@object-ui/cli 17.7.0 → 18.0.0

package/dist/cli.js

@@ -528,7 +528,9 @@ import { globSync } from "glob";
 import { readFileSync as readFileSync2 } from "fs";
 import { join as join6 } from "path";
 import { parse as parseJsonc, printParseErrorCode } from "jsonc-parser";
-import { safeValidateSchema } from "@object-ui/types/zod";
+
+// src/utils/authoring-face.ts
+import { StrictAnyComponentSchema } from "@object-ui/types/zod";
 
 // src/utils/issue-path.ts
 function formatIssuePath(path) {
@@ -536,6 +538,188 @@ function formatIssuePath(path) {
   return segments.length > 0 ? segments.join(" \u2192 ") : "(root)";
 }
 
+// src/utils/union-arm-diagnostics.ts
+var MAX_UNION_ARMS_REPORTED = 5;
+function editDistance(a, b) {
+  if (a === b) return 0;
+  if (a.length === 0) return b.length;
+  if (b.length === 0) return a.length;
+  let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= a.length; i += 1) {
+    const current = [i];
+    for (let j = 1; j <= b.length; j += 1) {
+      current[j] = Math.min(
+        previous[j] + 1,
+        current[j - 1] + 1,
+        previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1)
+      );
+    }
+    previous = current;
+  }
+  return previous[b.length];
+}
+function nearestArmNames(authoredType, armNames) {
+  const unique = [...new Set(armNames)].sort();
+  if (typeof authoredType !== "string" || authoredType === "") {
+    return { candidates: [], total: unique.length };
+  }
+  const ordered = [...unique].sort((x, y) => {
+    const d = editDistance(authoredType, x) - editDistance(authoredType, y);
+    return d !== 0 ? d : x.localeCompare(y);
+  });
+  return { candidates: ordered.slice(0, MAX_UNION_ARMS_REPORTED), total: unique.length };
+}
+function authoredTypeAt(document, path) {
+  let node = document;
+  for (const key of path) {
+    if (node === null || typeof node !== "object") return void 0;
+    node = node[key];
+  }
+  if (node === null || typeof node !== "object") return void 0;
+  const type = node.type;
+  return typeof type === "string" ? type : void 0;
+}
+function isUnion(issue) {
+  return issue.code === "invalid_union" && Array.isArray(issue.errors);
+}
+var NO_MATCHING_DISCRIMINATOR = "No matching discriminator";
+function noArmAccepts(node, literals, document) {
+  const authoredType = authoredTypeAt(document, node);
+  const { candidates, total } = nearestArmNames(authoredType, literals);
+  return {
+    kind: "note",
+    path: [...node],
+    ...authoredType === void 0 ? {} : { authoredType },
+    candidates,
+    totalArmNames: total
+  };
+}
+function noMatchingDiscriminator(issue, document) {
+  if (issue.code !== "invalid_union") return void 0;
+  if (issue.note !== NO_MATCHING_DISCRIMINATOR) return void 0;
+  if (!Array.isArray(issue.options)) return void 0;
+  if ((issue.errors ?? []).length > 0) return void 0;
+  const path = issue.path ?? [];
+  if (path[path.length - 1] !== "type") return void 0;
+  if (issue.discriminator !== void 0 && issue.discriminator !== "type") return void 0;
+  const literals = issue.options.filter((v) => typeof v === "string");
+  if (literals.length === 0) return void 0;
+  return noArmAccepts(path.slice(0, -1), literals, document);
+}
+function isAtTypeKey(issue) {
+  const path = issue.path ?? [];
+  return path.length === 1 && path[0] === "type";
+}
+function declaredTypeLiterals(armIssues) {
+  const literals = [];
+  let declares = false;
+  for (const issue of armIssues) {
+    if (isAtTypeKey(issue) && issue.code === "invalid_value" && Array.isArray(issue.values)) {
+      declares = true;
+      literals.push(...issue.values.filter((v) => typeof v === "string"));
+      continue;
+    }
+    if (isAtTypeKey(issue) && isUnion(issue) && Array.isArray(issue.options)) {
+      declares = true;
+      literals.push(...issue.options.filter((v) => typeof v === "string"));
+      continue;
+    }
+    if ((issue.path ?? []).length === 0 && isUnion(issue)) {
+      const nested = (issue.errors ?? []).map((sub) => declaredTypeLiterals(sub));
+      if (nested.length > 0 && nested.every((n) => n !== void 0)) {
+        declares = true;
+        for (const n of nested) literals.push(...n);
+      }
+    }
+  }
+  return declares ? literals : void 0;
+}
+function explain(unionIssue, prefix, document) {
+  const arms = unionIssue.errors ?? [];
+  const declared = arms.map((arm) => declaredTypeLiterals(arm));
+  const declaringArms = declared.filter((d) => d !== void 0);
+  const acceptingIndexes = declared.map((d, i) => d === void 0 ? i : -1).filter((i) => i >= 0);
+  const expand = (armIssues, arm) => armIssues.flatMap((issue) => {
+    const absolute = [...prefix, ...issue.path ?? []];
+    const discriminated = noMatchingDiscriminator({ ...issue, path: absolute }, document);
+    if (discriminated) return [discriminated];
+    if (isUnion(issue)) return explain(issue, absolute, document);
+    return [
+      {
+        kind: "issue",
+        path: absolute,
+        message: issue.message ?? "",
+        code: issue.code,
+        ...arm === void 0 ? {} : { arm }
+      }
+    ];
+  });
+  if (declaringArms.length > 0 && acceptingIndexes.length === 1) {
+    return expand(arms[acceptingIndexes[0]]);
+  }
+  if (declaringArms.length > 0 && acceptingIndexes.length === 0) {
+    return [noArmAccepts(prefix, declaringArms.flat(), document)];
+  }
+  return arms.slice(0, MAX_UNION_ARMS_REPORTED).flatMap((arm, i) => expand(arm, `${i + 1}/${arms.length}`));
+}
+function explainUnionIssue(issue, document) {
+  const discriminated = noMatchingDiscriminator(issue, document);
+  if (discriminated) return [discriminated];
+  if (!isUnion(issue)) return [];
+  return explain(issue, issue.path ?? [], document);
+}
+function isTypeMismatch(issue) {
+  return isAtTypeKey(issue) && (issue.code === "invalid_value" || isUnion(issue));
+}
+function isShapeMismatch(issue) {
+  if ((issue.path ?? []).length !== 0) return false;
+  if (issue.code === "invalid_type") return true;
+  return isUnion(issue) && (issue.errors ?? []).every((arm) => !isViableArm(arm));
+}
+function isViableArm(armIssues) {
+  if (armIssues.some(isTypeMismatch)) return false;
+  return !armIssues.every(isShapeMismatch);
+}
+function findUndeclaredKeys(issues) {
+  const idOf = (finding) => JSON.stringify([...finding.path.map(String), finding.key]);
+  const collect = (list, prefix) => {
+    const found = [];
+    for (const issue of list) {
+      const path = [...prefix, ...issue.path ?? []];
+      if (issue.code === "unrecognized_keys") {
+        for (const key of issue.keys ?? []) found.push({ path, key });
+      }
+      if (isUnion(issue)) {
+        const perArm = (issue.errors ?? []).filter(isViableArm).map((arm) => collect(arm, path));
+        const [first, ...others] = perArm;
+        if (first === void 0) continue;
+        const refusedByAll = first.filter(
+          (finding) => others.every((arm) => arm.some((other) => idOf(other) === idOf(finding)))
+        );
+        found.push(...refusedByAll);
+      }
+    }
+    return found;
+  };
+  const seen = /* @__PURE__ */ new Set();
+  return collect(issues, []).filter((finding) => {
+    const id = idOf(finding);
+    if (seen.has(id)) return false;
+    seen.add(id);
+    return true;
+  });
+}
+
+// src/utils/authoring-face.ts
+function validateAuthoredDocument(document) {
+  return StrictAnyComponentSchema.safeParse(document);
+}
+function describeUndeclaredKey(finding, document) {
+  const type = authoredTypeAt(document, finding.path);
+  const owner = type === void 0 ? "" : ` (type "${type}")`;
+  return `Undeclared key "${finding.key}" at ${formatIssuePath(finding.path)}${owner}: no schema declares it there. Remove it, or check its spelling against the keys declared at that position.`;
+}
+
 // src/utils/known-schema-types.ts
 var KNOWN_SCHEMA_TYPES = [
   "a",
@@ -558,8 +742,6 @@ var KNOWN_SCHEMA_TYPES = [
   "app-schema-renderer",
   "app-shell:cloud-connection:panel",
   "app-shell:cloud:ai-model-status",
-  "app-shell:cloud:onboarding-next",
-  "app-shell:marketplace:installed-list",
   "app-shell:mcp:connect-agent",
   "app:launcher",
   "article",
@@ -585,11 +767,11 @@ var KNOWN_SCHEMA_TYPES = [
   "chatbot-enhanced",
   "chatbot-floating",
   "checkbox",
+  "checklist",
   "cite",
   "cloud-connection:panel",
   "cloud:ai-model-status",
-  "cloud:onboarding-next",
-  "cloud:plan-status",
+  "cloud:workspace-timezone-notice",
   "code",
   "code-editor",
   "collapsible",
@@ -658,8 +840,9 @@ var KNOWN_SCHEMA_TYPES = [
   "field:object-ref",
   "field:password",
   "field:percent",
-  "field:permission-facet-link",
+  "field:permission-ref",
   "field:phone",
+  "field:position-ref",
   "field:progress",
   "field:qrcode",
   "field:radio",
@@ -698,6 +881,7 @@ var KNOWN_SCHEMA_TYPES = [
   "h6",
   "header",
   "header-bar",
+  "hero",
   "home",
   "hover-card",
   "hr",
@@ -720,7 +904,6 @@ var KNOWN_SCHEMA_TYPES = [
   "main",
   "mark",
   "markdown",
-  "marketplace:installed-list",
   "mcp:connect-agent",
   "menubar",
   "nav",
@@ -892,6 +1075,7 @@ var KNOWN_SCHEMA_TYPES = [
   "record",
   "record:activity",
   "record:alert",
+  "record:approval_decision",
   "record:approvals",
   "record:attachments",
   "record:chatter",
@@ -922,6 +1106,7 @@ var KNOWN_SCHEMA_TYPES = [
   "span",
   "spinner",
   "stack",
+  "stat",
   "statistic",
   "strong",
   "sub",
@@ -931,6 +1116,7 @@ var KNOWN_SCHEMA_TYPES = [
   "tabs",
   "text",
   "textarea",
+  "tile-grid",
   "time",
   "timeline",
   "toast",
@@ -1064,6 +1250,7 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:ul",
   "ui:utility",
   "ul",
+  "usage-bar",
   "utility",
   "view-switcher",
   "view:calendar",
@@ -1123,6 +1310,7 @@ import {
   EXPRESSION_BINDABLE_TEXT_KEYS,
   expressionBindableTextKeysFor
 } from "@objectstack/spec/ui";
+import { nodeSlotValues, nodeSlotsFor } from "@object-ui/types";
 var EXPRESSION_PATTERN = /\$\{[^}]+\}/;
 var COMPOSITION_KEY = "children";
 var PAGE_DOCUMENT_ROOT_TYPE = "page";
@@ -1156,6 +1344,11 @@ function visit(node, path, isDocumentRoot, into) {
   } else if (isComponentNode(children)) {
     visit(children, [...path, COMPOSITION_KEY], false, into);
   }
+  for (const slot of nodeSlotsFor(node.type)) {
+    for (const { segments, value } of nodeSlotValues(node, slot.path)) {
+      if (isComponentNode(value)) visit(value, [...path, ...segments], false, into);
+    }
+  }
 }
 function findUnbindableTextExpressions(document) {
   const found = [];
@@ -1207,7 +1400,7 @@ function recogniseObjectUiSchemaFile(content) {
   if (OBJECTUI_STRUCTURAL_KEYS.some((key) => key in content)) {
     return { recognised: true, validated: false };
   }
-  const result = safeValidateSchema(content);
+  const result = validateAuthoredDocument(content);
   return result.success ? { recognised: true, validated: true } : { recognised: false, issues: result.error.issues };
 }
 function describeFirstIssue(issues) {
@@ -1248,6 +1441,18 @@ async function check(cwd = process.cwd()) {
   const unvalidatedCandidates = [];
   let validated = 0;
   let notValidated = 0;
+  const judgeTextExpressions = (file, document) => {
+    for (const finding of findUnbindableTextExpressions(document)) {
+      const line = `${file} ${describeUnbindableTextExpression(finding)}`;
+      if (finding.severity === "refusal") {
+        console.log(chalk6.red(`x Unevaluated expression in ${line}`));
+        console.log(chalk6.dim(`   ${workingChannels(finding)}`));
+        errors++;
+      } else {
+        console.log(chalk6.yellow(`\u26A0\uFE0F Expression not judged in ${line}`));
+      }
+    }
+  };
   for (const file of files) {
     try {
       if (file.endsWith(".json")) {
@@ -1272,8 +1477,10 @@ async function check(cwd = process.cwd()) {
                 unvalidatedCandidates.push({
                   file,
                   type: content.type,
-                  issues: recognition.issues
+                  issues: recognition.issues,
+                  document: content
                 });
+                judgeTextExpressions(file, content);
               } else {
                 skipped++;
               }
@@ -1291,16 +1498,7 @@ async function check(cwd = process.cwd()) {
                 )
               );
             }
-            for (const finding of findUnbindableTextExpressions(content)) {
-              const line = `${file} ${describeUnbindableTextExpression(finding)}`;
-              if (finding.severity === "refusal") {
-                console.log(chalk6.red(`x Unevaluated expression in ${line}`));
-                console.log(chalk6.dim(`   ${workingChannels(finding)}`));
-                errors++;
-              } else {
-                console.log(chalk6.yellow(`\u26A0\uFE0F Expression not judged in ${line}`));
-              }
-            }
+            judgeTextExpressions(file, content);
           }
         }
       }
@@ -1316,12 +1514,15 @@ async function check(cwd = process.cwd()) {
         `\u26A0\uFE0F ${n} file${n === 1 ? "" : "s"} carr${n === 1 ? "ies" : "y"} a registered ObjectUI component type but did not validate as an ObjectUI schema:`
       )
     );
-    for (const { file, type, issues } of unvalidatedCandidates) {
+    for (const { file, type, issues, document } of unvalidatedCandidates) {
       console.log(chalk6.yellow(`   ${file} (type "${type}")`));
       const firstIssue = describeFirstIssue(issues);
       if (firstIssue !== void 0) {
         console.log(chalk6.yellow(`     ${firstIssue}`));
       }
+      for (const finding of findUndeclaredKeys(issues)) {
+        console.log(chalk6.yellow(`     ${describeUndeclaredKey(finding, document)}`));
+      }
     }
     console.log(
       chalk6.dim("   Run `objectui validate <file>` on any of them for the full diagnosis.")
@@ -1373,7 +1574,6 @@ import chalk7 from "chalk";
 import { readFileSync as readFileSync3, existsSync as existsSync5 } from "fs";
 import { resolve as resolve3 } from "path";
 import { load as loadYaml } from "js-yaml";
-import { safeValidateSchema as safeValidateSchema2 } from "@object-ui/types/zod";
 
 // src/utils/spec-vocabulary-hint.ts
 function findSpecVocabularyFormFields(node, path = "") {
@@ -1404,135 +1604,41 @@ function findSpecVocabularyFormFields(node, path = "") {
   return findings;
 }
 
-// src/utils/union-arm-diagnostics.ts
-var MAX_UNION_ARMS_REPORTED = 5;
-function editDistance(a, b) {
-  if (a === b) return 0;
-  if (a.length === 0) return b.length;
-  if (b.length === 0) return a.length;
-  let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
-  for (let i = 1; i <= a.length; i += 1) {
-    const current = [i];
-    for (let j = 1; j <= b.length; j += 1) {
-      current[j] = Math.min(
-        previous[j] + 1,
-        current[j - 1] + 1,
-        previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1)
-      );
-    }
-    previous = current;
-  }
-  return previous[b.length];
-}
-function nearestArmNames(authoredType, armNames) {
-  const unique = [...new Set(armNames)].sort();
-  if (typeof authoredType !== "string" || authoredType === "") {
-    return { candidates: [], total: unique.length };
+// src/utils/record-block-binding-hint.ts
+var ONE_RECORD_BLOCK_TYPES = /* @__PURE__ */ new Set([
+  "record:details",
+  "record:highlights",
+  "record:quick_actions"
+]);
+var PARENT_BINDING_BLOCK_TYPE = "record:related_list";
+var isRecord = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+var unboundedObjectOf = (binding) => isRecord(binding) && typeof binding.object === "string" && binding.object.length > 0 && binding.limit !== 1 ? binding.object : void 0;
+function findRecordBindingsWithoutLimitOne(document, path = []) {
+  if (Array.isArray(document)) {
+    return document.flatMap((child, i) => findRecordBindingsWithoutLimitOne(child, [...path, i]));
   }
-  const ordered = [...unique].sort((x, y) => {
-    const d = editDistance(authoredType, x) - editDistance(authoredType, y);
-    return d !== 0 ? d : x.localeCompare(y);
-  });
-  return { candidates: ordered.slice(0, MAX_UNION_ARMS_REPORTED), total: unique.length };
-}
-function authoredTypeAt(document, path) {
-  let node = document;
-  for (const key of path) {
-    if (node === null || typeof node !== "object") return void 0;
-    node = node[key];
+  if (!isRecord(document)) return [];
+  const findings = [];
+  if (typeof document.type === "string" && ONE_RECORD_BLOCK_TYPES.has(document.type)) {
+    const object = unboundedObjectOf(document.dataSource);
+    if (object) findings.push({ path: formatIssuePath(path), type: document.type, object, key: "dataSource" });
   }
-  if (node === null || typeof node !== "object") return void 0;
-  const type = node.type;
-  return typeof type === "string" ? type : void 0;
-}
-function isUnion(issue) {
-  return issue.code === "invalid_union" && Array.isArray(issue.errors);
-}
-var NO_MATCHING_DISCRIMINATOR = "No matching discriminator";
-function noArmAccepts(node, literals, document) {
-  const authoredType = authoredTypeAt(document, node);
-  const { candidates, total } = nearestArmNames(authoredType, literals);
-  return {
-    kind: "note",
-    path: [...node],
-    ...authoredType === void 0 ? {} : { authoredType },
-    candidates,
-    totalArmNames: total
-  };
-}
-function noMatchingDiscriminator(issue, document) {
-  if (issue.code !== "invalid_union") return void 0;
-  if (issue.note !== NO_MATCHING_DISCRIMINATOR) return void 0;
-  if (!Array.isArray(issue.options)) return void 0;
-  if ((issue.errors ?? []).length > 0) return void 0;
-  const path = issue.path ?? [];
-  if (path[path.length - 1] !== "type") return void 0;
-  if (issue.discriminator !== void 0 && issue.discriminator !== "type") return void 0;
-  const literals = issue.options.filter((v) => typeof v === "string");
-  if (literals.length === 0) return void 0;
-  return noArmAccepts(path.slice(0, -1), literals, document);
-}
-function isAtTypeKey(issue) {
-  const path = issue.path ?? [];
-  return path.length === 1 && path[0] === "type";
-}
-function declaredTypeLiterals(armIssues) {
-  const literals = [];
-  let declares = false;
-  for (const issue of armIssues) {
-    if (isAtTypeKey(issue) && issue.code === "invalid_value" && Array.isArray(issue.values)) {
-      declares = true;
-      literals.push(...issue.values.filter((v) => typeof v === "string"));
-      continue;
-    }
-    if (isAtTypeKey(issue) && isUnion(issue) && Array.isArray(issue.options)) {
-      declares = true;
-      literals.push(...issue.options.filter((v) => typeof v === "string"));
-      continue;
-    }
-    if ((issue.path ?? []).length === 0 && isUnion(issue)) {
-      const nested = (issue.errors ?? []).map((sub) => declaredTypeLiterals(sub));
-      if (nested.length > 0 && nested.every((n) => n !== void 0)) {
-        declares = true;
-        for (const n of nested) literals.push(...n);
-      }
+  if (document.type === PARENT_BINDING_BLOCK_TYPE && isRecord(document.properties)) {
+    const object = unboundedObjectOf(document.properties.parentDataSource);
+    if (object) {
+      findings.push({ path: formatIssuePath(path), type: document.type, object, key: "properties.parentDataSource" });
     }
   }
-  return declares ? literals : void 0;
-}
-function explain(unionIssue, prefix, document) {
-  const arms = unionIssue.errors ?? [];
-  const declared = arms.map((arm) => declaredTypeLiterals(arm));
-  const declaringArms = declared.filter((d) => d !== void 0);
-  const acceptingIndexes = declared.map((d, i) => d === void 0 ? i : -1).filter((i) => i >= 0);
-  const expand = (armIssues, arm) => armIssues.flatMap((issue) => {
-    const absolute = [...prefix, ...issue.path ?? []];
-    const discriminated = noMatchingDiscriminator({ ...issue, path: absolute }, document);
-    if (discriminated) return [discriminated];
-    if (isUnion(issue)) return explain(issue, absolute, document);
-    return [
-      {
-        kind: "issue",
-        path: absolute,
-        message: issue.message ?? "",
-        code: issue.code,
-        ...arm === void 0 ? {} : { arm }
-      }
-    ];
-  });
-  if (declaringArms.length > 0 && acceptingIndexes.length === 1) {
-    return expand(arms[acceptingIndexes[0]]);
-  }
-  if (declaringArms.length > 0 && acceptingIndexes.length === 0) {
-    return [noArmAccepts(prefix, declaringArms.flat(), document)];
+  for (const [key, value] of Object.entries(document)) {
+    findings.push(...findRecordBindingsWithoutLimitOne(value, [...path, key]));
   }
-  return arms.slice(0, MAX_UNION_ARMS_REPORTED).flatMap((arm, i) => expand(arm, `${i + 1}/${arms.length}`));
+  return findings;
 }
-function explainUnionIssue(issue, document) {
-  const discriminated = noMatchingDiscriminator(issue, document);
-  if (discriminated) return [discriminated];
-  if (!isUnion(issue)) return [];
-  return explain(issue, issue.path ?? [], document);
+function describeRecordBindingWithoutLimitOne(finding) {
+  if (finding.key === "properties.parentDataSource") {
+    return `${finding.path}: ${finding.type}'s parent record is bound to "${finding.object}" by a \`properties.parentDataSource\` without \`limit: 1\`. A related list hangs off ONE parent record \u2014 the first row of the binding by its \`sort\` \u2014 so declare \`limit: 1\` (and a \`sort\` when several rows can match) to say which record that is.`;
+  }
+  return `${finding.path}: ${finding.type} is bound to "${finding.object}" by a dataSource without \`limit: 1\`. A record block shows ONE record \u2014 the first row of the binding by its \`sort\` \u2014 so declare \`limit: 1\` (and a \`sort\` when several rows can match) to say which record that is.`;
 }
 
 // src/commands/validate.ts
@@ -1562,7 +1668,7 @@ async function validate(schemaPath) {
       }
     }
     console.log(chalk7.gray("Validating schema...\n"));
-    const result = safeValidateSchema2(schema);
+    const result = validateAuthoredDocument(schema);
     if (result.success) {
       console.log(chalk7.green("\u2713 Schema is valid!\n"));
       const data = result.data;
@@ -1579,13 +1685,17 @@ async function validate(schemaPath) {
         console.log(chalk7.gray("  Children:"), data.children.length);
       }
       const mixed = findSpecVocabularyFormFields(schema).filter((f) => f.mixedName);
-      if (mixed.length > 0) {
+      const unboundedRecordBindings = findRecordBindingsWithoutLimitOne(schema);
+      if (mixed.length > 0 || unboundedRecordBindings.length > 0) {
         console.log(chalk7.yellow("\nWarnings:"));
         for (const m of mixed) {
           console.log(chalk7.yellow(
             `  ${m.path}: '${m.mixedName}' also carries { field: '${m.field}' } \u2014 mixed form-field vocabularies. The renderer ignores \`field\` here; drop one of the two.`
           ));
         }
+        for (const finding of unboundedRecordBindings) {
+          console.log(chalk7.yellow(`  ${describeRecordBindingWithoutLimitOne(finding)}`));
+        }
       }
       console.log("");
       process.exit(0);
@@ -1631,6 +1741,19 @@ ${index + 1}. ${issue.message}`));
           }
         });
       });
+      const undeclared = findUndeclaredKeys(result.error.issues);
+      if (undeclared.length > 0) {
+        console.error(chalk7.bold("\nUndeclared keys \u2014 the strict authoring face refuses them:"));
+        for (const finding of undeclared) {
+          console.error(chalk7.yellow(`   ${describeUndeclaredKey(finding, schema)}`));
+        }
+      }
+      const mixedHere = findSpecVocabularyFormFields(schema).filter((f) => f.mixedName);
+      for (const m of mixedHere) {
+        console.error(chalk7.yellow(
+          `   ${m.path}: '${m.mixedName}' also carries { field: '${m.field}' } \u2014 mixed form-field vocabularies. The renderer ignores \`field\` here; drop one of the two.`
+        ));
+      }
       const specShaped = findSpecVocabularyFormFields(schema).filter((f) => !f.mixedName);
       if (specShaped.length > 0) {
         console.error(chalk7.bold("\nLikely cause \u2014 spec form-view vocabulary in a standalone form:"));