@nikkory/vibe-engine 4.0.0

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

@@ -0,0 +1,189 @@
+/**
+ * Intents Module - Semantic Intent Resolution
+ *
+ * Central export point for all intent-related functionality.
+ * Provides resolution of semantic intents and mood modifiers
+ * to Factor24 configurations.
+ *
+ * @packageDocumentation
+ * @module resolution/intents
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+import { isValidMoodModifier, getAllMoodIds } from './mood-modifiers';
+import type { IntentDefinition, SemanticIntent, SemanticMood, Factor24Config, IntentRegistry as IIntentRegistry, MoodModifierDefinition } from '../types';
+/**
+ * Intent registry implementation.
+ *
+ * @since 2.1.0
+ */
+declare class IntentRegistryImpl implements IIntentRegistry {
+    /** Intent storage */
+    readonly intents: Map<SemanticIntent, IntentDefinition>;
+    /** Mood modifier storage */
+    readonly moods: Map<SemanticMood, MoodModifierDefinition>;
+    /** Index by component type for fast lookups */
+    private readonly componentTypeIndex;
+    /**
+     * Creates a new intent registry.
+     *
+     * @param initialIntents - Optional initial intents
+     * @param initialMoods - Optional initial mood modifiers
+     */
+    constructor(initialIntents?: ReadonlyArray<IntentDefinition>, initialMoods?: ReadonlyArray<MoodModifierDefinition>);
+    /**
+     * Get an intent by ID.
+     *
+     * @param id - The intent ID
+     * @returns The intent definition or undefined
+     */
+    getIntent(id: SemanticIntent): IntentDefinition | undefined;
+    /**
+     * Get a mood modifier by ID.
+     *
+     * @param id - The mood ID
+     * @returns The mood modifier definition or undefined
+     */
+    getMood(id: SemanticMood): MoodModifierDefinition | undefined;
+    /**
+     * Register a new intent.
+     *
+     * @param intent - The intent to register
+     */
+    registerIntent(intent: IntentDefinition): void;
+    /**
+     * Register a mood modifier.
+     *
+     * @param mood - The mood modifier to register
+     */
+    registerMood(mood: MoodModifierDefinition): void;
+    /**
+     * Get all intents for a component type.
+     *
+     * @param componentType - The component type
+     * @returns Array of intents for the component
+     */
+    getIntentsByComponentType(componentType: string): IntentDefinition[];
+    /**
+     * Get all registered intents.
+     *
+     * @returns Array of all intents
+     */
+    getAllIntents(): IntentDefinition[];
+    /**
+     * Get all registered moods.
+     *
+     * @returns Array of all mood modifiers
+     */
+    getAllMoods(): MoodModifierDefinition[];
+}
+/**
+ * Global intent registry instance.
+ * Pre-populated with all built-in intents and moods.
+ *
+ * @since 2.1.0
+ */
+export declare const intentRegistry: IntentRegistryImpl;
+/**
+ * Resolve an intent to its Factor24Config.
+ *
+ * @param intentId - The intent ID to resolve
+ * @param mood - Optional mood modifier to apply
+ * @returns The resolved Factor24Config or undefined
+ * @since 2.1.0
+ */
+export declare function resolveIntent(intentId: SemanticIntent, mood?: SemanticMood): Partial<Factor24Config> | undefined;
+/**
+ * Resolve an intent with fallback to component-specific registries.
+ *
+ * @param intentId - The intent ID to resolve
+ * @param mood - Optional mood modifier
+ * @param componentType - Optional component type for fallback
+ * @returns The resolved Factor24Config or undefined
+ * @since 2.1.0
+ */
+export declare function resolveIntentWithFallback(intentId: SemanticIntent, mood?: SemanticMood, componentType?: string): Partial<Factor24Config> | undefined;
+/**
+ * Resolve a mood modifier to its adjustments.
+ *
+ * @param moodId - The mood ID to resolve
+ * @returns The mood adjustments or undefined
+ * @since 2.1.0
+ */
+export declare function resolveMood(moodId: SemanticMood): Partial<Factor24Config> | undefined;
+/**
+ * Get all intents for a specific component type.
+ *
+ * @param componentType - The component type
+ * @returns Array of intent definitions
+ * @since 2.1.0
+ */
+export declare function getIntentsForComponent(componentType: string): IntentDefinition[];
+/**
+ * Check if an intent ID is valid.
+ *
+ * @param intentId - The intent ID to check
+ * @returns True if valid
+ * @since 2.1.0
+ */
+export declare function isValidIntent(intentId: string): intentId is SemanticIntent;
+/**
+ * Check if a mood ID is valid.
+ *
+ * @param moodId - The mood ID to check
+ * @returns True if valid
+ * @since 2.1.0
+ */
+export { isValidMoodModifier as isValidMood };
+/**
+ * Get all available intent IDs.
+ *
+ * @returns Array of all intent IDs
+ * @since 2.1.0
+ */
+export declare function getAllIntentIds(): SemanticIntent[];
+/**
+ * Get all available mood IDs.
+ *
+ * @returns Array of all mood IDs
+ * @since 2.1.0
+ */
+export { getAllMoodIds };
+/**
+ * Get intent metadata without config.
+ *
+ * @param intentId - The intent ID
+ * @returns Intent metadata or undefined
+ * @since 2.1.0
+ */
+export declare function getIntentMetadata(intentId: SemanticIntent): Omit<IntentDefinition, 'config' | 'moodModifiers'> | undefined;
+/**
+ * Get intent count statistics.
+ *
+ * @returns Object with intent and mood counts
+ * @since 2.1.0
+ */
+export declare function getIntentStats(): {
+    totalIntents: number;
+    totalMoods: number;
+    byComponentType: Record<string, number>;
+};
+/**
+ * Create a new intent registry instance.
+ *
+ * @param initialIntents - Optional initial intents
+ * @param initialMoods - Optional initial moods
+ * @returns New intent registry instance
+ * @since 2.1.0
+ */
+export declare function createIntentRegistry(initialIntents?: ReadonlyArray<IntentDefinition>, initialMoods?: ReadonlyArray<MoodModifierDefinition>): IIntentRegistry;
+export { BUTTON_INTENTS, BUTTON_INTENTS_MAP, getButtonIntent, isButtonIntent, applyMoodToIntent, INTENT_CTA, INTENT_PRIMARY, INTENT_SECONDARY, INTENT_TERTIARY, INTENT_DESTRUCTIVE, INTENT_CONFIRM, INTENT_CANCEL, INTENT_NAV, INTENT_NAV_ACTIVE, INTENT_NAV_SUBTLE, INTENT_LINK, INTENT_SUCCESS, INTENT_WARNING, INTENT_ERROR, INTENT_INFO, INTENT_GHOST, INTENT_SUBTLE, INTENT_HERO, INTENT_PREMIUM, INTENT_BRAND, } from './button-intents';
+export { MOOD_MODIFIERS, MOOD_MODIFIERS_MAP, getMoodModifier, applyMood, applyMoodWithIntensity, combineMoods, getMoodDescriptions, MOOD_PROFESSIONAL, MOOD_FRIENDLY, MOOD_PLAYFUL, MOOD_SERIOUS, MOOD_LUXURIOUS, MOOD_MINIMAL, MOOD_BOLD, } from './mood-modifiers';
+export type { MoodIntensity } from './mood-modifiers';
+export { CARD_INTENTS, CARD_INTENTS_MAP, getCardIntent, isCardIntent, applyMoodToCardIntent, INTENT_CARD_CONTENT, INTENT_CARD_FEATURED, INTENT_CARD_ARTICLE, INTENT_CARD_INTERACTIVE, INTENT_CARD_SELECTABLE, INTENT_CARD_DRAGGABLE, INTENT_CARD_PRODUCT, INTENT_CARD_PRICING, INTENT_CARD_PROFILE, INTENT_CARD_TESTIMONIAL, INTENT_CARD_STATS, INTENT_CARD_NOTIFICATION, INTENT_CARD_GLASS, INTENT_CARD_NEUMORPHIC, } from './card-intents';
+export { INPUT_INTENTS, INPUT_INTENTS_MAP, getInputIntent, isInputIntent, applyMoodToInputIntent, INTENT_INPUT_TEXT, INTENT_INPUT_EMAIL, INTENT_INPUT_PASSWORD, INTENT_INPUT_SEARCH, INTENT_INPUT_CODE, INTENT_INPUT_NUMBER, INTENT_INPUT_CURRENCY, INTENT_INPUT_SELECT, INTENT_INPUT_MULTISELECT, INTENT_INPUT_AUTOCOMPLETE, INTENT_INPUT_CHECKBOX, INTENT_INPUT_SWITCH, INTENT_INPUT_RADIO, INTENT_INPUT_SLIDER, INTENT_INPUT_RATING, INTENT_INPUT_TEXTAREA, INTENT_INPUT_RICHTEXT, INTENT_INPUT_ERROR, INTENT_INPUT_SUCCESS, INTENT_INPUT_DISABLED, } from './input-intents';
+export { FEEDBACK_INTENTS, FEEDBACK_INTENTS_MAP, getFeedbackIntent, isFeedbackIntent, applyMoodToFeedbackIntent, INTENT_ALERT_INFO, INTENT_ALERT_SUCCESS, INTENT_ALERT_WARNING, INTENT_ALERT_ERROR, INTENT_TOAST_DEFAULT, INTENT_TOAST_SUCCESS, INTENT_TOAST_ERROR, INTENT_TOAST_ACTION, INTENT_PROGRESS_LINEAR, INTENT_PROGRESS_CIRCULAR, INTENT_SKELETON, INTENT_BADGE_DEFAULT, INTENT_BADGE_STATUS, INTENT_BADGE_COUNT, INTENT_CHIP_DEFAULT, INTENT_CHIP_SELECTABLE, INTENT_CHIP_DELETABLE, INTENT_TOOLTIP_DEFAULT, INTENT_TOOLTIP_RICH, } from './feedback-intents';
+export { IntentRegistryImpl };
+export type { IIntentRegistry };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,231 @@
+/**
+ * Input Intents - Semantic Intent Definitions for Inputs
+ *
+ * Defines the mapping from semantic intents to Factor24 configurations
+ * specifically optimized for input and form components.
+ *
+ * @packageDocumentation
+ * @module resolution/intents/input-intents
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { IntentDefinition, SemanticMood, Factor24Config } from '../types';
+/**
+ * Text Intent - Standard text input
+ *
+ * General text entry field.
+ * Clean, accessible appearance.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_TEXT: IntentDefinition;
+/**
+ * Email Intent - Email input
+ *
+ * Email-specific text entry.
+ * Validation-ready styling.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_EMAIL: IntentDefinition;
+/**
+ * Password Intent - Password input
+ *
+ * Secure password entry.
+ * Enhanced security indicators.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_PASSWORD: IntentDefinition;
+/**
+ * Search Intent - Search input
+ *
+ * Search field with action icon.
+ * Quick access and feedback.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_SEARCH: IntentDefinition;
+/**
+ * Code Intent - Code input
+ *
+ * Code/monospace entry.
+ * Syntax-friendly styling.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_CODE: IntentDefinition;
+/**
+ * Number Intent - Numeric input
+ *
+ * Numeric value entry.
+ * Spinner/stepper support.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_NUMBER: IntentDefinition;
+/**
+ * Currency Intent - Currency input
+ *
+ * Monetary value entry.
+ * Format and symbol support.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_CURRENCY: IntentDefinition;
+/**
+ * Select Intent - Dropdown select
+ *
+ * Single selection dropdown.
+ * Clear selection feedback.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_SELECT: IntentDefinition;
+/**
+ * Multiselect Intent - Multiple selection
+ *
+ * Multiple choice selection.
+ * Chip/tag display for selections.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_MULTISELECT: IntentDefinition;
+/**
+ * Autocomplete Intent - Autocomplete input
+ *
+ * Text with suggestions.
+ * Typeahead functionality.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_AUTOCOMPLETE: IntentDefinition;
+/**
+ * Checkbox Intent - Checkbox input
+ *
+ * Binary on/off selection.
+ * Clear checked state.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_CHECKBOX: IntentDefinition;
+/**
+ * Switch Intent - Toggle switch
+ *
+ * On/off toggle control.
+ * iOS/Android style.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_SWITCH: IntentDefinition;
+/**
+ * Radio Intent - Radio button
+ *
+ * Single selection from group.
+ * Exclusive choice pattern.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_RADIO: IntentDefinition;
+/**
+ * Slider Intent - Range slider
+ *
+ * Value selection via slider.
+ * Continuous or stepped values.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_SLIDER: IntentDefinition;
+/**
+ * Rating Intent - Star rating
+ *
+ * Rating value input.
+ * Star or icon-based.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_RATING: IntentDefinition;
+/**
+ * Textarea Intent - Multiline text
+ *
+ * Long-form text entry.
+ * Resizable container.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_TEXTAREA: IntentDefinition;
+/**
+ * Rich Text Intent - WYSIWYG editor
+ *
+ * Rich text editing.
+ * Toolbar and formatting.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_RICHTEXT: IntentDefinition;
+/**
+ * Error Intent - Error state
+ *
+ * Invalid input indication.
+ * Clear error messaging.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_ERROR: IntentDefinition;
+/**
+ * Success Intent - Success state
+ *
+ * Valid input indication.
+ * Confirmation feedback.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_SUCCESS: IntentDefinition;
+/**
+ * Disabled Intent - Disabled state
+ *
+ * Non-interactive input.
+ * Reduced visual prominence.
+ *
+ * @since 2.1.0
+ */
+export declare const INTENT_INPUT_DISABLED: IntentDefinition;
+/**
+ * All input intents as an array.
+ *
+ * @since 2.1.0
+ */
+export declare const INPUT_INTENTS: ReadonlyArray<IntentDefinition>;
+/**
+ * Input intents as a map for quick lookup.
+ *
+ * @since 2.1.0
+ */
+export declare const INPUT_INTENTS_MAP: ReadonlyMap<string, IntentDefinition>;
+/**
+ * Get an input intent by ID.
+ *
+ * @param id - The intent ID
+ * @returns The intent definition or undefined if not found
+ * @since 2.1.0
+ */
+export declare function getInputIntent(id: string): IntentDefinition | undefined;
+/**
+ * Check if an intent ID is a valid input intent.
+ *
+ * @param id - The intent ID to check
+ * @returns True if the ID is a valid input intent
+ * @since 2.1.0
+ */
+export declare function isInputIntent(id: string): boolean;
+/**
+ * Apply mood modifier to input intent.
+ *
+ * @param intentId - The intent ID
+ * @param mood - The mood to apply
+ * @returns Modified Factor24Config or undefined
+ * @since 2.1.0
+ */
+export declare function applyMoodToInputIntent(intentId: string, mood: SemanticMood): Partial<Factor24Config> | undefined;
+//# sourceMappingURL=input-intents.d.ts.map

package/dist/resolution/intents/mood-modifiers.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Mood Modifiers - Emotional Tone Adjustments
+ *
+ * Defines how different moods modify the base Factor24 configuration.
+ * Moods adjust animation, spacing, and visual weight to convey
+ * different emotional tones.
+ *
+ * @packageDocumentation
+ * @module resolution/intents/mood-modifiers
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { MoodModifierDefinition, SemanticMood, Factor24Config } from '../types';
+/**
+ * Professional Mood
+ *
+ * Corporate, formal tone.
+ * Reduced animation, clean lines, subtle transitions.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_PROFESSIONAL: MoodModifierDefinition;
+/**
+ * Friendly Mood
+ *
+ * Approachable, warm tone.
+ * Slightly more animation, softer shapes.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_FRIENDLY: MoodModifierDefinition;
+/**
+ * Playful Mood
+ *
+ * Fun, animated tone.
+ * Bouncy animations, rounded shapes, vibrant.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_PLAYFUL: MoodModifierDefinition;
+/**
+ * Serious Mood
+ *
+ * Formal, minimal animation.
+ * Static elements, sharp focus.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_SERIOUS: MoodModifierDefinition;
+/**
+ * Luxurious Mood
+ *
+ * Premium, elegant tone.
+ * Slow transitions, subtle depth, refined aesthetics.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_LUXURIOUS: MoodModifierDefinition;
+/**
+ * Minimal Mood
+ *
+ * Clean, sparse tone.
+ * Reduced visual elements, focus on content.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_MINIMAL: MoodModifierDefinition;
+/**
+ * Bold Mood
+ *
+ * Strong, impactful tone.
+ * Enhanced visual weight, prominent elements.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_BOLD: MoodModifierDefinition;
+/**
+ * All mood modifiers as an array.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_MODIFIERS: ReadonlyArray<MoodModifierDefinition>;
+/**
+ * Mood modifiers as a map for quick lookup.
+ *
+ * @since 2.1.0
+ */
+export declare const MOOD_MODIFIERS_MAP: ReadonlyMap<SemanticMood, MoodModifierDefinition>;
+/**
+ * Get a mood modifier by ID.
+ *
+ * @param id - The mood ID
+ * @returns The mood modifier definition or undefined if not found
+ * @since 2.1.0
+ */
+export declare function getMoodModifier(id: SemanticMood): MoodModifierDefinition | undefined;
+/**
+ * Check if a mood ID is valid.
+ *
+ * @param id - The mood ID to check
+ * @returns True if the ID is a valid mood
+ * @since 2.1.0
+ */
+export declare function isValidMoodModifier(id: string): id is SemanticMood;
+/**
+ * Apply mood adjustments to a base config.
+ *
+ * @param baseConfig - The base Factor24 configuration
+ * @param mood - The mood to apply
+ * @returns Modified Factor24Config
+ * @since 2.1.0
+ */
+export declare function applyMood(baseConfig: Partial<Factor24Config>, mood: SemanticMood): Partial<Factor24Config>;
+/**
+ * Get all mood IDs.
+ *
+ * @returns Array of all mood IDs
+ * @since 2.1.0
+ */
+export declare function getAllMoodIds(): SemanticMood[];
+/**
+ * Get mood descriptions for documentation.
+ *
+ * @returns Object with mood ID as key and description as value
+ * @since 2.1.0
+ */
+export declare function getMoodDescriptions(): Record<SemanticMood, string>;
+/**
+ * Intensity levels for mood application.
+ *
+ * @since 2.1.0
+ */
+export type MoodIntensity = 'subtle' | 'standard' | 'strong';
+/**
+ * Apply mood with intensity scaling.
+ *
+ * @param baseConfig - The base Factor24 configuration
+ * @param mood - The mood to apply
+ * @param _intensity - How strongly to apply the mood (currently unused, for future implementation)
+ * @returns Modified Factor24Config
+ * @since 2.1.0
+ */
+export declare function applyMoodWithIntensity(baseConfig: Partial<Factor24Config>, mood: SemanticMood, _intensity?: MoodIntensity): Partial<Factor24Config>;
+/**
+ * Combine multiple moods (later moods override earlier).
+ *
+ * @param baseConfig - The base Factor24 configuration
+ * @param moods - Array of moods to apply in order
+ * @returns Modified Factor24Config
+ * @since 2.1.0
+ */
+export declare function combineMoods(baseConfig: Partial<Factor24Config>, moods: SemanticMood[]): Partial<Factor24Config>;
+//# sourceMappingURL=mood-modifiers.d.ts.map