@nikkory/vibe-engine 4.0.0

package/dist/converters/section-converter.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Section Converter - Bridge from Registry to SectionConfig
+ *
+ * @packageDocumentation
+ * @module converters/section-converter
+ * @since 4.1.0
+ *
+ * @remarks
+ * This module provides the bridge function `toSectionConfig()` that converts
+ * a `RegistrySectionDefinition` (from section-registry) to a `SectionConfig`
+ * (used by generators and storage).
+ *
+ * Field Name Unification:
+ * - Registry `id` → SectionConfig `sectionId`
+ * - Registry `category` → SectionConfig `sectionType`
+ * - Registry `sectionLayout` → SectionConfig `layout`
+ *
+ * Powered by Nikkory
+ */
+import type { RegistrySectionDefinition } from '../ui-studio/presets/registry.types';
+import type { DesignSystem, Tier } from '../types';
+import type { SectionConfig, SectionCategory, LayoutType, SpacingLevel } from '../types/section.types';
+/**
+ * User-provided overrides for section configuration
+ *
+ * @remarks
+ * These are the fields that users can customize when using a section template.
+ * All fields are optional - if not provided, the registry defaults are used.
+ *
+ * @example
+ * ```typescript
+ * const overrides: SectionUserOverrides = {
+ *   title: 'My Custom Hero',
+ *   subtitle: 'Welcome to our platform',
+ *   designSystem: 'brutalism',
+ *   tier: 'enterprise',
+ *   columns: 2,
+ * };
+ *
+ * const config = toSectionConfig(registryDefinition, overrides);
+ * ```
+ */
+export interface SectionUserOverrides {
+    /** Custom section title */
+    readonly title?: string;
+    /** Custom section subtitle */
+    readonly subtitle?: string;
+    /** Override design system */
+    readonly designSystem?: DesignSystem;
+    /** Override quality tier */
+    readonly tier?: Tier;
+    /** Override layout type */
+    readonly layout?: LayoutType;
+    /** Override number of columns */
+    readonly columns?: 1 | 2 | 3 | 4 | 6;
+    /** Override spacing level */
+    readonly spacing?: SpacingLevel;
+    /** Override item count (for list-based sections) */
+    readonly itemCount?: number;
+    /** Override show CTA */
+    readonly showCta?: boolean;
+    /** Override show media */
+    readonly showMedia?: boolean;
+}
+/**
+ * Convert a RegistrySectionDefinition to SectionConfig
+ *
+ * @remarks
+ * This is the primary bridge function between the registry (UI/filtering) and
+ * the generation system. It handles:
+ *
+ * 1. **Field Name Unification**: Maps legacy field names to unified names
+ *    - `id` → `sectionId`
+ *    - `category` → `sectionType`
+ *    - `sectionLayout` → `layout`
+ *
+ * 2. **User Overrides**: Applies user-provided customizations
+ *    - Override priority: userOverrides > registry definition > category defaults
+ *
+ * 3. **Type Safety**: Ensures the returned SectionConfig is valid
+ *
+ * @param registry - The registry section definition to convert
+ * @param overrides - Optional user overrides for customization
+ * @returns A valid SectionConfig for use in generation
+ *
+ * @example
+ * ```typescript
+ * import { toSectionConfig } from './converters';
+ * import { ALL_SECTIONS } from './section-registry';
+ *
+ * // Find a section by id
+ * const heroSection = ALL_SECTIONS.find(s => s.id === 'hero-centered');
+ *
+ * // Convert to SectionConfig
+ * const config = toSectionConfig(heroSection);
+ *
+ * // Or with user overrides
+ * const customConfig = toSectionConfig(heroSection, {
+ *   title: 'Welcome to Nikkory',
+ *   designSystem: 'brutalism',
+ *   tier: 'enterprise',
+ * });
+ * ```
+ */
+export declare function toSectionConfig(registry: RegistrySectionDefinition, overrides?: SectionUserOverrides): SectionConfig;
+/**
+ * Convert multiple registry definitions to SectionConfigs
+ *
+ * @param sections - Array of registry definitions
+ * @param overrides - Optional map of overrides keyed by section id
+ * @returns Array of SectionConfigs
+ *
+ * @example
+ * ```typescript
+ * const heroSections = ALL_SECTIONS.filter(s => s.category === 'hero');
+ * const configs = toSectionConfigs(heroSections);
+ *
+ * // With per-section overrides
+ * const configs = toSectionConfigs(heroSections, {
+ *   'hero-centered': { title: 'Custom Hero' },
+ *   'hero-split': { tier: 'enterprise' },
+ * });
+ * ```
+ */
+export declare function toSectionConfigs(sections: readonly RegistrySectionDefinition[], overrides?: Record<string, SectionUserOverrides>): readonly SectionConfig[];
+/**
+ * Find a section by ID and convert to SectionConfig
+ *
+ * @param sections - Array of registry definitions to search
+ * @param sectionId - The section ID to find
+ * @param overrides - Optional user overrides
+ * @returns SectionConfig if found, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * const config = findAndConvertSection(ALL_SECTIONS, 'hero-centered', {
+ *   title: 'My Hero',
+ * });
+ *
+ * if (config) {
+ *   console.log(config.sectionId); // 'hero-centered'
+ *   console.log(config.title); // 'My Hero'
+ * }
+ * ```
+ */
+export declare function findAndConvertSection(sections: readonly RegistrySectionDefinition[], sectionId: string, overrides?: SectionUserOverrides): SectionConfig | undefined;
+/**
+ * Find sections by category and convert to SectionConfigs
+ *
+ * @param sections - Array of registry definitions to search
+ * @param category - The section category to filter by
+ * @param overrides - Optional map of overrides keyed by section id
+ * @returns Array of SectionConfigs for the category
+ *
+ * @example
+ * ```typescript
+ * const heroConfigs = findAndConvertByCategory(ALL_SECTIONS, 'hero');
+ * console.log(heroConfigs.length); // 10 hero sections
+ * ```
+ */
+export declare function findAndConvertByCategory(sections: readonly RegistrySectionDefinition[], category: SectionCategory, overrides?: Record<string, SectionUserOverrides>): readonly SectionConfig[];
+/**
+ * Validate that a SectionConfig has all required fields
+ *
+ * @param config - The SectionConfig to validate
+ * @returns Validation result with errors if any
+ */
+export declare function validateSectionConfig(config: SectionConfig): {
+    valid: boolean;
+    errors: readonly string[];
+};
+/**
+ * Check if a value is a valid SectionUserOverrides object
+ */
+export declare function isSectionUserOverrides(value: unknown): value is SectionUserOverrides;
+//# sourceMappingURL=section-converter.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Nikkory Vibe Engine - Framework-Agnostic Code Generation
+ *
+ * @packageDocumentation
+ * @module engine
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+export { cn, generateStyles } from './styling';
+export type { StyleConfig, GeneratedStyles, StyleGeneratorFn } from './styling/types';
+export * from './ui-studio/presets/variants';
+export { UI_COMPONENTS as ALL_COMPONENTS, getStableComponents, searchUIComponents as searchComponents, } from './ui-studio';
+export type { RegistryComponentDefinition } from './ui-studio';
+export { ALL_SECTIONS } from './ui-studio';
+export { ALL_PAGES } from './ui-studio';
+export { ALL_LAYOUTS } from './ui-studio';
+export { ALL_TEMPLATES } from './ui-studio';
+export { DESIGN_SYSTEM_DEFAULTS, MATERIAL_DESIGN_DEFAULTS, IOS_HIG_DEFAULTS, GLASSMORPHISM_DEFAULTS, NEUMORPHISM_DEFAULTS, BRUTALISM_DEFAULTS, MINIMALISM_DEFAULTS, CYBERPUNK_DEFAULTS, FLAT_DESIGN_DEFAULTS, RETRO_VINTAGE_DEFAULTS, FLUENT_DESIGN_DEFAULTS, CARBON_DESIGN_DEFAULTS, ANT_DESIGN_DEFAULTS, getDefaultFactors, mergeWithDefaults, getAvailableDesignSystems, isDesignSystemSupported, } from './ui-studio/presets/section-defaults';
+export type { RegistrySectionDefinition, RegistryPageDefinition, RegistryLayoutDefinition, RegistryTemplateDefinition, BaseRegistryDefinition, SectionCategory, PageCategory, LayoutCategory, TemplateCategory, PageType, } from './ui-studio';
+export * from './ui-studio/presets/registry.constants';
+export { TierGenerator } from './ui-studio';
+export { PageGenerator } from './ui-studio';
+export type { CompositionConfig, CompositionStrategy, SlotDefinition, } from './ui-studio/composition/PageGenerator';
+export type { TierGenerationConfig, GenerationResult, BatchGenerationConfig, BatchGenerationResult, GenerationOptions, ComponentTemplateData, TierFeatures, SectionGenerationConfig, PageGenerationConfig, LayoutGenerationConfig, TemplateGenerationConfig, GeneratorStats, } from './ui-studio/types';
+export { getTierFeatures } from './ui-studio/types';
+export { SectionGenerator as SectionConfigGenerator, createSectionGenerator as createSectionConfigGenerator, generateSection as generateSectionFromConfig, } from './ui-studio/composition/SectionGenerator';
+export type { SectionGenerationInput as SectionConfigGenerationInput, SectionGenerationResult as SectionConfigGenerationResult, SectionGeneratorOptions as SectionConfigGeneratorOptions, GeneratedSlot, SectionGenerationMetadata as SectionConfigGenerationMetadata, } from './ui-studio/composition/SectionGenerator';
+export { SlotResolver, createSlotResolver, resolveSlots, resolveSlot, } from './ui-studio';
+export type { SlotResolutionInput, SlotResolutionResult, ResolvedSlot, ResolvedComponent, } from './ui-studio/composition/SlotResolver';
+export { FactorPropagator, createFactorPropagator, propagateFactors, getFactorTailwindClasses, getFactorCssVariables, mapFactorsToProps, SECTION_FACTOR_MAPPINGS, } from './ui-studio';
+export type { FactorPropagationInput, FactorPropagationResult, FactorPropMapping, PropagatedFactor, FactorPropagatorOptions, } from './ui-studio/composition/FactorPropagator';
+export { SectionGenerator, createSectionGenerator, generateSectionComponents, } from './ui-studio/composition/section-orchestrator';
+export type { SectionGenerationInput, SectionGenerationOptions, SectionGenerationResult, SectionGenerationMetadata, GeneratedSlotComponent, GeneratedComponentMetadata, } from './ui-studio/composition/section-orchestrator';
+export { toSectionConfig, toSectionConfigs, findAndConvertSection, findAndConvertByCategory, validateSectionConfig as validateSectionConfigConverter, isSectionUserOverrides, } from './converters';
+export type { SectionUserOverrides } from './converters';
+export { FactorResolver, createFactorResolver, resolveFactors, getTailwindClassesForComponent, getCssVariablesForComponent, } from './ui-studio/resolution/FactorResolver';
+export { ComponentGenerator, createComponentGenerator, generateComponent, generateComponentOutput, } from './ui-studio';
+export type { StyleOutput, CodeOutput, ComponentGenerationResult, } from './ui-studio/ComponentGenerator';
+export { TIER_REGISTRY, getTierEntry, getFactorsForTier, getCodeFeaturesForTier, getLocRangeForTier, isFactorEnabledForTier, getMinimumTierForFactor, getTiersSupportingFactor, compareTierLevels, getAllTiers, getTierDisplayName, ALGORITHM_FACTOR_REGISTRY as FACTOR_REGISTRY, getFactorDefinition, getAllFactorDefinitions, getFactorsByGroup, getFactorIdsByGroup, getFactorName, getFactorDefaultValue, getFactorPossibleValues, isValidFactorValue, getFactorCssProperty, getFactorDataAttribute, getAllFactorGroups, getFactorCountByGroup, getFactorsInRange, searchFactors, } from './ui-studio';
+export { VALID_TIERS, isValidTier, assertValidTier, parseTier, getTierOrDefault, suggestTier, isValidFactorId, validateFactorId, validateFactorValueInput, validateFactorOverrides, assertValidFactorId, parseFactorId, VALID_COMPONENT_TYPES, isValidComponentType, validateComponentType, assertValidComponentType, parseComponentType, getComponentTypeOrDefault, suggestComponentType, getComponentTypesByCategory, getAllComponentCategories, VALID_DESIGN_SYSTEMS, isValidDesignSystem, assertValidDesignSystem, parseDesignSystem, getDesignSystemOrDefault, suggestDesignSystem, getDesignSystemDisplayName, getDesignSystemOrigin, getAllDesignSystems, validateSectionConfig, validateSectionFactors, createValidatedConfig, createValidatedFactors, isSectionCategory, isLayoutType, isSpacingLevel, isSectionDesignSystem, isSectionTier, validateSlotConfig, validateSlotConfigs, validateStoredComponent, validateComponentInSlot, validateComponentsInSlot, createValidatedSlotConfig, createValidatedStoredComponent, isSlotPosition, isComponentType, isValidSlotConfig, isValidStoredComponent, DEFAULT_HEADER_SLOT, DEFAULT_CONTENT_SLOT, DEFAULT_FOOTER_SLOT, DEFAULT_SIDEBAR_SLOT, DEFAULT_OVERLAY_SLOT, getDefaultSlotConfig, } from './validators';
+export type { FactorId, FactorGroup, FactorDefinition, FactorValue, TierCodeFeatures, LocRange, FactorRange, TierRegistryEntry, FactorApplicability, ComponentRegistryEntry, DesignSystemRegistryEntry, ValidatorFn, } from './types/algorithm-engine.types';
+export { main } from './cli/index';
+export { generateCommand, parseGenerateArgs } from './cli/generate-command';
+export type { GenerateCommandOptions, GenerateCommandResult } from './cli/generate-command';
+export { BatchCommand, createBatchCommand, executeBatch, getBatchEstimate, parseBatchArgs, } from './cli/batch-command';
+export type { BatchCommandOptions, BatchProgressCallback } from './cli/batch-command';
+export type { Factor24Config, ResolutionResult, SemanticIntent, SemanticMood, } from './resolution/types';
+export type { Tier, DesignSystem, ComponentType, ComponentGranularity, Framework, FactorConfig, GenerationConfig, ComponentRegistryDefinition, } from './types';
+export * from './types/Result';
+export * from './types/Option';
+export { CURRENT_COMPONENT_TYPES, ALL_COMPONENT_TYPES, COMPONENT_CATEGORIES, getComponentCategory, CURRENT_DESIGN_SYSTEMS, DESIGN_SYSTEM_INFO, TIERS, TIER_INFO, CURRENT_FRAMEWORKS, } from './constants';
+export * from './utils';
+export { MatrixResolver, ClassMapper, } from './ui-studio';
+export type { IMatrixResolver, IClassMapper, MatrixResolverInput, ResolvedComponentConfig, Matrix1Result, Matrix2Result, Matrix3Result, Matrix4Result, } from './ui-studio/matrix/types';
+export { TFCGAdapter, getTFCGAdapter, convertLegacyOptions, convertLegacyBatch, } from './adapters';
+export type { LegacyMatrixOptions } from './adapters';
+//# sourceMappingURL=index.d.ts.map