@almadar/core 10.31.0 → 10.32.0

package/dist/patterns/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-21T09:54:57.379Z",
+  "exportedAt": "2026-07-23T14:32:35.644Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -3499,7 +3499,8 @@
           "types": [
             "string"
           ],
-          "description": "Event name to dispatch on search (schema metadata, wired by trait) This is metadata used by the trait generator, not by the component."
+          "description": "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)",
+          "kind": "event"
         },
         "entity": {
           "types": [
@@ -3658,6 +3659,20 @@
             "inline-column-header"
           ],
           "default": "toolbar"
+        },
+        "event": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
+          "kind": "event"
+        },
+        "clearEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
+          "kind": "event"
         }
       }
     },
@@ -5721,9 +5736,9 @@
         },
         "title": {
           "types": [
-            "string"
+            "node"
           ],
-          "description": "Drawer title"
+          "description": "Drawer title (text or any node, e.g. a brand logo + name)."
         },
         "children": {
           "types": [
@@ -9733,8 +9748,9 @@
           "types": [
             "string"
           ],
-          "description": "Font weight override",
+          "description": "Font weight override — `none` = no override, the variant's baked weight applies",
           "enumValues": [
+            "none",
             "light",
             "normal",
             "medium",
@@ -9748,6 +9764,7 @@
           ],
           "description": "Font size override",
           "enumValues": [
+            "none",
             "xs",
             "sm",
             "md",
@@ -15219,37 +15236,7 @@
           "types": [
             "string"
           ],
-          "description": "Programming language for syntax highlighting",
-          "enumValues": [
-            "text",
-            "json",
-            "javascript",
-            "js",
-            "typescript",
-            "ts",
-            "jsx",
-            "tsx",
-            "css",
-            "markdown",
-            "md",
-            "bash",
-            "shell",
-            "sh",
-            "yaml",
-            "yml",
-            "rust",
-            "python",
-            "py",
-            "sql",
-            "diff",
-            "toml",
-            "go",
-            "graphql",
-            "html",
-            "xml",
-            "orb",
-            "lolo"
-          ],
+          "description": "Programming language for syntax highlighting (any Prism id; loaded on demand if not pre-registered)",
           "default": "text"
         },
         "showCopyButton": {
@@ -15450,6 +15437,58 @@
                   "graphql",
                   "html",
                   "xml",
+                  "clojure",
+                  "clj",
+                  "edn",
+                  "haskell",
+                  "hs",
+                  "lisp",
+                  "scheme",
+                  "scala",
+                  "elixir",
+                  "ex",
+                  "exs",
+                  "erlang",
+                  "erl",
+                  "elm",
+                  "fsharp",
+                  "fs",
+                  "fsx",
+                  "ocaml",
+                  "ml",
+                  "java",
+                  "c",
+                  "cpp",
+                  "c++",
+                  "cc",
+                  "cxx",
+                  "hpp",
+                  "h",
+                  "csharp",
+                  "cs",
+                  "objectivec",
+                  "objc",
+                  "php",
+                  "ruby",
+                  "rb",
+                  "swift",
+                  "kotlin",
+                  "kt",
+                  "lua",
+                  "r",
+                  "dart",
+                  "julia",
+                  "fortran",
+                  "f90",
+                  "f95",
+                  "perl",
+                  "pl",
+                  "powershell",
+                  "ps1",
+                  "makefile",
+                  "make",
+                  "nginx",
+                  "ini",
                   "orb",
                   "lolo"
                 ]
@@ -17101,6 +17140,11 @@
                   "string"
                 ]
               },
+              "navigatesTo": {
+                "types": [
+                  "string"
+                ]
+              },
               "icon": {
                 "types": [
                   "icon",
@@ -17261,7 +17305,7 @@
           "types": [
             "function"
           ],
-          "description": "Render prop for custom per-card content. When provided, `fields` and `itemActions` are ignored.",
+          "description": "Render prop for custom per-card content. When provided, `fields` are ignored; `itemActions` render as a footer beneath the custom content.",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -34016,22 +34060,6 @@
           "items": {
             "types": [
               "object"
-            ],
-            "properties": {
-              "type": {
-                "types": [
-                  "unknown"
-                ]
-              },
-              "content": {
-                "types": [
-                  "string"
-                ]
-              }
-            },
-            "required": [
-              "type",
-              "content"
             ]
           }
         },
@@ -34051,34 +34079,7 @@
           "types": [
             "object"
           ],
-          "description": "User progress for restoring activation/reflection state",
-          "properties": {
-            "activationResponse": {
-              "types": [
-                "string"
-              ]
-            },
-            "reflectionNotes": {
-              "types": [
-                "array"
-              ],
-              "items": {
-                "types": [
-                  "string"
-                ]
-              }
-            },
-            "bloomAnswered": {
-              "types": [
-                "object"
-              ],
-              "mapValue": {
-                "types": [
-                  "boolean"
-                ]
-              }
-            }
-          }
+          "description": "User progress for restoring activation/reflection state"
         },
         "onRunCodeSimulation": {
           "types": [
@@ -34107,7 +34108,7 @@
           "callbackArgs": [
             {
               "name": "type",
-              "type": "string"
+              "type": "object"
             },
             {
               "name": "description",

package/dist/patterns/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-21T09:54:57.379Z",
+  "exportedAt": "2026-07-23T14:32:35.644Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -3499,7 +3499,8 @@
           "types": [
             "string"
           ],
-          "description": "Event name to dispatch on search (schema metadata, wired by trait) This is metadata used by the trait generator, not by the component."
+          "description": "Declarative search event — emits UI:{event} via eventBus on query submit (alongside canonical UI:SEARCH)",
+          "kind": "event"
         },
         "entity": {
           "types": [
@@ -3658,6 +3659,20 @@
             "inline-column-header"
           ],
           "default": "toolbar"
+        },
+        "event": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
+          "kind": "event"
+        },
+        "clearEvent": {
+          "types": [
+            "string"
+          ],
+          "description": "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
+          "kind": "event"
         }
       }
     },
@@ -5721,9 +5736,9 @@
         },
         "title": {
           "types": [
-            "string"
+            "node"
           ],
-          "description": "Drawer title"
+          "description": "Drawer title (text or any node, e.g. a brand logo + name)."
         },
         "children": {
           "types": [
@@ -9733,8 +9748,9 @@
           "types": [
             "string"
           ],
-          "description": "Font weight override",
+          "description": "Font weight override — `none` = no override, the variant's baked weight applies",
           "enumValues": [
+            "none",
             "light",
             "normal",
             "medium",
@@ -9748,6 +9764,7 @@
           ],
           "description": "Font size override",
           "enumValues": [
+            "none",
             "xs",
             "sm",
             "md",
@@ -15219,37 +15236,7 @@
           "types": [
             "string"
           ],
-          "description": "Programming language for syntax highlighting",
-          "enumValues": [
-            "text",
-            "json",
-            "javascript",
-            "js",
-            "typescript",
-            "ts",
-            "jsx",
-            "tsx",
-            "css",
-            "markdown",
-            "md",
-            "bash",
-            "shell",
-            "sh",
-            "yaml",
-            "yml",
-            "rust",
-            "python",
-            "py",
-            "sql",
-            "diff",
-            "toml",
-            "go",
-            "graphql",
-            "html",
-            "xml",
-            "orb",
-            "lolo"
-          ],
+          "description": "Programming language for syntax highlighting (any Prism id; loaded on demand if not pre-registered)",
           "default": "text"
         },
         "showCopyButton": {
@@ -15450,6 +15437,58 @@
                   "graphql",
                   "html",
                   "xml",
+                  "clojure",
+                  "clj",
+                  "edn",
+                  "haskell",
+                  "hs",
+                  "lisp",
+                  "scheme",
+                  "scala",
+                  "elixir",
+                  "ex",
+                  "exs",
+                  "erlang",
+                  "erl",
+                  "elm",
+                  "fsharp",
+                  "fs",
+                  "fsx",
+                  "ocaml",
+                  "ml",
+                  "java",
+                  "c",
+                  "cpp",
+                  "c++",
+                  "cc",
+                  "cxx",
+                  "hpp",
+                  "h",
+                  "csharp",
+                  "cs",
+                  "objectivec",
+                  "objc",
+                  "php",
+                  "ruby",
+                  "rb",
+                  "swift",
+                  "kotlin",
+                  "kt",
+                  "lua",
+                  "r",
+                  "dart",
+                  "julia",
+                  "fortran",
+                  "f90",
+                  "f95",
+                  "perl",
+                  "pl",
+                  "powershell",
+                  "ps1",
+                  "makefile",
+                  "make",
+                  "nginx",
+                  "ini",
                   "orb",
                   "lolo"
                 ]
@@ -17101,6 +17140,11 @@
                   "string"
                 ]
               },
+              "navigatesTo": {
+                "types": [
+                  "string"
+                ]
+              },
               "icon": {
                 "types": [
                   "icon",
@@ -17261,7 +17305,7 @@
           "types": [
             "function"
           ],
-          "description": "Render prop for custom per-card content. When provided, `fields` and `itemActions` are ignored.",
+          "description": "Render prop for custom per-card content. When provided, `fields` are ignored; `itemActions` render as a footer beneath the custom content.",
           "kind": "callback",
           "callbackArgs": [
             {
@@ -34016,22 +34060,6 @@
           "items": {
             "types": [
               "object"
-            ],
-            "properties": {
-              "type": {
-                "types": [
-                  "unknown"
-                ]
-              },
-              "content": {
-                "types": [
-                  "string"
-                ]
-              }
-            },
-            "required": [
-              "type",
-              "content"
             ]
           }
         },
@@ -34051,34 +34079,7 @@
           "types": [
             "object"
           ],
-          "description": "User progress for restoring activation/reflection state",
-          "properties": {
-            "activationResponse": {
-              "types": [
-                "string"
-              ]
-            },
-            "reflectionNotes": {
-              "types": [
-                "array"
-              ],
-              "items": {
-                "types": [
-                  "string"
-                ]
-              }
-            },
-            "bloomAnswered": {
-              "types": [
-                "object"
-              ],
-              "mapValue": {
-                "types": [
-                  "boolean"
-                ]
-              }
-            }
-          }
+          "description": "User progress for restoring activation/reflection state"
         },
         "onRunCodeSimulation": {
           "types": [
@@ -34107,7 +34108,7 @@
           "callbackArgs": [
             {
               "name": "type",
-              "type": "string"
+              "type": "object"
             },
             {
               "name": "description",

package/dist/state-machine/index.d.ts

@@ -1,4 +1,4 @@
-import { E as EventPayload, S as SExpr } from '../expression-CB9R3KWk.js';
+import { c as EventPayload, S as SExpr } from '../expression-BlFrxmNB.js';
 import 'zod';
 
 /**
@@ -216,6 +216,17 @@ declare function walkStatePairs(transitions: GraphTransition[], initialState: st
  * extractPayloadFieldRef('@user.name'); // returns null
  */
 declare function extractPayloadFieldRef(ref: unknown): string | null;
+/**
+ * Full dotted path of a payload reference — `'@payload.data.providerName'`
+ * → `['data', 'providerName']`. `extractPayloadFieldRef` keeps only the
+ * first segment, which made every guard on a NESTED payload field
+ * unsatisfiable by synthesis: `when ?data.providerName` was seeded as
+ * `{data: 'mock-test-value'}`, the runtime read `.providerName` off a
+ * string, and the pass-case dispatch was correctly rejected (std-booking
+ * BookingWizard NEXT — the whole step chain became unwalkable). Returns
+ * `null` for non-payload references.
+ */
+declare function extractPayloadFieldPath(ref: unknown): string[] | null;
 /**
  * Builds test payloads that satisfy or violate guard conditions.
  *
@@ -344,4 +355,4 @@ declare function buildReplayPaths(transitions: ReplayTransition[], initialState:
  */
 declare function buildEdgeCoveringWalk(transitions: EdgeWalkTransition[], initialState: string): WalkStep[];
 
-export { type BFSNode, type BFSPathNode, type EdgeWalkTransition, type GraphTransition, type GuardPayload, type PayloadFieldSchema, type ReplayStep, type ReplayTransition, type StateEdge, type WalkStep, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, constTruth, extractPayloadFieldRef, walkStatePairs };
+export { type BFSNode, type BFSPathNode, type EdgeWalkTransition, type GraphTransition, type GuardPayload, type PayloadFieldSchema, type ReplayStep, type ReplayTransition, type StateEdge, type WalkStep, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, constTruth, extractPayloadFieldPath, extractPayloadFieldRef, walkStatePairs };

package/dist/state-machine/index.js

@@ -59,6 +59,29 @@ function extractPayloadFieldRef(ref) {
   const match = ref.match(/^@payload\.([A-Za-z0-9_]+)/);
   return match ? match[1] : null;
 }
+function extractPayloadFieldPath(ref) {
+  if (typeof ref !== "string") return null;
+  const match = ref.match(/^@payload\.([A-Za-z0-9_]+(?:\.[A-Za-z0-9_]+)*)/);
+  return match ? match[1].split(".") : null;
+}
+function nestedPayload(path, leaf) {
+  let value = leaf;
+  for (let i = path.length - 1; i >= 1; i--) {
+    value = { [path[i]]: value };
+  }
+  return { [path[0]]: value };
+}
+function isPayloadObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v) && !(v instanceof Date);
+}
+function mergePayloads(a, b) {
+  const out = { ...a };
+  for (const [k, v] of Object.entries(b)) {
+    const prev = out[k];
+    out[k] = prev !== void 0 && isPayloadObject(prev) && v !== void 0 && isPayloadObject(v) ? mergePayloads(prev, v) : v;
+  }
+  return out;
+}
 function constTruth(guard) {
   if (typeof guard === "boolean") return guard;
   if (typeof guard === "string") {
@@ -97,62 +120,64 @@ function buildGuardPayloads(guard) {
     return { pass: {}, fail: {} };
   }
   if (typeof guard === "string") {
-    const field = extractPayloadFieldRef(guard);
-    if (field) return { pass: { [field]: { id: "mock-test-id", name: "mock-test-name" } }, fail: { [field]: null } };
+    const path = extractPayloadFieldPath(guard);
+    if (path) {
+      return path.length === 1 ? { pass: { [path[0]]: { id: "mock-test-id", name: "mock-test-name" } }, fail: { [path[0]]: null } } : { pass: nestedPayload(path, "mock-test-value"), fail: nestedPayload(path, null) };
+    }
   }
   if (!Array.isArray(guard) || guard.length === 0) {
     return { pass: {}, fail: {} };
   }
   const op = String(guard[0]);
   if (op === "not-nil" || op === "not_nil") {
-    const field = extractPayloadFieldRef(guard[1]);
-    if (field) return { pass: { [field]: "mock-test-value" }, fail: { [field]: null } };
+    const path = extractPayloadFieldPath(guard[1]);
+    if (path) return { pass: nestedPayload(path, "mock-test-value"), fail: nestedPayload(path, null) };
   }
   if (op === "nil") {
-    const field = extractPayloadFieldRef(guard[1]);
-    if (field) return { pass: {}, fail: { [field]: "mock-test-value" } };
+    const path = extractPayloadFieldPath(guard[1]);
+    if (path) return { pass: {}, fail: nestedPayload(path, "mock-test-value") };
   }
   if (op === "eq" || op === "==" || op === "=") {
-    const field = extractPayloadFieldRef(guard[1]);
+    const path = extractPayloadFieldPath(guard[1]);
     const val = guard[2];
-    if (field && val !== void 0) {
+    if (path && val !== void 0) {
       const failVal = typeof val === "number" ? val + 1 : typeof val === "string" ? `not-${val}` : null;
-      return { pass: { [field]: val }, fail: { [field]: failVal } };
+      return { pass: nestedPayload(path, val), fail: nestedPayload(path, failVal) };
     }
   }
   if (op === "not-eq" || op === "!=" || op === "neq") {
-    const field = extractPayloadFieldRef(guard[1]);
+    const path = extractPayloadFieldPath(guard[1]);
     const val = guard[2];
-    if (field && val !== void 0) {
+    if (path && val !== void 0) {
       const passVal = typeof val === "number" ? val + 1 : typeof val === "string" ? `not-${val}` : "other";
-      return { pass: { [field]: passVal }, fail: { [field]: val } };
+      return { pass: nestedPayload(path, passVal), fail: nestedPayload(path, val) };
     }
   }
   if (op === "gt" || op === ">") {
-    const field = extractPayloadFieldRef(guard[1]);
+    const path = extractPayloadFieldPath(guard[1]);
     const n = typeof guard[2] === "number" ? guard[2] : 0;
-    if (field) return { pass: { [field]: n + 1 }, fail: { [field]: n - 1 } };
+    if (path) return { pass: nestedPayload(path, n + 1), fail: nestedPayload(path, n - 1) };
   }
   if (op === "gte" || op === ">=") {
-    const field = extractPayloadFieldRef(guard[1]);
+    const path = extractPayloadFieldPath(guard[1]);
     const n = typeof guard[2] === "number" ? guard[2] : 0;
-    if (field) return { pass: { [field]: n }, fail: { [field]: n - 1 } };
+    if (path) return { pass: nestedPayload(path, n), fail: nestedPayload(path, n - 1) };
   }
   if (op === "lt" || op === "<") {
-    const field = extractPayloadFieldRef(guard[1]);
+    const path = extractPayloadFieldPath(guard[1]);
     const n = typeof guard[2] === "number" ? guard[2] : 0;
-    if (field) return { pass: { [field]: n - 1 }, fail: { [field]: n + 1 } };
+    if (path) return { pass: nestedPayload(path, n - 1), fail: nestedPayload(path, n + 1) };
   }
   if (op === "lte" || op === "<=") {
-    const field = extractPayloadFieldRef(guard[1]);
+    const path = extractPayloadFieldPath(guard[1]);
     const n = typeof guard[2] === "number" ? guard[2] : 0;
-    if (field) return { pass: { [field]: n }, fail: { [field]: n + 1 } };
+    if (path) return { pass: nestedPayload(path, n), fail: nestedPayload(path, n + 1) };
   }
   if (op === "and") {
     const subs = guard.slice(1);
     if (subs.length >= 2) {
       const built = subs.map(buildGuardPayloads);
-      const pass = built.reduce((acc, b) => ({ ...acc, ...b.pass }), {});
+      const pass = built.reduce((acc, b) => mergePayloads(acc, b.pass), {});
       return { pass, fail: built[0].fail };
     }
     if (subs.length === 1) return buildGuardPayloads(subs[0]);
@@ -163,7 +188,7 @@ function buildGuardPayloads(guard) {
       const s1 = buildGuardPayloads(subs[0]);
       const s2 = buildGuardPayloads(subs[1]);
       const combinedPass = Object.keys(s1.pass).length > 0 ? s1.pass : s2.pass;
-      return { pass: combinedPass, fail: { ...s1.fail, ...s2.fail } };
+      return { pass: combinedPass, fail: mergePayloads(s1.fail, s2.fail) };
     }
     if (subs.length === 1) return buildGuardPayloads(subs[0]);
   }
@@ -385,6 +410,6 @@ function buildPayloadForEdge(transition, guardCase) {
   return {};
 }
 
-export { buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, constTruth, extractPayloadFieldRef, walkStatePairs };
+export { buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, constTruth, extractPayloadFieldPath, extractPayloadFieldRef, walkStatePairs };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map