@nikkory/vibe-engine 4.0.0

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

@@ -0,0 +1,123 @@
+/**
+ * Presets Resolution - Standard Tier (Pattern A+a)
+ *
+ * Adds validation on top of core preset resolution.
+ * Validates presets before registration and resolution.
+ * Used by standard tier components.
+ *
+ * @composition Standard = A + a (core + validation)
+ *
+ * @packageDocumentation
+ * @module resolution/standard/presets-standard
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { Factor24Config, PresetDefinition } from '../core/types-core';
+/**
+ * Preset storage (standard tier).
+ * @since 3.0.0
+ */
+export declare const PRESET_STORAGE: Map<string, Partial<Factor24Config>>;
+/**
+ * Standard preset registration result.
+ * @since 3.0.0
+ */
+export interface PresetRegistrationResult {
+    readonly success: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * Standard preset resolution result.
+ * @since 3.0.0
+ */
+export interface PresetResolutionResult {
+    readonly config?: Partial<Factor24Config>;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * Register a preset (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param preset - The preset definition to register
+ * @returns Registration result with validation
+ * @since 3.0.0
+ */
+export declare function registerPreset(preset: PresetDefinition): PresetRegistrationResult;
+/**
+ * Register multiple presets (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param presets - Array of preset definitions to register
+ * @returns Registration result with validation
+ * @since 3.0.0
+ */
+export declare function registerPresets(presets: ReadonlyArray<PresetDefinition | undefined>): PresetRegistrationResult;
+/**
+ * Resolve a preset ID to Factor24Config (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param presetId - The preset ID to resolve
+ * @returns Resolution result with validation
+ * @since 3.0.0
+ */
+export declare function resolvePreset(presetId: string): PresetResolutionResult;
+/**
+ * Check if a preset exists (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param presetId - The preset ID to check
+ * @returns True if preset exists, with validation
+ * @since 3.0.0
+ */
+export declare function hasPreset(presetId: string): {
+    readonly exists: boolean;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+};
+/**
+ * Remove a preset (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param presetId - The preset ID to remove
+ * @returns True if preset was removed, with validation
+ * @since 3.0.0
+ */
+export declare function unregisterPreset(presetId: string): {
+    readonly removed: boolean;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+};
+/**
+ * Clear all presets (standard tier).
+ * Simple wrapper - no validation needed.
+ *
+ * @since 3.0.0
+ */
+export declare function clearPresets(): void;
+/**
+ * Get all preset IDs (standard tier).
+ * Simple wrapper - no validation needed.
+ *
+ * @returns Array of all registered preset IDs
+ * @since 3.0.0
+ */
+export declare function getAllPresetIds(): string[];
+/**
+ * Get total preset count (standard tier).
+ * Simple wrapper - no validation needed.
+ *
+ * @returns Total number of registered presets
+ * @since 3.0.0
+ */
+export declare function getPresetCount(): number;
+/**
+ * Get all preset configs (standard tier).
+ * Simple wrapper - no validation needed.
+ *
+ * @returns Array of all preset configs
+ * @since 3.0.0
+ */
+export declare function getAllPresetConfigs(): Array<Partial<Factor24Config>>;
+//# sourceMappingURL=presets-standard.d.ts.map

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

@@ -0,0 +1,204 @@
+/**
+ * Resolution Orchestrator - Standard Tier (Pattern A+a)
+ *
+ * Adds validation on top of core 5-level resolution.
+ * Validates inputs before resolution, returns config with validation result.
+ * Used by standard tier components.
+ *
+ * @composition Standard = A + a (core + validation)
+ *
+ * @packageDocumentation
+ * @module resolution/standard/resolver-standard
+ * @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';
+/**
+ * Debug trace step for standard tier.
+ * @since 3.0.0
+ */
+export interface StandardDebugStep {
+    readonly level: number;
+    readonly action: string;
+    readonly input: unknown;
+    readonly output: unknown;
+    readonly note?: string;
+}
+/**
+ * Debug trace for standard tier.
+ * @since 3.0.0
+ */
+export interface StandardDebugTrace {
+    readonly steps: readonly StandardDebugStep[];
+    readonly finalConfig: Partial<Factor24Config>;
+    readonly levelConfigs: Record<number, unknown>;
+}
+/**
+ * Standard resolution result with validation.
+ * @since 3.0.0
+ */
+export interface StandardResolutionResult {
+    readonly config: Partial<Factor24Config>;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings?: readonly string[];
+    readonly debug?: StandardDebugTrace;
+}
+/**
+ * Level detection result with validation.
+ * @since 3.0.0
+ */
+export interface LevelDetectionResult {
+    readonly hasLevel5: boolean;
+    readonly hasLevel4: boolean;
+    readonly hasLevel3: boolean;
+    readonly hasLevel2: boolean;
+    readonly hasLevel1: boolean;
+    readonly levels: readonly number[];
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * Extract Level 1 (raw factors) from MultiLevelProps (standard tier).
+ * Adds validation after extraction.
+ *
+ * @param props - The multi-level props
+ * @returns Partial Factor24Config with validation
+ * @since 3.0.0
+ */
+export declare function extractLevel1Factors(props: MultiLevelProps): {
+    readonly config: Partial<Factor24Config>;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings?: readonly string[];
+};
+/**
+ * Extract Level 2 (groups) from MultiLevelProps (standard tier).
+ * Adds validation after extraction.
+ *
+ * @param props - The multi-level props
+ * @returns FactorGroups with validation
+ * @since 3.0.0
+ */
+export declare function extractLevel2Groups(props: MultiLevelProps): {
+    readonly groups: FactorGroups;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+};
+/**
+ * Extract Level 3 (shorthands) from MultiLevelProps (standard tier).
+ * Adds validation after extraction.
+ *
+ * @param props - The multi-level props
+ * @returns ShorthandPropsCore with validation
+ * @since 3.0.0
+ */
+export declare function extractLevel3Shorthands(props: MultiLevelProps): {
+    readonly shorthands: ShorthandPropsCore;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+};
+/**
+ * Extract Level 4 (preset) from MultiLevelProps (standard tier).
+ * Adds validation after extraction.
+ *
+ * @param props - The multi-level props
+ * @returns Preset ID with validation
+ * @since 3.0.0
+ */
+export declare function extractLevel4Preset(props: MultiLevelProps): {
+    readonly presetId?: string;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+};
+/**
+ * Extract Level 5 (intent + mood) from MultiLevelProps (standard tier).
+ * Adds validation after extraction.
+ *
+ * @param props - The multi-level props
+ * @returns Intent/mood with validation
+ * @since 3.0.0
+ */
+export declare function extractLevel5Intent(props: MultiLevelProps): {
+    readonly intent?: SemanticIntent;
+    readonly mood?: SemanticMood;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+};
+/**
+ * Merge multiple Factor24Configs (standard tier).
+ * Adds validation before and after merging.
+ *
+ * @param configs - Configs to merge in priority order
+ * @returns Merged configuration with validation
+ * @since 3.0.0
+ */
+export declare function mergeConfigs(...configs: Array<Partial<Factor24Config> | undefined>): {
+    readonly config: Partial<Factor24Config>;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings?: readonly string[];
+};
+/**
+ * Resolution options for standard tier.
+ * @since 3.0.0
+ */
+export interface ResolvePropsOptions {
+    /** Enable debug tracing */
+    readonly debug?: boolean;
+    /** Apply default values for missing factors */
+    readonly applyDefaults?: boolean;
+    /** Validate result */
+    readonly validate?: boolean;
+}
+/**
+ * Resolve MultiLevelProps to Factor24Config (standard tier).
+ * Adds validation before and after calling core.
+ *
+ * Priority: Level 1 > Level 2 > Level 3 > Level 4 > Level 5
+ *
+ * @param props - MultiLevelProps to resolve
+ * @param options - Resolution options (optional)
+ * @returns Resolved config with validation result
+ * @since 3.0.0
+ *
+ * @example
+ * ```typescript
+ * // Using Level 5 (Intent + Mood)
+ * const result1 = resolveProps({
+ *   intent: 'cta',
+ *   mood: 'professional'
+ * });
+ * if (result1.valid) {
+ *   console.log(result1.config);
+ * } else {
+ *   console.error(result1.errors);
+ * }
+ *
+ * // Using Level 3 (Shorthands) with Level 1 override
+ * const result2 = resolveProps({
+ *   look: 'bold',
+ *   feel: 'snappy',
+ *   size: 'lg' // Level 1 overrides shorthand
+ * });
+ *
+ * // With debug mode
+ * const result3 = resolveProps({
+ *   intent: 'cta'
+ * }, { debug: true });
+ * console.log(result3.debug); // Debug trace
+ * ```
+ */
+export declare function resolveProps(props: MultiLevelProps, options?: ResolvePropsOptions): StandardResolutionResult;
+/**
+ * Detect which levels are present in MultiLevelProps (standard tier).
+ * Adds validation after detection.
+ *
+ * @param props - The multi-level props to analyze
+ * @returns Level detection result with validation
+ * @since 3.0.0
+ */
+export declare function detectLevels(props: MultiLevelProps): LevelDetectionResult;
+//# sourceMappingURL=resolver-standard.d.ts.map

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

@@ -0,0 +1,98 @@
+/**
+ * Shorthands Resolution - Standard Tier (Pattern A+a)
+ *
+ * Adds validation on top of core shorthand expansion.
+ * Validates shorthands before expanding, returns config with validation result.
+ * Used by standard tier components.
+ *
+ * @composition Standard = A + a (core + validation)
+ *
+ * @packageDocumentation
+ * @module resolution/standard/shorthands-standard
+ * @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 (standard tier).
+ * @since 3.0.0
+ */
+export declare const LOOK_MAPPINGS: Record<LookShorthand, Partial<Factor24Config>>;
+/**
+ * Feel shorthand mappings (standard tier).
+ * @since 3.0.0
+ */
+export declare const FEEL_MAPPINGS: Record<FeelShorthand, Partial<Factor24Config>>;
+/**
+ * Surface shorthand mappings (standard tier).
+ * @since 3.0.0
+ */
+export declare const SURFACE_MAPPINGS: Record<SurfaceShorthand, Partial<Factor24Config>>;
+/**
+ * Spacing shorthand mappings (standard tier).
+ * @since 3.0.0
+ */
+export declare const SPACING_MAPPINGS: Record<SpacingShorthand, Partial<Factor24Config>>;
+/**
+ * Standard shorthand result with validation.
+ * @since 3.0.0
+ */
+export interface StandardShorthandResult {
+    readonly config: Partial<Factor24Config>;
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings?: readonly string[];
+}
+/**
+ * Expand look shorthand to Factor24Config (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param look - The look shorthand value
+ * @returns Config with validation result
+ * @since 3.0.0
+ */
+export declare function expandLook(look: LookShorthand): StandardShorthandResult;
+/**
+ * Expand feel shorthand to Factor24Config (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param feel - The feel shorthand value
+ * @returns Config with validation result
+ * @since 3.0.0
+ */
+export declare function expandFeel(feel: FeelShorthand): StandardShorthandResult;
+/**
+ * Expand surface shorthand to Factor24Config (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param surface - The surface shorthand value
+ * @returns Config with validation result
+ * @since 3.0.0
+ */
+export declare function expandSurface(surface: SurfaceShorthand): StandardShorthandResult;
+/**
+ * Expand spacing shorthand to Factor24Config (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param spacing - The spacing shorthand value
+ * @returns Config with validation result
+ * @since 3.0.0
+ */
+export declare function expandSpacingShorthand(spacing: SpacingShorthand): StandardShorthandResult;
+/**
+ * Expand all shorthands to Factor24Config (standard tier).
+ * Adds validation before calling core.
+ *
+ * @param shorthands - The shorthand props to expand
+ * @returns Config with validation result
+ * @since 3.0.0
+ */
+export declare function expandShorthands(shorthands: ShorthandPropsCore): StandardShorthandResult;
+/**
+ * Shorthand props type (standard tier).
+ * @since 3.0.0
+ */
+export type ShorthandProps = ShorthandPropsCore;
+//# sourceMappingURL=shorthands-standard.d.ts.map

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

@@ -0,0 +1,141 @@
+/**
+ * Validation Logic - Standard Tier (Pattern A+a)
+ *
+ * Adds validation layer on top of core resolution.
+ * Validates inputs before processing and results after.
+ * Used by standard tier components.
+ *
+ * @composition Standard = A + a (core + validation)
+ *
+ * @packageDocumentation
+ * @module resolution/standard/validators
+ * @since 3.0.0
+ *
+ * Powered by Nikkory
+ */
+import type { ShorthandPropsCore } from '../core/shorthands-core';
+import type { Factor24Config, FactorGroups, VisualGroup, MotionGroup, LayoutGroup, ExperienceGroup, PresetDefinition, IntentDefinition, MoodModifierDefinition, SemanticIntent, SemanticMood } from '../core/types-core';
+/**
+ * Validation result for standard tier.
+ * @since 3.0.0
+ */
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings?: readonly string[];
+}
+/**
+ * Create success validation result.
+ * @since 3.0.0
+ */
+export declare function validationSuccess(warnings?: readonly string[]): ValidationResult;
+/**
+ * Create failure validation result.
+ * @since 3.0.0
+ */
+export declare function validationFailure(errors: readonly string[], warnings?: readonly string[]): ValidationResult;
+/**
+ * Validate raw Factor24Config (standard tier).
+ *
+ * @param config - The config to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateFactor24Config(config: Partial<Factor24Config>): ValidationResult;
+/**
+ * Validate VisualGroup (standard tier).
+ *
+ * @param visual - The visual group to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateVisualGroup(visual: VisualGroup): ValidationResult;
+/**
+ * Validate MotionGroup (standard tier).
+ *
+ * @param motion - The motion group to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateMotionGroup(motion: MotionGroup): ValidationResult;
+/**
+ * Validate LayoutGroup (standard tier).
+ *
+ * @param layout - The layout group to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateLayoutGroup(layout: LayoutGroup): ValidationResult;
+/**
+ * Validate ExperienceGroup (standard tier).
+ *
+ * @param experience - The experience group to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateExperienceGroup(experience: ExperienceGroup): ValidationResult;
+/**
+ * Validate FactorGroups (standard tier).
+ *
+ * @param groups - The factor groups to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateFactorGroups(groups: FactorGroups): ValidationResult;
+/**
+ * Validate shorthand props (standard tier).
+ *
+ * @param shorthands - The shorthand props to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateShorthands(shorthands: ShorthandPropsCore): ValidationResult;
+/**
+ * Validate preset definition (standard tier).
+ *
+ * @param preset - The preset definition to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validatePresetDefinition(preset: PresetDefinition): ValidationResult;
+/**
+ * Validate preset ID (standard tier).
+ *
+ * @param presetId - The preset ID to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validatePresetId(presetId: string): ValidationResult;
+/**
+ * Validate intent definition (standard tier).
+ *
+ * @param intent - The intent definition to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateIntentDefinition(intent: IntentDefinition): ValidationResult;
+/**
+ * Validate mood definition (standard tier).
+ *
+ * @param mood - The mood definition to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateMoodDefinition(mood: MoodModifierDefinition): ValidationResult;
+/**
+ * Validate intent ID (standard tier).
+ *
+ * @param intentId - The intent ID to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateIntentId(intentId: SemanticIntent): ValidationResult;
+/**
+ * Validate mood ID (standard tier).
+ *
+ * @param moodId - The mood ID to validate
+ * @returns Validation result
+ * @since 3.0.0
+ */
+export declare function validateMoodId(moodId: SemanticMood): ValidationResult;
+//# sourceMappingURL=validators.d.ts.map