@nikkory/vibe-engine 4.0.0

package/dist/resolution/demo.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Resolution Visual Demo - Interactive Demo of 5-Level Resolution
+ *
+ * This file provides an interactive demonstration of how the resolution
+ * engine converts props from any level to complete Factor24Config.
+ *
+ * Run with: npx ts-node src/resolution/demo.ts
+ *
+ * @packageDocumentation
+ * @module resolution/demo
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { MultiLevelProps } from './types';
+/**
+ * Demo Level 5: Intent + Mood
+ */
+declare function demoLevel5(): void;
+/**
+ * Demo Level 3: Shorthands
+ */
+declare function demoLevel3(): void;
+/**
+ * Demo Level 2: Factor Groups
+ */
+declare function demoLevel2(): void;
+/**
+ * Demo Level 1: Raw Factors
+ */
+declare function demoLevel1(): void;
+/**
+ * Demo Mixed Levels
+ */
+declare function demoMixedLevels(): void;
+/**
+ * Demo Priority Resolution
+ */
+declare function demoPriority(): void;
+/**
+ * Demo Debug Mode
+ */
+declare function demoDebugMode(): void;
+/**
+ * Run all demos
+ */
+export declare function runAllDemos(): void;
+/**
+ * Run specific demo by name
+ */
+export declare function runDemo$(demoName: string): void;
+/**
+ * Interactive demo - resolve custom props
+ */
+export declare function interactiveResolve(props: MultiLevelProps): void;
+export { demoLevel5, demoLevel3, demoLevel2, demoLevel1, demoMixedLevels, demoPriority, demoDebugMode, };
+//# sourceMappingURL=demo.d.ts.map

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

@@ -0,0 +1,22 @@
+/**
+ * Resolution Enterprise Tier - Barrel Export
+ *
+ * Central export point for enterprise tier resolution modules.
+ * Core logic + validation + metrics/debugging (A+a+b pattern).
+ *
+ * @composition Enterprise = A + a + b (core + validation + metrics)
+ *
+ * @packageDocumentation
+ * @module resolution/enterprise
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+export type { Factor24Config, MultiLevelProps, SemanticIntent, SemanticMood, IntentDefinition, MoodModifierDefinition, PresetDefinition, LookShorthand, FeelShorthand, SurfaceShorthand, SpacingShorthand, VisualGroup, MotionGroup, LayoutGroup, ExperienceGroup, FactorGroups, ResolutionEnterpriseResult, ResolutionMetrics, DebugTrace, DebugStep, } from '../core/types-core';
+export type { ValidationResult } from '../standard/validators';
+export type { StandardResolutionResult, StandardGroupResult, StandardShorthandResult, PresetRegistrationResult, PresetResolutionResult, IntentRegistrationResult, IntentResolutionResult, } from '../standard/index';
+export { PerformanceTracker, DebugTraceBuilder, ResolutionCache, AnalyticsTracker, type AnalyticsEvent, } from './metrics';
+export type { EnterpriseResolutionOptions } from './resolver-enterprise';
+export { resolveProps, clearCache, getCacheSize, hasCacheKey, getAnalyticsEvents, clearAnalytics, trackEvent, } from './resolver-enterprise';
+export { validationSuccess, validationFailure, validateFactor24Config, validateVisualGroup, validateMotionGroup, validateLayoutGroup, validateExperienceGroup, validateFactorGroups, validateShorthands, validatePresetDefinition, validatePresetId, validateIntentDefinition, validateMoodDefinition, validateIntentId, validateMoodId, expandVisualGroup, expandMotionGroup, expandLayoutGroup, expandExperienceGroup, expandGroups, mergeFactorGroups, extractAllGroups, LOOK_MAPPINGS, FEEL_MAPPINGS, SURFACE_MAPPINGS, SPACING_MAPPINGS, expandLook, expandFeel, expandSurface, expandSpacingShorthand, expandShorthands, PRESET_STORAGE, registerPreset, registerPresets, resolvePreset, hasPreset, unregisterPreset, clearPresets, getAllPresetIds, getPresetCount, getAllPresetConfigs, INTENT_STORAGE, MOOD_STORAGE, registerIntent, registerIntents, registerMood, registerMoods, resolveIntent, resolveMood, hasIntent, hasMood, applyMood, resolveIntentWithMood, unregisterIntent, unregisterMood, clearIntents, clearMoods, getAllIntentIds, getAllMoodIds, getIntentCount, getMoodCount, getAllIntentConfigs, getAllMoodAdjustments, extractLevel1Factors, extractLevel2Groups, extractLevel3Shorthands, extractLevel4Preset, extractLevel5Intent, mergeConfigs, detectLevels, } from '../standard/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/resolution/enterprise/metrics.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Performance Metrics - Enterprise Tier (Pattern A+a+b)
+ *
+ * Performance tracking and debugging utilities.
+ * Used by enterprise tier components for profiling and optimization.
+ *
+ * @composition Enterprise = A + a + b (core + validation + metrics)
+ *
+ * @packageDocumentation
+ * @module resolution/enterprise/metrics
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { ResolutionMetrics, DebugTrace } from '../core/types-core';
+/**
+ * Performance tracker for enterprise tier.
+ * @since 3.0.0
+ */
+export declare class PerformanceTracker {
+    private startTime;
+    private endTime;
+    private levelsResolved;
+    private factorOverwrites;
+    constructor();
+    /**
+     * Start tracking performance.
+     * @since 3.0.0
+     */
+    start(): void;
+    /**
+     * Stop tracking performance.
+     * @since 3.0.0
+     */
+    stop(): void;
+    /**
+     * Record that a level was resolved.
+     * @since 3.0.0
+     */
+    recordLevel(level: number): void;
+    /**
+     * Record a factor overwrite.
+     * @since 3.0.0
+     */
+    recordOverwrite(): void;
+    /**
+     * Get metrics result.
+     * @since 3.0.0
+     */
+    getMetrics(cacheSize?: number): ResolutionMetrics;
+}
+/**
+ * Debug trace builder for enterprise tier.
+ * @since 3.0.0
+ */
+export declare class DebugTraceBuilder {
+    private steps;
+    private levelConfigs;
+    constructor();
+    /**
+     * Add a debug step.
+     * @since 3.0.0
+     */
+    addStep(level: number, action: string, input: unknown, output: unknown, description?: string): void;
+    /**
+     * Record config at a specific level.
+     * @since 3.0.0
+     */
+    recordLevelConfig(level: number, config: unknown): void;
+    /**
+     * Build final debug trace.
+     * @since 3.0.0
+     */
+    build(finalConfig: unknown): DebugTrace;
+    /**
+     * Clear all trace data.
+     * @since 3.0.0
+     */
+    clear(): void;
+}
+/**
+ * Simple LRU cache for enterprise tier.
+ * @since 3.0.0
+ */
+export declare class ResolutionCache<K, V> {
+    private cache;
+    private maxSize;
+    constructor(maxSize?: number);
+    /**
+     * Get value from cache.
+     * @since 3.0.0
+     */
+    get(key: K): V | undefined;
+    /**
+     * Set value in cache.
+     * @since 3.0.0
+     */
+    set(key: K, value: V): void;
+    /**
+     * Check if key exists.
+     * @since 3.0.0
+     */
+    has(key: K): boolean;
+    /**
+     * Clear cache.
+     * @since 3.0.0
+     */
+    clear(): void;
+    /**
+     * Get cache size.
+     * @since 3.0.0
+     */
+    size(): number;
+    /**
+     * Convert key to string for storage.
+     * @since 3.0.0
+     */
+    private keyToString;
+}
+/**
+ * Analytics event for enterprise tier.
+ * @since 3.0.0
+ */
+export interface AnalyticsEvent {
+    readonly event: string;
+    readonly timestamp: number;
+    readonly data?: Record<string, unknown>;
+}
+/**
+ * Analytics tracker for enterprise tier.
+ * @since 3.0.0
+ */
+export declare class AnalyticsTracker {
+    private events;
+    constructor();
+    /**
+     * Track an analytics event.
+     * @since 3.0.0
+     */
+    track(event: string, data?: Record<string, unknown>): void;
+    /**
+     * Get all tracked events.
+     * @since 3.0.0
+     */
+    getEvents(): ReadonlyArray<AnalyticsEvent>;
+    /**
+     * Clear all events.
+     * @since 3.0.0
+     */
+    clear(): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/resolution/enterprise/resolver-enterprise.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Resolution Orchestrator - Enterprise Tier (Pattern A+a+b)
+ *
+ * Adds performance metrics and debugging on top of standard resolution.
+ * Used by enterprise tier components for production optimization.
+ *
+ * @composition Enterprise = A + a + b (core + validation + metrics)
+ *
+ * @packageDocumentation
+ * @module resolution/enterprise/resolver-enterprise
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { MultiLevelProps, ResolutionEnterpriseResult } from '../core/types-core';
+/**
+ * Enterprise resolution options.
+ * @since 3.0.0
+ */
+export interface EnterpriseResolutionOptions {
+    /** Enable debug mode (detailed trace) */
+    debug?: boolean;
+    /** Enable performance profiling */
+    profile?: boolean;
+    /** Analytics event name (for tracking) */
+    analyticsEvent?: string;
+    /** Enable caching */
+    cache?: boolean;
+    /** Custom cache key */
+    cacheKey?: string;
+}
+/**
+ * Resolve MultiLevelProps to Factor24Config (enterprise tier).
+ * Adds performance tracking and debugging on top of standard resolution.
+ *
+ * Priority: Level 1 > Level 2 > Level 3 > Level 4 > Level 5
+ *
+ * @param props - MultiLevelProps to resolve
+ * @param options - Enterprise resolution options
+ * @returns Resolved config with validation, metrics, and optional debug trace
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with profiling
+ * const result = resolveProps(
+ *   { intent: 'cta', mood: 'professional' },
+ *   { profile: true }
+ * );
+ * console.log(`Resolution took ${result.metrics.durationMs}ms`);
+ *
+ * // With debug trace
+ * const debugResult = resolveProps(
+ *   { look: 'bold', size: 'lg' },
+ *   { debug: true, profile: true }
+ * );
+ * console.log(debugResult.debug?.steps);
+ *
+ * // With caching
+ * const cachedResult = resolveProps(
+ *   { preset: 'button-cta' },
+ *   { cache: true, cacheKey: 'button-cta' }
+ * );
+ * console.log(`Cache hit: ${cachedResult.cacheHit}`);
+ *
+ * // With analytics
+ * const analyticsResult = resolveProps(
+ *   { intent: 'primary' },
+ *   { analyticsEvent: 'component_resolve', profile: true }
+ * );
+ * ```
+ */
+export declare function resolveProps(props: MultiLevelProps, options?: EnterpriseResolutionOptions): ResolutionEnterpriseResult;
+/**
+ * Clear the global resolution cache.
+ * @since 3.0.0
+ */
+export declare function clearCache(): void;
+/**
+ * Get cache size.
+ * @since 3.0.0
+ */
+export declare function getCacheSize(): number;
+/**
+ * Check if a cache key exists.
+ * @since 3.0.0
+ */
+export declare function hasCacheKey(key: string): boolean;
+/**
+ * Get all tracked analytics events.
+ * @since 3.0.0
+ */
+export declare function getAnalyticsEvents(): ReadonlyArray<{
+    event: string;
+    timestamp: number;
+    data?: Record<string, unknown>;
+}>;
+/**
+ * Clear analytics events.
+ * @since 3.0.0
+ */
+export declare function clearAnalytics(): void;
+/**
+ * Manually track an analytics event.
+ * @since 3.0.0
+ */
+export declare function trackEvent(event: string, data?: Record<string, unknown>): void;
+//# sourceMappingURL=resolver-enterprise.d.ts.map