@nikkory/vibe-engine 4.0.0

package/dist/resolution/validators/factor24-validator.d.ts

@@ -0,0 +1,418 @@
+/**
+ * Factor24 Validator - Complete Validation Utility for 24-Factor System
+ *
+ * Provides comprehensive validation for all 24 factors with:
+ * - Type-safe validation functions
+ * - Detailed error messages with suggestions
+ * - Batch validation for complete configs
+ * - Partial config validation
+ *
+ * @packageDocumentation
+ * @module resolution/validators/factor24-validator
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { Factor24Config, FactorShape, FactorPosition, FactorIconPosition, FactorState, FactorAnimation, FactorElevation, FactorA11y, FactorAlignment, FactorOrientation, FactorDensity, FactorLoadingState, FactorTheme, FactorSpacing, FactorTypography, FactorBorder, FactorOpacity, FactorOverflow, FactorCursor, FactorZIndex, FactorTransition, ComponentSize, ColorScheme } from '../types';
+/**
+ * Valid values for Factor 1: Size
+ * @since 2.1.0
+ */
+export declare const VALID_SIZES: ReadonlyArray<ComponentSize>;
+/**
+ * Valid values for Factor 3: Color Scheme
+ * @since 2.1.0
+ */
+export declare const VALID_COLOR_SCHEMES: ReadonlyArray<ColorScheme>;
+/**
+ * Valid values for Factor 4: Shape
+ * @since 2.1.0
+ */
+export declare const VALID_SHAPES: ReadonlyArray<FactorShape>;
+/**
+ * Valid values for Factor 5: Position
+ * @since 2.1.0
+ */
+export declare const VALID_POSITIONS: ReadonlyArray<FactorPosition>;
+/**
+ * Valid values for Factor 6: Icon Position
+ * @since 2.1.0
+ */
+export declare const VALID_ICON_POSITIONS: ReadonlyArray<FactorIconPosition>;
+/**
+ * Valid values for Factor 7: State
+ * @since 2.1.0
+ */
+export declare const VALID_STATES: ReadonlyArray<FactorState>;
+/**
+ * Valid values for Factor 8: Animation
+ * @since 2.1.0
+ */
+export declare const VALID_ANIMATIONS: ReadonlyArray<FactorAnimation>;
+/**
+ * Valid values for Factor 9: Elevation
+ * @since 2.1.0
+ */
+export declare const VALID_ELEVATIONS: ReadonlyArray<FactorElevation>;
+/**
+ * Valid values for Factor 10: Accessibility
+ * @since 2.1.0
+ */
+export declare const VALID_A11Y_LEVELS: ReadonlyArray<FactorA11y>;
+/**
+ * Valid values for Factor 11: Alignment
+ * @since 2.1.0
+ */
+export declare const VALID_ALIGNMENTS: ReadonlyArray<FactorAlignment>;
+/**
+ * Valid values for Factor 12: Orientation
+ * @since 2.1.0
+ */
+export declare const VALID_ORIENTATIONS: ReadonlyArray<FactorOrientation>;
+/**
+ * Valid values for Factor 13: Density
+ * @since 2.1.0
+ */
+export declare const VALID_DENSITIES: ReadonlyArray<FactorDensity>;
+/**
+ * Valid values for Factor 14: Loading State
+ * @since 2.1.0
+ */
+export declare const VALID_LOADING_STATES: ReadonlyArray<FactorLoadingState>;
+/**
+ * Valid values for Factor 16: Theme
+ * @since 2.1.0
+ */
+export declare const VALID_THEMES: ReadonlyArray<FactorTheme>;
+/**
+ * Valid values for Factor 17: Spacing
+ * @since 2.1.0
+ */
+export declare const VALID_SPACINGS: ReadonlyArray<FactorSpacing>;
+/**
+ * Valid values for Factor 18: Typography
+ * @since 2.1.0
+ */
+export declare const VALID_TYPOGRAPHIES: ReadonlyArray<FactorTypography>;
+/**
+ * Valid values for Factor 19: Border
+ * @since 2.1.0
+ */
+export declare const VALID_BORDERS: ReadonlyArray<FactorBorder>;
+/**
+ * Valid values for Factor 20: Opacity
+ * @since 2.1.0
+ */
+export declare const VALID_OPACITIES: ReadonlyArray<FactorOpacity>;
+/**
+ * Valid values for Factor 21: Overflow
+ * @since 2.1.0
+ */
+export declare const VALID_OVERFLOWS: ReadonlyArray<FactorOverflow>;
+/**
+ * Valid values for Factor 22: Cursor
+ * @since 2.1.0
+ */
+export declare const VALID_CURSORS: ReadonlyArray<FactorCursor>;
+/**
+ * Valid values for Factor 23: Z-Index
+ * @since 2.1.0
+ */
+export declare const VALID_Z_INDICES: ReadonlyArray<FactorZIndex>;
+/**
+ * Valid values for Factor 24: Transition
+ * @since 2.1.0
+ */
+export declare const VALID_TRANSITIONS: ReadonlyArray<FactorTransition>;
+/**
+ * Check if value is a valid ComponentSize.
+ * @since 2.1.0
+ */
+export declare function isValidSize(value: unknown): value is ComponentSize;
+/**
+ * Check if value is a valid ColorScheme.
+ * @since 2.1.0
+ */
+export declare function isValidColorScheme(value: unknown): value is ColorScheme;
+/**
+ * Check if value is a valid FactorShape.
+ * @since 2.1.0
+ */
+export declare function isValidShape(value: unknown): value is FactorShape;
+/**
+ * Check if value is a valid FactorPosition.
+ * @since 2.1.0
+ */
+export declare function isValidPosition(value: unknown): value is FactorPosition;
+/**
+ * Check if value is a valid FactorIconPosition.
+ * @since 2.1.0
+ */
+export declare function isValidIconPosition(value: unknown): value is FactorIconPosition;
+/**
+ * Check if value is a valid FactorState.
+ * @since 2.1.0
+ */
+export declare function isValidState(value: unknown): value is FactorState;
+/**
+ * Check if value is a valid FactorAnimation.
+ * @since 2.1.0
+ */
+export declare function isValidAnimation(value: unknown): value is FactorAnimation;
+/**
+ * Check if value is a valid FactorElevation.
+ * @since 2.1.0
+ */
+export declare function isValidElevation(value: unknown): value is FactorElevation;
+/**
+ * Check if value is a valid FactorA11y.
+ * @since 2.1.0
+ */
+export declare function isValidA11y(value: unknown): value is FactorA11y;
+/**
+ * Check if value is a valid FactorAlignment.
+ * @since 2.1.0
+ */
+export declare function isValidAlignment(value: unknown): value is FactorAlignment;
+/**
+ * Check if value is a valid FactorOrientation.
+ * @since 2.1.0
+ */
+export declare function isValidOrientation(value: unknown): value is FactorOrientation;
+/**
+ * Check if value is a valid FactorDensity.
+ * @since 2.1.0
+ */
+export declare function isValidDensity(value: unknown): value is FactorDensity;
+/**
+ * Check if value is a valid FactorLoadingState.
+ * @since 2.1.0
+ */
+export declare function isValidLoadingState(value: unknown): value is FactorLoadingState;
+/**
+ * Check if value is a valid FactorTheme.
+ * @since 2.1.0
+ */
+export declare function isValidTheme(value: unknown): value is FactorTheme;
+/**
+ * Check if value is a valid FactorSpacing.
+ * @since 2.1.0
+ */
+export declare function isValidSpacing(value: unknown): value is FactorSpacing;
+/**
+ * Check if value is a valid FactorTypography.
+ * @since 2.1.0
+ */
+export declare function isValidTypography(value: unknown): value is FactorTypography;
+/**
+ * Check if value is a valid FactorBorder.
+ * @since 2.1.0
+ */
+export declare function isValidBorder(value: unknown): value is FactorBorder;
+/**
+ * Check if value is a valid FactorOpacity.
+ * @since 2.1.0
+ */
+export declare function isValidOpacity(value: unknown): value is FactorOpacity;
+/**
+ * Check if value is a valid FactorOverflow.
+ * @since 2.1.0
+ */
+export declare function isValidOverflow(value: unknown): value is FactorOverflow;
+/**
+ * Check if value is a valid FactorCursor.
+ * @since 2.1.0
+ */
+export declare function isValidCursor(value: unknown): value is FactorCursor;
+/**
+ * Check if value is a valid FactorZIndex.
+ * @since 2.1.0
+ */
+export declare function isValidZIndex(value: unknown): value is FactorZIndex;
+/**
+ * Check if value is a valid FactorTransition.
+ * @since 2.1.0
+ */
+export declare function isValidTransition(value: unknown): value is FactorTransition;
+/**
+ * Validation error with detailed information.
+ * @since 2.1.0
+ */
+export interface Factor24ValidationError {
+    /** The factor that failed validation */
+    factor: keyof Factor24Config;
+    /** The factor number (1-24) */
+    factorNumber: number;
+    /** The invalid value provided */
+    invalidValue: unknown;
+    /** Expected type or values */
+    expected: string;
+    /** Human-readable error message */
+    message: string;
+    /** Suggestion for valid values */
+    suggestion?: string;
+}
+/**
+ * Validation result for Factor24Config.
+ * @since 2.1.0
+ */
+export interface Factor24ValidationResult {
+    /** Whether the config is valid */
+    isValid: boolean;
+    /** List of validation errors (empty if valid) */
+    errors: Factor24ValidationError[];
+    /** Validated config (only set if valid) */
+    validatedConfig?: Partial<Factor24Config>;
+    /** Count of validated factors */
+    validatedCount: number;
+    /** Count of errors */
+    errorCount: number;
+}
+/**
+ * Factor metadata for validation and documentation.
+ * @since 2.1.0
+ */
+interface FactorMetadata {
+    factorNumber: number;
+    name: string;
+    validator: (value: unknown) => boolean;
+    validValues: readonly string[];
+}
+/**
+ * Factor24 Validator - Complete validation utility.
+ *
+ * @example
+ * ```typescript
+ * const validator = new Factor24Validator();
+ *
+ * // Validate partial config
+ * const result = validator.validate({
+ *   size: 'md',
+ *   spacing: 'lg',
+ *   cursor: 'pointer',
+ * });
+ *
+ * if (result.isValid) {
+ *   console.log('Config is valid!');
+ * } else {
+ *   console.log('Errors:', result.errors);
+ * }
+ * ```
+ *
+ * @since 2.1.0
+ */
+export declare class Factor24Validator {
+    /**
+     * Validate a partial Factor24Config.
+     *
+     * @param config - The partial config to validate
+     * @returns Validation result with errors if any
+     * @since 2.1.0
+     */
+    validate(config: Partial<Factor24Config>): Factor24ValidationResult;
+    /**
+     * Validate a single factor value.
+     *
+     * @param factor - The factor key to validate
+     * @param value - The value to validate
+     * @returns True if the value is valid for the factor
+     * @since 2.1.0
+     */
+    validateFactor(factor: keyof Factor24Config, value: unknown): boolean;
+    /**
+     * Get valid values for a factor.
+     *
+     * @param factor - The factor key
+     * @returns Array of valid values
+     * @since 2.1.0
+     */
+    getValidValues(factor: keyof Factor24Config): readonly string[];
+    /**
+     * Get factor number for a key.
+     *
+     * @param factor - The factor key
+     * @returns Factor number (1-24) or 0 if not found
+     * @since 2.1.0
+     */
+    getFactorNumber(factor: keyof Factor24Config): number;
+    /**
+     * Get factor name for a key.
+     *
+     * @param factor - The factor key
+     * @returns Human-readable factor name
+     * @since 2.1.0
+     */
+    getFactorName(factor: keyof Factor24Config): string;
+    /**
+     * Get all factors for a specific factor number.
+     *
+     * @param factorNumber - The factor number (1-24)
+     * @returns Array of factor keys for that number
+     * @since 2.1.0
+     */
+    getFactorsByNumber(factorNumber: number): Array<keyof Factor24Config>;
+    /**
+     * Get complete factor metadata.
+     *
+     * @param factor - The factor key
+     * @returns Factor metadata or undefined
+     * @since 2.1.0
+     */
+    getFactorMetadata(factor: keyof Factor24Config): FactorMetadata | undefined;
+    /**
+     * Get all factor keys.
+     *
+     * @returns Array of all factor keys
+     * @since 2.1.0
+     */
+    getAllFactorKeys(): Array<keyof Factor24Config>;
+    /**
+     * Format validation errors as human-readable string.
+     *
+     * @param result - Validation result
+     * @returns Formatted error string
+     * @since 2.1.0
+     */
+    formatErrors(result: Factor24ValidationResult): string;
+}
+/**
+ * Global Factor24Validator instance.
+ * @since 2.1.0
+ */
+export declare const factor24Validator: Factor24Validator;
+/**
+ * Validate a Factor24Config using the global validator.
+ *
+ * @param config - The config to validate
+ * @returns Validation result
+ * @since 2.1.0
+ */
+export declare function validateFactor24Config(config: Partial<Factor24Config>): Factor24ValidationResult;
+/**
+ * Validate a single factor using the global validator.
+ *
+ * @param factor - The factor key
+ * @param value - The value to validate
+ * @returns True if valid
+ * @since 2.1.0
+ */
+export declare function validateFactor(factor: keyof Factor24Config, value: unknown): boolean;
+/**
+ * Quick check if a config is valid.
+ *
+ * @param config - The config to check
+ * @returns True if the config is valid
+ * @since 2.1.0
+ */
+export declare function isValidFactor24Config(config: Partial<Factor24Config>): boolean;
+/**
+ * Validate and return config or throw error.
+ *
+ * @param config - The config to validate
+ * @returns The validated config
+ * @throws Error if validation fails
+ * @since 2.1.0
+ */
+export declare function assertValidFactor24Config(config: Partial<Factor24Config>): Partial<Factor24Config>;
+export {};
+//# sourceMappingURL=factor24-validator.d.ts.map

package/dist/resolution/validators/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Validators Module - Factor24 Validation Utilities
+ *
+ * Central export point for all validation functionality.
+ *
+ * @packageDocumentation
+ * @module resolution/validators
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+export { Factor24Validator, factor24Validator, validateFactor24Config, validateFactor, isValidFactor24Config, assertValidFactor24Config, VALID_SIZES, VALID_COLOR_SCHEMES, VALID_SHAPES, VALID_POSITIONS, VALID_ICON_POSITIONS, VALID_STATES, VALID_ANIMATIONS, VALID_ELEVATIONS, VALID_A11Y_LEVELS, VALID_ALIGNMENTS, VALID_ORIENTATIONS, VALID_DENSITIES, VALID_LOADING_STATES, VALID_THEMES, VALID_SPACINGS, VALID_TYPOGRAPHIES, VALID_BORDERS, VALID_OPACITIES, VALID_OVERFLOWS, VALID_CURSORS, VALID_Z_INDICES, VALID_TRANSITIONS, isValidSize, isValidColorScheme, isValidShape, isValidPosition, isValidIconPosition, isValidState, isValidAnimation, isValidElevation, isValidA11y, isValidAlignment, isValidOrientation, isValidDensity, isValidLoadingState, isValidTheme, isValidSpacing, isValidTypography, isValidBorder, isValidOpacity, isValidOverflow, isValidCursor, isValidZIndex, isValidTransition, } from './factor24-validator';
+export type { Factor24ValidationError, Factor24ValidationResult, } from './factor24-validator';
+//# sourceMappingURL=index.d.ts.map

package/dist/scripts/generate-react-library.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generate React Library - Auto-generation script for all registry components
+ * @packageDocumentation
+ * @module scripts/generate-react-library
+ * @since 4.0.0
+ *
+ * Usage:
+ *   pnpm tsx src/scripts/generate-react-library.ts
+ *   pnpm tsx src/scripts/generate-react-library.ts --tier enterprise
+ *   pnpm tsx src/scripts/generate-react-library.ts --design-system material-design
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=generate-react-library.d.ts.map

package/dist/scripts/write-react-library.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Write React Library - Production file generation script
+ * @packageDocumentation
+ * @module scripts/write-react-library
+ * @since 4.0.0
+ *
+ * This script WRITES actual files to packages/react/src/
+ * Unlike generate-react-library.ts (testing only), this creates production files.
+ *
+ * Usage:
+ *   pnpm tsx src/scripts/write-react-library.ts
+ *   pnpm tsx src/scripts/write-react-library.ts --tier enterprise
+ *   pnpm tsx src/scripts/write-react-library.ts --design-system material-design
+ *
+ * Powered by Nikkory
+ */
+export {};
+//# sourceMappingURL=write-react-library.d.ts.map

package/dist/storage/cloud-sync.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Cloud Sync Module
+ * Cloud synchronization for team and public templates
+ *
+ * @packageDocumentation
+ * @module storage/cloud-sync
+ * @since 4.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { SectionTemplate, SectionTemplateWithFactors, TemplateVisibility } from '../types/section-template.types';
+/**
+ * Cloud sync operation result
+ */
+export interface SyncResult<T> {
+    /** Whether sync succeeded */
+    readonly success: boolean;
+    /** Result data if successful */
+    readonly data?: T;
+    /** Error message if failed */
+    readonly error?: string;
+    /** Sync timestamp */
+    readonly syncedAt?: Date;
+}
+/**
+ * Sync status for a template
+ */
+export interface SyncStatus {
+    /** Template identifier */
+    readonly templateId: string;
+    /** Whether template is synced */
+    readonly isSynced: boolean;
+    /** Last sync timestamp */
+    readonly lastSyncedAt?: Date;
+    /** Whether local has pending changes */
+    readonly hasPendingChanges: boolean;
+    /** Remote version if available */
+    readonly remoteVersion?: string;
+    /** Local version */
+    readonly localVersion: string;
+}
+/**
+ * Sync conflict information
+ */
+export interface SyncConflict {
+    /** Template identifier */
+    readonly templateId: string;
+    /** Local template version */
+    readonly localVersion: string;
+    /** Remote template version */
+    readonly remoteVersion: string;
+    /** Local modified timestamp */
+    readonly localModifiedAt: Date;
+    /** Remote modified timestamp */
+    readonly remoteModifiedAt: Date;
+    /** Conflict resolution options */
+    readonly resolution: 'keep-local' | 'keep-remote' | 'merge' | 'pending';
+}
+/**
+ * Batch sync result
+ */
+export interface BatchSyncResult {
+    /** Templates successfully synced */
+    readonly synced: readonly string[];
+    /** Templates that failed to sync */
+    readonly failed: readonly {
+        templateId: string;
+        error: string;
+    }[];
+    /** Templates with conflicts */
+    readonly conflicts: readonly SyncConflict[];
+    /** Total sync duration in ms */
+    readonly durationMs: number;
+}
+/**
+ * Visibility rules for cloud sync
+ *
+ * @remarks
+ * - private: Local storage only, no cloud sync
+ * - team: Syncs to team workspace in cloud
+ * - public: Syncs to cloud + listed in marketplace
+ */
+export declare const VISIBILITY_SYNC_RULES: Record<TemplateVisibility, {
+    readonly syncEnabled: boolean;
+    readonly marketplaceListing: boolean;
+    readonly requiresAuth: boolean;
+}>;
+/**
+ * Check if visibility allows cloud sync
+ *
+ * @param visibility - Template visibility
+ * @returns Whether sync is enabled for this visibility
+ */
+export declare function isSyncEnabled(visibility: TemplateVisibility): boolean;
+/**
+ * Check if visibility allows marketplace listing
+ *
+ * @param visibility - Template visibility
+ * @returns Whether marketplace listing is enabled
+ */
+export declare function isMarketplaceEnabled(visibility: TemplateVisibility): boolean;
+/**
+ * Sync template to cloud
+ *
+ * @param template - Template to sync
+ * @param options - Sync options
+ * @returns Sync result
+ *
+ * @remarks
+ * Only syncs if visibility is 'team' or 'public'.
+ * Private templates are stored locally only.
+ *
+ * @example
+ * ```typescript
+ * const result = await syncToCloud(myTemplate);
+ * if (result.success) {
+ *   console.log('Synced at:', result.syncedAt);
+ * }
+ * ```
+ */
+export declare function syncToCloud(template: SectionTemplate | SectionTemplateWithFactors, options?: SyncOptions): Promise<SyncResult<string>>;
+/**
+ * Sync options for cloud operations
+ */
+export interface SyncOptions {
+    /** Force overwrite remote version */
+    readonly forceOverwrite?: boolean;
+    /** Skip conflict check */
+    readonly skipConflictCheck?: boolean;
+    /** Custom API endpoint */
+    readonly apiEndpoint?: string;
+    /** Auth token for API */
+    readonly authToken?: string;
+}
+/**
+ * Fetch template from cloud
+ *
+ * @param templateId - Template identifier
+ * @param options - Sync options
+ * @returns Sync result with template data
+ */
+export declare function fetchFromCloud(templateId: string, options?: SyncOptions): Promise<SyncResult<SectionTemplate | SectionTemplateWithFactors>>;
+/**
+ * Check sync status for a template
+ *
+ * @param templateId - Template identifier
+ * @param localVersion - Local template version
+ * @param options - Sync options
+ * @returns Sync status
+ */
+export declare function checkSyncStatus(templateId: string, localVersion: string, _options?: SyncOptions): Promise<SyncResult<SyncStatus>>;
+/**
+ * Sync multiple templates to cloud
+ *
+ * @param templates - Templates to sync
+ * @param options - Sync options
+ * @returns Batch sync result
+ *
+ * @example
+ * ```typescript
+ * const result = await batchSyncToCloud([template1, template2]);
+ * console.log(`Synced: ${result.synced.length}, Failed: ${result.failed.length}`);
+ * ```
+ */
+export declare function batchSyncToCloud(templates: readonly (SectionTemplate | SectionTemplateWithFactors)[], options?: SyncOptions): Promise<BatchSyncResult>;
+/**
+ * Delete template from cloud
+ *
+ * @param templateId - Template identifier
+ * @param options - Sync options
+ * @returns Sync result
+ */
+export declare function deleteFromCloud(templateId: string, options?: SyncOptions): Promise<SyncResult<boolean>>;
+/**
+ * Resolve sync conflict
+ *
+ * @param conflict - Conflict to resolve
+ * @param resolution - Resolution strategy
+ * @returns Resolution result
+ */
+export declare function resolveConflict(conflict: SyncConflict, resolution: 'keep-local' | 'keep-remote' | 'merge'): Promise<SyncResult<SectionTemplate | SectionTemplateWithFactors>>;
+//# sourceMappingURL=cloud-sync.d.ts.map