feat!: v3.0.0 - Angular 18+, gh-pages v6, commander fork

.claude/settings.local.json

@@ -0,0 +1,20 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm test)",
+      "Bash(npm run build)",
+      "Bash(git log:*)",
+      "Bash(npm test:*)",
+      "Bash(gh issue view:*)",
+      "WebSearch",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr diff:*)",
+      "Bash(git add:*)",
+      "Bash(gh run watch:*)",
+      "Bash(node -e:*)",
+      "Bash(gh run list:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

.github/workflows/main.yml

@@ -2,38 +2,125 @@ name: Build and test
 
 on:
   push:
-    branches: [main]
+    branches: [main, big-update]
 
 jobs:
-  build-and-deploy:
+  build-and-test:
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v4
+
       - uses: actions/setup-node@v4
         with:
           node-version: 22
+          cache: npm
+          cache-dependency-path: src/package-lock.json
 
-      - name: Prepare
+      - name: Build and test
+        working-directory: src
         run: |
-          cd src
-          npm install
+          npm ci
           npm run build
           npm run test
-          cd dist
-          npm link
-          cd ..
-          cd ..
-          npm install -g @angular/cli
-          ng new your-angular-project --defaults
-          cd your-angular-project
+
+      - name: Upload build artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: src/dist
+          retention-days: 1
+
+  # Test ng add and ng deploy across multiple Angular versions (sequentially)
+  # This catches breaking changes in angular.json structure
+  # Each test creates its own git repo and deploys locally to verify the full flow
+  #
+  # Why checkout + npm ci? The ng-add.js requires @angular-devkit/core which must
+  # be resolvable from the dist folder. Node.js resolves modules by traversing up
+  # from the file's location, so we need src/node_modules available.
+  test-angular-versions:
+    needs: build-and-test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: src/package-lock.json
+
+      - name: Install dependencies for module resolution
+        working-directory: src
+        run: npm ci
+
+      - name: Configure git
+        run: |
+          git config --global user.name "CI Bot"
+          git config --global user.email "[email protected]"
+
+      - name: Download build artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: src/dist
+
+      - name: Link angular-cli-ghpages
+        working-directory: src/dist
+        run: npm link
+
+      # Test projects are created OUTSIDE the repo to get their own git repos
+      # (Angular CLI creates a git repo by default with --defaults)
+      # Each test creates a bare repo as a fake remote to deploy to
+      - name: Test Angular 18
+        run: |
+          cd /tmp
+          git init --bare remote-18.git
+          npx @angular/cli@18 new test-app-18 --defaults
+          cd test-app-18
+          git remote add origin /tmp/remote-18.git
           npm link angular-cli-ghpages
-          ng add angular-cli-ghpages
+          npx ng add angular-cli-ghpages
+          npx ng deploy
+          cd /tmp/remote-18.git && git branch | grep gh-pages
+          echo "Angular 18: build + deploy successful"
 
-      - name: Deploy
-        if: github.ref == 'refs/heads/main'
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Test Angular 19
         run: |
-          cd your-angular-project
-          ng deploy --name="The Buildbot" --email="[email protected]" --cname=angular-cli-ghpages.angular.schule
+          cd /tmp
+          git init --bare remote-19.git
+          npx @angular/cli@19 new test-app-19 --defaults
+          cd test-app-19
+          git remote add origin /tmp/remote-19.git
+          npm link angular-cli-ghpages
+          npx ng add angular-cli-ghpages
+          npx ng deploy
+          cd /tmp/remote-19.git && git branch | grep gh-pages
+          echo "Angular 19: build + deploy successful"
+
+      - name: Test Angular 20
+        run: |
+          cd /tmp
+          git init --bare remote-20.git
+          npx @angular/cli@20 new test-app-20 --defaults
+          cd test-app-20
+          git remote add origin /tmp/remote-20.git
+          npm link angular-cli-ghpages
+          npx ng add angular-cli-ghpages
+          npx ng deploy
+          cd /tmp/remote-20.git && git branch | grep gh-pages
+          echo "Angular 20: build + deploy successful"
+
+      - name: Test Angular 21
+        run: |
+          cd /tmp
+          git init --bare remote-21.git
+          npx @angular/cli@21 new test-app-21 --defaults
+          cd test-app-21
+          git remote add origin /tmp/remote-21.git
+          npm link angular-cli-ghpages
+          npx ng add angular-cli-ghpages
+          npx ng deploy
+          cd /tmp/remote-21.git && git branch | grep gh-pages
+          echo "Angular 21: build + deploy successful"

.github/workflows/npm-publish.yml

@@ -7,6 +7,13 @@ on:
         type: boolean
         default: true
         description: 'Dry-run (test without publishing)'
+      tag:
+        type: choice
+        default: 'latest'
+        options:
+          - latest
+          - next
+        description: 'npm tag (use "next" for pre-release/RC versions)'
 
 # Required for OIDC token exchange with npm (Trusted Publishers)
 permissions:
@@ -33,14 +40,28 @@ jobs:
           npm run build
           npm test
 
+      - name: Show version info
+        working-directory: src/dist
+        run: |
+          VERSION=$(node -p "require('./package.json').version")
+          echo "📦 Package: angular-cli-ghpages"
+          echo "📌 Version: $VERSION"
+          echo "🏷️  Tag: ${{ inputs.tag }}"
+          echo ""
+          if [ "${{ inputs.dry_run }}" = "true" ]; then
+            echo "🧪 Mode: DRY-RUN (no actual publish)"
+          else
+            echo "🚀 Mode: PUBLISH FOR REAL"
+          fi
+
       - name: Publish to npm (dry-run)
         if: ${{ inputs.dry_run }}
         working-directory: src/dist
         run: |
-          echo "🧪 DRY-RUN MODE"
-          echo "==============="
           echo ""
-          npm publish --provenance --dry-run
+          echo "==============="
+          npm publish --provenance --tag ${{ inputs.tag }} --dry-run
+          echo "==============="
           echo ""
           echo "✅ Dry-run successful! Package is ready to publish."
           echo "   To publish for real, run this workflow again with dry_run unchecked."
@@ -49,9 +70,10 @@ jobs:
         if: ${{ !inputs.dry_run }}
         working-directory: src/dist
         run: |
-          echo "🚀 PUBLISHING TO NPM"
-          echo "===================="
           echo ""
-          npm publish --provenance
+          echo "==============="
+          npm publish --provenance --tag ${{ inputs.tag }}
+          echo "==============="
           echo ""
           echo "✅ Published successfully with provenance!"
+          echo "   https://www.npmjs.com/package/angular-cli-ghpages"

.gitignore

@@ -5,7 +5,6 @@ node_modules
 .bash_history
 *.swp
 *.swo
-*.d.ts
 .idea
 
 *.classpath