@almadar/core 10.41.0 → 10.43.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-29T19:32:01.461Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -8498,6 +8498,25 @@ var patterns_registry_default = {
           description: "Show arrow",
           default: true
         },
+        open: {
+          types: [
+            "boolean"
+          ],
+          description: "Controlled open state. When set, the host owns visibility and the popover reports intent through onOpenChange instead of toggling itself."
+        },
+        onOpenChange: {
+          types: [
+            "function"
+          ],
+          description: "Fired when the popover wants to change visibility (trigger click, outside click)",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "open",
+              type: "boolean"
+            }
+          ]
+        },
         className: {
           types: [
             "string"
@@ -18160,6 +18179,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"
@@ -33534,6 +33569,13 @@ var patterns_registry_default = {
           ],
           description: 'Max inline action buttons before the rest collapse into a "\u22EF" overflow menu. Omit = all inline.'
         },
+        itemClickEvent: {
+          types: [
+            "string"
+          ],
+          description: "When set, the whole row is clickable and emits UI:{itemClickEvent} with { id, row } (action-button clicks stopPropagation so they still win). Mirrors DataList's contract.",
+          kind: "event"
+        },
         selectable: {
           types: [
             "boolean"
@@ -35052,9 +35094,22 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Render scale (0.4 = 40% zoom). Ignored by `free`/`side` (world-pixel-direct).",
+          description: "Render scale, legacy-squared semantics: on-screen cell \u2248 `256 \xD7 scale\xB2` px (the authored contract every board tuned its value for). Converted internally to the single camera zoom against the board's native tile width, so the cell pitch follows the asset while the on-screen size stays as authored. Ignored when `fit` is on; passed through raw for `free`/`side` (world-pixel-direct).",
           default: 0.4
         },
+        tileWidth: {
+          types: [
+            "number"
+          ],
+          description: "Native tile/cell width in source px for this board's asset (e.g. 16 for Kenney tiny-dungeon, ~128 for iso blocks). The grid cell pitch follows the asset, so tile textures map 1:1 (crisp, no stretch). Defaults to the detected atlas tile width, else 256."
+        },
+        fit: {
+          types: [
+            "boolean"
+          ],
+          description: "Auto-fit the board's grid extent to the viewport (default false \u2014 boards render at their authored `scale` and overflow \u2192 pan). Opt in for whole-board-overview boards. User wheel/pinch zoom always wins after the initial fit.",
+          default: false
+        },
         showMinimap: {
           types: [
             "boolean"
@@ -39210,7 +39265,8 @@ var patterns_registry_default = {
             "cell",
             "rect",
             "ellipse",
-            "poly"
+            "poly",
+            "path"
           ]
         },
         position: {
@@ -39295,6 +39351,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"
@@ -39483,13 +39545,13 @@ var patterns_registry_default = {
           types: [
             "number"
           ],
-          description: "Draw width in world units (fractions of `projector.tileWidth`); omitted \u2192 resolved source width in px."
+          description: "Draw width in world units (fractions of `projector.tileWidth`). Omitted \u2192 one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`."
         },
         height: {
           types: [
             "number"
           ],
-          description: "Draw height in world units (fractions of `projector.tileWidth`); omitted \u2192 resolved source height in px."
+          description: "Draw height in world units (fractions of `projector.tileWidth`). Omitted \u2192 one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`."
         },
         frame: {
           types: [
@@ -39695,7 +39757,8 @@ var patterns_registry_default = {
                   "cell",
                   "rect",
                   "ellipse",
-                  "poly"
+                  "poly",
+                  "path"
                 ]
               },
               position: {
@@ -39770,6 +39833,11 @@ var patterns_registry_default = {
                   ]
                 }
               },
+              d: {
+                types: [
+                  "string"
+                ]
+              },
               fill: {
                 types: [
                   "string"
@@ -40226,6 +40294,18 @@ var patterns_registry_default = {
           ],
           description: "Minimap overlay (2D)."
         },
+        fit: {
+          types: [
+            "boolean"
+          ],
+          description: "Auto-fit the board's grid extent to the viewport (2D grid layouts; default false \u2014 boards render at their authored `camera.zoom` scale)."
+        },
+        tileWidth: {
+          types: [
+            "number"
+          ],
+          description: "Native tile/cell width in source px of the board's asset (2D grid layouts; defaults to the detected atlas tile width, else 256)."
+        },
         backgroundImage: {
           types: [
             "asset",
@@ -40917,175 +40997,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: {
+        position: {
           types: [
-            "string"
+            "object"
           ],
-          description: "Polygon/polyline points, viewBox units relative to the translated origin."
-        },
-        d: {
-          types: [
-            "string"
+          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: "Path data, viewBox units relative to the translated origin."
+          scenePos: true
         },
-        x2: {
+        scale: {
           types: [
             "number"
           ],
-          description: "Line end x in cell units."
+          description: "Uniform scale applied to the whole group."
         },
-        y2: {
+        rotate: {
           types: [
             "number"
           ],
-          description: "Line end y in cell units."
-        },
-        fill: {
-          types: [
-            "string"
-          ],
-          description: "fill prop"
-        },
-        stroke: {
-          types: [
-            "string"
-          ],
-          description: "stroke prop"
-        },
-        strokeWidth: {
-          types: [
-            "number"
-          ],
-          description: "strokeWidth prop"
+          description: "Rotation in radians (painter units)."
         },
         opacity: {
           types: [
@@ -41093,266 +41070,74 @@ 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"
-            ]
+            drawableSlot: true
           }
-        },
-        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."
         }
-      }
+      },
+      drawable: true,
+      drawHost: true
     },
-    "svg-stage": {
-      type: "svg-stage",
-      category: "game",
+    "emoji-picker": {
+      type: "emoji-picker",
+      category: "component",
       tier: "molecules",
-      family: "game",
-      description: "SvgStage component",
+      family: "core",
+      description: "EmojiPicker component",
       suggestedFor: [
-        "svg",
-        "stage",
-        "svg stage"
+        "emoji",
+        "picker",
+        "emoji picker"
       ],
       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: {
+        pickEvent: {
           types: [
             "string"
           ],
-          description: "Background rect fill (default `var(--color-background)`).",
-          default: "var(--color-background)"
+          description: "Declarative event name \u2014 picking an emoji emits UI:{pickEvent} with { emoji } via eventBus",
+          kind: "event"
         },
-        tileClickEvent: {
+        position: {
           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: "Which side of the trigger the panel opens on",
+          enumValues: [
+            "top",
+            "bottom"
           ],
-          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
-            }
-          ]
+          default: "top"
         },
-        tileLeaveEvent: {
+        triggerIcon: {
           types: [
+            "icon",
             "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"
-            ]
-          }
+          description: "Icon shown on the trigger button",
+          default: "smile"
         },
-        keyUpMap: {
+        triggerLabel: {
           types: [
-            "object"
+            "string"
           ],
-          description: "Keyup counterpart of `keyMap`.",
-          mapValue: {
-            types: [
-              "string"
-            ]
-          }
+          description: "Accessible label for the trigger button",
+          default: "Add emoji"
         },
         className: {
           types: [
             "string"
           ],
-          description: "Additional CSS classes"
-        },
-        children: {
-          types: [
-            "node"
-          ],
-          description: "children prop"
+          description: "Additional CSS classes applied to the trigger button"
         }
       }
     }
@@ -42276,7 +42061,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-29T19:32:01.461Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -43650,30 +43435,15 @@ 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",
+    "draw-group": {
+      component: "DrawGroup",
+      importPath: "@/components/game/atoms/DrawGroup",
       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",
-      category: "game"
+    "emoji-picker": {
+      component: "EmojiPicker",
+      importPath: "@/components/core/molecules/EmojiPicker",
+      category: "component"
     }
   }
 };
@@ -43681,7 +43451,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-29T19:32:01.461Z",
   contracts: {
     form: {
       emits: [
@@ -44911,6 +44681,7 @@ var PATTERN_TYPES = [
   "doc-sidebar",
   "doc-toc",
   "document-viewer",
+  "draw-group",
   "draw-shape",
   "draw-shape-layer",
   "draw-sprite",
@@ -44920,6 +44691,7 @@ var PATTERN_TYPES = [
   "drawer",
   "drawer-slot",
   "edge-decoration",
+  "emoji-picker",
   "empty-state",
   "entity-cards",
   "entity-list",
@@ -45062,10 +44834,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 +44844,6 @@ var PATTERN_TYPES = [
   "svg-ring",
   "svg-shield",
   "svg-stack",
-  "svg-stage",
   "swipeable-row",
   "switch",
   "tabbed-container",