@zenithbuild/plugins 0.3.2

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,40 @@
+# 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.3.1] - 2026-01-16
+
+### 🐛 Bug Fixes
+
+- **release**: use appendFileSync for GitHub Actions output (197ed51)
+
+### 📝 Other Changes
+
+- 
+1b01347bc123da83fa3d47244243ccc71bc08119 ()
+- 
+0e46b4719d367aae779989ba8dd2c663a3367f68 ()
+- 
+421a8073322947af590e877d5082422788fc2181 ()
+- 
+d897b6b63ce9befc76fca102b26ee9810f96658f ()
+- 
+90fc174c6cc860416a66b3cc0551f31c891fa5e6 ()
+- added hooks and markdown compad (5df2a49)
+- 
+ebd3b4562954462bcc7266a92704832175e537c4 ()
+- 
+90ac532ab8af8b4c7df64853522c77feb4c9cb7f ()
+- 
+5bc7dba965edfe06ee95a151447af7ae45821a78 ()
+- 
+f83484b99a677b6c76181526efc0aa66a5ba5cb4 ()
+- 
+1d87564d9816f1f42c7f94360707ad7673157ce0 ()
+- 
+5a856fe53f86f2ddc51a974fc29d2fab5e38bd84 ()
+-  ()
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zenith Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @zenithbuild/plugins ⚡
+
+The official plugin ecosystem for the Zenith framework.
+
+## Overview
+
+Zenith is designed to be extensible. The `@zenithbuild/plugins` package provides the core plugin system and is the home for shared official plugins that enhance the framework's capabilities.
+
+## Features
+
+- **Extensible Hooks**: Tap into different phases of the Zenith lifecycle (build, dev, runtime).
+- **Official Plugins**: A collection of vetted plugins for common tasks (SEO, Analytics, State persistence, etc.).
+- **Simple API**: Focused on ease of use for plugin authors.
+
+## Plugin Example (Preview)
+
+```typescript
+export default function myZenithPlugin() {
+  return {
+    name: 'my-plugin',
+    setup(api) {
+      // Tap into the build process
+      api.onBuild(() => {
+        console.log('Zenith is building!');
+      });
+    }
+  }
+}
+```
+
+## Getting Started
+
+Refer to the Zenith documentation for instructions on how to consume and create plugins.
+
+## License
+
+MIT

package/bun.lock

@@ -0,0 +1,17 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@zenithbuild/plugins",
+      "devDependencies": {
+        "@types/node": "^25.0.6",
+      },
+    },
+  },
+  "packages": {
+    "@types/node": ["@types/node@25.0.6", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-NNu0sjyNxpoiW3YuVFfNz7mxSQ+S4X2G28uqg2s+CzoqoQjLPsWSbsFFyztIAqt2vb8kfEAsJNepMGPTxFDx3Q=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+  }
+}

package/content/README.md

@@ -0,0 +1,116 @@
+# ⚡ Zenith Content Plugin
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/zenithbuild/zenith/main/assets/logos/logo.png" alt="Zenith Logo" width="120" />
+  <h3>Scale your Zenith experience with Content</h3>
+  
+  [![Zenith Ecosystem](https://img.shields.io/badge/Zenith-Ecosystem-blue?style=for-the-badge&logo=zenith)](https://github.com/zenithbuild/zenith)
+  [![Template: content](https://img.shields.io/badge/Template-content-cyan?style=for-the-badge)](https://github.com/zenithbuild/create-zenith-plugin)
+</div>
+
+---
+
+## 📖 Introduction
+
+Welcome to the **content** plugin! 🎯
+
+This plugin exists to [Enter specific purpose here: e.g., integrate with Firebase, provide custom theming utilities, etc.]. It has been scaffolded using the **content** pattern, ensuring it integrates seamlessly with the Zenith core while staying flexible for your needs.
+
+### Why use this?
+- **Seamless Integration**: Designed specifically for the Zenith runtime.
+- **Type Safe**: Built with TypeScript from the ground up.
+- **DX Focused**: Includes example stubs to get you running in seconds.
+
+---
+
+## ⚙️ Installation
+
+To enable the **content** plugin in your Zenith project:
+
+1. Import the plugin in your `zenith.config.ts`:
+
+```ts
+import { plugin as content } from "./plugins/content";
+
+export default {
+  // ... other config
+  plugins: [
+    content({
+      /* options */
+    })
+  ]
+};
+```
+
+2. Zenith will automatically call the `setup` hook during the initialization phase.
+
+---
+
+## 🛠️ Configuration
+
+The plugin accepts an options object. Define your parameters in `types.ts` and handle them in `index.ts`.
+
+| Option | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `enabled` | `boolean` | `true` | Toggle the plugin functionality |
+| `apiKey` | `string` | `undefined` | Required for service-based plugins |
+
+> [!TIP]
+> **Pro Tip**: Always use environment variables for sensitive options like `apiKey`. Use `process.env.MY_PLUGIN_KEY` in your config!
+
+---
+
+## 🚀 Usage
+
+Once configured, the plugin interacts with the Zenith lifecycle via the `setup(ctx)` function.
+
+### Runtime Hooks
+You can access the Zenith context (`ctx`) to:
+- Access the component registry.
+- Inject global styles.
+- Listen to lifecycle events.
+
+```ts
+// Example: Implementation inside index.ts
+setup(ctx) {
+  ctx.on('mount', () => {
+    console.log("Content is active!");
+  });
+}
+```
+
+---
+
+## 🎨 Examples
+
+### Basic Setup
+[Provide a simple use case here]
+
+### Advanced Customization
+[Demonstrate complex logic or hooks interaction here]
+
+---
+
+## 🩺 Troubleshooting & FAQ
+
+> [!CAUTION]
+> **Common Pitfall**: If your plugin isn't firing, ensure it's added to the `plugins` array in the *correct* environment config.
+
+**Q: Can I use this with other plugins?**  
+A: Yes! Zenith plugins are composable. Just be mindful of hook execution order.
+
+**Q: Where do my logs go?**  
+A: By default, logs from the `setup` hook appear in your dev server console.
+
+---
+
+## 🤝 Contributing
+
+We welcome all contributions to the Zenith ecosystem!
+- **Submit a Bug**: Open an issue describing the behavior.
+- **Request a Feature**: Let us know what's missing.
+- **PRs**: Point your PRs to the `main` branch.
+
+---
+
+*Generated with [create-zenith-plugin](https://github.com/zenithbuild/create-zenith-plugin)*

package/content/enhancers.ts

@@ -0,0 +1,39 @@
+import type { ContentItem, EnhancerFn } from './types';
+
+export const builtInEnhancers: Record<string, EnhancerFn> = {
+    readTime: (item: ContentItem) => {
+        const wordsPerMinute = 200;
+        const text = item.content || '';
+        const wordCount = text.split(/\s+/).length;
+        const minutes = Math.ceil(wordCount / wordsPerMinute);
+        return {
+            ...item,
+            readTime: `${minutes} min`
+        };
+    },
+    wordCount: (item: ContentItem) => {
+        const text = item.content || '';
+        const wordCount = text.split(/\s+/).length;
+        return {
+            ...item,
+            wordCount
+        };
+    }
+};
+
+export async function applyEnhancers(item: ContentItem, enhancers: (string | EnhancerFn)[]): Promise<ContentItem> {
+    let enrichedItem = { ...item };
+    for (const enhancer of enhancers) {
+        if (typeof enhancer === 'string') {
+            const fn = builtInEnhancers[enhancer];
+            if (fn) {
+                enrichedItem = await fn(enrichedItem);
+            } else {
+                console.warn(`Enhancer "${enhancer}" not found.`);
+            }
+        } else if (typeof enhancer === 'function') {
+            enrichedItem = await enhancer(enrichedItem);
+        }
+    }
+    return enrichedItem;
+}