@almadar/patterns 1.0.14 → 1.1.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-10T05:45:36.769Z",
+  exportedAt: "2026-02-10T15:35:56.769Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -882,62 +882,188 @@ var patterns_registry_default = {
     "form-section": {
       type: "form-section",
       category: "form",
-      description: "Group of related input fields",
+      description: "Alias for form \u2014 Complete form with fields and actions",
       suggestedFor: [
         "create forms",
         "edit forms",
-        "settings"
+        "data entry"
       ],
-      typicalSize: "small",
+      typicalSize: "medium",
       propsSchema: {
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Form fields (traditional React children)"
+        },
+        onSubmit: {
+          types: [
+            "function",
+            "string"
+          ],
+          description: "Submit handler - receives form data, or event name string for trait dispatch"
+        },
+        onCancel: {
+          types: [
+            "function",
+            "string"
+          ],
+          description: "Cancel handler - function or event name string for trait dispatch"
+        },
+        layout: {
+          types: [
+            "string"
+          ],
+          description: "Form layout"
+        },
+        gap: {
+          types: [
+            "string"
+          ],
+          description: "Gap between fields"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes"
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "Schema-based props"
+        },
+        mode: {
+          types: [
+            "string"
+          ],
+          description: "Form mode - 'create' for new records, 'edit' for updating existing"
+        },
+        fields: {
+          types: [
+            "unknown"
+          ],
+          description: "Fields definition (schema format) - accepts readonly for generated const arrays"
+        },
+        initialData: {
+          types: [
+            "object",
+            "unknown"
+          ],
+          description: "Initial form data"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "Loading state"
+        },
+        error: {
+          types: [
+            "error"
+          ],
+          description: "Error state"
+        },
+        submitLabel: {
+          types: [
+            "string"
+          ],
+          description: "Submit button label"
+        },
+        cancelLabel: {
+          types: [
+            "string"
+          ],
+          description: "Cancel button label (if provided, shows cancel button)"
+        },
+        showCancel: {
+          types: [
+            "boolean"
+          ],
+          description: "Show cancel button (defaults to true for schema forms)"
+        },
         title: {
           types: [
             "string"
           ],
-          description: "Section title"
+          description: "Form title (used by ModalSlot to extract title)"
         },
-        description: {
+        submitEvent: {
           types: [
             "string"
           ],
-          description: "Section description"
+          description: "Event dispatch props (for trait state machine integration)"
         },
-        children: {
+        cancelEvent: {
           types: [
-            "node"
+            "string"
           ],
-          description: "Form fields",
-          required: true
+          description: "Event to dispatch on cancel (defaults to 'CANCEL')"
+        },
+        relationsData: {
+          types: [
+            "object"
+          ],
+          description: "Relation data props"
+        },
+        relationsLoading: {
+          types: [
+            "object"
+          ],
+          description: "Loading state for relation data: { fieldName: boolean }"
         },
-        collapsible: {
+        conditionalFields: {
           types: [
+            "object",
             "boolean"
           ],
-          description: "Collapsible"
+          description: "Inspection form extensions"
         },
-        defaultCollapsed: {
+        hiddenCalculations: {
           types: [
+            "array",
             "boolean"
           ],
-          description: "Default collapsed state"
+          description: "Hidden calculations that emit GLOBAL_VARIABLE_SET on field change (boolean true means enabled but config loaded separately)"
         },
-        card: {
+        violationTriggers: {
           types: [
+            "array",
             "boolean"
           ],
-          description: "Use card wrapper"
+          description: "Violation conditions that emit VIOLATION_DETECTED when met (boolean true means enabled but config loaded separately)"
         },
-        columns: {
+        evaluationContext: {
           types: [
-            "number"
+            "formevaluationcontext",
+            "object"
           ],
-          description: "Grid columns for fields"
+          description: "Context for S-expression evaluation - accepts flexible types from generated code"
         },
-        className: {
+        sections: {
+          types: [
+            "array"
+          ],
+          description: "Nested form sections with optional conditions"
+        },
+        onFieldChange: {
+          types: [
+            "function"
+          ],
+          description: "Callback when any field value changes"
+        },
+        configPath: {
           types: [
             "string"
           ],
-          description: "className prop"
+          description: "Config path for form configuration (schema-driven)"
+        },
+        repeatable: {
+          types: [
+            "boolean"
+          ],
+          description: "Whether the form supports repeatable entries"
         }
       }
     },
@@ -8183,7 +8309,7 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Duration in ms before auto-dismiss (default 800)"
+          description: "Duration in ms before auto-dismiss (default 2000 for canvas, 800 for emoji)"
         },
         intensity: {
           types: [
@@ -8226,6 +8352,24 @@ var patterns_registry_default = {
             "string"
           ],
           description: "Base URL for remote assets. Prepended to relative effectSpriteUrl paths."
+        },
+        assetManifest: {
+          types: [
+            "effectassetmanifest"
+          ],
+          description: "Full effect asset manifest for the sprite particle engine. When provided, enables the canvas-based particle system."
+        },
+        width: {
+          types: [
+            "number"
+          ],
+          description: "Canvas width (default 400)"
+        },
+        height: {
+          types: [
+            "number"
+          ],
+          description: "Canvas height (default 300)"
         }
       }
     },
@@ -8421,78 +8565,661 @@ var patterns_registry_default = {
           description: "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."
         }
       }
-    }
-  },
-  categories: [
-    "display",
-    "header",
-    "form",
-    "filter",
-    "navigation",
-    "state",
-    "dashboard",
-    "container",
-    "layout",
-    "game",
-    "debug",
-    "meta",
-    "component",
-    "template",
-    "visualization",
-    "media"
-  ]
-};
-
-// src/integrators-registry.json
-var integrators_registry_default = {
-  version: "1.0.0",
-  exportedAt: "2026-01-25T00:58:14.172Z",
-  integrators: {
-    youtube: {
-      name: "youtube",
-      description: "YouTube Data API - search videos, get video/channel details",
-      category: "media",
-      actions: [
-        {
-          name: "search",
-          description: "Search for videos",
-          params: [
-            {
-              name: "query",
-              type: "string",
-              required: true,
-              description: "Search query"
-            },
-            {
-              name: "maxResults",
-              type: "number",
-              required: false,
-              description: "Max results (1-50)"
-            },
-            {
-              name: "type",
-              type: "string",
-              required: false,
-              description: "video, channel, or playlist"
-            }
+    },
+    "battle-template": {
+      type: "battle-template",
+      category: "template",
+      description: "BattleTemplate  Generalized tactical battle template composing IsometricCanvas from almadar-ui. Provides turn-based phase management, movement animation, valid-move/attack-target calculation, screen shake/flash, and a game-over overlay.  Game-specific UI (combat log, trait viewer, damage popups, etc.) is injected via render-prop slots so this template remains project-agnostic.",
+      suggestedFor: [
+        "battle",
+        "template",
+        "battle template"
+      ],
+      typicalSize: "full",
+      propsSchema: {
+        initialUnits: {
+          types: [
+            "array"
           ],
-          responseShape: {
-            videoId: "string",
-            title: "string",
-            thumbnail: "string",
-            description: "string"
-          }
+          description: "Initial units for the battle",
+          required: true
         },
-        {
-          name: "getVideo",
-          description: "Get video details by ID",
-          params: [
-            {
-              name: "videoId",
-              type: "string",
-              required: true,
-              description: "YouTube video ID"
-            }
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Isometric tiles (pre-resolved with terrainSprite)",
+          required: true
+        },
+        scale: {
+          types: [
+            "number"
+          ],
+          description: "Canvas render scale"
+        },
+        boardWidth: {
+          types: [
+            "number"
+          ],
+          description: "Board width for bounds checking"
+        },
+        boardHeight: {
+          types: [
+            "number"
+          ],
+          description: "Board height for bounds checking"
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Asset manifest for IsometricCanvas"
+        },
+        backgroundImage: {
+          types: [
+            "string"
+          ],
+          description: "Background image URL for canvas"
+        },
+        unitScale: {
+          types: [
+            "number"
+          ],
+          description: "Unit draw-size multiplier"
+        },
+        header: {
+          types: [
+            "function"
+          ],
+          description: "-- Slots --"
+        },
+        sidebar: {
+          types: [
+            "function"
+          ],
+          description: "Sidebar content (combat log, unit roster, etc.)"
+        },
+        actions: {
+          types: [
+            "function"
+          ],
+          description: "Floating action buttons"
+        },
+        overlay: {
+          types: [
+            "function"
+          ],
+          description: "Floating overlays above the canvas (damage popups, tooltips)"
+        },
+        gameOverOverlay: {
+          types: [
+            "function"
+          ],
+          description: "Game-over screen overlay"
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "-- Obstacle features --"
+        },
+        onAttack: {
+          types: [
+            "function"
+          ],
+          description: "-- Callbacks --"
+        },
+        onGameEnd: {
+          types: [
+            "function"
+          ],
+          description: "Called when battle ends"
+        },
+        onUnitMove: {
+          types: [
+            "function"
+          ],
+          description: "Called after a unit moves"
+        },
+        calculateDamage: {
+          types: [
+            "function"
+          ],
+          description: "Custom combat damage calculator"
+        },
+        onDrawEffects: {
+          types: [
+            "function"
+          ],
+          description: "-- Canvas pass-through --"
+        },
+        hasActiveEffects: {
+          types: [
+            "boolean"
+          ],
+          description: "hasActiveEffects prop"
+        },
+        effectSpriteUrls: {
+          types: [
+            "array"
+          ],
+          description: "effectSpriteUrls prop"
+        },
+        resolveUnitFrame: {
+          types: [
+            "function"
+          ],
+          description: "resolveUnitFrame prop"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "castle-template": {
+      type: "castle-template",
+      category: "template",
+      description: "CastleTemplate  Generalized castle / base-management template composing IsometricCanvas from almadar-ui. Renders an isometric courtyard/base view and exposes a side-panel area via slots for game-specific UI (building details, recruitment, garrison).",
+      suggestedFor: [
+        "castle",
+        "template",
+        "castle template"
+      ],
+      typicalSize: "full",
+      propsSchema: {
+        tiles: {
+          types: [
+            "array"
+          ],
+          description: "Isometric tiles (pre-resolved with terrainSprite)",
+          required: true
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Building features rendered on the grid"
+        },
+        units: {
+          types: [
+            "array"
+          ],
+          description: "Garrison / stationed units on the grid"
+        },
+        scale: {
+          types: [
+            "number"
+          ],
+          description: "Canvas render scale"
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Asset manifest for IsometricCanvas"
+        },
+        backgroundImage: {
+          types: [
+            "string"
+          ],
+          description: "Background image URL"
+        },
+        header: {
+          types: [
+            "function"
+          ],
+          description: "-- Slots --"
+        },
+        sidePanel: {
+          types: [
+            "function"
+          ],
+          description: "Side panel content (buildings list, recruit tab, garrison tab)"
+        },
+        overlay: {
+          types: [
+            "function"
+          ],
+          description: "Canvas overlay (hover tooltips, etc.)"
+        },
+        footer: {
+          types: [
+            "function"
+          ],
+          description: "Bottom bar (income summary, etc.)"
+        },
+        onFeatureClick: {
+          types: [
+            "function"
+          ],
+          description: "-- Callbacks --"
+        },
+        onUnitClick: {
+          types: [
+            "function"
+          ],
+          description: "Called when a unit is clicked"
+        },
+        onTileClick: {
+          types: [
+            "function"
+          ],
+          description: "Called when any tile is clicked"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    "world-map-template": {
+      type: "world-map-template",
+      category: "template",
+      description: "WorldMapTemplate  Generalized strategic world-map template composing IsometricCanvas from almadar-ui. Renders an isometric hex/iso map with hero selection, movement animation, and encounter callbacks. Game-specific panels (hero detail, hero lists, resource bars) are injected via render-prop slots.",
+      suggestedFor: [
+        "world",
+        "map",
+        "template",
+        "world map template"
+      ],
+      typicalSize: "full",
+      propsSchema: {
+        hexes: {
+          types: [
+            "array"
+          ],
+          description: "All map hexes (with pre-resolved terrain sprites)",
+          required: true
+        },
+        heroes: {
+          types: [
+            "array"
+          ],
+          description: "Heroes on the map",
+          required: true
+        },
+        features: {
+          types: [
+            "array"
+          ],
+          description: "Features rendered on tiles"
+        },
+        selectedHeroId: {
+          types: [
+            "string"
+          ],
+          description: "Currently selected hero ID"
+        },
+        scale: {
+          types: [
+            "number"
+          ],
+          description: "Canvas render scale"
+        },
+        unitScale: {
+          types: [
+            "number"
+          ],
+          description: "Unit draw-size multiplier"
+        },
+        assetManifest: {
+          types: [
+            "object"
+          ],
+          description: "Asset manifest for IsometricCanvas"
+        },
+        backgroundImage: {
+          types: [
+            "string"
+          ],
+          description: "Background image URL"
+        },
+        allowMoveAllHeroes: {
+          types: [
+            "boolean"
+          ],
+          description: "Allow selecting / moving ALL heroes (including enemy). For testing."
+        },
+        isInRange: {
+          types: [
+            "function"
+          ],
+          description: "Custom movement range validator"
+        },
+        header: {
+          types: [
+            "function"
+          ],
+          description: "-- Slots --"
+        },
+        sidePanel: {
+          types: [
+            "function"
+          ],
+          description: "Side panel (hero detail, hero lists, etc.)"
+        },
+        overlay: {
+          types: [
+            "function"
+          ],
+          description: "Canvas overlay (tooltips, popups)"
+        },
+        footer: {
+          types: [
+            "function"
+          ],
+          description: "Footer"
+        },
+        onHeroSelect: {
+          types: [
+            "function"
+          ],
+          description: "-- Callbacks --"
+        },
+        onHeroMove: {
+          types: [
+            "function"
+          ],
+          description: "onHeroMove prop"
+        },
+        onBattleEncounter: {
+          types: [
+            "function"
+          ],
+          description: "Called when hero clicks an enemy hero tile"
+        },
+        onFeatureEnter: {
+          types: [
+            "function"
+          ],
+          description: "Called when hero enters a feature hex (castle, resource, etc.)"
+        },
+        effectSpriteUrls: {
+          types: [
+            "array"
+          ],
+          description: "-- Canvas pass-through --"
+        },
+        resolveUnitFrame: {
+          types: [
+            "function"
+          ],
+          description: "resolveUnitFrame prop"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        }
+      }
+    },
+    heading: {
+      type: "heading",
+      category: "component",
+      description: "Alias for typography \u2014 Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
+      suggestedFor: [
+        "typography"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        variant: {
+          types: [
+            "typographyvariant"
+          ],
+          description: "Typography variant"
+        },
+        level: {
+          types: [
+            "number"
+          ],
+          description: "Heading level (1-6) - alternative to variant for headings"
+        },
+        color: {
+          types: [
+            "string"
+          ],
+          description: "Text color"
+        },
+        align: {
+          types: [
+            "string"
+          ],
+          description: "Text alignment"
+        },
+        weight: {
+          types: [
+            "string"
+          ],
+          description: "Font weight override"
+        },
+        size: {
+          types: [
+            "typographysize"
+          ],
+          description: "Font size override"
+        },
+        truncate: {
+          types: [
+            "boolean"
+          ],
+          description: "Truncate with ellipsis (single line)"
+        },
+        overflow: {
+          types: [
+            "string"
+          ],
+          description: "Overflow handling mode"
+        },
+        as: {
+          types: [
+            "unknown"
+          ],
+          description: "Custom HTML element"
+        },
+        id: {
+          types: [
+            "string"
+          ],
+          description: "HTML id attribute"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional class names"
+        },
+        style: {
+          types: [
+            "object"
+          ],
+          description: "Inline style"
+        },
+        content: {
+          types: [
+            "node"
+          ],
+          description: "Text content (alternative to children)"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Children elements"
+        }
+      }
+    },
+    text: {
+      type: "text",
+      category: "component",
+      description: "Alias for typography \u2014 Typography Atom Component  Text elements following the KFlow design system with theme-aware styling.",
+      suggestedFor: [
+        "typography"
+      ],
+      typicalSize: "small",
+      propsSchema: {
+        variant: {
+          types: [
+            "typographyvariant"
+          ],
+          description: "Typography variant"
+        },
+        level: {
+          types: [
+            "number"
+          ],
+          description: "Heading level (1-6) - alternative to variant for headings"
+        },
+        color: {
+          types: [
+            "string"
+          ],
+          description: "Text color"
+        },
+        align: {
+          types: [
+            "string"
+          ],
+          description: "Text alignment"
+        },
+        weight: {
+          types: [
+            "string"
+          ],
+          description: "Font weight override"
+        },
+        size: {
+          types: [
+            "typographysize"
+          ],
+          description: "Font size override"
+        },
+        truncate: {
+          types: [
+            "boolean"
+          ],
+          description: "Truncate with ellipsis (single line)"
+        },
+        overflow: {
+          types: [
+            "string"
+          ],
+          description: "Overflow handling mode"
+        },
+        as: {
+          types: [
+            "unknown"
+          ],
+          description: "Custom HTML element"
+        },
+        id: {
+          types: [
+            "string"
+          ],
+          description: "HTML id attribute"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional class names"
+        },
+        style: {
+          types: [
+            "object"
+          ],
+          description: "Inline style"
+        },
+        content: {
+          types: [
+            "node"
+          ],
+          description: "Text content (alternative to children)"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Children elements"
+        }
+      }
+    }
+  },
+  categories: [
+    "display",
+    "header",
+    "form",
+    "filter",
+    "navigation",
+    "state",
+    "dashboard",
+    "container",
+    "layout",
+    "game",
+    "debug",
+    "meta",
+    "component",
+    "template",
+    "visualization",
+    "media"
+  ]
+};
+
+// src/integrators-registry.json
+var integrators_registry_default = {
+  version: "1.0.0",
+  exportedAt: "2026-01-25T00:58:14.172Z",
+  integrators: {
+    youtube: {
+      name: "youtube",
+      description: "YouTube Data API - search videos, get video/channel details",
+      category: "media",
+      actions: [
+        {
+          name: "search",
+          description: "Search for videos",
+          params: [
+            {
+              name: "query",
+              type: "string",
+              required: true,
+              description: "Search query"
+            },
+            {
+              name: "maxResults",
+              type: "number",
+              required: false,
+              description: "Max results (1-50)"
+            },
+            {
+              name: "type",
+              type: "string",
+              required: false,
+              description: "video, channel, or playlist"
+            }
+          ],
+          responseShape: {
+            videoId: "string",
+            title: "string",
+            thumbnail: "string",
+            description: "string"
+          }
+        },
+        {
+          name: "getVideo",
+          description: "Get video details by ID",
+          params: [
+            {
+              name: "videoId",
+              type: "string",
+              required: true,
+              description: "YouTube video ID"
+            }
           ],
           responseShape: {
             title: "string",
@@ -8948,7 +9675,7 @@ var integrators_registry_default = {
 // src/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-10T05:45:36.769Z",
+  exportedAt: "2026-02-10T15:35:56.769Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -8986,7 +9713,7 @@ var component_mapping_default = {
       category: "form"
     },
     "form-section": {
-      component: "FormSection",
+      component: "Form",
       importPath: "@/components/organisms/Form",
       category: "form"
     },
@@ -9587,6 +10314,31 @@ var component_mapping_default = {
       component: "IsometricCanvas",
       importPath: "@/components/organisms/IsometricCanvas",
       category: "game"
+    },
+    "battle-template": {
+      component: "BattleTemplate",
+      importPath: "@/components/templates/BattleTemplate",
+      category: "template"
+    },
+    "castle-template": {
+      component: "CastleTemplate",
+      importPath: "@/components/templates/CastleTemplate",
+      category: "template"
+    },
+    "world-map-template": {
+      component: "WorldMapTemplate",
+      importPath: "@/components/templates/WorldMapTemplate",
+      category: "template"
+    },
+    heading: {
+      component: "Typography",
+      importPath: "@/components/atoms/Typography",
+      category: "component"
+    },
+    text: {
+      component: "Typography",
+      importPath: "@/components/atoms/Typography",
+      category: "component"
     }
   }
 };
@@ -9594,7 +10346,7 @@ var component_mapping_default = {
 // src/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-02-10T05:45:36.769Z",
+  exportedAt: "2026-02-10T15:35:56.769Z",
   contracts: {
     form: {
       emits: [
@@ -9636,17 +10388,31 @@ var event_contracts_default = {
     "form-section": {
       emits: [
         {
-          event: "SAVE",
-          trigger: "submit",
+          event: "GLOBAL_VARIABLE_SET",
+          trigger: "action",
           payload: {
-            type: "FormData"
+            type: "object"
           }
         },
         {
-          event: "CANCEL",
-          trigger: "click",
+          event: "VIOLATION_DETECTED",
+          trigger: "action",
           payload: {
-            type: "void"
+            type: "object"
+          }
+        },
+        {
+          event: "FIELD_CHANGED",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "CLOSE",
+          trigger: "action",
+          payload: {
+            type: "object"
           }
         }
       ],
@@ -9654,7 +10420,7 @@ var event_contracts_default = {
         "SAVE",
         "CANCEL"
       ],
-      entityAware: false
+      entityAware: true
     },
     "form-actions": {
       emits: [
@@ -10518,12 +11284,14 @@ var PATTERN_TYPES = [
   "auth-layout",
   "avatar",
   "badge",
+  "battle-template",
   "box",
   "breadcrumb",
   "button",
   "button-pattern",
   "canvas-effect",
   "card",
+  "castle-template",
   "center",
   "chart",
   "checkbox",
@@ -10628,7 +11396,8 @@ var PATTERN_TYPES = [
   "violation-alert",
   "wizard-container",
   "wizard-navigation",
-  "wizard-progress"
+  "wizard-progress",
+  "world-map-template"
 ];
 function isValidPatternType(type) {
   return PATTERN_TYPES.includes(type);
@@ -10715,6 +11484,161 @@ function getPatternMetadata(patternType) {
   return patterns[patternType] || null;
 }
 
+// src/helpers/pattern-recommender.ts
+var DOMAIN_KEYWORDS = {
+  business: ["admin panels", "data-dense views", "list pages", "data entry", "comparisons"],
+  dashboard: ["dashboards", "analytics", "overview pages", "overview screens", "data visualization", "reporting", "KPI indicators"],
+  "e-commerce": ["visual items", "images", "previews", "data entry", "list pages"],
+  content: ["visual items", "images", "previews", "media", "pages with multiple views"],
+  social: ["activity logs", "visual items", "previews"],
+  workflow: ["process tracking", "workflow steps", "multi-step forms", "wizards"],
+  form: ["data entry", "create forms", "edit forms", "multi-step forms"],
+  game: ["game", "real-time", "interactive"]
+};
+var EVENT_KEYWORDS = {
+  INIT: ["list pages", "overview pages", "dashboards", "admin panels"],
+  CREATE: ["create forms", "data entry", "multi-step forms"],
+  EDIT: ["edit forms", "data entry"],
+  VIEW: ["detail pages", "entity management", "pages with multiple views"],
+  DELETE: ["destructive actions", "confirmations"],
+  FILTER: ["filterable data", "search functionality", "quick filters"]
+};
+var SLOT_CATEGORY_AFFINITY = {
+  main: ["display", "dashboard", "filter", "header", "layout", "visualization", "navigation", "template"],
+  modal: ["form", "container", "state"],
+  drawer: ["display", "form", "navigation"],
+  sidebar: ["navigation", "filter"],
+  overlay: ["container", "state"]
+};
+var STATE_CATEGORY_AFFINITY = {
+  Browsing: ["display", "filter", "header", "dashboard", "visualization"],
+  Creating: ["form", "navigation"],
+  Editing: ["form", "navigation"],
+  Viewing: ["display", "navigation"],
+  Deleting: ["container", "state"]
+};
+function recommendPatterns(context, maxResults = 10) {
+  const patterns = patterns_registry_default.patterns || {};
+  const scores = /* @__PURE__ */ new Map();
+  const domainKeywords = context.domainCategory ? DOMAIN_KEYWORDS[context.domainCategory] || [] : [];
+  const eventKeywords = context.event ? EVENT_KEYWORDS[context.event] || [] : [];
+  const slotCategories = context.slot ? SLOT_CATEGORY_AFFINITY[context.slot] || [] : [];
+  const stateCategories = context.state ? STATE_CATEGORY_AFFINITY[context.state] || [] : [];
+  for (const [patternName, patternDef] of Object.entries(patterns)) {
+    const suggestedFor = patternDef.suggestedFor || [];
+    const category = patternDef.category || "";
+    let score = 0;
+    const reasons = [];
+    if (category === "game" && context.domainCategory !== "game") continue;
+    if (category === "debug") continue;
+    if (category === "template") continue;
+    for (const keyword of domainKeywords) {
+      if (suggestedFor.some((sf) => sf.toLowerCase().includes(keyword.toLowerCase()))) {
+        score += 30;
+        reasons.push(`domain:${keyword}`);
+        break;
+      }
+    }
+    for (const keyword of eventKeywords) {
+      if (suggestedFor.some((sf) => sf.toLowerCase().includes(keyword.toLowerCase()))) {
+        score += 25;
+        reasons.push(`event:${keyword}`);
+        break;
+      }
+    }
+    if (slotCategories.includes(category)) {
+      score += 20;
+      reasons.push(`slot:${context.slot}`);
+    }
+    if (stateCategories.includes(category)) {
+      score += 15;
+      reasons.push(`state:${context.state}`);
+    }
+    if (context.hasEnumFields && ["filter-group", "tabs", "badge"].includes(patternName)) {
+      score += 10;
+      reasons.push("enum-fields");
+    }
+    if (context.hasDateFields && ["timeline", "chart"].includes(patternName)) {
+      score += 10;
+      reasons.push("date-fields");
+    }
+    if (context.hasNumericFields && ["stats", "chart", "meter", "progress-bar"].includes(patternName)) {
+      score += 10;
+      reasons.push("numeric-fields");
+    }
+    if (context.hasRelationFields && ["tabs", "master-detail"].includes(patternName)) {
+      score += 10;
+      reasons.push("relation-fields");
+    }
+    if (context.hasMediaFields && ["entity-cards", "media-gallery"].includes(patternName)) {
+      score += 10;
+      reasons.push("media-fields");
+    }
+    if (category === "display" || category === "dashboard") {
+      const propsSchema = patternDef.propsSchema || {};
+      if ("entity" in propsSchema) {
+        score += 5;
+        reasons.push("entity-aware");
+      }
+    }
+    if (score > 0) {
+      scores.set(patternName, { score, reasons });
+    }
+  }
+  const ranked = [...scores.entries()].sort((a, b) => b[1].score - a[1].score).slice(0, maxResults);
+  return ranked.map(([patternName, { score, reasons }]) => {
+    const patternDef = patterns[patternName];
+    const propsSchema = patternDef.propsSchema || {};
+    const keyProps = Object.keys(propsSchema).filter((k) => propsSchema[k]?.required === true).slice(0, 5);
+    if (keyProps.length === 0) {
+      const meaningful = Object.keys(propsSchema).filter(
+        (k) => !["className", "isLoading", "error", "entity"].includes(k)
+      );
+      keyProps.push(...meaningful.slice(0, 4));
+    }
+    return {
+      pattern: patternName,
+      score,
+      reason: reasons.join(", "),
+      category: patternDef.category || "unknown",
+      description: patternDef.description || patternName,
+      keyProps
+    };
+  });
+}
+function buildRecommendationContext(options) {
+  const fields = options.entityFields || [];
+  const fieldTypes = fields.map((f) => f.type);
+  return {
+    state: options.state,
+    event: options.event,
+    slot: options.slot,
+    domainCategory: options.domainCategory,
+    entityFieldTypes: fieldTypes,
+    hasEnumFields: fields.some((f) => f.type === "enum" || f.values && f.values.length > 0),
+    hasDateFields: fields.some((f) => ["date", "datetime", "timestamp"].includes(f.type)),
+    hasNumericFields: fields.some((f) => ["number", "integer", "float", "decimal", "currency"].includes(f.type)),
+    hasRelationFields: fields.some((f) => f.type === "relation"),
+    hasMediaFields: fields.some((f) => ["image", "url", "media", "file"].includes(f.type))
+  };
+}
+function formatRecommendationsForPrompt(recommendations) {
+  if (recommendations.length === 0) return "";
+  const lines = [
+    "## Recommended Patterns",
+    "",
+    "| Pattern | Category | Key Props | Why |",
+    "|---------|----------|-----------|-----|"
+  ];
+  for (const rec of recommendations) {
+    const props = rec.keyProps.length > 0 ? rec.keyProps.join(", ") : "\u2014";
+    lines.push(`| ${rec.pattern} | ${rec.category} | ${props} | ${rec.reason} |`);
+  }
+  lines.push("");
+  lines.push("Use these patterns where appropriate. Combine multiple for rich INIT transitions.");
+  return lines.join("\n");
+}
+
 // src/index.ts
 var registry = patterns_registry_default;
 var PATTERN_REGISTRY = patterns_registry_default;
@@ -10738,6 +11662,6 @@ function isEntityAwarePattern(patternType) {
   return hasEntityProp && hasDataProp;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, component_mapping_default as componentMapping, event_contracts_default as eventContracts, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, registry };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, component_mapping_default as componentMapping, event_contracts_default as eventContracts, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isEntityAwarePattern, isValidPatternType, patterns_registry_default as patternsRegistry, recommendPatterns, registry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map