@nikkory/vibe-engine 4.0.0

package/dist/resolution/basic/groups-basic.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Groups Resolution - Basic Tier (Pattern A Wrapper)
+ *
+ * Simple wrapper around core group expansion.
+ * No validation - delegates directly to core.
+ * Used by basic tier components.
+ *
+ * @composition Basic = A wrapper (no validation)
+ *
+ * @packageDocumentation
+ * @module resolution/basic/groups-basic
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Factor24Config, VisualGroup, MotionGroup, LayoutGroup, ExperienceGroup, FactorGroups } from '../core/types-core';
+/**
+ * Expand Visual Group to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param visual - The visual group configuration
+ * @returns Partial Factor24Config with visual-related factors
+ * @since 3.0.0
+ */
+export declare function expandVisualGroup(visual: VisualGroup): Partial<Factor24Config>;
+/**
+ * Expand Motion Group to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param motion - The motion group configuration
+ * @returns Partial Factor24Config with motion-related factors
+ * @since 3.0.0
+ */
+export declare function expandMotionGroup(motion: MotionGroup): Partial<Factor24Config>;
+/**
+ * Expand Layout Group to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param layout - The layout group configuration
+ * @returns Partial Factor24Config with layout-related factors
+ * @since 3.0.0
+ */
+export declare function expandLayoutGroup(layout: LayoutGroup): Partial<Factor24Config>;
+/**
+ * Expand Experience Group to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param experience - The experience group configuration
+ * @returns Partial Factor24Config with experience-related factors
+ * @since 3.0.0
+ */
+export declare function expandExperienceGroup(experience: ExperienceGroup): Partial<Factor24Config>;
+/**
+ * Expand all factor groups to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param groups - The factor groups to expand
+ * @returns Partial Factor24Config with all group factors
+ * @since 3.0.0
+ */
+export declare function expandGroups(groups: FactorGroups): Partial<Factor24Config>;
+/**
+ * Merge multiple FactorGroups configurations (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param groupsList - Factor groups to merge
+ * @returns Merged factor groups
+ * @since 3.0.0
+ */
+export declare function mergeFactorGroups(...groupsList: FactorGroups[]): FactorGroups;
+/**
+ * Extract all factor groups from a Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param config - The full Factor24Config
+ * @returns Extracted factor groups
+ * @since 3.0.0
+ */
+export declare function extractAllGroups(config: Partial<Factor24Config>): FactorGroups;
+//# sourceMappingURL=groups-basic.d.ts.map

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

@@ -0,0 +1,21 @@
+/**
+ * Resolution Basic Tier - Barrel Export
+ *
+ * Central export point for basic tier resolution modules.
+ * Simple wrappers around Pattern A (core logic).
+ *
+ * @composition Basic = A wrapper (no validation)
+ *
+ * @packageDocumentation
+ * @module resolution/basic
+ * @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, } from '../core/types-core';
+export { expandVisualGroup, expandMotionGroup, expandLayoutGroup, expandExperienceGroup, expandGroups, mergeFactorGroups, extractAllGroups, } from './groups-basic';
+export { LOOK_MAPPINGS, FEEL_MAPPINGS, SURFACE_MAPPINGS, SPACING_MAPPINGS, expandLook, expandFeel, expandSurface, expandSpacingShorthand, expandShorthands, type ShorthandProps, } from './shorthands-basic';
+export { PRESET_STORAGE, registerPreset, registerPresets, resolvePreset, hasPreset, unregisterPreset, clearPresets, getAllPresetIds, getPresetCount, getAllPresetConfigs, } from './presets-basic';
+export { INTENT_STORAGE, MOOD_STORAGE, registerIntent, registerIntents, registerMood, registerMoods, resolveIntent, resolveMood, hasIntent, hasMood, applyMood, resolveIntentWithMood, unregisterIntent, unregisterMood, clearIntents, clearMoods, getAllIntentIds, getAllMoodIds, getIntentCount, getMoodCount, getAllIntentConfigs, getAllMoodAdjustments, } from './intents-basic';
+export { extractLevel1Factors, extractLevel2Groups, extractLevel3Shorthands, extractLevel4Preset, extractLevel5Intent, mergeConfigs, resolveProps, detectLevels, } from './resolver-basic';
+//# sourceMappingURL=index.d.ts.map

package/dist/resolution/basic/intents-basic.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Intents Resolution - Basic Tier (Pattern A Wrapper)
+ *
+ * Simple wrapper around core intent resolution.
+ * No validation - delegates directly to core.
+ * Used by basic tier components.
+ *
+ * @composition Basic = A wrapper (no validation)
+ *
+ * @packageDocumentation
+ * @module resolution/basic/intents-basic
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Factor24Config, IntentDefinition, MoodModifierDefinition, SemanticIntent, SemanticMood } from '../core/types-core';
+/**
+ * Intent storage (basic tier).
+ * @since 3.0.0
+ */
+export declare const INTENT_STORAGE: Map<SemanticIntent, Partial<Factor24Config>>;
+/**
+ * Mood storage (basic tier).
+ * @since 3.0.0
+ */
+export declare const MOOD_STORAGE: Map<SemanticMood, Partial<Factor24Config>>;
+/**
+ * Register an intent (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param intent - The intent definition to register
+ * @since 3.0.0
+ */
+export declare function registerIntent(intent: IntentDefinition): void;
+/**
+ * Register multiple intents (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param intents - Array of intent definitions to register
+ * @since 3.0.0
+ */
+export declare function registerIntents(intents: ReadonlyArray<IntentDefinition>): void;
+/**
+ * Register a mood modifier (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param mood - The mood definition to register
+ * @since 3.0.0
+ */
+export declare function registerMood(mood: MoodModifierDefinition): void;
+/**
+ * Register multiple moods (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param moods - Array of mood definitions to register
+ * @since 3.0.0
+ */
+export declare function registerMoods(moods: ReadonlyArray<MoodModifierDefinition>): void;
+/**
+ * Resolve an intent ID to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param intentId - The intent ID to resolve
+ * @returns The intent's base config or undefined
+ * @since 3.0.0
+ */
+export declare function resolveIntent(intentId: SemanticIntent): Partial<Factor24Config> | undefined;
+/**
+ * Resolve a mood ID to its adjustments (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param moodId - The mood ID to resolve
+ * @returns The mood's adjustments or undefined
+ * @since 3.0.0
+ */
+export declare function resolveMood(moodId: SemanticMood): Partial<Factor24Config> | undefined;
+/**
+ * Check if an intent exists (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param intentId - The intent ID to check
+ * @returns True if intent exists
+ * @since 3.0.0
+ */
+export declare function hasIntent(intentId: SemanticIntent): boolean;
+/**
+ * Check if a mood exists (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param moodId - The mood ID to check
+ * @returns True if mood exists
+ * @since 3.0.0
+ */
+export declare function hasMood(moodId: SemanticMood): boolean;
+/**
+ * Apply mood adjustments to a base config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param baseConfig - The base configuration
+ * @param moodAdjustments - The mood adjustments to apply
+ * @returns Merged configuration
+ * @since 3.0.0
+ */
+export declare function applyMood(baseConfig: Partial<Factor24Config>, moodAdjustments: Partial<Factor24Config>): Partial<Factor24Config>;
+/**
+ * Resolve intent with mood application (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param intentId - The intent ID to resolve
+ * @param moodId - The mood ID to apply (optional)
+ * @returns Resolved and mood-adjusted config or undefined
+ * @since 3.0.0
+ */
+export declare function resolveIntentWithMood(intentId: SemanticIntent, moodId?: SemanticMood): Partial<Factor24Config> | undefined;
+/**
+ * Remove an intent (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param intentId - The intent ID to remove
+ * @returns True if intent was removed
+ * @since 3.0.0
+ */
+export declare function unregisterIntent(intentId: SemanticIntent): boolean;
+/**
+ * Remove a mood (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param moodId - The mood ID to remove
+ * @returns True if mood was removed
+ * @since 3.0.0
+ */
+export declare function unregisterMood(moodId: SemanticMood): boolean;
+/**
+ * Clear all intents (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @since 3.0.0
+ */
+export declare function clearIntents(): void;
+/**
+ * Clear all moods (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @since 3.0.0
+ */
+export declare function clearMoods(): void;
+/**
+ * Get all intent IDs (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Array of all registered intent IDs
+ * @since 3.0.0
+ */
+export declare function getAllIntentIds(): SemanticIntent[];
+/**
+ * Get all mood IDs (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Array of all registered mood IDs
+ * @since 3.0.0
+ */
+export declare function getAllMoodIds(): SemanticMood[];
+/**
+ * Get total intent count (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Total number of registered intents
+ * @since 3.0.0
+ */
+export declare function getIntentCount(): number;
+/**
+ * Get total mood count (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Total number of registered moods
+ * @since 3.0.0
+ */
+export declare function getMoodCount(): number;
+/**
+ * Get all intent configs (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Array of all intent configs
+ * @since 3.0.0
+ */
+export declare function getAllIntentConfigs(): Array<Partial<Factor24Config>>;
+/**
+ * Get all mood adjustment configs (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Array of all mood adjustment configs
+ * @since 3.0.0
+ */
+export declare function getAllMoodAdjustments(): Array<Partial<Factor24Config>>;
+//# sourceMappingURL=intents-basic.d.ts.map

package/dist/resolution/basic/presets-basic.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Presets Resolution - Basic Tier (Pattern A Wrapper)
+ *
+ * Simple wrapper around core preset resolution.
+ * No validation - delegates directly to core.
+ * Used by basic tier components.
+ *
+ * @composition Basic = A wrapper (no validation)
+ *
+ * @packageDocumentation
+ * @module resolution/basic/presets-basic
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Factor24Config, PresetDefinition } from '../core/types-core';
+/**
+ * Preset storage (basic tier).
+ * @since 3.0.0
+ */
+export declare const PRESET_STORAGE: Map<string, Partial<Factor24Config>>;
+/**
+ * Register a preset (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param preset - The preset definition to register
+ * @since 3.0.0
+ */
+export declare function registerPreset(preset: PresetDefinition): void;
+/**
+ * Register multiple presets (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param presets - Array of preset definitions to register
+ * @since 3.0.0
+ */
+export declare function registerPresets(presets: ReadonlyArray<PresetDefinition>): void;
+/**
+ * Resolve a preset ID to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param presetId - The preset ID to resolve
+ * @returns The preset's config or undefined if not found
+ * @since 3.0.0
+ */
+export declare function resolvePreset(presetId: string): Partial<Factor24Config> | undefined;
+/**
+ * Check if a preset exists (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param presetId - The preset ID to check
+ * @returns True if preset exists
+ * @since 3.0.0
+ */
+export declare function hasPreset(presetId: string): boolean;
+/**
+ * Remove a preset (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param presetId - The preset ID to remove
+ * @returns True if preset was removed
+ * @since 3.0.0
+ */
+export declare function unregisterPreset(presetId: string): boolean;
+/**
+ * Clear all presets (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @since 3.0.0
+ */
+export declare function clearPresets(): void;
+/**
+ * Get all preset IDs (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Array of all registered preset IDs
+ * @since 3.0.0
+ */
+export declare function getAllPresetIds(): string[];
+/**
+ * Get total preset count (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Total number of registered presets
+ * @since 3.0.0
+ */
+export declare function getPresetCount(): number;
+/**
+ * Get all preset configs (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @returns Array of all preset configs
+ * @since 3.0.0
+ */
+export declare function getAllPresetConfigs(): Array<Partial<Factor24Config>>;
+//# sourceMappingURL=presets-basic.d.ts.map

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

@@ -0,0 +1,127 @@
+/**
+ * Resolution Orchestrator - Basic Tier (Pattern A Wrapper)
+ *
+ * Simple wrapper around core 5-level resolution.
+ * No validation, no debug - delegates directly to core.
+ * Used by basic tier components.
+ *
+ * @composition Basic = A wrapper (no validation)
+ *
+ * @packageDocumentation
+ * @module resolution/basic/resolver-basic
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { ShorthandPropsCore } from '../core/shorthands-core';
+import type { Factor24Config, MultiLevelProps, FactorGroups, SemanticIntent, SemanticMood } from '../core/types-core';
+/**
+ * Extract Level 1 (raw factors) from MultiLevelProps (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param props - The multi-level props
+ * @returns Partial Factor24Config with Level 1 factors
+ * @since 3.0.0
+ */
+export declare function extractLevel1Factors(props: MultiLevelProps): Partial<Factor24Config>;
+/**
+ * Extract Level 2 (groups) from MultiLevelProps (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param props - The multi-level props
+ * @returns FactorGroups
+ * @since 3.0.0
+ */
+export declare function extractLevel2Groups(props: MultiLevelProps): FactorGroups;
+/**
+ * Extract Level 3 (shorthands) from MultiLevelProps (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param props - The multi-level props
+ * @returns ShorthandPropsCore
+ * @since 3.0.0
+ */
+export declare function extractLevel3Shorthands(props: MultiLevelProps): ShorthandPropsCore;
+/**
+ * Extract Level 4 (preset) from MultiLevelProps (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param props - The multi-level props
+ * @returns Preset ID or undefined
+ * @since 3.0.0
+ */
+export declare function extractLevel4Preset(props: MultiLevelProps): string | undefined;
+/**
+ * Extract Level 5 (intent + mood) from MultiLevelProps (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param props - The multi-level props
+ * @returns Object with intent and mood IDs
+ * @since 3.0.0
+ */
+export declare function extractLevel5Intent(props: MultiLevelProps): {
+    intent?: SemanticIntent;
+    mood?: SemanticMood;
+};
+/**
+ * Merge multiple Factor24Configs (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param configs - Configs to merge in priority order
+ * @returns Merged configuration
+ * @since 3.0.0
+ */
+export declare function mergeConfigs(...configs: Array<Partial<Factor24Config>>): Partial<Factor24Config>;
+/**
+ * Resolve MultiLevelProps to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * Priority: Level 1 > Level 2 > Level 3 > Level 4 > Level 5
+ *
+ * @param props - MultiLevelProps to resolve
+ * @returns Resolved Partial Factor24Config
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * // Using Level 5 (Intent + Mood)
+ * const config1 = resolveProps({
+ *   intent: 'cta',
+ *   mood: 'professional'
+ * });
+ *
+ * // Using Level 3 (Shorthands) with Level 1 override
+ * const config2 = resolveProps({
+ *   look: 'bold',
+ *   feel: 'snappy',
+ *   size: 'lg' // Level 1 overrides shorthand
+ * });
+ *
+ * // Mixing all levels
+ * const config3 = resolveProps({
+ *   intent: 'primary',          // Level 5 (lowest priority)
+ *   preset: 'button-cta',       // Level 4
+ *   look: 'elevated',           // Level 3
+ *   visual: { shape: 'lg' },    // Level 2
+ *   colorScheme: 'secondary',   // Level 1 (highest priority)
+ * });
+ * ```
+ */
+export declare function resolveProps(props: MultiLevelProps): Partial<Factor24Config>;
+/**
+ * Detect which levels are present in MultiLevelProps (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param props - The multi-level props to analyze
+ * @returns Object indicating which levels are present
+ * @since 3.0.0
+ */
+export declare function detectLevels(props: MultiLevelProps): {
+    hasLevel5: boolean;
+    hasLevel4: boolean;
+    hasLevel3: boolean;
+    hasLevel2: boolean;
+    hasLevel1: boolean;
+    levels: number[];
+};
+//# sourceMappingURL=resolver-basic.d.ts.map

package/dist/resolution/basic/shorthands-basic.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Shorthands Resolution - Basic Tier (Pattern A Wrapper)
+ *
+ * Simple wrapper around core shorthand expansion.
+ * No validation - delegates directly to core.
+ * Used by basic tier components.
+ *
+ * @composition Basic = A wrapper (no validation)
+ *
+ * @packageDocumentation
+ * @module resolution/basic/shorthands-basic
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { ShorthandPropsCore } from '../core/shorthands-core';
+import type { Factor24Config, LookShorthand, FeelShorthand, SurfaceShorthand, SpacingShorthand } from '../core/types-core';
+/**
+ * Look shorthand mappings (basic tier).
+ * @since 3.0.0
+ */
+export declare const LOOK_MAPPINGS: Record<LookShorthand, Partial<Factor24Config>>;
+/**
+ * Feel shorthand mappings (basic tier).
+ * @since 3.0.0
+ */
+export declare const FEEL_MAPPINGS: Record<FeelShorthand, Partial<Factor24Config>>;
+/**
+ * Surface shorthand mappings (basic tier).
+ * @since 3.0.0
+ */
+export declare const SURFACE_MAPPINGS: Record<SurfaceShorthand, Partial<Factor24Config>>;
+/**
+ * Spacing shorthand mappings (basic tier).
+ * @since 3.0.0
+ */
+export declare const SPACING_MAPPINGS: Record<SpacingShorthand, Partial<Factor24Config>>;
+/**
+ * Expand look shorthand to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param look - The look shorthand value
+ * @returns Partial Factor24Config with look-related factors
+ * @since 3.0.0
+ */
+export declare function expandLook(look: LookShorthand): Partial<Factor24Config>;
+/**
+ * Expand feel shorthand to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param feel - The feel shorthand value
+ * @returns Partial Factor24Config with feel-related factors
+ * @since 3.0.0
+ */
+export declare function expandFeel(feel: FeelShorthand): Partial<Factor24Config>;
+/**
+ * Expand surface shorthand to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param surface - The surface shorthand value
+ * @returns Partial Factor24Config with surface-related factors
+ * @since 3.0.0
+ */
+export declare function expandSurface(surface: SurfaceShorthand): Partial<Factor24Config>;
+/**
+ * Expand spacing shorthand to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param spacing - The spacing shorthand value
+ * @returns Partial Factor24Config with spacing-related factors
+ * @since 3.0.0
+ */
+export declare function expandSpacingShorthand(spacing: SpacingShorthand): Partial<Factor24Config>;
+/**
+ * Expand all shorthands to Factor24Config (basic tier).
+ * Simple wrapper - delegates to core.
+ *
+ * @param shorthands - The shorthand props to expand
+ * @returns Partial Factor24Config with all shorthand factors
+ * @since 3.0.0
+ */
+export declare function expandShorthands(shorthands: ShorthandPropsCore): Partial<Factor24Config>;
+/**
+ * Shorthand props type (basic tier).
+ * @since 3.0.0
+ */
+export type ShorthandProps = ShorthandPropsCore;
+//# sourceMappingURL=shorthands-basic.d.ts.map