@almadar/core 10.42.0 → 10.44.0

package/dist/patterns/component-mapping.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-28T16:34:50.202Z",
+  "exportedAt": "2026-07-29T19:32:01.461Z",
   "mappings": {
     "page-header": {
       "component": "PageHeader",
@@ -1378,6 +1378,11 @@
       "component": "DrawGroup",
       "importPath": "@/components/game/atoms/DrawGroup",
       "category": "game"
+    },
+    "emoji-picker": {
+      "component": "EmojiPicker",
+      "importPath": "@/components/core/molecules/EmojiPicker",
+      "category": "component"
     }
   }
 }

package/dist/patterns/event-contracts.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-28T16:34:50.202Z",
+  "exportedAt": "2026-07-29T19:32:01.461Z",
   "contracts": {
     "form": {
       "emits": [

package/dist/patterns/index.d.ts

@@ -1,10 +1,10 @@
-import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, a$ as PatternType, J as JsonValue } from '../effect-D4os99OL.js';
-export { aU as PATTERN_TYPES, aY as PatternConfig, aZ as PatternProps, a_ as PatternPropsMap, cR as isValidPatternType } from '../effect-D4os99OL.js';
-import { d as EventPayloadValue, a as EventPayload } from '../expression-DpAj1RzP.js';
+import { A as AnyPatternConfig, h as RenderBinding, F as FieldValue, aY as PatternType } from '../effect-NbTgX2yB.js';
+export { aR as PATTERN_TYPES, aV as PatternConfig, aW as PatternProps, aX as PatternPropsMap, cL as isValidPatternType } from '../effect-NbTgX2yB.js';
+import { d as EventPayloadValue, a as EventPayload, J as JsonValue } from '../expression-Yf7qvvOs.js';
 import 'zod';
 
 var version$3 = "1.0.0";
-var exportedAt$3 = "2026-07-28T16:34:50.202Z";
+var exportedAt$3 = "2026-07-29T19:32:01.461Z";
 var patterns = {
 	"entity-table": {
 		type: "entity-table",
@@ -8531,6 +8531,25 @@ var patterns = {
 				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"
@@ -33631,6 +33650,13 @@ var patterns = {
 				],
 				description: "Max inline action buttons before the rest collapse into a \"⋯\" 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"
@@ -35151,9 +35177,22 @@ var patterns = {
 				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 ≈ `256 × scale²` 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 — boards render at their authored `scale` and overflow → pan). Opt in for whole-board-overview boards. User wheel/pinch zoom always wins after the initial fit.",
+				"default": false
+			},
 			showMinimap: {
 				types: [
 					"boolean"
@@ -39609,13 +39648,13 @@ var patterns = {
 				types: [
 					"number"
 				],
-				description: "Draw width in world units (fractions of `projector.tileWidth`); omitted → resolved source width in px."
+				description: "Draw width in world units (fractions of `projector.tileWidth`). Omitted → 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 → resolved source height in px."
+				description: "Draw height in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`."
 			},
 			frame: {
 				types: [
@@ -40358,6 +40397,18 @@ var patterns = {
 				],
 				description: "Minimap overlay (2D)."
 			},
+			fit: {
+				types: [
+					"boolean"
+				],
+				description: "Auto-fit the board's grid extent to the viewport (2D grid layouts; default false — 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",
@@ -41142,6 +41193,60 @@ var patterns = {
 		},
 		drawable: true,
 		drawHost: true
+	},
+	"emoji-picker": {
+		type: "emoji-picker",
+		category: "component",
+		tier: "molecules",
+		family: "core",
+		description: "EmojiPicker component",
+		suggestedFor: [
+			"emoji",
+			"picker",
+			"emoji picker"
+		],
+		typicalSize: "medium",
+		propsSchema: {
+			pickEvent: {
+				types: [
+					"string"
+				],
+				description: "Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus",
+				kind: "event"
+			},
+			position: {
+				types: [
+					"string"
+				],
+				description: "Which side of the trigger the panel opens on",
+				enumValues: [
+					"top",
+					"bottom"
+				],
+				"default": "top"
+			},
+			triggerIcon: {
+				types: [
+					"icon",
+					"string"
+				],
+				description: "Icon shown on the trigger button",
+				"default": "smile"
+			},
+			triggerLabel: {
+				types: [
+					"string"
+				],
+				description: "Accessible label for the trigger button",
+				"default": "Add emoji"
+			},
+			className: {
+				types: [
+					"string"
+				],
+				description: "Additional CSS classes applied to the trigger button"
+			}
+		}
 	}
 };
 var categories$1 = [
@@ -42069,7 +42174,7 @@ var integratorsRegistry = {
 };
 
 var version$1 = "1.0.0";
-var exportedAt$1 = "2026-07-28T16:34:50.202Z";
+var exportedAt$1 = "2026-07-29T19:32:01.461Z";
 var mappings = {
 	"page-header": {
 		component: "PageHeader",
@@ -43447,6 +43552,11 @@ var mappings = {
 		component: "DrawGroup",
 		importPath: "@/components/game/atoms/DrawGroup",
 		category: "game"
+	},
+	"emoji-picker": {
+		component: "EmojiPicker",
+		importPath: "@/components/core/molecules/EmojiPicker",
+		category: "component"
 	}
 };
 var componentMapping = {
@@ -43456,7 +43566,7 @@ var componentMapping = {
 };
 
 var version = "1.0.0";
-var exportedAt = "2026-07-28T16:34:50.202Z";
+var exportedAt = "2026-07-29T19:32:01.461Z";
 var contracts = {
 	form: {
 		emits: [
@@ -44954,6 +45064,15 @@ type SelectionChangePayload = EventPayload & {
  * destructure without runtime checks.
  */
 type LoadMoreRequestPayload = EventPayload;
+/**
+ * Payload dispatched by an emoji-choosing pattern (`pickEvent` on
+ * EmojiPicker) when the user picks a glyph. The receiving trait appends
+ * the glyph to a draft, records a reaction, etc.
+ */
+type EmojiPickPayload = EventPayload & {
+    /** The chosen emoji glyph (e.g. "😀"). */
+    emoji: string;
+};
 /**
  * Payload dispatched by a schema-driven `Form` on successful submit
  * (`submitEvent`). `data` holds the form's collected field values.
@@ -50350,6 +50469,19 @@ declare const registry: {
                     description: string;
                     default: boolean;
                 };
+                open: {
+                    types: string[];
+                    description: string;
+                };
+                onOpenChange: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                    }[];
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -65735,6 +65867,11 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                itemClickEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                };
                 selectable: {
                     types: string[];
                     description: string;
@@ -66683,6 +66820,15 @@ declare const registry: {
                     description: string;
                     default: number;
                 };
+                tileWidth: {
+                    types: string[];
+                    description: string;
+                };
+                fit: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
                 showMinimap: {
                     types: string[];
                     description: string;
@@ -69825,6 +69971,14 @@ declare const registry: {
                     types: string[];
                     description: string;
                 };
+                fit: {
+                    types: string[];
+                    description: string;
+                };
+                tileWidth: {
+                    types: string[];
+                    description: string;
+                };
                 backgroundImage: {
                     types: string[];
                     description: string;
@@ -70314,6 +70468,42 @@ declare const registry: {
             drawable: boolean;
             drawHost: boolean;
         };
+        "emoji-picker": {
+            type: string;
+            category: string;
+            tier: string;
+            family: string;
+            description: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                pickEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                };
+                position: {
+                    types: string[];
+                    description: string;
+                    enumValues: string[];
+                    default: string;
+                };
+                triggerIcon: {
+                    types: string[];
+                    description: string;
+                    default: string;
+                };
+                triggerLabel: {
+                    types: string[];
+                    description: string;
+                    default: string;
+                };
+                className: {
+                    types: string[];
+                    description: string;
+                };
+            };
+        };
     };
     categories: string[];
 };
@@ -75490,6 +75680,19 @@ declare const PATTERN_REGISTRY: {
                     description: string;
                     default: boolean;
                 };
+                open: {
+                    types: string[];
+                    description: string;
+                };
+                onOpenChange: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                    callbackArgs: {
+                        name: string;
+                        type: string;
+                    }[];
+                };
                 className: {
                     types: string[];
                     description: string;
@@ -90875,6 +91078,11 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                itemClickEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                };
                 selectable: {
                     types: string[];
                     description: string;
@@ -91823,6 +92031,15 @@ declare const PATTERN_REGISTRY: {
                     description: string;
                     default: number;
                 };
+                tileWidth: {
+                    types: string[];
+                    description: string;
+                };
+                fit: {
+                    types: string[];
+                    description: string;
+                    default: boolean;
+                };
                 showMinimap: {
                     types: string[];
                     description: string;
@@ -94965,6 +95182,14 @@ declare const PATTERN_REGISTRY: {
                     types: string[];
                     description: string;
                 };
+                fit: {
+                    types: string[];
+                    description: string;
+                };
+                tileWidth: {
+                    types: string[];
+                    description: string;
+                };
                 backgroundImage: {
                     types: string[];
                     description: string;
@@ -95454,6 +95679,42 @@ declare const PATTERN_REGISTRY: {
             drawable: boolean;
             drawHost: boolean;
         };
+        "emoji-picker": {
+            type: string;
+            category: string;
+            tier: string;
+            family: string;
+            description: string;
+            suggestedFor: string[];
+            typicalSize: string;
+            propsSchema: {
+                pickEvent: {
+                    types: string[];
+                    description: string;
+                    kind: string;
+                };
+                position: {
+                    types: string[];
+                    description: string;
+                    enumValues: string[];
+                    default: string;
+                };
+                triggerIcon: {
+                    types: string[];
+                    description: string;
+                    default: string;
+                };
+                triggerLabel: {
+                    types: string[];
+                    description: string;
+                    default: string;
+                };
+                className: {
+                    types: string[];
+                    description: string;
+                };
+            };
+        };
     };
     categories: string[];
 };
@@ -97532,6 +97793,11 @@ declare const COMPONENT_MAPPING: {
             importPath: string;
             category: string;
         };
+        "emoji-picker": {
+            component: string;
+            importPath: string;
+            category: string;
+        };
     };
 };
 declare const EVENT_CONTRACTS: {
@@ -98289,4 +98555,4 @@ declare function isDrawablePattern(patternType: string): boolean;
  */
 declare function isDrawHostPattern(patternType: string): boolean;
 
-export { AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, type FormSubmitPayload, INTEGRATORS_REGISTRY, type ItemActionPayload, type LoadMoreRequestPayload, PATTERN_REGISTRY, type PatternCallbackArg, type PatternEntry, type PatternPayloadField, type PatternPropDef, type PatternRecommendation, type PatternSwapGate, PatternType, type PropKind, type RecommendationContext, type RenderUiPayload, type SelectionChangePayload, buildRecommendationContext, collectRenderUiPatternTypes, componentMapping, eventContracts, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
+export { AnyPatternConfig, COMPONENT_MAPPING, EVENT_CONTRACTS, type EmojiPickPayload, type FormSubmitPayload, INTEGRATORS_REGISTRY, type ItemActionPayload, type LoadMoreRequestPayload, PATTERN_REGISTRY, type PatternCallbackArg, type PatternEntry, type PatternPayloadField, type PatternPropDef, type PatternRecommendation, type PatternSwapGate, PatternType, type PropKind, type RecommendationContext, type RenderUiPayload, type SelectionChangePayload, buildRecommendationContext, collectRenderUiPatternTypes, componentMapping, eventContracts, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };

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-28T16:34:50.202Z",
+  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"
@@ -33550,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"
@@ -35068,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"
@@ -39506,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: [
@@ -40255,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",
@@ -41035,6 +41086,60 @@ var patterns_registry_default = {
       },
       drawable: true,
       drawHost: true
+    },
+    "emoji-picker": {
+      type: "emoji-picker",
+      category: "component",
+      tier: "molecules",
+      family: "core",
+      description: "EmojiPicker component",
+      suggestedFor: [
+        "emoji",
+        "picker",
+        "emoji picker"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        pickEvent: {
+          types: [
+            "string"
+          ],
+          description: "Declarative event name \u2014 picking an emoji emits UI:{pickEvent} with { emoji } via eventBus",
+          kind: "event"
+        },
+        position: {
+          types: [
+            "string"
+          ],
+          description: "Which side of the trigger the panel opens on",
+          enumValues: [
+            "top",
+            "bottom"
+          ],
+          default: "top"
+        },
+        triggerIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Icon shown on the trigger button",
+          default: "smile"
+        },
+        triggerLabel: {
+          types: [
+            "string"
+          ],
+          description: "Accessible label for the trigger button",
+          default: "Add emoji"
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional CSS classes applied to the trigger button"
+        }
+      }
     }
   },
   categories: [
@@ -41956,7 +42061,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-28T16:34:50.202Z",
+  exportedAt: "2026-07-29T19:32:01.461Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -43334,6 +43439,11 @@ var component_mapping_default = {
       component: "DrawGroup",
       importPath: "@/components/game/atoms/DrawGroup",
       category: "game"
+    },
+    "emoji-picker": {
+      component: "EmojiPicker",
+      importPath: "@/components/core/molecules/EmojiPicker",
+      category: "component"
     }
   }
 };
@@ -43341,7 +43451,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-07-28T16:34:50.202Z",
+  exportedAt: "2026-07-29T19:32:01.461Z",
   contracts: {
     form: {
       emits: [
@@ -44581,6 +44691,7 @@ var PATTERN_TYPES = [
   "drawer",
   "drawer-slot",
   "edge-decoration",
+  "emoji-picker",
   "empty-state",
   "entity-cards",
   "entity-list",