@nikkory/vibe-engine 4.0.0

package/dist/types/granularity-levels/template.config.d.ts

@@ -0,0 +1,340 @@
+/**
+ * Template Configuration Types
+ *
+ * Template-level configuration for complete applications like Admin, E-commerce.
+ * Templates are the highest granularity level, containing layouts, pages, and
+ * shared components that form a complete application.
+ *
+ * @packageDocumentation
+ * @module types/granularity-levels
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { GranularityLevel, GranularityFactorValues, GranularityStyleOverrides, GranularityLayoutConfig, GranularityTemplateVisibility } from '../granularity/base.types';
+import type { GranularityConfig, ChildReference } from '../granularity/config.types';
+import type { GranularitySlotPosition, GranularitySlotConfig } from '../granularity/slot.types';
+import type { GranularityTemplateMetadata, GranularityTemplate } from '../granularity/template.types';
+import type { DesignSystem, Tier } from '../index';
+/**
+ * Template slot positions - pages, shared, assets
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type TemplateSlotPosition = GranularitySlotPosition<'template'>;
+/**
+ * Template slot configuration
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type TemplateSlotConfig = GranularitySlotConfig<'template'>;
+/**
+ * Template type categories - 20+ types organized by purpose
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * @example
+ * ```typescript
+ * const category: TemplateCategory = 'admin';
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export type TemplateCategory = 'admin' | 'ecommerce' | 'saas' | 'portfolio' | 'blog' | 'landing' | 'documentation' | 'social' | 'marketplace' | 'booking';
+/**
+ * Template type identifiers (20+ types)
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type TemplateType = 'admin-dashboard' | 'cms-admin' | 'analytics-dashboard' | 'ecommerce-store' | 'marketplace-vendor' | 'digital-products' | 'saas-landing' | 'saas-dashboard' | 'saas-onboarding' | 'portfolio-minimal' | 'portfolio-creative' | 'resume-cv' | 'blog-personal' | 'blog-magazine' | 'blog-technical' | 'landing-product' | 'landing-startup' | 'landing-agency' | 'docs-technical' | 'docs-api' | 'knowledge-base';
+/**
+ * Technology stack configuration
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface TechStack {
+    /** Frontend framework */
+    readonly framework: 'react' | 'vue' | 'angular' | 'svelte' | 'solid';
+    /** UI library */
+    readonly uiLibrary?: 'tailwind' | 'styled-components' | 'emotion' | 'vanilla';
+    /** State management */
+    readonly stateManagement?: 'zustand' | 'redux' | 'jotai' | 'mobx' | 'none';
+    /** Form handling */
+    readonly formLibrary?: 'react-hook-form' | 'formik' | 'final-form' | 'none';
+    /** API layer */
+    readonly apiLayer?: 'trpc' | 'graphql' | 'rest' | 'none';
+    /** Authentication */
+    readonly auth?: 'next-auth' | 'clerk' | 'supabase' | 'firebase' | 'custom';
+    /** Database */
+    readonly database?: 'prisma' | 'drizzle' | 'mongoose' | 'none';
+    /** Testing framework */
+    readonly testing?: 'vitest' | 'jest' | 'playwright' | 'cypress';
+}
+/**
+ * Pages configuration for template
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface TemplatePages {
+    /** All page IDs included in template */
+    readonly included: readonly string[];
+    /** Default/home page ID */
+    readonly homePage: string;
+    /** 404 page ID */
+    readonly notFoundPage?: string;
+    /** Error page ID */
+    readonly errorPage?: string;
+    /** Page groups for navigation */
+    readonly groups?: readonly PageGroup[];
+}
+/**
+ * Page group for navigation organization
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface PageGroup {
+    /** Group identifier */
+    readonly id: string;
+    /** Group display name */
+    readonly name: string;
+    /** Page IDs in this group */
+    readonly pages: readonly string[];
+    /** Group icon */
+    readonly icon?: string;
+    /** Whether group is collapsible */
+    readonly collapsible?: boolean;
+}
+/**
+ * Shared assets configuration
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface TemplateAssets {
+    /** Shared components IDs */
+    readonly components?: readonly string[];
+    /** Shared layouts IDs */
+    readonly layouts?: readonly string[];
+    /** Image assets */
+    readonly images?: readonly AssetReference[];
+    /** Icon set */
+    readonly icons?: 'lucide' | 'heroicons' | 'phosphor' | 'custom';
+    /** Font configuration */
+    readonly fonts?: FontConfig;
+}
+/**
+ * Asset reference
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface AssetReference {
+    /** Asset identifier */
+    readonly id: string;
+    /** Asset path or URL */
+    readonly path: string;
+    /** Asset type */
+    readonly type: 'image' | 'svg' | 'video' | 'font';
+    /** Asset alt text */
+    readonly alt?: string;
+}
+/**
+ * Font configuration
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface FontConfig {
+    /** Primary font family */
+    readonly primary: string;
+    /** Secondary font family */
+    readonly secondary?: string;
+    /** Monospace font family */
+    readonly mono?: string;
+    /** Font weights to include */
+    readonly weights?: readonly number[];
+}
+/**
+ * Template-specific extension fields beyond GranularityConfig
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface TemplateExtensions {
+    /** Template type identifier */
+    readonly templateType: TemplateType;
+    /** Template category for organization */
+    readonly templateCategory: TemplateCategory;
+    /** Technology stack */
+    readonly stack: TechStack;
+    /** Pages configuration */
+    readonly pages: TemplatePages;
+    /** Shared assets */
+    readonly assets?: TemplateAssets;
+    /** Template version */
+    readonly version: string;
+    /** Template visibility */
+    readonly visibility: GranularityTemplateVisibility;
+    /** License type */
+    readonly license?: 'mit' | 'apache-2.0' | 'proprietary' | 'custom';
+    /** Pricing tier (if applicable) */
+    readonly pricingTier?: 'free' | 'starter' | 'pro' | 'enterprise';
+    /** Preview URL */
+    readonly previewUrl?: string;
+    /** Repository URL */
+    readonly repositoryUrl?: string;
+    /** Documentation URL */
+    readonly docsUrl?: string;
+    /** Whether template is featured */
+    readonly featured?: boolean;
+    /** Download count */
+    readonly downloads?: number;
+    /** Rating (1-5) */
+    readonly rating?: number;
+}
+/**
+ * TemplateLevelConfig - Full configuration for template-level elements
+ *
+ * Extends GranularityConfig<'template'> with template-specific fields.
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * @example
+ * ```typescript
+ * const adminTemplate: TemplateLevelConfig = {
+ *   id: 'admin-dashboard-template',
+ *   granularity: 'template',
+ *   designSystem: 'material-design',
+ *   tier: 'enterprise',
+ *   title: 'Admin Dashboard',
+ *   subtitle: 'Complete admin panel with analytics',
+ *   templateType: 'admin-dashboard',
+ *   templateCategory: 'admin',
+ *   version: '1.0.0',
+ *   visibility: 'public',
+ *   stack: {
+ *     framework: 'react',
+ *     uiLibrary: 'tailwind',
+ *     stateManagement: 'zustand',
+ *     apiLayer: 'trpc'
+ *   },
+ *   pages: {
+ *     included: ['dashboard', 'users', 'settings'],
+ *     homePage: 'dashboard',
+ *     notFoundPage: '404',
+ *     groups: [
+ *       { id: 'main', name: 'Main', pages: ['dashboard'] },
+ *       { id: 'admin', name: 'Admin', pages: ['users', 'settings'] }
+ *     ]
+ *   }
+ * };
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export interface TemplateLevelConfig extends TemplateExtensions {
+    /** Unique identifier */
+    readonly id: string;
+    /** Granularity level - always 'template' */
+    readonly granularity: 'template';
+    /** Design system */
+    readonly designSystem: DesignSystem;
+    /** Quality tier */
+    readonly tier: Tier;
+    /** Display title */
+    readonly title: string;
+    /** Optional subtitle/description */
+    readonly subtitle?: string;
+    /** Layout configuration */
+    readonly layout?: GranularityLayoutConfig;
+    /** Slots for template organization */
+    readonly slots?: readonly TemplateSlotConfig[];
+    /** Factor values */
+    readonly factors?: GranularityFactorValues;
+    /** Children references (layouts and pages) */
+    readonly children?: readonly ChildReference<'template'>[];
+    /** Style overrides */
+    readonly styleOverrides?: GranularityStyleOverrides;
+}
+/**
+ * Default slot configurations for templates
+ *
+ * @category constants
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const DEFAULT_TEMPLATE_SLOTS: readonly TemplateSlotConfig[];
+/**
+ * FullTemplate - Complete template with metadata for marketplace
+ *
+ * Combines TemplateLevelConfig with TemplateMetadata for full template definition.
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface FullTemplate extends TemplateLevelConfig, GranularityTemplateMetadata {
+}
+/**
+ * Type guard to check if a config is a TemplateLevelConfig
+ *
+ * @category utils
+ * @since 4.0.0
+ *
+ * @param config - The config to check
+ * @returns True if config is a TemplateLevelConfig
+ *
+ * Powered by Nikkory
+ */
+export declare function isTemplateLevelConfig(config: GranularityConfig<GranularityLevel>): config is TemplateLevelConfig & GranularityConfig<'template'>;
+/**
+ * TemplateGranularityConfig - Alias to GranularityConfig<'template'>
+ *
+ * Use TemplateLevelConfig for the full extended version with template-specific fields.
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type TemplateGranularityConfig = GranularityConfig<'template'>;
+/**
+ * Re-export GranularityTemplate for convenience
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type { GranularityTemplate, GranularityTemplateMetadata as TemplateMetadata };
+//# sourceMappingURL=template.config.d.ts.map

package/dist/types/index.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Shared Types for Nikkory Vibe v4.0
+ *
+ * @packageDocumentation
+ * @module engine/types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export * from './Result';
+export * from './Option';
+export * from './algorithm-engine.types';
+export * from './section.types';
+export * from './section-template.types';
+export * from './section-slot.types';
+export * from './section-storage.types';
+export * from './granularity';
+/**
+ * Component quality tier
+ * - basic: Prototype/MVP (30-50 LOC)
+ * - standard: Production (50-150 LOC, forwardRef)
+ * - enterprise: Mission-critical (150-300 LOC, memo, analytics, ARIA)
+ */
+export type Tier = 'basic' | 'standard' | 'enterprise';
+/**
+ * Supported design systems (12 total)
+ */
+export type DesignSystem = 'material-design' | 'ios-hig' | 'glassmorphism' | 'neumorphism' | 'brutalism' | 'minimalism' | 'cyberpunk' | 'flat-design' | 'retro-vintage' | 'fluent-design' | 'carbon-design' | 'ant-design';
+/**
+ * Component types (40+ supported)
+ */
+export type ComponentType = 'button' | 'input' | 'textarea' | 'checkbox' | 'radio-group' | 'switch' | 'select' | 'slider' | 'alert' | 'badge' | 'chip' | 'progress' | 'spinner' | 'skeleton' | 'tooltip' | 'tabs' | 'menu' | 'breadcrumb' | 'pagination' | 'stepper' | 'card' | 'table' | 'list' | 'accordion' | 'avatar' | 'modal' | 'drawer' | 'popover' | 'date-picker' | 'calendar' | 'audio' | 'video' | 'image' | 'file';
+/**
+ * Component granularity levels (6 levels)
+ */
+export type ComponentGranularity = 'atom' | 'component' | 'section' | 'page' | 'layout' | 'template';
+/**
+ * Supported frontend frameworks
+ */
+export type Framework = 'react' | 'vue' | 'svelte' | 'angular' | 'solid' | 'qwik';
+/**
+ * 24-Factor Dynamic Matrix configuration
+ */
+export interface FactorConfig {
+    readonly preset?: string;
+    readonly spacing?: string;
+    readonly sizing?: string;
+    readonly typography?: string;
+    readonly colors?: string;
+    readonly borders?: string;
+    readonly shadows?: string;
+    readonly animations?: string;
+    readonly layout?: string;
+    readonly responsive?: string;
+    readonly darkMode?: string;
+    readonly accessibility?: string;
+    readonly performance?: string;
+    readonly state?: string;
+    readonly validation?: string;
+    readonly localization?: string;
+    readonly analytics?: string;
+    readonly security?: string;
+    readonly testing?: string;
+    readonly documentation?: string;
+    readonly versioning?: string;
+    readonly compatibility?: string;
+    readonly optimization?: string;
+    readonly monitoring?: string;
+}
+/**
+ * Component generation configuration
+ */
+export interface GenerationConfig {
+    readonly componentType: ComponentType;
+    readonly framework: Framework;
+    readonly designSystem: DesignSystem;
+    readonly tier: Tier;
+    readonly granularity?: ComponentGranularity;
+    readonly factors?: FactorConfig;
+    readonly customProps?: Record<string, unknown>;
+}
+/**
+ * Component registry definition
+ */
+export interface ComponentRegistryDefinition {
+    readonly id: string;
+    readonly name: string;
+    readonly category: string;
+    readonly complexity: 'basic' | 'standard' | 'complex';
+    readonly status: 'stable' | 'beta' | 'planned';
+    readonly icon: string;
+    readonly emoji: string;
+    readonly designSystems: readonly DesignSystem[];
+    readonly tiers: readonly Tier[];
+    readonly isNew?: boolean;
+    readonly isPopular?: boolean;
+    readonly tags: readonly string[];
+}
+/**
+ * Component features that can be enabled
+ */
+export type ComponentFeature = 'loading' | 'disabled' | 'tooltip' | 'icon' | 'badge' | 'analytics' | 'a11y' | 'animation' | 'responsive';
+/**
+ * Generation options
+ */
+export interface GenerateComponentOptions {
+    includeTests?: boolean;
+    includeStorybook?: boolean;
+    includeCss?: boolean;
+    formatCode?: boolean;
+    overwrite?: boolean;
+}
+/**
+ * Generate Component DTO
+ * Data Transfer Object for component generation use case.
+ */
+export interface GenerateComponentDto {
+    template: string;
+    name: string;
+    designSystem: string;
+    tier: 'basic' | 'standard' | 'enterprise';
+    framework?: 'react' | 'vue' | 'angular' | 'svelte' | 'solid';
+    outputPath?: string;
+    variants?: string[];
+    props?: Record<string, string>;
+    features?: ComponentFeature[];
+    options?: GenerateComponentOptions;
+}
+/**
+ * Generated component metadata
+ */
+export interface GeneratedComponentMetadata {
+    template: string;
+    name: string;
+    designSystem: string;
+    tier: string;
+    framework: string;
+    generatedAt: Date;
+    linesOfCode: number;
+    features: string[];
+}
+/**
+ * Generated component result
+ */
+export interface GeneratedComponent {
+    code: string;
+    path?: string;
+    testCode?: string;
+    storybookCode?: string;
+    metadata: GeneratedComponentMetadata;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/section-slot.types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Section Slot Types
+ * Type definitions for section slots and component placement
+ *
+ * @packageDocumentation
+ * @module types/section-slot
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { ComponentType } from './index';
+import type { SlotConfig, StoredComponentInSlot } from './section.types';
+/**
+ * Slot state for runtime management
+ */
+export interface SlotState {
+    /** Slot configuration */
+    readonly config: SlotConfig;
+    /** Components currently in slot */
+    readonly components: readonly StoredComponentInSlot[];
+    /** Whether slot is currently being edited */
+    readonly isEditing: boolean;
+    /** Whether slot accepts more components */
+    readonly canAddMore: boolean;
+    /** Validation errors for slot */
+    readonly errors: readonly string[];
+}
+/**
+ * Add component to slot operation
+ */
+export interface AddComponentToSlotInput {
+    /** Slot ID to add component to */
+    readonly slotId: string;
+    /** Component type to add */
+    readonly componentType: ComponentType;
+    /** Initial prop overrides */
+    readonly propOverrides?: Record<string, unknown>;
+    /** Position in slot (appends if not specified) */
+    readonly position?: number;
+}
+/**
+ * Remove component from slot operation
+ */
+export interface RemoveComponentFromSlotInput {
+    /** Slot ID to remove component from */
+    readonly slotId: string;
+    /** Instance ID of component to remove */
+    readonly instanceId: string;
+}
+/**
+ * Update component in slot operation
+ */
+export interface UpdateComponentInSlotInput {
+    /** Slot ID containing component */
+    readonly slotId: string;
+    /** Instance ID of component to update */
+    readonly instanceId: string;
+    /** New prop overrides (merged with existing) */
+    readonly propOverrides?: Record<string, unknown>;
+    /** New visibility state */
+    readonly visible?: boolean;
+    /** New position in slot */
+    readonly order?: number;
+}
+/**
+ * Reorder components in slot operation
+ */
+export interface ReorderSlotComponentsInput {
+    /** Slot ID to reorder */
+    readonly slotId: string;
+    /** New order of instance IDs */
+    readonly instanceIds: readonly string[];
+}
+/**
+ * Slot validation result
+ */
+export interface SlotValidationResult {
+    /** Whether slot is valid */
+    readonly valid: boolean;
+    /** Validation errors */
+    readonly errors: readonly string[];
+    /** Validation warnings */
+    readonly warnings: readonly string[];
+}
+/**
+ * Component placement validation input
+ */
+export interface ComponentPlacementValidationInput {
+    /** Slot configuration */
+    readonly slotConfig: SlotConfig;
+    /** Component type to place */
+    readonly componentType: ComponentType;
+    /** Current components in slot */
+    readonly currentComponents: readonly StoredComponentInSlot[];
+}
+/**
+ * Default slot configurations by section type
+ */
+export interface SectionSlotDefaults {
+    /** Section type */
+    readonly sectionType: string;
+    /** Default slot configurations */
+    readonly slots: readonly SlotConfig[];
+}
+/**
+ * Slot preset for quick configuration
+ */
+export interface SlotPreset {
+    /** Preset identifier */
+    readonly presetId: string;
+    /** Preset name */
+    readonly name: string;
+    /** Preset description */
+    readonly description: string;
+    /** Slot configuration */
+    readonly config: SlotConfig;
+    /** Default components to place */
+    readonly defaultComponents: readonly StoredComponentInSlot[];
+}
+/**
+ * Slot event types for state management
+ */
+export type SlotEventType = 'component-added' | 'component-removed' | 'component-updated' | 'components-reordered' | 'slot-cleared';
+/**
+ * Slot event payload
+ */
+export interface SlotEvent {
+    /** Event type */
+    readonly type: SlotEventType;
+    /** Slot ID */
+    readonly slotId: string;
+    /** Affected instance ID (if applicable) */
+    readonly instanceId?: string;
+    /** Timestamp */
+    readonly timestamp: Date;
+    /** Event payload */
+    readonly payload?: Record<string, unknown>;
+}
+/**
+ * Slot render context for component generation
+ */
+export interface SlotRenderContext {
+    /** Slot configuration */
+    readonly slot: SlotConfig;
+    /** Components to render */
+    readonly components: readonly StoredComponentInSlot[];
+    /** Parent section ID */
+    readonly sectionId: string;
+    /** Design system to use */
+    readonly designSystem: string;
+    /** Tier to use */
+    readonly tier: string;
+    /** Whether in edit mode */
+    readonly isEditMode: boolean;
+}
+/**
+ * Rendered slot output
+ */
+export interface RenderedSlot {
+    /** Slot ID */
+    readonly slotId: string;
+    /** Generated HTML/JSX */
+    readonly content: string;
+    /** Component instance IDs rendered */
+    readonly renderedInstances: readonly string[];
+    /** Render errors (if any) */
+    readonly errors: readonly string[];
+}
+//# sourceMappingURL=section-slot.types.d.ts.map