@almadar/core 10.41.0 → 10.42.0

package/dist/patterns/index.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-28T14:48:23.507Z",
+  exportedAt: "2026-07-28T16:34:50.202Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -18160,6 +18160,22 @@ var patterns_registry_default = {
           description: 'Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable.',
           default: 5
         },
+        sortBy: {
+          types: [
+            "string"
+          ],
+          description: "Field name to order rows by. Values are compared by their own type \u2014 numbers numerically, date-like strings chronologically, everything else alphabetically \u2014 never by what the field is called. Empty cells sort last. Unset leaves the incoming order untouched. Orders only the rows already fetched: a collection larger than its `limit` still needs ordering at the data layer."
+        },
+        sortDirection: {
+          types: [
+            "string"
+          ],
+          description: "Direction for `sortBy`. Defaults to ascending.",
+          enumValues: [
+            "asc",
+            "desc"
+          ]
+        },
         look: {
           types: [
             "string"
@@ -39210,7 +39226,8 @@ var patterns_registry_default = {
             "cell",
             "rect",
             "ellipse",
-            "poly"
+            "poly",
+            "path"
           ]
         },
         position: {
@@ -39295,6 +39312,12 @@ var patterns_registry_default = {
             ]
           }
         },
+        d: {
+          types: [
+            "string"
+          ],
+          description: "SVG path data in world units relative to the cell's projected top-left \u2014 same coordinate convention as `points`."
+        },
         fill: {
           types: [
             "string"
@@ -39695,7 +39718,8 @@ var patterns_registry_default = {
                   "cell",
                   "rect",
                   "ellipse",
-                  "poly"
+                  "poly",
+                  "path"
                 ]
               },
               position: {
@@ -39770,6 +39794,11 @@ var patterns_registry_default = {
                   ]
                 }
               },
+              d: {
+                types: [
+                  "string"
+                ]
+              },
               fill: {
                 types: [
                   "string"
@@ -40917,175 +40946,72 @@ var patterns_registry_default = {
         }
       }
     },
-    "svg-draw-group": {
-      type: "svg-draw-group",
+    "draw-group": {
+      type: "draw-group",
       category: "game",
       tier: "atoms",
       family: "game",
-      description: "SvgDrawGroup component",
+      description: "DrawGroup component",
       suggestedFor: [
-        "svg",
         "draw",
         "group",
-        "svg draw group"
+        "draw group"
       ],
       typicalSize: "small",
       propsSchema: {
-        x: {
-          types: [
-            "number"
-          ],
-          description: "Grid-cell x of the group's origin.",
-          default: 0
-        },
-        y: {
-          types: [
-            "number"
-          ],
-          description: "Grid-cell y of the group's origin.",
-          default: 0
-        },
-        scale: {
-          types: [
-            "number"
-          ],
-          description: "Uniform scale applied after the translate."
-        },
-        rotate: {
-          types: [
-            "number"
-          ],
-          description: "Rotation in degrees applied after the translate."
-        },
-        opacity: {
-          types: [
-            "number"
-          ],
-          description: "0..1 opacity."
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        children: {
-          types: [
-            "node"
-          ],
-          description: "children prop"
-        }
-      }
-    },
-    "svg-draw-shape": {
-      type: "svg-draw-shape",
-      category: "game",
-      tier: "atoms",
-      family: "game",
-      description: "SvgDrawShape component",
-      suggestedFor: [
-        "svg",
-        "draw",
-        "shape",
-        "svg draw shape"
-      ],
-      typicalSize: "small",
-      propsSchema: {
-        shape: {
+        id: {
           types: [
             "string"
           ],
-          description: "shape prop",
-          required: true,
-          enumValues: [
-            "rect",
-            "circle",
-            "ellipse",
-            "polygon",
-            "polyline",
-            "path",
-            "line"
-          ]
-        },
-        x: {
-          types: [
-            "number"
-          ],
-          description: "Grid-cell x of the element's translated origin.",
-          required: true
+          description: "Optional source-tagged hit-test handle \u2014 the host indexes the drawable's ScenePos\u2192id so a pointer/raycast at that cell resolves to this id (unit/entity click). No id \u2192 the host emits only the coordinate (tile click)."
         },
-        y: {
+        type: {
           types: [
-            "number"
+            "unknown"
           ],
-          description: "Grid-cell y of the element's translated origin.",
+          description: "type prop",
           required: true
         },
-        width: {
-          types: [
-            "number"
-          ],
-          description: "Rect width in cell units."
-        },
-        height: {
-          types: [
-            "number"
-          ],
-          description: "Rect height in cell units."
-        },
-        radius: {
-          types: [
-            "number"
-          ],
-          description: "Circle radius / ellipse horizontal radius in cell units."
-        },
-        radiusY: {
-          types: [
-            "number"
-          ],
-          description: "Ellipse vertical radius in cell units; omitted \u2192 `radius` (a circle)."
-        },
-        points: {
-          types: [
-            "string"
-          ],
-          description: "Polygon/polyline points, viewBox units relative to the translated origin."
-        },
-        d: {
+        position: {
           types: [
-            "string"
+            "object"
           ],
-          description: "Path data, viewBox units relative to the translated origin."
-        },
-        x2: {
-          types: [
-            "number"
+          description: "Logical scene position; the projector maps it to pixels / world.",
+          required: true,
+          properties: {
+            x: {
+              types: [
+                "number"
+              ]
+            },
+            y: {
+              types: [
+                "number"
+              ]
+            },
+            z: {
+              types: [
+                "number"
+              ]
+            }
+          },
+          propertyRequired: [
+            "x",
+            "y"
           ],
-          description: "Line end x in cell units."
+          scenePos: true
         },
-        y2: {
+        scale: {
           types: [
             "number"
           ],
-          description: "Line end y in cell units."
-        },
-        fill: {
-          types: [
-            "string"
-          ],
-          description: "fill prop"
+          description: "Uniform scale applied to the whole group."
         },
-        stroke: {
-          types: [
-            "string"
-          ],
-          description: "stroke prop"
-        },
-        strokeWidth: {
+        rotate: {
           types: [
             "number"
           ],
-          description: "strokeWidth prop"
+          description: "Rotation in radians (painter units)."
         },
         opacity: {
           types: [
@@ -41093,268 +41019,22 @@ var patterns_registry_default = {
           ],
           description: "0..1 opacity."
         },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        }
-      }
-    },
-    "svg-draw-text": {
-      type: "svg-draw-text",
-      category: "game",
-      tier: "atoms",
-      family: "game",
-      description: "SvgDrawText component",
-      suggestedFor: [
-        "svg",
-        "draw",
-        "text",
-        "svg draw text"
-      ],
-      typicalSize: "small",
-      propsSchema: {
-        x: {
-          types: [
-            "number"
-          ],
-          description: "Grid-cell x of the text anchor.",
-          required: true
-        },
-        y: {
-          types: [
-            "number"
-          ],
-          description: "Grid-cell y of the text anchor.",
-          required: true
-        },
-        text: {
-          types: [
-            "string"
-          ],
-          description: "The text content.",
-          required: true
-        },
-        size: {
-          types: [
-            "number"
-          ],
-          description: "Font size in viewBox units (default 12).",
-          default: 12
-        },
-        fill: {
-          types: [
-            "string"
-          ],
-          description: "fill prop",
-          default: "var(--color-foreground)"
-        },
-        anchor: {
-          types: [
-            "string"
-          ],
-          description: "Text anchor (default 'middle').",
-          enumValues: [
-            "start",
-            "middle",
-            "end"
-          ],
-          default: "middle"
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        }
-      }
-    },
-    "svg-draw-shape-layer": {
-      type: "svg-draw-shape-layer",
-      category: "game",
-      tier: "molecules",
-      family: "game",
-      description: "SvgDrawShapeLayer component",
-      suggestedFor: [
-        "svg",
-        "draw",
-        "shape",
-        "layer",
-        "svg draw shape layer"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
         items: {
           types: [
             "array"
           ],
-          description: "items prop",
+          description: "The grouped drawables, painted through the normal dispatch.",
           required: true,
           items: {
             types: [
               "object"
             ],
-            properties: {
-              id: {
-                types: [
-                  "string"
-                ]
-              }
-            },
-            required: [
-              "id"
-            ]
-          }
-        },
-        fill: {
-          types: [
-            "string"
-          ],
-          description: "Default fill for items that don't set one."
-        },
-        stroke: {
-          types: [
-            "string"
-          ],
-          description: "Default stroke for items that don't set one."
-        },
-        strokeWidth: {
-          types: [
-            "number"
-          ],
-          description: "Default strokeWidth for items that don't set one."
-        },
-        opacity: {
-          types: [
-            "number"
-          ],
-          description: "Default 0..1 opacity for items that don't set one."
-        }
-      }
-    },
-    "svg-stage": {
-      type: "svg-stage",
-      category: "game",
-      tier: "molecules",
-      family: "game",
-      description: "SvgStage component",
-      suggestedFor: [
-        "svg",
-        "stage",
-        "svg stage"
-      ],
-      typicalSize: "medium",
-      propsSchema: {
-        cols: {
-          types: [
-            "number"
-          ],
-          description: "Grid width in cells.",
-          required: true
-        },
-        rows: {
-          types: [
-            "number"
-          ],
-          description: "Grid height in cells.",
-          required: true
-        },
-        tileSize: {
-          types: [
-            "number"
-          ],
-          description: "ViewBox units per cell (default 32); viewBox is `0 0 cols*tileSize rows*tileSize`.",
-          default: 32
-        },
-        background: {
-          types: [
-            "string"
-          ],
-          description: "Background rect fill (default `var(--color-background)`).",
-          default: "var(--color-background)"
-        },
-        tileClickEvent: {
-          types: [
-            "string"
-          ],
-          description: "Emitted as `UI:<event>` with `{ x, y }` cell coords on pointer up (<5px drag).",
-          kind: "event-ref",
-          emitPayloadSchema: [
-            {
-              name: "x",
-              type: "number",
-              required: true
-            },
-            {
-              name: "y",
-              type: "number",
-              required: true
-            }
-          ]
-        },
-        tileHoverEvent: {
-          types: [
-            "string"
-          ],
-          description: "Emitted as `UI:<event>` with `{ x, y }` cell coords on pointer move.",
-          kind: "event-ref",
-          emitPayloadSchema: [
-            {
-              name: "x",
-              type: "number",
-              required: true
-            },
-            {
-              name: "y",
-              type: "number",
-              required: true
-            }
-          ]
-        },
-        tileLeaveEvent: {
-          types: [
-            "string"
-          ],
-          description: "Emitted as `UI:<event>` with `{}` when the pointer leaves the stage.",
-          kind: "event-ref",
-          emitPayloadSchema: []
-        },
-        keyMap: {
-          types: [
-            "object"
-          ],
-          description: "Keyboard \u2192 semantic events: `e.code` \u2192 event name, emitted as `UI:<event>` with `{}`.",
-          mapValue: {
-            types: [
-              "string"
-            ]
-          }
-        },
-        keyUpMap: {
-          types: [
-            "object"
-          ],
-          description: "Keyup counterpart of `keyMap`.",
-          mapValue: {
-            types: [
-              "string"
-            ]
+            drawableSlot: true
           }
-        },
-        className: {
-          types: [
-            "string"
-          ],
-          description: "Additional CSS classes"
-        },
-        children: {
-          types: [
-            "node"
-          ],
-          description: "children prop"
         }
-      }
+      },
+      drawable: true,
+      drawHost: true
     }
   },
   categories: [
@@ -42276,7 +41956,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-28T14:48:23.507Z",
+  exportedAt: "2026-07-28T16:34:50.202Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -43650,29 +43330,9 @@ var component_mapping_default = {
       importPath: "@/components/core/molecules/ImportSourcePicker",
       category: "component"
     },
-    "svg-draw-group": {
-      component: "SvgDrawGroup",
-      importPath: "@/components/game/atoms/SvgDrawGroup",
-      category: "game"
-    },
-    "svg-draw-shape": {
-      component: "SvgDrawShape",
-      importPath: "@/components/game/atoms/SvgDrawShape",
-      category: "game"
-    },
-    "svg-draw-text": {
-      component: "SvgDrawText",
-      importPath: "@/components/game/atoms/SvgDrawText",
-      category: "game"
-    },
-    "svg-draw-shape-layer": {
-      component: "SvgDrawShapeLayer",
-      importPath: "@/components/game/molecules/SvgDrawShapeLayer",
-      category: "game"
-    },
-    "svg-stage": {
-      component: "SvgStage",
-      importPath: "@/components/game/molecules/SvgStage",
+    "draw-group": {
+      component: "DrawGroup",
+      importPath: "@/components/game/atoms/DrawGroup",
       category: "game"
     }
   }
@@ -43681,7 +43341,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-28T14:48:23.507Z",
+  exportedAt: "2026-07-28T16:34:50.202Z",
   contracts: {
     form: {
       emits: [
@@ -44911,6 +44571,7 @@ var PATTERN_TYPES = [
   "doc-sidebar",
   "doc-toc",
   "document-viewer",
+  "draw-group",
   "draw-shape",
   "draw-shape-layer",
   "draw-sprite",
@@ -45062,10 +44723,6 @@ var PATTERN_TYPES = [
   "subagent-trace-panel",
   "svg-branch",
   "svg-connection",
-  "svg-draw-group",
-  "svg-draw-shape",
-  "svg-draw-shape-layer",
-  "svg-draw-text",
   "svg-flow",
   "svg-grid",
   "svg-lobe",
@@ -45076,7 +44733,6 @@ var PATTERN_TYPES = [
   "svg-ring",
   "svg-shield",
   "svg-stack",
-  "svg-stage",
   "swipeable-row",
   "switch",
   "tabbed-container",