chore(release): merge develop into main

.codacy.yml

@@ -0,0 +1,7 @@
+---
+exclude_paths:
+  - "docs/**"
+  - "coverage/**"
+  - "dist/**"
+  - ".yarn/**"
+  - "node_modules/**"

.github/workflows/ci.yml

@@ -1,10 +1,9 @@
-name: CI & Quality Gate
-
 on:
   workflow_dispatch:
   push:
     branches:
       - main
+      - develop
     paths:
       - 'packages/**'
       - 'bin/**'
@@ -14,7 +13,10 @@ on:
       - 'turbo.json'
       - '.github/workflows/ci.yml'
   pull_request:
-    types: [opened, synchronize, reopened]
+    types: [opened, synchronize, reopened, labeled]
+    branches:
+      - main
+      - develop
     paths:
       - 'packages/**'
       - 'bin/**'
@@ -112,7 +114,7 @@ jobs:
     name: Publish Independent Packages
     needs: sonarcloud
     runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/main' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
+    if: (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/develop') && (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
     permissions:
       contents: write
       packages: write
@@ -173,15 +175,44 @@ jobs:
         run: |
           git config --global user.name "github-actions[bot]"
           git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git pull --rebase origin main
+          BRANCH="${GITHUB_REF_NAME:-main}"
+          git pull --rebase origin "$BRANCH" --autostash
 
       - name: Publish all changed packages
-        run: yarn publish:all
+        run: |
+          if [ "${{ github.ref }}" = "refs/heads/develop" ]; then
+            yarn publish:all --tag beta --beta
+          else
+            yarn publish:all
+          fi
+
+      - name: Sync with remote to prevent push rejection
+        run: |
+          BRANCH="${GITHUB_REF_NAME:-main}"
+          git pull --rebase origin "$BRANCH" --autostash
 
       - name: Commit version bumps & hashes
+        id: auto_commit
         uses: stefanzweifel/git-auto-commit-action@v5 # NOSONAR
         with:
           commit_message: "chore: release versions & update hashes [skip ci]"
           commit_options: '--no-verify'
 
+      - name: Create and push temporal release tag on main
+        if: github.ref == 'refs/heads/main' && steps.auto_commit.outputs.changes_detected == 'true'
+        run: |
+          git fetch --tags origin
+          DATE_TAG="v$(date -u +'%Y.%m.%d')"
+          TAG="$DATE_TAG"
+          COUNTER=1
+          while git rev-parse "$TAG" >/dev/null 2>&1; do
+            TAG="${DATE_TAG}.${COUNTER}"
+            COUNTER=$((COUNTER + 1))
+          done
+          echo "Creating temporal release tag: $TAG"
+          git tag -a "$TAG" -m "Release $TAG [skip ci]"
+          git push origin "$TAG"
+
+
+
 

.github/workflows/docs-pipeline.yml

@@ -5,6 +5,14 @@ on:
   push:
     branches:
       - main
+      - develop
+    paths:
+      - 'docs/**'
+      - 'scripts/build-docs.ts'
+  pull_request:
+    branches:
+      - main
+      - develop
     paths:
       - 'docs/**'
       - 'scripts/build-docs.ts'
@@ -30,6 +38,7 @@ jobs:
           fetch-depth: 0
 
       - name: Log in to the Container registry
+        if: github.event_name != 'pull_request'
         uses: docker/login-action@v3 # NOSONAR
         with:
           registry: ${{ env.REGISTRY }}
@@ -57,8 +66,8 @@ jobs:
         with:
           context: .
           file: docs/ContainerFile
-          platforms: linux/amd64,linux/arm64
-          push: true
+          platforms: ${{ github.event_name == 'pull_request' && 'linux/amd64' || 'linux/amd64,linux/arm64' }}
+          push: ${{ github.event_name != 'pull_request' }}
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha

.github/workflows/publish-dev.yml

@@ -61,8 +61,8 @@ jobs:
             exit 1
           fi
 
-      - name: Publish all changed packages (latest-dev)
-        run: yarn node bin/publish_all.js --tag latest-dev
+      - name: Publish all changed packages (beta)
+        run: yarn node bin/publish_all.js --tag beta --beta
 
       - name: Sync with remote to prevent push rejection
         run: |

.gitignore

@@ -30,12 +30,18 @@ packages/**/.*.txt
 !bin/**/*.js
 !**/bin/**/*.js
 !/*.js
+!docs/*.js
+!docs/pages/_meta.js
 *.tsbuildinfo
 
 # Generated App
 /app/
 
 .turbo/
 **/.turbo/
+docs/.next/
+docs/out/
+docs/.yarn/
 firestore-debug.log
 firebase-debug.log
+.node-persist/

.markdownlint.yaml

@@ -1,7 +1,10 @@
 # .markdownlint.yaml
 # Tell markdownlint to allow 2 spaces after a list marker, matching Prettier's style.
 MD030:
-   ul_single: 2
-   ol_single: 2
-   ul_multi: 2
-   ol_multi: 2
+  ul_single: 2
+  ol_single: 2
+  ul_multi: 2
+  ol_multi: 2
+
+# Disable line length rule for markdown files
+MD013: false

.markdownlintignore

@@ -0,0 +1,6 @@
+# Documentation build artifacts and generated pages
+docs/**
+coverage/**
+dist/**
+node_modules/**
+.yarn/**