@nikkory/vibe-engine 4.0.0

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

@@ -0,0 +1,213 @@
+/**
+ * Component Registry
+ *
+ * Central registry for all 169 components in the Nikkory Vibe library.
+ * Each component has full 16-Factor Dynamic Matrix support with 3 tiers (Basic, Standard, Enterprise).
+ *
+ * @packageDocumentation
+ * @module presets/component-registry
+ * @since 2.0.0
+ *
+ * Powered by Nikkory
+ */
+/**
+ * Component category types.
+ */
+export type ComponentCategory = 'form' | 'feedback' | 'navigation' | 'data-display' | 'overlay' | 'layout' | 'media' | 'utility' | 'advanced' | 'social' | 'ecommerce' | 'content';
+/**
+ * Component complexity level.
+ */
+export type ComponentComplexity = 'low' | 'medium' | 'high';
+/**
+ * Component status in the library.
+ */
+export type ComponentStatus = 'stable' | 'beta' | 'alpha' | 'planned' | 'deprecated';
+import type { DesignSystem, Tier } from '../types';
+/**
+ * Registry component definition with UI display fields.
+ * This is the unified type for both code generation and UI display.
+ * @since 2.1.0
+ */
+export interface RegistryComponentDefinition {
+    /** Unique component ID (kebab-case) */
+    readonly id: string;
+    /** Display name */
+    readonly name: string;
+    /** Category */
+    readonly category: ComponentCategory;
+    /** Complexity level */
+    readonly complexity: ComponentComplexity;
+    /** Component status */
+    readonly status: ComponentStatus;
+    /** HTML element type */
+    readonly element: string;
+    /** Dependencies on other components */
+    readonly dependencies: readonly string[];
+    /** Brief description */
+    readonly description: string;
+    /** Keywords for search */
+    readonly keywords: readonly string[];
+    /** Phase when component was/will be added */
+    readonly phase: string;
+    /** Lucide icon name for UI display */
+    readonly icon: string;
+    /** Emoji for quick visual identification */
+    readonly emoji: string;
+    /** Supported design systems */
+    readonly designSystems: readonly DesignSystem[];
+    /** Available quality tiers */
+    readonly tiers: readonly Tier[];
+    /** Show "NEW" badge in UI */
+    readonly isNew?: boolean;
+    /** Show "POPULAR" badge in UI */
+    readonly isPopular?: boolean;
+    /** Additional search tags for UI filtering */
+    readonly tags: readonly string[];
+}
+/**
+ * @deprecated Use RegistryComponentDefinition instead. Will be removed in v3.0.0.
+ */
+export type ComponentDefinition = RegistryComponentDefinition;
+/**
+ * All components in the registry with UI fields.
+ * Total: 169 components with full 16-Factor Dynamic Matrix support
+ */
+export declare const ALL_COMPONENTS: readonly RegistryComponentDefinition[];
+/**
+ * Component registry indexed by ID.
+ */
+export declare const COMPONENT_REGISTRY: Record<string, RegistryComponentDefinition>;
+/**
+ * All valid component IDs.
+ * This type is derived from the registry and auto-updates when components are added.
+ */
+export type ComponentId = (typeof ALL_COMPONENTS)[number]['id'];
+/**
+ * Get all component IDs.
+ */
+export declare function getAllComponentIds(): string[];
+/**
+ * Get component by ID.
+ */
+export declare function getComponent(id: string): RegistryComponentDefinition | undefined;
+/**
+ * Check if component ID is valid.
+ */
+export declare function isValidComponentId(id: string): boolean;
+/**
+ * Get components by category.
+ */
+export declare function getComponentsByCategory(category: ComponentCategory): RegistryComponentDefinition[];
+/**
+ * Get components by status.
+ */
+export declare function getComponentsByStatus(status: ComponentStatus): RegistryComponentDefinition[];
+/**
+ * Get components by phase.
+ */
+export declare function getComponentsByPhase(phase: string): RegistryComponentDefinition[];
+/**
+ * Get stable components only.
+ */
+export declare function getStableComponents(): RegistryComponentDefinition[];
+/**
+ * Get planned components only.
+ */
+export declare function getPlannedComponents(): RegistryComponentDefinition[];
+/**
+ * Search components by keyword.
+ */
+export declare function searchComponents(keyword: string): RegistryComponentDefinition[];
+/**
+ * Get component dependencies (recursive).
+ */
+export declare function getComponentDependencies(id: string, visited?: Set<string>): string[];
+/**
+ * Get components that depend on a given component.
+ */
+export declare function getComponentDependents(id: string): RegistryComponentDefinition[];
+/**
+ * Get registry statistics.
+ */
+export declare function getRegistryStats(): {
+    total: number;
+    stable: number;
+    planned: number;
+    byCategory: Record<ComponentCategory, number>;
+    byPhase: Record<string, number>;
+};
+/**
+ * Get popular components (marked with isPopular: true).
+ * @returns Array of popular components sorted by name
+ * @since 2.1.0
+ */
+export declare function getPopularComponents(): RegistryComponentDefinition[];
+/**
+ * Get new components (marked with isNew: true).
+ * @returns Array of new components sorted by name
+ * @since 2.1.0
+ */
+export declare function getNewComponents(): RegistryComponentDefinition[];
+/**
+ * Search components for UI display with enhanced matching.
+ * Searches in: id, name, description, keywords, tags, emoji.
+ *
+ * @param query - Search query string
+ * @returns Array of matching components sorted by relevance
+ * @since 2.1.0
+ */
+export declare function searchUIComponents(query: string): RegistryComponentDefinition[];
+/**
+ * Get components by design system.
+ * @param designSystem - Design system ID to filter by
+ * @returns Array of components supporting the design system
+ * @since 2.1.0
+ */
+export declare function getComponentsByDesignSystem(designSystem: DesignSystem): RegistryComponentDefinition[];
+/**
+ * Get components by tier.
+ * @param tier - Tier to filter by
+ * @returns Array of components supporting the tier
+ * @since 2.1.0
+ */
+export declare function getComponentsByTier(tier: Tier): RegistryComponentDefinition[];
+/**
+ * Get components by icon name.
+ * @param icon - Lucide icon name
+ * @returns Array of components with that icon
+ * @since 2.1.0
+ */
+export declare function getComponentsByIcon(icon: string): RegistryComponentDefinition[];
+/**
+ * Get all unique icons used in the registry.
+ * @returns Array of unique icon names
+ * @since 2.1.0
+ */
+export declare function getAllIcons(): string[];
+/**
+ * Get all unique emojis used in the registry.
+ * @returns Array of unique emojis
+ * @since 2.1.0
+ */
+export declare function getAllEmojis(): string[];
+/**
+ * Get components grouped by category for UI display.
+ * @returns Record of category to components array
+ * @since 2.1.0
+ */
+export declare function getComponentsGroupedByCategory(): Record<ComponentCategory, RegistryComponentDefinition[]>;
+/**
+ * Get UI statistics for the registry.
+ * @returns Statistics including popular/new counts and category breakdown
+ * @since 2.1.0
+ */
+export declare function getUIStats(): {
+    total: number;
+    popular: number;
+    new: number;
+    byCategory: Record<ComponentCategory, number>;
+    byDesignSystem: Record<DesignSystem, number>;
+    byTier: Record<Tier, number>;
+};
+export default COMPONENT_REGISTRY;
+//# sourceMappingURL=component-registry.d.ts.map

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

@@ -0,0 +1,364 @@
+/**
+ * Factor Registry - Unified Granularity Architecture
+ *
+ * This file defines the 24 factors with level and cascadeDown fields,
+ * replacing hardcoded 8/13/24 factor arrays with a dynamic registry-based approach.
+ *
+ * Each factor specifies:
+ * - `level`: Minimum granularity level where this factor applies
+ * - `cascadeDown`: Whether factor cascades DOWN to child granularities
+ *
+ * Factor Distribution by Level:
+ * - Template (level 6): 8 factors - cascadeDown=true
+ * - Page (level 4): 5 additional factors
+ * - Section (level 3): 5 additional factors
+ * - Component (level 2): 6 additional factors
+ * - Total: 24 factors
+ *
+ * @packageDocumentation
+ * @module presets/factor-registry
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { GranularityFactorDefinition, GranularityFactorCategory } from '../types/granularity';
+/**
+ * Color Primary - Primary brand color
+ *
+ * @category visual
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const colorPrimaryFactor: GranularityFactorDefinition;
+/**
+ * Color Secondary - Secondary accent color
+ *
+ * @category visual
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const colorSecondaryFactor: GranularityFactorDefinition;
+/**
+ * Typography Scale - Font sizing scale
+ *
+ * @category visual
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const typographyScaleFactor: GranularityFactorDefinition;
+/**
+ * Border Radius - Corner rounding style
+ *
+ * @category visual
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const borderRadiusFactor: GranularityFactorDefinition;
+/**
+ * Shadow Style - Box shadow intensity
+ *
+ * @category visual
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const shadowStyleFactor: GranularityFactorDefinition;
+/**
+ * Theme Mode - Light/dark mode preference
+ *
+ * @category visual
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const themeModeFactor: GranularityFactorDefinition;
+/**
+ * Icon Style - Icon set and style
+ *
+ * @category visual
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const iconStyleFactor: GranularityFactorDefinition;
+/**
+ * Surface Style - Background surface treatment
+ *
+ * @category visual
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const surfaceStyleFactor: GranularityFactorDefinition;
+/**
+ * Spacing Scale - Global spacing scale
+ *
+ * @category layout
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const spacingScaleFactor: GranularityFactorDefinition;
+/**
+ * Container Width - Max container width
+ *
+ * @category layout
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const containerWidthFactor: GranularityFactorDefinition;
+/**
+ * Grid Columns - Default grid column count
+ *
+ * @category layout
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const gridColumnsFactor: GranularityFactorDefinition;
+/**
+ * Gap Size - Gap between grid/flex items
+ *
+ * @category layout
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const gapSizeFactor: GranularityFactorDefinition;
+/**
+ * Alignment - Default content alignment
+ *
+ * @category layout
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const alignmentFactor: GranularityFactorDefinition;
+/**
+ * Layout Type - Default layout structure
+ *
+ * @category layout
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const layoutTypeFactor: GranularityFactorDefinition;
+/**
+ * Aspect Ratio - Default media aspect ratio
+ *
+ * @category layout
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const aspectRatioFactor: GranularityFactorDefinition;
+/**
+ * Animation Duration - Default animation timing
+ *
+ * @category behavior
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const animationDurationFactor: GranularityFactorDefinition;
+/**
+ * Animation Easing - Default easing function
+ *
+ * @category behavior
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const animationEasingFactor: GranularityFactorDefinition;
+/**
+ * Hover Effect - Default hover interaction
+ *
+ * @category behavior
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const hoverEffectFactor: GranularityFactorDefinition;
+/**
+ * Loading Style - Default loading indicator
+ *
+ * @category behavior
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const loadingStyleFactor: GranularityFactorDefinition;
+/**
+ * Breakpoint Strategy - Responsive breakpoint approach
+ *
+ * @category responsive
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const breakpointStrategyFactor: GranularityFactorDefinition;
+/**
+ * Mobile Behavior - Mobile-specific adaptations
+ *
+ * @category responsive
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const mobileBehaviorFactor: GranularityFactorDefinition;
+/**
+ * Touch Target Size - Minimum touch target
+ *
+ * @category responsive
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const touchTargetSizeFactor: GranularityFactorDefinition;
+/**
+ * Focus Style - Focus indicator style
+ *
+ * @category a11y
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const focusStyleFactor: GranularityFactorDefinition;
+/**
+ * Reduced Motion - Motion preference handling
+ *
+ * @category a11y
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export declare const reducedMotionFactor: GranularityFactorDefinition;
+/**
+ * Factor Registry - All 24 factors with level and cascadeDown
+ *
+ * This array replaces hardcoded PAGE_FACTORS, SECTION_FACTORS arrays.
+ * Use `getFactorsForLevel()` to dynamically query applicable factors.
+ *
+ * @category constants
+ * @since 4.0.0
+ *
+ * @example
+ * ```typescript
+ * // Get all factors
+ * console.log(FACTOR_REGISTRY.length); // 24
+ *
+ * // Filter by category
+ * const visualFactors = FACTOR_REGISTRY.filter(f => f.category === 'visual');
+ *
+ * // Use getFactorsForLevel() instead of hardcoded arrays
+ * import { getFactorsForLevel } from '../utils/factor-resolver';
+ * const pageFactors = getFactorsForLevel('page');
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export declare const FACTOR_REGISTRY: readonly GranularityFactorDefinition[];
+/**
+ * Get factor by ID
+ *
+ * @category utils
+ * @since 4.0.0
+ *
+ * @param factorId - The factor ID to look up
+ * @returns The factor definition or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const factor = getFactorById('spacing');
+ * if (factor) {
+ *   console.log(factor.name); // 'Spacing Scale'
+ * }
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export declare function getFactorById(factorId: string): GranularityFactorDefinition | undefined;
+/**
+ * Get factors by category
+ *
+ * @category utils
+ * @since 4.0.0
+ *
+ * @param category - The category to filter by
+ * @returns Array of factors in the specified category
+ *
+ * @example
+ * ```typescript
+ * const visualFactors = getFactorsByCategory('visual');
+ * console.log(visualFactors.length); // 8
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export declare function getFactorsByCategory(category: GranularityFactorCategory): readonly GranularityFactorDefinition[];
+/**
+ * Get all factor IDs
+ *
+ * @category utils
+ * @since 4.0.0
+ *
+ * @returns Array of all factor IDs
+ *
+ * @example
+ * ```typescript
+ * const ids = getAllFactorIds();
+ * console.log(ids); // ['colorPrimary', 'colorSecondary', ...]
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export declare function getAllFactorIds(): readonly string[];
+/**
+ * Check if a factor ID is valid
+ *
+ * @category utils
+ * @since 4.0.0
+ *
+ * @param factorId - The factor ID to check
+ * @returns True if the factor exists in the registry
+ *
+ * @example
+ * ```typescript
+ * isValidFactorId('spacing'); // true
+ * isValidFactorId('invalid'); // false
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export declare function isValidFactorId(factorId: string): boolean;
+/**
+ * Get registry statistics
+ *
+ * @category utils
+ * @since 4.0.0
+ *
+ * @returns Statistics about the factor registry
+ *
+ * @example
+ * ```typescript
+ * const stats = getFactorRegistryStats();
+ * console.log(stats.total); // 24
+ * console.log(stats.byCategory.visual); // 8
+ * ```
+ *
+ * Powered by Nikkory
+ */
+export declare function getFactorRegistryStats(): {
+    readonly total: number;
+    readonly byCategory: Record<GranularityFactorCategory, number>;
+    readonly byCascadeDown: {
+        cascading: number;
+        nonCascading: number;
+    };
+};
+//# sourceMappingURL=factor-registry.d.ts.map