@nikkory/vibe-engine 4.0.3 → 4.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nikkory/vibe-engine",
-  "version": "4.0.3",
+  "version": "4.0.5",
   "description": "Framework-agnostic code generation engine for Nikkory Vibe - Zero-token UI/UX code generation",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -61,6 +61,16 @@
     "typescript-eslint": "^8.49.0",
     "vitest": "^4.0.15"
   },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.mjs",
+    "dist/**/*.d.ts",
+    "!dist/**/*.map",
+    "bin",
+    "README.md",
+    "LICENSE",
+    "LOGO.txt"
+  ],
   "publishConfig": {
     "access": "public"
   }

package/PUBLISH-GUIDE.md

@@ -1,250 +0,0 @@
-# 📦 NPM Publish Guide - @nikkory/vibe-engine v4.0.0
-
-## ✅ Pre-Publish Checklist
-
-- [x] **Build completed**: `pnpm build` ✅
-- [x] **Hybrid logic implemented**: MatrixResolver ✅
-- [x] **Tests passing**: All 12 plan tasks complete ✅
-- [x] **Package.json valid**: Fixed with `npm pkg fix` ✅
-- [x] **.npmignore created**: Excludes test files ✅
-- [x] **Dry-run tested**: Package size ~1.5MB ✅
-
-## 📋 Package Info
-
-```json
-{
-  "name": "@nikkory/vibe-engine",
-  "version": "4.0.0",
-  "description": "Zero-token UI/UX code generation with Matrix Algorithm",
-  "bin": {
-    "vibe": "./bin/vibe.js"
-  },
-  "access": "public"
-}
-```
-
-## 🚀 Publish Steps
-
-### Step 1: Login to npm
-
-```bash
-cd packages/engine
-npm login
-```
-
-**Enter your credentials:**
-- Username: `kemonra` (or your npm username)
-- Password: [your npm password]
-- Email: [your npm email]
-- One-time password (OTP): [from authenticator app if 2FA enabled]
-
-### Step 2: Verify Login
-
-```bash
-npm whoami
-# Should output: kemonra
-```
-
-### Step 3: Final Dry Run
-
-```bash
-npm publish --dry-run
-```
-
-**Verify:**
-- Package name: `@nikkory/vibe-engine@4.0.0`
-- Tarball size: ~1.5MB
-- Files included: dist/, bin/, README.md, package.json
-- Files excluded: src/, test files, coverage/, *.map
-
-### Step 4: Publish to npm
-
-```bash
-npm publish --access public
-```
-
-**Expected output:**
-```
-+ @nikkory/vibe-engine@4.0.0
-```
-
-### Step 5: Verify Published Package
-
-```bash
-npm view @nikkory/vibe-engine
-npm view @nikkory/vibe-engine version
-```
-
-## 🧪 Test Installation (As End User)
-
-### Global Install
-
-```bash
-npm install -g @nikkory/vibe-engine
-```
-
-### Verify CLI
-
-```bash
-vibe --help
-vibe generate button material-design enterprise --factor-4=full
-```
-
-### Test Generation
-
-```bash
-# Create test directory
-mkdir ~/test-nikkory
-cd ~/test-nikkory
-
-# Generate enterprise button with override
-vibe generate button material-design enterprise --factor-4=full -o ./components
-
-# Verify generated files
-ls -la components/material-design/button/
-cat components/material-design/button/enterprise.tsx
-```
-
-**Expected output:**
-- ✅ Component file with `rounded-full` (override applied)
-- ✅ Types file with full TypeScript definitions
-- ✅ Test file with Vitest tests
-- ✅ All enterprise features (memo, forwardRef, analytics)
-
-## 📊 What Users Will Get
-
-### CLI Commands
-
-```bash
-# Generate single component
-vibe generate <component> <design-system> <tier> [options]
-
-# With factor overrides
-vibe generate button material-design enterprise --factor-4=full --factor-5=xl
-
-# Batch generation
-vibe batch -o ./output --ds material-design -t enterprise
-```
-
-### Generated Files Per Component
-
-1. **Component file** (`.tsx`):
-   - Enterprise tier: 150-300 LOC
-   - React.memo, forwardRef, useCallback
-   - Analytics tracking
-   - Full ARIA support
-
-2. **Types file** (`.types.ts`):
-   - Complete TypeScript definitions
-   - Variant and size types
-   - Event handler types
-
-3. **Test file** (`.test.tsx`):
-   - Vitest test suite
-   - Component rendering tests
-   - Props validation tests
-
-### Supported Features
-
-- **12 Design Systems**: Material, iOS, Glassmorphism, Neumorphism, Brutalism, Minimalism, etc.
-- **3 Quality Tiers**: Basic (30-50 LOC), Standard (50-150 LOC), Enterprise (150-300 LOC)
-- **40+ Component Types**: Button, Card, Input, Modal, Table, etc.
-- **24 Factors**: Color, Size, Variant, Shape, Shadow, Animation, etc.
-- **Hybrid Override System**: User values → ClassMapper, Defaults → Registry
-
-## 🔍 Package Stats
-
-**After .npmignore:**
-- **Total files**: ~150 files
-- **Size**: ~1.5MB (unpacked: ~4MB)
-- **Main exports**:
-  - `dist/index.js` (CJS): 577KB
-  - `dist/index.mjs` (ESM): 569KB
-  - `dist/browser.js`: 372KB (browser bundle)
-- **TypeScript definitions**: Full `.d.ts` files included
-
-## 📝 Post-Publish
-
-### Update README
-
-Add installation badge:
-
-```markdown
-[![npm version](https://img.shields.io/npm/v/@nikkory/vibe-engine.svg)](https://www.npmjs.com/package/@nikkory/vibe-engine)
-[![npm downloads](https://img.shields.io/npm/dm/@nikkory/vibe-engine.svg)](https://www.npmjs.com/package/@nikkory/vibe-engine)
-```
-
-### Create Release Notes
-
-GitHub release with:
-- Version: v4.0.0
-- Title: "Matrix Algorithm v4 - Hybrid Override System"
-- Changelog:
-  - ✅ Hybrid logic: ClassMapper + design-systems-registry
-  - ✅ CLI with factor overrides support
-  - ✅ 12 design systems × 3 tiers × 40+ components
-  - ✅ Enterprise-grade code generation
-
-### Social Media
-
-Twitter/LinkedIn post:
-```
-🚀 Just published @nikkory/vibe-engine v4.0.0!
-
-Zero-token UI component generation with Matrix Algorithm (M1×M2×M3×M4)
-
-✨ Features:
-- 12 design systems (Material, iOS, Glassmorphism, etc.)
-- 3 quality tiers (Basic → Enterprise)
-- 40+ component types
-- CLI with factor overrides
-- Enterprise-grade code
-
-npm i -g @nikkory/vibe-engine
-vibe generate button material-design enterprise
-
-Powered by Nikkory
-https://nikkory.com
-```
-
-## 🛟 Troubleshooting
-
-### Error: 401 Unauthorized
-
-```bash
-npm logout
-npm login
-npm publish --access public
-```
-
-### Error: Package already exists
-
-Version 4.0.0 already published? Update version:
-
-```bash
-npm version patch  # 4.0.1
-# or
-npm version minor  # 4.1.0
-```
-
-### Error: Missing bin file
-
-```bash
-chmod +x bin/vibe.js
-```
-
-## ✅ Success Criteria
-
-After publish, verify:
-
-- [ ] Package visible on npmjs.com: https://www.npmjs.com/package/@nikkory/vibe-engine
-- [ ] CLI installs globally: `npm i -g @nikkory/vibe-engine`
-- [ ] CLI works: `vibe --help`
-- [ ] Component generation works: `vibe generate button material-design enterprise`
-- [ ] Override works: `--factor-4=full` produces `rounded-full`
-- [ ] All files included: component + types + tests
-
----
-
-**Powered by Nikkory**
-https://nikkory.com

package/PUBLISH-SUCCESS.md

@@ -1,370 +0,0 @@
-# ✅ NPM Publish Success - @nikkory/vibe-engine v4.0.0
-
-## 🎉 PUBLISHED SUCCESSFULLY!
-
-```
-+ @nikkory/vibe-engine@4.0.0
-```
-
-**Published at**: 2026-01-11 04:36 UTC
-**Registry**: https://registry.npmjs.org/
-**Access**: public
-
----
-
-## 📦 Package Details
-
-| Property | Value |
-|----------|-------|
-| **Name** | `@nikkory/vibe-engine` |
-| **Version** | `4.0.0` |
-| **Tarball Size** | 532.5 KB |
-| **Unpacked Size** | 3.0 MB |
-| **Total Files** | 333 |
-| **License** | MIT |
-| **Author** | Nikkory <dev@nikkory.com> |
-
----
-
-## 🔗 Package Links
-
-- **npm Page**: https://www.npmjs.com/package/@nikkory/vibe-engine
-- **GitHub**: https://github.com/kemonra/nikkory-vibe/tree/main/packages/engine
-- **Documentation**: README.md
-
----
-
-## 📥 Installation (For End Users)
-
-### Global Install (Recommended for CLI)
-
-```bash
-npm install -g @nikkory/vibe-engine
-```
-
-### Local Install (For programmatic use)
-
-```bash
-npm install @nikkory/vibe-engine
-# or
-pnpm add @nikkory/vibe-engine
-# or
-yarn add @nikkory/vibe-engine
-```
-
----
-
-## 🧪 Test Installation
-
-### 1. Install Globally
-
-```bash
-npm install -g @nikkory/vibe-engine
-```
-
-### 2. Verify CLI
-
-```bash
-vibe --help
-```
-
-**Expected output:**
-```
-Nikkory Vibe CLI - Algorithm Engine
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-USAGE:
-  vibe <command> [options]
-
-COMMANDS:
-  generate    Generate a single component
-  batch       Generate multiple components
-...
-```
-
-### 3. Test Generation with Override
-
-```bash
-# Create test directory
-mkdir ~/test-nikkory-cli
-cd ~/test-nikkory-cli
-
-# Generate enterprise button with factor override
-vibe generate button material-design enterprise --factor-4=full -o ./output
-
-# Check generated files
-ls -la output/material-design/button/
-```
-
-### 4. Verify Override Works
-
-```bash
-# Check for rounded-full (override) instead of rounded-lg (default)
-cat output/material-design/button/enterprise.tsx | grep "rounded"
-```
-
-**Expected**: Should see `rounded-full` (from ClassMapper override)
-
-### 5. Test Glassmorphism Card
-
-```bash
-vibe generate card glassmorphism enterprise -o ./output
-cat output/glassmorphism/card/enterprise.tsx
-```
-
-**Expected**:
-- Glassmorphism styles: `backdrop-blur-lg`, `bg-white/20`
-- Enterprise features: `memo`, `forwardRef`, `analytics`
-
----
-
-## ✅ What Users Get
-
-### CLI Commands
-
-```bash
-# Generate single component
-vibe generate <component> <design-system> <tier> [options]
-
-# With factor overrides
-vibe generate button material-design enterprise \
-  --factor-4=full \
-  --factor-5=xl \
-  -o ./components
-
-# Batch generation
-vibe batch \
-  -o ./output \
-  --ds material-design \
-  -t enterprise \
-  -c button,card,input
-```
-
-### Generated Files (Per Component)
-
-1. **Component File** (`.tsx`):
-   - Enterprise: 150-300 LOC
-   - React.memo, forwardRef, useCallback
-   - Analytics tracking
-   - Full ARIA support
-   - Tailwind CSS styling
-
-2. **Types File** (`.types.ts`):
-   - Complete TypeScript definitions
-   - Variant and size types
-   - Event handler types
-   - Loading/error state types
-
-3. **Test File** (`.test.tsx`):
-   - Vitest test suite
-   - Component rendering tests
-   - Props validation tests
-   - Accessibility tests
-
-### Features
-
-- **12 Design Systems**: Material Design, iOS HIG, Glassmorphism, Neumorphism, Brutalism, Minimalism, Cyberpunk, Flat Design, Retro Vintage, Fluent Design, Carbon Design, Ant Design
-- **3 Quality Tiers**: Basic (30-50 LOC), Standard (50-150 LOC), Enterprise (150-300 LOC)
-- **40+ Component Types**: Button, Card, Input, Modal, Table, Alert, Badge, etc.
-- **24 Factors**: Color, Size, Variant, Shape, Shadow, Animation, etc.
-- **Hybrid Override System**: User overrides → ClassMapper, Defaults → Registry
-
----
-
-## 🎯 Key Achievements
-
-### ✅ Matrix Algorithm Implementation
-
-- **M1 × M2 × M3 × M4**: Full matrix multiplication
-- **Hybrid Approach**: ClassMapper (overrides) + design-systems-registry (defaults)
-- **24-Factor System**: Complete factor configuration
-- **Zero duplicate code**: Each system handles its domain
-
-### ✅ CLI Features
-
-- **Factor overrides**: `--factor-N=value` syntax
-- **Multiple output formats**: Component + Types + Tests
-- **Batch generation**: Multiple components at once
-- **Design system support**: 12 systems × 3 tiers
-
-### ✅ Code Quality
-
-- **Enterprise tier**: All 7 features verified
-  - React.memo
-  - forwardRef
-  - useCallback
-  - displayName
-  - Analytics tracking
-  - ARIA attributes
-  - Type safety
-
-- **Build quality**:
-  - Zero TypeScript errors
-  - Zero ESLint errors
-  - Full type definitions included
-  - Source maps available
-
----
-
-## 📊 Package Stats
-
-### Files Published (333 total)
-
-- `dist/index.js`: 577.7 KB (CJS)
-- `dist/index.mjs`: 569.7 KB (ESM)
-- `dist/browser.js`: 372.3 KB (Browser bundle)
-- `dist/*.d.ts`: Full TypeScript definitions (~150 files)
-- `bin/vibe.js`: CLI executable
-- `README.md`: 35.1 KB documentation
-- `PUBLISH-GUIDE.md`: 6.0 KB publish guide
-
-### Bundle Size
-
-| Format | Size | Use Case |
-|--------|------|----------|
-| CJS | 577.7 KB | Node.js require() |
-| ESM | 569.7 KB | Modern import |
-| Browser | 372.3 KB | Browser bundle |
-
----
-
-## 🔄 What Happens Next
-
-### Immediate (Within minutes)
-
-- ✅ Package appears on npmjs.com
-- ✅ Available for `npm install`
-- ✅ CLI available globally
-
-### Soon (Within hours)
-
-- Package indexed by npm search
-- Download stats begin tracking
-- Package appears in dependency graphs
-
-### You Can Do Now
-
-1. **Verify on npmjs.com**:
-   - Visit: https://www.npmjs.com/package/@nikkory/vibe-engine
-   - Check version, readme, files
-
-2. **Test install on another machine**:
-   ```bash
-   npm install -g @nikkory/vibe-engine
-   vibe --help
-   ```
-
-3. **Share the news**:
-   - Twitter/LinkedIn announcement
-   - Update project README with npm badge
-   - Create GitHub release v4.0.0
-
-4. **Create documentation**:
-   - Usage examples
-   - Video demo
-   - Tutorial blog post
-
----
-
-## 🎨 Example Outputs
-
-### Generated Enterprise Button (Material Design)
-
-```tsx
-export const MaterialButtonEnterprise = memo(
-  forwardRef<HTMLButtonElement, MaterialButtonEnterpriseProps>(
-    ({ analyticsEvent, onClick, children, ...props }, ref) => {
-      const handleClick = useCallback(
-        (e: React.MouseEvent<HTMLButtonElement>): void => {
-          if (analyticsEvent && typeof window !== "undefined") {
-            (window as unknown as { dataLayer?: unknown[] }).dataLayer?.push({
-              event: analyticsEvent,
-            });
-          }
-          onClick?.(e);
-        },
-        [analyticsEvent, onClick]
-      );
-
-      return (
-        <button
-          ref={ref}
-          onClick={handleClick}
-          className="bg-blue-500 hover:bg-blue-600 rounded-full ..."
-          {...props}
-        >
-          {children}
-        </button>
-      );
-    }
-  )
-);
-
-MaterialButtonEnterprise.displayName = 'MaterialButtonEnterprise';
-```
-
-### Generated Glassmorphism Card
-
-```tsx
-export const GlassCardEnterprise = memo(
-  forwardRef<HTMLArticleElement, GlassCardEnterpriseProps>(
-    ({ children, ...props }, ref) => {
-      return (
-        <article
-          ref={ref}
-          className="bg-white/20 backdrop-blur-lg border-white/20 rounded-2xl ..."
-          {...props}
-        >
-          {children}
-        </article>
-      );
-    }
-  )
-);
-```
-
----
-
-## 🚀 Future Updates
-
-### Planned Features
-
-- [ ] More design systems (15+ total)
-- [ ] More component types (60+ total)
-- [ ] Complete 24-factor ClassMapper (currently 3/24)
-- [ ] Visual builder integration
-- [ ] Theme customization
-- [ ] Plugin system
-
-### Version Roadmap
-
-- **v4.0.x**: Patches and bug fixes
-- **v4.1.0**: Additional factors in ClassMapper
-- **v4.2.0**: New design systems
-- **v5.0.0**: Visual builder integration
-
----
-
-## 📞 Support
-
-- **Issues**: https://github.com/kemonra/nikkory-vibe/issues
-- **Email**: dev@nikkory.com
-- **Website**: https://nikkory.com
-
----
-
-## 🎉 Celebration!
-
-**We did it!** 🎊
-
-The hybrid approach implementation is complete and published:
-
-- ✅ 12/12 plan tasks completed
-- ✅ Hybrid logic implemented and verified
-- ✅ CLI tested with overrides
-- ✅ Enterprise quality verified
-- ✅ Package published to npm
-- ✅ Ready for users
-
-**Powered by Nikkory** 🚀
-https://nikkory.com

package/tests/16-factor-integration.test.d.ts

@@ -1,14 +0,0 @@
-/**
- * 16-Factor Integration Tests
- *
- * Integration tests for the complete 16-factor system in StyleGenerator.
- * Tests factor combinations and ensures all factors work together correctly.
- *
- * @packageDocumentation
- * @module tests/generator/16-factor-integration
- * @since 2.0.0
- *
- * Powered by Nikkory
- */
-export {};
-//# sourceMappingURL=16-factor-integration.test.d.ts.map

package/tests/16-factor-visual.test.d.ts

@@ -1,14 +0,0 @@
-/**
- * 16-Factor Visual E2E Tests
- *
- * End-to-end tests for visual verification of 16-Factor system.
- * These tests verify that factor props correctly apply visual styles.
- *
- * @packageDocumentation
- * @module __tests__/e2e/16-factor-visual
- * @since 2.1.0
- *
- * Powered by Nikkory
- */
-export {};
-//# sourceMappingURL=16-factor-visual.test.d.ts.map

package/tests/5-level-integration.test.d.ts

@@ -1,14 +0,0 @@
-/**
- * 5-Level Abstraction Integration Tests
- *
- * Integration tests for the 5-Level Abstraction API with component props.
- * Tests that MultiLevelProps works correctly across all levels.
- *
- * @packageDocumentation
- * @module tests/resolution/5-level-integration
- * @since 2.1.0
- *
- * Powered by Nikkory
- */
-export {};
-//# sourceMappingURL=5-level-integration.test.d.ts.map

package/tests/CodeUtils.test.d.ts

@@ -1,7 +0,0 @@
-/**
- * CodeUtils Tests
- *
- * Powered by Nikkory
- */
-export {};
-//# sourceMappingURL=CodeUtils.test.d.ts.map

package/tests/DesignSystems.test.d.ts

@@ -1,7 +0,0 @@
-/**
- * DesignSystems Constants Tests
- *
- * Powered by Nikkory
- */
-export {};
-//# sourceMappingURL=DesignSystems.test.d.ts.map

package/tests/GenerateComponentValidator.test.d.ts

@@ -1,7 +0,0 @@
-/**
- * GenerateComponentValidator Tests
- *
- * Powered by Nikkory
- */
-export {};
-//# sourceMappingURL=GenerateComponentValidator.test.d.ts.map