@nikkory/vibe-engine 4.0.0

package/dist/ui-studio/registries/components-registry.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Components Registry
+ * Maps components to their factor applicability (24-Factor system)
+ *
+ * @packageDocumentation
+ * @module registries/components-registry
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { ComponentType, DesignSystem, Tier } from '../types';
+import type { ComponentRegistryEntry, FactorApplicability, FactorId } from '../../types/algorithm-engine.types';
+/**
+ * Component Registry
+ * Maps each component type to its factor applicability and metadata
+ *
+ * @remarks
+ * - Each component defines which of the 24 factors apply
+ * - null = factor not applicable (skip)
+ * - true = factor applicable with design system default
+ * - string = factor applicable with specific override value
+ */
+export declare const COMPONENT_REGISTRY: Record<ComponentType, ComponentRegistryEntry>;
+/**
+ * Get component registry entry
+ *
+ * @param componentType - Component type to get entry for
+ * @returns Component registry entry
+ *
+ * @example
+ * ```typescript
+ * const entry = getComponentEntry('button');
+ * // entry.elementType = 'button'
+ * // entry.category = 'basic'
+ * ```
+ */
+export declare function getComponentEntry(componentType: ComponentType): ComponentRegistryEntry;
+/**
+ * Get all component types
+ *
+ * @returns Array of all component type IDs
+ */
+export declare function getAllComponentTypes(): ComponentType[];
+/**
+ * Get components by category
+ *
+ * @param category - Category to filter by
+ * @returns Array of component entries in the category
+ *
+ * @example
+ * ```typescript
+ * const basicComponents = getComponentsByCategory('basic');
+ * // Returns button, input, textarea, checkbox, etc.
+ * ```
+ */
+export declare function getComponentsByCategory(category: string): ComponentRegistryEntry[];
+/**
+ * Get component IDs by category
+ *
+ * @param category - Category to filter by
+ * @returns Array of component type IDs
+ */
+export declare function getComponentIdsByCategory(category: string): ComponentType[];
+/**
+ * Get all component categories
+ *
+ * @returns Array of unique category names
+ */
+export declare function getAllComponentCategories(): string[];
+/**
+ * Get component count by category
+ *
+ * @returns Map of category to component count
+ */
+export declare function getComponentCountByCategory(): Record<string, number>;
+/**
+ * Get applicable factors for a component
+ * Returns factor IDs where applicability is not null
+ *
+ * @param componentType - Component type to check
+ * @returns Array of applicable factor IDs
+ *
+ * @example
+ * ```typescript
+ * const factors = getApplicableFactors('button');
+ * // Returns [1, 2, 3, 4, 6, 7, 8, 9, 10, 13, 14, ...]
+ * ```
+ */
+export declare function getApplicableFactors(componentType: ComponentType): FactorId[];
+/**
+ * Get skipped factors for a component
+ * Returns factor IDs where applicability is null
+ *
+ * @param componentType - Component type to check
+ * @returns Array of skipped factor IDs
+ */
+export declare function getSkippedFactors(componentType: ComponentType): FactorId[];
+/**
+ * Get factor applicability for a component
+ *
+ * @param componentType - Component type to check
+ * @param factorId - Factor ID to check
+ * @returns Factor applicability (null, true, or override string)
+ *
+ * @example
+ * ```typescript
+ * getFactorApplicability('button', 1) // true
+ * getFactorApplicability('button', 5) // null
+ * getFactorApplicability('avatar', 4) // 'circle'
+ * ```
+ */
+export declare function getFactorApplicability(componentType: ComponentType, factorId: FactorId): FactorApplicability;
+/**
+ * Check if factor is applicable for a component
+ *
+ * @param componentType - Component type to check
+ * @param factorId - Factor ID to check
+ * @returns True if factor is applicable (not null)
+ */
+export declare function isFactorApplicable(componentType: ComponentType, factorId: FactorId): boolean;
+/**
+ * Get factor override value for a component
+ * Returns the override string if one exists, undefined otherwise
+ *
+ * @param componentType - Component type to check
+ * @param factorId - Factor ID to check
+ * @returns Override value or undefined
+ *
+ * @example
+ * ```typescript
+ * getFactorOverride('avatar', 4) // 'circle'
+ * getFactorOverride('button', 1) // undefined (uses default)
+ * ```
+ */
+export declare function getFactorOverride(componentType: ComponentType, factorId: FactorId): string | undefined;
+/**
+ * Get components that support a specific factor
+ *
+ * @param factorId - Factor ID to check
+ * @returns Array of component types that support the factor
+ */
+export declare function getComponentsSupportingFactor(factorId: FactorId): ComponentType[];
+/**
+ * Get components that support a design system
+ *
+ * @param designSystem - Design system to check
+ * @returns Array of component entries that support the design system
+ */
+export declare function getComponentsForDesignSystem(designSystem: DesignSystem): ComponentRegistryEntry[];
+/**
+ * Get components that support a tier
+ *
+ * @param tier - Tier to check
+ * @returns Array of component entries that support the tier
+ */
+export declare function getComponentsForTier(tier: Tier): ComponentRegistryEntry[];
+/**
+ * Check if a component supports a specific design system
+ *
+ * @param componentType - Component type to check
+ * @param designSystem - Design system to check
+ * @returns True if component supports the design system
+ */
+export declare function componentSupportsDesignSystem(componentType: ComponentType, designSystem: DesignSystem): boolean;
+/**
+ * Check if a component supports a specific tier
+ *
+ * @param componentType - Component type to check
+ * @param tier - Tier to check
+ * @returns True if component supports the tier
+ */
+export declare function componentSupportsTier(componentType: ComponentType, tier: Tier): boolean;
+/**
+ * Search components by name or category
+ *
+ * @param query - Search query
+ * @returns Array of matching component entries
+ */
+export declare function searchComponents(query: string): ComponentRegistryEntry[];
+/**
+ * Get total component count
+ *
+ * @returns Total number of registered components
+ */
+export declare function getTotalComponentCount(): number;
+/**
+ * Get component element type
+ *
+ * @param componentType - Component type
+ * @returns Base HTML element type
+ */
+export declare function getComponentElementType(componentType: ComponentType): string;
+//# sourceMappingURL=components-registry.d.ts.map

package/dist/ui-studio/registries/design-systems-registry.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Design Systems Registry
+ * Maps design systems to their factor values (24-Factor system with Tailwind CSS v4)
+ *
+ * @packageDocumentation
+ * @module registries/design-systems-registry
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { DesignSystem } from '../types';
+import type { DesignSystemRegistryEntry, FactorValue, FactorId } from '../../types/algorithm-engine.types';
+/**
+ * Design System Registry
+ * Maps each design system to its factor values and CSS variables
+ *
+ * @remarks
+ * - Each design system defines values for all 24 factors
+ * - Values include Tailwind CSS classes for direct styling
+ * - CSS variables are provided for Tailwind v4 @theme integration
+ */
+export declare const DESIGN_SYSTEM_REGISTRY: Record<DesignSystem, DesignSystemRegistryEntry>;
+/**
+ * Get design system registry entry
+ *
+ * @param designSystem - Design system to get entry for
+ * @returns Design system registry entry
+ *
+ * @example
+ * ```typescript
+ * const entry = getDesignSystemEntry('material-design');
+ * // entry.name = 'Material Design'
+ * // entry.description = 'Google Material Design 3...'
+ * ```
+ */
+export declare function getDesignSystemEntry(designSystem: DesignSystem): DesignSystemRegistryEntry;
+/**
+ * Get all design system IDs
+ *
+ * @returns Array of all design system IDs
+ */
+export declare function getAllDesignSystems(): DesignSystem[];
+/**
+ * Get factor value for a design system
+ *
+ * @param designSystem - Design system to check
+ * @param factorId - Factor ID to get value for
+ * @returns Factor value or undefined if not defined
+ *
+ * @example
+ * ```typescript
+ * const value = getFactorValue('material-design', 1);
+ * // value.tailwindClasses = 'bg-blue-500 text-white hover:bg-blue-600'
+ * ```
+ */
+export declare function getFactorValue(designSystem: DesignSystem, factorId: FactorId): FactorValue | undefined;
+/**
+ * Get all factor values for a design system
+ *
+ * @param designSystem - Design system to get values for
+ * @returns Map of factor ID to factor value
+ */
+export declare function getAllFactorValues(designSystem: DesignSystem): Partial<Record<FactorId, FactorValue>>;
+/**
+ * Get Tailwind classes for a factor in a design system
+ *
+ * @param designSystem - Design system to check
+ * @param factorId - Factor ID to get classes for
+ * @returns Tailwind classes or empty string if not defined
+ */
+export declare function getFactorTailwindClasses(designSystem: DesignSystem, factorId: FactorId): string;
+/**
+ * Get CSS variables for a factor in a design system
+ *
+ * @param designSystem - Design system to check
+ * @param factorId - Factor ID to get variables for
+ * @returns CSS variables object or empty object if not defined
+ */
+export declare function getFactorCssVariables(designSystem: DesignSystem, factorId: FactorId): Record<string, string>;
+/**
+ * Get all CSS variables for a design system
+ *
+ * @param designSystem - Design system to get variables for
+ * @returns All CSS variables for the design system
+ */
+export declare function getDesignSystemCssVariables(designSystem: DesignSystem): Record<string, string>;
+/**
+ * Get design system name
+ *
+ * @param designSystem - Design system ID
+ * @returns Human-readable name
+ */
+export declare function getDesignSystemName(designSystem: DesignSystem): string;
+/**
+ * Get design system description
+ *
+ * @param designSystem - Design system ID
+ * @returns Description of the design system
+ */
+export declare function getDesignSystemDescription(designSystem: DesignSystem): string;
+/**
+ * Search design systems by name or description
+ *
+ * @param query - Search query
+ * @returns Array of matching design system entries
+ */
+export declare function searchDesignSystems(query: string): DesignSystemRegistryEntry[];
+/**
+ * Get total design system count
+ *
+ * @returns Total number of registered design systems
+ */
+export declare function getTotalDesignSystemCount(): number;
+/**
+ * Check if a design system has a specific factor value
+ *
+ * @param designSystem - Design system to check
+ * @param factorId - Factor ID to check
+ * @returns True if factor value is defined
+ */
+export declare function hasFactorValue(designSystem: DesignSystem, factorId: FactorId): boolean;
+/**
+ * Get design systems that define a specific factor
+ *
+ * @param factorId - Factor ID to check
+ * @returns Array of design system IDs that define the factor
+ */
+export declare function getDesignSystemsWithFactor(factorId: FactorId): DesignSystem[];
+/**
+ * Generate @theme CSS block for a design system (Tailwind v4)
+ *
+ * @param designSystem - Design system to generate theme for
+ * @returns CSS string with @theme block
+ *
+ * @example
+ * ```typescript
+ * const css = generateThemeCss('material-design');
+ * // @theme {
+ * //   --md-color-primary: #2196f3;
+ * //   ...
+ * // }
+ * ```
+ */
+export declare function generateThemeCss(designSystem: DesignSystem): string;
+/**
+ * Merge factor values from design system with overrides
+ *
+ * @param designSystem - Base design system
+ * @param overrides - Factor value overrides
+ * @returns Merged factor values map
+ */
+export declare function mergeFactorValues(designSystem: DesignSystem, overrides: Partial<Record<FactorId, FactorValue>>): Map<FactorId, FactorValue>;
+//# sourceMappingURL=design-systems-registry.d.ts.map

package/dist/ui-studio/registries/factors-registry.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Factors Registry
+ * Consolidated 24-Factor definitions with metadata
+ *
+ * @packageDocumentation
+ * @module registries/factors-registry
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { FactorDefinition, FactorId, FactorGroup } from '../../types/algorithm-engine.types';
+/**
+ * Complete 24-Factor Registry
+ * Defines all factors with their metadata, default values, and possible values
+ *
+ * @remarks
+ * Factors are grouped by tier availability:
+ * - Factors 1-6: Basic tier (visual foundations)
+ * - Factors 7-14: Standard tier (interaction + layout)
+ * - Factors 15-24: Enterprise tier (advanced features)
+ */
+export declare const FACTOR_REGISTRY: Record<FactorId, FactorDefinition>;
+/**
+ * Get factor definition by ID
+ *
+ * @param factorId - Factor ID (1-24)
+ * @returns Factor definition
+ *
+ * @example
+ * ```typescript
+ * const factor = getFactorDefinition(1);
+ * // factor.name = 'Color'
+ * // factor.group = 'visual'
+ * ```
+ */
+export declare function getFactorDefinition(factorId: FactorId): FactorDefinition;
+/**
+ * Get all factor definitions
+ *
+ * @returns Array of all 24 factor definitions
+ */
+export declare function getAllFactorDefinitions(): FactorDefinition[];
+/**
+ * Get factors by group
+ *
+ * @param group - Factor group to filter by
+ * @returns Array of factor definitions in the group
+ *
+ * @example
+ * ```typescript
+ * const visualFactors = getFactorsByGroup('visual');
+ * // Returns factors 1-4, 9, 16, 18-20
+ * ```
+ */
+export declare function getFactorsByGroup(group: FactorGroup): FactorDefinition[];
+/**
+ * Get factor IDs by group
+ *
+ * @param group - Factor group to filter by
+ * @returns Array of factor IDs in the group
+ */
+export declare function getFactorIdsByGroup(group: FactorGroup): FactorId[];
+/**
+ * Get factor name by ID
+ *
+ * @param factorId - Factor ID (1-24)
+ * @returns Factor name
+ */
+export declare function getFactorName(factorId: FactorId): string;
+/**
+ * Get default value for a factor
+ *
+ * @param factorId - Factor ID (1-24)
+ * @returns Default value for the factor
+ */
+export declare function getFactorDefaultValue(factorId: FactorId): string;
+/**
+ * Get possible values for a factor
+ *
+ * @param factorId - Factor ID (1-24)
+ * @returns Array of possible values
+ */
+export declare function getFactorPossibleValues(factorId: FactorId): readonly string[];
+/**
+ * Check if a value is valid for a factor
+ *
+ * @param factorId - Factor ID (1-24)
+ * @param value - Value to check
+ * @returns True if value is valid
+ *
+ * @example
+ * ```typescript
+ * isValidFactorValue(1, 'primary') // true
+ * isValidFactorValue(1, 'invalid') // false
+ * ```
+ */
+export declare function isValidFactorValue(factorId: FactorId, value: string): boolean;
+/**
+ * Get CSS property for a factor
+ *
+ * @param factorId - Factor ID (1-24)
+ * @returns CSS property or undefined if not applicable
+ */
+export declare function getFactorCssProperty(factorId: FactorId): string | undefined;
+/**
+ * Get data attribute for a factor
+ *
+ * @param factorId - Factor ID (1-24)
+ * @returns Data attribute name
+ */
+export declare function getFactorDataAttribute(factorId: FactorId): string | undefined;
+/**
+ * Get all factor groups
+ *
+ * @returns Array of unique factor groups
+ */
+export declare function getAllFactorGroups(): FactorGroup[];
+/**
+ * Get factor count by group
+ *
+ * @returns Map of group to factor count
+ */
+export declare function getFactorCountByGroup(): Record<FactorGroup, number>;
+/**
+ * Get factors in a range
+ *
+ * @param start - Starting factor ID
+ * @param end - Ending factor ID
+ * @returns Array of factor definitions in the range
+ *
+ * @example
+ * ```typescript
+ * getFactorsInRange(1, 6) // Basic tier factors
+ * getFactorsInRange(7, 14) // Standard tier additions
+ * ```
+ */
+export declare function getFactorsInRange(start: FactorId, end: FactorId): FactorDefinition[];
+/**
+ * Search factors by name or description
+ *
+ * @param query - Search query
+ * @returns Array of matching factor definitions
+ */
+export declare function searchFactors(query: string): FactorDefinition[];
+//# sourceMappingURL=factors-registry.d.ts.map

package/dist/ui-studio/registries/tiers-registry.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Tier Registry
+ * Maps tiers to factor ranges and code features (Option C: Registry-based)
+ *
+ * @packageDocumentation
+ * @module registries/tiers-registry
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Tier } from '../types';
+import type { TierRegistryEntry, FactorId } from '../../types/algorithm-engine.types';
+/**
+ * Tier Registry
+ * Maps each tier to its factor range, code features, and LOC range
+ *
+ * @remarks
+ * - Basic: Factors 1-6, minimal code features, 30-50 LOC
+ * - Standard: Factors 1-14, forwardRef + displayName, 50-150 LOC
+ * - Enterprise: Factors 1-24, full features, 150-300 LOC
+ */
+export declare const TIER_REGISTRY: Record<Tier, TierRegistryEntry>;
+/**
+ * Get tier registry entry
+ *
+ * @param tier - Tier to get entry for
+ * @returns Tier registry entry with factor range and code features
+ *
+ * @example
+ * ```typescript
+ * const entry = getTierEntry('enterprise');
+ * // entry.factorRange = { start: 1, end: 24 }
+ * // entry.codeFeatures.useMemo = true
+ * ```
+ */
+export declare function getTierEntry(tier: Tier): TierRegistryEntry;
+/**
+ * Get factors for a tier
+ * Returns array of factor IDs enabled for the specified tier
+ *
+ * @param tier - Tier to get factors for
+ * @returns Array of factor IDs (1-6, 1-14, or 1-24)
+ *
+ * @example
+ * ```typescript
+ * getFactorsForTier('basic')    // [1, 2, 3, 4, 5, 6]
+ * getFactorsForTier('standard') // [1, 2, ..., 14]
+ * getFactorsForTier('enterprise') // [1, 2, ..., 24]
+ * ```
+ */
+export declare function getFactorsForTier(tier: Tier): FactorId[];
+/**
+ * Get code features for a tier
+ *
+ * @param tier - Tier to get code features for
+ * @returns Code features configuration
+ *
+ * @example
+ * ```typescript
+ * const features = getCodeFeaturesForTier('enterprise');
+ * // features.useMemo = true
+ * // features.includeAnalytics = true
+ * ```
+ */
+export declare function getCodeFeaturesForTier(tier: Tier): TierRegistryEntry['codeFeatures'];
+/**
+ * Get LOC range for a tier
+ *
+ * @param tier - Tier to get LOC range for
+ * @returns Object with min and max LOC
+ *
+ * @example
+ * ```typescript
+ * const range = getLocRangeForTier('standard');
+ * // range = { min: 50, max: 150 }
+ * ```
+ */
+export declare function getLocRangeForTier(tier: Tier): TierRegistryEntry['locRange'];
+/**
+ * Check if a factor is enabled for a tier
+ *
+ * @param tier - Tier to check
+ * @param factorId - Factor ID to check
+ * @returns True if factor is enabled for tier
+ *
+ * @example
+ * ```typescript
+ * isFactorEnabledForTier('basic', 1)  // true
+ * isFactorEnabledForTier('basic', 10) // false
+ * isFactorEnabledForTier('enterprise', 24) // true
+ * ```
+ */
+export declare function isFactorEnabledForTier(tier: Tier, factorId: FactorId): boolean;
+/**
+ * Get the minimum tier required for a factor
+ *
+ * @param factorId - Factor ID to check
+ * @returns Minimum tier that supports this factor
+ *
+ * @example
+ * ```typescript
+ * getMinimumTierForFactor(5)  // 'basic'
+ * getMinimumTierForFactor(10) // 'standard'
+ * getMinimumTierForFactor(20) // 'enterprise'
+ * ```
+ */
+export declare function getMinimumTierForFactor(factorId: FactorId): Tier;
+/**
+ * Get all tiers that support a factor
+ *
+ * @param factorId - Factor ID to check
+ * @returns Array of tiers that support this factor
+ *
+ * @example
+ * ```typescript
+ * getTiersSupportingFactor(5)  // ['basic', 'standard', 'enterprise']
+ * getTiersSupportingFactor(10) // ['standard', 'enterprise']
+ * getTiersSupportingFactor(20) // ['enterprise']
+ * ```
+ */
+export declare function getTiersSupportingFactor(factorId: FactorId): Tier[];
+/**
+ * Compare tier levels
+ *
+ * @param a - First tier
+ * @param b - Second tier
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ *
+ * @example
+ * ```typescript
+ * compareTierLevels('basic', 'enterprise') // -1
+ * compareTierLevels('standard', 'standard') // 0
+ * compareTierLevels('enterprise', 'basic') // 1
+ * ```
+ */
+export declare function compareTierLevels(a: Tier, b: Tier): -1 | 0 | 1;
+/**
+ * Get all tier IDs
+ *
+ * @returns Array of all tier IDs in order
+ */
+export declare function getAllTiers(): Tier[];
+/**
+ * Get tier display name
+ *
+ * @param tier - Tier to get display name for
+ * @returns Capitalized tier name
+ */
+export declare function getTierDisplayName(tier: Tier): string;
+//# sourceMappingURL=tiers-registry.d.ts.map