@nikkory/vibe-engine 4.0.0

package/dist/types/granularity/template.types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Granularity Template Types
+ *
+ * This file defines the GranularityTemplate<G> generic interface that
+ * extends GranularityConfig<G> with 8 shared metadata fields.
+ *
+ * @packageDocumentation
+ * @module types/granularity
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { GranularityLevel, GranularityTemplateVisibility } from './base.types';
+import type { GranularityConfig } from './config.types';
+/**
+ * Template metadata - 8 fields shared by all granularity templates
+ *
+ * This interface defines the metadata that makes a config into a
+ * reusable template. Every template at any granularity level will
+ * have these 8 fields.
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * @example
+ * ```typescript
+ * const metadata: TemplateMetadata = {
+ *   templateId: 'hero-section-v1',
+ *   templateName: 'Hero Section',
+ *   description: 'A full-width hero section with headline and CTA',
+ *   author: 'Nikkory Team',
+ *   version: '1.0.0',
+ *   tags: ['hero', 'landing', 'cta', 'marketing'],
+ *   visibility: 'public',
+ *   thumbnail: 'https://nikkory.com/templates/hero-section.png'
+ * };
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export interface GranularityTemplateMetadata {
+    /** Unique template identifier (different from config id) */
+    readonly templateId: string;
+    /** Human-readable template name */
+    readonly templateName: string;
+    /** Template description */
+    readonly description: string;
+    /** Template author */
+    readonly author: string;
+    /** Template version (semver) */
+    readonly version: string;
+    /** Search tags for discovery */
+    readonly tags: readonly string[];
+    /** Visibility: private (local), team, public */
+    readonly visibility: GranularityTemplateVisibility;
+    /** Preview thumbnail URL */
+    readonly thumbnail?: string;
+}
+/**
+ * GranularityTemplate<G> - THE unified generic template interface
+ *
+ * This interface extends GranularityConfig<G> with TemplateMetadata,
+ * creating a complete template definition for any granularity level.
+ *
+ * Templates are reusable configurations that can be:
+ * - Shared publicly or within teams
+ * - Versioned and maintained
+ * - Discovered through tags and search
+ * - Customized when instantiated
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * @typeParam G - The granularity level this template is for
+ *
+ * @example
+ * ```typescript
+ * // Section template
+ * const heroTemplate: GranularityTemplate<'section'> = {
+ *   // Config fields
+ *   id: 'hero-instance-1',
+ *   granularity: 'section',
+ *   designSystem: 'material-design',
+ *   tier: 'enterprise',
+ *   title: 'Hero Section',
+ *   layout: { type: 'flex', alignment: 'center' },
+ *   factors: { spacing: 'lg' },
+ *
+ *   // Template metadata
+ *   templateId: 'hero-section-v1',
+ *   templateName: 'Hero Section Template',
+ *   description: 'Full-width hero with headline and CTA',
+ *   author: 'Nikkory',
+ *   version: '1.0.0',
+ *   tags: ['hero', 'landing', 'cta'],
+ *   visibility: 'public',
+ *   thumbnail: 'https://nikkory.com/hero.png'
+ * };
+ *
+ * // Page template
+ * const landingTemplate: GranularityTemplate<'page'> = {
+ *   id: 'landing-instance-1',
+ *   granularity: 'page',
+ *   designSystem: 'material-design',
+ *   tier: 'enterprise',
+ *   title: 'Landing Page',
+ *   children: [
+ *     { childGranularity: 'section', ref: 'hero-section-v1', slot: 'main' }
+ *   ],
+ *
+ *   templateId: 'landing-page-v1',
+ *   templateName: 'Landing Page Template',
+ *   description: 'Complete landing page with hero, features, CTA',
+ *   author: 'Nikkory',
+ *   version: '1.0.0',
+ *   tags: ['landing', 'marketing', 'conversion'],
+ *   visibility: 'public'
+ * };
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export interface GranularityTemplate<G extends GranularityLevel> extends GranularityConfig<G>, GranularityTemplateMetadata {
+}
+/**
+ * AtomTemplate - Template for atom-level components
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type AtomTemplate = GranularityTemplate<'atom'>;
+/**
+ * ComponentTemplate - Template for component-level elements
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type ComponentTemplate = GranularityTemplate<'component'>;
+/**
+ * SectionTemplate - Template for section-level elements
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type SectionGranularityTemplate = GranularityTemplate<'section'>;
+/**
+ * PageTemplate - Template for page-level elements
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type PageTemplate = GranularityTemplate<'page'>;
+/**
+ * LayoutTemplate - Template for layout-level elements
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type LayoutTemplate = GranularityTemplate<'layout'>;
+/**
+ * TemplateTemplate - Template for template-level elements
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type TemplateGranularityTemplate = GranularityTemplate<'template'>;
+//# sourceMappingURL=template.types.d.ts.map

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

@@ -0,0 +1,151 @@
+/**
+ * Atom Configuration Types
+ *
+ * Atom-level configuration for the smallest UI elements like Button, Input, Icon.
+ * Atoms are the building blocks that don't contain other elements.
+ *
+ * @packageDocumentation
+ * @module types/granularity-levels
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { GranularityLevel, GranularityFactorValues, GranularityStyleOverrides } from '../granularity/base.types';
+import type { GranularityConfig } from '../granularity/config.types';
+import type { GranularitySlotPosition, GranularitySlotConfig } from '../granularity/slot.types';
+import type { DesignSystem, Tier } from '../index';
+/**
+ * Atom slot position - atoms only have a content slot
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type AtomSlotPosition = GranularitySlotPosition<'atom'>;
+/**
+ * Atom slot configuration
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type AtomSlotConfig = GranularitySlotConfig<'atom'>;
+/**
+ * Atom type categories - 40+ types organized by function
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * @example
+ * ```typescript
+ * const category: AtomCategory = 'input';
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export type AtomCategory = 'button' | 'input' | 'text' | 'icon' | 'media' | 'feedback' | 'layout' | 'interactive';
+/**
+ * Atom type identifiers (40+ types)
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type AtomType = 'button' | 'icon-button' | 'link-button' | 'toggle-button' | 'input' | 'textarea' | 'checkbox' | 'radio' | 'switch' | 'slider' | 'select' | 'text' | 'heading' | 'label' | 'caption' | 'code' | 'icon' | 'logo' | 'avatar' | 'emoji' | 'image' | 'video' | 'audio' | 'spinner' | 'progress' | 'skeleton' | 'dot' | 'divider' | 'spacer' | 'container' | 'link' | 'badge' | 'chip' | 'tag' | 'tooltip-trigger';
+/**
+ * Atom-specific extension fields beyond GranularityConfig
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface AtomExtensions {
+    /** Atom type identifier */
+    readonly atomType: AtomType;
+    /** Atom category for organization */
+    readonly atomCategory: AtomCategory;
+    /** Size variant */
+    readonly size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** Visual variant */
+    readonly variant?: 'filled' | 'outlined' | 'ghost' | 'text';
+    /** Color scheme */
+    readonly colorScheme?: 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral';
+    /** Whether atom is disabled */
+    readonly disabled?: boolean;
+    /** Whether atom is in loading state */
+    readonly loading?: boolean;
+    /** Accessibility label */
+    readonly ariaLabel?: string;
+}
+/**
+ * AtomConfig - Full configuration for atom-level elements
+ *
+ * Extends GranularityConfig<'atom'> with atom-specific fields.
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * @example
+ * ```typescript
+ * const buttonConfig: AtomConfig = {
+ *   id: 'primary-button',
+ *   granularity: 'atom',
+ *   designSystem: 'material-design',
+ *   tier: 'standard',
+ *   title: 'Primary Button',
+ *   atomType: 'button',
+ *   atomCategory: 'button',
+ *   size: 'md',
+ *   variant: 'filled',
+ *   colorScheme: 'primary'
+ * };
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export interface AtomConfig extends AtomExtensions {
+    /** Unique identifier */
+    readonly id: string;
+    /** Granularity level - always 'atom' */
+    readonly granularity: 'atom';
+    /** Design system */
+    readonly designSystem: DesignSystem;
+    /** Quality tier */
+    readonly tier: Tier;
+    /** Display title */
+    readonly title: string;
+    /** Optional subtitle/description */
+    readonly subtitle?: string;
+    /** Factor values */
+    readonly factors?: GranularityFactorValues;
+    /** Style overrides */
+    readonly styleOverrides?: GranularityStyleOverrides;
+}
+/**
+ * Type guard to check if a config is an AtomConfig
+ *
+ * @category utils
+ * @since 4.0.0
+ *
+ * @param config - The config to check
+ * @returns True if config is an AtomConfig
+ *
+ * Powered by Nikkory
+ */
+export declare function isAtomConfig(config: GranularityConfig<GranularityLevel>): config is AtomConfig & GranularityConfig<'atom'>;
+/**
+ * AtomGranularityConfig - Alias to GranularityConfig<'atom'>
+ *
+ * Use AtomConfig for the full extended version with atom-specific fields.
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type AtomGranularityConfig = GranularityConfig<'atom'>;
+//# sourceMappingURL=atom.config.d.ts.map

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

@@ -0,0 +1,175 @@
+/**
+ * Component Configuration Types
+ *
+ * Component-level configuration for medium-complexity UI elements
+ * like Card, Modal, Dropdown that can contain atoms.
+ *
+ * @packageDocumentation
+ * @module types/granularity-levels
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { GranularityLevel, GranularityFactorValues, GranularityStyleOverrides, GranularityLayoutConfig } from '../granularity/base.types';
+import type { GranularityConfig, ChildReference } from '../granularity/config.types';
+import type { GranularitySlotPosition, GranularitySlotConfig } from '../granularity/slot.types';
+import type { DesignSystem, Tier } from '../index';
+/**
+ * Component slot positions - content, prefix, suffix
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type ComponentSlotPosition = GranularitySlotPosition<'component'>;
+/**
+ * Component slot configuration
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type ComponentSlotConfig = GranularitySlotConfig<'component'>;
+/**
+ * Component type categories - 100+ types organized by function
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * @example
+ * ```typescript
+ * const category: ComponentCategory = 'card';
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export type ComponentCategory = 'card' | 'form' | 'navigation' | 'overlay' | 'data-display' | 'feedback' | 'input-group' | 'layout' | 'media' | 'composite';
+/**
+ * Component type identifiers (100+ types)
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type ComponentType = 'card' | 'media-card' | 'profile-card' | 'stat-card' | 'pricing-card' | 'form' | 'form-group' | 'form-field' | 'form-section' | 'menu' | 'tabs' | 'breadcrumb' | 'pagination' | 'stepper' | 'navbar' | 'modal' | 'drawer' | 'popover' | 'tooltip' | 'dropdown' | 'table' | 'list' | 'tree' | 'timeline' | 'data-grid' | 'alert' | 'toast' | 'notification' | 'banner' | 'snackbar' | 'input-group' | 'search-bar' | 'date-picker' | 'time-picker' | 'color-picker' | 'accordion' | 'collapse' | 'panel' | 'split-pane' | 'carousel' | 'gallery' | 'video-player' | 'audio-player' | 'header' | 'footer' | 'sidebar' | 'toolbar';
+/**
+ * Component-specific extension fields beyond GranularityConfig
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export interface ComponentExtensions {
+    /** Component type identifier */
+    readonly componentType: ComponentType;
+    /** Component category for organization */
+    readonly componentCategory: ComponentCategory;
+    /** Size variant */
+    readonly size?: 'sm' | 'md' | 'lg' | 'xl';
+    /** Visual variant */
+    readonly variant?: 'elevated' | 'outlined' | 'filled' | 'ghost';
+    /** Whether component is interactive */
+    readonly interactive?: boolean;
+    /** Whether component is collapsible */
+    readonly collapsible?: boolean;
+    /** Whether component starts expanded (if collapsible) */
+    readonly defaultExpanded?: boolean;
+    /** Whether component is dismissible */
+    readonly dismissible?: boolean;
+    /** Whether component is draggable */
+    readonly draggable?: boolean;
+    /** Whether component supports selection */
+    readonly selectable?: boolean;
+    /** Maximum height with scroll */
+    readonly maxHeight?: string;
+}
+/**
+ * ComponentConfig - Full configuration for component-level elements
+ *
+ * Extends GranularityConfig<'component'> with component-specific fields.
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * @example
+ * ```typescript
+ * const cardConfig: ComponentConfig = {
+ *   id: 'feature-card',
+ *   granularity: 'component',
+ *   designSystem: 'material-design',
+ *   tier: 'enterprise',
+ *   title: 'Feature Card',
+ *   componentType: 'card',
+ *   componentCategory: 'card',
+ *   size: 'md',
+ *   variant: 'elevated',
+ *   interactive: true,
+ *   slots: [
+ *     { slotId: 'card-content', position: 'content', allowedChildren: ['atom'], maxChildren: 10 }
+ *   ]
+ * };
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export interface ComponentConfig extends ComponentExtensions {
+    /** Unique identifier */
+    readonly id: string;
+    /** Granularity level - always 'component' */
+    readonly granularity: 'component';
+    /** 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 child atoms */
+    readonly slots?: readonly ComponentSlotConfig[];
+    /** Factor values */
+    readonly factors?: GranularityFactorValues;
+    /** Children references */
+    readonly children?: readonly ChildReference<'component'>[];
+    /** Style overrides */
+    readonly styleOverrides?: GranularityStyleOverrides;
+}
+/**
+ * Default slot configurations for components
+ *
+ * @category constants
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const DEFAULT_COMPONENT_SLOTS: readonly ComponentSlotConfig[];
+/**
+ * Type guard to check if a config is a ComponentConfig
+ *
+ * @category utils
+ * @since 4.0.0
+ *
+ * @param config - The config to check
+ * @returns True if config is a ComponentConfig
+ *
+ * Powered by Nikkory
+ */
+export declare function isComponentConfig(config: GranularityConfig<GranularityLevel>): config is ComponentConfig & GranularityConfig<'component'>;
+/**
+ * ComponentGranularityConfig - Alias to GranularityConfig<'component'>
+ *
+ * Use ComponentConfig for the full extended version with component-specific fields.
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type ComponentGranularityConfig = GranularityConfig<'component'>;
+//# sourceMappingURL=component.config.d.ts.map

package/dist/types/granularity-levels/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Granularity Levels - Level-Specific Configuration Types
+ *
+ * This module exports level-specific configuration types for all 6 granularity levels:
+ * - Atom: Smallest UI elements (Button, Input, Icon)
+ * - Component: Medium-complexity elements (Card, Modal, Dropdown)
+ * - Section: Large UI blocks (Hero, Pricing, Testimonials)
+ * - Page: Complete routes (Landing, Dashboard, Auth)
+ * - Layout: Structural wrappers (AppLayout, AuthLayout, DashboardLayout)
+ * - Template: Complete applications (Admin, E-commerce, SaaS)
+ *
+ * Each level has its own configuration interface extending the generic GranularityConfig<G>.
+ *
+ * @packageDocumentation
+ * @module types/granularity-levels
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { AtomConfig } from './atom.config';
+import type { ComponentConfig as ComponentLevelConfig } from './component.config';
+import type { LayoutLevelConfig } from './layout.config';
+import type { PageLevelConfig } from './page.config';
+import type { SectionLevelConfig } from './section.config';
+import type { TemplateLevelConfig } from './template.config';
+export type { AtomSlotPosition, AtomSlotConfig, AtomCategory, AtomType, AtomExtensions, AtomConfig, AtomGranularityConfig, } from './atom.config';
+export { isAtomConfig } from './atom.config';
+export type { ComponentSlotPosition, ComponentSlotConfig, ComponentCategory, ComponentType as ComponentLevelType, ComponentExtensions, ComponentConfig as ComponentLevelConfig, ComponentGranularityConfig, } from './component.config';
+export { isComponentConfig, DEFAULT_COMPONENT_SLOTS } from './component.config';
+export type { SectionSlotPosition, SectionSlotConfig, SectionLayoutType, SectionExtensions, SectionBackground, SectionLevelConfig, SectionGranularityConfig, } from './section.config';
+export { isSectionLevelConfig, DEFAULT_SECTION_SLOTS } from './section.config';
+export type { PageSlotPosition, PageSlotConfig, PageCategory, PageType, PageMetadata, PageExtensions, PageLevelConfig, PageGranularityConfig, } from './page.config';
+export { isPageLevelConfig, DEFAULT_PAGE_SLOTS } from './page.config';
+export type { LayoutSlotPosition, LayoutSlotConfig, LayoutCategory, LayoutType as LayoutLevelType, LayoutSidebar, ResponsiveConfig as LayoutResponsiveConfig, LayoutStructure, LayoutExtensions, LayoutLevelConfig, LayoutGranularityConfig, } from './layout.config';
+export { isLayoutLevelConfig, DEFAULT_LAYOUT_SLOTS } from './layout.config';
+export type { TemplateSlotPosition, TemplateSlotConfig, TemplateCategory, TemplateType, TechStack, TemplatePages, PageGroup, TemplateAssets, AssetReference, FontConfig, TemplateExtensions, TemplateLevelConfig, FullTemplate, TemplateGranularityConfig, GranularityTemplate, TemplateMetadata, } from './template.config';
+export { isTemplateLevelConfig, DEFAULT_TEMPLATE_SLOTS } from './template.config';
+/**
+ * Union type of all level-specific configurations
+ *
+ * @category types
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export type AnyLevelConfig = AtomConfig | ComponentLevelConfig | SectionLevelConfig | PageLevelConfig | LayoutLevelConfig | TemplateLevelConfig;
+//# sourceMappingURL=index.d.ts.map