@almadar/core 10.83.0 → 10.85.0

package/dist/index.js

@@ -1325,6 +1325,14 @@ var EntityFieldContractSchema = z.object({
   requires: z.array(z.string()),
   provides: z.array(z.string())
 });
+var EffectSiteSchema = z.enum(["transition", "tick"]);
+var EffectUseSchema = z.object({
+  kind: z.string(),
+  resource: z.string().optional(),
+  resolved: z.boolean().optional(),
+  site: EffectSiteSchema.optional()
+});
+var EffectRowSchema = z.array(EffectUseSchema);
 var SourceBehaviorMetadataSchema = z.object({
   behavior: z.string().min(1),
   alias: z.string().min(1),
@@ -1343,6 +1351,7 @@ var TraitSchema = z.object({
   category: TraitCategorySchema.optional(),
   entityRebindable: z.boolean().optional(),
   entityContract: EntityFieldContractSchema.optional(),
+  effectRow: EffectRowSchema.optional(),
   entityBindingDescription: z.string().optional(),
   entityBindingSynonyms: z.string().optional(),
   capabilities: z.array(z.string()).optional(),
@@ -2475,7 +2484,7 @@ function getInteractionModelForDomain(domain) {
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-04T03:53:29.561Z",
+  exportedAt: "2026-09-05T01:37:56.135Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -11756,6 +11765,11 @@ var patterns_registry_default = {
                   "boolean"
                 ]
               },
+              title: {
+                types: [
+                  "string"
+                ]
+              },
               onClick: {
                 types: [
                   "function"
@@ -19237,7 +19251,8 @@ var patterns_registry_default = {
                 "paragraph-forward",
                 "paragraph-back",
                 "line",
-                "selection"
+                "selection",
+                "match-bracket"
               ]
             },
             {
@@ -19268,7 +19283,16 @@ var patterns_registry_default = {
               enumValues: [
                 "delete",
                 "yank",
-                "change"
+                "change",
+                "put",
+                "put-before",
+                "undo",
+                "redo",
+                "join",
+                "toggle-case",
+                "indent",
+                "dedent",
+                "replace"
               ]
             },
             {
@@ -19291,7 +19315,8 @@ var patterns_registry_default = {
                 "paragraph-forward",
                 "paragraph-back",
                 "line",
-                "selection"
+                "selection",
+                "match-bracket"
               ]
             },
             {
@@ -19380,7 +19405,8 @@ var patterns_registry_default = {
               "paragraph-forward",
               "paragraph-back",
               "line",
-              "selection"
+              "selection",
+              "match-bracket"
             ]
           },
           default: [
@@ -19399,7 +19425,8 @@ var patterns_registry_default = {
             "paragraph-forward",
             "paragraph-back",
             "line",
-            "selection"
+            "selection",
+            "match-bracket"
           ],
           tier: "presentation"
         },
@@ -19415,13 +19442,31 @@ var patterns_registry_default = {
             enumValues: [
               "delete",
               "yank",
-              "change"
+              "change",
+              "put",
+              "put-before",
+              "undo",
+              "redo",
+              "join",
+              "toggle-case",
+              "indent",
+              "dedent",
+              "replace"
             ]
           },
           default: [
             "delete",
             "yank",
-            "change"
+            "change",
+            "put",
+            "put-before",
+            "undo",
+            "redo",
+            "join",
+            "toggle-case",
+            "indent",
+            "dedent",
+            "replace"
           ],
           tier: "presentation"
         }
@@ -54695,7 +54740,10 @@ var patterns_registry_default = {
           enumValues: [
             "bottom-center",
             "bottom-left",
-            "bottom-right"
+            "bottom-right",
+            "top-center",
+            "top-left",
+            "top-right"
           ],
           default: "bottom-center"
         },
@@ -55258,6 +55306,139 @@ var patterns_registry_default = {
           description: "Base URL prepended to every manifest path."
         }
       }
+    },
+    "ui-slot-component": {
+      type: "ui-slot-component",
+      category: "layout",
+      tier: "organisms",
+      family: "core",
+      description: "UISlotComponent component",
+      suggestedFor: [
+        "slot",
+        "component",
+        "u i slot component"
+      ],
+      typicalSize: "large",
+      propsSchema: {
+        slot: {
+          types: [
+            "object"
+          ],
+          description: "slot prop",
+          required: true
+        },
+        portal: {
+          types: [
+            "boolean"
+          ],
+          description: "portal prop",
+          default: false
+        },
+        position: {
+          types: [
+            "string"
+          ],
+          description: "position prop",
+          enumValues: [
+            "left",
+            "right",
+            "top-right",
+            "top-left",
+            "bottom-right",
+            "bottom-left"
+          ]
+        },
+        className: {
+          types: [
+            "string"
+          ],
+          description: "className prop"
+        },
+        draggable: {
+          types: [
+            "boolean"
+          ],
+          description: "draggable prop"
+        },
+        isLoading: {
+          types: [
+            "boolean"
+          ],
+          description: "isLoading prop"
+        },
+        error: {
+          types: [
+            "object"
+          ],
+          description: "error prop",
+          properties: {
+            message: {
+              types: [
+                "string"
+              ]
+            },
+            name: {
+              types: [
+                "string"
+              ]
+            },
+            code: {
+              types: [
+                "string"
+              ]
+            },
+            stack: {
+              types: [
+                "string"
+              ]
+            }
+          },
+          propertyRequired: [
+            "message"
+          ]
+        },
+        entity: {
+          types: [
+            "string"
+          ],
+          description: "entity prop"
+        },
+        children: {
+          types: [
+            "node"
+          ],
+          description: "Compiled mode: render children directly instead of resolving from context"
+        },
+        pattern: {
+          types: [
+            "string"
+          ],
+          description: "Pattern type for data-pattern attribute (compiled mode)"
+        },
+        sourceTrait: {
+          types: [
+            "string"
+          ],
+          description: "Source trait name for data-source-trait attribute (compiled mode)"
+        },
+        fallback: {
+          types: [
+            "node"
+          ],
+          description: "Host-supplied stock content for a slot-host region (Studio V4 \xA714 Part I2). Ignored whenever `children` is passed \u2014 `children` (compiled mode) always wins, so a compiled organism's slot can never be silently shadowed by a host `fallback`. In `portal` mode `fallback` never portals: it paints inline at this component's own position in the tree, while slot content (if present) still portals as usual \u2014 a plugin filling `modal` doesn't relocate the host's inline empty-state."
+        },
+        mode: {
+          types: [
+            "string"
+          ],
+          description: "`'replace'` (default): slot content when present, else `fallback`. `'append'`: `fallback` first, then slot content when present \u2014 both render together, so `fallback` is a fixture, not just a placeholder.",
+          enumValues: [
+            "replace",
+            "append"
+          ],
+          default: "replace"
+        }
+      }
     }
   },
   categories: [
@@ -58801,7 +58982,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-04T03:53:29.561Z",
+  exportedAt: "2026-09-05T01:37:56.135Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -60234,6 +60415,11 @@ var component_mapping_default = {
       component: "GameAudioCue",
       importPath: "@/components/game/atoms/GameAudioCue",
       category: "game"
+    },
+    "ui-slot-component": {
+      component: "UISlotComponent",
+      importPath: "@/components/core/organisms/UISlotRenderer",
+      category: "layout"
     }
   }
 };
@@ -60241,7 +60427,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-04T03:53:29.561Z",
+  exportedAt: "2026-09-05T01:37:56.135Z",
   contracts: {
     form: {
       emits: [
@@ -61693,6 +61879,7 @@ var PATTERN_TYPES = [
   "trend-indicator",
   "typewriter-text",
   "typography",
+  "ui-slot-component",
   "ui-slot-renderer",
   "upload-drop-zone",
   "version-diff",
@@ -65593,6 +65780,61 @@ function nestedPayload(path, leaf) {
 function isPayloadObject(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v) && !(v instanceof Date);
 }
+var SYNTHESIZED_GUARD_OPERATORS = /* @__PURE__ */ new Set([
+  "not-nil",
+  "not_nil",
+  "nil",
+  "eq",
+  "==",
+  "=",
+  "not-eq",
+  "!=",
+  "neq",
+  "gt",
+  ">",
+  "gte",
+  ">=",
+  "lt",
+  "<",
+  "lte",
+  "<=",
+  "and",
+  "or",
+  "not",
+  "object/has",
+  "object/get",
+  "array/includes",
+  "str/startsWith",
+  "agent/is-pinned",
+  "agent/memory-strength"
+]);
+var ACKNOWLEDGED_UNSYNTHESIZED_GUARD_OPERATORS = /* @__PURE__ */ new Set(["if", "let", "array/some", "grid/in-bounds"]);
+function isRecognizedGuardOperator(op) {
+  return SYNTHESIZED_GUARD_OPERATORS.has(op) || ACKNOWLEDGED_UNSYNTHESIZED_GUARD_OPERATORS.has(op) || op.startsWith("agent/");
+}
+var unhandledGuardOperators = [];
+function recordUnhandledOperator(op) {
+  if (unhandledGuardOperators.includes(op)) return;
+  unhandledGuardOperators.push(op);
+  console.warn(
+    `[@almadar/core buildGuardPayloads] unrecognized guard operator "${op}" \u2014 synthesizing {pass:{}, fail:{}}; this guard arm cannot be walked pass/fail by verify. Add synthesis (or a tracked-gap entry) in guard-payloads.ts.`
+  );
+}
+function splitPayloadArg(a, b) {
+  const pathA = extractPayloadFieldPath(a);
+  if (pathA) return { path: pathA, collection: b };
+  const pathB = extractPayloadFieldPath(b);
+  if (pathB) return { path: pathB, collection: a };
+  return null;
+}
+function isPlainRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v) && !(v instanceof Date);
+}
+function absentKey(keys) {
+  let candidate = `${keys.reduce((longest, k) => k.length > longest.length ? k : longest, "")}_`;
+  while (keys.includes(candidate)) candidate += "_";
+  return candidate;
+}
 function mergePayloads(a, b) {
   const out = { ...a };
   for (const [k, v] of Object.entries(b)) {
@@ -65601,6 +65843,91 @@ function mergePayloads(a, b) {
   }
   return out;
 }
+function extractObjectGetOperand(x) {
+  if (!Array.isArray(x) || x[0] !== "object/get") return null;
+  const split = splitPayloadArg(x[1], x[2]);
+  if (split && isPlainRecord(split.collection)) {
+    return { path: split.path, map: split.collection };
+  }
+  return null;
+}
+function resolveObjectGetComparison(a, b) {
+  const getA = extractObjectGetOperand(a);
+  if (getA) return { path: getA.path, map: getA.map, literal: b };
+  const getB = extractObjectGetOperand(b);
+  if (getB) return { path: getB.path, map: getB.map, literal: a };
+  return null;
+}
+function buildObjectGetComparisonPayload(a, b, negate) {
+  const resolved = resolveObjectGetComparison(a, b);
+  if (!resolved) return null;
+  const { path, map, literal } = resolved;
+  const keys = Object.keys(map);
+  const passKey = keys.find((k) => negate ? map[k] !== literal : map[k] === literal);
+  const failKey = keys.find((k) => negate ? map[k] === literal : map[k] !== literal);
+  return {
+    pass: passKey !== void 0 ? nestedPayload(path, passKey) : {},
+    fail: failKey !== void 0 ? nestedPayload(path, failKey) : nestedPayload(path, absentKey(keys))
+  };
+}
+function guardPassCandidateSet(guard) {
+  if (!Array.isArray(guard) || guard.length === 0) return null;
+  const op = String(guard[0]);
+  if (op === "object/has") {
+    const split = splitPayloadArg(guard[1], guard[2]);
+    if (split && isPlainRecord(split.collection)) {
+      return { path: split.path, values: Object.keys(split.collection) };
+    }
+    return null;
+  }
+  if (op === "eq" || op === "==" || op === "=" || op === "not-eq" || op === "!=" || op === "neq") {
+    const negate = op === "not-eq" || op === "!=" || op === "neq";
+    const resolved = resolveObjectGetComparison(guard[1], guard[2]);
+    if (resolved) {
+      const values = Object.keys(resolved.map).filter(
+        (k) => negate ? resolved.map[k] !== resolved.literal : resolved.map[k] === resolved.literal
+      );
+      return { path: resolved.path, values };
+    }
+    if (!negate) {
+      const path = extractPayloadFieldPath(guard[1]);
+      if (path && typeof guard[2] === "string") return { path, values: [guard[2]] };
+    }
+    return null;
+  }
+  return null;
+}
+function withoutField(payload, path) {
+  const [head, ...tail] = path;
+  if (tail.length === 0) {
+    const rest = {};
+    for (const k of Object.keys(payload)) {
+      if (k !== head) rest[k] = payload[k];
+    }
+    return rest;
+  }
+  const nested = payload[head];
+  if (!isPayloadObject(nested)) return payload;
+  return { ...payload, [head]: withoutField(nested, tail) };
+}
+function applyFieldIntersections(subs, pass) {
+  const byField = /* @__PURE__ */ new Map();
+  for (const sub of subs) {
+    const candidate = guardPassCandidateSet(sub);
+    if (!candidate) continue;
+    const key = JSON.stringify(candidate.path);
+    const entry = byField.get(key);
+    if (entry) entry.sets.push(candidate.values);
+    else byField.set(key, { path: candidate.path, sets: [candidate.values] });
+  }
+  let out = pass;
+  for (const { path, sets } of byField.values()) {
+    if (sets.length < 2) continue;
+    const intersection = sets.reduce((acc, set2) => acc.filter((v) => set2.includes(v)));
+    out = intersection.length > 0 ? mergePayloads(out, nestedPayload(path, intersection[0])) : withoutField(out, path);
+  }
+  return out;
+}
 function constTruth(guard) {
   if (typeof guard === "boolean") return guard;
   if (typeof guard === "string") {
@@ -65663,6 +65990,8 @@ function buildGuardPayloads(guard) {
       const failVal = typeof val === "number" ? val + 1 : typeof val === "string" ? `not-${val}` : null;
       return { pass: nestedPayload(path, val), fail: nestedPayload(path, failVal) };
     }
+    const objectGetPayload = buildObjectGetComparisonPayload(guard[1], guard[2], false);
+    if (objectGetPayload) return objectGetPayload;
   }
   if (op === "not-eq" || op === "!=" || op === "neq") {
     const path = extractPayloadFieldPath(guard[1]);
@@ -65671,6 +66000,8 @@ function buildGuardPayloads(guard) {
       const passVal = typeof val === "number" ? val + 1 : typeof val === "string" ? `not-${val}` : "other";
       return { pass: nestedPayload(path, passVal), fail: nestedPayload(path, val) };
     }
+    const objectGetPayload = buildObjectGetComparisonPayload(guard[1], guard[2], true);
+    if (objectGetPayload) return objectGetPayload;
   }
   if (op === "gt" || op === ">") {
     const path = extractPayloadFieldPath(guard[1]);
@@ -65696,7 +66027,8 @@ function buildGuardPayloads(guard) {
     const subs = guard.slice(1);
     if (subs.length >= 2) {
       const built = subs.map(buildGuardPayloads);
-      const pass = built.reduce((acc, b) => mergePayloads(acc, b.pass), {});
+      const merged = built.reduce((acc, b) => mergePayloads(acc, b.pass), {});
+      const pass = applyFieldIntersections(subs, merged);
       return { pass, fail: built[0].fail };
     }
     if (subs.length === 1) return buildGuardPayloads(subs[0]);
@@ -65715,6 +66047,44 @@ function buildGuardPayloads(guard) {
     const inner = buildGuardPayloads(guard[1]);
     return { pass: inner.fail, fail: inner.pass };
   }
+  if (op === "object/has") {
+    const split = splitPayloadArg(guard[1], guard[2]);
+    if (split && isPlainRecord(split.collection)) {
+      const keys = Object.keys(split.collection);
+      if (keys.length > 0) {
+        return { pass: nestedPayload(split.path, keys[0]), fail: nestedPayload(split.path, absentKey(keys)) };
+      }
+    }
+  }
+  if (op === "object/get") {
+    const split = splitPayloadArg(guard[1], guard[2]);
+    if (split && isPlainRecord(split.collection)) {
+      const map = split.collection;
+      const keys = Object.keys(map);
+      const passKey = keys.find((k) => Boolean(map[k]));
+      if (passKey !== void 0) {
+        return { pass: nestedPayload(split.path, passKey), fail: nestedPayload(split.path, absentKey(keys)) };
+      }
+    }
+  }
+  if (op === "array/includes") {
+    const split = splitPayloadArg(guard[1], guard[2]);
+    if (split && Array.isArray(split.collection) && split.collection.length > 0) {
+      const passVal = split.collection[0];
+      const failVal = typeof passVal === "string" ? `${passVal}-not-in-list` : "not-in-list";
+      return { pass: nestedPayload(split.path, passVal), fail: nestedPayload(split.path, failVal) };
+    }
+  }
+  if (op === "str/startsWith") {
+    const path = extractPayloadFieldPath(guard[1]);
+    const prefix = typeof guard[2] === "string" ? guard[2] : "";
+    if (path) {
+      return {
+        pass: nestedPayload(path, `${prefix}mock-suffix`),
+        fail: nestedPayload(path, prefix.length > 0 ? `not-${prefix}` : "mock-test-value")
+      };
+    }
+  }
   if (op === "agent/is-pinned") {
     const field = extractPayloadFieldRef(guard[1]);
     if (field) return { pass: { [field]: "mem_test_unpinned" }, fail: { [field]: "mem_test_pinned" } };
@@ -65726,6 +66096,9 @@ function buildGuardPayloads(guard) {
   if (op.startsWith("agent/")) {
     return { pass: {}, fail: {} };
   }
+  if (!isRecognizedGuardOperator(op)) {
+    recordUnhandledOperator(op);
+  }
   return { pass: {}, fail: {} };
 }