@almadar/core 10.82.0 → 10.84.0

package/dist/index.js

@@ -2475,7 +2475,7 @@ function getInteractionModelForDomain(domain) {
 // src/patterns/patterns-registry.json
 var patterns_registry_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-03T18:48:23.816Z",
+  exportedAt: "2026-09-04T03:53:29.561Z",
   patterns: {
     "entity-table": {
       type: "entity-table",
@@ -18876,7 +18876,7 @@ var patterns_registry_default = {
           types: [
             "object"
           ],
-          description: "GAP-80: line-level error/warning highlights for editable mode. Map of 1-based line number \u2192 severity. The overlay paints a colored background on each line: error = red, warning = yellow. Pass undefined (default) to disable. The consumer is responsible for computing the path \u2192 line map from the schema + validation results.",
+          description: "GAP-80: line-level error/warning highlights. Map of 1-based line number \u2192 severity. Paints a colored background on each line: error = red, warning = yellow. Honored by the editable overlay and (GAP-84) by viewer mode's non-diff highlight; pass undefined (default) to disable. The consumer is responsible for computing the path \u2192 line map from the schema + validation results.",
           nonAuthorable: true
         },
         title: {
@@ -19165,6 +19165,265 @@ var patterns_registry_default = {
             "boolean"
           ],
           description: "Show copy button (viewer alias for showCopyButton)"
+        },
+        editorId: {
+          types: [
+            "string"
+          ],
+          description: "Stable identity for the keyboard router / plugin host to target this editor. Unset = this instance never receives capability events.",
+          tier: "presentation"
+        },
+        onEditorFocus: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus emit fired when this editor gains focus.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            }
+          ],
+          default: "EDITOR_FOCUS",
+          tier: "presentation"
+        },
+        onEditorBlur: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus emit fired when this editor loses focus.",
+          kind: "event-ref",
+          emitPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            }
+          ],
+          default: "EDITOR_BLUR",
+          tier: "presentation"
+        },
+        onMotion: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus listen: move the cursor per the vim-style motion vocabulary.",
+          kind: "event-listen",
+          listenPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "motion",
+              type: "string",
+              required: true,
+              enumValues: [
+                "left",
+                "right",
+                "up",
+                "down",
+                "word-forward",
+                "word-back",
+                "word-end",
+                "line-start",
+                "line-end",
+                "first-nonblank",
+                "doc-start",
+                "doc-end",
+                "paragraph-forward",
+                "paragraph-back",
+                "line",
+                "selection"
+              ]
+            },
+            {
+              name: "count",
+              type: "number",
+              required: true
+            }
+          ],
+          default: "MOTION",
+          tier: "presentation"
+        },
+        onOperate: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus listen: apply a text operator over a motion's range.",
+          kind: "event-listen",
+          listenPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "operator",
+              type: "string",
+              required: true,
+              enumValues: [
+                "delete",
+                "yank",
+                "change"
+              ]
+            },
+            {
+              name: "motion",
+              type: "string",
+              required: true,
+              enumValues: [
+                "left",
+                "right",
+                "up",
+                "down",
+                "word-forward",
+                "word-back",
+                "word-end",
+                "line-start",
+                "line-end",
+                "first-nonblank",
+                "doc-start",
+                "doc-end",
+                "paragraph-forward",
+                "paragraph-back",
+                "line",
+                "selection"
+              ]
+            },
+            {
+              name: "count",
+              type: "number",
+              required: true
+            }
+          ],
+          default: "OPERATE",
+          tier: "presentation"
+        },
+        onInsertText: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus listen: insert literal text at the cursor.",
+          kind: "event-listen",
+          listenPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "text",
+              type: "string",
+              required: true
+            }
+          ],
+          default: "INSERT_TEXT",
+          tier: "presentation"
+        },
+        onSetMode: {
+          types: [
+            "string"
+          ],
+          description: "Declarative bus listen: switch editor mode and caret style.",
+          kind: "event-listen",
+          listenPayloadSchema: [
+            {
+              name: "editorId",
+              type: "string",
+              required: true
+            },
+            {
+              name: "mode",
+              type: "string",
+              required: true
+            },
+            {
+              name: "caret",
+              type: "string",
+              required: true,
+              enumValues: [
+                "bar",
+                "block",
+                "underline"
+              ]
+            }
+          ],
+          default: "SET_MODE",
+          tier: "presentation"
+        },
+        motions: {
+          types: [
+            "array"
+          ],
+          description: "Motion vocabulary this editor accepts. Default: the full `EditorMotion` set.",
+          items: {
+            types: [
+              "string"
+            ],
+            enumValues: [
+              "left",
+              "right",
+              "up",
+              "down",
+              "word-forward",
+              "word-back",
+              "word-end",
+              "line-start",
+              "line-end",
+              "first-nonblank",
+              "doc-start",
+              "doc-end",
+              "paragraph-forward",
+              "paragraph-back",
+              "line",
+              "selection"
+            ]
+          },
+          default: [
+            "left",
+            "right",
+            "up",
+            "down",
+            "word-forward",
+            "word-back",
+            "word-end",
+            "line-start",
+            "line-end",
+            "first-nonblank",
+            "doc-start",
+            "doc-end",
+            "paragraph-forward",
+            "paragraph-back",
+            "line",
+            "selection"
+          ],
+          tier: "presentation"
+        },
+        operators: {
+          types: [
+            "array"
+          ],
+          description: "Operator vocabulary this editor accepts. Default: the full `EditorOperator` set.",
+          items: {
+            types: [
+              "string"
+            ],
+            enumValues: [
+              "delete",
+              "yank",
+              "change"
+            ]
+          },
+          default: [
+            "delete",
+            "yank",
+            "change"
+          ],
+          tier: "presentation"
         }
       }
     },
@@ -29227,7 +29486,12 @@ var patterns_registry_default = {
             {
               name: "next",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "none"
+              ]
             }
           ]
         },
@@ -29695,7 +29959,12 @@ var patterns_registry_default = {
             {
               name: "vote",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "none"
+              ]
             }
           ]
         },
@@ -38769,7 +39038,11 @@ var patterns_registry_default = {
             {
               name: "direction",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "asc",
+                "desc"
+              ]
             }
           ]
         },
@@ -40733,7 +41006,13 @@ var patterns_registry_default = {
             {
               name: "direction",
               type: "string",
-              required: true
+              required: true,
+              enumValues: [
+                "up",
+                "down",
+                "left",
+                "right"
+              ]
             },
             {
               name: "pressed",
@@ -41764,6 +42043,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -43141,6 +43421,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -44421,6 +44702,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -44892,6 +45174,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -45177,6 +45460,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -45485,6 +45769,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -47025,6 +47310,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -48239,6 +48525,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -53138,6 +53425,7 @@ var patterns_registry_default = {
                   "string"
                 ],
                 enumValues: [
+                  "solid",
                   "dashed",
                   "dotted"
                 ]
@@ -58513,7 +58801,7 @@ var integrators_registry_default = {
 // src/patterns/component-mapping.json
 var component_mapping_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-03T18:48:23.816Z",
+  exportedAt: "2026-09-04T03:53:29.561Z",
   mappings: {
     "page-header": {
       component: "PageHeader",
@@ -59953,7 +60241,7 @@ var component_mapping_default = {
 // src/patterns/event-contracts.json
 var event_contracts_default = {
   version: "1.0.0",
-  exportedAt: "2026-09-03T18:48:23.816Z",
+  exportedAt: "2026-09-04T03:53:29.561Z",
   contracts: {
     form: {
       emits: [
@@ -60863,6 +61151,20 @@ var event_contracts_default = {
           payload: {
             type: "object"
           }
+        },
+        {
+          event: "EDITOR_FOCUS",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
+        },
+        {
+          event: "EDITOR_BLUR",
+          trigger: "action",
+          payload: {
+            type: "object"
+          }
         }
       ],
       requires: [],
@@ -65291,6 +65593,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)) {
@@ -65413,6 +65770,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" } };
@@ -65424,6 +65819,9 @@ function buildGuardPayloads(guard) {
   if (op.startsWith("agent/")) {
     return { pass: {}, fail: {} };
   }
+  if (!isRecognizedGuardOperator(op)) {
+    recordUnhandledOperator(op);
+  }
   return { pass: {}, fail: {} };
 }