@almadar/core 10.110.0 → 10.112.0

package/dist/factory/index.js

@@ -30,6 +30,181 @@ function rehydrateKnobDefs(catalog) {
   }
   return catalog;
 }
+var JsonValueSchema = z.lazy(
+  () => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(JsonValueSchema), z.record(JsonValueSchema)])
+);
+function isJsonObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+// src/factory/merge.ts
+function canonical(v) {
+  if (Array.isArray(v)) return `[${v.map(canonical).join(",")}]`;
+  if (isJsonObject(v)) return `{${Object.keys(v).sort().map((k) => `${JSON.stringify(k)}:${canonical(v[k] ?? null)}`).join(",")}}`;
+  return JSON.stringify(v);
+}
+var same = (a, b) => a === void 0 || b === void 0 ? a === b : canonical(a) === canonical(b);
+function isIdList(v) {
+  return Array.isArray(v) && v.length > 0 && v.every((i) => isJsonObject(i) && typeof i["id"] === "string");
+}
+var idList = (v) => v === void 0 || Array.isArray(v) && v.length === 0 || isIdList(v);
+function mergeParams(base, ours, theirs) {
+  const conflicts = [];
+  const merged = mergeValue([], base, ours, theirs, conflicts);
+  return { merged: merged === void 0 ? null : merged, conflicts };
+}
+function mergeValue(path, base, ours, theirs, conflicts) {
+  if (same(ours, theirs)) return ours;
+  if (same(base, ours)) return theirs;
+  if (same(base, theirs)) return ours;
+  if (ours !== void 0 && theirs !== void 0 && isJsonObject(ours) && isJsonObject(theirs) && (base === void 0 || isJsonObject(base))) {
+    return mergeObject(path, base, ours, theirs, conflicts);
+  }
+  if (ours !== void 0 && theirs !== void 0 && (isIdList(ours) || isIdList(theirs)) && idList(ours) && idList(theirs) && idList(base)) {
+    return mergeIdList(path, base ?? [], ours, theirs, conflicts);
+  }
+  conflicts.push({
+    path,
+    kind: ours === void 0 || theirs === void 0 ? "delete-vs-edit" : "both-changed",
+    base: base ?? null,
+    ours: ours ?? null,
+    theirs: theirs ?? null
+  });
+  return ours;
+}
+function mergeObject(path, base, ours, theirs, conflicts) {
+  const out = {};
+  const keys = [.../* @__PURE__ */ new Set([...Object.keys(base ?? {}), ...Object.keys(ours), ...Object.keys(theirs)])];
+  for (const key of keys) {
+    const value = mergeValue([...path, key], base?.[key], ours[key], theirs[key], conflicts);
+    if (value !== void 0) out[key] = value;
+  }
+  return out;
+}
+var idsOf = (list) => list.map((i) => i.id);
+function mergeIdList(path, base, ours, theirs, conflicts) {
+  const byId = (list) => new Map(list.map((i) => [i.id, i]));
+  const b = byId(base);
+  const o = byId(ours);
+  const t = byId(theirs);
+  const result = /* @__PURE__ */ new Map();
+  for (const id of /* @__PURE__ */ new Set([...b.keys(), ...o.keys(), ...t.keys()])) {
+    const value = mergeValue([...path, id], b.get(id), o.get(id), t.get(id), conflicts);
+    if (value !== void 0) result.set(id, value);
+  }
+  const common = (list) => idsOf(list).filter((id) => b.has(id));
+  const reordered = (list) => canonical(common(list).filter((id) => o.has(id) && t.has(id))) !== canonical(idsOf(base).filter((id) => o.has(id) && t.has(id)));
+  const [primary, secondary] = reordered(ours) || !reordered(theirs) ? [ours, theirs] : [theirs, ours];
+  const order = idsOf(primary).filter((id) => result.has(id));
+  const secondaryIds = idsOf(secondary);
+  secondaryIds.forEach((id, index) => {
+    if (!result.has(id) || order.includes(id)) return;
+    const before = secondaryIds.slice(0, index).reverse().find((prev) => order.includes(prev));
+    order.splice(before === void 0 ? 0 : order.indexOf(before) + 1, 0, id);
+  });
+  for (const id of result.keys()) if (!order.includes(id)) order.push(id);
+  return order.map((id) => result.get(id) ?? null);
+}
+
+// src/factory/lolo-behavior-contracts.ts
+var JS_TO_LOLO_TYPE = {
+  string: "string",
+  number: "number",
+  integer: "number",
+  boolean: "boolean",
+  array: "array",
+  object: "object"
+};
+function jsToLolo(t) {
+  return JS_TO_LOLO_TYPE[t ?? ""] ?? (t || "string");
+}
+function inferConfigType(spec) {
+  if (spec === void 0 || !isJsonObject(spec)) return void 0;
+  const explicit = spec["type"];
+  if (typeof explicit === "string" && explicit.length > 0) return explicit;
+  const d = spec["default"];
+  if (Array.isArray(d)) return "array";
+  if (d === null || d === void 0) return void 0;
+  return typeof d;
+}
+function sortKeysDeep(v) {
+  if (Array.isArray(v)) return v.map(sortKeysDeep);
+  if (isJsonObject(v)) {
+    const out = {};
+    for (const k of Object.keys(v).sort()) out[k] = sortKeysDeep(v[k] ?? null);
+    return out;
+  }
+  return v;
+}
+var objectsOf = (v) => Array.isArray(v) ? v.filter(isJsonObject) : [];
+var objectOf = (v) => v !== void 0 && isJsonObject(v) ? v : {};
+var stringsOf = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+function configTypes(config) {
+  const out = {};
+  for (const [key, spec] of Object.entries(objectOf(config))) out[key] = jsToLolo(inferConfigType(spec));
+  return out;
+}
+function buildLoloBehaviorContracts(catalogs, orbs) {
+  const behaviors = {};
+  const entryFor = (name) => behaviors[name] ?? (behaviors[name] = { traits: {}, pages: [], orbitals: {}, appConfig: {} });
+  for (const raw of catalogs) {
+    const catalog = rehydrateKnobDefs(raw);
+    for (const s of catalog.signatures) {
+      if (!s.organism) continue;
+      const entry = entryFor(s.organism);
+      for (const t of s.traits) {
+        if (t.name in entry.traits) continue;
+        const config = {};
+        for (const ck of t.overridableConfigKeys ?? []) {
+          if (ck?.key) config[ck.key] = jsToLolo(ck.type);
+        }
+        entry.traits[t.name] = { requires: [...t.entityContract?.requires ?? []], config };
+      }
+      for (const p of s.pages) {
+        if (p?.name && !entry.pages.includes(p.name)) entry.pages.push(p.name);
+      }
+    }
+  }
+  for (const entry of Object.values(behaviors)) entry.pages.sort();
+  for (const { name, orb } of orbs) {
+    if (behaviors[name]) continue;
+    const traits = {};
+    const pages = [];
+    for (const orbital of objectsOf(objectOf(orb)["orbitals"])) {
+      for (const t of objectsOf(orbital["traits"])) {
+        const traitName = t["name"];
+        if (typeof traitName !== "string") continue;
+        traits[traitName] = { requires: stringsOf(objectOf(t["entityContract"])["requires"]), config: configTypes(t["config"]) };
+      }
+      for (const p of objectsOf(orbital["pages"])) {
+        if (typeof p["name"] === "string" && p["name"]) pages.push(p["name"]);
+      }
+    }
+    behaviors[name] = { traits, pages, orbitals: {}, appConfig: {} };
+  }
+  for (const { name, orb } of orbs) {
+    const target = entryFor(name);
+    const doc = objectOf(orb);
+    Object.assign(target.appConfig, configTypes(doc["config"]));
+    for (const orbital of objectsOf(doc["orbitals"])) {
+      const orbitalName = orbital["name"];
+      if (typeof orbitalName !== "string" || !orbitalName) continue;
+      target.orbitals[orbitalName] = { config: configTypes(orbital["config"]) };
+    }
+  }
+  return behaviors;
+}
+function serializeLoloBehaviorContracts(behaviors) {
+  const doc = {};
+  for (const [name, b] of Object.entries(behaviors)) {
+    const traits = {};
+    for (const [t, c] of Object.entries(b.traits)) traits[t] = { requires: c.requires, config: c.config };
+    const orbitals = {};
+    for (const [o, c] of Object.entries(b.orbitals)) orbitals[o] = { config: c.config };
+    doc[name] = { traits, pages: b.pages, orbitals, appConfig: b.appConfig };
+  }
+  return JSON.stringify(sortKeysDeep({ behaviors: doc }));
+}
 
 // src/factory/questions/generate.ts
 function generateQuestions(plan, catalog, ruleOverlay, _userPrompt) {
@@ -500,10 +675,10 @@ function applyEntityFields(binding, signature, params) {
     params.entityFields = [...binding.entityFields];
     return;
   }
-  const canonical = new Set(signature.entities[0].fields.map((f) => f.name));
+  const canonical2 = new Set(signature.entities[0].fields.map((f) => f.name));
   const extras = [];
   for (const f of binding.entityFields) {
-    if (f.name && canonical.has(f.name)) continue;
+    if (f.name && canonical2.has(f.name)) continue;
     extras.push(f);
   }
   if (extras.length > 0) params.entityFields = extras;
@@ -1201,6 +1376,12 @@ var patterns_registry_default = {
                 types: [
                   "function"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -1316,6 +1497,12 @@ var patterns_registry_default = {
                   "string"
                 ],
                 kind: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -1636,6 +1823,12 @@ var patterns_registry_default = {
                 types: [
                   "function"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -2133,6 +2326,12 @@ var patterns_registry_default = {
                 types: [
                   "string"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -2470,6 +2669,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -2527,6 +2732,12 @@ var patterns_registry_default = {
                 "ghost",
                 "danger"
               ]
+            },
+            when: {
+              types: [
+                "sexpr",
+                "function"
+              ]
             }
           },
           propertyRequired: [
@@ -2740,6 +2951,13 @@ var patterns_registry_default = {
           ],
           description: "Page title - accepts string or number from generated code accessing dynamic entity data"
         },
+        icon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Icon shown before the title."
+        },
         subtitle: {
           types: [
             "string",
@@ -4827,6 +5045,7 @@ var patterns_registry_default = {
       tier: "molecules",
       family: "core",
       description: "Search input with events",
+      minUsableWidth: 160,
       suggestedFor: [
         "search functionality",
         "quick filters"
@@ -7338,6 +7557,13 @@ var patterns_registry_default = {
             "full-screen"
           ],
           default: "centered-card"
+        },
+        contained: {
+          types: [
+            "boolean"
+          ],
+          description: "Render inside the nearest positioned ancestor (a preview frame) instead of portaling over the whole window; page scroll is left alone.",
+          default: false
         }
       }
     },
@@ -7362,6 +7588,21 @@ var patterns_registry_default = {
           description: "Whether the drawer is open (defaults to true when rendered by slot wrapper)",
           default: true
         },
+        onExited: {
+          types: [
+            "function"
+          ],
+          description: "Fires after the exit animation completes (the drawer is about to unmount).",
+          kind: "callback",
+          callbackArgs: []
+        },
+        contained: {
+          types: [
+            "boolean"
+          ],
+          description: "Render inside the nearest positioned ancestor (a preview frame) instead of over the window.",
+          default: false
+        },
         onClose: {
           types: [
             "function"
@@ -7471,6 +7712,14 @@ var patterns_registry_default = {
           kind: "callback",
           callbackArgs: []
         },
+        onExited: {
+          types: [
+            "function"
+          ],
+          description: "Fires after the exit animation completes (the dialog is about to unmount).",
+          kind: "callback",
+          callbackArgs: []
+        },
         onConfirm: {
           types: [
             "function"
@@ -15417,6 +15666,19 @@ var patterns_registry_default = {
           description: 'Format X-axis labels as time (ISO date in \u2192 "Mar 2026"-style label out)',
           default: false
         },
+        period: {
+          types: [
+            "string"
+          ],
+          description: 'Bucket granularity of a time axis \u2014 labels read "Oct 2", "Week of Sep 28", "Oct 2026", "Q4 2026" or "2026"',
+          enumValues: [
+            "day",
+            "week",
+            "month",
+            "quarter",
+            "year"
+          ]
+        },
         drillEvent: {
           types: [
             "string"
@@ -18744,6 +19006,52 @@ var patterns_registry_default = {
             }
           ]
         },
+        onTransitionClick: {
+          types: [
+            "function"
+          ],
+          description: "Direct transition-click callback, for React hosts (e.g. a canvas node).",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "transition",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  index: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  event: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  from: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  to: {
+                    types: [
+                      "string"
+                    ]
+                  }
+                },
+                required: [
+                  "index",
+                  "event",
+                  "from",
+                  "to"
+                ]
+              }
+            }
+          ]
+        },
         selectedState: {
           types: [
             "string"
@@ -20024,6 +20332,7 @@ var patterns_registry_default = {
       description: "DataGrid \u2014 structured records grid rendering rows over configurable columns, with sort, select, and drag-reorder.",
       capabilities: "admin table, records grid, user list, CRUD list, manage-records view, spreadsheet-style data grid, sortable columns",
       fieldsContract: "display",
+      minUsableWidth: 200,
       suggestedFor: [
         "data",
         "grid",
@@ -20079,6 +20388,47 @@ var patterns_registry_default = {
           ],
           description: "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
+        emptyIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Domain icon for the empty state."
+        },
+        emptyTitle: {
+          types: [
+            "string"
+          ],
+          description: 'Specific title ("No orders yet").'
+        },
+        emptyDescription: {
+          types: [
+            "string"
+          ],
+          description: "What will appear here once rows exist."
+        },
+        emptyAction: {
+          types: [
+            "object"
+          ],
+          description: "Create-the-first-item action.",
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            event: {
+              types: [
+                "string"
+              ],
+              kind: "event"
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
         entity: {
           types: [
             "object",
@@ -20269,6 +20619,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -20532,6 +20888,7 @@ var patterns_registry_default = {
       family: "core",
       description: "DataList component",
       fieldsContract: "display",
+      minUsableWidth: 200,
       suggestedFor: [
         "data",
         "list",
@@ -20588,6 +20945,47 @@ var patterns_registry_default = {
           ],
           description: "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
+        emptyIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Domain icon for the empty state."
+        },
+        emptyTitle: {
+          types: [
+            "string"
+          ],
+          description: 'Specific title ("No orders yet").'
+        },
+        emptyDescription: {
+          types: [
+            "string"
+          ],
+          description: "What will appear here once rows exist."
+        },
+        emptyAction: {
+          types: [
+            "object"
+          ],
+          description: "Create-the-first-item action.",
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            event: {
+              types: [
+                "string"
+              ],
+              kind: "event"
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
         entity: {
           types: [
             "object",
@@ -20753,6 +21151,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -22777,14 +23181,19 @@ var patterns_registry_default = {
                 ],
                 eventPayloadBrand: true,
                 payloadFor: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
               "label",
               "event"
             ]
-          },
-          default: []
+          }
         },
         rightActions: {
           types: [
@@ -22832,14 +23241,19 @@ var patterns_registry_default = {
                 ],
                 eventPayloadBrand: true,
                 payloadFor: "event"
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
               "label",
               "event"
             ]
-          },
-          default: []
+          }
         },
         threshold: {
           types: [
@@ -23876,6 +24290,12 @@ var patterns_registry_default = {
           propertyRequired: [
             "enabled"
           ]
+        },
+        pageKey: {
+          types: [
+            "string"
+          ],
+          description: "The current page (path or name). When set, the main slot's content animates in on every page change (`PageTransition`); a layout's own content region claims the transition so its chrome stays still."
         }
       }
     },
@@ -34387,6 +34807,7 @@ var patterns_registry_default = {
       description: "TableView \u2014 sortable, selectable data table rendering rows over configurable columns, with inline row actions and grouping.",
       capabilities: "admin console table, records list, CRUD data table, user list, manage-users grid, sortable columns, row selection with bulk actions, grouped list view",
       fieldsContract: "display",
+      minUsableWidth: 240,
       suggestedFor: [
         "table",
         "view",
@@ -34442,6 +34863,47 @@ var patterns_registry_default = {
           ],
           description: "Mark this container as the DnD root for its subtree \u2014 descendant zones share one DndContext (cross-container drag). Use on an outer container whose own items are not draggable."
         },
+        emptyIcon: {
+          types: [
+            "icon",
+            "string"
+          ],
+          description: "Domain icon for the empty state."
+        },
+        emptyTitle: {
+          types: [
+            "string"
+          ],
+          description: 'Specific title ("No orders yet").'
+        },
+        emptyDescription: {
+          types: [
+            "string"
+          ],
+          description: "What will appear here once rows exist."
+        },
+        emptyAction: {
+          types: [
+            "object"
+          ],
+          description: "Create-the-first-item action.",
+          properties: {
+            label: {
+              types: [
+                "string"
+              ]
+            },
+            event: {
+              types: [
+                "string"
+              ],
+              kind: "event"
+            }
+          },
+          propertyRequired: [
+            "label"
+          ]
+        },
         entity: {
           types: [
             "object",
@@ -34671,6 +35133,12 @@ var patterns_registry_default = {
                   "ghost",
                   "danger"
                 ]
+              },
+              when: {
+                types: [
+                  "sexpr",
+                  "function"
+                ]
               }
             },
             required: [
@@ -47754,6 +48222,37 @@ var patterns_registry_default = {
       ],
       typicalSize: "small",
       propsSchema: {
+        animation: {
+          types: [
+            "string"
+          ],
+          description: "Which motion preset to use (maps to `animate-<name>-in/out`).",
+          required: true,
+          enumValues: [
+            "modal",
+            "overlay",
+            "slide-up",
+            "drawer",
+            "popover",
+            "toast",
+            "fade",
+            "page"
+          ]
+        },
+        animate: {
+          types: [
+            "boolean"
+          ],
+          description: "Per-instance opt-out. Global opt-out is `--motion-enable` / reduced-motion. @default true"
+        },
+        onExited: {
+          types: [
+            "function"
+          ],
+          description: "Fired after the exit animation completes (before unmount).",
+          kind: "callback",
+          callbackArgs: []
+        },
         show: {
           types: [
             "boolean"
@@ -47794,7 +48293,7 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "Value that changes on navigation (e.g. `location.pathname`).",
+          description: "Value that changes on navigation (a page path).",
           required: true
         },
         children: {
@@ -51331,9 +51830,10 @@ var patterns_registry_default = {
         },
         children: {
           types: [
-            "node"
+            "node",
+            "function"
           ],
-          description: "Compiled mode: render children directly instead of resolving from context"
+          description: "Compiled mode: render children directly instead of resolving from context. A function receives the slot's presence \u2014 compiled self-overlaying content (Modal / ConfirmDialog) takes it as `isOpen`/`onExited` to play its exit."
         },
         pattern: {
           types: [
@@ -52583,14 +53083,15 @@ var patterns_registry_default = {
           types: [
             "string"
           ],
-          description: "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot).",
+          description: "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot, a merge of a teammate's work).",
           enumValues: [
             "user",
             "agent",
             "restore",
             "undo",
             "redo",
-            "snapshot"
+            "snapshot",
+            "merge"
           ]
         },
         additions: {
@@ -53014,6 +53515,52 @@ var patterns_registry_default = {
             }
           ]
         },
+        onTransitionClick: {
+          types: [
+            "function"
+          ],
+          description: "Direct transition-click callback, for React hosts (e.g. a canvas node).",
+          kind: "callback",
+          callbackArgs: [
+            {
+              name: "transition",
+              type: "object",
+              schema: {
+                types: [
+                  "object"
+                ],
+                properties: {
+                  index: {
+                    types: [
+                      "number"
+                    ]
+                  },
+                  event: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  from: {
+                    types: [
+                      "string"
+                    ]
+                  },
+                  to: {
+                    types: [
+                      "string"
+                    ]
+                  }
+                },
+                required: [
+                  "index",
+                  "event",
+                  "from",
+                  "to"
+                ]
+              }
+            }
+          ]
+        },
         selectedState: {
           types: [
             "string"
@@ -53174,9 +53721,6 @@ var patterns_registry_default = {
       }
     }
   }};
-var JsonValueSchema = z.lazy(
-  () => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(JsonValueSchema), z.record(JsonValueSchema)])
-);
 
 // src/patterns/helpers/prompt-helpers.ts
 function getAllPatternTypes() {
@@ -53585,7 +54129,7 @@ var SExprAtomSchema = z.union([
 var SExprSchema = z.lazy(
   () => z.union([
     SExprAtomSchema,
-    z.array(z.lazy(() => SExprSchema)).min(1).refine(
+    z.array(SExprDataSchema).min(1).refine(
       (arr) => typeof arr[0] === "string",
       { message: "S-expression array must have a string operator as first element" }
     )
@@ -54165,6 +54709,6 @@ var PAGE_OVERRIDE_SCHEMA = {
   }
 };
 
-export { answerToMutations, answersToMutations, applyFactoryCallPlanMutation, assertNoUnsatisfiableEnum, deriveInputType, diffFactoryCalls, generateQuestions, rehydrateKnobDefs, signatureToParamsSchema, translateOverlaysToParams };
+export { answerToMutations, answersToMutations, applyFactoryCallPlanMutation, assertNoUnsatisfiableEnum, buildLoloBehaviorContracts, deriveInputType, diffFactoryCalls, generateQuestions, inferConfigType, mergeParams, rehydrateKnobDefs, serializeLoloBehaviorContracts, signatureToParamsSchema, sortKeysDeep, translateOverlaysToParams };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map