@nikkory/vibe-cli 2.4.2 → 2.4.4

package/dist/index.js

@@ -25,7 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/index.ts
 var import_commander6 = require("commander");
-var import_chalk5 = __toESM(require("chalk"));
+var import_chalk6 = __toESM(require("chalk"));
 
 // src/commands/init.ts
 var fs = __toESM(require("fs/promises"));
@@ -7528,12 +7528,64 @@ var pageGenerateCommand = new import_commander5.Command("add:page").alias("page"
   }
 });
 
+// src/utils/first-run.ts
+var import_fs = require("fs");
+var import_path3 = require("path");
+var import_os = require("os");
+var import_chalk5 = __toESM(require("chalk"));
+var CONFIG_DIR = (0, import_path3.join)((0, import_os.homedir)(), ".nikkory-vibe");
+var FIRST_RUN_FILE = (0, import_path3.join)(CONFIG_DIR, ".first-run");
+function isFirstRun() {
+  return !(0, import_fs.existsSync)(FIRST_RUN_FILE);
+}
+function markAsRun() {
+  if (!(0, import_fs.existsSync)(CONFIG_DIR)) {
+    (0, import_fs.mkdirSync)(CONFIG_DIR, { recursive: true });
+  }
+  (0, import_fs.writeFileSync)(FIRST_RUN_FILE, (/* @__PURE__ */ new Date()).toISOString(), "utf-8");
+}
+function showWelcomeIfFirstRun() {
+  if (!isFirstRun()) return;
+  const y2 = import_chalk5.default.hex("#fcb800");
+  const banner2 = `
+${y2.bold("\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557")}
+${y2.bold("\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D")}
+${y2.bold("\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u255A\u2588\u2588\u2588\u2588\u2554\u255D ")}
+${y2.bold("\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557  \u255A\u2588\u2588\u2554\u255D  ")}
+${y2.bold("\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   ")}
+${y2.bold("\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   ")}
+
+${y2.bold("             \u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557              ")}
+${y2.bold("             \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D              ")}
+${y2.bold("             \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557                ")}
+${y2.bold("             \u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u255D                ")}
+${y2.bold("              \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557              ")}
+${y2.bold("               \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D              ")}
+
+${y2("                 happy together")} ${import_chalk5.default.white("\u2022 v2.4.4")}
+
+${import_chalk5.default.gray("    Production-ready code in seconds")}
+${import_chalk5.default.gray("           https://nikkory.com")}
+
+${import_chalk5.default.green("\u2713 Thanks for installing Nikkory Vibe CLI!")}
+
+${import_chalk5.default.cyan("Quick Start:")}
+  ${import_chalk5.default.white("nikkory-vibe add button")}            ${import_chalk5.default.gray("# Generate button component")}
+  ${import_chalk5.default.white("nikkory-vibe add:section hero")}      ${import_chalk5.default.gray("# Generate hero section")}
+  ${import_chalk5.default.white("nikkory-vibe list")}                  ${import_chalk5.default.gray("# Browse available templates")}
+
+${y2("  169 Components")} ${import_chalk5.default.gray("+")} ${y2("50 Sections")} ${import_chalk5.default.gray("\xD7")} ${y2("12 Systems")} ${import_chalk5.default.gray("\xD7")} ${y2("3 Tiers")}
+`;
+  console.log(banner2);
+  markAsRun();
+}
+
 // src/index.ts
 var componentCount = 169;
 var sectionCount = 50;
 var designSystemCount = 12;
 var tierCount = 3;
-var y = import_chalk5.default.hex("#fcb800");
+var y = import_chalk6.default.hex("#fcb800");
 var banner = `
 ${y.bold("\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557")}
 ${y.bold("\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D")}
@@ -7549,15 +7601,16 @@ ${y.bold("             \u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u
 ${y.bold("              \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557              ")}
 ${y.bold("               \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D              ")}
 
-${y("                 happy together")} ${import_chalk5.default.white("\u2022 v2.4.2")}
+${y("                 happy together")} ${import_chalk6.default.white("\u2022 v2.4.4")}
 
-${import_chalk5.default.gray("    Production-ready code in seconds")}
-${import_chalk5.default.gray("           https://nikkory.com")}
+${import_chalk6.default.gray("    Production-ready code in seconds")}
+${import_chalk6.default.gray("           https://nikkory.com")}
 
-${y(`  ${componentCount} Components`)} ${import_chalk5.default.gray("+")} ${y(`${sectionCount} Sections`)} ${import_chalk5.default.gray("\xD7")} ${y(`${designSystemCount} Systems`)} ${import_chalk5.default.gray("\xD7")} ${y(`${tierCount} Tiers`)}
+${y(`  ${componentCount} Components`)} ${import_chalk6.default.gray("+")} ${y(`${sectionCount} Sections`)} ${import_chalk6.default.gray("\xD7")} ${y(`${designSystemCount} Systems`)} ${import_chalk6.default.gray("\xD7")} ${y(`${tierCount} Tiers`)}
 `;
+showWelcomeIfFirstRun();
 var program = new import_commander6.Command();
-program.name("nikkory-vibe").description("Nikkory Vibe - Production-ready code in seconds").version("2.4.2").addHelpText("before", banner);
+program.name("nikkory-vibe").description("Nikkory Vibe - Production-ready code in seconds").version("2.4.4").addHelpText("before", banner);
 program.addCommand(matrixGenerateCommand);
 program.addCommand(sectionGenerateCommand);
 program.addCommand(pageGenerateCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nikkory/vibe-cli",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "description": "CLI tool for Nikkory Vibe - Generate production-ready code in seconds",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -8,6 +8,10 @@
     "nikkory-vibe": "./dist/index.js",
     "vibe": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",

package/CHANGELOG.md

@@ -1,234 +0,0 @@
-# Changelog
-
-All notable changes to @nikkory/vibe-cli 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).
-
-## [4.0.0] - 2026-01-04
-
-### 🎉 Major Release - Multi-Framework Architecture
-
-Complete CLI redesign with new command structure for multi-framework support.
-
-### Added
-
-#### Multi-Framework Support
-
-- **New Command Pattern**: `nikkory-vibe <scope> <action> <granularity> <target> [options]`
-- **Scope System**: Framework-specific handlers (react, vue, pattern, engine)
-- **React Scope**: Full support for React component generation
-- **Pattern Scope**: Design pattern browsing and search
-- **Engine Scope**: Vibe engine utilities
-
-#### Config File Support (Phase 3)
-
-- **Auto-discovery**: Automatically finds `nikkory-vibe.config.ts` in current directory
-- **Config Schema**: TypeScript-first configuration with full type safety
-- **Config Loader**: Supports `.ts`, `.mts`, `.js`, `.mjs`, `.cjs` files
-- **Deep Merging**: Config values override defaults intelligently
-- **Per-Framework Config**: Customize settings for each framework
-- **Output Structure**: Customize output directories per granularity level
-- **Example Config**: `nikkory-vibe.config.example.ts` included
-
-#### Interactive Wizard Mode (Phase 3)
-
-- **Step-by-Step Generation**: Interactive prompts for component creation
-- **5 Action Flows**: generate, list, search, info, preview
-- **Smart Question Routing**: Questions adapt based on selected action
-- **Input Validation**: Validates component names, required fields
-- **Summary Preview**: Shows configuration before generation
-- **Emoji UI**: Enhanced visual feedback
-- **Shorthand**: `-i` or `--interactive` flag
-
-#### Type System (Phase 1)
-
-- **CommandScope**: `react`, `vue`, `svelte`, `angular`, `pattern`, `engine`
-- **ComponentGranularity**: `atom`, `component`, `section`, `page`, `layout`, `template`
-- **IScopeHandler**: Interface for framework-specific handlers
-- **CLIOptions**: Comprehensive options type system
-
-#### Scope Handlers (Phase 2)
-
-- **ReactScopeHandler**: Full React component generation
-- **PatternScopeHandler**: Design pattern management
-- **EngineScopeHandler**: Engine utilities
-- **VueScopeHandler**: Stub for v4.1.0
-- **SvelteScopeHandler**: Stub for v4.2.0
-
-### Changed
-
-- **Bundle Size**: Reduced from 190KB to 142KB (25% smaller)
-- **Binary Name**: `nikkory-vibe` is new primary (legacy `vibe` still works)
-- **Command Structure**: New scope-based pattern (legacy commands deprecated)
-- **Import Organization**: Improved ESLint compliance with strict import order
-
-### Deprecated
-
-- **Legacy Commands** (will be removed in v5.0.0):
-  - `vibe add` → Use `nikkory-vibe react generate atom`
-  - `vibe copy` → Use `nikkory-vibe react list` + manual copy
-  - `vibe generate` (old style) → Use new scope-based pattern
-  - `vibe matrix` → Disabled (TypeScript errors)
-  - `vibe smart` → Disabled (TypeScript errors)
-
-### Removed
-
-- **Matrix Command**: Temporarily disabled due to TypeScript errors
-- **Smart Command**: Temporarily disabled due to TypeScript errors
-- **Old Generate Command**: Temporarily disabled due to missing types
-
-### Fixed
-
-- **TypeScript Errors**: Zero errors in new Phase 1-3 code
-- **ESLint Errors**: Zero errors in new Phase 1-3 code
-- **Import Order**: Fixed type import ordering in handlers and types
-- **Build Process**: Successful compilation with reduced bundle size
-
-### Migration
-
-See [MIGRATION-v3-v4.md](./MIGRATION-v3-v4.md) for detailed migration guide.
-
-**Quick Migration**:
-
-```bash
-# v3.x (Legacy)
-vibe add button --style=material --tier=standard
-
-# v4.0.0 (New)
-nikkory-vibe react generate atom button --design=material-design --tier=standard
-
-# Or with config file
-nikkory-vibe react generate atom button
-```
-
-### Documentation
-
-- **README.md**: Completely rewritten for v4.0.0
-- **MIGRATION-v3-v4.md**: Comprehensive migration guide
-- **nikkory-vibe.config.example.ts**: Example configuration file
-
-### Quality Metrics
-
-**Phase 1-2** (Types + Handlers):
-
-- 📝 Files Created: 15+
-- 📊 Lines of Code: ~800
-- ✅ TypeScript Errors: 0
-- ✅ ESLint Errors: 0
-- ✅ Build: SUCCESS (190KB)
-
-**Phase 3** (Config + Interactive):
-
-- 📝 Files Created: 8
-- 📊 Lines of Code: 1,287
-- ✅ TypeScript Errors: 0 (in new code)
-- ✅ ESLint Errors: 0 (in new code)
-- ✅ Build: SUCCESS (142KB, -25%)
-
-**Phase 4** (Quality Gate - Partial):
-
-- ✅ Legacy commands disabled
-- ✅ Import order fixed
-- ✅ Documentation updated
-
-**Overall Progress**: 75% complete (Phase 0-4 done, Phase 5-7 remaining)
-
-### Technical Details
-
-**New Files**:
-
-- `src/types/command.ts` - CLI command types
-- `src/types/enums.ts` - Scope and action enums
-- `src/types/granularity.ts` - Component granularity types
-- `src/types/handler.ts` - Scope handler interface
-- `src/scopes/react.ts` - React scope handler
-- `src/scopes/pattern.ts` - Pattern scope handler
-- `src/scopes/engine.ts` - Engine scope handler
-- `src/scopes/vue.ts` - Vue scope handler (stub)
-- `src/scopes/svelte.ts` - Svelte scope handler (stub)
-- `src/config/schema.ts` - Config type definitions (220 LOC)
-- `src/config/loader.ts` - Config file loader (306 LOC)
-- `src/config/index.ts` - Config barrel exports
-- `src/interactive/questions.ts` - Inquirer prompts (173 LOC)
-- `src/interactive/wizard.ts` - Interactive wizard (361 LOC)
-- `src/interactive/index.ts` - Interactive barrel exports
-- `nikkory-vibe.config.example.ts` - Example config (132 LOC)
-
-**Modified Files**:
-
-- `src/cli.ts` - Integrated config loading and interactive mode (+40 LOC)
-- `src/types/handler.ts` - Fixed import order
-
-### Breaking Changes
-
-1. **Command Structure**: New scope-based pattern required
-
-   ```bash
-   # Before
-   vibe add button
-
-   # After
-   nikkory-vibe react generate atom button
-   ```
-
-2. **Scope Required**: Must specify framework scope
-
-   ```bash
-   # ❌ Error
-   nikkory-vibe generate atom button
-
-   # ✅ Correct
-   nikkory-vibe react generate atom button
-   ```
-
-3. **Option Names**: Some options renamed
-   - `--style` → `--design` (design system)
-
-### Upgrade Instructions
-
-```bash
-# Update package
-pnpm add @nikkory/vibe-cli@latest
-
-# Create config file (optional)
-cp node_modules/@nikkory/vibe-cli/nikkory-vibe.config.example.ts nikkory-vibe.config.ts
-
-# Update scripts in package.json
-{
-  "scripts": {
-    "vibe": "nikkory-vibe react --interactive"
-  }
-}
-```
-
-### Known Issues
-
-- Matrix command disabled (TypeScript errors, will be fixed in v4.0.1)
-- Smart command disabled (TypeScript errors, will be fixed in v4.0.1)
-- Vue/Svelte/Angular scopes not yet implemented (coming v4.1.0+)
-
-### Contributors
-
-- **Planner & Developer**: Nikkory Team
-- **AI Assistant**: Claude Code (Sonnet 4.5)
-
-### Next Release (v4.0.1)
-
-Planned fixes:
-
-- Fix TypeScript errors in matrix command
-- Fix TypeScript errors in smart command
-- Add unit tests for config loader
-- Add unit tests for interactive wizard
-
-### Future Releases
-
-- **v4.1.0**: Vue framework support
-- **v4.2.0**: Svelte framework support
-- **v4.3.0**: Angular framework support
-- **v5.0.0**: Remove all legacy commands
-
----
-
-**Powered by Nikkory**

package/nikkory-vibe.config.example.d.ts

@@ -1,23 +0,0 @@
-/**
- * Nikkory Vibe Configuration Example
- *
- * Copy this file to your project root as `nikkory-vibe.config.ts`
- * to customize CLI defaults and output directories.
- *
- * @example
- * ```bash
- * # Copy to your project
- * cp nikkory-vibe.config.example.ts nikkory-vibe.config.ts
- *
- * # Use the config
- * nikkory-vibe react generate atom button
- * # Will use defaultTier='enterprise' from config
- * ```
- *
- * @since 4.0.0
- * Powered by Nikkory
- */
-import type { NikkoryVibeConfig } from '@nikkory/vibe-cli';
-declare const config: NikkoryVibeConfig;
-export default config;
-//# sourceMappingURL=nikkory-vibe.config.example.d.ts.map

package/nikkory-vibe.config.example.ts

@@ -1,143 +0,0 @@
-/**
- * Nikkory Vibe Configuration Example
- *
- * Copy this file to your project root as `nikkory-vibe.config.ts`
- * to customize CLI defaults and output directories.
- *
- * @example
- * ```bash
- * # Copy to your project
- * cp nikkory-vibe.config.example.ts nikkory-vibe.config.ts
- *
- * # Use the config
- * nikkory-vibe react generate atom button
- * # Will use defaultTier='enterprise' from config
- * ```
- *
- * @since 4.0.0
- * Powered by Nikkory
- */
-
-import type { NikkoryVibeConfig } from '@nikkory/vibe-cli';
-
-const config: NikkoryVibeConfig = {
-  // ============================================================================
-  // DEFAULT VALUES
-  // ============================================================================
-
-  /**
-   * Default framework scope
-   *
-   * When no scope is specified, use this framework.
-   * Options: 'react', 'vue', 'svelte', 'angular', 'pattern', 'engine'
-   */
-  defaultScope: 'react',
-
-  /**
-   * Default quality tier
-   *
-   * Determines code quality level for generated components.
-   * Options: 'basic' | 'standard' | 'enterprise'
-   *
-   * - basic: Simple components for prototyping (30-50 LOC)
-   * - standard: Production-ready with variants (50-150 LOC)
-   * - enterprise: Full analytics, accessibility, memoization (150-300 LOC)
-   */
-  defaultTier: 'enterprise',
-
-  /**
-   * Default design system
-   *
-   * Visual style for generated components.
-   * Options: 'material-design', 'ios-hig', 'glassmorphism', 'neumorphism',
-   *          'brutalism', 'minimalism'
-   */
-  defaultDesignSystem: 'material-design',
-
-  // ============================================================================
-  // OUTPUT DIRECTORIES
-  // ============================================================================
-
-  /**
-   * Output structure for different component granularities
-   *
-   * Customize where generated files are saved.
-   * All paths are relative to current working directory.
-   */
-  outputStructure: {
-    atoms: './src/components/atoms',       // Small UI primitives (buttons, inputs)
-    components: './src/components',        // Composite components (cards, modals)
-    sections: './src/sections',            // Page sections (hero, pricing)
-    pages: './src/pages',                  // Complete pages
-    layouts: './src/layouts',              // Layout templates
-    templates: './src/templates',          // Full page templates
-  },
-
-  // ============================================================================
-  // FRAMEWORK-SPECIFIC SETTINGS
-  // ============================================================================
-
-  /**
-   * Per-framework configuration
-   *
-   * Customize settings for each framework scope.
-   */
-  frameworks: {
-    react: {
-      typescript: true,
-      styleLibrary: 'tailwind',
-      // Add custom React-specific settings here
-    },
-    vue: {
-      typescript: true,
-      styleLibrary: 'tailwind',
-      composition: true, // Use Composition API
-      // Add custom Vue-specific settings here
-    },
-    svelte: {
-      typescript: true,
-      styleLibrary: 'tailwind',
-      // Add custom Svelte-specific settings here
-    },
-    angular: {
-      typescript: true,
-      styleLibrary: 'tailwind',
-      // Add custom Angular-specific settings here
-    },
-    pattern: {
-      typescript: true,
-    },
-    engine: {
-      typescript: true,
-    },
-  },
-
-  // ============================================================================
-  // GLOBAL OPTIONS
-  // ============================================================================
-
-  /**
-   * Force overwrite existing files
-   *
-   * When true, CLI will not prompt before overwriting files.
-   * Use with caution in production!
-   */
-  forceOverwrite: false,
-
-  /**
-   * Verbose output
-   *
-   * When true, CLI shows detailed logs for debugging.
-   */
-  verbose: false,
-
-  /**
-   * Dry run mode
-   *
-   * When true, CLI previews changes without writing files.
-   * Useful for testing commands.
-   */
-  dryRun: false,
-};
-
-export default config;

package/tsup.config.d.ts

@@ -1,3 +0,0 @@
-declare const _default: import("tsup").Options | import("tsup").Options[] | ((overrideOptions: import("tsup").Options) => import("tsup").Options | import("tsup").Options[] | Promise<import("tsup").Options | import("tsup").Options[]>);
-export default _default;
-//# sourceMappingURL=tsup.config.d.ts.map