@nikkory/vibe-engine 4.0.0

package/dist/ui-studio/presets/registry.constants.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Registry Constants
+ * @packageDocumentation
+ * @module presets/registry-constants
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+/**
+ * Section category constants
+ */
+export declare const SECTION_CATEGORIES: readonly ["hero", "features", "testimonials", "pricing", "cta", "faq", "team", "contact", "gallery", "stats"];
+/**
+ * Page category constants
+ */
+export declare const PAGE_CATEGORIES: readonly ["marketing", "e-commerce", "saas", "portfolio", "blog", "docs", "app"];
+/**
+ * Layout category constants
+ */
+export declare const LAYOUT_CATEGORIES: readonly ["standard", "dashboard", "landing", "app", "blog"];
+/**
+ * Template category constants
+ */
+export declare const TEMPLATE_CATEGORIES: readonly ["saas", "e-commerce", "portfolio", "blog", "startup", "agency"];
+/**
+ * Page type constants
+ */
+export declare const PAGE_TYPES: readonly ["landing", "product", "checkout", "about", "contact", "blog-post"];
+/**
+ * Section height constants
+ */
+export declare const SECTION_HEIGHTS: readonly ["compact", "standard", "tall", "fullscreen"];
+/**
+ * Section alignment constants
+ */
+export declare const SECTION_ALIGNMENTS: readonly ["left", "center", "right"];
+/**
+ * Section layout constants
+ */
+export declare const SECTION_LAYOUTS: readonly ["single-column", "two-column", "three-column", "grid"];
+/**
+ * Layout structure constants
+ */
+export declare const LAYOUT_STRUCTURES: readonly ["standard", "sidebar", "dashboard", "split"];
+/**
+ * Layout responsive behavior constants
+ */
+export declare const LAYOUT_RESPONSIVE_TYPES: readonly ["fluid", "fixed", "hybrid"];
+/**
+ * Header type constants
+ */
+export declare const HEADER_TYPES: readonly ["fixed", "sticky", "static", "none"];
+/**
+ * Footer type constants
+ */
+export declare const FOOTER_TYPES: readonly ["standard", "minimal", "none"];
+/**
+ * SEO importance level constants
+ */
+export declare const SEO_LEVELS: readonly ["critical", "important", "standard"];
+/**
+ * Template complexity level constants
+ */
+export declare const COMPLEXITY_LEVELS: readonly ["starter", "intermediate", "advanced"];
+/**
+ * Registry status constants
+ */
+export declare const REGISTRY_STATUSES: readonly ["stable", "beta", "planned"];
+//# sourceMappingURL=registry.constants.d.ts.map

package/dist/ui-studio/presets/registry.types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Registry Types - SINGLE SOURCE OF TRUTH
+ * @packageDocumentation
+ * @module presets/registry-types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { DesignSystem, Tier } from '../types';
+import type { LayoutType, SpacingLevel, SlotConfig, StyleOverrides } from '../../types/section.types';
+/**
+ * Base definition interface that ALL registry items extend from
+ * Source: Derived from existing component-registry.ts pattern
+ */
+export interface BaseRegistryDefinition {
+    /** Unique identifier (kebab-case) */
+    readonly id: string;
+    /** Display name (human-readable) */
+    readonly name: string;
+    /** Current status */
+    readonly status: 'stable' | 'beta' | 'planned';
+    /** Description for documentation */
+    readonly description: string;
+    /** Search keywords */
+    readonly keywords: readonly string[];
+    /** Implementation phase */
+    readonly phase: string;
+    /** Lucide icon name for UI */
+    readonly icon: string;
+    /** Emoji for visual representation */
+    readonly emoji: string;
+    /** Available design systems */
+    readonly designSystems: readonly DesignSystem[];
+    /** Available tiers */
+    readonly tiers: readonly Tier[];
+    /** Show NEW badge in UI */
+    readonly isNew?: boolean;
+    /** Show POPULAR badge in UI */
+    readonly isPopular?: boolean;
+    /** Additional tags for filtering */
+    readonly tags: readonly string[];
+}
+import type { SectionCategory } from '../../types/section.types';
+export type { SectionCategory };
+/**
+ * Page category types
+ */
+export type PageCategory = 'marketing' | 'e-commerce' | 'saas' | 'portfolio' | 'blog' | 'docs' | 'app';
+/**
+ * Layout category types
+ */
+export type LayoutCategory = 'standard' | 'dashboard' | 'landing' | 'app' | 'blog';
+/**
+ * Template category types
+ */
+export type TemplateCategory = 'saas' | 'e-commerce' | 'portfolio' | 'blog' | 'startup' | 'agency';
+/**
+ * Page type identifiers
+ */
+export type PageType = 'landing' | 'product' | 'checkout' | 'about' | 'contact' | 'blog-post';
+/**
+ * Section registry definition
+ * Sections are page subdivisions (hero, features, pricing, etc.)
+ *
+ * @remarks
+ * Includes all 14 SectionConfig fields as required by Section Architecture:
+ * - Section-Level (6): sectionId(id), sectionType(category), title, subtitle, designSystem, tier
+ * - Layout (3): layout, columns, spacing
+ * - Generation (2): slots, itemCount
+ * - Component-Specific (3): showCta, showMedia, styleOverrides
+ *
+ * Field Name Mapping (Registry → SectionConfig):
+ * - `id` → `sectionId` (BaseRegistryDefinition.id maps to SectionConfig.sectionId)
+ * - `category` → `sectionType` (use category for filtering, sectionType in runtime)
+ * - `sectionLayout` → `layout` (sectionLayout for UI display, layout for generation)
+ *
+ * Use `toSectionConfig()` from `converters/section-converter` to convert
+ * a RegistrySectionDefinition to a SectionConfig for runtime use.
+ *
+ * @see {@link ../converters/section-converter#toSectionConfig}
+ */
+export interface RegistrySectionDefinition extends BaseRegistryDefinition {
+    /** Section category (maps to sectionType in SectionConfig) */
+    readonly category: SectionCategory;
+    /** Section title for display */
+    readonly title: string;
+    /** Section subtitle/description for display */
+    readonly subtitle?: string;
+    /** Default design system to use when generating */
+    readonly defaultDesignSystem: DesignSystem;
+    /** Default tier to use when generating */
+    readonly defaultTier: Tier;
+    /** Layout type for generation */
+    readonly sectionLayout: LayoutType;
+    /** Number of columns for grid layout */
+    readonly columns: 1 | 2 | 3 | 4 | 6;
+    /** Spacing between elements */
+    readonly spacing: SpacingLevel;
+    /** Optional slots configuration */
+    readonly slots?: readonly SlotConfig[];
+    /** Number of items to generate */
+    readonly itemCount?: number;
+    /** Show CTA button */
+    readonly showCta?: boolean;
+    /** Show images/media */
+    readonly showMedia?: boolean;
+    /** Custom styling overrides */
+    readonly styleOverrides?: StyleOverrides;
+    /** Typical height for UI preview */
+    readonly height: 'compact' | 'standard' | 'tall' | 'fullscreen';
+    /** Content alignment for UI display */
+    readonly alignment: 'left' | 'center' | 'right';
+    /** Layout pattern for UI display (legacy, use sectionLayout for generation) */
+    readonly layout: 'single-column' | 'two-column' | 'three-column' | 'grid';
+    /** Dependencies on other sections */
+    readonly dependencies: readonly string[];
+}
+/**
+ * Page registry definition
+ * Pages are complete layouts (landing, product, checkout, etc.)
+ */
+export interface RegistryPageDefinition extends BaseRegistryDefinition {
+    /** Page category */
+    readonly category: PageCategory;
+    /** Required sections */
+    readonly sections: readonly string[];
+    /** Page type (marketing, e-commerce, app, etc.) */
+    readonly pageType: PageType;
+    /** SEO importance level */
+    readonly seo: 'critical' | 'important' | 'standard';
+    /** Conversion tracking */
+    readonly hasConversion: boolean;
+}
+/**
+ * Layout registry definition
+ * Layouts are structural patterns (header+content+footer, sidebar, etc.)
+ */
+export interface RegistryLayoutDefinition extends BaseRegistryDefinition {
+    /** Layout category */
+    readonly category: LayoutCategory;
+    /** Layout structure */
+    readonly structure: 'standard' | 'sidebar' | 'dashboard' | 'split';
+    /** Responsive behavior */
+    readonly responsive: 'fluid' | 'fixed' | 'hybrid';
+    /** Header type */
+    readonly header: 'fixed' | 'sticky' | 'static' | 'none';
+    /** Footer type */
+    readonly footer: 'standard' | 'minimal' | 'none';
+}
+/**
+ * Template registry definition
+ * Templates are complete multi-page applications
+ */
+export interface RegistryTemplateDefinition extends BaseRegistryDefinition {
+    /** Template category */
+    readonly category: TemplateCategory;
+    /** Included pages */
+    readonly pages: readonly string[];
+    /** Technology stack */
+    readonly stack: readonly string[];
+    /** Target industry */
+    readonly industry: readonly string[];
+    /** Complexity level */
+    readonly complexity: 'starter' | 'intermediate' | 'advanced';
+}
+//# sourceMappingURL=registry.types.d.ts.map

package/dist/ui-studio/presets/section-defaults.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Section Defaults - Default SectionFactors per Design System
+ *
+ * @packageDocumentation
+ * @module presets/section-defaults
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { DesignSystem } from '../types';
+import type { SectionFactors } from '../../types/section.types';
+/**
+ * Material Design 3 default section factors
+ *
+ * @remarks
+ * Based on Google's Material Design 3 specifications.
+ * Uses rounded corners, elevated surfaces, and dynamic color.
+ */
+export declare const MATERIAL_DESIGN_DEFAULTS: SectionFactors;
+/**
+ * Apple Human Interface Guidelines default section factors
+ *
+ * @remarks
+ * Based on Apple's HIG specifications.
+ * Uses system fonts, subtle shadows, and native feel.
+ */
+export declare const IOS_HIG_DEFAULTS: SectionFactors;
+/**
+ * Glassmorphism default section factors
+ *
+ * @remarks
+ * Features frosted glass effects, transparency, and blur.
+ * Requires backdrop-filter support.
+ */
+export declare const GLASSMORPHISM_DEFAULTS: SectionFactors;
+/**
+ * Neumorphism (Soft UI) default section factors
+ *
+ * @remarks
+ * Features soft shadows, subtle depth, and monochromatic palettes.
+ * Uses inset and outset shadows for depth effect.
+ */
+export declare const NEUMORPHISM_DEFAULTS: SectionFactors;
+/**
+ * Brutalism default section factors
+ *
+ * @remarks
+ * Features bold colors, sharp edges, and raw aesthetics.
+ * Uses strong contrasts and unconventional layouts.
+ */
+export declare const BRUTALISM_DEFAULTS: SectionFactors;
+/**
+ * Minimalism default section factors
+ *
+ * @remarks
+ * Features clean lines, ample whitespace, and essential elements only.
+ * Focuses on typography and content hierarchy.
+ */
+export declare const MINIMALISM_DEFAULTS: SectionFactors;
+/**
+ * Cyberpunk default section factors
+ *
+ * @remarks
+ * Features neon colors, dark backgrounds, and futuristic aesthetics.
+ * Uses glitch effects and high-tech visual language.
+ */
+export declare const CYBERPUNK_DEFAULTS: SectionFactors;
+/**
+ * Flat Design default section factors
+ *
+ * @remarks
+ * Features flat colors, no gradients, and 2D aesthetics.
+ * Emphasizes bold colors and clean shapes.
+ */
+export declare const FLAT_DESIGN_DEFAULTS: SectionFactors;
+/**
+ * Retro/Vintage default section factors
+ *
+ * @remarks
+ * Features muted colors, vintage typography, and nostalgic aesthetics.
+ * Uses textures and ornamental elements.
+ */
+export declare const RETRO_VINTAGE_DEFAULTS: SectionFactors;
+/**
+ * Microsoft Fluent Design default section factors
+ *
+ * @remarks
+ * Based on Microsoft's Fluent Design System.
+ * Features depth, motion, and material-based visuals.
+ */
+export declare const FLUENT_DESIGN_DEFAULTS: SectionFactors;
+/**
+ * IBM Carbon Design default section factors
+ *
+ * @remarks
+ * Based on IBM's Carbon Design System.
+ * Features structured layouts, technical aesthetics, and accessibility focus.
+ */
+export declare const CARBON_DESIGN_DEFAULTS: SectionFactors;
+/**
+ * Ant Design default section factors
+ *
+ * @remarks
+ * Based on Ant Design System by Alibaba.
+ * Features enterprise-focused aesthetics and comprehensive components.
+ */
+export declare const ANT_DESIGN_DEFAULTS: SectionFactors;
+/**
+ * Map of design system to default section factors
+ *
+ * @remarks
+ * Use this to get defaults for any supported design system.
+ *
+ * @example
+ * ```typescript
+ * const materialDefaults = DESIGN_SYSTEM_DEFAULTS['material-design'];
+ * const iosDefaults = DESIGN_SYSTEM_DEFAULTS['ios-hig'];
+ * ```
+ */
+export declare const DESIGN_SYSTEM_DEFAULTS: Readonly<Record<DesignSystem, SectionFactors>>;
+/**
+ * Get default section factors for a design system
+ *
+ * @param designSystem - The design system to get defaults for
+ * @returns Default SectionFactors for the specified design system
+ *
+ * @example
+ * ```typescript
+ * const factors = getDefaultFactors('material-design');
+ * console.log(factors.colorPrimary); // '#6750a4'
+ * ```
+ */
+export declare function getDefaultFactors(designSystem: DesignSystem): SectionFactors;
+/**
+ * Merge custom factors with design system defaults
+ *
+ * @param designSystem - The base design system
+ * @param overrides - Partial factors to override defaults
+ * @returns Merged SectionFactors
+ *
+ * @example
+ * ```typescript
+ * const customFactors = mergeWithDefaults('material-design', {
+ *   colorPrimary: '#ff0000',
+ *   elevation: 'lg',
+ * });
+ * ```
+ */
+export declare function mergeWithDefaults(designSystem: DesignSystem, overrides: Partial<SectionFactors>): SectionFactors;
+/**
+ * Get all available design systems with defaults
+ *
+ * @returns Array of design system IDs
+ *
+ * @example
+ * ```typescript
+ * const systems = getAvailableDesignSystems();
+ * // ['material-design', 'ios-hig', 'glassmorphism', ...]
+ * ```
+ */
+export declare function getAvailableDesignSystems(): readonly DesignSystem[];
+/**
+ * Check if a design system is supported
+ *
+ * @param designSystem - Design system ID to check
+ * @returns True if the design system has defaults defined
+ *
+ * @example
+ * ```typescript
+ * isDesignSystemSupported('material-design'); // true
+ * isDesignSystemSupported('unknown'); // false
+ * ```
+ */
+export declare function isDesignSystemSupported(designSystem: string): designSystem is DesignSystem;
+//# sourceMappingURL=section-defaults.d.ts.map

package/dist/ui-studio/presets/section-registry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Section Registry - 50 Section Definitions
+ * Optimized using factory pattern to reduce duplication
+ *
+ * @packageDocumentation
+ * @module presets/section-registry
+ * @since 4.0.0
+ *
+ * @remarks
+ * Uses `withSectionDefaultsArray()` factory to auto-generate:
+ * - designSystems, tiers (from category defaults)
+ * - icon, emoji (from category mappings)
+ * - height, alignment (from category defaults)
+ * - layout display pattern (derived from sectionLayout + columns)
+ *
+ * Powered by Nikkory
+ */
+import type { RegistrySectionDefinition } from './registry.types';
+/**
+ * Hero sections with full definitions (10)
+ */
+declare const HERO_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * Features sections with full definitions (8)
+ */
+declare const FEATURES_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * Testimonials sections with full definitions (6)
+ */
+declare const TESTIMONIALS_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * Pricing sections with full definitions (5)
+ */
+declare const PRICING_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * CTA sections with full definitions (4)
+ */
+declare const CTA_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * FAQ sections with full definitions (3)
+ */
+declare const FAQ_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * Team sections with full definitions (3)
+ */
+declare const TEAM_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * Contact sections with full definitions (3)
+ */
+declare const CONTACT_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * Gallery sections with full definitions (3)
+ */
+declare const GALLERY_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * Stats sections with full definitions (5)
+ */
+declare const STATS_SECTIONS: readonly RegistrySectionDefinition[];
+/**
+ * All section definitions (50 total)
+ *
+ * @remarks
+ * Combined from all 10 categories:
+ * - Hero: 10
+ * - Features: 8
+ * - Testimonials: 6
+ * - Pricing: 5
+ * - CTA: 4
+ * - FAQ: 3
+ * - Team: 3
+ * - Contact: 3
+ * - Gallery: 3
+ * - Stats: 5
+ *
+ * Total: 50 sections
+ *
+ * Each definition includes all 14 SectionConfig fields (Section Architecture v4.0)
+ * auto-generated by the factory pattern.
+ */
+export declare const ALL_SECTIONS: readonly RegistrySectionDefinition[];
+export { HERO_SECTIONS, FEATURES_SECTIONS, TESTIMONIALS_SECTIONS, PRICING_SECTIONS, CTA_SECTIONS, FAQ_SECTIONS, TEAM_SECTIONS, CONTACT_SECTIONS, GALLERY_SECTIONS, STATS_SECTIONS, };
+export type { RegistrySectionDefinition };
+//# sourceMappingURL=section-registry.d.ts.map

package/dist/ui-studio/presets/section-registry.defaults.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Section Registry Defaults
+ * Default values per category for factory pattern
+ *
+ * @packageDocumentation
+ * @module presets/section-registry-defaults
+ * @since 4.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { SectionCategory } from '../types';
+import type { SectionCategoryDefaults } from './section-registry.types';
+/**
+ * Icon mapping per category (Lucide icon names)
+ *
+ * @remarks
+ * These icons are used in the UI to visually identify section categories.
+ * All icons are from the Lucide icon library.
+ *
+ * @example
+ * ```typescript
+ * import { SECTION_CATEGORY_ICONS } from './section-registry.defaults';
+ * import { Rocket } from 'lucide-react';
+ *
+ * const iconName = SECTION_CATEGORY_ICONS['hero']; // 'Rocket'
+ * ```
+ */
+export declare const SECTION_CATEGORY_ICONS: Record<SectionCategory, string>;
+/**
+ * Emoji mapping per category
+ *
+ * @remarks
+ * These emojis are used for quick visual identification in UIs,
+ * documentation, and search results.
+ *
+ * @example
+ * ```typescript
+ * import { SECTION_CATEGORY_EMOJIS } from './section-registry.defaults';
+ *
+ * const emoji = SECTION_CATEGORY_EMOJIS['hero']; // '🚀'
+ * console.log(`${emoji} Hero Section`); // '🚀 Hero Section'
+ * ```
+ */
+export declare const SECTION_CATEGORY_EMOJIS: Record<SectionCategory, string>;
+/**
+ * Default values per category
+ *
+ * @remarks
+ * These defaults are applied by `withSectionDefaults()` when creating
+ * full section definitions. Each category has optimized defaults based
+ * on typical use cases.
+ *
+ * @example
+ * ```typescript
+ * import { SECTION_CATEGORY_DEFAULTS } from './section-registry.defaults';
+ *
+ * const heroDefaults = SECTION_CATEGORY_DEFAULTS['hero'];
+ * console.log(heroDefaults.height); // 'fullscreen'
+ * console.log(heroDefaults.showCta); // true
+ * ```
+ */
+export declare const SECTION_CATEGORY_DEFAULTS: Record<SectionCategory, SectionCategoryDefaults>;
+/**
+ * Get defaults for a category
+ *
+ * @param category - Section category
+ * @returns Category defaults
+ *
+ * @example
+ * ```typescript
+ * const defaults = getCategoryDefaults('hero');
+ * console.log(defaults.height); // 'fullscreen'
+ * ```
+ */
+export declare function getCategoryDefaults(category: SectionCategory): SectionCategoryDefaults;
+/**
+ * Get icon for a category
+ *
+ * @param category - Section category
+ * @returns Lucide icon name
+ *
+ * @example
+ * ```typescript
+ * const icon = getCategoryIcon('hero'); // 'Rocket'
+ * ```
+ */
+export declare function getCategoryIcon(category: SectionCategory): string;
+/**
+ * Get emoji for a category
+ *
+ * @param category - Section category
+ * @returns Category emoji
+ *
+ * @example
+ * ```typescript
+ * const emoji = getCategoryEmoji('hero'); // '🚀'
+ * ```
+ */
+export declare function getCategoryEmoji(category: SectionCategory): string;
+/**
+ * Get all section categories
+ *
+ * @returns Array of all section categories
+ */
+export declare function getAllSectionCategories(): readonly SectionCategory[];
+//# sourceMappingURL=section-registry.defaults.d.ts.map