@nikkory/vibe-engine 4.0.0

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

@@ -0,0 +1,235 @@
+/**
+ * Navigation Presets - Pre-configured 24-Factor Configurations
+ *
+ * Named presets for navigation components covering common use cases:
+ * - Navbar presets for main navigation
+ * - Sidebar presets for side navigation
+ * - Breadcrumb presets for hierarchy navigation
+ * - Tab presets for content organization
+ * - Pagination presets for list navigation
+ * - Menu presets for dropdown menus
+ *
+ * @packageDocumentation
+ * @module resolution/presets/nav-presets
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { PresetDefinition } from '../types';
+/**
+ * Navbar Default Preset
+ *
+ * Standard navigation bar with clean, professional appearance.
+ * Features subtle elevation and smooth transitions.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_NAVBAR_DEFAULT: PresetDefinition;
+/**
+ * Navbar Transparent Preset
+ *
+ * Transparent navbar that overlays content.
+ * Great for hero sections and landing pages.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_NAVBAR_TRANSPARENT: PresetDefinition;
+/**
+ * Navbar Elevated Preset
+ *
+ * Elevated navbar with prominent shadow.
+ * Suitable for apps requiring clear navigation separation.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_NAVBAR_ELEVATED: PresetDefinition;
+/**
+ * Sidebar Default Preset
+ *
+ * Standard sidebar navigation with clean appearance.
+ * Features subtle border and comfortable spacing.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_SIDEBAR_DEFAULT: PresetDefinition;
+/**
+ * Sidebar Compact Preset
+ *
+ * Compact sidebar for dense navigation needs.
+ * Icons only when collapsed, full labels when expanded.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_SIDEBAR_COMPACT: PresetDefinition;
+/**
+ * Sidebar Floating Preset
+ *
+ * Floating sidebar with elevation and rounded corners.
+ * Modern appearance for dashboard applications.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_SIDEBAR_FLOATING: PresetDefinition;
+/**
+ * Breadcrumb Default Preset
+ *
+ * Standard breadcrumb navigation with clean appearance.
+ * Features subtle styling and clear hierarchy indication.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_BREADCRUMB_DEFAULT: PresetDefinition;
+/**
+ * Breadcrumb Contained Preset
+ *
+ * Breadcrumb with contained background.
+ * Better visibility on complex backgrounds.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_BREADCRUMB_CONTAINED: PresetDefinition;
+/**
+ * Tabs Default Preset
+ *
+ * Standard tab navigation with underline indicator.
+ * Clean and minimal appearance.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_TABS_DEFAULT: PresetDefinition;
+/**
+ * Tabs Contained Preset
+ *
+ * Tab navigation with contained/pill style.
+ * Active tab has distinct background.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_TABS_CONTAINED: PresetDefinition;
+/**
+ * Tabs Vertical Preset
+ *
+ * Vertical tab navigation for side content switching.
+ * Suitable for settings pages and forms.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_TABS_VERTICAL: PresetDefinition;
+/**
+ * Pagination Default Preset
+ *
+ * Standard pagination with numbered buttons.
+ * Clean appearance suitable for most use cases.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_PAGINATION_DEFAULT: PresetDefinition;
+/**
+ * Pagination Minimal Preset
+ *
+ * Minimal pagination with only prev/next buttons.
+ * Suitable for infinite scroll or simple navigation.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_PAGINATION_MINIMAL: PresetDefinition;
+/**
+ * Pagination Rounded Preset
+ *
+ * Pagination with fully rounded buttons.
+ * Modern, playful appearance.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_PAGINATION_ROUNDED: PresetDefinition;
+/**
+ * Menu Default Preset
+ *
+ * Standard dropdown menu with clean appearance.
+ * Features subtle elevation and smooth animation.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_MENU_DEFAULT: PresetDefinition;
+/**
+ * Menu Compact Preset
+ *
+ * Compact dropdown menu for dense interfaces.
+ * Smaller items with tighter spacing.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_MENU_COMPACT: PresetDefinition;
+/**
+ * Menu Cascading Preset
+ *
+ * Cascading/nested menu with submenu support.
+ * Features animation for submenu reveal.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_MENU_CASCADING: PresetDefinition;
+/**
+ * Stepper Default Preset
+ *
+ * Standard step-by-step navigation.
+ * Shows progress through multi-step processes.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_STEPPER_DEFAULT: PresetDefinition;
+/**
+ * Stepper Vertical Preset
+ *
+ * Vertical step navigation for forms.
+ * Shows all steps with detailed descriptions.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_STEPPER_VERTICAL: PresetDefinition;
+/**
+ * Stepper Minimal Preset
+ *
+ * Minimal step indicator without labels.
+ * Dots or numbers only.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_STEPPER_MINIMAL: PresetDefinition;
+/**
+ * All navigation presets as an array.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_PRESETS: ReadonlyArray<PresetDefinition>;
+/**
+ * Navigation presets as a map for quick lookup.
+ *
+ * @since 2.1.0
+ */
+export declare const NAV_PRESETS_MAP: ReadonlyMap<string, PresetDefinition>;
+/**
+ * Get a navigation preset by ID.
+ *
+ * @param id - The preset ID
+ * @returns The preset definition or undefined if not found
+ * @since 2.1.0
+ */
+export declare function getNavPreset(id: string): PresetDefinition | undefined;
+/**
+ * Get navigation presets by tag.
+ *
+ * @param tag - The tag to filter by
+ * @returns Array of matching presets
+ * @since 2.1.0
+ */
+export declare function getNavPresetsByTag(tag: string): PresetDefinition[];
+/**
+ * Check if a preset ID is a valid navigation preset.
+ *
+ * @param id - The preset ID to check
+ * @returns True if the ID is a valid navigation preset
+ * @since 2.1.0
+ */
+export declare function isNavPreset(id: string): boolean;
+//# sourceMappingURL=nav-presets.d.ts.map

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

@@ -0,0 +1,216 @@
+/**
+ * Overlay Presets - Pre-configured 24-Factor Configurations
+ *
+ * Named presets for overlay components covering common use cases:
+ * - Modal presets for dialog windows
+ * - Drawer presets for sliding panels
+ * - Tooltip presets for contextual information
+ * - Popover presets for rich content overlays
+ * - Sheet presets for bottom/side sheets
+ *
+ * @packageDocumentation
+ * @module resolution/presets/overlay-presets
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { PresetDefinition } from '../types';
+/**
+ * Modal Default Preset
+ *
+ * Standard modal dialog with clean appearance.
+ * Features elevation, rounded corners, and smooth animation.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_MODAL_DEFAULT: PresetDefinition;
+/**
+ * Modal Alert Preset
+ *
+ * Alert modal for important messages and confirmations.
+ * Features prominent styling and action focus.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_MODAL_ALERT: PresetDefinition;
+/**
+ * Modal Fullscreen Preset
+ *
+ * Full-screen modal for immersive experiences.
+ * Takes entire viewport with no backdrop visible.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_MODAL_FULLSCREEN: PresetDefinition;
+/**
+ * Modal Minimal Preset
+ *
+ * Minimal modal with subtle styling.
+ * Less visual weight for secondary dialogs.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_MODAL_MINIMAL: PresetDefinition;
+/**
+ * Drawer Default Preset
+ *
+ * Standard sliding drawer from the side.
+ * Features smooth slide animation and elevation.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_DRAWER_DEFAULT: PresetDefinition;
+/**
+ * Drawer Compact Preset
+ *
+ * Narrow drawer for quick actions.
+ * Suitable for navigation or simple forms.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_DRAWER_COMPACT: PresetDefinition;
+/**
+ * Drawer Full Preset
+ *
+ * Full-width drawer for complex content.
+ * Suitable for forms, editors, or detail views.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_DRAWER_FULL: PresetDefinition;
+/**
+ * Tooltip Default Preset
+ *
+ * Standard tooltip for contextual information.
+ * Compact, dark background with subtle animation.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_TOOLTIP_DEFAULT: PresetDefinition;
+/**
+ * Tooltip Light Preset
+ *
+ * Light-themed tooltip for dark backgrounds.
+ * Clean appearance with subtle shadow.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_TOOLTIP_LIGHT: PresetDefinition;
+/**
+ * Tooltip Rich Preset
+ *
+ * Rich tooltip with more content space.
+ * Suitable for detailed explanations or mini-cards.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_TOOLTIP_RICH: PresetDefinition;
+/**
+ * Popover Default Preset
+ *
+ * Standard popover for rich content overlays.
+ * Features elevation and smooth animation.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_POPOVER_DEFAULT: PresetDefinition;
+/**
+ * Popover Menu Preset
+ *
+ * Popover styled for menu content.
+ * Compact spacing for action lists.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_POPOVER_MENU: PresetDefinition;
+/**
+ * Popover Form Preset
+ *
+ * Popover with form-friendly styling.
+ * Comfortable spacing for inputs and controls.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_POPOVER_FORM: PresetDefinition;
+/**
+ * Sheet Bottom Preset
+ *
+ * Bottom sheet sliding up from bottom.
+ * Common mobile pattern for actions and content.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_SHEET_BOTTOM: PresetDefinition;
+/**
+ * Sheet Draggable Preset
+ *
+ * Draggable bottom sheet with handle.
+ * Can be swiped to different snap points.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_SHEET_DRAGGABLE: PresetDefinition;
+/**
+ * Sheet Full Preset
+ *
+ * Full-height sheet that covers entire screen.
+ * Used for complex flows on mobile.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_SHEET_FULL: PresetDefinition;
+/**
+ * Backdrop Default Preset
+ *
+ * Standard backdrop for modal overlays.
+ * Semi-transparent dark background.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_BACKDROP_DEFAULT: PresetDefinition;
+/**
+ * Backdrop Blur Preset
+ *
+ * Backdrop with blur effect.
+ * Modern glass-like appearance.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_BACKDROP_BLUR: PresetDefinition;
+/**
+ * All overlay presets as an array.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_PRESETS: ReadonlyArray<PresetDefinition>;
+/**
+ * Overlay presets as a map for quick lookup.
+ *
+ * @since 2.1.0
+ */
+export declare const OVERLAY_PRESETS_MAP: ReadonlyMap<string, PresetDefinition>;
+/**
+ * Get an overlay preset by ID.
+ *
+ * @param id - The preset ID
+ * @returns The preset definition or undefined if not found
+ * @since 2.1.0
+ */
+export declare function getOverlayPreset(id: string): PresetDefinition | undefined;
+/**
+ * Get overlay presets by tag.
+ *
+ * @param tag - The tag to filter by
+ * @returns Array of matching presets
+ * @since 2.1.0
+ */
+export declare function getOverlayPresetsByTag(tag: string): PresetDefinition[];
+/**
+ * Check if a preset ID is a valid overlay preset.
+ *
+ * @param id - The preset ID to check
+ * @returns True if the ID is a valid overlay preset
+ * @since 2.1.0
+ */
+export declare function isOverlayPreset(id: string): boolean;
+//# sourceMappingURL=overlay-presets.d.ts.map

package/dist/resolution/presets/preset-registry.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Preset Registry - Central Registry for All Presets
+ *
+ * Unified registry for managing and resolving presets across all component types.
+ * Provides fast lookup, filtering, and search capabilities.
+ *
+ * @packageDocumentation
+ * @module resolution/presets/preset-registry
+ * @since 2.1.0
+ *
+ * Powered by Nikkory
+ */
+import type { PresetDefinition, PresetCategory, Factor24Config, PresetRegistry as IPresetRegistry } from '../types';
+/**
+ * Preset registry implementation.
+ *
+ * @since 2.1.0
+ */
+declare class PresetRegistryImpl implements IPresetRegistry {
+    /** Internal preset storage */
+    readonly presets: Map<string, PresetDefinition>;
+    /** Index by category for fast category lookups */
+    private readonly categoryIndex;
+    /** Index by component type for fast type lookups */
+    private readonly componentTypeIndex;
+    /** Index by tag for fast tag searches */
+    private readonly tagIndex;
+    /**
+     * Creates a new preset registry.
+     *
+     * @param initialPresets - Optional initial presets to register
+     */
+    constructor(initialPresets?: ReadonlyArray<PresetDefinition>);
+    /**
+     * Get a preset by ID.
+     *
+     * @param id - The preset ID
+     * @returns The preset definition or undefined if not found
+     */
+    get(id: string): PresetDefinition | undefined;
+    /**
+     * Register a new preset.
+     *
+     * @param preset - The preset to register
+     * @throws Error if preset with same ID already exists
+     */
+    register(preset: PresetDefinition): void;
+    /**
+     * Get all presets in a category.
+     *
+     * @param category - The category to filter by
+     * @returns Array of presets in the category
+     */
+    getByCategory(category: PresetCategory): PresetDefinition[];
+    /**
+     * Get all presets for a component type.
+     *
+     * @param componentType - The component type to filter by
+     * @returns Array of presets for the component type
+     */
+    getByComponentType(componentType: string): PresetDefinition[];
+    /**
+     * Search presets by tag.
+     *
+     * @param tag - The tag to search for
+     * @returns Array of presets with the tag
+     */
+    searchByTag(tag: string): PresetDefinition[];
+    /**
+     * Search presets by multiple tags (OR logic).
+     *
+     * @param tags - Tags to search for
+     * @returns Array of presets matching any tag
+     */
+    searchByTags(tags: string[]): PresetDefinition[];
+    /**
+     * Search presets by text (searches name, description, and tags).
+     *
+     * @param query - Search query
+     * @returns Array of matching presets
+     */
+    search(query: string): PresetDefinition[];
+    /**
+     * Get all registered presets.
+     *
+     * @returns Array of all presets
+     */
+    getAll(): PresetDefinition[];
+    /**
+     * Get all categories with their preset counts.
+     *
+     * @returns Map of category to preset count
+     */
+    getCategoryCounts(): Map<PresetCategory, number>;
+    /**
+     * Get total number of registered presets.
+     *
+     * @returns Total preset count
+     */
+    get size(): number;
+    /**
+     * Check if a preset exists.
+     *
+     * @param id - The preset ID to check
+     * @returns True if preset exists
+     */
+    has(id: string): boolean;
+    /**
+     * Remove a preset from the registry.
+     *
+     * @param id - The preset ID to remove
+     * @returns True if preset was removed
+     */
+    unregister(id: string): boolean;
+    /**
+     * Clear all presets from the registry.
+     */
+    clear(): void;
+}
+/**
+ * Global preset registry instance.
+ * Pre-populated with all built-in presets.
+ *
+ * @since 2.1.0
+ */
+export declare const presetRegistry: PresetRegistryImpl;
+/**
+ * Resolve a preset ID to its Factor24Config.
+ *
+ * @param presetId - The preset ID to resolve
+ * @returns The preset's config or undefined if not found
+ * @since 2.1.0
+ */
+export declare function resolvePreset(presetId: string): Partial<Factor24Config> | undefined;
+/**
+ * Resolve a preset with fallback to component-specific registries.
+ *
+ * @param presetId - The preset ID to resolve
+ * @param componentType - Optional component type for fallback
+ * @returns The preset's config or undefined if not found
+ * @since 2.1.0
+ */
+export declare function resolvePresetWithFallback(presetId: string, componentType?: string): Partial<Factor24Config> | undefined;
+/**
+ * Get all presets for a specific component type.
+ *
+ * @param componentType - The component type
+ * @returns Array of presets for the component
+ * @since 2.1.0
+ */
+export declare function getPresetsForComponent(componentType: string): PresetDefinition[];
+/**
+ * Get all presets in a category.
+ *
+ * @param category - The preset category
+ * @returns Array of presets in the category
+ * @since 2.1.0
+ */
+export declare function getPresetsByCategory(category: PresetCategory): PresetDefinition[];
+/**
+ * Search all presets.
+ *
+ * @param query - Search query
+ * @returns Array of matching presets
+ * @since 2.1.0
+ */
+export declare function searchPresets(query: string): PresetDefinition[];
+/**
+ * Check if a preset ID is valid.
+ *
+ * @param presetId - The preset ID to check
+ * @returns True if the preset exists
+ * @since 2.1.0
+ */
+export declare function isValidPreset(presetId: string): boolean;
+/**
+ * Get preset metadata without config.
+ *
+ * @param presetId - The preset ID
+ * @returns Preset metadata or undefined
+ * @since 2.1.0
+ */
+export declare function getPresetMetadata(presetId: string): Omit<PresetDefinition, 'config'> | undefined;
+/**
+ * Get all available preset IDs.
+ *
+ * @returns Array of all preset IDs
+ * @since 2.1.0
+ */
+export declare function getAllPresetIds(): string[];
+/**
+ * Get preset count statistics.
+ *
+ * @returns Object with preset counts by category
+ * @since 2.1.0
+ */
+export declare function getPresetStats(): {
+    total: number;
+    byCategory: Record<PresetCategory, number>;
+};
+/**
+ * Create a new preset registry instance.
+ * Useful for isolated testing or custom preset collections.
+ *
+ * @param initialPresets - Optional initial presets
+ * @returns New preset registry instance
+ * @since 2.1.0
+ */
+export declare function createPresetRegistry(initialPresets?: ReadonlyArray<PresetDefinition>): IPresetRegistry;
+export { PresetRegistryImpl };
+export type { IPresetRegistry };
+//# sourceMappingURL=preset-registry.d.ts.map