chore: update documentation and code references for version 4

- Changed import paths for defineCustomElements in multiple files to use the new loader path.
- Updated links in documentation to point to the new version 4 (next) site.
- Modified version hints in the documentation to reflect the new versioning.
- Adjusted Angular adapter versions in the framework documentation.
- Removed references to the old KoliBri Designer and updated theming instructions to reflect new practices.
- Updated package.json to reflect new version numbers and dependencies.
- Changed sample app links to point to the development version.

Author: deleonio

.github/actions/build-artifacts/action.yml

@@ -1,8 +1,8 @@
 name: Build Docs Artifacts
 description: Builds the documentation artifacts including Docusaus, Sample App and Designer
 inputs:
-  PERSONAL_ACCESS_TOKEN:
-    description: 'A Github PAT'
+  GITHUB_TOKEN:
+    description: 'GitHub token for package registry authentication'
     required: true
 runs:
   using: 'composite'
@@ -11,100 +11,68 @@ runs:
 
     - name: Build Docs
       shell: bash
-      run: npm run build
+      run: |
+        rm -rf build
+        npm run build
+        mv build next
 
-    - uses: actions/setup-node@v4
+    - uses: actions/setup-node@v6
       with:
         node-version: 22
-        registry-url: 'https://npm.pkg.github.com'
+        registry-url: https://npm.pkg.github.com
         scope: '@public-ui'
 
-    - name: Download Docs (v2)
+    - name: Download Docs (v3)
       env:
-        NODE_AUTH_TOKEN: ${{ inputs.PERSONAL_ACCESS_TOKEN }}
+        NODE_AUTH_TOKEN: ${{ inputs.GITHUB_TOKEN }}
       shell: bash
       run: |
+        npm pack @public-ui/docs-v3@latest > /dev/null
+        tar -xzvf public-ui-*.tgz > /dev/null
+
+        mv package/build build
+        mv next build/next
+
         rm -rf package *.tgz
+
+    - name: Download Docs (v2)
+      env:
+        NODE_AUTH_TOKEN: ${{ inputs.GITHUB_TOKEN }}
+      shell: bash
+      run: |
         npm pack @public-ui/docs-v2@latest > /dev/null
-        tar -xzvf public-ui-docs-*.tgz > /dev/null
+        tar -xzvf public-ui-*.tgz > /dev/null
 
-        rm -rf build/docs/2.2 build/v2
+        rm -rf build/v2
         mkdir -p build/v2
         mv package/build/* build/v2/
 
         rm -rf package *.tgz
 
     - name: Download designer (v1)
       env:
-        NODE_AUTH_TOKEN: ${{ inputs.PERSONAL_ACCESS_TOKEN }}
+        NODE_AUTH_TOKEN: ${{ inputs.GITHUB_TOKEN }}
       shell: bash
       run: |
-        rm -rf package *.tgz
         npm pack @public-ui/designer@^1
-        tar -xzvf public-ui-designer-*.tgz
+        tar -xzvf public-ui-*.tgz > /dev/null
 
         rm -rf build/v1/designer
         mkdir -p build/v1
         mv package/dist build/v1/designer
 
         rm -rf package *.tgz
 
-    - name: Download sample react (v1)
-      env:
-        NODE_AUTH_TOKEN: ${{ inputs.PERSONAL_ACCESS_TOKEN }}
-      shell: bash
-      run: |
-        rm -rf package *.tgz
-        npm pack @public-ui/sample-react@^1
-        tar -xzvf public-ui-sample-react-*.tgz
-
-        rm -rf build/v1/sample-react
-        mkdir -p build/v1
-        mv package/dist build/v1/sample-react
-
-        rm -rf package *.tgz
-
     - name: Download designer (v2)
       env:
-        NODE_AUTH_TOKEN: ${{ inputs.PERSONAL_ACCESS_TOKEN }}
+        NODE_AUTH_TOKEN: ${{ inputs.GITHUB_TOKEN }}
       shell: bash
       run: |
-        rm -rf package *.tgz
         npm pack @public-ui/designer@^2
-        tar -xzvf public-ui-designer-*.tgz
+        tar -xzvf public-ui-*.tgz > /dev/null
 
         rm -rf build/v2/designer
         mkdir -p build/v2
         mv package/dist build/v2/designer
 
         rm -rf package *.tgz
-
-    - name: Download sample react (v2)
-      env:
-        NODE_AUTH_TOKEN: ${{ inputs.PERSONAL_ACCESS_TOKEN }}
-      shell: bash
-      run: |
-        rm -rf package *.tgz
-        npm pack @public-ui/sample-react@^2
-        tar -xzvf public-ui-sample-react-*.tgz
-
-        rm -rf build/v2/sample-react
-        mkdir -p build/v2
-        mv package/dist build/v2/sample-react
-
-        rm -rf package *.tgz
-
-    - name: Download sample react (v3)
-      env:
-        NODE_AUTH_TOKEN: ${{ inputs.PERSONAL_ACCESS_TOKEN }}
-      shell: bash
-      run: |
-        rm -rf package *.tgz
-        npm pack @public-ui/sample-react@">=3.0.0-rc.1" --include-prerelease
-        tar -xzvf public-ui-sample-react-*.tgz
-
-        rm -rf build/v3/sample-react
-        mkdir -p build/v3
-        mv package/dist build/v3/sample-react
-
-        rm -rf package *.tgz

.github/actions/pnpm-setup/action.yml

@@ -5,17 +5,17 @@
 name: pnpm Setup
 description: Install Node and pnpm, install dependencies
 runs:
-  using: 'composite'
+  using: composite
   steps:
     - uses: pnpm/action-setup@v4
       with:
         version: 10
         run_install: false
 
-    - uses: actions/setup-node@v4
+    - uses: actions/setup-node@v6
       with:
-        node-version: '22'
-        cache: 'pnpm'
+        node-version: 22
+        cache: pnpm
 
     - run: pnpm install
       shell: bash

.github/dependabot.yml

@@ -5,15 +5,41 @@
 
 version: 2
 updates:
+  # === Default Branch ===
   - package-ecosystem: github-actions
-    directory: "/"
+    directory: /
+    labels:
+      - dependabot
+      - v4
     schedule:
-      interval: monthly
-    target-branch: main
-  # - package-ecosystem: npm
-  #   directory: "/dev"
-  #   ignore:
-  #     - dependency-name: "rimraf"
-  #   schedule:
-  #     interval: daily
-  #   target-branch: main
+      interval: weekly
+
+  # === Release Branch: v3 ===
+  - package-ecosystem: github-actions
+    directory: /
+    target-branch: release/3
+    labels:
+      - dependabot
+      - v3
+    schedule:
+      interval: weekly
+
+  # === Release Branch: v2 ===
+  - package-ecosystem: github-actions
+    directory: /
+    target-branch: release/2
+    labels:
+      - dependabot
+      - v2
+    schedule:
+      interval: weekly
+
+  # === Release Branch: v1 ===
+  - package-ecosystem: github-actions
+    directory: /
+    target-branch: release/1
+    labels:
+      - dependabot
+      - v1
+    schedule:
+      interval: weekly

.github/workflows/add-issues-to-project.yml

@@ -15,6 +15,10 @@ permissions:
   contents: read
   issues: write
 
+concurrency:
+  group: 'workflow-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}'
+  cancel-in-progress: true
+
 jobs:
   add-to-project:
     name: Add issue to roadmap project

.github/workflows/auto-dependency-updater.yml

@@ -12,6 +12,10 @@ permissions:
   contents: write
   pull-requests: write
 
+concurrency:
+  group: 'workflow-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}'
+  cancel-in-progress: true
+
 jobs:
   update:
     runs-on: ubuntu-latest
@@ -26,7 +30,7 @@ jobs:
     env:
       version: ${{ matrix.version }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           ref: ${{ matrix.base }}

.github/workflows/ci.yml

@@ -4,11 +4,15 @@ on:
   pull_request:
   workflow_dispatch:
 
+concurrency:
+  group: 'workflow-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}'
+  cancel-in-progress: true
+
 jobs:
   build-and-check:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           persist-credentials: false

.github/workflows/draft-deploy.yml

@@ -4,18 +4,22 @@ on:
   workflow_dispatch:
   pull_request:
 
+concurrency:
+  group: 'workflow-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}'
+  cancel-in-progress: true
+
 jobs:
   build-and-deploy:
     if: ${{ github.event.pull_request.base.repo.clone_url == github.event.pull_request.head.repo.clone_url }}
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Build Artifacts
         uses: ./.github/actions/build-artifacts
         with:
-          PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Netlify Deploy
         uses: netlify/actions/cli@master

.github/workflows/publish.yml

@@ -0,0 +1,69 @@
+name: Publish GitHub package and trigger main branch update
+
+on:
+  push:
+    branches:
+      - release/3
+  workflow_dispatch:
+
+concurrency:
+  group: 'workflow-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}'
+  cancel-in-progress: true
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+    steps:
+      - uses: actions/create-github-app-token@v2
+        id: app-token
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.PRIVATE_KEY }}
+
+      - name: Get GitHub App User ID
+        id: get-user-id
+        run: echo "user-id=$(gh api "/users/${{ steps.app-token.outputs.app-slug }}[bot]" --jq .id)" >> "$GITHUB_OUTPUT"
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          fetch-depth: 0
+
+      - name: Build Artifacts
+        uses: ./.github/actions/build-artifacts
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          registry-url: https://npm.pkg.github.com
+
+      - name: Bump version
+        shell: bash
+        run: pnpm version prerelease --no-git-tag-version
+
+      - name: Commit and push changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: 'chore: Bump version [skip actions]'
+          file_pattern: 'package.json'
+          commit_user_name: '${{ steps.app-token.outputs.app-slug }}[bot]'
+          commit_user_email: '${{ steps.get-user-id.outputs.user-id }}+${{ steps.app-token.outputs.app-slug }}[bot]@users.noreply.github.com'
+
+      - name: Publish Docs
+        run: npm publish --access restricted
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Trigger main branch update
+        shell: bash
+        run: gh workflow run update.yml --ref main
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}

.github/workflows/test-deploy.yml

@@ -6,17 +6,21 @@ on:
       - 'main'
   workflow_dispatch:
 
+concurrency:
+  group: 'workflow-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}'
+  cancel-in-progress: true
+
 jobs:
   build-and-deploy:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Build Artifacts
         uses: ./.github/actions/build-artifacts
         with:
-          PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Netlify Deploy
         uses: netlify/actions/cli@master