@almadar/core 10.61.0 → 10.63.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-08-19T03:03:56.666Z",
+  exportedAt: "2026-08-20T23:14:19.545Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -1239,6 +1239,7 @@ var patterns_registry_default = {
       tier: "organisms",
       family: "core",
       description: "Detail view panel for drawers/sidebars",
+      fieldsContract: "display",
       suggestedFor: [
         "drawer content",
         "side panels",
@@ -1520,6 +1521,54 @@ var patterns_registry_default = {
             ]
           }
         },
+        backAction: {
+          types: [
+            "object"
+          ],
+          description: "Navigation-back affordance. Renders top-LEFT before the title (OS/back convention \u2014 Almadar_UX \xA78.4), spatially separated from the right-aligned action buttons + close X. Never inferred from actions[] labels.",
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            icon: {
+              types: [
+                "icon",
+                "string"
+              ]
+            },
+            onClick: {
+              types: [
+                "function"
+              ]
+            },
+            event: {
+              types: [
+                "string"
+              ]
+            },
+            navigatesTo: {
+              types: [
+                "string"
+              ]
+            },
+            variant: {
+              types: [
+                "string"
+              ],
+              enumValues: [
+                "primary",
+                "secondary",
+                "ghost",
+                "danger"
+              ]
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
         footer: {
           types: [
             "node"
@@ -1554,6 +1603,26 @@ var patterns_registry_default = {
                 types: [
                   "string"
                 ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              values: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              },
+              relation: {
+                types: [
+                  "string"
+                ]
               }
             },
             required: [
@@ -1618,6 +1687,48 @@ var patterns_registry_default = {
             "boolean"
           ],
           description: "Show actions flag"
+        },
+        relationsData: {
+          types: [
+            "object"
+          ],
+          description: "Relation display data: { fieldName: [{value, label}] } \u2014 injected server-side by the runtime (relation-option injection) or bound by compiled codegen; resolves stored foreign ids to display names.",
+          mapValue: {
+            types: [
+              "array"
+            ],
+            items: {
+              types: [
+                "object"
+              ],
+              properties: {
+                value: {
+                  types: [
+                    "string"
+                  ]
+                },
+                label: {
+                  types: [
+                    "string"
+                  ]
+                },
+                description: {
+                  types: [
+                    "string"
+                  ]
+                },
+                disabled: {
+                  types: [
+                    "boolean"
+                  ]
+                }
+              },
+              required: [
+                "value",
+                "label"
+              ]
+            }
+          }
         }
       }
     },
@@ -1692,9 +1803,10 @@ var patterns_registry_default = {
         },
         status: {
           types: [
-            "object"
+            "object",
+            "string"
           ],
-          description: "Status badge",
+          description: "Status badge \u2014 a bare string (an entity's status field bound directly, e.g. `status: @entity.status`) renders as a default-variant badge",
           properties: {
             label: {
               types: [
@@ -1889,6 +2001,7 @@ var patterns_registry_default = {
       tier: "organisms",
       family: "core",
       description: "Complete form with fields and actions",
+      fieldsContract: "form",
       suggestedFor: [
         "create forms",
         "edit forms",
@@ -2121,6 +2234,11 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              hint: {
+                types: [
+                  "string"
+                ]
               }
             }
           }
@@ -2273,6 +2391,42 @@ var patterns_registry_default = {
           },
           default: {}
         },
+        fieldOverrides: {
+          types: [
+            "array"
+          ],
+          description: "Per-field display-copy overrides (label/placeholder/hint), merged by field name over the schema-enriched fields.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              name: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              placeholder: {
+                types: [
+                  "string"
+                ]
+              },
+              hint: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "name"
+            ]
+          }
+        },
         conditionalFields: {
           types: [
             "object",
@@ -2399,7 +2553,12 @@ var patterns_registry_default = {
             formValues: {
               types: [
                 "object"
-              ]
+              ],
+              mapValue: {
+                types: [
+                  "object"
+                ]
+              }
             },
             globalVariables: {
               types: [
@@ -2426,7 +2585,12 @@ var patterns_registry_default = {
             entity: {
               types: [
                 "object"
-              ]
+              ],
+              mapValue: {
+                types: [
+                  "object"
+                ]
+              }
             }
           },
           propertyRequired: [
@@ -2615,6 +2779,11 @@ var patterns_registry_default = {
                       types: [
                         "boolean"
                       ]
+                    },
+                    hint: {
+                      types: [
+                        "string"
+                      ]
                     }
                   }
                 }
@@ -2698,6 +2867,7 @@ var patterns_registry_default = {
       tier: "organisms",
       family: "core",
       description: "Alias for form \u2014 Complete form with fields and actions",
+      fieldsContract: "form",
       suggestedFor: [
         "create forms",
         "edit forms",
@@ -2930,6 +3100,11 @@ var patterns_registry_default = {
                 types: [
                   "boolean"
                 ]
+              },
+              hint: {
+                types: [
+                  "string"
+                ]
               }
             }
           }
@@ -3082,6 +3257,42 @@ var patterns_registry_default = {
           },
           default: {}
         },
+        fieldOverrides: {
+          types: [
+            "array"
+          ],
+          description: "Per-field display-copy overrides (label/placeholder/hint), merged by field name over the schema-enriched fields.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              name: {
+                types: [
+                  "string"
+                ]
+              },
+              label: {
+                types: [
+                  "string"
+                ]
+              },
+              placeholder: {
+                types: [
+                  "string"
+                ]
+              },
+              hint: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "name"
+            ]
+          }
+        },
         conditionalFields: {
           types: [
             "object",
@@ -3208,7 +3419,12 @@ var patterns_registry_default = {
             formValues: {
               types: [
                 "object"
-              ]
+              ],
+              mapValue: {
+                types: [
+                  "object"
+                ]
+              }
             },
             globalVariables: {
               types: [
@@ -3235,7 +3451,12 @@ var patterns_registry_default = {
             entity: {
               types: [
                 "object"
-              ]
+              ],
+              mapValue: {
+                types: [
+                  "object"
+                ]
+              }
             }
           },
           propertyRequired: [
@@ -3424,6 +3645,11 @@ var patterns_registry_default = {
                       types: [
                         "boolean"
                       ]
+                    },
+                    hint: {
+                      types: [
+                        "string"
+                      ]
                     }
                   }
                 }
@@ -12817,7 +13043,7 @@ var patterns_registry_default = {
           types: [
             "object"
           ],
-          description: "Current user info (optional - auto-populated from auth context if not provided)",
+          description: "Current user info (optional - auto-populated from auth context if not provided). Accepts `null` as well as `undefined`: the `.lolo` substrate's signed-out spelling is `(if @config.viewerName {\u2026} null)`, and the compiled path passes that `null` through verbatim.",
           properties: {
             name: {
               types: [
@@ -12836,8 +13062,7 @@ var patterns_registry_default = {
             }
           },
           propertyRequired: [
-            "name",
-            "email"
+            "name"
           ]
         },
         headerActions: {
@@ -40055,6 +40280,28 @@ var patterns_registry_default = {
             }
           ]
         },
+        keyMap: {
+          types: [
+            "object"
+          ],
+          description: "Maps a keydown `e.code` \u2192 the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}` \u2014 same contract as the game canvas keyMap.",
+          mapValue: {
+            types: [
+              "string"
+            ]
+          }
+        },
+        keyUpMap: {
+          types: [
+            "object"
+          ],
+          description: "Maps a keyup `e.code` \u2192 the board's SEMANTIC event.",
+          mapValue: {
+            types: [
+              "string"
+            ]
+          }
+        },
         isLoading: {
           types: [
             "boolean"
@@ -46767,6 +47014,566 @@ var patterns_registry_default = {
           ]
         }
       }
+    },
+    "fx-overlay": {
+      type: "fx-overlay",
+      category: "container",
+      tier: "molecules",
+      family: "core",
+      description: "FxOverlay component",
+      suggestedFor: [
+        "overlay",
+        "fx overlay"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        items: {
+          types: [
+            "array"
+          ],
+          description: "Live screen-space fx entries (the mechanic's fx list filtered to `space == \"screen\"`); mount starts each item's animation, ttl decay unmounts it.",
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              effect: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "confetti",
+                  "flash",
+                  "shake",
+                  "sparkle",
+                  "float-text",
+                  "streak-glow"
+                ]
+              },
+              message: {
+                types: [
+                  "string"
+                ]
+              },
+              color: {
+                types: [
+                  "string"
+                ]
+              },
+              size: {
+                types: [
+                  "number"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              ttl: {
+                types: [
+                  "number"
+                ]
+              },
+              maxTtl: {
+                types: [
+                  "number"
+                ]
+              },
+              bornAt: {
+                types: [
+                  "number"
+                ]
+              },
+              space: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "world",
+                  "screen"
+                ]
+              },
+              particleCount: {
+                types: [
+                  "number"
+                ]
+              },
+              vx: {
+                types: [
+                  "number"
+                ]
+              },
+              vy: {
+                types: [
+                  "number"
+                ]
+              },
+              vz: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "id",
+              "type",
+              "ttl"
+            ]
+          }
+        },
+        tickMs: {
+          types: [
+            "number"
+          ],
+          description: "The fx mechanic's decay tick period in ms; per-item animation duration = maxTtl \xD7 tickMs. Default 500."
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Wrapped content \u2014 the `shake` target and the overlay's bounds."
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "Additional class names on the outermost element."
+        }
+      }
+    },
+    "draw-fx-layer": {
+      type: "draw-fx-layer",
+      category: "game",
+      tier: "molecules",
+      family: "game",
+      description: "DrawFxLayer component",
+      suggestedFor: [
+        "draw",
+        "layer",
+        "draw fx layer"
+      ],
+      typicalSize: "medium",
+      propsSchema: {
+        id: {
+          types: [
+            "string"
+          ],
+          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)."
+        },
+        type: {
+          types: [
+            "unknown"
+          ],
+          description: "type prop",
+          required: true
+        },
+        items: {
+          types: [
+            "array"
+          ],
+          description: 'The live fx entries \u2014 the mechanic\'s `@entity.fx` list passed whole; `space: "screen"` entries are skipped (the overlay owns those).',
+          required: true,
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              id: {
+                types: [
+                  "string"
+                ]
+              },
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              position: {
+                types: [
+                  "object"
+                ],
+                scenePos: true,
+                properties: {
+                  x: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  y: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  z: {
+                    types: [
+                      "number"
+                    ]
+                  }
+                },
+                required: [
+                  "x",
+                  "y"
+                ]
+              },
+              x: {
+                types: [
+                  "number"
+                ]
+              },
+              z: {
+                types: [
+                  "number"
+                ]
+              },
+              y: {
+                types: [
+                  "number"
+                ]
+              },
+              message: {
+                types: [
+                  "string"
+                ]
+              },
+              ttl: {
+                types: [
+                  "number"
+                ]
+              },
+              maxTtl: {
+                types: [
+                  "number"
+                ]
+              },
+              bornAt: {
+                types: [
+                  "number"
+                ]
+              },
+              space: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "world",
+                  "screen"
+                ]
+              },
+              effect: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "confetti",
+                  "flash",
+                  "shake",
+                  "sparkle",
+                  "float-text",
+                  "streak-glow"
+                ]
+              },
+              color: {
+                types: [
+                  "string"
+                ]
+              },
+              size: {
+                types: [
+                  "number"
+                ]
+              },
+              vx: {
+                types: [
+                  "number"
+                ]
+              },
+              vy: {
+                types: [
+                  "number"
+                ]
+              },
+              vz: {
+                types: [
+                  "number"
+                ]
+              },
+              particleCount: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "id",
+              "type",
+              "x",
+              "ttl"
+            ]
+          }
+        },
+        presets: {
+          types: [
+            "array"
+          ],
+          description: "Consumer-declared effect vocabulary \u2014 one row per fx `type` (look + recipe). Unknown types fall back to a neutral spark burst.",
+          items: {
+            types: [
+              "object"
+            ],
+            properties: {
+              type: {
+                types: [
+                  "string"
+                ]
+              },
+              color: {
+                types: [
+                  "string"
+                ]
+              },
+              color2: {
+                types: [
+                  "string"
+                ]
+              },
+              size: {
+                types: [
+                  "number"
+                ]
+              },
+              shape: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "spark",
+                  "ring",
+                  "puff",
+                  "streak"
+                ]
+              },
+              count: {
+                types: [
+                  "number"
+                ]
+              },
+              glow: {
+                types: [
+                  "number"
+                ]
+              },
+              gravity: {
+                types: [
+                  "number"
+                ]
+              },
+              vx: {
+                types: [
+                  "number"
+                ]
+              },
+              vy: {
+                types: [
+                  "number"
+                ]
+              },
+              vz: {
+                types: [
+                  "number"
+                ]
+              },
+              space: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "world",
+                  "screen"
+                ]
+              },
+              effect: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "confetti",
+                  "flash",
+                  "shake",
+                  "sparkle",
+                  "float-text",
+                  "streak-glow"
+                ]
+              },
+              particleCount: {
+                types: [
+                  "number"
+                ]
+              }
+            },
+            required: [
+              "type"
+            ]
+          }
+        },
+        art: {
+          types: [
+            "object"
+          ],
+          description: "Vector art per fx type (an asset-art map: type \u2192 anim-state \u2192 drawables); a type's `idle` state wins over sprites/procedural.",
+          mapValue: {
+            types: [
+              "object"
+            ],
+            mapValue: {
+              types: [
+                "array"
+              ],
+              items: {
+                types: [
+                  "object"
+                ],
+                drawableSlot: true
+              }
+            }
+          }
+        },
+        sprites: {
+          types: [
+            "object"
+          ],
+          description: "Sprite asset per fx type (an asset-manifest effects map) \u2014 used when no vector art matches.",
+          mapValue: {
+            types: [
+              "object"
+            ],
+            properties: {
+              url: {
+                types: [
+                  "asset"
+                ]
+              },
+              role: {
+                types: [
+                  "string"
+                ]
+              },
+              category: {
+                types: [
+                  "string"
+                ]
+              },
+              animations: {
+                types: [
+                  "array"
+                ],
+                items: {
+                  types: [
+                    "string"
+                  ]
+                }
+              },
+              style: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "pixel",
+                  "vector",
+                  "hd",
+                  "1-bit",
+                  "isometric"
+                ]
+              },
+              variant: {
+                types: [
+                  "string"
+                ]
+              },
+              dimension: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "2d",
+                  "3d"
+                ]
+              },
+              aspect: {
+                types: [
+                  "string"
+                ],
+                enumValues: [
+                  "1:1",
+                  "16:9",
+                  "5:7",
+                  "8:1"
+                ]
+              },
+              atlas: {
+                types: [
+                  "asset"
+                ]
+              },
+              sprite: {
+                types: [
+                  "string"
+                ]
+              },
+              name: {
+                types: [
+                  "string"
+                ]
+              },
+              thumbnailUrl: {
+                types: [
+                  "string"
+                ]
+              }
+            },
+            required: [
+              "url",
+              "role",
+              "category"
+            ]
+          }
+        },
+        tickMs: {
+          types: [
+            "number"
+          ],
+          description: "The fx mechanic's decay tick period in ms; lifetime = maxTtl \xD7 tickMs. Default 500."
+        },
+        textColor: {
+          types: [
+            "string"
+          ],
+          description: "Floating-message text color when an item declares none. Default `#ffe066`."
+        }
+      },
+      drawable: true,
+      drawHost: true
     }
   },
   categories: [
@@ -47751,7 +48558,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-19T03:03:56.666Z",
+  exportedAt: "2026-08-20T23:14:19.545Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -49144,6 +49951,16 @@ var component_mapping_default = {
       component: "AlgoGraphCanvas",
       importPath: "@/components/learning/molecules/AlgoGraphCanvas",
       category: "learning"
+    },
+    "fx-overlay": {
+      component: "FxOverlay",
+      importPath: "@/components/core/molecules/FxOverlay",
+      category: "container"
+    },
+    "draw-fx-layer": {
+      component: "DrawFxLayer",
+      importPath: "@/components/game/molecules/DrawFxLayer",
+      category: "game"
     }
   }
 };
@@ -49151,7 +49968,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-08-19T03:03:56.666Z",
+  exportedAt: "2026-08-20T23:14:19.545Z",
   contracts: {
     form: {
       emits: [
@@ -50389,6 +51206,7 @@ var PATTERN_TYPES = [
   "doc-sidebar",
   "doc-toc",
   "document-viewer",
+  "draw-fx-layer",
   "draw-group",
   "draw-mesh",
   "draw-shape",
@@ -50424,6 +51242,7 @@ var PATTERN_TYPES = [
   "form-layout",
   "form-section",
   "form-section-header",
+  "fx-overlay",
   "game-audio-toggle",
   "game-hud",
   "game-icon",
@@ -51056,6 +51875,9 @@ function eventListPropsOf(patternType) {
   eventListPropsCache.set(patternType, out);
   return out;
 }
+function getPatternFieldsContract(patternType) {
+  return getPatternDefinition(patternType)?.fieldsContract;
+}
 function isDrawablePattern(patternType) {
   const definition = getPatternDefinition(patternType);
   if (!definition) return false;
@@ -51095,6 +51917,6 @@ function propHostsDrawables(schema) {
   return false;
 }
 
-export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
+export { COMPONENT_MAPPING, EVENT_CONTRACTS, INTEGRATORS_REGISTRY, PATTERN_REGISTRY, PATTERN_TYPES, buildRecommendationContext, collectRenderUiPatternTypes, component_mapping_default as componentMapping, event_contracts_default as eventContracts, eventKeyPropsOf, eventListPropsOf, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternFieldsContract, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integrators_registry_default as integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, isValidPatternType, isValueInputPattern, patterns_registry_default as patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map