zenith-language 0.3.0 → 0.4.1

package/.github/workflows/release.yml

@@ -0,0 +1,254 @@
+# =============================================================================
+# Zenith Automated Release Workflow
+# =============================================================================
+# This workflow handles automated releases for all Zenith repositories.
+# 
+# TRIGGERS:
+# - Push to 'main' branch (analyzes commits for version bump)
+# - Manual trigger via workflow_dispatch (with optional dry-run mode)
+# - Tag creation (v*) for explicit version releases
+#
+# FEATURES:
+# - Conventional Commits parsing for automatic version determination
+# - Automatic CHANGELOG.md generation
+# - GitHub Release creation
+# - Optional NPM publishing
+# - Commits updated files back to repo
+# - Dry-run mode for testing
+# - Monorepo support (detects changed packages)
+#
+# REQUIRED SECRETS:
+# - NPM_TOKEN: For publishing to NPM (if enabled)
+# - GITHUB_TOKEN: Automatically provided by GitHub Actions
+# =============================================================================
+
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+    paths-ignore:
+      - '**.md'
+      - '.github/**'
+      - '!.github/workflows/release.yml'
+  
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Dry run mode (no actual release)'
+        required: false
+        default: false
+        type: boolean
+      package:
+        description: 'Specific package to release (for monorepo, leave empty for auto-detect)'
+        required: false
+        default: ''
+        type: string
+      bump_type:
+        description: 'Force version bump type (leave empty for auto-detect from commits)'
+        required: false
+        default: ''
+        type: choice
+        options:
+          - ''
+          - patch
+          - minor
+          - major
+      publish_npm:
+        description: 'Publish to NPM'
+        required: false
+        default: true
+        type: boolean
+
+# Prevent concurrent releases
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+env:
+  BUN_VERSION: '1.1.38'
+
+jobs:
+  # ==========================================================================
+  # Detect Changes (for monorepo support)
+  # ==========================================================================
+  detect-changes:
+    name: Detect Changed Packages
+    runs-on: ubuntu-latest
+    outputs:
+      packages: ${{ steps.detect.outputs.packages }}
+      has_changes: ${{ steps.detect.outputs.has_changes }}
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Detect Changed Packages
+        id: detect
+        run: |
+          # First, check if this is a single-package repo (package.json in root)
+          if [ -f "./package.json" ]; then
+            # Count subdirectories with package.json (excluding node_modules)
+            SUB_PACKAGES=$(find . -mindepth 2 -name "package.json" -not -path "*/node_modules/*" | wc -l)
+            
+            if [ "$SUB_PACKAGES" -eq 0 ]; then
+              # Single package repo - always release from root
+              echo "Single package repository detected"
+              echo "packages=[\".\"]" >> $GITHUB_OUTPUT
+              echo "has_changes=true" >> $GITHUB_OUTPUT
+              exit 0
+            fi
+          fi
+          
+          # Monorepo detection
+          PACKAGES=$(find . -name "package.json" -not -path "*/node_modules/*" -not -path "*/.git/*" | xargs -I {} dirname {} | sed 's|^\./||' | grep -v "^$" | sort -u)
+          
+          # For monorepos, detect which packages changed
+          CHANGED_PACKAGES="[]"
+          if [ "${{ github.event.inputs.package }}" != "" ]; then
+            CHANGED_PACKAGES="[\"${{ github.event.inputs.package }}\"]"
+          else
+            # Get changed files since last tag or in the current push
+            LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+            if [ -z "$LAST_TAG" ]; then
+              CHANGED_FILES=$(git diff --name-only HEAD~1 HEAD 2>/dev/null || git ls-files)
+            else
+              CHANGED_FILES=$(git diff --name-only $LAST_TAG HEAD)
+            fi
+            
+            # Match changed files to packages
+            CHANGED_PKGS=""
+            for pkg in $PACKAGES; do
+              if echo "$CHANGED_FILES" | grep -q "^$pkg/"; then
+                if [ -z "$CHANGED_PKGS" ]; then
+                  CHANGED_PKGS="\"$pkg\""
+                else
+                  CHANGED_PKGS="$CHANGED_PKGS, \"$pkg\""
+                fi
+              fi
+            done
+            CHANGED_PACKAGES="[$CHANGED_PKGS]"
+          fi
+          
+          echo "packages=$CHANGED_PACKAGES" >> $GITHUB_OUTPUT
+          if [ "$CHANGED_PACKAGES" = "[]" ]; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+          fi
+
+
+  # ==========================================================================
+  # Release Job
+  # ==========================================================================
+  release:
+    name: Release
+    needs: detect-changes
+    if: needs.detect-changes.outputs.has_changes == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+    
+    strategy:
+      fail-fast: false
+      matrix:
+        package: ${{ fromJson(needs.detect-changes.outputs.packages) }}
+    
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Install Dependencies
+        working-directory: ${{ matrix.package }}
+        run: bun install
+
+      - name: Run Release Script
+        id: release
+        working-directory: ${{ matrix.package }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          DRY_RUN: ${{ github.event.inputs.dry_run || 'false' }}
+          BUMP_TYPE: ${{ github.event.inputs.bump_type || '' }}
+          PUBLISH_NPM: ${{ github.event.inputs.publish_npm || 'true' }}
+        run: |
+          # Run the Bun release script
+          bun run scripts/release.ts
+
+      - name: Build Package
+        if: steps.release.outputs.should_release == 'true'
+        working-directory: ${{ matrix.package }}
+        run: |
+          if bun run build 2>/dev/null; then
+            echo "Build completed successfully"
+          else
+            echo "No build script found or build not required"
+          fi
+
+      - name: Commit Changes
+        if: steps.release.outputs.should_release == 'true' && github.event.inputs.dry_run != 'true'
+        working-directory: ${{ matrix.package }}
+        run: |
+          git add CHANGELOG.md package.json
+          git commit -m "chore(release): v${{ steps.release.outputs.new_version }} [skip ci]" || echo "No changes to commit"
+          git push
+
+      - name: Create GitHub Release
+        if: steps.release.outputs.should_release == 'true' && github.event.inputs.dry_run != 'true'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.release.outputs.new_version }}
+          name: Release v${{ steps.release.outputs.new_version }}
+          body_path: ${{ matrix.package }}/RELEASE_NOTES.md
+          draft: false
+          prerelease: false
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to NPM
+        if: steps.release.outputs.should_release == 'true' && github.event.inputs.dry_run != 'true' && (github.event.inputs.publish_npm == 'true' || github.event.inputs.publish_npm == '')
+        working-directory: ${{ matrix.package }}
+        run: |
+          # Check if package is not private
+          PRIVATE=$(cat package.json | bun -e "console.log(JSON.parse(await Bun.stdin.text()).private || false)")
+          if [ "$PRIVATE" = "false" ]; then
+            echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > ~/.npmrc
+            bun publish --access public || npm publish --access public
+          else
+            echo "Package is private, skipping NPM publish"
+          fi
+
+      - name: Summary
+        run: |
+          echo "## Release Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          if [ "${{ github.event.inputs.dry_run }}" = "true" ]; then
+            echo "⚠️ **DRY RUN MODE** - No actual release was created" >> $GITHUB_STEP_SUMMARY
+          fi
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **Package**: ${{ matrix.package }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Version**: ${{ steps.release.outputs.new_version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Bump Type**: ${{ steps.release.outputs.bump_type }}" >> $GITHUB_STEP_SUMMARY

package/.releaserc.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "types": {
+    "feat": {
+      "title": "✨ Features",
+      "bump": "minor",
+      "description": "New features or functionality"
+    },
+    "fix": {
+      "title": "🐛 Bug Fixes",
+      "bump": "patch",
+      "description": "Bug fixes and corrections"
+    },
+    "perf": {
+      "title": "⚡ Performance Improvements",
+      "bump": "patch",
+      "description": "Performance optimizations"
+    },
+    "refactor": {
+      "title": "♻️ Code Refactoring",
+      "bump": "patch",
+      "description": "Code changes that neither fix bugs nor add features"
+    },
+    "docs": {
+      "title": "📚 Documentation",
+      "bump": null,
+      "description": "Documentation only changes"
+    },
+    "style": {
+      "title": "💄 Styles",
+      "bump": null,
+      "description": "Code style changes (formatting, whitespace)"
+    },
+    "test": {
+      "title": "✅ Tests",
+      "bump": null,
+      "description": "Adding or updating tests"
+    },
+    "build": {
+      "title": "📦 Build System",
+      "bump": "patch",
+      "description": "Build system or dependency changes"
+    },
+    "ci": {
+      "title": "🔧 CI Configuration",
+      "bump": null,
+      "description": "CI/CD configuration changes"
+    },
+    "chore": {
+      "title": "🔨 Chores",
+      "bump": null,
+      "description": "Maintenance tasks and other changes"
+    },
+    "revert": {
+      "title": "⏪ Reverts",
+      "bump": "patch",
+      "description": "Reverting previous commits"
+    }
+  },
+  "skipCI": [
+    "[skip ci]",
+    "[ci skip]",
+    "[no ci]",
+    "chore(release)"
+  ],
+  "tagPrefix": "v",
+  "branches": {
+    "main": "latest",
+    "next": "next",
+    "beta": "beta",
+    "alpha": "alpha"
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.4.0] - 2026-01-16
+
+### ✨ Features
+
+- **language**: update syntax grammar for new directives and reactive bindings (cb65c98)
+
+### 🐛 Bug Fixes
+
+- **release**: use appendFileSync for GitHub Actions output (c953f51)
+
+### 📝 Other Changes
+
+- 
+c1aa285dac910ec64f2240c849ff6c0d18b7cd2e ()
+- 
+dc90df4092e298ffdce221f8127ae87b0aeed45c ()
+- 
+18982c541782091455f32bb5c354e66a06c2938a ()
+- 
+5a5046880d2afbc7df70abce0062c6a4be21859e ()
+- 
+8627c68faf8cd28521675a6216dc7462c7deb2b2 ()
+- 
+e06fdd9e3167f30671c559e98c3fb75088c7e1b6 ()
+- 0.2.9 (de391df)
+- 
+e0ad1cd02292af51ac321e7580ae9e534abd6c1b ()
+- 
+e4ca2b1d2af81e1cf9876b0932cd3178b7d1bf7e ()
+- 
+cff8202737008d97c6527703f51783583eae7e6f ()
+- 
+645d159ba240aec6cb6cab5bf332743f6eed4fcd ()
+- 
+52507461378cb8f2d87245b84924790a191879ad ()
+-  ()
+

package/README.md

@@ -12,7 +12,7 @@ VS Code extension providing world-class development support for the Zenith frame
 - **IntelliSense**: Smart completions for Zenith components, hooks, and reactive state.
 - **Emmet Support**: Accelerated HTML development inside `.zen` templates.
 - **Project Scaffolding**: Integrated support for starting new projects.
-- **LSP Integration**: Leverages `@zenith/language-server` for powerful diagnostics and refactoring.
+- **LSP Integration**: Leverages `@zenithbuild/language-server` for powerful diagnostics and refactoring.
 
 ## Supported Extensions
 

package/package.json

@@ -1,102 +1,110 @@
 {
-    "name": "zenith-language",
-    "displayName": "Zenith Language Support",
-    "description": "Syntax highlighting, IntelliSense, and editor support for Zenith Framework (.zen files)",
-    "version": "0.3.0",
-    "publisher": "ZenithBuild",
-    "engines": {
-        "vscode": "^1.80.0"
-    },
-    "main": "./out/extension.js",
-    "scripts": {
-        "build:server": "cd ../zenith-language-server && bun run build",
-        "compile": "bun x esbuild src/extension.ts --bundle --outfile=out/extension.js --external:vscode --format=cjs --platform=node && cp ../zenith-language-server/dist/server.js out/server.js",
-        "watch": "bun run compile -- --watch",
-        "build:marketplace": "bun run build:server && bun run compile && node scripts/build.js marketplace",
-        "build:openvsx": "bun run build:server && bun run compile && node scripts/build.js openvsx",
-        "build:all": "bun run build:server && bun run compile && node scripts/build.js all"
-    },
-    "devDependencies": {
-        "@types/node": "^20.0.0",
-        "@types/vscode": "^1.80.0",
-        "esbuild": "^0.19.0",
-        "typescript": "^5.0.0"
-    },
-    "categories": [
-        "Programming Languages"
-    ],
-    "icon": "assets/logo.png",
-    "keywords": [
-        "zenith",
-        "zen",
-        "syntax",
-        "highlighting",
-        "intellisense",
-        "framework"
-    ],
-    "contributes": {
-        "languages": [
-            {
-                "id": "zenith",
-                "aliases": [
-                    "Zenith",
-                    "zenith"
-                ],
-                "extensions": [
-                    ".zen",
-                    ".zen.html",
-                    ".zenx"
-                ],
-                "configuration": "./language-configuration.json"
-            }
+  "name": "zenith-language",
+  "displayName": "Zenith Language Support",
+  "description": "Syntax highlighting, IntelliSense, and editor support for Zenith Framework (.zen files)",
+  "version": "0.4.1",
+  "publisher": "ZenithBuild",
+  "engines": {
+    "vscode": "^1.80.0"
+  },
+  "main": "./out/extension.js",
+  "scripts": {
+    "build:server": "cd ../zenith-language-server && bun run build",
+    "compile": "bun x esbuild src/extension.ts --bundle --outfile=out/extension.js --external:vscode --format=cjs --platform=node && cp ../zenith-language-server/dist/server.js out/server.js",
+    "watch": "bun run compile -- --watch",
+    "build:marketplace": "bun run build:server && bun run compile && node scripts/build.js marketplace",
+    "build:openvsx": "bun run build:server && bun run compile && node scripts/build.js openvsx",
+    "build:all": "bun run build:server && bun run compile && node scripts/build.js all",
+    "release": "bun run scripts/release.ts",
+    "release:dry": "bun run scripts/release.ts --dry-run",
+    "release:patch": "bun run scripts/release.ts --bump=patch",
+    "release:minor": "bun run scripts/release.ts --bump=minor",
+    "release:major": "bun run scripts/release.ts --bump=major"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/vscode": "^1.80.0",
+    "esbuild": "^0.19.0",
+    "typescript": "^5.0.0"
+  },
+  "categories": [
+    "Programming Languages"
+  ],
+  "icon": "assets/logo.png",
+  "keywords": [
+    "zenith",
+    "zen",
+    "syntax",
+    "highlighting",
+    "intellisense",
+    "framework"
+  ],
+  "contributes": {
+    "languages": [
+      {
+        "id": "zenith",
+        "aliases": [
+          "Zenith",
+          "zenith"
         ],
-        "grammars": [
-            {
-                "language": "zenith",
-                "scopeName": "text.html.zenith",
-                "path": "./syntaxes/zenith.tmLanguage.json",
-                "embeddedLanguages": {
-                    "source.js": "javascript",
-                    "source.ts": "typescript",
-                    "source.css": "css",
-                    "text.html.basic": "html",
-                    "meta.embedded.block.javascript": "javascript",
-                    "meta.embedded.block.typescript": "typescript",
-                    "meta.embedded.block.css": "css"
-                }
-            }
+        "extensions": [
+          ".zen",
+          ".zen.html",
+          ".zenx"
         ],
-        "configurationDefaults": {
-            "[zenith]": {
-                "editor.formatOnSave": true,
-                "editor.wordBasedSuggestions": "off",
-                "editor.suggest.insertMode": "replace",
-                "editor.semanticHighlighting.enabled": true,
-                "editor.quickSuggestions": {
-                    "other": true,
-                    "comments": false,
-                    "strings": true
-                },
-                "editor.autoClosingBrackets": "always"
-            },
-            "emmet.includeLanguages": {
-                "zenith": "html"
-            },
-            "emmet.syntaxProfiles": {
-                "zenith": "html"
-            }
+        "configuration": "./language-configuration.json"
+      }
+    ],
+    "grammars": [
+      {
+        "language": "zenith",
+        "scopeName": "text.html.zenith",
+        "path": "./syntaxes/zenith.tmLanguage.json",
+        "embeddedLanguages": {
+          "source.js": "javascript",
+          "source.ts": "typescript",
+          "source.css": "css",
+          "text.html.basic": "html",
+          "meta.embedded.block.javascript": "javascript",
+          "meta.embedded.block.typescript": "typescript",
+          "meta.embedded.block.css": "css"
         }
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/zenithbuild/zenith"
-    },
-    "homepage": "https://github.com/zenithbuild/zenith#readme",
-    "bugs": {
-        "url": "https://github.com/zenithbuild/zenith/issues"
-    },
-    "license": "MIT",
-    "dependencies": {
-        "vscode-languageclient": "^9.0.1"
+      }
+    ],
+    "configurationDefaults": {
+      "[zenith]": {
+        "editor.formatOnSave": true,
+        "editor.wordBasedSuggestions": "off",
+        "editor.suggest.insertMode": "replace",
+        "editor.semanticHighlighting.enabled": true,
+        "editor.quickSuggestions": {
+          "other": true,
+          "comments": false,
+          "strings": true
+        },
+        "editor.autoClosingBrackets": "always"
+      },
+      "emmet.includeLanguages": {
+        "zenith": "html"
+      },
+      "emmet.syntaxProfiles": {
+        "zenith": "html"
+      }
     }
-}
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zenithbuild/zenith"
+  },
+  "homepage": "https://github.com/zenithbuild/zenith#readme",
+  "bugs": {
+    "url": "https://github.com/zenithbuild/zenith/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "vscode-languageclient": "^9.0.1"
+  }
+}

package/scripts/release.ts

@@ -0,0 +1,554 @@
+#!/usr/bin/env bun
+/**
+ * =============================================================================
+ * Zenith Release Script
+ * =============================================================================
+ * 
+ * Automated release script using Bun for all Zenith repositories.
+ * Handles:
+ * - Conventional Commit parsing for automatic version determination
+ * - CHANGELOG.md generation
+ * - package.json version updates
+ * - Release notes generation for GitHub releases
+ * 
+ * Usage:
+ *   bun run scripts/release.ts              # Normal release
+ *   bun run scripts/release.ts --dry-run    # Test without making changes
+ *   bun run scripts/release.ts --bump=major # Force major version bump
+ *   bun run scripts/release.ts --bump=minor # Force minor version bump
+ *   bun run scripts/release.ts --bump=patch # Force patch version bump
+ * 
+ * Environment Variables:
+ *   DRY_RUN      - Set to 'true' for dry run mode
+ *   BUMP_TYPE    - Force bump type (patch, minor, major)
+ *   GITHUB_TOKEN - GitHub token for API calls (optional)
+ * 
+ * =============================================================================
+ */
+
+import { $ } from "bun";
+import { existsSync } from "fs";
+import { join } from "path";
+
+// =============================================================================
+// Types
+// =============================================================================
+
+interface Commit {
+  hash: string;
+  type: string;
+  scope: string | null;
+  subject: string;
+  body: string;
+  breaking: boolean;
+  raw: string;
+}
+
+interface PackageJson {
+  name: string;
+  version: string;
+  private?: boolean;
+  [key: string]: unknown;
+}
+
+interface ReleaseConfig {
+  types: {
+    [key: string]: {
+      title: string;
+      bump: "patch" | "minor" | "major" | null;
+      hidden?: boolean;
+    };
+  };
+  skipCI: string[];
+  tagPrefix: string;
+}
+
+type BumpType = "patch" | "minor" | "major";
+
+// =============================================================================
+// Configuration
+// =============================================================================
+
+const DEFAULT_CONFIG: ReleaseConfig = {
+  types: {
+    feat: { title: "✨ Features", bump: "minor" },
+    fix: { title: "🐛 Bug Fixes", bump: "patch" },
+    perf: { title: "⚡ Performance Improvements", bump: "patch" },
+    refactor: { title: "♻️ Code Refactoring", bump: "patch" },
+    docs: { title: "📚 Documentation", bump: null },
+    style: { title: "💄 Styles", bump: null },
+    test: { title: "✅ Tests", bump: null },
+    build: { title: "📦 Build System", bump: "patch" },
+    ci: { title: "🔧 CI Configuration", bump: null },
+    chore: { title: "🔨 Chores", bump: null },
+    revert: { title: "⏪ Reverts", bump: "patch" },
+  },
+  skipCI: ["[skip ci]", "[ci skip]", "[no ci]"],
+  tagPrefix: "v",
+};
+
+// =============================================================================
+// Utility Functions
+// =============================================================================
+
+function log(message: string, type: "info" | "success" | "warn" | "error" = "info"): void {
+  const colors = {
+    info: "\x1b[36m",    // Cyan
+    success: "\x1b[32m", // Green
+    warn: "\x1b[33m",    // Yellow
+    error: "\x1b[31m",   // Red
+  };
+  const reset = "\x1b[0m";
+  const prefix = {
+    info: "ℹ",
+    success: "✓",
+    warn: "⚠",
+    error: "✖",
+  };
+  console.log(`${colors[type]}${prefix[type]}${reset} ${message}`);
+}
+
+function parseArgs(): { dryRun: boolean; bumpType: BumpType | null } {
+  const args = process.argv.slice(2);
+  let dryRun = process.env.DRY_RUN === "true";
+  let bumpType: BumpType | null = (process.env.BUMP_TYPE as BumpType) || null;
+
+  for (const arg of args) {
+    if (arg === "--dry-run") {
+      dryRun = true;
+    } else if (arg.startsWith("--bump=")) {
+      const bump = arg.split("=")[1] as BumpType;
+      if (["patch", "minor", "major"].includes(bump)) {
+        bumpType = bump;
+      }
+    }
+  }
+
+  return { dryRun, bumpType };
+}
+
+// =============================================================================
+// Git Functions
+// =============================================================================
+
+async function getLastTag(): Promise<string | null> {
+  try {
+    const result = await $`git describe --tags --abbrev=0 2>/dev/null`.text();
+    return result.trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+async function tagExists(version: string): Promise<boolean> {
+  try {
+    const result = await $`git tag -l "v${version}"`.text();
+    return result.trim() !== "";
+  } catch {
+    return false;
+  }
+}
+
+
+async function getCommitsSinceTag(tag: string | null): Promise<string[]> {
+  try {
+    let result: string;
+    if (tag) {
+      result = await $`git log ${tag}..HEAD --pretty=format:"%H|%s|%b|||"`.text();
+    } else {
+      result = await $`git log --pretty=format:"%H|%s|%b|||"`.text();
+    }
+    return result.split("|||").filter((c) => c.trim());
+  } catch {
+    return [];
+  }
+}
+
+function parseCommit(rawCommit: string, config: ReleaseConfig): Commit | null {
+  const parts = rawCommit.trim().split("|");
+  if (parts.length < 2) return null;
+
+  const hash = parts[0];
+  const subject = parts[1];
+  const body = parts.slice(2).join("|").trim();
+
+  // Skip CI commits
+  if (config.skipCI.some((skip) => subject.includes(skip))) {
+    return null;
+  }
+
+  // Parse conventional commit format: type(scope): subject
+  const conventionalMatch = subject.match(/^(\w+)(?:\(([^)]+)\))?!?:\s*(.+)$/);
+
+  if (!conventionalMatch) {
+    // Non-conventional commit, treat as misc
+    return {
+      hash,
+      type: "other",
+      scope: null,
+      subject,
+      body,
+      breaking: false,
+      raw: rawCommit,
+    };
+  }
+
+  const [, type, scope, message] = conventionalMatch;
+  const breaking = subject.includes("!:") ||
+    body.toLowerCase().includes("breaking change") ||
+    body.toLowerCase().includes("breaking-change");
+
+  return {
+    hash,
+    type: type.toLowerCase(),
+    scope: scope || null,
+    subject: message.trim(),
+    body,
+    breaking,
+    raw: rawCommit,
+  };
+}
+
+// =============================================================================
+// Version Functions
+// =============================================================================
+
+function bumpVersion(version: string, bumpType: BumpType): string {
+  const parts = version.replace(/^v/, "").split(".");
+  const major = parseInt(parts[0] || "0", 10);
+  const minor = parseInt(parts[1] || "0", 10);
+  const patch = parseInt(parts[2] || "0", 10);
+
+  switch (bumpType) {
+    case "major":
+      return `${major + 1}.0.0`;
+    case "minor":
+      return `${major}.${minor + 1}.0`;
+    case "patch":
+      return `${major}.${minor}.${patch + 1}`;
+  }
+}
+
+function determineBumpType(commits: Commit[], config: ReleaseConfig): BumpType | null {
+  let bump: BumpType | null = null;
+  const priority: Record<BumpType, number> = { patch: 1, minor: 2, major: 3 };
+
+  for (const commit of commits) {
+    // Breaking changes always result in major bump
+    if (commit.breaking) {
+      return "major";
+    }
+
+    const typeConfig = config.types[commit.type];
+    if (typeConfig?.bump) {
+      if (!bump || priority[typeConfig.bump] > priority[bump]) {
+        bump = typeConfig.bump;
+      }
+    }
+  }
+
+  return bump;
+}
+
+// =============================================================================
+// Changelog Generation
+// =============================================================================
+
+function generateChangelog(
+  commits: Commit[],
+  newVersion: string,
+  config: ReleaseConfig
+): string {
+  const date = new Date().toISOString().split("T")[0];
+  const groupedCommits: Record<string, Commit[]> = {};
+
+  // Group commits by type
+  for (const commit of commits) {
+    const type = commit.type;
+    if (!groupedCommits[type]) {
+      groupedCommits[type] = [];
+    }
+    groupedCommits[type].push(commit);
+  }
+
+  let changelog = `## [${newVersion}] - ${date}\n\n`;
+
+  // Breaking changes section
+  const breakingChanges = commits.filter((c) => c.breaking);
+  if (breakingChanges.length > 0) {
+    changelog += `### ⚠️ BREAKING CHANGES\n\n`;
+    for (const commit of breakingChanges) {
+      const scope = commit.scope ? `**${commit.scope}**: ` : "";
+      changelog += `- ${scope}${commit.subject} (${commit.hash.slice(0, 7)})\n`;
+    }
+    changelog += "\n";
+  }
+
+  // Regular changes by type
+  for (const [type, typeConfig] of Object.entries(config.types)) {
+    if (typeConfig.hidden) continue;
+
+    const typeCommits = groupedCommits[type];
+    if (!typeCommits || typeCommits.length === 0) continue;
+
+    changelog += `### ${typeConfig.title}\n\n`;
+    for (const commit of typeCommits) {
+      const scope = commit.scope ? `**${commit.scope}**: ` : "";
+      changelog += `- ${scope}${commit.subject} (${commit.hash.slice(0, 7)})\n`;
+    }
+    changelog += "\n";
+  }
+
+  // Other/uncategorized commits
+  if (groupedCommits.other && groupedCommits.other.length > 0) {
+    changelog += `### 📝 Other Changes\n\n`;
+    for (const commit of groupedCommits.other) {
+      changelog += `- ${commit.subject} (${commit.hash.slice(0, 7)})\n`;
+    }
+    changelog += "\n";
+  }
+
+  return changelog;
+}
+
+function generateReleaseNotes(
+  commits: Commit[],
+  newVersion: string,
+  packageName: string,
+  config: ReleaseConfig
+): string {
+  const changelog = generateChangelog(commits, newVersion, config);
+
+  return `# ${packageName} v${newVersion}
+
+${changelog}
+
+## Installation
+
+\`\`\`bash
+bun add ${packageName}@${newVersion}
+\`\`\`
+
+or with npm:
+
+\`\`\`bash
+npm install ${packageName}@${newVersion}
+\`\`\`
+`;
+}
+
+async function updateChangelogFile(
+  newChangelog: string,
+  dryRun: boolean
+): Promise<void> {
+  const changelogPath = join(process.cwd(), "CHANGELOG.md");
+  let existingChangelog = "";
+
+  if (existsSync(changelogPath)) {
+    existingChangelog = await Bun.file(changelogPath).text();
+    // Remove the header if it exists
+    existingChangelog = existingChangelog.replace(
+      /^# Changelog\n\n(?:.*\n)*?(?=## \[)/,
+      ""
+    );
+  }
+
+  const fullChangelog = `# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+${newChangelog}${existingChangelog}`;
+
+  if (dryRun) {
+    log("Would write CHANGELOG.md:", "info");
+    console.log(fullChangelog.slice(0, 500) + "...");
+  } else {
+    await Bun.write(changelogPath, fullChangelog);
+    log("Updated CHANGELOG.md", "success");
+  }
+}
+
+// =============================================================================
+// Package.json Functions
+// =============================================================================
+
+async function readPackageJson(): Promise<PackageJson> {
+  const packagePath = join(process.cwd(), "package.json");
+  const content = await Bun.file(packagePath).text();
+  return JSON.parse(content);
+}
+
+async function updatePackageJson(
+  newVersion: string,
+  dryRun: boolean
+): Promise<void> {
+  const packagePath = join(process.cwd(), "package.json");
+  const packageJson = await readPackageJson();
+  packageJson.version = newVersion;
+
+  if (dryRun) {
+    log(`Would update package.json version to ${newVersion}`, "info");
+  } else {
+    await Bun.write(packagePath, JSON.stringify(packageJson, null, 2) + "\n");
+    log(`Updated package.json version to ${newVersion}`, "success");
+  }
+}
+
+// =============================================================================
+// GitHub Actions Output
+// =============================================================================
+
+async function setGitHubOutput(name: string, value: string): Promise<void> {
+  const outputFile = process.env.GITHUB_OUTPUT;
+  if (outputFile) {
+    const output = `${name}=${value}\n`;
+    // Use Node.js appendFileSync for reliable GitHub Actions output
+    const { appendFileSync } = await import("fs");
+    appendFileSync(outputFile, output);
+    log(`Set output: ${name}=${value}`, "info");
+  }
+}
+
+// =============================================================================
+// Load Custom Config
+// =============================================================================
+
+async function loadConfig(): Promise<ReleaseConfig> {
+  const configPaths = [
+    join(process.cwd(), ".releaserc.json"),
+    join(process.cwd(), "release.config.json"),
+    join(process.cwd(), ".release.json"),
+  ];
+
+  for (const configPath of configPaths) {
+    if (existsSync(configPath)) {
+      const content = await Bun.file(configPath).text();
+      const customConfig = JSON.parse(content);
+      return { ...DEFAULT_CONFIG, ...customConfig };
+    }
+  }
+
+  return DEFAULT_CONFIG;
+}
+
+// =============================================================================
+// Main Release Function
+// =============================================================================
+
+async function main(): Promise<void> {
+  console.log("\n🚀 Zenith Release Script\n");
+  console.log("=".repeat(50) + "\n");
+
+  const { dryRun, bumpType: forcedBumpType } = parseArgs();
+
+  if (dryRun) {
+    log("Running in DRY RUN mode - no changes will be made", "warn");
+    console.log();
+  }
+
+  // Load configuration
+  const config = await loadConfig();
+  log("Loaded release configuration", "success");
+
+  // Read package.json
+  const packageJson = await readPackageJson();
+  log(`Package: ${packageJson.name}`, "info");
+  log(`Current version: ${packageJson.version}`, "info");
+
+  // Get last tag
+  const lastTag = await getLastTag();
+  log(`Last tag: ${lastTag || "none"}`, "info");
+
+  // Get commits since last tag
+  const rawCommits = await getCommitsSinceTag(lastTag);
+  log(`Found ${rawCommits.length} commits since last release`, "info");
+
+  if (rawCommits.length === 0) {
+    log("No commits since last release. Nothing to do.", "warn");
+    await setGitHubOutput("should_release", "false");
+    return;
+  }
+
+  // Parse commits
+  const commits = rawCommits
+    .map((c) => parseCommit(c, config))
+    .filter((c): c is Commit => c !== null);
+
+  log(`Parsed ${commits.length} conventional commits`, "info");
+
+  // Determine bump type
+  const determinedBumpType = forcedBumpType || determineBumpType(commits, config);
+
+  if (!determinedBumpType) {
+    log("No version bump required based on commits", "warn");
+    await setGitHubOutput("should_release", "false");
+    return;
+  }
+
+  log(`Version bump type: ${determinedBumpType}`, "info");
+
+  // Calculate new version
+  const newVersion = bumpVersion(packageJson.version, determinedBumpType);
+  log(`New version: ${newVersion}`, "success");
+
+  // Check if this version already exists as a tag (fallback to prevent duplicates)
+  if (await tagExists(newVersion)) {
+    log(`Version v${newVersion} already exists as a tag. Skipping release.`, "warn");
+    await setGitHubOutput("should_release", "false");
+    return;
+  }
+
+  console.log("\n" + "-".repeat(50) + "\n");
+
+  // Generate changelog
+  const changelog = generateChangelog(commits, newVersion, config);
+  log("Generated changelog", "success");
+
+  // Generate release notes
+  const releaseNotes = generateReleaseNotes(
+    commits,
+    newVersion,
+    packageJson.name,
+    config
+  );
+
+  // Update files
+  await updateChangelogFile(changelog, dryRun);
+  await updatePackageJson(newVersion, dryRun);
+
+  // Write release notes for GitHub Action
+  if (!dryRun) {
+    await Bun.write(join(process.cwd(), "RELEASE_NOTES.md"), releaseNotes);
+    log("Written RELEASE_NOTES.md", "success");
+  }
+
+  // Set GitHub Actions outputs
+  await setGitHubOutput("should_release", "true");
+  await setGitHubOutput("new_version", newVersion);
+  await setGitHubOutput("bump_type", determinedBumpType);
+  await setGitHubOutput("package_name", packageJson.name);
+
+  console.log("\n" + "=".repeat(50));
+  console.log("\n✅ Release preparation complete!\n");
+
+  if (dryRun) {
+    console.log("DRY RUN - Summary of what would happen:");
+    console.log(`  • Version: ${packageJson.version} → ${newVersion}`);
+    console.log(`  • CHANGELOG.md would be updated`);
+    console.log(`  • Release notes would be created`);
+    console.log(`  • Git tag: v${newVersion} would be created`);
+    console.log(`  • GitHub release would be published`);
+    if (!packageJson.private) {
+      console.log(`  • Package would be published to NPM`);
+    }
+  }
+}
+
+// Run the script
+main().catch((error) => {
+  log(`Release failed: ${error.message}`, "error");
+  process.exit(1);
+});