@ai-matrx/content-ir 0.19.21 → 0.19.26

package/dist/index.cjs

@@ -2128,7 +2128,7 @@ function stripKindDeep(value) {
   return value;
 }
 
-// utils/text-case-converter.ts
+// text-case.ts
 var DEFAULT_WORD_REPLACEMENTS = {
   // Acronyms & initialisms
   "api": "API",
@@ -2396,6 +2396,24 @@ function formatText(text, options = {}) {
   }
   return result;
 }
+var IDENTIFIER_ACRONYMS = [
+  "ID",
+  "URL",
+  "PDF",
+  "HTML",
+  "JSON",
+  "API",
+  "AI",
+  "UI",
+  "CSV",
+  "SMS",
+  "SEO",
+  "LLM",
+  "MCP",
+  "UUID",
+  "ISO"
+];
+new Set(IDENTIFIER_ACRONYMS.map((a) => a.toLowerCase()));
 
 // core/schema-structure.ts
 function formatBlockLabel(key) {
@@ -3188,13 +3206,13 @@ function makeKindJsonSchemaProperty(kindSlug, strict) {
   return { ...base2, enum: [kindSlug] };
 }
 function injectKindIntoObjectSchema(objectSchema, kindSlug, strict) {
-  const clone = deepClone(objectSchema);
-  const properties = isRecord4(clone.properties) ? { ...clone.properties } : {};
+  const clone2 = deepClone(objectSchema);
+  const properties = isRecord4(clone2.properties) ? { ...clone2.properties } : {};
   properties[KIND_KEY] = makeKindJsonSchemaProperty(kindSlug, strict);
-  const required = Array.isArray(clone.required) ? clone.required.filter((k) => typeof k === "string") : [];
+  const required = Array.isArray(clone2.required) ? clone2.required.filter((k) => typeof k === "string") : [];
   const nextRequired = required.includes(KIND_KEY) ? required : [KIND_KEY, ...required];
   return {
-    ...clone,
+    ...clone2,
     properties,
     required: nextRequired,
     ...strict ? { additionalProperties: false } : {}
@@ -4391,8 +4409,132 @@ function kindSchemaToJsonSchema(kind, resolve, options = {}) {
   return { name: kind, schema: { ...rootNode, $defs: defs }, strict, unresolved };
 }
 
+// convert/control-keys.ts
+var CONTROL_KEYS = ["_replaces", "_new", "_record_id", "_records"];
+var RECORD_DISPOSITION = "record";
+var KIND_KEY2 = "__kind";
+var DOCUMENT_KEYS = /* @__PURE__ */ new Set(["$schema", "$id", "$defs", "definitions", "title", "description"]);
+var CONTROL = new Set(CONTROL_KEYS);
+function controlKeysApplyTo(disposition) {
+  return disposition === RECORD_DISPOSITION;
+}
+function clone(value) {
+  return value === void 0 ? value : JSON.parse(JSON.stringify(value));
+}
+function isObjectSchema(schema) {
+  if (!schema || typeof schema !== "object" || Array.isArray(schema)) return false;
+  const s = schema;
+  return s.type === "object" && !!s.properties && typeof s.properties === "object" && !Array.isArray(s.properties);
+}
+function requiredOf(schema) {
+  return Array.isArray(schema.required) ? schema.required : [];
+}
+function recordObject(schema) {
+  const item = {};
+  for (const [k, v] of Object.entries(schema)) {
+    if (!DOCUMENT_KEYS.has(k)) item[k] = clone(v);
+  }
+  const props = {};
+  for (const [k, v] of Object.entries(item.properties)) {
+    if (k !== KIND_KEY2 && !CONTROL.has(k)) props[k] = v;
+  }
+  item.properties = props;
+  const required = requiredOf(item).filter((k) => k !== KIND_KEY2 && !CONTROL.has(k));
+  if (required.length > 0) item.required = required;
+  else delete item.required;
+  return item;
+}
+function stored(schema) {
+  const out = clone(schema);
+  const item = recordObject(schema);
+  const props = out.properties;
+  props._replaces = { type: ["string", "null"], format: "uuid" };
+  props._new = { type: ["boolean", "null"] };
+  props._record_id = { type: ["string", "null"], format: "uuid" };
+  props._records = { type: ["array", "null"], items: item };
+  const rootRequired = requiredOf(out).filter((k) => !CONTROL.has(k));
+  const lifted = rootRequired.filter((k) => k !== KIND_KEY2);
+  if (lifted.length > 0) {
+    const kept = rootRequired.filter((k) => k === KIND_KEY2);
+    if (kept.length > 0) out.required = kept;
+    else delete out.required;
+    const branch = {
+      if: {
+        anyOf: [
+          { required: ["_record_id"], properties: { _record_id: { type: "string" } } },
+          { required: ["_records"], properties: { _records: { type: "array" } } }
+        ]
+      },
+      else: { required: lifted }
+    };
+    out.allOf = Array.isArray(out.allOf) ? [...out.allOf, branch] : [branch];
+  }
+  return out;
+}
+function authored(schema, many, allowEdit) {
+  const signals = {
+    _replaces: { type: "string", format: "uuid" },
+    _new: { type: "boolean" }
+  };
+  if (allowEdit) signals._record_id = { type: "string", format: "uuid" };
+  if (!many) {
+    const out2 = clone(schema);
+    Object.assign(out2.properties, clone(signals));
+    const required = requiredOf(out2).filter((k) => !CONTROL.has(k));
+    if (required.length > 0 || "required" in out2) out2.required = required;
+    return out2;
+  }
+  const out = {};
+  for (const [k, v] of Object.entries(schema)) {
+    if (DOCUMENT_KEYS.has(k)) out[k] = clone(v);
+  }
+  out.type = "object";
+  const kindProp = schema.properties[KIND_KEY2];
+  const properties = {};
+  if (kindProp !== void 0) properties[KIND_KEY2] = clone(kindProp);
+  properties._records = { type: "array", items: recordObject(schema) };
+  Object.assign(properties, clone(signals));
+  out.properties = properties;
+  out.required = [KIND_KEY2, "_records"].filter((k) => k in properties);
+  out.additionalProperties = false;
+  return out;
+}
+function withControlKeys(schema, options) {
+  const { mode, many = false, allowEdit = false } = options;
+  if (mode !== "stored" && mode !== "authored") {
+    throw new Error(`withControlKeys: mode must be "stored" or "authored", got ${String(mode)}`);
+  }
+  if (!isObjectSchema(schema)) return schema;
+  return mode === "stored" ? stored(schema) : authored(schema, many, allowEdit);
+}
+var CONTROL_KEY_FIELDS = Object.freeze({
+  _replaces: { type: "string", nullable: true },
+  _new: { type: "boolean", nullable: true },
+  _record_id: { type: "string", nullable: true },
+  // A batch's items are records of this kind WITHOUT `__kind`; the render layer reads them
+  // as opaque JSON (never stricter than the store, which validates each item).
+  _records: { type: "json[]", nullable: true }
+});
+function withControlKeyFields(schema) {
+  if (schema.root) return schema;
+  const fields = { ...schema.fields };
+  for (const key of CONTROL_KEYS) {
+    if (!(key in fields)) fields[key] = { ...CONTROL_KEY_FIELDS[key] };
+  }
+  return { ...schema, fields };
+}
+function stripControlKeys(value) {
+  const values = {};
+  const signals = {};
+  for (const [k, v] of Object.entries(value)) {
+    if (CONTROL.has(k)) signals[k] = v;
+    else values[k] = v;
+  }
+  return { values, signals };
+}
+
 // convert/json-schema-to-kind.ts
-function kindSchemaFromJsonSchema(kind, jsonSchema) {
+function kindSchemaFromJsonSchema(kind, jsonSchema, options = {}) {
   if (jsonSchema === null || jsonSchema === void 0) {
     return { schema: null, children: {}, problems: [] };
   }
@@ -4423,6 +4565,9 @@ function kindSchemaFromJsonSchema(kind, jsonSchema) {
     if (draft.slug === kind) schema = asKindSchema;
     else children[draft.slug] = asKindSchema;
   }
+  if (schema && controlKeysApplyTo(options.disposition)) {
+    schema = withControlKeyFields(schema);
+  }
   return { schema, children, problems: converted.problems };
 }
 
@@ -7933,6 +8078,8 @@ exports.BacktickRuns = BacktickRuns;
 exports.CALLOUT_NAMES = CALLOUT_NAMES;
 exports.CAPABILITY_BY_CLASS = CAPABILITY_BY_CLASS;
 exports.CLASSES = CLASSES;
+exports.CONTROL_KEYS = CONTROL_KEYS;
+exports.CONTROL_KEY_FIELDS = CONTROL_KEY_FIELDS;
 exports.DIRECTIVE_VERSION = DIRECTIVE_VERSION;
 exports.DirectiveDecodeError = DirectiveDecodeError;
 exports.FENCE_OPENER_WHITESPACE = FENCE_OPENER_WHITESPACE;
@@ -7952,6 +8099,7 @@ exports.KindStreamParser = KindStreamParser;
 exports.NESTING_FENCE_LANGUAGES = NESTING_FENCE_LANGUAGES;
 exports.NODE_OUTCOME_KIND = NODE_OUTCOME_KIND;
 exports.ParseSession = ParseSession;
+exports.RECORD_DISPOSITION = RECORD_DISPOSITION;
 exports.RESERVED_PREFIX = RESERVED_PREFIX;
 exports.ROOT_STORAGE_NAME = ROOT_STORAGE_NAME;
 exports.RUN_RESULT_KIND = RUN_RESULT_KIND;
@@ -7979,6 +8127,7 @@ exports.collectReferencedKinds = collectReferencedKinds;
 exports.collectSchemaReferencedKinds = collectSchemaReferencedKinds;
 exports.compareWithExistingKindSchema = compareWithExistingKindSchema;
 exports.continuesTable = continuesTable;
+exports.controlKeysApplyTo = controlKeysApplyTo;
 exports.convertAiSchemaToBlockFields = convertAiSchemaToBlockFields;
 exports.createFingerprinter = createFingerprinter;
 exports.createKindStreamParser = createKindStreamParser;
@@ -8065,6 +8214,7 @@ exports.opensTable = opensTable;
 exports.pairDisplayMath = pairDisplayMath;
 exports.parseDirectiveSlug = parseDirectiveSlug;
 exports.parseFenceOpener = parseFenceOpener;
+exports.pendingCodeSpanStart = pendingCodeSpanStart;
 exports.pendingDisplayMathOpener = pendingDisplayMathOpener;
 exports.readEnvelope = readEnvelope;
 exports.readNodeOutcomeValue = readNodeOutcomeValue;
@@ -8097,6 +8247,7 @@ exports.splitsSurrogatePair = splitsSurrogatePair;
 exports.startsHtmlBlock = startsHtmlBlock;
 exports.startsPipelessTable = startsPipelessTable;
 exports.storageToKindSchema = storageToKindSchema;
+exports.stripControlKeys = stripControlKeys;
 exports.stripKindDeep = stripKindDeep;
 exports.tableContainerIndent = tableContainerIndent;
 exports.tableStartsAt = tableStartsAt;
@@ -8110,6 +8261,8 @@ exports.tryDecodeDirectiveContent = tryDecodeDirectiveContent;
 exports.unescapeCellPipes = unescapeCellPipes;
 exports.validateBlockSchemaSavePlan = validateBlockSchemaSavePlan;
 exports.validateStructuralLeg = validateStructuralLeg;
+exports.withControlKeyFields = withControlKeyFields;
+exports.withControlKeys = withControlKeys;
 exports.withRootKind = withRootKind;
 exports.xmlDiscriminator = xmlDiscriminator;
 //# sourceMappingURL=index.cjs.map