chore(ci): add prebuilt branches to allow use of unreleased features

.github/workflows/update-prebuilt-branches.yml

@@ -0,0 +1,28 @@
+name: Update Prebuilt Branches
+on:
+  push:
+    branches: main
+permissions:
+  contents: write
+concurrency:
+  group: update-prebuilt-branches
+  cancel-in-progress: true
+jobs:
+  update-prebuilt-branches:
+    name: Update Prebuilt Branches
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version-file: '.nvmrc'
+      - name: Install Dependencies
+        run: npm ci
+      - name: Disable Docs Builds
+        run: node ./scripts/clear-npm-script.js _build:demo _build:storybook
+      - name: Build
+        run: npm run build
+      - name: Update Prebuilt Branches
+        run: ./scripts/update-prebuilt-branches.sh

docs/INSTALLATION.md

@@ -45,3 +45,14 @@
     })
     export class AppModule {    }
     ```
+
+## Using the "Bleeding Edge" of the `main` Branch
+
+You can install unreleased builds of the `@clr/ui` and `@clr/angular` packages by installing our prebuilt branches.
+These branches are automatically built after each commit to the `main` branch, so you can use features before we release
+to npm.
+
+```bash
+npm install @clr/ui@github:ng-clarity/ng-clarity.git#main-prebuilt-clr-ui
+npm install @clr/angular@github:ng-clarity/ng-clarity.git#main-prebuilt-clr-angular
+```

scripts/update-prebuilt-branches.sh

@@ -0,0 +1,35 @@
+COMMIT_SHA=$(git log -1 --format='%H')
+
+# configure git
+git config user.name "Clarity Update Bot"
+git config user.email "noreply@github.com"
+
+# fetch prebuilt branch remotes
+git fetch origin main-prebuilt-clr-ui
+git fetch origin main-prebuilt-clr-angular
+
+# add worktrees
+git worktree add --track -b main-prebuilt-clr-ui main-prebuilt-clr-ui origin/main-prebuilt-clr-ui
+git worktree add --track -b main-prebuilt-clr-angular main-prebuilt-clr-angular origin/main-prebuilt-clr-angular
+
+# delete old files
+rm -rf ./main-prebuilt-clr-ui/*
+rm -rf ./main-prebuilt-clr-angular/*
+
+# copy new files
+cp -r ./dist/clr-ui/* ./main-prebuilt-clr-ui
+cp -r ./dist/clr-angular/* ./main-prebuilt-clr-angular
+
+# push @clr/ui
+pushd ./main-prebuilt-clr-ui
+git add .
+git commit -m "update build for commit $COMMIT_SHA"
+git push origin main-prebuilt-clr-ui:main-prebuilt-clr-ui
+popd
+
+# push @clr/angular
+pushd ./main-prebuilt-clr-angular
+git add .
+git commit -m "update build for commit $COMMIT_SHA"
+git push origin main-prebuilt-clr-angular:main-prebuilt-clr-angular
+popd