feat: add GitHub Actions CI/CD and release automation

- Add release.yml workflow for npm publishing on tag push
- Add ci.yml workflow for tests on push/PR
- Add build script with ESM, CJS, and minified outputs
- Add release script for version management and tagging
- Update package.json with proper exports and build config
- Exclude dist/ and scripts/ from pre-commit validators

Author: Brian

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run validation and tests
+        run: npm run validate:all
+
+      - name: Build bundles
+        run: npm run build
+
+      - name: Verify build outputs
+        run: |
+          for file in jss.min.js jss.esm.js jss.cjs.js; do
+            if [ ! -f "dist/$file" ]; then
+              echo "ERROR: Missing dist/$file"
+              exit 1
+            fi
+          done
+          echo "Build verified!"

.github/workflows/release.yml

@@ -0,0 +1,100 @@
+name: Release to npm
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm run test:coverage:check
+
+      - name: Build bundles
+        run: npm run build
+
+      - name: Verify build outputs
+        run: |
+          echo "Checking build outputs..."
+          ls -la dist/
+
+          for file in jss.min.js jss.min.js.map jss.esm.js jss.esm.js.map jss.cjs.js jss.cjs.js.map; do
+            if [ ! -f "dist/$file" ]; then
+              echo "ERROR: Missing dist/$file"
+              exit 1
+            fi
+          done
+
+          echo "All build outputs verified!"
+
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Get previous tag
+        id: prev_tag
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          echo "tag=$PREV_TAG" >> $GITHUB_OUTPUT
+
+      - name: Generate release notes
+        id: release_notes
+        run: |
+          CURRENT_TAG="${GITHUB_REF_NAME}"
+          PREV_TAG="${{ steps.prev_tag.outputs.tag }}"
+
+          echo "Current tag: $CURRENT_TAG"
+          echo "Previous tag: $PREV_TAG"
+
+          if [ -n "$PREV_TAG" ]; then
+            COMMITS=$(git log ${PREV_TAG}..${CURRENT_TAG} --pretty=format:"- %s" --no-merges)
+          else
+            COMMITS=$(git log --pretty=format:"- %s" --no-merges)
+          fi
+
+          # Write to file for multi-line handling
+          echo "## What's Changed" > release_notes.md
+          echo "" >> release_notes.md
+          echo "$COMMITS" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "---" >> release_notes.md
+          echo "" >> release_notes.md
+          echo "**Full Changelog**: https://github.com/${{ github.repository }}/compare/${PREV_TAG}...${CURRENT_TAG}" >> release_notes.md
+
+          cat release_notes.md
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          body_path: release_notes.md
+          files: |
+            dist/jss.min.js
+            dist/jss.min.js.map
+            dist/jss.esm.js
+            dist/jss.esm.js.map
+            dist/jss.cjs.js
+            dist/jss.cjs.js.map
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,2 +1,3 @@
 node_modules/
 coverage/
+dist/

.hooks/pre-commit.d/check-docs.sh

@@ -31,7 +31,7 @@ cd "$PROJECT_ROOT"
 echo "    Checking documentation (README.md & files.md in every folder)..."
 
 # Directories to exclude from checking
-EXCLUDED_DIRS="node_modules|\.git|\.hooks|coverage|\.claude"
+EXCLUDED_DIRS="node_modules|\.git|\.hooks|coverage|\.claude|dist|scripts"
 
 # Track missing files
 MISSING_README=()

.hooks/pre-commit.d/jsdoc-validator.js

@@ -122,6 +122,8 @@ function main() {
     ".hooks",
     "coverage",
     ".claude",
+    "dist",
+    "scripts",
   ];
 
   console.log("    Validating JSDoc comments...");

.hooks/pre-commit.d/yoda-validator.js

@@ -106,6 +106,8 @@ function main() {
         ".hooks",
         "coverage",
         ".claude",
+        "dist",
+        "scripts",
     ];
 
     console.log("    Validating Yoda conditions...");