@nikkory/vibe-engine 4.0.0

package/dist/cli/batch-command.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Batch Command
+ * CLI command for batch generation of components
+ *
+ * @packageDocumentation
+ * @module cli/batch-command
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Tier, DesignSystem, ComponentType } from '../types';
+import type { BatchGenerationResult, GenerationResultItem, FactorId } from '../types/algorithm-engine.types';
+/**
+ * Batch command options
+ */
+export interface BatchCommandOptions {
+    /** Component types to generate (default: all) */
+    components?: readonly ComponentType[];
+    /** Design systems to generate for (default: all) */
+    designSystems?: readonly DesignSystem[];
+    /** Tiers to generate (default: all) */
+    tiers?: readonly Tier[];
+    /** Output directory */
+    outputDir: string;
+    /** Overwrite existing files */
+    overwrite?: boolean;
+    /** Factor overrides to apply to all components */
+    factorOverrides?: Partial<Record<FactorId, string>>;
+    /** Dry run (don't write files) */
+    dryRun?: boolean;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Parallel generation count */
+    parallelCount?: number;
+}
+/**
+ * Batch generation progress callback
+ */
+export type BatchProgressCallback = (current: number, total: number, item: GenerationResultItem) => void;
+/**
+ * Batch Command
+ *
+ * Handles batch generation of components across design systems and tiers
+ *
+ * @example
+ * ```typescript
+ * const command = new BatchCommand();
+ *
+ * // Generate all components for all design systems
+ * const result = await command.execute({
+ *   outputDir: './generated',
+ *   overwrite: true,
+ * });
+ *
+ * console.log(`Generated ${result.successful} components`);
+ * ```
+ */
+export declare class BatchCommand {
+    private generator;
+    constructor();
+    /**
+     * Execute batch generation
+     *
+     * @param options - Batch command options
+     * @param onProgress - Optional progress callback
+     * @returns Batch generation result
+     */
+    execute(options: BatchCommandOptions, onProgress?: BatchProgressCallback): BatchGenerationResult;
+    /**
+     * Get estimated generation count
+     *
+     * @param options - Batch command options
+     * @returns Object with count details
+     */
+    getEstimatedCount(options: Partial<BatchCommandOptions>): {
+        components: number;
+        designSystems: number;
+        tiers: number;
+        total: number;
+    };
+    /**
+     * Validate batch options
+     *
+     * @param options - Options to validate
+     * @returns Validation result
+     */
+    validateOptions(options: BatchCommandOptions): {
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * Get available options for CLI help
+     *
+     * @returns Object with available values
+     */
+    getAvailableOptions(): {
+        componentTypes: ComponentType[];
+        designSystems: DesignSystem[];
+        tiers: Tier[];
+    };
+    /**
+     * Generate a single component
+     */
+    private generateSingle;
+    /**
+     * Generate a unique component ID
+     */
+    private generateComponentId;
+}
+/**
+ * Create a new batch command instance
+ */
+export declare function createBatchCommand(): BatchCommand;
+/**
+ * Execute batch generation with default options
+ *
+ * @param options - Batch options
+ * @param onProgress - Progress callback
+ * @returns Batch result
+ */
+export declare function executeBatch(options: BatchCommandOptions, onProgress?: BatchProgressCallback): BatchGenerationResult;
+/**
+ * Get batch generation estimate
+ *
+ * @param options - Partial batch options
+ * @returns Estimate object
+ */
+export declare function getBatchEstimate(options: Partial<BatchCommandOptions>): {
+    components: number;
+    designSystems: number;
+    tiers: number;
+    total: number;
+};
+/**
+ * Parse CLI arguments for batch command
+ *
+ * @param args - CLI arguments
+ * @returns Parsed batch options
+ */
+export declare function parseBatchArgs(args: string[]): Partial<BatchCommandOptions>;
+//# sourceMappingURL=batch-command.d.ts.map

package/dist/cli/generate-command.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Generate Command
+ * CLI command for single component generation
+ *
+ * @packageDocumentation
+ * @module cli/generate-command
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Tier, DesignSystem, ComponentType } from '../types';
+import type { FactorId } from '../types/algorithm-engine.types';
+/**
+ * Generate command options
+ */
+export interface GenerateCommandOptions {
+    /** Component type to generate */
+    readonly componentType: ComponentType;
+    /** Design system to use */
+    readonly designSystem: DesignSystem;
+    /** Quality tier */
+    readonly tier: Tier;
+    /** Output directory */
+    readonly outputDir: string;
+    /** Factor overrides */
+    readonly factorOverrides?: Partial<Record<FactorId, string>>;
+    /** Dry run mode (no file writes) */
+    readonly dryRun?: boolean;
+    /** Include TypeScript types file */
+    readonly includeTypes?: boolean;
+    /** Include test file */
+    readonly includeTests?: boolean;
+    /** Include Storybook stories */
+    readonly includeStories?: boolean;
+}
+/**
+ * Generate command result
+ */
+export interface GenerateCommandResult {
+    /** Whether generation succeeded */
+    readonly success: boolean;
+    /** Error message if failed */
+    readonly error?: string;
+    /** Generated component name */
+    readonly componentName?: string;
+    /** Output file path */
+    readonly outputPath?: string;
+    /** Types file path (if generated) */
+    readonly typesPath?: string;
+    /** Test file path (if generated) */
+    readonly testPath?: string;
+    /** Story file path (if generated) */
+    readonly storyPath?: string;
+    /** Lines of code */
+    readonly linesOfCode?: number;
+    /** Generated code (dry run only) */
+    readonly code?: string;
+}
+/**
+ * Execute generate command
+ *
+ * @param options - Generate command options
+ * @returns Generation result
+ *
+ * @example
+ * ```typescript
+ * const result = generateCommand({
+ *   componentType: 'button',
+ *   designSystem: 'material-design',
+ *   tier: 'enterprise',
+ *   outputDir: './generated',
+ * });
+ * ```
+ */
+export declare function generateCommand(options: GenerateCommandOptions): GenerateCommandResult;
+/**
+ * Parse generate command arguments
+ *
+ * @param args - CLI arguments
+ * @returns Parsed generate options
+ * @throws Error if required arguments are missing or invalid
+ *
+ * @example
+ * ```typescript
+ * // vibe generate button material-design enterprise -o ./output
+ * const options = parseGenerateArgs(['button', 'material-design', 'enterprise', '-o', './output']);
+ * ```
+ */
+export declare function parseGenerateArgs(args: string[]): GenerateCommandOptions;
+/**
+ * Validate generate command options
+ *
+ * @param options - Options to validate
+ * @returns Validation result
+ */
+export declare function validateGenerateOptions(options: GenerateCommandOptions): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get available options for CLI help
+ *
+ * @returns Available values for each option
+ */
+export declare function getAvailableOptions(): {
+    componentTypes: ComponentType[];
+    designSystems: DesignSystem[];
+    tiers: Tier[];
+};
+/**
+ * Format component name from input
+ *
+ * @param componentType - Component type
+ * @param designSystem - Design system
+ * @param tier - Quality tier
+ * @returns Formatted component name
+ */
+export declare function formatComponentName(componentType: ComponentType, designSystem: DesignSystem, tier: Tier): string;
+//# sourceMappingURL=generate-command.d.ts.map

package/dist/cli/index.d.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * Nikkory Vibe CLI
+ * Command-line interface for the Algorithm Engine
+ *
+ * @packageDocumentation
+ * @module cli
+ * @since 4.0.0
+ *
+ * Usage:
+ *   vibe generate component button material-design enterprise
+ *   vibe generate --batch --ds material-design
+ *   vibe --help
+ *
+ * Powered by Nikkory
+ */
+/**
+ * CLI Command result
+ */
+export interface CommandResult {
+    readonly success: boolean;
+    readonly message: string;
+    readonly data?: unknown;
+}
+/**
+ * Main CLI entry point
+ *
+ * @param args - Command line arguments (process.argv.slice(2))
+ * @returns Command result
+ */
+export declare function main(args: string[]): CommandResult;
+export { generateCommand, parseGenerateArgs } from './generate-command';
+export { BatchCommand, parseBatchArgs, executeBatch, getBatchEstimate } from './batch-command';
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/ComponentTypes.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Component Types Constants
+ *
+ * All supported component types in Nikkory Vibe Library.
+ *
+ * Powered by Nikkory
+ */
+/**
+ * Basic UI Components
+ */
+export declare const BASIC_COMPONENTS: readonly ["button", "input", "textarea", "checkbox", "radio", "select", "switch", "slider"];
+/**
+ * Layout Components
+ */
+export declare const LAYOUT_COMPONENTS: readonly ["card", "container", "grid", "flex", "stack", "divider", "spacer"];
+/**
+ * Navigation Components
+ */
+export declare const NAVIGATION_COMPONENTS: readonly ["navbar", "sidebar", "breadcrumb", "tabs", "pagination", "menu", "dropdown"];
+/**
+ * Feedback Components
+ */
+export declare const FEEDBACK_COMPONENTS: readonly ["modal", "dialog", "toast", "alert", "spinner", "skeleton", "progress"];
+/**
+ * Data Display Components
+ */
+export declare const DATA_DISPLAY_COMPONENTS: readonly ["table", "list", "avatar", "badge", "chip", "tag", "tooltip"];
+/**
+ * Form Components
+ */
+export declare const FORM_COMPONENTS: readonly ["form", "form-field", "date-picker", "time-picker", "file-upload", "color-picker", "autocomplete"];
+/**
+ * Advanced Components
+ */
+export declare const ADVANCED_COMPONENTS: readonly ["accordion", "carousel", "stepper", "timeline", "tree-view", "data-grid", "virtualized-list"];
+/**
+ * All Component Types
+ */
+export declare const ALL_COMPONENT_TYPES: readonly ["button", "input", "textarea", "checkbox", "radio", "select", "switch", "slider", "card", "container", "grid", "flex", "stack", "divider", "spacer", "navbar", "sidebar", "breadcrumb", "tabs", "pagination", "menu", "dropdown", "modal", "dialog", "toast", "alert", "spinner", "skeleton", "progress", "table", "list", "avatar", "badge", "chip", "tag", "tooltip", "form", "form-field", "date-picker", "time-picker", "file-upload", "color-picker", "autocomplete", "accordion", "carousel", "stepper", "timeline", "tree-view", "data-grid", "virtualized-list"];
+/**
+ * Alias for backward compatibility
+ * @deprecated Use ALL_COMPONENT_TYPES instead
+ */
+export declare const CURRENT_COMPONENT_TYPES: readonly ["button", "input", "textarea", "checkbox", "radio", "select", "switch", "slider", "card", "container", "grid", "flex", "stack", "divider", "spacer", "navbar", "sidebar", "breadcrumb", "tabs", "pagination", "menu", "dropdown", "modal", "dialog", "toast", "alert", "spinner", "skeleton", "progress", "table", "list", "avatar", "badge", "chip", "tag", "tooltip", "form", "form-field", "date-picker", "time-picker", "file-upload", "color-picker", "autocomplete", "accordion", "carousel", "stepper", "timeline", "tree-view", "data-grid", "virtualized-list"];
+/**
+ * Component Type Union
+ */
+export type ComponentType = (typeof ALL_COMPONENT_TYPES)[number];
+/**
+ * Component Category
+ */
+export type ComponentCategory = 'basic' | 'layout' | 'navigation' | 'feedback' | 'data-display' | 'form' | 'advanced';
+/**
+ * Component Category Map
+ */
+export declare const COMPONENT_CATEGORIES: Record<ComponentCategory, readonly string[]>;
+/**
+ * Get category for a component type
+ */
+export declare function getComponentCategory(componentType: string): ComponentCategory | undefined;
+/**
+ * Check if a string is a valid component type
+ */
+export declare function isValidComponentType(type: string): type is ComponentType;
+//# sourceMappingURL=ComponentTypes.d.ts.map

package/dist/constants/DesignSystems.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Design Systems Constants
+ *
+ * All supported design systems in Nikkory Vibe.
+ *
+ * Powered by Nikkory
+ */
+/**
+ * Current Design Systems (Implemented)
+ */
+export declare const CURRENT_DESIGN_SYSTEMS: readonly ["material-design", "ios-hig", "glassmorphism", "neumorphism", "brutalism", "minimalism", "cyberpunk", "flat-design", "retro-vintage", "fluent-design", "carbon-design", "ant-design"];
+/**
+ * Planned Design Systems (Future)
+ */
+export declare const PLANNED_DESIGN_SYSTEMS: readonly ["skeuomorphism", "art-deco", "memphis", "bauhaus", "swiss-design", "organic-natural", "futuristic", "handcrafted", "corporate", "playful", "elegant", "dark-mode", "high-contrast", "accessibility-first", "dashboard", "e-commerce", "social-media", "gaming", "healthcare", "fintech", "education"];
+/**
+ * All Design Systems (Current + Planned)
+ */
+export declare const ALL_DESIGN_SYSTEMS: readonly ["material-design", "ios-hig", "glassmorphism", "neumorphism", "brutalism", "minimalism", "cyberpunk", "flat-design", "retro-vintage", "fluent-design", "carbon-design", "ant-design", "skeuomorphism", "art-deco", "memphis", "bauhaus", "swiss-design", "organic-natural", "futuristic", "handcrafted", "corporate", "playful", "elegant", "dark-mode", "high-contrast", "accessibility-first", "dashboard", "e-commerce", "social-media", "gaming", "healthcare", "fintech", "education"];
+/**
+ * Design System Union Type
+ */
+export type DesignSystem = (typeof CURRENT_DESIGN_SYSTEMS)[number];
+/**
+ * All Design System Union Type (including planned)
+ */
+export type AllDesignSystem = (typeof ALL_DESIGN_SYSTEMS)[number];
+/**
+ * Design System Metadata
+ */
+export interface DesignSystemInfo {
+    id: DesignSystem;
+    name: string;
+    description: string;
+    characteristics: string[];
+    colorPalette: {
+        primary: string;
+        secondary: string;
+        accent: string;
+        background: string;
+    };
+    typography: {
+        fontFamily: string;
+        headingWeight: number;
+        bodyWeight: number;
+    };
+}
+/**
+ * Design System Metadata Map
+ */
+export declare const DESIGN_SYSTEM_INFO: Record<DesignSystem, DesignSystemInfo>;
+/**
+ * Check if a string is a valid design system
+ */
+export declare function isValidDesignSystem(system: string): system is DesignSystem;
+/**
+ * Get design system info
+ */
+export declare function getDesignSystemInfo(system: DesignSystem): DesignSystemInfo;
+/**
+ * Get display name for design system
+ */
+export declare function getDesignSystemName(system: DesignSystem): string;
+//# sourceMappingURL=DesignSystems.d.ts.map

package/dist/constants/Frameworks.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Frameworks Constants
+ *
+ * Supported frameworks for code generation.
+ *
+ * Powered by Nikkory
+ */
+/**
+ * Current Supported Frameworks
+ */
+export declare const CURRENT_FRAMEWORKS: readonly ["react", "vue", "svelte", "solid", "angular"];
+/**
+ * Planned Frameworks (Future)
+ */
+export declare const PLANNED_FRAMEWORKS: readonly ["preact", "qwik", "lit", "alpine", "htmx", "astro"];
+/**
+ * All Frameworks
+ */
+export declare const ALL_FRAMEWORKS: readonly ["react", "vue", "svelte", "solid", "angular", "preact", "qwik", "lit", "alpine", "htmx", "astro"];
+/**
+ * Framework Type
+ */
+export type Framework = (typeof CURRENT_FRAMEWORKS)[number];
+/**
+ * All Framework Type (including planned)
+ */
+export type AllFramework = (typeof ALL_FRAMEWORKS)[number];
+/**
+ * Framework Metadata
+ */
+export interface FrameworkInfo {
+    id: Framework;
+    name: string;
+    description: string;
+    fileExtension: string;
+    componentExtension: string;
+    importStyle: 'default' | 'named' | 'namespace';
+    supportsJSX: boolean;
+    supportsSFC: boolean;
+    packageManager: string;
+    officialWebsite: string;
+}
+/**
+ * Framework Metadata Map
+ */
+export declare const FRAMEWORK_INFO: Record<Framework, FrameworkInfo>;
+/**
+ * Check if a string is a valid framework
+ */
+export declare function isValidFramework(framework: string): framework is Framework;
+/**
+ * Get framework info
+ */
+export declare function getFrameworkInfo(framework: Framework): FrameworkInfo;
+/**
+ * Get framework display name
+ */
+export declare function getFrameworkName(framework: Framework): string;
+/**
+ * Get component file extension for framework
+ */
+export declare function getComponentExtension(framework: Framework): string;
+/**
+ * Check if framework supports JSX
+ */
+export declare function supportsJSX(framework: Framework): boolean;
+/**
+ * Check if framework supports Single File Components
+ */
+export declare function supportsSFC(framework: Framework): boolean;
+//# sourceMappingURL=Frameworks.d.ts.map

package/dist/constants/Tiers.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Tiers Constants
+ *
+ * Quality tiers for component generation.
+ *
+ * Powered by Nikkory
+ */
+/**
+ * Available Tiers
+ */
+export declare const TIERS: readonly ["basic", "standard", "enterprise"];
+/**
+ * Tier Type
+ */
+export type Tier = (typeof TIERS)[number];
+/**
+ * Tier Metadata
+ */
+export interface TierInfo {
+    id: Tier;
+    name: string;
+    description: string;
+    targetUseCase: string;
+    features: string[];
+    linesOfCode: {
+        min: number;
+        max: number;
+    };
+    includes: {
+        forwardRef: boolean;
+        memo: boolean;
+        displayName: boolean;
+        analytics: boolean;
+        accessibility: boolean;
+        documentation: boolean;
+        variants: boolean;
+        animations: boolean;
+    };
+}
+/**
+ * Tier Metadata Map
+ */
+export declare const TIER_INFO: Record<Tier, TierInfo>;
+/**
+ * Check if a string is a valid tier
+ */
+export declare function isValidTier(tier: string): tier is Tier;
+/**
+ * Get tier info
+ */
+export declare function getTierInfo(tier: Tier): TierInfo;
+/**
+ * Get tier display name
+ */
+export declare function getTierName(tier: Tier): string;
+/**
+ * Compare tiers (returns -1, 0, or 1)
+ */
+export declare function compareTiers(a: Tier, b: Tier): number;
+/**
+ * Check if tier A is higher than tier B
+ */
+export declare function isHigherTier(a: Tier, b: Tier): boolean;
+/**
+ * Get the next tier (or undefined if already at highest)
+ */
+export declare function getNextTier(tier: Tier): Tier | undefined;
+/**
+ * Get all tiers at or above the specified tier
+ */
+export declare function getTiersAtOrAbove(tier: Tier): Tier[];
+//# sourceMappingURL=Tiers.d.ts.map

package/dist/constants/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared Constants
+ *
+ * Powered by Nikkory
+ */
+export * from './ComponentTypes';
+export * from './DesignSystems';
+export * from './Tiers';
+export * from './Frameworks';
+//# sourceMappingURL=index.d.ts.map

package/dist/converters/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Converters Module
+ * Bridge functions between Registry and Runtime configurations
+ *
+ * @packageDocumentation
+ * @module converters
+ * @since 4.1.0
+ *
+ * Powered by Nikkory
+ */
+export { toSectionConfig, toSectionConfigs, findAndConvertSection, findAndConvertByCategory, validateSectionConfig, isSectionUserOverrides, type SectionUserOverrides, } from './section-converter';
+//# sourceMappingURL=index.d.ts.map