Renew documentaion site

.commitlintrc.json

@@ -1,7 +1,7 @@
 {
   "extends": ["@commitlint/config-conventional"],
   "rules": {
-    "scope-enum": [2, "always", ["angular", "angular-formly", "core", "react", "tokens", "release"]],
+    "scope-enum": [2, "always", ["angular", "angular-formly", "core", "docs", "react", "tokens", "release"]],
     "scope-case": [2, "always", "lower-case"]
   }
 }

.github/workflows/deploy-docs.yml

@@ -0,0 +1,64 @@
+name: Deploy Docs to Cloud Run
+
+on:
+  push:
+    branches:
+      - main
+      - feature/update-documentaion
+    paths:
+      - 'docs/**'
+      - 'core/**'
+      - 'tokens/**'
+      - 'package.json'
+      - 'pnpm-workspace.yaml'
+      - 'pnpm-lock.yaml'
+  workflow_dispatch:
+
+env:
+  REGION: europe-west1
+  SERVICE: catalyst-docs
+  IMAGE: europe-west1-docker.pkg.dev/haiilo-docs-487312/catalyst-docs/catalyst-docs
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Auth to Google Cloud
+        uses: google-github-actions/auth@v2
+        with:
+          credentials_json: ${{ secrets.GCP_SERVICE_ACCOUNT_KEY }}
+
+      - name: Setup gcloud
+        uses: google-github-actions/setup-gcloud@v2
+
+      - name: Configure Docker for Artifact Registry
+        run: gcloud auth configure-docker ${{ env.REGION }}-docker.pkg.dev --quiet
+
+      - name: Build and push Docker image
+        run: |
+          docker build -f docs/Dockerfile \
+            -t ${{ env.IMAGE }}:${{ github.sha }} \
+            -t ${{ env.IMAGE }}:latest \
+            .
+
+          docker push --all-tags ${{ env.IMAGE }}
+
+      - name: Deploy to Cloud Run
+        run: |
+          gcloud run deploy ${{ env.SERVICE }} \
+            --image=${{ env.IMAGE }}:${{ github.sha }} \
+            --region=${{ env.REGION }} \
+            --platform=managed \
+            --allow-unauthenticated \
+            --port=3000 \
+            --min-instances=1 \
+            --max-instances=3 \
+            --memory=512Mi \
+            --quiet

.npmrc

@@ -2,3 +2,6 @@ engine-strict=true
 enable-pre-post-scripts=true
 git-checks=false
 shamefully-hoist=true
+auto-install-peers=false
+frozen-lockfile=false
+resolution-mode=highest

.pnpmfile.cjs

@@ -0,0 +1,19 @@
+// #region agent log
+fetch('http://127.0.0.1:7245/ingest/a53d94c4-bb14-4c00-8cee-e4c7e61eb768',{method:'POST',headers:{'Content-Type':'application/json','X-Debug-Session-Id':'67fbf2'},body:JSON.stringify({sessionId:'67fbf2',runId:'pre-fix',hypothesisId:'H1',location:'.pnpmfile.cjs:2',message:'pnpmfile loaded',data:{node:process.version},timestamp:Date.now()})}).catch(()=>{});
+// #endregion
+
+let firstPackageLogged = false;
+
+module.exports = {
+  hooks: {
+    readPackage(pkg) {
+      if (!firstPackageLogged) {
+        firstPackageLogged = true;
+        // #region agent log
+        fetch('http://127.0.0.1:7245/ingest/a53d94c4-bb14-4c00-8cee-e4c7e61eb768',{method:'POST',headers:{'Content-Type':'application/json','X-Debug-Session-Id':'67fbf2'},body:JSON.stringify({sessionId:'67fbf2',runId:'pre-fix',hypothesisId:'H2',location:'.pnpmfile.cjs:13',message:'pnpm readPackage hook called',data:{name:pkg.name||null,version:pkg.version||null},timestamp:Date.now()})}).catch(()=>{});
+        // #endregion
+      }
+      return pkg;
+    },
+  },
+};

cloudbuild.yaml

@@ -0,0 +1,48 @@
+steps:
+  # Diagnostic: verify build context has the full repo
+  - name: 'alpine'
+    args: ['ls', '-la', '/workspace/']
+
+  # Build the container image from repo root using docs/Dockerfile
+  - name: 'gcr.io/cloud-builders/docker'
+    dir: '.'
+    args:
+      - 'build'
+      - '-f'
+      - 'docs/Dockerfile'
+      - '-t'
+      - '${_REGION}-docker.pkg.dev/$PROJECT_ID/${_REPO_NAME}/${_SERVICE_NAME}:$COMMIT_SHA'
+      - '-t'
+      - '${_REGION}-docker.pkg.dev/$PROJECT_ID/${_REPO_NAME}/${_SERVICE_NAME}:latest'
+      - '.'
+
+  # Push to Artifact Registry
+  - name: 'gcr.io/cloud-builders/docker'
+    args:
+      - 'push'
+      - '--all-tags'
+      - '${_REGION}-docker.pkg.dev/$PROJECT_ID/${_REPO_NAME}/${_SERVICE_NAME}'
+
+  # Deploy to Cloud Run
+  - name: 'gcr.io/cloud-builders/gcloud'
+    args:
+      - 'run'
+      - 'deploy'
+      - '${_SERVICE_NAME}'
+      - '--image=${_REGION}-docker.pkg.dev/$PROJECT_ID/${_REPO_NAME}/${_SERVICE_NAME}:$COMMIT_SHA'
+      - '--region=${_REGION}'
+      - '--platform=managed'
+      - '--allow-unauthenticated'
+      - '--port=3000'
+      - '--min-instances=0'
+      - '--max-instances=3'
+      - '--memory=512Mi'
+
+substitutions:
+  _REGION: europe-west1
+  _REPO_NAME: catalyst-docs
+  _SERVICE_NAME: catalyst-docs
+
+images:
+  - '${_REGION}-docker.pkg.dev/$PROJECT_ID/${_REPO_NAME}/${_SERVICE_NAME}:$COMMIT_SHA'
+  - '${_REGION}-docker.pkg.dev/$PROJECT_ID/${_REPO_NAME}/${_SERVICE_NAME}:latest'

core/src/components/cat-alert/docs.json

@@ -0,0 +1,136 @@
+{
+  "dirPath": "/Users/marcus/Haiilo/catalyst/core/src/components/cat-alert",
+  "filePath": "src/components/cat-alert/cat-alert.tsx",
+  "fileName": "cat-alert.tsx",
+  "readmePath": "/Users/marcus/Haiilo/catalyst/core/src/components/cat-alert/readme.md",
+  "usagesDir": "/Users/marcus/Haiilo/catalyst/core/src/components/cat-alert/usage",
+  "tag": "cat-alert",
+  "readme": "# cat-alert\n\n\n",
+  "overview": "Informs user about important changes or conditions in the interface. Use this\ncomponent if you need to capture user’s attention in a prominent way.",
+  "usage": {},
+  "docs": "Informs user about important changes or conditions in the interface. Use this\ncomponent if you need to capture user’s attention in a prominent way.",
+  "docsTags": [],
+  "encapsulation": "shadow",
+  "dependents": [],
+  "dependencies": [
+    "cat-icon"
+  ],
+  "dependencyGraph": {
+    "cat-alert": [
+      "cat-icon"
+    ]
+  },
+  "props": [
+    {
+      "name": "color",
+      "type": "\"danger\" | \"none\" | \"primary\" | \"secondary\" | \"success\" | \"warning\"",
+      "complexType": {
+        "original": "'primary' | 'secondary' | 'danger' | 'success' | 'warning' | 'none'",
+        "resolved": "\"danger\" | \"none\" | \"primary\" | \"secondary\" | \"success\" | \"warning\"",
+        "references": {}
+      },
+      "mutable": false,
+      "attr": "color",
+      "reflectToAttr": true,
+      "docs": "The color palette of the alert.",
+      "docsTags": [
+        {
+          "name": "default",
+          "text": "'primary'"
+        }
+      ],
+      "default": "'primary'",
+      "values": [
+        {
+          "value": "danger",
+          "type": "string"
+        },
+        {
+          "value": "none",
+          "type": "string"
+        },
+        {
+          "value": "primary",
+          "type": "string"
+        },
+        {
+          "value": "secondary",
+          "type": "string"
+        },
+        {
+          "value": "success",
+          "type": "string"
+        },
+        {
+          "value": "warning",
+          "type": "string"
+        }
+      ],
+      "optional": false,
+      "required": false,
+      "getter": false,
+      "setter": false
+    },
+    {
+      "name": "icon",
+      "type": "string | undefined",
+      "complexType": {
+        "original": "string",
+        "resolved": "string | undefined",
+        "references": {}
+      },
+      "mutable": false,
+      "attr": "icon",
+      "reflectToAttr": false,
+      "docs": "The name of an icon to be displayed in the alert.",
+      "docsTags": [],
+      "values": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "undefined"
+        }
+      ],
+      "optional": true,
+      "required": false,
+      "getter": false,
+      "setter": false
+    },
+    {
+      "name": "noIcon",
+      "type": "boolean",
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "mutable": false,
+      "attr": "no-icon",
+      "reflectToAttr": false,
+      "docs": "Whether the icon of the alert is deactivated.",
+      "docsTags": [
+        {
+          "name": "default",
+          "text": "false"
+        }
+      ],
+      "default": "false",
+      "values": [
+        {
+          "type": "boolean"
+        }
+      ],
+      "optional": false,
+      "required": false,
+      "getter": false,
+      "setter": false
+    }
+  ],
+  "methods": [],
+  "events": [],
+  "styles": [],
+  "slots": [],
+  "parts": [],
+  "listeners": []
+}