@almadar/patterns 2.8.13 → 2.9.0

package/dist/pattern-types.d.ts

@@ -0,0 +1,2840 @@
+/**
+ * Pattern Types (Auto-Generated)
+ *
+ * DO NOT EDIT MANUALLY - Generated by scripts/generate-pattern-types.ts
+ * Run: npx tsx scripts/generate-pattern-types.ts
+ *
+ * Generated: 2026-02-10T14:06:03.975Z
+ * Pattern count: 120
+ */
+/**
+ * All valid pattern type names from almadar-patterns registry.
+ * Use this type in render-ui effects for compile-time validation.
+ */
+export type PatternType = 'accordion' | 'action-buttons' | 'alert' | 'auth-layout' | 'avatar' | 'badge' | 'battle-template' | 'box' | 'breadcrumb' | 'button' | 'button-pattern' | 'canvas-effect' | 'card' | 'castle-template' | 'center' | 'chart' | 'checkbox' | 'code-viewer' | 'conditional-wrapper' | 'confirm-dialog' | 'container' | 'control-button' | 'counter-template' | 'crud-template' | 'custom-pattern' | 'd-pad' | 'dashboard-grid' | 'dashboard-layout' | 'detail-panel' | 'dialogue-box' | 'divider' | 'document-viewer' | 'drawer' | 'drawer-slot' | 'empty-state' | 'entity-cards' | 'entity-list' | 'entity-table' | 'error-state' | 'filter-group' | 'flex' | 'floating-action-button' | 'form' | 'form-actions' | 'form-field' | 'form-section' | 'form-section-header' | 'form-template' | 'game-hud' | 'game-menu' | 'game-over-screen' | 'game-shell' | 'game-template' | 'generic-app-template' | 'graph-canvas' | 'grid' | 'header' | 'health-bar' | 'icon' | 'input' | 'input-group' | 'inventory-panel' | 'isometric-canvas' | 'label' | 'law-reference-tooltip' | 'layout-pattern' | 'list-template' | 'loading-state' | 'master-detail' | 'media-gallery' | 'menu' | 'meter' | 'modal' | 'modal-slot' | 'navigation' | 'notification' | 'orbital-visualization' | 'overlay' | 'page-header' | 'pagination' | 'popover' | 'progress-bar' | 'radio' | 'relation-select' | 'repeatable-form-section' | 'runtime-debugger' | 'score-display' | 'search-input' | 'section' | 'select' | 'settings-template' | 'side-panel' | 'sidebar' | 'signature-pad' | 'simple-grid' | 'spacer' | 'spinner' | 'split' | 'split-pane' | 'sprite' | 'stack' | 'stat-badge' | 'stats' | 'switch' | 'tabbed-container' | 'table' | 'tabs' | 'text-highlight' | 'textarea' | 'theme-toggle' | 'timeline' | 'toast-slot' | 'tooltip' | 'typography' | 'u-i-slot-renderer' | 'violation-alert' | 'wizard-container' | 'wizard-navigation' | 'wizard-progress' | 'world-map-template';
+/**
+ * Pattern props map - each pattern type maps to its valid props interface.
+ * This enables full type-checking of pattern configurations.
+ */
+export interface PatternPropsMap {
+    'accordion': {
+        type: 'accordion';
+        /** Accordion items */
+        items: unknown[] | string;
+        /** Allow multiple items open at once @default false */
+        multiple?: boolean | string;
+        /** Default open items (IDs) */
+        defaultOpenItems?: unknown[] | string;
+        /** Default open items by index (pattern compatibility) */
+        defaultOpen?: unknown[] | string;
+        /** Controlled open items (IDs) */
+        openItems?: unknown[] | string;
+        /** Callback when item opens/closes */
+        onItemToggle?: ((...args: unknown[]) => unknown) | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'action-buttons': {
+        type: 'action-buttons';
+        /** Button configurations */
+        buttons: unknown[] | string;
+        /** Called when a button is pressed/released */
+        onAction: ((...args: unknown[]) => unknown) | string;
+        /** Layout variant */
+        layout?: string;
+        /** Size variant */
+        size?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Disabled state */
+        disabled?: boolean | string;
+    };
+    'alert': {
+        type: 'alert';
+        /** Alert content (children or message) */
+        children?: unknown | string;
+        /** Alert message (alias for children) */
+        message?: string;
+        /** variant prop */
+        variant?: unknown | string;
+        /** title prop */
+        title?: string;
+        /** dismissible prop */
+        dismissible?: boolean | string;
+        /** onDismiss prop */
+        onDismiss?: ((...args: unknown[]) => unknown) | string;
+        /** onClose prop */
+        onClose?: ((...args: unknown[]) => unknown) | string;
+        /** actions prop */
+        actions?: unknown | string;
+        /** className prop */
+        className?: string;
+    };
+    'auth-layout': {
+        type: 'auth-layout';
+        /** App name */
+        appName?: string;
+        /** Logo component or URL */
+        logo?: unknown | string;
+        /** Background image URL */
+        backgroundImage?: string;
+        /** Show branding panel on the side */
+        showBranding?: boolean | string;
+        /** Branding panel content */
+        brandingContent?: unknown | string;
+    };
+    'avatar': {
+        type: 'avatar';
+        /** Image source URL */
+        src?: string;
+        /** Alt text for the image */
+        alt?: string;
+        /** Full name - initials will be generated automatically */
+        name?: string;
+        /** Initials to display (e.g., "JD" for John Doe) If not provided but name is, initials will be auto-generated */
+        initials?: string;
+        /** Icon to display when no image or initials */
+        icon?: unknown | string;
+        /** Size of the avatar @default 'md' */
+        size?: unknown | string;
+        /** Status indicator */
+        status?: unknown | string;
+        /** Badge content (e.g., notification count) */
+        badge?: string | number;
+        /** Additional CSS classes */
+        className?: string;
+        /** Click handler */
+        onClick?: ((...args: unknown[]) => unknown) | string;
+    };
+    'badge': {
+        type: 'badge';
+        /** variant prop */
+        variant?: unknown | string;
+        /** size prop */
+        size?: unknown | string;
+    };
+    'battle-template': {
+        type: 'battle-template';
+        /** Initial units for the battle */
+        initialUnits: unknown[] | string;
+        /** Isometric tiles (pre-resolved with terrainSprite) */
+        tiles: unknown[] | string;
+        /** Canvas render scale */
+        scale?: number | string;
+        /** Board width for bounds checking */
+        boardWidth?: number | string;
+        /** Board height for bounds checking */
+        boardHeight?: number | string;
+        /** Asset manifest for IsometricCanvas */
+        assetManifest?: Record<string, unknown> | string;
+        /** Background image URL for canvas */
+        backgroundImage?: string;
+        /** Unit draw-size multiplier */
+        unitScale?: number | string;
+        /** -- Slots -- */
+        header?: ((...args: unknown[]) => unknown) | string;
+        /** Sidebar content (combat log, unit roster, etc.) */
+        sidebar?: ((...args: unknown[]) => unknown) | string;
+        /** Floating action buttons */
+        actions?: ((...args: unknown[]) => unknown) | string;
+        /** Floating overlays above the canvas (damage popups, tooltips) */
+        overlay?: ((...args: unknown[]) => unknown) | string;
+        /** Game-over screen overlay */
+        gameOverOverlay?: ((...args: unknown[]) => unknown) | string;
+        /** -- Obstacle features -- */
+        features?: unknown[] | string;
+        /** -- Callbacks -- */
+        onAttack?: ((...args: unknown[]) => unknown) | string;
+        /** Called when battle ends */
+        onGameEnd?: ((...args: unknown[]) => unknown) | string;
+        /** Called after a unit moves */
+        onUnitMove?: ((...args: unknown[]) => unknown) | string;
+        /** Custom combat damage calculator */
+        calculateDamage?: ((...args: unknown[]) => unknown) | string;
+        /** -- Canvas pass-through -- */
+        onDrawEffects?: ((...args: unknown[]) => unknown) | string;
+        /** hasActiveEffects prop */
+        hasActiveEffects?: boolean | string;
+        /** effectSpriteUrls prop */
+        effectSpriteUrls?: unknown[] | string;
+        /** resolveUnitFrame prop */
+        resolveUnitFrame?: ((...args: unknown[]) => unknown) | string;
+        /** className prop */
+        className?: string;
+    };
+    'box': {
+        type: 'box';
+        /** Padding on all sides */
+        padding?: unknown | string;
+        /** Horizontal padding (overrides padding for x-axis) */
+        paddingX?: unknown | string;
+        /** Vertical padding (overrides padding for y-axis) */
+        paddingY?: unknown | string;
+        /** Margin on all sides */
+        margin?: unknown | string;
+        /** Horizontal margin */
+        marginX?: unknown | string;
+        /** Vertical margin */
+        marginY?: unknown | string;
+        /** Background color */
+        bg?: unknown | string;
+        /** Show border */
+        border?: boolean | string;
+        /** Border radius */
+        rounded?: unknown | string;
+        /** Box shadow */
+        shadow?: unknown | string;
+        /** Display type */
+        display?: string;
+        /** Fill available width */
+        fullWidth?: boolean | string;
+        /** Fill available height */
+        fullHeight?: boolean | string;
+        /** Overflow behavior */
+        overflow?: string;
+        /** Position */
+        position?: string;
+        /** HTML element to render as */
+        as?: unknown | string;
+    };
+    'breadcrumb': {
+        type: 'breadcrumb';
+        /** Breadcrumb items */
+        items: unknown[] | string;
+        /** Separator icon */
+        separator?: unknown | string;
+        /** Maximum items to show (truncates with ellipsis) */
+        maxItems?: number | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'button': {
+        type: 'button';
+        /** variant prop */
+        variant?: unknown | string;
+        /** size prop */
+        size?: unknown | string;
+        /** isLoading prop */
+        isLoading?: boolean | string;
+        /** Left icon as ReactNode (preferred) */
+        leftIcon?: unknown | string;
+        /** Right icon as ReactNode (preferred) */
+        rightIcon?: unknown | string;
+        /** Left icon as Lucide icon component (convenience prop, renders with default size) */
+        icon?: unknown | string;
+        /** Right icon as Lucide icon component (convenience prop) */
+        iconRight?: unknown | string;
+    };
+    'button-pattern': {
+        type: 'button-pattern';
+        /** label prop */
+        label: string;
+        /** variant prop */
+        variant?: unknown | string;
+        /** size prop */
+        size?: unknown | string;
+        /** disabled prop */
+        disabled?: boolean | string;
+        /** onClick prop */
+        onClick?: string;
+        /** icon prop */
+        icon?: string;
+        /** iconPosition prop */
+        iconPosition?: string;
+        /** className prop */
+        className?: string;
+    };
+    'canvas-effect': {
+        type: 'canvas-effect';
+        /** The type of combat action to visualise */
+        actionType: unknown | string;
+        /** Screen-space X position (center of the effect) */
+        x: number | string;
+        /** Screen-space Y position (center of the effect) */
+        y: number | string;
+        /** Duration in ms before auto-dismiss (default 2000 for canvas, 800 for emoji) */
+        duration?: number | string;
+        /** Optional intensity multiplier (1 = normal, 2 = double size/brightness) */
+        intensity?: number | string;
+        /** Callback when the effect animation completes */
+        onComplete?: ((...args: unknown[]) => unknown) | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Loading state indicator */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** --- Remote asset loading --- */
+        effectSpriteUrl?: string;
+        /** Base URL for remote assets. Prepended to relative effectSpriteUrl paths. */
+        assetBaseUrl?: string;
+        /** Full effect asset manifest for the sprite particle engine. When provided, enables the canvas-based particle system. */
+        assetManifest?: unknown | string;
+        /** Canvas width (default 400) */
+        width?: number | string;
+        /** Canvas height (default 300) */
+        height?: number | string;
+    };
+    'card': {
+        type: 'card';
+        /** Card title */
+        title?: string;
+        /** Card subtitle or description */
+        subtitle?: string;
+        /** Image URL to display at top of card */
+        image?: string;
+        /** Action buttons to display in card footer */
+        actions?: unknown[] | string;
+        /** Card content */
+        children?: unknown | string;
+        /** Click handler for the entire card */
+        onClick?: ((...args: unknown[]) => unknown) | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'castle-template': {
+        type: 'castle-template';
+        /** Isometric tiles (pre-resolved with terrainSprite) */
+        tiles: unknown[] | string;
+        /** Building features rendered on the grid */
+        features?: unknown[] | string;
+        /** Garrison / stationed units on the grid */
+        units?: unknown[] | string;
+        /** Canvas render scale */
+        scale?: number | string;
+        /** Asset manifest for IsometricCanvas */
+        assetManifest?: Record<string, unknown> | string;
+        /** Background image URL */
+        backgroundImage?: string;
+        /** -- Slots -- */
+        header?: ((...args: unknown[]) => unknown) | string;
+        /** Side panel content (buildings list, recruit tab, garrison tab) */
+        sidePanel?: ((...args: unknown[]) => unknown) | string;
+        /** Canvas overlay (hover tooltips, etc.) */
+        overlay?: ((...args: unknown[]) => unknown) | string;
+        /** Bottom bar (income summary, etc.) */
+        footer?: ((...args: unknown[]) => unknown) | string;
+        /** -- Callbacks -- */
+        onFeatureClick?: ((...args: unknown[]) => unknown) | string;
+        /** Called when a unit is clicked */
+        onUnitClick?: ((...args: unknown[]) => unknown) | string;
+        /** Called when any tile is clicked */
+        onTileClick?: ((...args: unknown[]) => unknown) | string;
+        /** className prop */
+        className?: string;
+    };
+    'center': {
+        type: 'center';
+        /** Center inline (width fits content) vs block (full width) */
+        inline?: boolean | string;
+        /** Center only horizontally */
+        horizontal?: boolean | string;
+        /** Center only vertically */
+        vertical?: boolean | string;
+        /** Minimum height (useful for vertical centering) */
+        minHeight?: string | number;
+        /** Fill available height */
+        fullHeight?: boolean | string;
+        /** Fill available width */
+        fullWidth?: boolean | string;
+        /** Custom class name */
+        className?: string;
+        /** Inline styles */
+        style?: Record<string, unknown> | string;
+        /** Children elements */
+        children: unknown | string;
+        /** HTML element to render as */
+        as?: unknown | string;
+    };
+    'chart': {
+        type: 'chart';
+        /** Chart title */
+        title?: string;
+        /** Chart subtitle / description */
+        subtitle?: string;
+        /** Chart type */
+        chartType?: unknown | string;
+        /** Data series */
+        series?: unknown | string;
+        /** Simple data (single series shorthand) */
+        data?: unknown | string;
+        /** Chart height in px */
+        height?: number | string;
+        /** Show legend */
+        showLegend?: boolean | string;
+        /** Show values on chart */
+        showValues?: boolean | string;
+        /** Actions for chart interactions */
+        actions?: unknown | string;
+        /** Entity name for schema-driven auto-fetch */
+        entity?: string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'checkbox': {
+        type: 'checkbox';
+        /** label prop */
+        label?: string;
+    };
+    'code-viewer': {
+        type: 'code-viewer';
+        /** Viewer title */
+        title?: string;
+        /** Code content */
+        code?: string;
+        /** Language for display label */
+        language?: string;
+        /** Diff lines (for diff mode) */
+        diff?: unknown | string;
+        /** Old value (for generating diff) */
+        oldValue?: string;
+        /** New value (for generating diff) */
+        newValue?: string;
+        /** Display mode */
+        mode?: unknown | string;
+        /** Show line numbers */
+        showLineNumbers?: boolean | string;
+        /** Show copy button */
+        showCopy?: boolean | string;
+        /** Enable word wrap */
+        wordWrap?: boolean | string;
+        /** Max height before scrolling */
+        maxHeight?: number | string;
+        /** Multiple files (tabbed view) */
+        files?: unknown | string;
+        /** Actions */
+        actions?: unknown | string;
+        /** Entity name for schema-driven auto-fetch */
+        entity?: string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'conditional-wrapper': {
+        type: 'conditional-wrapper';
+        /** The S-expression condition to evaluate */
+        condition?: unknown | string;
+        /** Context for evaluating the condition */
+        context: unknown | string;
+        /** Children to render when condition is true (or when no condition is provided) */
+        children: unknown | string;
+        /** Optional fallback to render when condition is false */
+        fallback?: unknown | string;
+        /** Whether to animate the transition (uses CSS transitions) */
+        animate?: boolean | string;
+    };
+    'confirm-dialog': {
+        type: 'confirm-dialog';
+        /** Whether the dialog is open (defaults to true when rendered by slot wrapper) */
+        isOpen?: boolean | string;
+        /** Callback when dialog is closed (injected by slot wrapper) */
+        onClose?: ((...args: unknown[]) => unknown) | string;
+        /** Callback when action is confirmed (injected by slot wrapper) */
+        onConfirm?: ((...args: unknown[]) => unknown) | string;
+        /** Dialog title */
+        title: string;
+        /** Dialog message/description */
+        message?: string | unknown;
+        /** Alias for message (schema compatibility) */
+        description?: string | unknown;
+        /** Confirm button text */
+        confirmText?: string;
+        /** Alias for confirmText (schema compatibility) */
+        confirmLabel?: string;
+        /** Cancel button text */
+        cancelText?: string;
+        /** Alias for cancelText (schema compatibility) */
+        cancelLabel?: string;
+        /** Dialog variant */
+        variant?: unknown | string;
+        /** Dialog size */
+        size?: unknown | string;
+        /** Loading state for confirm button */
+        isLoading?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'container': {
+        type: 'container';
+        /** Maximum width */
+        size?: unknown | string;
+        /** Alias for size (pattern compatibility) */
+        maxWidth?: unknown | string;
+        /** Horizontal padding */
+        padding?: unknown | string;
+        /** Center horizontally */
+        center?: boolean | string;
+        /** Custom class name */
+        className?: string;
+        /** Children elements */
+        children?: unknown | string;
+        /** HTML element to render as */
+        as?: unknown | string;
+    };
+    'control-button': {
+        type: 'control-button';
+        /** Button label text */
+        label?: string;
+        /** Icon component or emoji */
+        icon?: unknown | string;
+        /** Size variant */
+        size?: string;
+        /** Shape variant */
+        shape?: string;
+        /** Visual variant */
+        variant?: string;
+        /** Called when button is pressed */
+        onPress?: ((...args: unknown[]) => unknown) | string;
+        /** Called when button is released */
+        onRelease?: ((...args: unknown[]) => unknown) | string;
+        /** Whether the button is currently pressed */
+        pressed?: boolean | string;
+        /** Whether the button is disabled */
+        disabled?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'counter-template': {
+        type: 'counter-template';
+        /** Current count value */
+        count: number | string;
+        /** Minimum allowed value */
+        min?: number | string;
+        /** Maximum allowed value */
+        max?: number | string;
+        /** Step size for increment/decrement */
+        step?: number | string;
+        /** Called when increment is clicked */
+        onIncrement?: ((...args: unknown[]) => unknown) | string;
+        /** Called when decrement is clicked */
+        onDecrement?: ((...args: unknown[]) => unknown) | string;
+        /** Called when reset is clicked */
+        onReset?: ((...args: unknown[]) => unknown) | string;
+        /** Title displayed above the counter */
+        title?: string;
+        /** Show reset button */
+        showReset?: boolean | string;
+        /** Counter display size */
+        size?: unknown | string;
+        /** Template variant */
+        variant?: unknown | string;
+        /** Additional class name */
+        className?: string;
+    };
+    'crud-template': {
+        type: 'crud-template';
+        /** Array of items to display */
+        items: unknown[] | string;
+        /** Whether data is loading */
+        isLoading?: boolean | string;
+        /** Error object if loading failed */
+        error?: unknown | string;
+        /** Currently selected item for editing */
+        selectedItem?: unknown | string;
+        /** Whether the create/edit modal is open */
+        isModalOpen?: boolean | string;
+        /** Current search query */
+        searchQuery?: string;
+        /** Current sort field */
+        sortBy?: string;
+        /** Current sort order */
+        sortOrder?: string;
+        /** Called to load/refresh items */
+        onLoad?: ((...args: unknown[]) => unknown) | string;
+        /** Called when creating a new item */
+        onCreate?: ((...args: unknown[]) => unknown) | string;
+        /** Called when updating an item */
+        onUpdate?: ((...args: unknown[]) => unknown) | string;
+        /** Called when deleting an item */
+        onDelete?: ((...args: unknown[]) => unknown) | string;
+        /** Called when selecting an item for editing */
+        onSelect?: ((...args: unknown[]) => unknown) | string;
+        /** Called when viewing an item */
+        onView?: ((...args: unknown[]) => unknown) | string;
+        /** Called when search query changes */
+        onSearch?: ((...args: unknown[]) => unknown) | string;
+        /** Called when sort changes */
+        onSort?: ((...args: unknown[]) => unknown) | string;
+        /** Called to open create/edit modal */
+        onOpenModal?: ((...args: unknown[]) => unknown) | string;
+        /** Called to close modal */
+        onCloseModal?: ((...args: unknown[]) => unknown) | string;
+        /** Page title */
+        title?: string;
+        /** Singular entity name for labels */
+        entityName?: string;
+        /** Table column definitions */
+        columns?: unknown[] | string;
+        /** Form field definitions for create/edit */
+        fields?: unknown[] | string;
+        /** Whether to show search input */
+        showSearch?: boolean | string;
+        /** Search input placeholder */
+        searchPlaceholder?: string;
+        /** Whether to show view action */
+        showViewAction?: boolean | string;
+        /** Template variant */
+        variant?: unknown | string;
+        /** Additional class name */
+        className?: string;
+    };
+    'custom-pattern': {
+        type: 'custom-pattern';
+        /** HTML element to render */
+        component: unknown | string;
+        /** Tailwind classes */
+        className?: string;
+        /** Token path(s) for design token resolution */
+        token?: string | unknown[];
+        /** Text content (for leaf elements) */
+        content?: string;
+        /** Event to emit on click (REQUIRED for interactive elements) */
+        action?: string;
+        /** Event payload */
+        payload?: Record<string, unknown> | string;
+        /** Nested children patterns */
+        children?: unknown | string;
+        /** Image source (for img elements) */
+        src?: string;
+        /** Image alt text (for img elements) */
+        alt?: string;
+        /** Link href (for a elements) */
+        href?: string;
+        /** Open link in new tab */
+        external?: boolean | string;
+        /** Disabled state */
+        disabled?: boolean | string;
+        /** Additional HTML attributes */
+        htmlProps?: Record<string, unknown> | string;
+    };
+    'd-pad': {
+        type: 'd-pad';
+        /** Called when a direction is pressed/released */
+        onDirection: ((...args: unknown[]) => unknown) | string;
+        /** Size variant */
+        size?: string;
+        /** Whether to include diagonal buttons */
+        includeDiagonals?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Disabled state */
+        disabled?: boolean | string;
+    };
+    'dashboard-grid': {
+        type: 'dashboard-grid';
+        /** Number of columns */
+        columns?: number | string;
+        /** Gap between cells */
+        gap?: string;
+        /** Cell definitions */
+        cells: unknown[] | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'dashboard-layout': {
+        type: 'dashboard-layout';
+        /** App name shown in sidebar */
+        appName?: string;
+        /** Logo component or URL */
+        logo?: unknown | string;
+        /** Navigation items */
+        navItems?: unknown[] | string;
+        /** Current user info (optional - auto-populated from auth context if not provided) */
+        user?: Record<string, unknown> | string;
+        /** Header actions (notifications, etc.) */
+        headerActions?: unknown | string;
+        /** Show search in header */
+        showSearch?: boolean | string;
+        /** Custom sidebar footer */
+        sidebarFooter?: unknown | string;
+        /** Callback when user clicks sign out (optional - uses auth context signOut if not provided) */
+        onSignOut?: ((...args: unknown[]) => unknown) | string;
+    };
+    'detail-panel': {
+        type: 'detail-panel';
+        /** title prop */
+        title?: string;
+        /** subtitle prop */
+        subtitle?: string;
+        /** status prop */
+        status?: Record<string, unknown> | string;
+        /** avatar prop */
+        avatar?: unknown | string;
+        /** sections prop */
+        sections?: unknown | string;
+        /** Unified actions array - first action with variant='primary' is the main action */
+        actions?: unknown | string;
+        /** footer prop */
+        footer?: unknown | string;
+        /** slideOver prop */
+        slideOver?: boolean | string;
+        /** onClose prop */
+        onClose?: ((...args: unknown[]) => unknown) | string;
+        /** className prop */
+        className?: string;
+        /** Schema-based props */
+        entity?: string;
+        /** Fields to display - accepts string[] or {key, header}[] for unified interface */
+        fields?: unknown | string;
+        /** Alias for fields - backwards compatibility */
+        fieldNames?: unknown | string;
+        /** data prop */
+        data?: Record<string, unknown> | unknown | string;
+        /** isLoading prop */
+        isLoading?: boolean | string;
+        /** error prop */
+        error?: unknown | string;
+        /** Panel position (for drawer/sidebar placement) */
+        position?: string;
+        /** Panel width (CSS value, e.g., '400px', '50%') */
+        width?: string;
+    };
+    'dialogue-box': {
+        type: 'dialogue-box';
+        /** Current dialogue node to display */
+        dialogue: unknown | string;
+        /** Typewriter speed in ms per character (0 = instant) */
+        typewriterSpeed?: number | string;
+        /** Position of dialogue box */
+        position?: string;
+        /** Called when text animation completes */
+        onComplete?: ((...args: unknown[]) => unknown) | string;
+        /** Called when a choice is selected */
+        onChoice?: ((...args: unknown[]) => unknown) | string;
+        /** Called when dialogue is advanced (no choices) */
+        onAdvance?: ((...args: unknown[]) => unknown) | string;
+        /** Optional className */
+        className?: string;
+    };
+    'divider': {
+        type: 'divider';
+        /** Orientation of the divider @default 'horizontal' */
+        orientation?: unknown | string;
+        /** Text label to display in the divider */
+        label?: string;
+        /** Line style variant @default 'solid' */
+        variant?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'document-viewer': {
+        type: 'document-viewer';
+        /** Document title */
+        title?: string;
+        /** Document URL (for PDF/external documents) */
+        src?: string;
+        /** Document content (for text/html/markdown) */
+        content?: string;
+        /** Document type */
+        documentType?: unknown | string;
+        /** Current page (for multi-page documents) */
+        currentPage?: number | string;
+        /** Total pages */
+        totalPages?: number | string;
+        /** Viewer height */
+        height?: number | string;
+        /** Show toolbar */
+        showToolbar?: boolean | string;
+        /** Show download button */
+        showDownload?: boolean | string;
+        /** Show print button */
+        showPrint?: boolean | string;
+        /** Actions */
+        actions?: unknown | string;
+        /** Multiple documents (tabbed view) */
+        documents?: unknown | string;
+        /** Entity name for schema-driven auto-fetch */
+        entity?: string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'drawer': {
+        type: 'drawer';
+        /** Whether the drawer is open (defaults to true when rendered by slot wrapper) */
+        isOpen?: boolean | string;
+        /** Callback when drawer should close (injected by slot wrapper) */
+        onClose?: ((...args: unknown[]) => unknown) | string;
+        /** Drawer title */
+        title?: string;
+        /** Drawer content (can be empty if using slot content) */
+        children?: unknown | string;
+        /** Footer content */
+        footer?: unknown | string;
+        /** Position (left or right) */
+        position?: unknown | string;
+        /** Width (CSS value or preset size) */
+        width?: string | unknown;
+        /** Show close button */
+        showCloseButton?: boolean | string;
+        /** Close on overlay click */
+        closeOnOverlayClick?: boolean | string;
+        /** Close on escape key */
+        closeOnEscape?: boolean | string;
+        /** Additional class name */
+        className?: string;
+    };
+    'drawer-slot': {
+        type: 'drawer-slot';
+        /** Content to display in the drawer */
+        children?: unknown | string;
+        /** Override drawer title (extracted from children if not provided) */
+        title?: string;
+        /** Drawer position */
+        position?: unknown | string;
+        /** Drawer size */
+        size?: unknown | string;
+        /** Custom class name */
+        className?: string;
+    };
+    'empty-state': {
+        type: 'empty-state';
+        /** Icon to display. Accepts either: - A Lucide icon component (LucideIcon) - A string icon name (e.g., "check-circle", "x-circle") */
+        icon?: unknown | string;
+        /** Primary text to display - use title or message (message is alias for backwards compat) */
+        title?: string;
+        /** Alias for title - used by schema patterns */
+        message?: string;
+        /** description prop */
+        description?: string;
+        /** actionLabel prop */
+        actionLabel?: string;
+        /** onAction prop */
+        onAction?: ((...args: unknown[]) => unknown) | string;
+        /** className prop */
+        className?: string;
+        /** Destructive styling for confirmation dialogs */
+        destructive?: boolean | string;
+        /** Variant for color styling */
+        variant?: string;
+    };
+    'entity-cards': {
+        type: 'entity-cards';
+        /** Minimum width of each card (default: 280px) */
+        minCardWidth?: number | string;
+        /** Maximum number of columns */
+        maxCols?: number | string;
+        /** Gap between cards */
+        gap?: unknown | string;
+        /** Align cards vertically in their cells */
+        alignItems?: string;
+        /** Custom class name */
+        className?: string;
+        /** Children elements (cards) - optional when using entity/data props */
+        children?: unknown | string;
+        /** Entity type for data-bound usage */
+        entity?: string;
+        /** Fields to display - accepts string[] or {key, header}[] for unified interface */
+        fields?: unknown | string;
+        /** Alias for fields - backwards compatibility */
+        fieldNames?: unknown | string;
+        /** Alias for fields - backwards compatibility */
+        columns?: unknown | string;
+        /** Data array for data-bound usage - accepts readonly for generated const arrays */
+        data?: unknown | string;
+        /** Loading state indicator */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Actions for each card item (schema-driven) */
+        itemActions?: unknown | string;
+        /** Callback when a card is clicked */
+        onCardClick?: ((...args: unknown[]) => unknown) | string;
+        /** Enable server-side pagination */
+        enablePagination?: boolean | string;
+        /** Items per page (default: 20) */
+        pageSize?: number | string;
+        /** Show total count in pagination */
+        showTotal?: boolean | string;
+        /** Filter configuration for entity data */
+        filter?: Record<string, unknown> | string;
+        /** Query singleton binding for filter/sort state. When provided, syncs with the query singleton for filtering and sorting. Example: "@TaskQuery" */
+        query?: string;
+    };
+    'entity-list': {
+        type: 'entity-list';
+        /** Entity name for auto-fetch OR data array (backwards compatible) */
+        entity?: unknown[] | unknown | string;
+        /** Data array - primary prop for data */
+        data?: unknown[] | unknown | string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** selectable prop */
+        selectable?: boolean | string;
+        /** selectedItems prop */
+        selectedItems?: unknown | string;
+        /** onSelectionChange prop */
+        onSelectionChange?: ((...args: unknown[]) => unknown) | string;
+        /** Item actions - schema-driven or function-based */
+        itemActions?: ((...args: unknown[]) => unknown) | unknown | string;
+        /** showDividers prop */
+        showDividers?: boolean | string;
+        /** variant prop */
+        variant?: string;
+        /** emptyMessage prop */
+        emptyMessage?: string;
+        /** className prop */
+        className?: string;
+        /** renderItem prop */
+        renderItem?: ((...args: unknown[]) => unknown) | string;
+        /** children prop */
+        children?: unknown | string;
+        /** onItemAction prop */
+        onItemAction?: ((...args: unknown[]) => unknown) | string;
+        /** onRowClick prop */
+        onRowClick?: ((...args: unknown[]) => unknown) | string;
+        /** Fields to display - accepts string[] or {key, header}[] for unified interface */
+        fields?: unknown | string;
+        /** Alias for fields - backwards compatibility */
+        fieldNames?: unknown | string;
+        /** Query singleton binding for filter/sort state. When provided, syncs with the query singleton for filtering and sorting. Example: "@TaskQuery" */
+        query?: string;
+        /** Entity type name for display */
+        entityType?: string;
+    };
+    'entity-table': {
+        type: 'entity-table';
+        /** Fields to display - accepts string[] or Column[] for unified interface. Alias for columns */
+        fields?: unknown | string;
+        /** Columns can be Column objects or simple string field names - accepts readonly for generated const arrays */
+        columns?: unknown | string;
+        /** Data array - primary prop for data. Accepts readonly or mutable arrays, and unknown for generated components */
+        data?: unknown | unknown[] | string;
+        /** Entity name for auto-fetch OR data array (backwards compatible) */
+        entity?: string | unknown | unknown[];
+        /** Item actions from generated code - maps to rowActions */
+        itemActions?: unknown | string;
+        /** Loading state indicator */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** emptyIcon prop */
+        emptyIcon?: unknown | string;
+        /** emptyTitle prop */
+        emptyTitle?: string;
+        /** emptyDescription prop */
+        emptyDescription?: string;
+        /** emptyAction prop */
+        emptyAction?: Record<string, unknown> | string;
+        /** Selection */
+        selectable?: boolean | string;
+        /** selectedIds prop */
+        selectedIds?: unknown | string;
+        /** onSelectionChange prop */
+        onSelectionChange?: ((...args: unknown[]) => unknown) | string;
+        /** Sorting */
+        sortBy?: string;
+        /** sortDirection prop */
+        sortDirection?: string;
+        /** onSort prop */
+        onSort?: ((...args: unknown[]) => unknown) | string;
+        /** Pagination (manual control) */
+        pagination?: Record<string, unknown> | string;
+        /** Server-side pagination (automatic when enabled) */
+        enablePagination?: boolean | string;
+        /** Items per page for automatic pagination (default: 20) */
+        defaultPageSize?: number | string;
+        /** Show total count in pagination */
+        showTotal?: boolean | string;
+        /** Search */
+        searchable?: boolean | string;
+        /** searchValue prop */
+        searchValue?: string;
+        /** onSearch prop */
+        onSearch?: ((...args: unknown[]) => unknown) | string;
+        /** searchPlaceholder prop */
+        searchPlaceholder?: string;
+        /** Row click navigation */
+        onRowClick?: ((...args: unknown[]) => unknown) | string;
+        /** Row actions */
+        rowActions?: unknown | string;
+        /** Bulk actions */
+        bulkActions?: unknown[] | string;
+        /** Header actions */
+        headerActions?: unknown | string;
+        /** Query singleton binding for filter/sort state. When provided, syncs with the query singleton for filtering and sorting. Example: "@TaskQuery" */
+        query?: string;
+        /** className prop */
+        className?: string;
+    };
+    'error-state': {
+        type: 'error-state';
+        /** title prop */
+        title?: string;
+        /** Error message to display */
+        message?: string;
+        /** Alias for message (schema compatibility) */
+        description?: string;
+        /** onRetry prop */
+        onRetry?: ((...args: unknown[]) => unknown) | string;
+        /** className prop */
+        className?: string;
+    };
+    'filter-group': {
+        type: 'filter-group';
+        /** Entity name to filter */
+        entity: string;
+        /** Filter definitions from schema */
+        filters: unknown | string;
+        /** Callback when a filter changes - for EntityStore integration */
+        onFilterChange?: ((...args: unknown[]) => unknown) | string;
+        /** Callback to clear all filters */
+        onClearAll?: ((...args: unknown[]) => unknown) | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Variant style */
+        variant?: string;
+        /** Show filter icon */
+        showIcon?: boolean | string;
+        /** Query singleton binding for state management. When provided, syncs filter state with the query singleton. Example: "@TaskQuery" */
+        query?: string;
+        /** Loading state indicator */
+        isLoading?: boolean | string;
+    };
+    'flex': {
+        type: 'flex';
+        /** Flex direction */
+        direction?: unknown | string;
+        /** Flex wrap */
+        wrap?: unknown | string;
+        /** Align items */
+        align?: unknown | string;
+        /** Justify content */
+        justify?: unknown | string;
+        /** Gap between items */
+        gap?: unknown | string;
+        /** Inline flex */
+        inline?: boolean | string;
+        /** Flex grow */
+        grow?: boolean | number | string;
+        /** Flex shrink */
+        shrink?: boolean | number | string;
+        /** Flex basis */
+        basis?: string | number;
+        /** Custom class name */
+        className?: string;
+        /** Children elements */
+        children: unknown | string;
+        /** HTML element to render as */
+        as?: unknown | string;
+    };
+    'floating-action-button': {
+        type: 'floating-action-button';
+        /** Single action (if only one action, button will directly trigger onClick) */
+        action?: Record<string, unknown> | string;
+        /** Multiple actions (if provided, button will expand to show all actions) */
+        actions?: unknown[] | string;
+        /** Icon name (simplified API for pattern compatibility) */
+        icon?: string;
+        /** Click handler (simplified API for pattern compatibility) */
+        onClick?: ((...args: unknown[]) => unknown) | string;
+        /** Variant (simplified API for pattern compatibility) */
+        variant?: string;
+        /** Button position @default 'bottom-right' */
+        position?: string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'form': {
+        type: 'form';
+        /** Form fields (traditional React children) */
+        children?: unknown | string;
+        /** Submit handler - receives form data, or event name string for trait dispatch */
+        onSubmit?: ((...args: unknown[]) => unknown) | string;
+        /** Cancel handler - function or event name string for trait dispatch */
+        onCancel?: ((...args: unknown[]) => unknown) | string;
+        /** Form layout */
+        layout?: string;
+        /** Gap between fields */
+        gap?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Schema-based props */
+        entity?: string;
+        /** Form mode - 'create' for new records, 'edit' for updating existing */
+        mode?: string;
+        /** Fields definition (schema format) - accepts readonly for generated const arrays */
+        fields?: unknown | string;
+        /** Initial form data */
+        initialData?: Record<string, unknown> | unknown | string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Submit button label */
+        submitLabel?: string;
+        /** Cancel button label (if provided, shows cancel button) */
+        cancelLabel?: string;
+        /** Show cancel button (defaults to true for schema forms) */
+        showCancel?: boolean | string;
+        /** Form title (used by ModalSlot to extract title) */
+        title?: string;
+        /** Event dispatch props (for trait state machine integration) */
+        submitEvent?: string;
+        /** Event to dispatch on cancel (defaults to 'CANCEL') */
+        cancelEvent?: string;
+        /** Relation data props */
+        relationsData?: Record<string, unknown> | string;
+        /** Loading state for relation data: { fieldName: boolean } */
+        relationsLoading?: Record<string, unknown> | string;
+        /** Inspection form extensions */
+        conditionalFields?: Record<string, unknown> | boolean | string;
+        /** Hidden calculations that emit GLOBAL_VARIABLE_SET on field change (boolean true means enabled but config loaded separately) */
+        hiddenCalculations?: unknown[] | boolean | string;
+        /** Violation conditions that emit VIOLATION_DETECTED when met (boolean true means enabled but config loaded separately) */
+        violationTriggers?: unknown[] | boolean | string;
+        /** Context for S-expression evaluation - accepts flexible types from generated code */
+        evaluationContext?: unknown | Record<string, unknown> | string;
+        /** Nested form sections with optional conditions */
+        sections?: unknown[] | string;
+        /** Callback when any field value changes */
+        onFieldChange?: ((...args: unknown[]) => unknown) | string;
+        /** Config path for form configuration (schema-driven) */
+        configPath?: string;
+        /** Whether the form supports repeatable entries */
+        repeatable?: boolean | string;
+    };
+    'form-actions': {
+        type: 'form-actions';
+        /** Button group content (Button components) - use this OR primary/secondary */
+        children?: unknown | string;
+        /** Primary action button config (for form-actions pattern) Accepts Readonly for compatibility with generated const objects */
+        primary?: unknown | string;
+        /** Secondary action buttons config (for form-actions pattern) Accepts readonly array for compatibility with generated const arrays */
+        secondary?: unknown | string;
+        /** Visual variant @default 'default' */
+        variant?: unknown | string;
+        /** Orientation @default 'horizontal' */
+        orientation?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Entity type for filter-group pattern (schema metadata) */
+        entity?: string;
+        /** Filter definitions for filter-group pattern */
+        filters?: unknown | string;
+    };
+    'form-field': {
+        type: 'form-field';
+        /** label prop */
+        label: string;
+        /** required prop */
+        required?: boolean | string;
+        /** error prop */
+        error?: string;
+        /** hint prop */
+        hint?: string;
+        /** className prop */
+        className?: string;
+        /** children prop */
+        children: unknown | string;
+    };
+    'form-section': {
+        type: 'form-section';
+        /** Form fields (traditional React children) */
+        children?: unknown | string;
+        /** Submit handler - receives form data, or event name string for trait dispatch */
+        onSubmit?: ((...args: unknown[]) => unknown) | string;
+        /** Cancel handler - function or event name string for trait dispatch */
+        onCancel?: ((...args: unknown[]) => unknown) | string;
+        /** Form layout */
+        layout?: string;
+        /** Gap between fields */
+        gap?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Schema-based props */
+        entity?: string;
+        /** Form mode - 'create' for new records, 'edit' for updating existing */
+        mode?: string;
+        /** Fields definition (schema format) - accepts readonly for generated const arrays */
+        fields?: unknown | string;
+        /** Initial form data */
+        initialData?: Record<string, unknown> | unknown | string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Submit button label */
+        submitLabel?: string;
+        /** Cancel button label (if provided, shows cancel button) */
+        cancelLabel?: string;
+        /** Show cancel button (defaults to true for schema forms) */
+        showCancel?: boolean | string;
+        /** Form title (used by ModalSlot to extract title) */
+        title?: string;
+        /** Event dispatch props (for trait state machine integration) */
+        submitEvent?: string;
+        /** Event to dispatch on cancel (defaults to 'CANCEL') */
+        cancelEvent?: string;
+        /** Relation data props */
+        relationsData?: Record<string, unknown> | string;
+        /** Loading state for relation data: { fieldName: boolean } */
+        relationsLoading?: Record<string, unknown> | string;
+        /** Inspection form extensions */
+        conditionalFields?: Record<string, unknown> | boolean | string;
+        /** Hidden calculations that emit GLOBAL_VARIABLE_SET on field change (boolean true means enabled but config loaded separately) */
+        hiddenCalculations?: unknown[] | boolean | string;
+        /** Violation conditions that emit VIOLATION_DETECTED when met (boolean true means enabled but config loaded separately) */
+        violationTriggers?: unknown[] | boolean | string;
+        /** Context for S-expression evaluation - accepts flexible types from generated code */
+        evaluationContext?: unknown | Record<string, unknown> | string;
+        /** Nested form sections with optional conditions */
+        sections?: unknown[] | string;
+        /** Callback when any field value changes */
+        onFieldChange?: ((...args: unknown[]) => unknown) | string;
+        /** Config path for form configuration (schema-driven) */
+        configPath?: string;
+        /** Whether the form supports repeatable entries */
+        repeatable?: boolean | string;
+    };
+    'form-section-header': {
+        type: 'form-section-header';
+        /** Section title */
+        title: string;
+        /** Section subtitle */
+        subtitle?: string;
+        /** Whether section is collapsed */
+        isCollapsed?: boolean | string;
+        /** Toggle collapse handler (makes header clickable) */
+        onToggle?: ((...args: unknown[]) => unknown) | string;
+        /** Badge text (e.g., "3 fields", "Required", "Complete") */
+        badge?: string;
+        /** Badge variant */
+        badgeVariant?: string;
+        /** Icon name to show before title */
+        icon?: string;
+        /** Whether section has validation errors */
+        hasErrors?: boolean | string;
+        /** Whether section is complete */
+        isComplete?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'form-template': {
+        type: 'form-template';
+        /** Current form field values */
+        formData: Record<string, unknown> | string;
+        /** Whether form is being submitted */
+        isSubmitting?: boolean | string;
+        /** Whether submission was successful */
+        isSuccess?: boolean | string;
+        /** Error object if submission failed */
+        error?: unknown | string;
+        /** Field-level validation errors */
+        validationErrors?: Record<string, unknown> | string;
+        /** Called when form is submitted */
+        onSubmit?: ((...args: unknown[]) => unknown) | string;
+        /** Called when a field value changes */
+        onFieldChange?: ((...args: unknown[]) => unknown) | string;
+        /** Called to reset the form */
+        onReset?: ((...args: unknown[]) => unknown) | string;
+        /** Called to dismiss success message */
+        onDismissSuccess?: ((...args: unknown[]) => unknown) | string;
+        /** Form title */
+        title?: string;
+        /** Form subtitle/description */
+        subtitle?: string;
+        /** Submit button label */
+        submitLabel?: string;
+        /** Success message */
+        successMessage?: string;
+        /** Whether to show reset button */
+        showReset?: boolean | string;
+        /** Form field definitions */
+        fields?: unknown[] | string;
+        /** Template variant */
+        variant?: unknown | string;
+        /** Additional class name */
+        className?: string;
+    };
+    'game-hud': {
+        type: 'game-hud';
+        /** Position of the HUD */
+        position?: string;
+        /** Stats to display - accepts readonly for compatibility with generated const arrays */
+        stats?: unknown | string;
+        /** Alias for stats (schema compatibility) */
+        items?: unknown | string;
+        /** Schema-style elements array (alternative to stats). Converted to stats internally for backwards compatibility. */
+        elements?: unknown | string;
+        /** Size variant */
+        size?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Whether to use a semi-transparent background */
+        transparent?: boolean | string;
+    };
+    'game-menu': {
+        type: 'game-menu';
+        /** Menu title */
+        title: string;
+        /** Optional subtitle or version */
+        subtitle?: string;
+        /** Menu options - accepts readonly for compatibility with generated const arrays */
+        options?: unknown | string;
+        /** Alias for options (schema compatibility) */
+        menuItems?: unknown | string;
+        /** Called when an option is selected (legacy callback, prefer event bus) */
+        onSelect?: ((...args: unknown[]) => unknown) | string;
+        /** Event bus for emitting UI events (optional, uses hook if not provided) */
+        eventBus?: unknown | string;
+        /** Background image or gradient */
+        background?: string;
+        /** Logo image URL */
+        logo?: string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'game-over-screen': {
+        type: 'game-over-screen';
+        /** Screen title (e.g., "Game Over", "Victory!") */
+        title: string;
+        /** Optional message */
+        message?: string;
+        /** Stats to display */
+        stats?: unknown[] | string;
+        /** Action buttons */
+        actions?: unknown[] | string;
+        /** Alias for actions (schema compatibility) */
+        menuItems?: unknown[] | string;
+        /** Called when an action is selected (legacy callback, prefer event bus) */
+        onAction?: ((...args: unknown[]) => unknown) | string;
+        /** Event bus for emitting UI events (optional, uses hook if not provided) */
+        eventBus?: unknown | string;
+        /** Victory or defeat variant */
+        variant?: string;
+        /** High score (optional, shows "NEW HIGH SCORE!" if exceeded) */
+        highScore?: number | string;
+        /** Current score for high score comparison (accepts string for schema bindings) */
+        currentScore?: number | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'game-shell': {
+        type: 'game-shell';
+        /** Application / game title shown in the HUD bar */
+        appName?: string;
+        /** Optional HUD content rendered above the main area */
+        hud?: unknown | string;
+        /** Extra class name on the root container */
+        className?: string;
+        /** Whether to show the minimal top bar (default: true) */
+        showTopBar?: boolean | string;
+    };
+    'game-template': {
+        type: 'game-template';
+        /** Title of the game */
+        title?: string;
+        /** The main game canvas or content */
+        children: unknown | string;
+        /** HUD overlay content (scores, health, etc.) */
+        hud?: unknown | string;
+        /** Debug panel content */
+        debugPanel?: unknown | string;
+        /** Whether the debug panel is visible */
+        showDebugPanel?: boolean | string;
+        /** Game controls */
+        controls?: Record<string, unknown> | string;
+        /** Additional class name */
+        className?: string;
+    };
+    'generic-app-template': {
+        type: 'generic-app-template';
+        /** Page title */
+        title: string;
+        /** Subtitle or description */
+        subtitle?: string;
+        /** Main content */
+        children: unknown | string;
+        /** Header actions (buttons, links) */
+        headerActions?: unknown | string;
+        /** Footer content */
+        footer?: unknown | string;
+        /** Additional class name */
+        className?: string;
+    };
+    'graph-canvas': {
+        type: 'graph-canvas';
+        /** Graph title */
+        title?: string;
+        /** Graph nodes */
+        nodes?: unknown | string;
+        /** Graph edges */
+        edges?: unknown | string;
+        /** Canvas height */
+        height?: number | string;
+        /** Show node labels */
+        showLabels?: boolean | string;
+        /** Enable zoom/pan */
+        interactive?: boolean | string;
+        /** Enable node dragging */
+        draggable?: boolean | string;
+        /** Actions */
+        actions?: unknown | string;
+        /** On node click */
+        onNodeClick?: ((...args: unknown[]) => unknown) | string;
+        /** Node click event */
+        nodeClickEvent?: string;
+        /** Layout algorithm */
+        layout?: string;
+        /** Entity name for schema-driven auto-fetch */
+        entity?: string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'grid': {
+        type: 'grid';
+        /** Number of columns (can be responsive object) */
+        cols?: unknown | unknown | string;
+        /** Number of rows */
+        rows?: number | string;
+        /** Gap between items */
+        gap?: unknown | string;
+        /** Row gap (overrides gap for rows) */
+        rowGap?: unknown | string;
+        /** Column gap (overrides gap for columns) */
+        colGap?: unknown | string;
+        /** Align items on block axis */
+        alignItems?: unknown | string;
+        /** Justify items on inline axis */
+        justifyItems?: unknown | string;
+        /** Auto-flow direction */
+        flow?: string;
+        /** Custom class name */
+        className?: string;
+        /** Inline styles */
+        style?: Record<string, unknown> | string;
+        /** Children elements */
+        children: unknown | string;
+        /** HTML element to render as */
+        as?: unknown | string;
+    };
+    'header': {
+        type: 'header';
+        /** Logo/Brand content */
+        logo?: unknown | string;
+        /** Logo image source */
+        logoSrc?: string;
+        /** Brand/App name */
+        brandName?: string;
+        /** Navigation items (for desktop header variant) */
+        navigationItems?: unknown[] | string;
+        /** Show menu toggle button @default true */
+        showMenuToggle?: boolean | string;
+        /** Is menu open (for toggle icon) */
+        isMenuOpen?: boolean | string;
+        /** Menu toggle callback */
+        onMenuToggle?: ((...args: unknown[]) => unknown) | string;
+        /** Show search input @default false */
+        showSearch?: boolean | string;
+        /** Search placeholder */
+        searchPlaceholder?: string;
+        /** Search callback */
+        onSearch?: ((...args: unknown[]) => unknown) | string;
+        /** User avatar configuration */
+        userAvatar?: Record<string, unknown> | string;
+        /** User name (display name or email) */
+        userName?: string;
+        /** Callback when user avatar is clicked */
+        onUserClick?: ((...args: unknown[]) => unknown) | string;
+        /** Action buttons (right side) */
+        actions?: unknown | string;
+        /** Sticky header @default true */
+        sticky?: boolean | string;
+        /** Variant - mobile shows menu toggle, desktop shows full nav @default 'mobile' */
+        variant?: string;
+        /** Callback when logo/brand is clicked */
+        onLogoClick?: ((...args: unknown[]) => unknown) | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'health-bar': {
+        type: 'health-bar';
+        /** Current health value */
+        current: number | string;
+        /** Maximum health value */
+        max: number | string;
+        /** Display format */
+        format?: string;
+        /** Size variant */
+        size?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Animation on change */
+        animated?: boolean | string;
+    };
+    'icon': {
+        type: 'icon';
+        /** Lucide icon component (preferred for type-safe usage) */
+        icon?: unknown | string;
+        /** Icon name as string (resolved from iconMap) */
+        name?: string;
+        /** Size of the icon */
+        size?: unknown | string;
+        /** Color class (Tailwind color class) or 'inherit' for theme default */
+        color?: string;
+        /** Animation type */
+        animation?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Icon stroke width - uses theme default if not specified */
+        strokeWidth?: number | string;
+        /** Inline style */
+        style?: Record<string, unknown> | string;
+    };
+    'input': {
+        type: 'input';
+        /** error prop */
+        error?: string;
+        /** leftIcon prop */
+        leftIcon?: unknown | string;
+        /** rightIcon prop */
+        rightIcon?: unknown | string;
+        /** Lucide icon component for left side (convenience prop) */
+        icon?: unknown | string;
+        /** Show clear button when input has value */
+        clearable?: boolean | string;
+        /** Callback when clear button is clicked */
+        onClear?: ((...args: unknown[]) => unknown) | string;
+        /** Options for select type */
+        options?: unknown[] | string;
+        /** Rows for textarea type */
+        rows?: number | string;
+        /** onChange handler - accepts events from input, select, or textarea */
+        onChange?: unknown | string;
+        /** Input type - supports 'select' and 'textarea' in addition to standard types */
+        inputType?: string;
+    };
+    'input-group': {
+        type: 'input-group';
+        /** Left addon (icon, button, or text) */
+        leftAddon?: unknown | unknown | string;
+        /** Right addon (icon, button, or text) */
+        rightAddon?: unknown | unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'inventory-panel': {
+        type: 'inventory-panel';
+        /** Array of items in inventory */
+        items: unknown[] | string;
+        /** Total number of slots */
+        slots: number | string;
+        /** Number of columns in grid */
+        columns: number | string;
+        /** Currently selected slot index */
+        selectedSlot?: number | string;
+        /** Called when a slot is selected */
+        onSelectSlot: ((...args: unknown[]) => unknown) | string;
+        /** Called when an item is used (double-click or Enter) */
+        onUseItem?: ((...args: unknown[]) => unknown) | string;
+        /** Called when an item is dropped */
+        onDropItem?: ((...args: unknown[]) => unknown) | string;
+        /** Show item tooltips on hover */
+        showTooltips?: boolean | string;
+        /** Optional className */
+        className?: string;
+        /** Slot size in pixels */
+        slotSize?: number | string;
+    };
+    'isometric-canvas': {
+        type: 'isometric-canvas';
+        /** --- Closed-circuit props (MANDATORY) --- */
+        className?: string;
+        /** Loading state indicator */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Entity name for schema-driven auto-fetch */
+        entity?: string;
+        /** --- Grid data --- */
+        tiles?: unknown[] | string;
+        /** Array of units on the board */
+        units?: unknown[] | string;
+        /** Array of features (resources, portals, buildings, etc.) */
+        features?: unknown[] | string;
+        /** --- Interaction state --- */
+        selectedUnitId?: string;
+        /** Valid move positions (shown as pulsing green highlights) */
+        validMoves?: unknown[] | string;
+        /** Attack target positions (shown as pulsing red highlights) */
+        attackTargets?: unknown[] | string;
+        /** Hovered tile position */
+        hoveredTile?: Record<string, unknown> | string;
+        /** --- Event handlers --- */
+        onTileClick?: ((...args: unknown[]) => unknown) | string;
+        /** Unit click handler */
+        onUnitClick?: ((...args: unknown[]) => unknown) | string;
+        /** Tile hover handler */
+        onTileHover?: ((...args: unknown[]) => unknown) | string;
+        /** Tile leave handler */
+        onTileLeave?: ((...args: unknown[]) => unknown) | string;
+        /** --- Rendering options --- */
+        scale?: number | string;
+        /** Show debug grid lines and coordinates */
+        debug?: boolean | string;
+        /** Background image URL tiled behind the isometric grid */
+        backgroundImage?: string;
+        /** Toggle minimap overlay */
+        showMinimap?: boolean | string;
+        /** Enable camera pan/zoom controls */
+        enableCamera?: boolean | string;
+        /** Extra scale multiplier for unit draw size. 1 = default. */
+        unitScale?: number | string;
+        /** --- Asset resolution (project-agnostic) --- */
+        getTerrainSprite?: ((...args: unknown[]) => unknown) | string;
+        /** Resolve feature sprite URL from feature type key */
+        getFeatureSprite?: ((...args: unknown[]) => unknown) | string;
+        /** Resolve unit static sprite URL */
+        getUnitSprite?: ((...args: unknown[]) => unknown) | string;
+        /** Resolve animated sprite sheet frame for a unit */
+        resolveUnitFrame?: ((...args: unknown[]) => unknown) | string;
+        /** Additional sprite URLs to preload (e.g., effect sprites) */
+        effectSpriteUrls?: unknown[] | string;
+        /** Callback to draw canvas effects after units */
+        onDrawEffects?: ((...args: unknown[]) => unknown) | string;
+        /** Whether there are active effects — keeps RAF loop alive */
+        hasActiveEffects?: boolean | string;
+        /** --- Remote asset loading --- */
+        assetBaseUrl?: string;
+        /** Manifest mapping entity keys to relative sprite paths. Combined with assetBaseUrl to produce full URLs. Used as a fallback when inline URLs and callbacks don't resolve. */
+        assetManifest?: Record<string, unknown> | string;
+    };
+    'label': {
+        type: 'label';
+        /** required prop */
+        required?: boolean | string;
+    };
+    'law-reference-tooltip': {
+        type: 'law-reference-tooltip';
+        /** The law reference to display */
+        reference: unknown | string;
+        /** Children element that triggers the tooltip */
+        children: unknown | string;
+        /** Tooltip position */
+        position?: string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'layout-pattern': {
+        type: 'layout-pattern';
+        /** Nested pattern configurations - rendered recursively */
+        children?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Inline styles */
+        style?: Record<string, unknown> | string;
+    };
+    'list-template': {
+        type: 'list-template';
+        /** Array of list items */
+        items: unknown[] | string;
+        /** Whether data is loading */
+        isLoading?: boolean | string;
+        /** Error object if loading failed */
+        error?: unknown | string;
+        /** Current filter value */
+        filter?: unknown | string;
+        /** Called when a new item is added */
+        onAdd?: ((...args: unknown[]) => unknown) | string;
+        /** Called when an item is toggled */
+        onToggle?: ((...args: unknown[]) => unknown) | string;
+        /** Called when an item is deleted */
+        onDelete?: ((...args: unknown[]) => unknown) | string;
+        /** Called when filter changes */
+        onFilterChange?: ((...args: unknown[]) => unknown) | string;
+        /** Called to retry loading */
+        onRetry?: ((...args: unknown[]) => unknown) | string;
+        /** Title displayed above the list */
+        title?: string;
+        /** Placeholder for the input field */
+        placeholder?: string;
+        /** Whether to show filter buttons */
+        showFilters?: boolean | string;
+        /** Whether to show item count */
+        showCount?: boolean | string;
+        /** Message shown when list is empty */
+        emptyMessage?: string;
+        /** Template variant */
+        variant?: unknown | string;
+        /** Additional class name */
+        className?: string;
+    };
+    'loading-state': {
+        type: 'loading-state';
+        /** title prop */
+        title?: string;
+        /** message prop */
+        message?: string;
+        /** className prop */
+        className?: string;
+    };
+    'master-detail': {
+        type: 'master-detail';
+        /** Master panel content (usually a list) */
+        master: unknown | string;
+        /** Detail panel content */
+        detail: unknown | string;
+        /** Content shown when nothing is selected */
+        emptyDetail?: unknown | string;
+        /** Whether an item is currently selected */
+        hasSelection?: boolean | string;
+        /** Width of master panel (e.g., '350px', '30%') */
+        masterWidth?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Class for master pane */
+        masterClassName?: string;
+        /** Class for detail pane */
+        detailClassName?: string;
+    };
+    'media-gallery': {
+        type: 'media-gallery';
+        /** Gallery title */
+        title?: string;
+        /** Media items */
+        items?: unknown | string;
+        /** Schema-driven data */
+        data?: unknown | string;
+        /** Column count */
+        columns?: number | string;
+        /** Enable item selection */
+        selectable?: boolean | string;
+        /** Selected item IDs */
+        selectedItems?: unknown | string;
+        /** Selection change callback */
+        onSelectionChange?: ((...args: unknown[]) => unknown) | string;
+        /** Show upload button */
+        showUpload?: boolean | string;
+        /** Actions */
+        actions?: unknown | string;
+        /** Aspect ratio for thumbnails */
+        aspectRatio?: string;
+        /** Entity name for schema-driven auto-fetch */
+        entity?: string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'menu': {
+        type: 'menu';
+        /** Menu trigger element */
+        trigger: unknown | string;
+        /** Menu items */
+        items: unknown[] | string;
+        /** Menu position */
+        position?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'meter': {
+        type: 'meter';
+        /** Current value */
+        value: number | string;
+        /** Minimum value */
+        min?: number | string;
+        /** Maximum value */
+        max?: number | string;
+        /** Display label */
+        label?: string;
+        /** Unit suffix (e.g., '%', 'MB', 'credits') */
+        unit?: string;
+        /** Display variant */
+        variant?: unknown | string;
+        /** Color thresholds */
+        thresholds?: unknown | string;
+        /** Number of segments (for segmented variant) */
+        segments?: number | string;
+        /** Show value text */
+        showValue?: boolean | string;
+        /** Size (for radial variant) */
+        size?: string;
+        /** Actions */
+        actions?: unknown | string;
+        /** Entity name for schema-driven auto-fetch */
+        entity?: string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'modal': {
+        type: 'modal';
+        /** Whether the modal is open (defaults to true when rendered by slot wrapper) */
+        isOpen?: boolean | string;
+        /** Callback when modal should close (injected by slot wrapper) */
+        onClose?: ((...args: unknown[]) => unknown) | string;
+        /** title prop */
+        title?: string;
+        /** Modal content (can be empty if using slot content) */
+        children?: unknown | string;
+        /** footer prop */
+        footer?: unknown | string;
+        /** size prop */
+        size?: unknown | string;
+        /** showCloseButton prop */
+        showCloseButton?: boolean | string;
+        /** closeOnOverlayClick prop */
+        closeOnOverlayClick?: boolean | string;
+        /** closeOnEscape prop */
+        closeOnEscape?: boolean | string;
+        /** className prop */
+        className?: string;
+    };
+    'modal-slot': {
+        type: 'modal-slot';
+        /** Content to display in the modal */
+        children?: unknown | string;
+        /** Override modal title (extracted from children if not provided) */
+        title?: string;
+        /** Modal size */
+        size?: string;
+        /** Custom class name */
+        className?: string;
+    };
+    'navigation': {
+        type: 'navigation';
+        /** Navigation items */
+        items: unknown[] | string;
+        /** Navigation orientation @default 'horizontal' */
+        orientation?: string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'notification': {
+        type: 'notification';
+        /** Toast variant */
+        variant?: unknown | string;
+        /** Toast message */
+        message: string;
+        /** Toast title (optional) */
+        title?: string;
+        /** Auto-dismiss duration in milliseconds (0 = no auto-dismiss) */
+        duration?: number | string;
+        /** Show dismiss button */
+        dismissible?: boolean | string;
+        /** Callback when toast is dismissed */
+        onDismiss?: ((...args: unknown[]) => unknown) | string;
+        /** Action button label */
+        actionLabel?: string;
+        /** Action button click handler */
+        onAction?: ((...args: unknown[]) => unknown) | string;
+        /** Badge count (optional) */
+        badge?: string | number;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'orbital-visualization': {
+        type: 'orbital-visualization';
+        /** Full KFlow schema object */
+        schema?: Record<string, unknown> | string;
+        /** Direct complexity override (1-100+) */
+        complexity?: number | string;
+        /** Size of the visualization */
+        size?: string;
+        /** Show complexity label */
+        showLabel?: boolean | string;
+        /** Animation enabled */
+        animated?: boolean | string;
+        /** Click handler */
+        onClick?: ((...args: unknown[]) => unknown) | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'overlay': {
+        type: 'overlay';
+        /** isVisible prop */
+        isVisible?: boolean | string;
+        /** onClick prop */
+        onClick?: ((...args: unknown[]) => unknown) | string;
+        /** className prop */
+        className?: string;
+        /** blur prop */
+        blur?: boolean | string;
+    };
+    'page-header': {
+        type: 'page-header';
+        /** Page title - accepts unknown to handle generated code accessing dynamic entity data */
+        title?: string | number | unknown;
+        /** Optional subtitle/description */
+        subtitle?: string | number | unknown;
+        /** Show back button */
+        showBack?: boolean | string;
+        /** Event to emit when back is clicked (default: BACK) */
+        backEvent?: string;
+        /** Breadcrumbs */
+        breadcrumbs?: unknown | string;
+        /** Status badge */
+        status?: Record<string, unknown> | string;
+        /** Actions array - first action with variant='primary' (or first action) is the main action */
+        actions?: unknown | string;
+        /** Loading state indicator */
+        isLoading?: boolean | string;
+        /** Tabs for sub-navigation */
+        tabs?: unknown[] | string;
+        /** activeTab prop */
+        activeTab?: string;
+        /** onTabChange prop */
+        onTabChange?: ((...args: unknown[]) => unknown) | string;
+        /** Custom content in the header */
+        children?: unknown | string;
+        /** className prop */
+        className?: string;
+    };
+    'pagination': {
+        type: 'pagination';
+        /** Current page (1-indexed) */
+        currentPage: number | string;
+        /** Total number of pages */
+        totalPages: number | string;
+        /** Callback when page changes (optional - can be a no-op if not interactive) */
+        onPageChange?: ((...args: unknown[]) => unknown) | string;
+        /** Show page size selector @default false */
+        showPageSize?: boolean | string;
+        /** Page size options */
+        pageSizeOptions?: unknown[] | string;
+        /** Current page size */
+        pageSize?: number | string;
+        /** Callback when page size changes */
+        onPageSizeChange?: ((...args: unknown[]) => unknown) | string;
+        /** Show jump to page input @default false */
+        showJumpToPage?: boolean | string;
+        /** Show total count @default false */
+        showTotal?: boolean | string;
+        /** Total items count */
+        totalItems?: number | string;
+        /** Maximum number of page buttons to show @default 7 */
+        maxVisiblePages?: number | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'popover': {
+        type: 'popover';
+        /** Popover content */
+        content: unknown | string;
+        /** Popover trigger element (ReactElement or ReactNode that will be wrapped in span) */
+        children: unknown | string;
+        /** Popover position @default 'bottom' */
+        position?: unknown | string;
+        /** Trigger type @default 'click' */
+        trigger?: unknown | string;
+        /** Show arrow @default true */
+        showArrow?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'progress-bar': {
+        type: 'progress-bar';
+        /** Progress value (0-100) */
+        value: number | string;
+        /** Maximum value (for calculating percentage) @default 100 */
+        max?: number | string;
+        /** Variant/color of the progress bar @default 'primary' */
+        variant?: unknown | string;
+        /** Color variant (alias for variant) @default 'primary' */
+        color?: unknown | string;
+        /** Show percentage text @default false */
+        showPercentage?: boolean | string;
+        /** Alias for showPercentage (pattern compatibility) */
+        showLabel?: boolean | string;
+        /** Label text */
+        label?: string;
+        /** Size (for circular variant) @default 'md' */
+        size?: string;
+        /** Number of steps (for stepped variant) @default 5 */
+        steps?: number | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Type of the progress bar (linear, circular, stepped) @default 'linear' */
+        progressType?: unknown | string;
+    };
+    'radio': {
+        type: 'radio';
+        /** Label text displayed next to the radio button */
+        label?: string;
+        /** Helper text displayed below the radio button */
+        helperText?: string;
+        /** Error message displayed below the radio button */
+        error?: string;
+        /** Size of the radio button @default 'md' */
+        size?: string;
+    };
+    'relation-select': {
+        type: 'relation-select';
+        /** Current value (ID) */
+        value?: string;
+        /** Callback when value changes */
+        onChange?: ((...args: unknown[]) => unknown) | string;
+        /** Available options - accepts readonly for compatibility with generated const arrays */
+        options: unknown | string;
+        /** Placeholder text */
+        placeholder?: string;
+        /** Whether the field is required */
+        required?: boolean | string;
+        /** Whether the field is disabled */
+        disabled?: boolean | string;
+        /** Whether data is loading */
+        isLoading?: boolean | string;
+        /** Error message */
+        error?: string;
+        /** Allow clearing the selection */
+        clearable?: boolean | string;
+        /** Name attribute for forms */
+        name?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Search placeholder */
+        searchPlaceholder?: string;
+        /** Empty state message */
+        emptyMessage?: string;
+    };
+    'repeatable-form-section': {
+        type: 'repeatable-form-section';
+        /** Section type identifier */
+        sectionType: string;
+        /** Section title */
+        title: string;
+        /** Items in the section */
+        items: unknown[] | string;
+        /** Render function for each item */
+        renderItem: ((...args: unknown[]) => unknown) | string;
+        /** Minimum items required */
+        minItems?: number | string;
+        /** Maximum items allowed */
+        maxItems?: number | string;
+        /** Allow reordering */
+        allowReorder?: boolean | string;
+        /** Add button label */
+        addLabel?: string;
+        /** Empty state message */
+        emptyMessage?: string;
+        /** Read-only mode */
+        readOnly?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Add handler */
+        onAdd?: ((...args: unknown[]) => unknown) | string;
+        /** Remove handler */
+        onRemove?: ((...args: unknown[]) => unknown) | string;
+        /** Reorder handler */
+        onReorder?: ((...args: unknown[]) => unknown) | string;
+        /** Inspection-specific enhancements */
+        trackAddedInState?: boolean | string;
+        /** Current inspection state (used when trackAddedInState is true) */
+        currentState?: string;
+        /** Show audit metadata (addedInState, addedAt) */
+        showAuditInfo?: boolean | string;
+    };
+    'runtime-debugger': {
+        type: 'runtime-debugger';
+        /** Initial position */
+        position?: string;
+        /** Initial collapsed state */
+        defaultCollapsed?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'score-display': {
+        type: 'score-display';
+        /** Current score value */
+        value: number | string;
+        /** Label to display before score */
+        label?: string;
+        /** Icon component or emoji */
+        icon?: unknown | string;
+        /** Size variant */
+        size?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Animation on value change */
+        animated?: boolean | string;
+        /** Number formatting locale */
+        locale?: string;
+    };
+    'search-input': {
+        type: 'search-input';
+        /** Search value (controlled mode) */
+        value?: string;
+        /** Callback when search value changes */
+        onSearch?: ((...args: unknown[]) => unknown) | string;
+        /** Debounce delay in milliseconds @default 300 */
+        debounceMs?: number | string;
+        /** Show loading state @default false */
+        isLoading?: boolean | string;
+        /** Placeholder text @default 'Search...' */
+        placeholder?: string;
+        /** Show clear button @default true */
+        clearable?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Event name to dispatch on search (schema metadata, wired by trait) This is metadata used by the trait generator, not by the component. */
+        event?: string;
+        /** Entity type for context-aware search. When provided, search events include entity context. */
+        entity?: string;
+        /** Query singleton binding for state management. When provided, syncs search state with the query singleton. Example: "@TaskQuery" */
+        query?: string;
+    };
+    'section': {
+        type: 'section';
+        /** Section title */
+        title?: string;
+        /** Section subtitle/description */
+        description?: string;
+        /** Action element (e.g., button, link) */
+        action?: unknown | string;
+        /** Padding amount */
+        padding?: unknown | string;
+        /** Visual variant */
+        variant?: unknown | string;
+        /** Show divider below header */
+        divider?: boolean | string;
+        /** Custom class name */
+        className?: string;
+        /** Children elements */
+        children: unknown | string;
+        /** Header custom class name */
+        headerClassName?: string;
+        /** Content custom class name */
+        contentClassName?: string;
+        /** HTML element to render as */
+        as?: unknown | string;
+    };
+    'select': {
+        type: 'select';
+        /** options prop */
+        options: unknown[] | string;
+        /** placeholder prop */
+        placeholder?: string;
+        /** error prop */
+        error?: string;
+    };
+    'settings-template': {
+        type: 'settings-template';
+        /** Current settings values */
+        settings: Record<string, unknown> | string;
+        /** Whether settings are being saved */
+        isSaving?: boolean | string;
+        /** Whether there are unsaved changes */
+        hasChanges?: boolean | string;
+        /** Error object if save failed */
+        error?: unknown | string;
+        /** Success message after save */
+        successMessage?: string;
+        /** Called when saving settings */
+        onSave?: ((...args: unknown[]) => unknown) | string;
+        /** Called when a setting value changes */
+        onChange?: ((...args: unknown[]) => unknown) | string;
+        /** Called to reset to default settings */
+        onReset?: ((...args: unknown[]) => unknown) | string;
+        /** Called to revert unsaved changes */
+        onRevert?: ((...args: unknown[]) => unknown) | string;
+        /** Called to dismiss success message */
+        onDismissSuccess?: ((...args: unknown[]) => unknown) | string;
+        /** Page title */
+        title?: string;
+        /** Settings sections */
+        sections?: unknown[] | string;
+        /** Whether to show reset to defaults button */
+        showResetToDefaults?: boolean | string;
+        /** Template variant */
+        variant?: unknown | string;
+        /** Additional class name */
+        className?: string;
+    };
+    'side-panel': {
+        type: 'side-panel';
+        /** Panel title */
+        title: string;
+        /** Panel content */
+        children: unknown | string;
+        /** Is panel open */
+        isOpen: boolean | string;
+        /** On close handler */
+        onClose: ((...args: unknown[]) => unknown) | string;
+        /** Panel width @default 'w-96' */
+        width?: string;
+        /** Panel position @default 'right' */
+        position?: string;
+        /** Show overlay on mobile @default true */
+        showOverlay?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'sidebar': {
+        type: 'sidebar';
+        /** Logo/Brand content - can be a ReactNode or logo config */
+        logo?: unknown | string;
+        /** Logo image source */
+        logoSrc?: string;
+        /** Brand/App name */
+        brandName?: string;
+        /** Navigation items */
+        items: unknown[] | string;
+        /** User section content */
+        userSection?: unknown | string;
+        /** Footer content (e.g., theme toggle) */
+        footerContent?: unknown | string;
+        /** Collapsed state (controlled) */
+        collapsed?: boolean | string;
+        /** Default collapsed state */
+        defaultCollapsed?: boolean | string;
+        /** Callback when collapse state changes */
+        onCollapseChange?: ((...args: unknown[]) => unknown) | string;
+        /** Hide the collapse/expand button */
+        hideCollapseButton?: boolean | string;
+        /** Show a close button (for mobile) */
+        showCloseButton?: boolean | string;
+        /** Callback when close button is clicked */
+        onClose?: ((...args: unknown[]) => unknown) | string;
+        /** Callback when logo/brand is clicked */
+        onLogoClick?: ((...args: unknown[]) => unknown) | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'signature-pad': {
+        type: 'signature-pad';
+        /** Label above the pad */
+        label?: string;
+        /** Helper text */
+        helperText?: string;
+        /** Stroke color */
+        strokeColor?: string;
+        /** Stroke width */
+        strokeWidth?: number | string;
+        /** Pad height */
+        height?: number | string;
+        /** Whether the pad is read-only */
+        readOnly?: boolean | string;
+        /** Existing signature image URL */
+        value?: string;
+        /** Callback when signature changes */
+        onChange?: ((...args: unknown[]) => unknown) | string;
+        /** Event to emit on sign */
+        signEvent?: string;
+        /** Event to emit on clear */
+        clearEvent?: string;
+        /** Entity name for schema-driven context */
+        entity?: string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'simple-grid': {
+        type: 'simple-grid';
+        /** Minimum width of each child (e.g., 200, "200px", "15rem") */
+        minChildWidth?: number | string;
+        /** Maximum number of columns */
+        maxCols?: number | string;
+        /** Exact number of columns (disables auto-fit) */
+        cols?: number | string;
+        /** Gap between items */
+        gap?: unknown | string;
+        /** Custom class name */
+        className?: string;
+        /** Children elements */
+        children: unknown | string;
+    };
+    'spacer': {
+        type: 'spacer';
+        /** Fixed size (auto = flex grow) */
+        size?: unknown | string;
+        /** Orientation (for fixed sizes) */
+        axis?: string;
+        /** Custom class name */
+        className?: string;
+    };
+    'spinner': {
+        type: 'spinner';
+        /** size prop */
+        size?: unknown | string;
+    };
+    'split': {
+        type: 'split';
+        /** Size ratio between left and right panels */
+        ratio?: unknown | string;
+        /** Gap between panels */
+        gap?: unknown | string;
+        /** Reverse the order (right first) */
+        reverse?: boolean | string;
+        /** Stack vertically on mobile */
+        stackOnMobile?: boolean | string;
+        /** Breakpoint to switch from stacked to side-by-side */
+        stackBreakpoint?: string;
+        /** Align items vertically */
+        align?: string;
+        /** Custom class name */
+        className?: string;
+        /** Left/first panel class name */
+        leftClassName?: string;
+        /** Right/second panel class name */
+        rightClassName?: string;
+        /** Exactly two children: [left, right] */
+        children: unknown | string;
+    };
+    'split-pane': {
+        type: 'split-pane';
+        /** Direction of the split */
+        direction?: string;
+        /** Initial ratio (0-100, percentage of first pane) */
+        ratio?: number | string;
+        /** Minimum size of either pane in pixels */
+        minSize?: number | string;
+        /** Allow user resizing */
+        resizable?: boolean | string;
+        /** Content for the left/top pane */
+        left: unknown | string;
+        /** Content for the right/bottom pane */
+        right: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Class for left/top pane */
+        leftClassName?: string;
+        /** Class for right/bottom pane */
+        rightClassName?: string;
+    };
+    'sprite': {
+        type: 'sprite';
+        /** Spritesheet image URL */
+        spritesheet: string;
+        /** Width of each frame in pixels */
+        frameWidth: number | string;
+        /** Height of each frame in pixels */
+        frameHeight: number | string;
+        /** Frame index to display (0-based, left-to-right, top-to-bottom) */
+        frame: number | string;
+        /** X position in pixels */
+        x: number | string;
+        /** Y position in pixels */
+        y: number | string;
+        /** Scale factor (default: 1) */
+        scale?: number | string;
+        /** Flip horizontally */
+        flipX?: boolean | string;
+        /** Flip vertically */
+        flipY?: boolean | string;
+        /** Rotation in degrees */
+        rotation?: number | string;
+        /** Opacity (0-1) */
+        opacity?: number | string;
+        /** Z-index for layering */
+        zIndex?: number | string;
+        /** Number of columns in spritesheet (for frame calculation) */
+        columns?: number | string;
+        /** Optional className */
+        className?: string;
+        /** Optional onClick handler */
+        onClick?: ((...args: unknown[]) => unknown) | string;
+    };
+    'stack': {
+        type: 'stack';
+        /** Stack direction */
+        direction?: unknown | string;
+        /** Gap between children */
+        gap?: unknown | string;
+        /** Align items on the cross axis */
+        align?: unknown | string;
+        /** Justify items on the main axis */
+        justify?: unknown | string;
+        /** Allow items to wrap */
+        wrap?: boolean | string;
+        /** Reverse the order of children */
+        reverse?: boolean | string;
+        /** Fill available space (flex: 1) */
+        flex?: boolean | string;
+        /** Custom class name */
+        className?: string;
+        /** Inline styles */
+        style?: Record<string, unknown> | string;
+        /** Children elements */
+        children?: unknown | string;
+        /** HTML element to render as */
+        as?: unknown | string;
+        /** Click handler */
+        onClick?: ((...args: unknown[]) => unknown) | string;
+        /** Keyboard handler */
+        onKeyDown?: ((...args: unknown[]) => unknown) | string;
+        /** Role for accessibility */
+        role?: string;
+        /** Tab index for focus management */
+        tabIndex?: number | string;
+    };
+    'stat-badge': {
+        type: 'stat-badge';
+        /** Stat label */
+        label: string;
+        /** Current value (defaults to 0 if not provided) */
+        value?: number | string;
+        /** Maximum value (for bar/hearts format) */
+        max?: number | string;
+        /** Data source entity name (for schema config) */
+        source?: string;
+        /** Field name in the source (for schema config) */
+        field?: string;
+        /** Display format */
+        format?: string;
+        /** Icon component or emoji */
+        icon?: unknown | string;
+        /** Size variant */
+        size?: string;
+        /** Visual variant */
+        variant?: string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'stats': {
+        type: 'stats';
+        /** Main label */
+        label?: string;
+        /** Title (alias for label) */
+        title?: string;
+        /** Primary value - accepts array/unknown from generated code (will use first element or length) */
+        value?: string | number | unknown[] | unknown;
+        /** Previous value for comparison */
+        previousValue?: number | string;
+        /** Current value as number for trend calculation */
+        currentValue?: number | string;
+        /** Manual trend percentage (overrides calculation) */
+        trend?: number | string;
+        /** Trend direction (overrides calculation) */
+        trendDirection?: string;
+        /** Whether up is good (green) or bad (red) */
+        invertTrend?: boolean | string;
+        /** Icon to display */
+        icon?: unknown | string;
+        /** Icon background color */
+        iconBg?: string;
+        /** Icon color */
+        iconColor?: string;
+        /** Subtitle or description */
+        subtitle?: string;
+        /** Action button */
+        action?: Record<string, unknown> | string;
+        /** className prop */
+        className?: string;
+        /** Schema-based props */
+        entity?: string;
+        /** Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays */
+        metrics?: unknown | string;
+        /** Data to calculate stats from - accepts readonly for compatibility with generated const arrays */
+        data?: unknown | string;
+        /** Loading state indicator */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+    };
+    'switch': {
+        type: 'switch';
+        /** checked prop */
+        checked?: boolean | string;
+        /** defaultChecked prop */
+        defaultChecked?: boolean | string;
+        /** onChange prop */
+        onChange?: ((...args: unknown[]) => unknown) | string;
+        /** disabled prop */
+        disabled?: boolean | string;
+        /** label prop */
+        label?: string;
+        /** id prop */
+        id?: string;
+        /** name prop */
+        name?: string;
+        /** className prop */
+        className?: string;
+    };
+    'tabbed-container': {
+        type: 'tabbed-container';
+        /** Tab definitions */
+        tabs: unknown[] | string;
+        /** Default active tab ID */
+        defaultTab?: string;
+        /** Controlled active tab */
+        activeTab?: string;
+        /** Callback when tab changes */
+        onTabChange?: ((...args: unknown[]) => unknown) | string;
+        /** Tab position */
+        position?: string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'table': {
+        type: 'table';
+        /** Table columns */
+        columns: unknown[] | string;
+        /** Table entity data */
+        entity: unknown[] | string;
+        /** Row key getter */
+        getRowKey: ((...args: unknown[]) => unknown) | string;
+        /** Enable row selection @default false */
+        selectable?: boolean | string;
+        /** Selected row keys */
+        selectedRows?: unknown[] | string;
+        /** Callback when selection changes */
+        onSelectionChange?: ((...args: unknown[]) => unknown) | string;
+        /** Enable sorting @default false */
+        sortable?: boolean | string;
+        /** Current sort column */
+        sortColumn?: string;
+        /** Current sort direction */
+        sortDirection?: unknown | string;
+        /** Callback when sort changes */
+        onSortChange?: ((...args: unknown[]) => unknown) | string;
+        /** Enable search/filter @default false */
+        searchable?: boolean | string;
+        /** Search placeholder */
+        searchPlaceholder?: string;
+        /** Enable pagination @default false */
+        paginated?: boolean | string;
+        /** Current page */
+        currentPage?: number | string;
+        /** Total pages */
+        totalPages?: number | string;
+        /** Callback when page changes */
+        onPageChange?: ((...args: unknown[]) => unknown) | string;
+        /** Row actions menu items */
+        rowActions?: ((...args: unknown[]) => unknown) | string;
+        /** Empty state message */
+        emptyMessage?: string;
+        /** Loading state @default false */
+        loading?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'tabs': {
+        type: 'tabs';
+        /** Tab items */
+        items?: unknown[] | string;
+        /** Tab items (alias for items - used by generated code) */
+        tabs?: unknown[] | string;
+        /** Default active tab ID */
+        defaultActiveTab?: string;
+        /** Controlled active tab ID */
+        activeTab?: string;
+        /** Callback when tab changes */
+        onTabChange?: ((...args: unknown[]) => unknown) | string;
+        /** Tab variant */
+        variant?: string;
+        /** Tab orientation */
+        orientation?: string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'text-highlight': {
+        type: 'text-highlight';
+        /** Whether the highlight is currently active/focused @default false */
+        isActive?: boolean | string;
+        /** Callback when highlight is clicked */
+        onClick?: ((...args: unknown[]) => unknown) | string;
+        /** Callback when highlight is hovered */
+        onMouseEnter?: ((...args: unknown[]) => unknown) | string;
+        /** Callback when hover ends */
+        onMouseLeave?: ((...args: unknown[]) => unknown) | string;
+        /** Unique ID for the annotation */
+        annotationId?: string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Highlighted text content */
+        children: unknown | string;
+        /** Type of highlight (determines color) */
+        highlightType: unknown | string;
+    };
+    'textarea': {
+        type: 'textarea';
+        /** error prop */
+        error?: string;
+    };
+    'theme-toggle': {
+        type: 'theme-toggle';
+        /** Additional CSS classes */
+        className?: string;
+        /** Size variant */
+        size?: string;
+        /** Show label text */
+        showLabel?: boolean | string;
+    };
+    'timeline': {
+        type: 'timeline';
+        /** Timeline title */
+        title?: string;
+        /** Timeline items */
+        items?: unknown | string;
+        /** Schema-driven data */
+        data?: unknown | string;
+        /** Fields to display */
+        fields?: unknown | string;
+        /** Actions per item */
+        itemActions?: unknown | string;
+        /** Entity name for schema-driven auto-fetch */
+        entity?: string;
+        /** Loading state */
+        isLoading?: boolean | string;
+        /** Error state */
+        error?: unknown | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'toast-slot': {
+        type: 'toast-slot';
+        /** Content to display in the toast (message or ReactNode) */
+        children?: unknown | string;
+        /** Toast variant */
+        variant?: unknown | string;
+        /** Toast title */
+        title?: string;
+        /** Auto-dismiss duration in ms (0 = no auto-dismiss) */
+        duration?: number | string;
+        /** Custom class name */
+        className?: string;
+    };
+    'tooltip': {
+        type: 'tooltip';
+        /** Tooltip content */
+        content: unknown | string;
+        /** Tooltip trigger element (ReactElement or ReactNode that will be wrapped in span) */
+        children: unknown | string;
+        /** Tooltip position */
+        position?: unknown | string;
+        /** Show delay in milliseconds */
+        delay?: number | string;
+        /** Hide delay in milliseconds */
+        hideDelay?: number | string;
+        /** Show arrow */
+        showArrow?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'typography': {
+        type: 'typography';
+        /** Typography variant */
+        variant?: unknown | string;
+        /** Heading level (1-6) - alternative to variant for headings */
+        level?: number | string;
+        /** Text color */
+        color?: string;
+        /** Text alignment */
+        align?: string;
+        /** Font weight override */
+        weight?: string;
+        /** Font size override */
+        size?: unknown | string;
+        /** Truncate with ellipsis (single line) */
+        truncate?: boolean | string;
+        /** Overflow handling mode */
+        overflow?: string;
+        /** Custom HTML element */
+        as?: unknown | string;
+        /** HTML id attribute */
+        id?: string;
+        /** Additional class names */
+        className?: string;
+        /** Inline style */
+        style?: Record<string, unknown> | string;
+        /** Text content (alternative to children) */
+        content?: unknown | string;
+        /** Children elements */
+        children?: unknown | string;
+    };
+    'u-i-slot-renderer': {
+        type: 'u-i-slot-renderer';
+        /** Include HUD slots */
+        includeHud?: boolean | string;
+        /** Include floating slot */
+        includeFloating?: boolean | string;
+        /** Additional class name for the container */
+        className?: string;
+    };
+    'violation-alert': {
+        type: 'violation-alert';
+        /** Violation data */
+        violation: unknown | string;
+        /** Visual severity (derived from actionType if not specified) */
+        severity?: string;
+        /** Dismissible alert */
+        dismissible?: boolean | string;
+        /** Dismiss handler */
+        onDismiss?: ((...args: unknown[]) => unknown) | string;
+        /** Navigate to the field that caused violation */
+        onNavigateToField?: ((...args: unknown[]) => unknown) | string;
+        /** Compact display mode */
+        compact?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'wizard-container': {
+        type: 'wizard-container';
+        /** Wizard steps */
+        steps: unknown[] | string;
+        /** Current step index (controlled) - accepts unknown for generated code compatibility */
+        currentStep?: number | string | unknown;
+        /** Callback when step changes */
+        onStepChange?: ((...args: unknown[]) => unknown) | string;
+        /** Callback when wizard is completed */
+        onComplete?: ((...args: unknown[]) => unknown) | string;
+        /** Show progress indicator */
+        showProgress?: boolean | string;
+        /** Allow navigation to previous steps */
+        allowBack?: boolean | string;
+        /** Modal mode (compact header, no padding) */
+        compact?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+        /** Entity type name (schema-driven) */
+        entity?: string;
+    };
+    'wizard-navigation': {
+        type: 'wizard-navigation';
+        /** Current step index (0-based) */
+        currentStep: number | string;
+        /** Total number of steps */
+        totalSteps: number | string;
+        /** Whether the current step is valid (enables Next/Complete) */
+        isValid?: boolean | string;
+        /** Show the Back button */
+        showBack?: boolean | string;
+        /** Show the Next button */
+        showNext?: boolean | string;
+        /** Show the Complete button (on last step) */
+        showComplete?: boolean | string;
+        /** Custom label for Back button */
+        backLabel?: string;
+        /** Custom label for Next button */
+        nextLabel?: string;
+        /** Custom label for Complete button */
+        completeLabel?: string;
+        /** Event to emit on Back click */
+        onBack?: string;
+        /** Event to emit on Next click */
+        onNext?: string;
+        /** Event to emit on Complete click */
+        onComplete?: string;
+        /** Direct callback for Back (alternative to event) */
+        onBackClick?: ((...args: unknown[]) => unknown) | string;
+        /** Direct callback for Next (alternative to event) */
+        onNextClick?: ((...args: unknown[]) => unknown) | string;
+        /** Direct callback for Complete (alternative to event) */
+        onCompleteClick?: ((...args: unknown[]) => unknown) | string;
+        /** Compact mode (smaller padding) */
+        compact?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'wizard-progress': {
+        type: 'wizard-progress';
+        /** Step definitions (compatible with WizardContainer's WizardStep) */
+        steps: unknown[] | string;
+        /** Current step index (0-based) */
+        currentStep: number | string;
+        /** Callback when a completed step is clicked */
+        onStepClick?: ((...args: unknown[]) => unknown) | string;
+        /** Allow clicking on completed steps to navigate back */
+        allowNavigation?: boolean | string;
+        /** Compact mode (smaller, no titles) */
+        compact?: boolean | string;
+        /** Additional CSS classes */
+        className?: string;
+    };
+    'world-map-template': {
+        type: 'world-map-template';
+        /** All map hexes (with pre-resolved terrain sprites) */
+        hexes: unknown[] | string;
+        /** Heroes on the map */
+        heroes: unknown[] | string;
+        /** Features rendered on tiles */
+        features?: unknown[] | string;
+        /** Currently selected hero ID */
+        selectedHeroId?: string;
+        /** Canvas render scale */
+        scale?: number | string;
+        /** Unit draw-size multiplier */
+        unitScale?: number | string;
+        /** Asset manifest for IsometricCanvas */
+        assetManifest?: Record<string, unknown> | string;
+        /** Background image URL */
+        backgroundImage?: string;
+        /** Allow selecting / moving ALL heroes (including enemy). For testing. */
+        allowMoveAllHeroes?: boolean | string;
+        /** Custom movement range validator */
+        isInRange?: ((...args: unknown[]) => unknown) | string;
+        /** -- Slots -- */
+        header?: ((...args: unknown[]) => unknown) | string;
+        /** Side panel (hero detail, hero lists, etc.) */
+        sidePanel?: ((...args: unknown[]) => unknown) | string;
+        /** Canvas overlay (tooltips, popups) */
+        overlay?: ((...args: unknown[]) => unknown) | string;
+        /** Footer */
+        footer?: ((...args: unknown[]) => unknown) | string;
+        /** -- Callbacks -- */
+        onHeroSelect?: ((...args: unknown[]) => unknown) | string;
+        /** onHeroMove prop */
+        onHeroMove?: ((...args: unknown[]) => unknown) | string;
+        /** Called when hero clicks an enemy hero tile */
+        onBattleEncounter?: ((...args: unknown[]) => unknown) | string;
+        /** Called when hero enters a feature hex (castle, resource, etc.) */
+        onFeatureEnter?: ((...args: unknown[]) => unknown) | string;
+        /** -- Canvas pass-through -- */
+        effectSpriteUrls?: unknown[] | string;
+        /** resolveUnitFrame prop */
+        resolveUnitFrame?: ((...args: unknown[]) => unknown) | string;
+        /** className prop */
+        className?: string;
+    };
+}
+/**
+ * Get the props type for a specific pattern.
+ *
+ * @example
+ * type TableProps = PatternProps<'entity-table'>;
+ * // { type: 'entity-table'; columns: unknown[]; data?: Record<string, unknown>; ... }
+ */
+export type PatternProps<T extends PatternType> = PatternPropsMap[T];
+/**
+ * Type-safe pattern configuration.
+ * The props are validated based on the pattern type.
+ *
+ * @example
+ * // ✅ Valid
+ * const config: PatternConfig<'entity-table'> = {
+ *   type: 'entity-table',
+ *   columns: ['name', 'email']
+ * };
+ *
+ * // ❌ Error: Property 'columns' is missing
+ * const bad: PatternConfig<'entity-table'> = { type: 'entity-table' };
+ */
+export type PatternConfig<T extends PatternType = PatternType> = PatternPropsMap[T];
+/**
+ * Discriminated union of all pattern configs.
+ * Use when the pattern type is not known statically.
+ */
+export type AnyPatternConfig = PatternPropsMap[PatternType];
+/**
+ * Array of all pattern type names (for runtime validation)
+ */
+export declare const PATTERN_TYPES: PatternType[];
+/**
+ * Check if a string is a valid pattern type
+ */
+export declare function isValidPatternType(type: string): type is PatternType;