@nikkory/vibe-engine 4.0.0

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

@@ -0,0 +1,112 @@
+/**
+ * Section Registry Helpers
+ * Factory functions for creating section definitions
+ *
+ * @packageDocumentation
+ * @module presets/section-registry-helpers
+ * @since 4.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { RegistrySectionDefinition } from './registry.types';
+import type { BaseSectionDefinition } from './section-registry.types';
+/**
+ * Factory function to extend base section with auto-generated fields
+ *
+ * @remarks
+ * Reduces 700+ duplicate lines to ~50 lines per category by:
+ * 1. Taking minimal required fields (BaseSectionDefinition)
+ * 2. Auto-generating remaining fields from category defaults
+ * 3. Maintaining backward compatibility with legacy field names
+ *
+ * Field Mapping:
+ * - sectionId → id (backward compat) + sectionId (unified)
+ * - sectionType → category (backward compat) + sectionType (unified)
+ * - layout → sectionLayout (backward compat) + layout (unified)
+ *
+ * @param base - Base section definition with minimal required fields
+ * @returns Full registry section definition with all fields populated
+ *
+ * @example
+ * ```typescript
+ * // Input: Minimal definition
+ * const base: BaseSectionDefinition = {
+ *   sectionId: 'hero-centered',
+ *   name: 'Hero - Centered',
+ *   sectionType: 'hero',
+ *   status: 'stable',
+ *   description: 'Centered hero section',
+ *   keywords: ['hero', 'landing', 'cta'],
+ *   layout: 'centered',
+ *   columns: 1,
+ *   spacing: 'lg',
+ * };
+ *
+ * // Output: Full definition with 25+ fields
+ * const full = withSectionDefaults(base);
+ * console.log(full.icon); // 'Rocket' (auto-generated)
+ * console.log(full.emoji); // '🚀' (auto-generated)
+ * console.log(full.showCta); // true (from category default)
+ * ```
+ */
+export declare function withSectionDefaults(base: BaseSectionDefinition): RegistrySectionDefinition;
+/**
+ * Process array of base definitions through the factory
+ *
+ * @remarks
+ * Convenience function to apply `withSectionDefaults()` to an array of
+ * base definitions. Useful when defining multiple sections at once.
+ *
+ * @param sections - Array of base section definitions
+ * @returns Array of full registry section definitions
+ *
+ * @example
+ * ```typescript
+ * const HERO_SECTIONS_BASE: BaseSectionDefinition[] = [
+ *   { sectionId: 'hero-centered', ... },
+ *   { sectionId: 'hero-split', ... },
+ *   { sectionId: 'hero-video', ... },
+ * ];
+ *
+ * const HERO_SECTIONS = withSectionDefaultsArray(HERO_SECTIONS_BASE);
+ * // All 3 sections now have full definitions with 25+ fields each
+ * ```
+ */
+export declare function withSectionDefaultsArray(sections: readonly BaseSectionDefinition[]): readonly RegistrySectionDefinition[];
+/**
+ * Validate a base section definition
+ *
+ * @param section - Section to validate
+ * @returns Validation result with errors if any
+ *
+ * @example
+ * ```typescript
+ * const result = validateBaseSectionDefinition(section);
+ * if (!result.valid) {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+export declare function validateBaseSectionDefinition(section: BaseSectionDefinition): {
+    valid: boolean;
+    errors: readonly string[];
+};
+/**
+ * Validate an array of base section definitions
+ *
+ * @param sections - Sections to validate
+ * @returns Validation results for all sections
+ */
+export declare function validateBaseSectionDefinitions(sections: readonly BaseSectionDefinition[]): {
+    valid: boolean;
+    sectionErrors: Record<string, readonly string[]>;
+};
+/**
+ * Check if an object is a valid BaseSectionDefinition
+ */
+export declare function isBaseSectionDefinition(obj: unknown): obj is BaseSectionDefinition;
+/**
+ * Check if an object is a valid RegistrySectionDefinition
+ */
+export declare function isRegistrySectionDefinition(obj: unknown): obj is RegistrySectionDefinition;
+//# sourceMappingURL=section-registry.helpers.d.ts.map

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

@@ -0,0 +1,181 @@
+/**
+ * Section Registry Types
+ * Type definitions for factory pattern infrastructure
+ *
+ * @packageDocumentation
+ * @module presets/section-registry-types
+ * @since 4.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { DesignSystem, Tier, SectionCategory, LayoutType, SpacingLevel, SlotConfig, StyleOverrides } from '../types';
+/**
+ * Base section definition - MINIMAL fields only
+ * Factory function will auto-generate remaining fields
+ *
+ * @remarks
+ * This interface defines the minimal set of fields required to define a section.
+ * The factory function `withSectionDefaults()` will expand this into a full
+ * `RegistrySectionDefinition` by applying category-specific defaults.
+ *
+ * @example
+ * ```typescript
+ * const heroSection: BaseSectionDefinition = {
+ *   sectionId: 'hero-centered',
+ *   name: 'Hero - Centered',
+ *   sectionType: 'hero',
+ *   status: 'stable',
+ *   description: 'Centered hero section with headline, subheadline, and CTA',
+ *   keywords: ['hero', 'landing', 'cta', 'centered'],
+ *   layout: 'centered',
+ *   columns: 1,
+ *   spacing: 'lg',
+ *   showCta: true,
+ *   showMedia: false,
+ * };
+ *
+ * // Expand to full definition using factory
+ * const fullDefinition = withSectionDefaults(heroSection);
+ * ```
+ */
+export interface BaseSectionDefinition {
+    /**
+     * Unique section identifier (kebab-case)
+     * @example 'hero-centered', 'pricing-three-tier', 'testimonials-carousel'
+     */
+    readonly sectionId: string;
+    /**
+     * Section name (human-readable)
+     * @example 'Hero - Centered', 'Pricing - Three Tier'
+     */
+    readonly name: string;
+    /**
+     * Section type/category (10 categories)
+     */
+    readonly sectionType: SectionCategory;
+    /**
+     * Description for documentation and search
+     */
+    readonly description: string;
+    /**
+     * Search keywords for filtering
+     * @example ['hero', 'landing', 'cta', 'centered']
+     */
+    readonly keywords: readonly string[];
+    /**
+     * Status of the section
+     */
+    readonly status: 'stable' | 'beta' | 'planned';
+    /**
+     * Layout type for the section
+     */
+    readonly layout: LayoutType;
+    /**
+     * Number of columns (for grid layouts)
+     */
+    readonly columns: 1 | 2 | 3 | 4 | 6;
+    /**
+     * Spacing between elements
+     */
+    readonly spacing: SpacingLevel;
+    /**
+     * Override default design system for this section
+     * @remarks If not provided, uses category default
+     */
+    readonly defaultDesignSystem?: DesignSystem;
+    /**
+     * Override default tier for this section
+     * @remarks If not provided, uses category default
+     */
+    readonly defaultTier?: Tier;
+    /**
+     * Slot configurations for component placement
+     */
+    readonly slots?: readonly SlotConfig[];
+    /**
+     * Number of items to generate (for list-based sections)
+     * @example 3 for testimonials, 3-5 for pricing tiers
+     */
+    readonly itemCount?: number;
+    /**
+     * Override showCta default
+     */
+    readonly showCta?: boolean;
+    /**
+     * Override showMedia default
+     */
+    readonly showMedia?: boolean;
+    /**
+     * Custom styling overrides
+     */
+    readonly styleOverrides?: StyleOverrides;
+}
+/**
+ * Category defaults - auto-applied by factory
+ *
+ * @remarks
+ * Each of the 10 section categories has its own set of default values.
+ * These are applied automatically by `withSectionDefaults()` when creating
+ * full section definitions.
+ *
+ * @example
+ * ```typescript
+ * const heroDefaults: SectionCategoryDefaults = {
+ *   defaultDesignSystem: 'material-design',
+ *   defaultTier: 'standard',
+ *   icon: 'Rocket',
+ *   emoji: '🚀',
+ *   height: 'fullscreen',
+ *   alignment: 'center',
+ *   showCta: true,
+ *   showMedia: false,
+ *   designSystems: ['material-design', 'ios-hig', ...],
+ *   tiers: ['basic', 'standard', 'enterprise'],
+ * };
+ * ```
+ */
+export interface SectionCategoryDefaults {
+    /**
+     * Default design system for this category
+     */
+    readonly defaultDesignSystem: DesignSystem;
+    /**
+     * Default tier for this category
+     */
+    readonly defaultTier: Tier;
+    /**
+     * Lucide icon name for this category
+     * @example 'Rocket', 'Sparkles', 'Quote'
+     */
+    readonly icon: string;
+    /**
+     * Emoji for this category
+     * @example '🚀', '✨', '💬'
+     */
+    readonly emoji: string;
+    /**
+     * Default section height
+     */
+    readonly height: 'compact' | 'standard' | 'tall' | 'fullscreen';
+    /**
+     * Default content alignment
+     */
+    readonly alignment: 'left' | 'center' | 'right';
+    /**
+     * Whether to show CTA by default
+     */
+    readonly showCta: boolean;
+    /**
+     * Whether to show media by default
+     */
+    readonly showMedia: boolean;
+    /**
+     * Supported design systems for this category
+     */
+    readonly designSystems: readonly DesignSystem[];
+    /**
+     * Supported tiers for this category
+     */
+    readonly tiers: readonly Tier[];
+}
+//# sourceMappingURL=section-registry.types.d.ts.map

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

@@ -0,0 +1,23 @@
+/**
+ * Template Registry - 20 Template Definitions
+ * @packageDocumentation
+ * @module presets/template-registry
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { RegistryTemplateDefinition } from './registry.types';
+/**
+ * All template definitions (20 total)
+ *
+ * Categories:
+ * - SaaS (5): B2B SaaS applications
+ * - E-commerce (4): Online stores
+ * - Portfolio (3): Creative portfolios
+ * - Blog (3): Content sites
+ * - Startup (3): Startup landing sites
+ * - Agency (2): Agency websites
+ */
+export declare const ALL_TEMPLATES: readonly RegistryTemplateDefinition[];
+export type { RegistryTemplateDefinition };
+//# sourceMappingURL=template-registry.d.ts.map