@nikkory/vibe-engine 4.0.0

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

@@ -0,0 +1,160 @@
+/**
+ * Groups Resolution - Core Logic (A)
+ *
+ * Pure group expansion without validation or presets.
+ * Used by all tiers (basic, standard, enterprise).
+ *
+ * @composition Core = A (resolution only)
+ *
+ * @packageDocumentation
+ * @module resolution/core/groups-core
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Factor24Config, FactorGroups, VisualGroup, MotionGroup, LayoutGroup, ExperienceGroup } from '../types';
+/**
+ * Expand Visual Group to Factor24 config (core logic).
+ * No validation - assumes input is well-formed.
+ *
+ * @param visual - The visual group configuration
+ * @returns Partial Factor24Config with visual-related factors
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const config = expandVisualGroupCore({
+ *   shape: 'lg',
+ *   elevation: 'md',
+ *   colorScheme: 'primary',
+ * });
+ * // { shape: 'lg', elevation: 'md', colorScheme: 'primary' }
+ * ```
+ */
+export declare function expandVisualGroupCore(visual: VisualGroup): Partial<Factor24Config>;
+/**
+ * Expand Motion Group to Factor24 config (core logic).
+ * No validation - assumes input is well-formed.
+ *
+ * @param motion - The motion group configuration
+ * @returns Partial Factor24Config with motion-related factors
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const config = expandMotionGroupCore({
+ *   animation: 'smooth',
+ *   transition: 'fast',
+ * });
+ * // { animation: 'smooth', transition: 'fast' }
+ * ```
+ */
+export declare function expandMotionGroupCore(motion: MotionGroup): Partial<Factor24Config>;
+/**
+ * Expand Layout Group to Factor24 config (core logic).
+ * No validation - assumes input is well-formed.
+ *
+ * @param layout - The layout group configuration
+ * @returns Partial Factor24Config with layout-related factors
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const config = expandLayoutGroupCore({
+ *   orientation: 'horizontal',
+ *   density: 'comfortable',
+ * });
+ * // { orientation: 'horizontal', density: 'comfortable' }
+ * ```
+ */
+export declare function expandLayoutGroupCore(layout: LayoutGroup): Partial<Factor24Config>;
+/**
+ * Expand Experience Group to Factor24 config (core logic).
+ * No validation - assumes input is well-formed.
+ *
+ * @param experience - The experience group configuration
+ * @returns Partial Factor24Config with experience-related factors
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const config = expandExperienceGroupCore({
+ *   a11y: 'full',
+ *   cursor: 'pointer',
+ * });
+ * // { a11y: 'full', cursor: 'pointer' }
+ * ```
+ */
+export declare function expandExperienceGroupCore(experience: ExperienceGroup): Partial<Factor24Config>;
+/**
+ * Expand all factor groups to complete Factor24 config (core logic).
+ * Merges all group expansions with later groups overriding earlier ones.
+ * No validation - assumes input is well-formed.
+ *
+ * @param groups - The factor groups to expand
+ * @returns Partial Factor24Config with all group factors
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const config = expandGroupsCore({
+ *   visual: { shape: 'lg', elevation: 'md' },
+ *   motion: { animation: 'smooth' },
+ *   layout: { orientation: 'horizontal' },
+ *   experience: { cursor: 'pointer' },
+ * });
+ * // {
+ * //   shape: 'lg',
+ * //   elevation: 'md',
+ * //   animation: 'smooth',
+ * //   orientation: 'horizontal',
+ * //   cursor: 'pointer'
+ * // }
+ * ```
+ */
+export declare function expandGroupsCore(groups: FactorGroups): Partial<Factor24Config>;
+/**
+ * Merge multiple FactorGroups configurations (core logic).
+ * Later values override earlier ones within each group.
+ * No validation.
+ *
+ * @param groupsList - Factor groups to merge
+ * @returns Merged factor groups
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const merged = mergeFactorGroupsCore(
+ *   { visual: { shape: 'sm' } },
+ *   { visual: { shape: 'lg', elevation: 'md' } }
+ * );
+ * // { visual: { shape: 'lg', elevation: 'md' } }
+ * ```
+ */
+export declare function mergeFactorGroupsCore(...groupsList: FactorGroups[]): FactorGroups;
+/**
+ * Extract all factor groups from a Factor24Config (core logic).
+ * No validation.
+ *
+ * @param config - The full Factor24Config
+ * @returns Extracted factor groups
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const groups = extractAllGroupsCore({
+ *   shape: 'lg',
+ *   animation: 'smooth',
+ *   orientation: 'horizontal',
+ *   cursor: 'pointer',
+ * });
+ * // {
+ * //   visual: { shape: 'lg' },
+ * //   motion: { animation: 'smooth' },
+ * //   layout: { orientation: 'horizontal' },
+ * //   experience: { cursor: 'pointer' }
+ * // }
+ * ```
+ */
+export declare function extractAllGroupsCore(config: Partial<Factor24Config>): FactorGroups;
+//# sourceMappingURL=groups-core.d.ts.map

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

@@ -0,0 +1,21 @@
+/**
+ * Resolution Core - Barrel Export
+ *
+ * Central export point for all core resolution modules.
+ * Provides Pattern A (core logic) for all resolution tiers.
+ *
+ * @composition Core = A (resolution only, no validation)
+ *
+ * @packageDocumentation
+ * @module resolution/core
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+export type { Factor24Config, MultiLevelProps, ResolutionCoreResult, ResolutionStandardResult, ResolutionEnterpriseResult, ResolutionCoreOptions, ResolutionStandardOptions, ResolutionEnterpriseOptions, ResolutionMetrics, DebugTrace, DebugStep, SemanticIntent, SemanticMood, IntentDefinition, MoodModifierDefinition, PresetCategory, PresetDefinition, LookShorthand, FeelShorthand, SurfaceShorthand, SpacingShorthand, ShorthandMappings, VisualGroup, MotionGroup, LayoutGroup, ExperienceGroup, FactorGroups, FactorShape, FactorPosition, FactorIconPosition, FactorState, FactorAnimation, FactorElevation, FactorA11y, FactorAlignment, FactorOrientation, FactorDensity, FactorLoadingState, FactorResponsiveConfig, FactorTheme, FactorSpacing, FactorTypography, FactorBorder, FactorOpacity, FactorOverflow, FactorCursor, FactorZIndex, FactorTransition, ComponentSize, ColorScheme, } from './types-core';
+export { expandVisualGroupCore, expandMotionGroupCore, expandLayoutGroupCore, expandExperienceGroupCore, expandGroupsCore, mergeFactorGroupsCore, extractAllGroupsCore, } from './groups-core';
+export { LOOK_MAPPINGS_CORE, FEEL_MAPPINGS_CORE, SURFACE_MAPPINGS_CORE, SPACING_MAPPINGS_CORE, expandLookCore, expandFeelCore, expandSurfaceCore, expandSpacingShorthandCore, expandShorthandsCore, type ShorthandPropsCore, } from './shorthands-core';
+export { PRESET_STORAGE_CORE, registerPresetCore, registerPresetsCore, resolvePresetCore, hasPresetCore, unregisterPresetCore, clearPresetsCore, getAllPresetIdsCore, getPresetCountCore, getAllPresetConfigsCore, } from './presets-core';
+export { INTENT_STORAGE_CORE, MOOD_STORAGE_CORE, registerIntentCore, registerIntentsCore, registerMoodCore, registerMoodsCore, resolveIntentCore, resolveMoodCore, hasIntentCore, hasMoodCore, applyMoodCore, resolveIntentWithMoodCore, unregisterIntentCore, unregisterMoodCore, clearIntentsCore, clearMoodsCore, getAllIntentIdsCore, getAllMoodIdsCore, getIntentCountCore, getMoodCountCore, getAllIntentConfigsCore, getAllMoodAdjustmentsCore, } from './intents-core';
+export { extractLevel1FactorsCore, extractLevel2GroupsCore, extractLevel3ShorthandsCore, extractLevel4PresetCore, extractLevel5IntentCore, mergeConfigsCore, resolvePropsCore, detectLevelsCore, } from './resolver-core';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,355 @@
+/**
+ * Intents Resolution - Core Logic (A)
+ *
+ * Pure intent and mood resolution without validation or registry management.
+ * Used by all tiers (basic, standard, enterprise).
+ *
+ * @composition Core = A (resolution only)
+ *
+ * @packageDocumentation
+ * @module resolution/core/intents-core
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Factor24Config, IntentDefinition, MoodModifierDefinition, SemanticIntent, SemanticMood } from '../types';
+/**
+ * Core intent storage map.
+ * Maps intent ID to its base configuration.
+ *
+ * @since 3.0.0
+ */
+export declare const INTENT_STORAGE_CORE: Map<SemanticIntent, Partial<Factor24Config>>;
+/**
+ * Core mood storage map.
+ * Maps mood ID to its adjustment configuration.
+ *
+ * @since 3.0.0
+ */
+export declare const MOOD_STORAGE_CORE: Map<SemanticMood, Partial<Factor24Config>>;
+/**
+ * Register an intent in core storage (core logic).
+ * No validation - assumes intent is well-formed.
+ * Overwrites existing intent with same ID.
+ *
+ * @param intent - The intent definition to register
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * registerIntentCore({
+ *   id: 'cta',
+ *   name: 'Call to Action',
+ *   description: 'Primary CTA',
+ *   componentTypes: ['button'],
+ *   config: { variant: 'filled', colorScheme: 'primary' }
+ * });
+ * ```
+ */
+export declare function registerIntentCore(intent: IntentDefinition): void;
+/**
+ * Register multiple intents in core storage (core logic).
+ * No validation - assumes all intents are well-formed.
+ *
+ * @param intents - Array of intent definitions to register
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * registerIntentsCore([
+ *   { id: 'cta', ... },
+ *   { id: 'primary', ... }
+ * ]);
+ * ```
+ */
+export declare function registerIntentsCore(intents: ReadonlyArray<IntentDefinition>): void;
+/**
+ * Register a mood modifier in core storage (core logic).
+ * No validation - assumes mood is well-formed.
+ * Overwrites existing mood with same ID.
+ *
+ * @param mood - The mood definition to register
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * registerMoodCore({
+ *   id: 'professional',
+ *   name: 'Professional',
+ *   description: 'Corporate tone',
+ *   adjustments: { animation: 'subtle', shape: 'sm' }
+ * });
+ * ```
+ */
+export declare function registerMoodCore(mood: MoodModifierDefinition): void;
+/**
+ * Register multiple moods in core storage (core logic).
+ * No validation - assumes all moods are well-formed.
+ *
+ * @param moods - Array of mood definitions to register
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * registerMoodsCore([
+ *   { id: 'professional', ... },
+ *   { id: 'playful', ... }
+ * ]);
+ * ```
+ */
+export declare function registerMoodsCore(moods: ReadonlyArray<MoodModifierDefinition>): void;
+/**
+ * Resolve an intent ID to Factor24Config (core logic).
+ * No validation - returns undefined if not found.
+ *
+ * @param intentId - The intent ID to resolve
+ * @returns The intent's base config or undefined if not found
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const config = resolveIntentCore('cta');
+ * // { variant: 'filled', colorScheme: 'primary' }
+ * ```
+ */
+export declare function resolveIntentCore(intentId: SemanticIntent): Partial<Factor24Config> | undefined;
+/**
+ * Resolve a mood ID to its adjustments (core logic).
+ * No validation - returns undefined if not found.
+ *
+ * @param moodId - The mood ID to resolve
+ * @returns The mood's adjustments or undefined if not found
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const adjustments = resolveMoodCore('professional');
+ * // { animation: 'subtle', shape: 'sm', ... }
+ * ```
+ */
+export declare function resolveMoodCore(moodId: SemanticMood): Partial<Factor24Config> | undefined;
+/**
+ * Check if an intent exists in core storage (core logic).
+ * No validation.
+ *
+ * @param intentId - The intent ID to check
+ * @returns True if intent exists in storage
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * if (hasIntentCore('cta')) {
+ *   const config = resolveIntentCore('cta');
+ * }
+ * ```
+ */
+export declare function hasIntentCore(intentId: SemanticIntent): boolean;
+/**
+ * Check if a mood exists in core storage (core logic).
+ * No validation.
+ *
+ * @param moodId - The mood ID to check
+ * @returns True if mood exists in storage
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * if (hasMoodCore('professional')) {
+ *   const adjustments = resolveMoodCore('professional');
+ * }
+ * ```
+ */
+export declare function hasMoodCore(moodId: SemanticMood): boolean;
+/**
+ * Apply mood adjustments to a base config (core logic).
+ * Merges mood adjustments over base config.
+ * Later values override earlier ones.
+ * No validation.
+ *
+ * @param baseConfig - The base configuration
+ * @param moodAdjustments - The mood adjustments to apply
+ * @returns Merged configuration
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const base = { variant: 'filled', colorScheme: 'primary' };
+ * const mood = { animation: 'subtle', shape: 'sm' };
+ * const result = applyMoodCore(base, mood);
+ * // {
+ * //   variant: 'filled',
+ * //   colorScheme: 'primary',
+ * //   animation: 'subtle',
+ * //   shape: 'sm'
+ * // }
+ * ```
+ */
+export declare function applyMoodCore(baseConfig: Partial<Factor24Config>, moodAdjustments: Partial<Factor24Config>): Partial<Factor24Config>;
+/**
+ * Resolve intent with mood application (core logic).
+ * Combines intent resolution and mood application.
+ * No validation - returns undefined if intent not found.
+ *
+ * @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
+ *
+ * @example
+ * ```typescript
+ * // Without mood
+ * const config1 = resolveIntentWithMoodCore('cta');
+ * // { variant: 'filled', colorScheme: 'primary' }
+ *
+ * // With mood
+ * const config2 = resolveIntentWithMoodCore('cta', 'professional');
+ * // {
+ * //   variant: 'filled',
+ * //   colorScheme: 'primary',
+ * //   animation: 'subtle',
+ * //   shape: 'sm'
+ * // }
+ * ```
+ */
+export declare function resolveIntentWithMoodCore(intentId: SemanticIntent, moodId?: SemanticMood): Partial<Factor24Config> | undefined;
+/**
+ * Remove an intent from core storage (core logic).
+ * No validation.
+ *
+ * @param intentId - The intent ID to remove
+ * @returns True if intent was removed, false if not found
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const removed = unregisterIntentCore('cta');
+ * // true if existed, false if not found
+ * ```
+ */
+export declare function unregisterIntentCore(intentId: SemanticIntent): boolean;
+/**
+ * Remove a mood from core storage (core logic).
+ * No validation.
+ *
+ * @param moodId - The mood ID to remove
+ * @returns True if mood was removed, false if not found
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const removed = unregisterMoodCore('professional');
+ * // true if existed, false if not found
+ * ```
+ */
+export declare function unregisterMoodCore(moodId: SemanticMood): boolean;
+/**
+ * Clear all intents from core storage (core logic).
+ * No validation.
+ *
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * clearIntentsCore();
+ * // All intents removed
+ * ```
+ */
+export declare function clearIntentsCore(): void;
+/**
+ * Clear all moods from core storage (core logic).
+ * No validation.
+ *
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * clearMoodsCore();
+ * // All moods removed
+ * ```
+ */
+export declare function clearMoodsCore(): void;
+/**
+ * Get all intent IDs from core storage (core logic).
+ * No validation.
+ *
+ * @returns Array of all registered intent IDs
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const ids = getAllIntentIdsCore();
+ * // ['cta', 'primary', 'secondary', ...]
+ * ```
+ */
+export declare function getAllIntentIdsCore(): SemanticIntent[];
+/**
+ * Get all mood IDs from core storage (core logic).
+ * No validation.
+ *
+ * @returns Array of all registered mood IDs
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const ids = getAllMoodIdsCore();
+ * // ['professional', 'playful', 'serious', ...]
+ * ```
+ */
+export declare function getAllMoodIdsCore(): SemanticMood[];
+/**
+ * Get total intent count in core storage (core logic).
+ * No validation.
+ *
+ * @returns Total number of registered intents
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const count = getIntentCountCore();
+ * // 42
+ * ```
+ */
+export declare function getIntentCountCore(): number;
+/**
+ * Get total mood count in core storage (core logic).
+ * No validation.
+ *
+ * @returns Total number of registered moods
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const count = getMoodCountCore();
+ * // 7
+ * ```
+ */
+export declare function getMoodCountCore(): number;
+/**
+ * Get all intent configs from core storage (core logic).
+ * No validation.
+ *
+ * @returns Array of all intent configs
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const configs = getAllIntentConfigsCore();
+ * // [{ variant: 'filled', ... }, { variant: 'outlined', ... }]
+ * ```
+ */
+export declare function getAllIntentConfigsCore(): Array<Partial<Factor24Config>>;
+/**
+ * Get all mood adjustment configs from core storage (core logic).
+ * No validation.
+ *
+ * @returns Array of all mood adjustment configs
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const adjustments = getAllMoodAdjustmentsCore();
+ * // [{ animation: 'subtle', ... }, { animation: 'bounce', ... }]
+ * ```
+ */
+export declare function getAllMoodAdjustmentsCore(): Array<Partial<Factor24Config>>;
+//# sourceMappingURL=intents-core.d.ts.map

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

@@ -0,0 +1,160 @@
+/**
+ * Presets Resolution - Core Logic (A)
+ *
+ * Pure preset resolution without validation or registry management.
+ * Used by all tiers (basic, standard, enterprise).
+ *
+ * @composition Core = A (resolution only)
+ *
+ * @packageDocumentation
+ * @module resolution/core/presets-core
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Factor24Config, PresetDefinition } from '../types';
+/**
+ * Core preset storage map.
+ * Simple Map for preset ID to config lookup.
+ *
+ * @since 3.0.0
+ */
+export declare const PRESET_STORAGE_CORE: Map<string, Partial<Factor24Config>>;
+/**
+ * Register a preset in core storage (core logic).
+ * No validation - assumes preset is well-formed.
+ * Overwrites existing preset with same ID.
+ *
+ * @param preset - The preset definition to register
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * registerPresetCore({
+ *   id: 'button-primary',
+ *   name: 'Primary Button',
+ *   category: 'button',
+ *   description: 'Primary action button',
+ *   config: { variant: 'filled', colorScheme: 'primary' }
+ * });
+ * ```
+ */
+export declare function registerPresetCore(preset: PresetDefinition): void;
+/**
+ * Register multiple presets in core storage (core logic).
+ * No validation - assumes all presets are well-formed.
+ *
+ * @param presets - Array of preset definitions to register
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * registerPresetsCore([
+ *   { id: 'btn-primary', ... },
+ *   { id: 'btn-secondary', ... }
+ * ]);
+ * ```
+ */
+export declare function registerPresetsCore(presets: ReadonlyArray<PresetDefinition>): void;
+/**
+ * Resolve a preset ID to Factor24Config (core logic).
+ * No validation - returns undefined if not found.
+ *
+ * @param presetId - The preset ID to resolve
+ * @returns The preset's config or undefined if not found
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const config = resolvePresetCore('button-primary');
+ * // { variant: 'filled', colorScheme: 'primary' }
+ * ```
+ */
+export declare function resolvePresetCore(presetId: string): Partial<Factor24Config> | undefined;
+/**
+ * Check if a preset exists in core storage (core logic).
+ * No validation.
+ *
+ * @param presetId - The preset ID to check
+ * @returns True if preset exists in storage
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * if (hasPresetCore('button-primary')) {
+ *   const config = resolvePresetCore('button-primary');
+ * }
+ * ```
+ */
+export declare function hasPresetCore(presetId: string): boolean;
+/**
+ * Remove a preset from core storage (core logic).
+ * No validation.
+ *
+ * @param presetId - The preset ID to remove
+ * @returns True if preset was removed, false if not found
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const removed = unregisterPresetCore('button-primary');
+ * // true if existed, false if not found
+ * ```
+ */
+export declare function unregisterPresetCore(presetId: string): boolean;
+/**
+ * Clear all presets from core storage (core logic).
+ * No validation.
+ *
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * clearPresetsCore();
+ * // All presets removed
+ * ```
+ */
+export declare function clearPresetsCore(): void;
+/**
+ * Get all preset IDs from core storage (core logic).
+ * No validation.
+ *
+ * @returns Array of all registered preset IDs
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const ids = getAllPresetIdsCore();
+ * // ['button-primary', 'button-secondary', ...]
+ * ```
+ */
+export declare function getAllPresetIdsCore(): string[];
+/**
+ * Get total preset count in core storage (core logic).
+ * No validation.
+ *
+ * @returns Total number of registered presets
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const count = getPresetCountCore();
+ * // 42
+ * ```
+ */
+export declare function getPresetCountCore(): number;
+/**
+ * Get all preset configs from core storage (core logic).
+ * No validation.
+ *
+ * @returns Array of all preset configs
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * const configs = getAllPresetConfigsCore();
+ * // [{ variant: 'filled', ... }, { variant: 'outlined', ... }]
+ * ```
+ */
+export declare function getAllPresetConfigsCore(): Array<Partial<Factor24Config>>;
+//# sourceMappingURL=presets-core.d.ts.map