@mks2508/better-logger 0.0.1 → 0.0.2-alpha.0

package/.claude/settings.local.json

@@ -5,7 +5,10 @@
       "Bash(npm run dev:*)",
       "WebSearch",
       "Bash(git add:*)",
-      "Bash(npm publish:*)"
+      "Bash(npm publish:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(npm install:*)"
     ],
     "deny": [],
     "ask": []

package/.github/workflows/ci.yml

@@ -0,0 +1,307 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [ main, develop ]
+    tags: [ 'v*' ]
+  pull_request:
+    branches: [ main, develop ]
+
+env:
+  NODE_VERSION: '20'
+  REGISTRY_URL: 'https://registry.npmjs.org'
+
+jobs:
+  # ===== BUILD & TEST =====
+  build-and-test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [18, 20, 21]
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 📦 Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+          registry-url: ${{ env.REGISTRY_URL }}
+
+      - name: 🔧 Install dependencies
+        run: npm run ci:install
+
+      - name: 🔍 Type checking
+        run: npm run type-check
+
+      - name: 🧹 Lint code
+        run: npm run lint
+
+      - name: 🏗️ Build library
+        run: npm run ci:build
+
+      - name: 🧪 Run tests
+        run: npm run ci:test
+
+      - name: 📊 Check bundle sizes
+        run: npm run size-limit
+
+      - name: 📤 Upload build artifacts
+        uses: actions/upload-artifact@v4
+        if: matrix.node-version == 20
+        with:
+          name: dist-files
+          path: dist/
+          retention-days: 30
+
+  # ===== VISUAL TESTING =====
+  visual-tests:
+    runs-on: ubuntu-latest
+    needs: build-and-test
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: 🔧 Install dependencies
+        run: npm run ci:install
+
+      - name: 📥 Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-files
+          path: dist/
+
+      - name: 🎭 Install Playwright
+        run: npx playwright install --with-deps chromium
+
+      - name: 🖼️ Run visual tests
+        run: npm run ci:test:visual
+
+      - name: 📤 Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-results
+          path: test-results/
+          retention-days: 30
+
+      - name: 📤 Upload screenshots
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: failed-screenshots
+          path: test-results/
+          retention-days: 30
+
+  # ===== NPM PUBLISH =====
+  publish:
+    runs-on: ubuntu-latest
+    needs: [build-and-test, visual-tests]
+    if: startsWith(github.ref, 'refs/tags/v')
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+          registry-url: ${{ env.REGISTRY_URL }}
+
+      - name: 🔧 Install dependencies
+        run: npm run ci:install
+
+      - name: 📥 Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-files
+          path: dist/
+
+      - name: 🚀 Publish to NPM
+        run: npm run ci:publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: 📝 Extract release notes
+        id: extract_release
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag_name=v$VERSION" >> $GITHUB_OUTPUT
+
+  # ===== GITHUB RELEASE =====
+  github-release:
+    runs-on: ubuntu-latest
+    needs: publish
+    if: startsWith(github.ref, 'refs/tags/v')
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 📥 Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-files
+          path: dist/
+
+      - name: 📦 Create release archive
+        run: |
+          tar -czf better-logger-dist.tar.gz dist/
+          zip -r better-logger-dist.zip dist/
+
+      - name: 🏷️ Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          name: Better Logger ${{ github.ref_name }}
+          tag_name: ${{ github.ref_name }}
+          body: |
+            ## 🚀 Better Logger ${{ github.ref_name }}
+            
+            ### 📦 Installation
+            ```bash
+            npm install @mks2508/better-logger@${{ github.ref_name }}
+            ```
+            
+            ### 📊 Bundle Sizes
+            - **Full library**: ~64KB (13KB gzipped)
+            - **Core module**: ~6KB (2KB gzipped)  
+            - **Styling module**: ~26KB (5KB gzipped)
+            - **Exports module**: ~12KB (3KB gzipped)
+            
+            ### 🔗 Links
+            - [📚 Documentation](https://mks2508.github.io/advanced-logger/)
+            - [🧩 Examples](https://github.com/MKS2508/advanced-logger/tree/main/examples)
+            - [📋 Changelog](https://github.com/MKS2508/advanced-logger/blob/main/CHANGELOG.md)
+            
+            ### 📁 Assets
+            - `better-logger-dist.tar.gz` - Distribution files (tar.gz)
+            - `better-logger-dist.zip` - Distribution files (zip)
+          files: |
+            better-logger-dist.tar.gz
+            better-logger-dist.zip
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  # ===== DEPLOY GITHUB PAGES =====
+  deploy-docs:
+    runs-on: ubuntu-latest
+    needs: build-and-test
+    if: github.ref == 'refs/heads/main'
+    
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: 🔧 Install dependencies
+        run: npm run ci:install
+
+      - name: 📥 Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-files
+          path: dist/
+
+      - name: 🏗️ Build documentation site
+        run: |
+          mkdir -p docs-site
+          cp demo.html docs-site/index.html
+          cp -r dist/ docs-site/dist/
+          cp -r docs/ docs-site/docs/
+          cp README.md docs-site/
+
+      - name: 📤 Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: 📤 Upload to Pages
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs-site/
+
+      - name: 🚀 Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+  # ===== SECURITY & QUALITY =====
+  security-audit:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: 🔒 Security audit
+        run: npm audit --audit-level=high
+
+      - name: 📊 Check for outdated packages
+        run: npm outdated || true
+
+  # ===== PERFORMANCE TESTING =====
+  performance:
+    runs-on: ubuntu-latest
+    needs: build-and-test
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: 🔧 Install dependencies
+        run: npm run ci:install
+
+      - name: 📥 Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-files
+          path: dist/
+
+      - name: ⚡ Performance benchmarks
+        run: npm run ci:test:performance
+
+      - name: 📊 Bundle analysis
+        run: |
+          echo "## Bundle Analysis" >> $GITHUB_STEP_SUMMARY
+          echo "### Size Breakdown" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY
+          ls -la dist/ >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY

package/.github/workflows/release.yml

@@ -0,0 +1,248 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      release_type:
+        description: 'Release type'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+          - alpha
+          - beta
+      skip_tests:
+        description: 'Skip tests (not recommended)'
+        required: false
+        default: false
+        type: boolean
+
+env:
+  NODE_VERSION: '20'
+  REGISTRY_URL: 'https://registry.npmjs.org'
+
+jobs:
+  # ===== PRE-RELEASE VALIDATION =====
+  pre-release:
+    runs-on: ubuntu-latest
+    
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      tag: ${{ steps.version.outputs.tag }}
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+          registry-url: ${{ env.REGISTRY_URL }}
+
+      - name: 🔧 Install dependencies
+        run: npm ci
+
+      - name: 🧪 Run tests (unless skipped)
+        if: ${{ !inputs.skip_tests }}
+        run: |
+          npm run type-check
+          npm run lint
+          npm run test
+          npm run build
+
+      - name: 🏷️ Determine version
+        id: version
+        run: |
+          case "${{ inputs.release_type }}" in
+            "patch")
+              NEW_VERSION=$(npm version patch --no-git-tag-version)
+              ;;
+            "minor") 
+              NEW_VERSION=$(npm version minor --no-git-tag-version)
+              ;;
+            "major")
+              NEW_VERSION=$(npm version major --no-git-tag-version)
+              ;;
+            "alpha")
+              NEW_VERSION=$(npm version prerelease --preid=alpha --no-git-tag-version)
+              ;;
+            "beta")
+              NEW_VERSION=$(npm version prerelease --preid=beta --no-git-tag-version)
+              ;;
+          esac
+          
+          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "tag=v$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "📦 New version: $NEW_VERSION"
+
+      - name: 🏗️ Build for release
+        run: npm run build
+
+      - name: 📤 Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dist
+          path: dist/
+          retention-days: 7
+
+  # ===== CREATE RELEASE =====
+  create-release:
+    runs-on: ubuntu-latest
+    needs: pre-release
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+          registry-url: ${{ env.REGISTRY_URL }}
+
+      - name: 📥 Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dist
+          path: dist/
+
+      - name: 🔄 Update package version
+        run: npm version ${{ needs.pre-release.outputs.version }} --no-git-tag-version
+
+      - name: 📦 Create release archives
+        run: |
+          # Create distribution archives
+          tar -czf better-logger-${{ needs.pre-release.outputs.version }}.tar.gz dist/ docs/ README.md package.json
+          zip -r better-logger-${{ needs.pre-release.outputs.version }}.zip dist/ docs/ README.md package.json
+          
+          # Create individual module packages
+          cd dist
+          tar -czf ../better-logger-core-${{ needs.pre-release.outputs.version }}.tar.gz core.js core.cjs types/core.d.ts
+          tar -czf ../better-logger-styling-${{ needs.pre-release.outputs.version }}.tar.gz styling.js styling.cjs types/styling.d.ts
+          tar -czf ../better-logger-exports-${{ needs.pre-release.outputs.version }}.tar.gz exports.js exports.cjs types/exports.d.ts
+          cd ..
+
+      - name: 📝 Generate changelog
+        id: changelog
+        run: |
+          # Get commits since last tag
+          LAST_TAG=$(git describe --tags --abbrev=0 HEAD~1 2>/dev/null || echo "")
+          if [ -n "$LAST_TAG" ]; then
+            echo "## Changes since $LAST_TAG" > RELEASE_NOTES.md
+            git log $LAST_TAG..HEAD --pretty=format:"- %s (%h)" >> RELEASE_NOTES.md
+          else
+            echo "## Initial Release" > RELEASE_NOTES.md
+            echo "- Complete Better Logger implementation with all features" >> RELEASE_NOTES.md
+          fi
+          
+          # Add bundle size info
+          echo "" >> RELEASE_NOTES.md
+          echo "## 📦 Bundle Sizes" >> RELEASE_NOTES.md
+          echo "\`\`\`" >> RELEASE_NOTES.md
+          ls -lh dist/*.js dist/*.cjs | grep -E '\.(js|cjs)$' >> RELEASE_NOTES.md
+          echo "\`\`\`" >> RELEASE_NOTES.md
+
+      - name: 🏷️ Create and push tag
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add package.json
+          git commit -m "chore: release ${{ needs.pre-release.outputs.version }}"
+          git tag -a "${{ needs.pre-release.outputs.tag }}" -m "Release ${{ needs.pre-release.outputs.version }}"
+          git push origin main --tags
+
+      - name: 🚀 Publish to NPM
+        run: |
+          if [[ "${{ inputs.release_type }}" == "alpha" || "${{ inputs.release_type }}" == "beta" ]]; then
+            npm run ci:publish -- --tag ${{ inputs.release_type }}
+          else
+            npm run ci:publish
+          fi
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: 🏷️ Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: ${{ needs.pre-release.outputs.tag }}
+          name: Better Logger ${{ needs.pre-release.outputs.version }}
+          body_path: RELEASE_NOTES.md
+          draft: false
+          prerelease: ${{ contains(inputs.release_type, 'alpha') || contains(inputs.release_type, 'beta') }}
+          files: |
+            better-logger-${{ needs.pre-release.outputs.version }}.tar.gz
+            better-logger-${{ needs.pre-release.outputs.version }}.zip
+            better-logger-core-${{ needs.pre-release.outputs.version }}.tar.gz
+            better-logger-styling-${{ needs.pre-release.outputs.version }}.tar.gz
+            better-logger-exports-${{ needs.pre-release.outputs.version }}.tar.gz
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  # ===== POST-RELEASE TASKS =====
+  post-release:
+    runs-on: ubuntu-latest
+    needs: [pre-release, create-release]
+    
+    steps:
+      - name: 📥 Checkout code
+        uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: 🔧 Install dependencies
+        run: npm ci
+
+      - name: 📥 Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dist
+          path: dist/
+
+      - name: 🚀 Deploy documentation
+        run: |
+          # Build documentation site
+          mkdir -p docs-site
+          cp demo.html docs-site/index.html
+          cp -r dist/ docs-site/dist/
+          cp -r docs/ docs-site/docs/
+          cp README.md docs-site/
+
+      - name: 📤 Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs-site
+          publish_branch: gh-pages
+          commit_message: 'docs: update documentation for ${{ needs.pre-release.outputs.version }}'
+
+      - name: 📊 Release summary
+        run: |
+          echo "## 🎉 Release Complete!" >> $GITHUB_STEP_SUMMARY
+          echo "- **Version**: ${{ needs.pre-release.outputs.version }}" >> $GITHUB_STEP_SUMMARY  
+          echo "- **NPM**: https://www.npmjs.com/package/@mks2508/better-logger" >> $GITHUB_STEP_SUMMARY
+          echo "- **GitHub**: https://github.com/MKS2508/advanced-logger/releases/tag/${{ needs.pre-release.outputs.tag }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Docs**: https://mks2508.github.io/advanced-logger/" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### 📦 Installation" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`bash" >> $GITHUB_STEP_SUMMARY
+          echo "npm install @mks2508/better-logger@${{ needs.pre-release.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY