@object-ui/cli 17.6.0 → 18.0.0

package/dist/cli.js

@@ -8,11 +8,11 @@ import {
   reportProjectSource,
   resolveProjectSource,
   serve
-} from "./chunk-AP2INOE7.js";
+} from "./chunk-VMMIGYU3.js";
 
 // src/cli.ts
 import { Command } from "commander";
-import chalk14 from "chalk";
+import chalk9 from "chalk";
 
 // src/commands/dev.ts
 import { createServer } from "vite";
@@ -212,108 +212,10 @@ Make sure you have a valid production build.`
   });
 }
 
-// src/commands/lint.ts
-import { execSync as execSync3 } from "child_process";
-import { existsSync as existsSync3 } from "fs";
-import { join as join4 } from "path";
-import chalk4 from "chalk";
-async function lint(options) {
-  const cwd = process.cwd();
-  console.log(chalk4.blue("\u{1F50D} Running linter...\n"));
-  const tmpDir = join4(cwd, ".objectui-tmp");
-  const hasTempApp = existsSync3(tmpDir);
-  if (!hasTempApp) {
-    throw new Error(
-      "No Object UI application found. Run 'objectui dev' first to generate the application."
-    );
-  }
-  const packageJsonPath = join4(tmpDir, "package.json");
-  const nodeModulesPath = join4(tmpDir, "node_modules");
-  if (!existsSync3(packageJsonPath) || !existsSync3(nodeModulesPath)) {
-    throw new Error(
-      "Dependencies not installed. Run 'objectui dev' first to set up the application."
-    );
-  }
-  try {
-    const fixFlag = options.fix ? "--fix" : "";
-    const command = `npx eslint "src/**/*.{js,jsx,ts,tsx}" ${fixFlag}`.trim();
-    console.log(chalk4.dim(`  Running: ${command}
-`));
-    execSync3(command, {
-      cwd: tmpDir,
-      stdio: "inherit"
-    });
-    console.log();
-    console.log(chalk4.green("\u2713 Linting completed successfully!"));
-    console.log();
-  } catch {
-    console.log();
-    console.log(chalk4.yellow("\u26A0 Linting found issues."));
-    if (!options.fix) {
-      console.log(chalk4.dim("  Run 'objectui lint --fix' to automatically fix some issues."));
-    }
-    console.log();
-    process.exit(1);
-  }
-}
-
-// src/commands/test.ts
-import { execSync as execSync4 } from "child_process";
-import { existsSync as existsSync4 } from "fs";
-import { join as join5 } from "path";
-import chalk5 from "chalk";
-async function test(options) {
-  const cwd = process.cwd();
-  console.log(chalk5.blue("\u{1F9EA} Running tests...\n"));
-  const tmpDir = join5(cwd, ".objectui-tmp");
-  const hasTempApp = existsSync4(tmpDir);
-  if (!hasTempApp) {
-    throw new Error(
-      "No Object UI application found. Run 'objectui dev' first to generate the application."
-    );
-  }
-  const packageJsonPath = join5(tmpDir, "package.json");
-  const nodeModulesPath = join5(tmpDir, "node_modules");
-  if (!existsSync4(packageJsonPath) || !existsSync4(nodeModulesPath)) {
-    throw new Error(
-      "Dependencies not installed. Run 'objectui dev' first to set up the application."
-    );
-  }
-  try {
-    let command = "npx vitest";
-    if (options.watch) {
-      command += " --watch";
-    } else if (options.ui) {
-      command += " --ui";
-    } else {
-      command += " run";
-    }
-    if (options.coverage) {
-      command += " --coverage";
-    }
-    console.log(chalk5.dim(`  Running: ${command}
-`));
-    execSync4(command, {
-      cwd: tmpDir,
-      stdio: "inherit"
-    });
-    if (!options.watch && !options.ui) {
-      console.log();
-      console.log(chalk5.green("\u2713 Tests completed successfully!"));
-      console.log();
-    }
-  } catch {
-    console.log();
-    console.log(chalk5.red("\u2717 Some tests failed."));
-    console.log();
-    process.exit(1);
-  }
-}
-
 // src/commands/generate.ts
-import chalk6 from "chalk";
-import { existsSync as existsSync5, mkdirSync as mkdirSync3, writeFileSync } from "fs";
-import { join as join6 } from "path";
+import chalk4 from "chalk";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, writeFileSync } from "fs";
+import { join as join4 } from "path";
 async function generate(type, name) {
   const cwd = process.cwd();
   switch (type) {
@@ -328,18 +230,18 @@ async function generate(type, name) {
       generatePlugin(cwd, name);
       break;
     default:
-      console.log(chalk6.red(`Unknown type: ${type}`));
+      console.log(chalk4.red(`Unknown type: ${type}`));
       console.log(`Available types: resource, page, plugin`);
       process.exit(1);
   }
 }
 function generateResource(cwd, name) {
-  const dir = join6(cwd, "objects");
-  if (!existsSync5(dir)) mkdirSync3(dir, { recursive: true });
+  const dir = join4(cwd, "objects");
+  if (!existsSync3(dir)) mkdirSync3(dir, { recursive: true });
   const fileName = `${name.toLowerCase()}.json`;
-  const filePath = join6(dir, fileName);
-  if (existsSync5(filePath)) {
-    console.log(chalk6.yellow(`Object ${name} already exists at ${filePath}`));
+  const filePath = join4(dir, fileName);
+  if (existsSync3(filePath)) {
+    console.log(chalk4.yellow(`Object ${name} already exists at ${filePath}`));
     return;
   }
   const content = {
@@ -349,34 +251,35 @@ function generateResource(cwd, name) {
     }
   };
   writeFileSync(filePath, JSON.stringify(content, null, 2));
-  console.log(chalk6.green(`\u2713 Generated resource schema: ${filePath}`));
+  console.log(chalk4.green(`\u2713 Generated resource schema: ${filePath}`));
 }
 function generatePage(cwd, name) {
-  const dir = join6(cwd, "pages");
-  if (!existsSync5(dir)) mkdirSync3(dir, { recursive: true });
+  const dir = join4(cwd, "pages");
+  if (!existsSync3(dir)) mkdirSync3(dir, { recursive: true });
   const fileName = `${name.toLowerCase()}.json`;
-  const filePath = join6(dir, fileName);
-  if (existsSync5(filePath)) {
-    console.log(chalk6.yellow(`Page ${name} already exists at ${filePath}`));
+  const filePath = join4(dir, fileName);
+  if (existsSync3(filePath)) {
+    console.log(chalk4.yellow(`Page ${name} already exists at ${filePath}`));
     return;
   }
   const content = {
     type: "page",
+    pageType: "app",
     title: name,
-    body: [
+    children: [
       {
         type: "markdown",
-        content: `# Welcome to ${name}`
+        content: `Welcome to ${name}`
       }
     ]
   };
   writeFileSync(filePath, JSON.stringify(content, null, 2));
-  console.log(chalk6.green(`\u2713 Generated page schema: ${filePath}`));
+  console.log(chalk4.green(`\u2713 Generated page schema: ${filePath}`));
 }
 function generatePlugin(cwd, name) {
-  const dir = join6(cwd, "plugins", name);
-  if (existsSync5(dir)) {
-    console.log(chalk6.yellow(`Plugin ${name} already exists`));
+  const dir = join4(cwd, "plugins", name);
+  if (existsSync3(dir)) {
+    console.log(chalk4.yellow(`Plugin ${name} already exists`));
     return;
   }
   mkdirSync3(dir, { recursive: true });
@@ -388,14 +291,14 @@ export const ${name}Plugin = {
   }
 };
 `;
-  writeFileSync(join6(dir, "index.ts"), content.trim());
-  console.log(chalk6.green(`\u2713 Generated plugin: ${dir}`));
+  writeFileSync(join4(dir, "index.ts"), content.trim());
+  console.log(chalk4.green(`\u2713 Generated plugin: ${dir}`));
 }
 
 // src/commands/doctor.ts
-import chalk7 from "chalk";
-import { existsSync as existsSync6, readFileSync } from "fs";
-import { dirname, join as join7, resolve as resolvePath } from "path";
+import chalk5 from "chalk";
+import { existsSync as existsSync4, readFileSync } from "fs";
+import { dirname, join as join5, resolve as resolvePath } from "path";
 var CSS_ENTRY_CANDIDATES = [
   "src/index.css",
   "src/main.css",
@@ -430,15 +333,15 @@ var V4_POSTCSS_PLUGIN = /@tailwindcss\/postcss/;
 var V3_POSTCSS_PLUGIN = /["']tailwindcss["']|(?:^|[{,\s])tailwindcss\s*:/m;
 function readIfExists(path) {
   try {
-    return existsSync6(path) ? readFileSync(path, "utf-8") : null;
+    return existsSync4(path) ? readFileSync(path, "utf-8") : null;
   } catch {
     return null;
   }
 }
 function findFile(cwd, candidates) {
   for (const rel of candidates) {
-    const abs = join7(cwd, rel);
-    if (existsSync6(abs)) return abs;
+    const abs = join5(cwd, rel);
+    if (existsSync4(abs)) return abs;
   }
   return null;
 }
@@ -451,7 +354,7 @@ function majorOf(range) {
 function isInstalledFrom(cwd, specifier) {
   let dir = resolvePath(cwd);
   for (; ; ) {
-    if (existsSync6(join7(dir, "node_modules", ...specifier.split("/")))) return true;
+    if (existsSync4(join5(dir, "node_modules", ...specifier.split("/")))) return true;
     const parent = dirname(dir);
     if (parent === dir) return false;
     dir = parent;
@@ -468,7 +371,7 @@ function runDiagnostics(cwd) {
   const error = (id, message) => {
     results.push({ id, level: "error", message });
   };
-  const pkgPath = join7(cwd, "package.json");
+  const pkgPath = join5(cwd, "package.json");
   const pkgRaw = readIfExists(pkgPath);
   let pkg = null;
   if (pkgRaw === null) {
@@ -536,7 +439,7 @@ function runDiagnostics(cwd) {
     }
     const cssEntries = CSS_ENTRY_CANDIDATES.map((rel) => ({
       rel,
-      content: readIfExists(join7(cwd, rel))
+      content: readIfExists(join5(cwd, rel))
     })).filter((entry) => entry.content !== null);
     const importsTailwind = cssEntries.some((entry) => V4_CSS_IMPORT.test(entry.content));
     const usesV3Directives = cssEntries.some((entry) => V3_CSS_DIRECTIVE.test(entry.content));
@@ -570,7 +473,7 @@ function runDiagnostics(cwd) {
       ok("tailwind-config-active", "JS Tailwind config is loaded via `@config`");
     }
   }
-  if (existsSync6(join7(cwd, "tsconfig.json"))) {
+  if (existsSync4(join5(cwd, "tsconfig.json"))) {
     ok("tsconfig-found", "tsconfig.json found");
     const tsRange = deps.typescript;
     if (tsRange) {
@@ -598,86 +501,224 @@ function countIssues(results) {
   return results.filter((result) => result.level !== "ok").length;
 }
 async function doctor() {
-  console.log(chalk7.bold("Object UI Doctor"));
+  console.log(chalk5.bold("Object UI Doctor"));
   console.log("Diagnosis in progress...\n");
   const results = runDiagnostics(process.cwd());
   for (const result of results) {
     if (result.level === "ok") {
-      console.log(chalk7.green(`\u2713 ${result.message}`));
+      console.log(chalk5.green(`\u2713 ${result.message}`));
     } else if (result.level === "warn") {
-      console.log(chalk7.yellow(`\u26A0\uFE0F ${result.message}`));
+      console.log(chalk5.yellow(`\u26A0\uFE0F ${result.message}`));
     } else {
-      console.log(chalk7.red(`x ${result.message}`));
+      console.log(chalk5.red(`x ${result.message}`));
     }
   }
   const issues = countIssues(results);
   console.log("\nResult:");
   if (issues === 0) {
-    console.log(chalk7.green("Everything looks good! \u2728"));
+    console.log(chalk5.green("Everything looks good! \u2728"));
   } else {
-    console.log(chalk7.yellow(`Found ${issues} issue(s).`));
+    console.log(chalk5.yellow(`Found ${issues} issue(s).`));
   }
 }
 
-// src/commands/add.ts
-import chalk8 from "chalk";
-async function add(component) {
-  console.log(chalk8.bold(`Object UI Add: ${component}`));
-  console.log(chalk8.yellow("Feature not implemented yet."));
-  console.log(`This command will download the source code for ${component}Renderer to your project.`);
+// src/commands/check.ts
+import chalk6 from "chalk";
+import { globSync } from "glob";
+import { readFileSync as readFileSync2 } from "fs";
+import { join as join6 } from "path";
+import { parse as parseJsonc, printParseErrorCode } from "jsonc-parser";
+
+// src/utils/authoring-face.ts
+import { StrictAnyComponentSchema } from "@object-ui/types/zod";
+
+// src/utils/issue-path.ts
+function formatIssuePath(path) {
+  const segments = path ?? [];
+  return segments.length > 0 ? segments.join(" \u2192 ") : "(root)";
 }
 
-// src/commands/studio.ts
-import chalk9 from "chalk";
-import { spawn } from "child_process";
-import { existsSync as existsSync7 } from "fs";
-import { join as join8, resolve as resolve3, dirname as dirname2 } from "path";
-import { fileURLToPath } from "url";
-async function studio() {
-  console.log(chalk9.bold("\n\u{1F3A8} Starting ObjectUI Studio...\n"));
-  const cwd = process.cwd();
-  const __filename3 = fileURLToPath(import.meta.url);
-  const __dirname3 = dirname2(__filename3);
-  const candidates = [
-    join8(cwd, "apps/console"),
-    resolve3(__dirname3, "../../apps/console"),
-    resolve3(__dirname3, "../../../apps/console")
-  ];
-  let consolePath = null;
-  for (const candidate of candidates) {
-    if (existsSync7(join8(candidate, "package.json"))) {
-      consolePath = candidate;
-      break;
+// 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;
   }
-  if (!consolePath) {
-    console.log(chalk9.yellow("\u26A0  Console app not found in workspace."));
-    console.log(chalk9.dim("  Hint: Run this command from the monorepo root."));
-    console.log(chalk9.dim("  Expected: apps/console/package.json\n"));
-    process.exit(1);
+  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);
+      }
+    }
   }
-  console.log(chalk9.dim(`  Console: ${consolePath}`));
-  console.log(chalk9.dim("  Mode:    MSW (in-browser mock server)\n"));
-  const child = spawn("pnpm", ["run", "dev"], {
-    cwd: consolePath,
-    stdio: "inherit",
-    env: { ...process.env, NODE_ENV: "development" },
-    shell: true
+  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 }
+      }
+    ];
   });
-  child.on("error", (err) => {
-    console.error(chalk9.red(`
-  \u2717 Failed to start studio: ${err.message}`));
-    process.exit(1);
+  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;
   });
-  child.on("exit", (code) => process.exit(code ?? 0));
 }
 
-// src/commands/check.ts
-import chalk10 from "chalk";
-import { globSync } from "glob";
-import { readFileSync as readFileSync2 } from "fs";
-import { join as join9 } from "path";
-import { parse as parseJsonc, printParseErrorCode } from "jsonc-parser";
+// 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 = [
@@ -690,7 +731,6 @@ var KNOWN_SCHEMA_TYPES = [
   "action:icon",
   "action:menu",
   "address",
-  "advanced-chart",
   "ai-form-assist",
   "ai-recommendations",
   "ai:feedback",
@@ -699,27 +739,21 @@ var KNOWN_SCHEMA_TYPES = [
   "alert",
   "alert-dialog",
   "app",
-  "app-creation-wizard",
   "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",
-  "area-chart",
   "article",
   "aside",
   "aspect-ratio",
-  "auto_number",
   "avatar",
   "b",
   "badge",
   "bar-chart",
   "blockquote",
-  "boolean",
+  "box",
   "br",
-  "branding-editor",
   "breadcrumb",
   "button",
   "button-group",
@@ -733,28 +767,22 @@ var KNOWN_SCHEMA_TYPES = [
   "chatbot-enhanced",
   "chatbot-floating",
   "checkbox",
-  "checkboxes",
+  "checklist",
   "cite",
   "cloud-connection:panel",
   "cloud:ai-model-status",
-  "cloud:onboarding-next",
+  "cloud:workspace-timezone-notice",
   "code",
   "code-editor",
   "collapsible",
-  "color",
   "combobox",
   "command",
   "container",
   "context-menu",
-  "currency",
   "dashboard",
-  "dashboard-editor",
-  "dashboard-grid",
   "data-model-designer",
   "data-table",
-  "date",
   "date-picker",
-  "datetime",
   "dd",
   "del",
   "detail",
@@ -763,7 +791,6 @@ var KNOWN_SCHEMA_TYPES = [
   "dialog",
   "div",
   "dl",
-  "donut-chart",
   "drawer",
   "dropdown-menu",
   "dt",
@@ -813,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",
@@ -836,17 +864,12 @@ var KNOWN_SCHEMA_TYPES = [
   "field:video",
   "figcaption",
   "figure",
-  "file",
   "file-upload",
   "filter-builder",
   "filter-ui",
   "flex",
   "footer",
   "form",
-  "form-analytics",
-  "formula",
-  "gantt",
-  "geolocation",
   "global:notifications",
   "global:search",
   "grid",
@@ -858,6 +881,7 @@ var KNOWN_SCHEMA_TYPES = [
   "h6",
   "header",
   "header-bar",
+  "hero",
   "home",
   "hover-card",
   "hr",
@@ -866,47 +890,27 @@ var KNOWN_SCHEMA_TYPES = [
   "icon",
   "image",
   "img",
-  "import-wizard",
   "input",
   "input-otp",
   "ins",
-  "kanban",
-  "kanban-enhanced",
-  "kanban-ui",
   "kbd",
   "label",
   "layout:app-schema-renderer",
-  "layout:navigation-renderer",
-  "layout:page-header",
   "layout:page:card",
-  "layout:responsive-grid",
   "li",
-  "line-chart",
   "list",
   "list-view",
   "loading",
-  "location",
-  "lookup",
   "main",
-  "map",
   "mark",
   "markdown",
-  "marketplace:installed-list",
-  "master_detail",
   "mcp:connect-agent",
   "menubar",
-  "metric",
-  "metric-card",
-  "multiselect",
   "nav",
   "nav:breadcrumb",
   "nav:menu",
-  "navigation-designer",
   "navigation-menu",
-  "navigation-renderer",
   "nl-query",
-  "number",
-  "object",
   "object-calendar",
   "object-chart",
   "object-data-table",
@@ -927,7 +931,6 @@ var KNOWN_SCHEMA_TYPES = [
   "p",
   "page",
   "page-designer",
-  "page-header",
   "page:accordion",
   "page:card",
   "page:footer",
@@ -937,57 +940,37 @@ var KNOWN_SCHEMA_TYPES = [
   "page:tabs",
   "pagination",
   "password",
-  "percent",
-  "phone",
-  "pie-chart",
   "pivot",
   "plugin-calendar:calendar-view",
   "plugin-calendar:object-calendar",
-  "plugin-charts:advanced-chart",
-  "plugin-charts:area-chart",
   "plugin-charts:bar-chart",
   "plugin-charts:chart",
   "plugin-charts:chart:bar",
-  "plugin-charts:donut-chart",
-  "plugin-charts:line-chart",
   "plugin-charts:object-chart",
-  "plugin-charts:pie-chart",
-  "plugin-charts:radar-chart",
-  "plugin-charts:scatter-chart",
   "plugin-chatbot:chatbot",
   "plugin-chatbot:chatbot-enhanced",
   "plugin-chatbot:chatbot-floating",
   "plugin-dashboard:dashboard",
-  "plugin-dashboard:dashboard-grid",
   "plugin-dashboard:metric",
   "plugin-dashboard:metric-card",
   "plugin-dashboard:object-data-table",
   "plugin-dashboard:object-metric",
   "plugin-dashboard:object-pivot",
   "plugin-dashboard:pivot",
-  "plugin-designer:app-creation-wizard",
-  "plugin-designer:branding-editor",
-  "plugin-designer:dashboard-editor",
   "plugin-designer:data-model-designer",
   "plugin-designer:field-designer",
-  "plugin-designer:navigation-designer",
   "plugin-designer:object-manager",
   "plugin-designer:page-designer",
   "plugin-designer:process-designer",
   "plugin-designer:report-designer",
   "plugin-detail:detail-section",
   "plugin-detail:detail-view",
-  "plugin-detail:related-list",
   "plugin-editor:code-editor",
   "plugin-form:embeddable-form",
-  "plugin-form:form-analytics",
   "plugin-form:object-form",
   "plugin-form:object-master-detail-form",
   "plugin-gantt:object-gantt",
-  "plugin-grid:import-wizard",
   "plugin-grid:object-grid",
-  "plugin-kanban:kanban-enhanced",
-  "plugin-kanban:kanban-ui",
   "plugin-kanban:object-kanban",
   "plugin-list:list-view",
   "plugin-list:object-gallery",
@@ -995,12 +978,10 @@ var KNOWN_SCHEMA_TYPES = [
   "plugin-markdown:markdown",
   "plugin-report:report",
   "plugin-report:report-viewer",
-  "plugin-report:spec-report",
   "plugin-timeline:object-timeline",
   "plugin-timeline:timeline",
   "plugin-tree:object-tree",
   "plugin-view:object-view",
-  "plugin-view:view",
   "plugin-view:view:simple",
   "popover",
   "pre",
@@ -1052,7 +1033,6 @@ var KNOWN_SCHEMA_TYPES = [
   "protocol-placeholder:global:search",
   "protocol-placeholder:nav:breadcrumb",
   "protocol-placeholder:nav:menu",
-  "protocol-placeholder:page-header",
   "protocol-placeholder:page:accordion",
   "protocol-placeholder:page:card",
   "protocol-placeholder:page:footer",
@@ -1065,7 +1045,6 @@ var KNOWN_SCHEMA_TYPES = [
   "protocol-placeholder:record:highlights",
   "protocol-placeholder:record:path",
   "protocol-placeholder:record:related_list",
-  "protocol-placeholder:user:profile",
   "protocol-placeholder:view:calendar",
   "protocol-placeholder:view:drawer",
   "protocol-placeholder:view:gallery",
@@ -1092,14 +1071,11 @@ var KNOWN_SCHEMA_TYPES = [
   "protocol-placeholder:widget:table",
   "protocol-placeholder:widget:text",
   "q",
-  "qrcode",
-  "radar-chart",
-  "radio",
   "radio-group",
-  "rating",
   "record",
   "record:activity",
   "record:alert",
+  "record:approval_decision",
   "record:approvals",
   "record:attachments",
   "record:chatter",
@@ -1112,55 +1088,35 @@ var KNOWN_SCHEMA_TYPES = [
   "record:quick_actions",
   "record:reference_rail",
   "record:related_list",
-  "related-list",
   "report",
   "report-designer",
   "report-viewer",
-  "report:report",
-  "report:report-viewer",
-  "report:spec-report",
   "resizable",
-  "responsive-grid",
-  "richtext",
-  "scatter-chart",
   "scroll-area",
   "section",
   "select",
   "separator",
-  "shared-view-link",
   "sheet",
   "sidebar",
-  "sidebar-content",
-  "sidebar-footer",
-  "sidebar-group",
-  "sidebar-header",
-  "sidebar-inset",
-  "sidebar-menu",
-  "sidebar-menu-button",
-  "sidebar-menu-item",
-  "sidebar-provider",
-  "sidebar-trigger",
-  "signature",
   "skeleton",
   "slider",
   "small",
   "sonner",
   "sort-ui",
   "span",
-  "spec-report",
   "spinner",
   "stack",
+  "stat",
   "statistic",
   "strong",
   "sub",
-  "summary",
   "sup",
   "switch",
   "table",
   "tabs",
-  "tags",
   "text",
   "textarea",
+  "tile-grid",
   "time",
   "timeline",
   "toast",
@@ -1168,7 +1124,6 @@ var KNOWN_SCHEMA_TYPES = [
   "toggle",
   "toggle-group",
   "tooltip",
-  "tree",
   "tree-view",
   "u",
   "ui:a",
@@ -1177,6 +1132,7 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:address",
   "ui:alert",
   "ui:alert-dialog",
+  "ui:app",
   "ui:article",
   "ui:aside",
   "ui:aspect-ratio",
@@ -1184,6 +1140,7 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:b",
   "ui:badge",
   "ui:blockquote",
+  "ui:box",
   "ui:br",
   "ui:breadcrumb",
   "ui:button",
@@ -1193,6 +1150,7 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:carousel",
   "ui:checkbox",
   "ui:cite",
+  "ui:code",
   "ui:collapsible",
   "ui:combobox",
   "ui:command",
@@ -1226,6 +1184,7 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:h6",
   "ui:header",
   "ui:header-bar",
+  "ui:home",
   "ui:hover-card",
   "ui:hr",
   "ui:html",
@@ -1248,6 +1207,7 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:navigation-menu",
   "ui:ol",
   "ui:p",
+  "ui:page",
   "ui:pagination",
   "ui:password",
   "ui:popover",
@@ -1255,6 +1215,7 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:progress",
   "ui:q",
   "ui:radio-group",
+  "ui:record",
   "ui:resizable",
   "ui:scroll-area",
   "ui:section",
@@ -1262,16 +1223,6 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:separator",
   "ui:sheet",
   "ui:sidebar",
-  "ui:sidebar-content",
-  "ui:sidebar-footer",
-  "ui:sidebar-group",
-  "ui:sidebar-header",
-  "ui:sidebar-inset",
-  "ui:sidebar-menu",
-  "ui:sidebar-menu-button",
-  "ui:sidebar-menu-item",
-  "ui:sidebar-provider",
-  "ui:sidebar-trigger",
   "ui:skeleton",
   "ui:slider",
   "ui:small",
@@ -1297,17 +1248,13 @@ var KNOWN_SCHEMA_TYPES = [
   "ui:tree-view",
   "ui:u",
   "ui:ul",
+  "ui:utility",
   "ul",
-  "url",
-  "user",
-  "user:profile",
+  "usage-bar",
   "utility",
-  "vector",
-  "view",
   "view-switcher",
   "view:calendar",
   "view:chart",
-  "view:dashboard",
   "view:detail",
   "view:drawer",
   "view:filter-ui",
@@ -1319,13 +1266,11 @@ var KNOWN_SCHEMA_TYPES = [
   "view:list",
   "view:map",
   "view:modal",
-  "view:shared-view-link",
   "view:simple",
   "view:sort-ui",
   "view:split",
   "view:tabbed",
   "view:timeline",
-  "view:tree",
   "view:view-switcher",
   "view:wizard",
   "widget:bar",
@@ -1346,9 +1291,93 @@ function isKnownSchemaType(type) {
   return KNOWN_SCHEMA_TYPE_SET.has(type);
 }
 
+// src/utils/known-type-case-suggestion.ts
+function suggestKnownTypeByCase(type) {
+  if (typeof type !== "string" || type === "") return void 0;
+  const wanted = type.toLowerCase();
+  for (const candidate of KNOWN_SCHEMA_TYPES) {
+    if (candidate !== type && candidate.toLowerCase() === wanted) return candidate;
+  }
+  return void 0;
+}
+function didYouMeanClause(type) {
+  const match = suggestKnownTypeByCase(type);
+  return match === void 0 ? "" : ` \u2014 did you mean "${match}"?`;
+}
+
+// src/utils/unbindable-text-expressions.ts
+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";
+function isComponentNode(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && typeof value.type === "string";
+}
+function judge(node, path, into) {
+  const evaluatedKeys = expressionBindableTextKeysFor(node.type);
+  for (const key of EXPRESSION_BINDABLE_TEXT_KEYS) {
+    const value = node[key];
+    if (typeof value !== "string" || !EXPRESSION_PATTERN.test(value)) continue;
+    if (evaluatedKeys.includes(key)) continue;
+    into.push({
+      severity: isKnownSchemaType(node.type) ? "refusal" : "warning",
+      path: [...path, key],
+      type: node.type,
+      key,
+      evaluatedKeys
+    });
+  }
+}
+function visit(node, path, isDocumentRoot, into) {
+  if (!(isDocumentRoot && node.type === PAGE_DOCUMENT_ROOT_TYPE)) {
+    judge(node, path, into);
+  }
+  const children = node[COMPOSITION_KEY];
+  if (Array.isArray(children)) {
+    children.forEach((child, index) => {
+      if (isComponentNode(child)) visit(child, [...path, COMPOSITION_KEY, index], false, 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 = [];
+  if (isComponentNode(document)) visit(document, [], true, found);
+  return found;
+}
+var inCode = (key) => "`" + key + "`";
+function describeUnbindableTextExpression(finding) {
+  const at = formatIssuePath(finding.path);
+  if (finding.severity === "warning") {
+    return `at ${at}: "${finding.type}" is not a registered component, so the expression on ${inCode(finding.key)} is not refused; a custom renderer may evaluate it itself.`;
+  }
+  const evaluates = finding.evaluatedKeys.length > 0 ? `it evaluates only ${finding.evaluatedKeys.map(inCode).join(", ")}` : `it evaluates none of ${EXPRESSION_BINDABLE_TEXT_KEYS.map(inCode).join(", ")}`;
+  return `at ${at}: "${finding.type}" never evaluates ${inCode(finding.key)} (${evaluates}), so the expression is never resolved: the user sees its literal text, or nothing.`;
+}
+function workingChannels(finding) {
+  const channels = [
+    ...finding.evaluatedKeys.map(inCode),
+    inCode("content"),
+    `${inCode(`properties.${finding.key}`)} (evaluated, then hoisted onto the node)`
+  ];
+  return `Channels SchemaRenderer evaluates: ${channels.join(", ")}; or resolve the value in the host before the schema reaches SchemaRenderer.`;
+}
+
 // src/commands/check.ts
 var OBJECTUI_STRUCTURAL_KEYS = [
   // Composition — the `children`/`body`-class keys the ruling names.
+  // `body` is the RETIRED spelling, kept so old files are still identified and
+  // then refused — see the docblock above (objectui#6771).
   "body",
   "children",
   // Presentation.
@@ -1367,8 +1396,24 @@ var OBJECTUI_STRUCTURAL_KEYS = [
   "testId",
   "ariaLabel"
 ];
-function isObjectUiSchemaFile(content) {
-  return OBJECTUI_STRUCTURAL_KEYS.some((key) => key in content);
+function recogniseObjectUiSchemaFile(content) {
+  if (OBJECTUI_STRUCTURAL_KEYS.some((key) => key in content)) {
+    return { recognised: true, validated: false };
+  }
+  const result = validateAuthoredDocument(content);
+  return result.success ? { recognised: true, validated: true } : { recognised: false, issues: result.error.issues };
+}
+function describeFirstIssue(issues) {
+  const [first] = issues;
+  if (first === void 0) return void 0;
+  const lead = issues.length === 1 ? "Issue" : `First of ${issues.length} issues`;
+  return `${lead} at ${formatIssuePath(first.path)}: ${first.message}`;
+}
+function closingLine(tally) {
+  return `ObjectUI schema files: ${tally.validated} validated, ${tally.notValidated} recognised but not validated, ${tally.didNotValidate} did not validate. This sweep is advisory; run \`objectui validate <file>\` for a verdict.`;
+}
+function isUnvalidatedCandidate(type) {
+  return isKnownSchemaType(type);
 }
 function describeParseError(text, error) {
   const upTo = text.slice(0, error.offset);
@@ -1377,69 +1422,158 @@ function describeParseError(text, error) {
   return `${printParseErrorCode(error.error)} at line ${line} column ${column}`;
 }
 async function check(cwd = process.cwd()) {
-  console.log(chalk10.bold("Object UI Schema Check"));
+  console.log(chalk6.bold("Object UI Schema Check"));
   const files = globSync("**/*.{json,yaml,yml}", {
     cwd,
-    ignore: ["node_modules/**", "dist/**", ".git/**"]
+    // `glob` matches `ignore` patterns against the path relative to `cwd`, so
+    // an unanchored `dist/**`/`node_modules/**` excludes only a directory of
+    // that name at the scan root — every nested `packages/*/dist/`,
+    // `examples/*/dist/`, `apps/*/dist/` (and their `node_modules/`) is still
+    // scanned. `**/` anchors the match at any depth (objectui#6320): measured
+    // on this repository, a built tree without it reports roughly double the
+    // files of a clean checkout, almost all of it re-reading the author's own
+    // schemas from build output.
+    ignore: ["**/node_modules/**", "**/dist/**", ".git/**"]
   });
   console.log(`Analyzing ${files.length} files...`);
   let errors = 0;
   let skipped = 0;
+  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")) {
-        const text = readFileSync2(join9(cwd, file), "utf-8");
+        const text = readFileSync2(join6(cwd, file), "utf-8");
         const parseErrors = [];
         const content = parseJsonc(text, parseErrors, { allowTrailingComma: true });
         if (parseErrors.length > 0) {
           const [first] = parseErrors;
           console.log(
-            chalk10.red(`x Invalid JSON in ${file}: ${describeParseError(text, first)}`)
+            chalk6.red(`x Invalid JSON in ${file}: ${describeParseError(text, first)}`)
           );
           errors++;
           continue;
         }
         if (content && typeof content === "object" && content.type) {
           if (typeof content.type === "string") {
-            if (!isObjectUiSchemaFile(content)) {
-              skipped++;
-            } else if (!isKnownSchemaType(content.type)) {
-              console.log(chalk10.yellow(`\u26A0\uFE0F Unknown schema type "${content.type}" in ${file}`));
+            const recognition = recogniseObjectUiSchemaFile(
+              content
+            );
+            if (!recognition.recognised) {
+              if (isUnvalidatedCandidate(content.type)) {
+                unvalidatedCandidates.push({
+                  file,
+                  type: content.type,
+                  issues: recognition.issues,
+                  document: content
+                });
+                judgeTextExpressions(file, content);
+              } else {
+                skipped++;
+              }
+              continue;
             }
+            if (recognition.validated) {
+              validated++;
+            } else {
+              notValidated++;
+            }
+            if (!isKnownSchemaType(content.type)) {
+              console.log(
+                chalk6.yellow(
+                  `\u26A0\uFE0F Unknown schema type "${content.type}" in ${file}` + didYouMeanClause(content.type)
+                )
+              );
+            }
+            judgeTextExpressions(file, content);
           }
         }
       }
     } catch (e) {
-      console.log(chalk10.red(`x Invalid JSON in ${file}: ${e.message}`));
+      console.log(chalk6.red(`x Invalid JSON in ${file}: ${e.message}`));
       errors++;
     }
   }
+  if (unvalidatedCandidates.length > 0) {
+    const n = unvalidatedCandidates.length;
+    console.log(
+      chalk6.yellow(
+        `\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, 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.")
+    );
+    console.log(
+      chalk6.dim(
+        "   Either the document is off-spec, or its component type is not modelled by @object-ui/types."
+      )
+    );
+    console.log(
+      chalk6.dim(
+        "   These are NOT counted as skipped: a schema that fails validation is a broken schema, not a foreign file."
+      )
+    );
+  }
   if (skipped > 0) {
     console.log(
-      chalk10.dim(
-        `Skipped ${skipped} file${skipped === 1 ? "" : "s"} with a root "type" and no ObjectUI schema marker.`
+      chalk6.dim(
+        `Skipped ${skipped} file${skipped === 1 ? "" : "s"} with a root "type" that no ObjectUI recogniser admitted.`
       )
     );
     console.log(
-      chalk10.dim(
+      chalk6.dim(
         `  A file is checked when its root carries an ObjectUI structural key: ${OBJECTUI_STRUCTURAL_KEYS.join(", ")}.`
       )
     );
+    console.log(
+      chalk6.dim(
+        "  It is also checked when the whole document validates as an ObjectUI component schema."
+      )
+    );
   }
   if (errors === 0) {
-    console.log(chalk10.green("\u2713 All checks passed"));
+    console.log(
+      closingLine({
+        validated,
+        notValidated,
+        didNotValidate: unvalidatedCandidates.length
+      })
+    );
   } else {
-    console.log(chalk10.red(`Found ${errors} errors`));
+    console.log(chalk6.red(`Found ${errors} errors`));
     process.exit(1);
   }
 }
 
 // src/commands/validate.ts
-import chalk11 from "chalk";
-import { readFileSync as readFileSync3, existsSync as existsSync8 } from "fs";
-import { resolve as resolve4 } from "path";
+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 } from "@object-ui/types/zod";
 
 // src/utils/spec-vocabulary-hint.ts
 function findSpecVocabularyFormFields(node, path = "") {
@@ -1470,81 +1604,165 @@ function findSpecVocabularyFormFields(node, path = "") {
   return findings;
 }
 
+// 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]));
+  }
+  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 (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" });
+    }
+  }
+  for (const [key, value] of Object.entries(document)) {
+    findings.push(...findRecordBindingsWithoutLimitOne(value, [...path, key]));
+  }
+  return findings;
+}
+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
 async function validate(schemaPath) {
-  console.log(chalk11.blue("\u{1F50D} ObjectUI Schema Validator\n"));
-  const resolvedPath = resolve4(process.cwd(), schemaPath);
-  if (!existsSync8(resolvedPath)) {
-    console.error(chalk11.red(`\u2717 Error: Schema file not found: ${schemaPath}`));
+  console.log(chalk7.blue("\u{1F50D} ObjectUI Schema Validator\n"));
+  const resolvedPath = resolve3(process.cwd(), schemaPath);
+  if (!existsSync5(resolvedPath)) {
+    console.error(chalk7.red(`\u2717 Error: Schema file not found: ${schemaPath}`));
     process.exit(1);
   }
   try {
     const fileContent = readFileSync3(resolvedPath, "utf-8");
     let schema;
     if (schemaPath.endsWith(".yaml") || schemaPath.endsWith(".yml")) {
-      console.log(chalk11.gray(`Reading YAML schema from: ${schemaPath}`));
+      console.log(chalk7.gray(`Reading YAML schema from: ${schemaPath}`));
       schema = loadYaml(fileContent);
     } else if (schemaPath.endsWith(".json")) {
-      console.log(chalk11.gray(`Reading JSON schema from: ${schemaPath}`));
+      console.log(chalk7.gray(`Reading JSON schema from: ${schemaPath}`));
       schema = JSON.parse(fileContent);
     } else {
       try {
         schema = JSON.parse(fileContent);
-        console.log(chalk11.gray(`Reading schema from: ${schemaPath} (detected as JSON)`));
+        console.log(chalk7.gray(`Reading schema from: ${schemaPath} (detected as JSON)`));
       } catch {
         schema = loadYaml(fileContent);
-        console.log(chalk11.gray(`Reading schema from: ${schemaPath} (detected as YAML)`));
+        console.log(chalk7.gray(`Reading schema from: ${schemaPath} (detected as YAML)`));
       }
     }
-    console.log(chalk11.gray("Validating schema...\n"));
-    const result = safeValidateSchema(schema);
+    console.log(chalk7.gray("Validating schema...\n"));
+    const result = validateAuthoredDocument(schema);
     if (result.success) {
-      console.log(chalk11.green("\u2713 Schema is valid!\n"));
+      console.log(chalk7.green("\u2713 Schema is valid!\n"));
       const data = result.data;
-      console.log(chalk11.bold("Schema Information:"));
-      console.log(chalk11.gray("  Type:"), data.type || "unknown");
+      console.log(chalk7.bold("Schema Information:"));
+      console.log(chalk7.gray("  Type:"), data.type || "unknown");
       if (data.id) {
-        console.log(chalk11.gray("  ID:"), data.id);
+        console.log(chalk7.gray("  ID:"), data.id);
       }
-      if (data.label || data.title) {
-        console.log(chalk11.gray("  Label:"), data.label || data.title);
+      const title = "title" in data ? data.title : void 0;
+      if (data.label || title) {
+        console.log(chalk7.gray("  Label:"), data.label || title);
       }
       if (data.children && Array.isArray(data.children)) {
-        console.log(chalk11.gray("  Children:"), data.children.length);
+        console.log(chalk7.gray("  Children:"), data.children.length);
       }
       const mixed = findSpecVocabularyFormFields(schema).filter((f) => f.mixedName);
-      if (mixed.length > 0) {
-        console.log(chalk11.yellow("\nWarnings:"));
+      const unboundedRecordBindings = findRecordBindingsWithoutLimitOne(schema);
+      if (mixed.length > 0 || unboundedRecordBindings.length > 0) {
+        console.log(chalk7.yellow("\nWarnings:"));
         for (const m of mixed) {
-          console.log(chalk11.yellow(
+          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);
     } else {
-      console.error(chalk11.red("\u2717 Schema validation failed!\n"));
-      console.error(chalk11.bold("Validation Errors:"));
+      console.error(chalk7.red("\u2717 Schema validation failed!\n"));
+      console.error(chalk7.bold("Validation Errors:"));
       result.error.issues.forEach((issue, index) => {
-        console.error(chalk11.red(`
+        console.error(chalk7.red(`
 ${index + 1}. ${issue.message}`));
-        if (issue.path && issue.path.length > 0) {
-          console.error(chalk11.gray(`   Path: ${issue.path.join(" \u2192 ")}`));
-        }
+        console.error(chalk7.gray(`   Path: ${formatIssuePath(issue.path)}`));
         if (issue.code) {
-          console.error(chalk11.gray(`   Code: ${issue.code}`));
+          console.error(chalk7.gray(`   Code: ${issue.code}`));
         }
+        explainUnionIssue(issue, schema).forEach((line, sub) => {
+          const where = formatIssuePath(line.path);
+          if (line.kind === "note") {
+            const at = line.path.length > 0 ? ` at ${where}` : "";
+            if (line.authoredType === void 0) {
+              console.error(
+                chalk7.yellow(
+                  `   No \`type\` is declared${at}, so none of the ${line.totalArmNames} accepted component types can be selected.`
+                )
+              );
+              return;
+            }
+            console.error(
+              chalk7.yellow(`   No arm accepts type "${line.authoredType}"${at}.`)
+            );
+            if (line.candidates.length > 0) {
+              console.error(
+                chalk7.gray(
+                  `   Nearest of the ${line.totalArmNames} accepted types: ` + line.candidates.join(", ")
+                )
+              );
+            }
+            return;
+          }
+          const arm = line.arm === void 0 ? "" : `[arm ${line.arm}] `;
+          console.error(chalk7.red(`   ${index + 1}.${sub + 1} ${arm}${line.message}`));
+          console.error(chalk7.gray(`       Path: ${where}`));
+          if (line.code) {
+            console.error(chalk7.gray(`       Code: ${line.code}`));
+          }
+        });
       });
+      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(chalk11.bold("\nLikely cause \u2014 spec form-view vocabulary in a standalone form:"));
+        console.error(chalk7.bold("\nLikely cause \u2014 spec form-view vocabulary in a standalone form:"));
         for (const s of specShaped) {
-          console.error(chalk11.yellow(
+          console.error(chalk7.yellow(
             `   ${s.path}: { field: '${s.field}' } is the spec form-VIEW shape (an object-field reference).`
           ));
         }
-        console.error(chalk11.yellow(
+        console.error(chalk7.yellow(
           `   A standalone \`type: 'form'\` component uses { name: \u2026 } (the form data path).
    Fix: author the field with \`name\` and its own type/label \u2014 or, to reference object fields
    with the spec shape, use an object-bound form (\`type: 'object-form'\` with objectName +
@@ -1555,61 +1773,28 @@ ${index + 1}. ${issue.message}`));
       process.exit(1);
     }
   } catch (error) {
-    console.error(chalk11.red("\n\u2717 Error reading or parsing schema file:"));
-    console.error(chalk11.red(error.message));
+    console.error(chalk7.red("\n\u2717 Error reading or parsing schema file:"));
+    console.error(chalk7.red(error.message));
     console.error("");
     process.exit(1);
   }
 }
 
-// src/commands/create-plugin.ts
-import chalk12 from "chalk";
-import { spawn as spawn2 } from "child_process";
-import { resolve as resolve5, dirname as dirname3 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var __filename = fileURLToPath2(import.meta.url);
-var __dirname = dirname3(__filename);
-async function createPlugin(pluginName) {
-  console.log(chalk12.blue("\u{1F680} Creating ObjectUI plugin...\n"));
-  const createPluginScript = resolve5(
-    __dirname,
-    "../../../create-plugin/dist/index.js"
-  );
-  return new Promise((resolve7, reject) => {
-    const child = spawn2("node", [createPluginScript, pluginName], {
-      stdio: "inherit",
-      shell: true
-    });
-    child.on("error", (error) => {
-      console.error(chalk12.red("Failed to create plugin:"), error);
-      reject(error);
-    });
-    child.on("exit", (code) => {
-      if (code === 0) {
-        resolve7();
-      } else {
-        reject(new Error(`create-plugin exited with code ${code}`));
-      }
-    });
-  });
-}
-
 // src/commands/analyze.ts
-import chalk13 from "chalk";
-import { existsSync as existsSync9, statSync, readdirSync } from "fs";
-import { resolve as resolve6, join as join10, extname } from "path";
+import chalk8 from "chalk";
+import { existsSync as existsSync6, statSync, readdirSync } from "fs";
+import { resolve as resolve4, join as join7, extname } from "path";
 async function analyzeBundleSize() {
-  console.log(chalk13.bold("\n\u{1F4E6} Bundle Size Analysis\n"));
-  const distDir = resolve6(process.cwd(), "dist");
-  if (!existsSync9(distDir)) {
-    console.log(chalk13.yellow("\u26A0 No dist directory found. Run build first."));
-    return;
+  console.log(chalk8.bold("\n\u{1F4E6} Bundle Size Analysis\n"));
+  const distDir = resolve4(process.cwd(), "dist");
+  if (!existsSync6(distDir)) {
+    throw new Error("No dist/ directory to analyze. Run `objectui build` first.");
   }
   const files = [];
   function scanDirectory(dir) {
     const items = readdirSync(dir);
     for (const item of items) {
-      const fullPath = join10(dir, item);
+      const fullPath = join7(dir, item);
       const stat = statSync(fullPath);
       if (stat.isDirectory()) {
         scanDirectory(fullPath);
@@ -1628,48 +1813,34 @@ async function analyzeBundleSize() {
   const cssFiles = files.filter((f) => extname(f.path) === ".css");
   const jsSize = jsFiles.reduce((sum, file) => sum + file.size, 0);
   const cssSize = cssFiles.reduce((sum, file) => sum + file.size, 0);
-  console.log(chalk13.bold("Summary:"));
-  console.log(chalk13.gray("  Total Size:"), formatBytes(totalSize));
-  console.log(chalk13.gray("  JavaScript:"), formatBytes(jsSize), chalk13.dim(`(${jsFiles.length} files)`));
-  console.log(chalk13.gray("  CSS:       "), formatBytes(cssSize), chalk13.dim(`(${cssFiles.length} files)`));
-  console.log(chalk13.gray("  Other:     "), formatBytes(totalSize - jsSize - cssSize));
-  console.log(chalk13.bold("\nLargest Files:"));
+  console.log(chalk8.bold("Summary:"));
+  console.log(chalk8.gray("  Total Size:"), formatBytes(totalSize));
+  console.log(chalk8.gray("  JavaScript:"), formatBytes(jsSize), chalk8.dim(`(${jsFiles.length} files)`));
+  console.log(chalk8.gray("  CSS:       "), formatBytes(cssSize), chalk8.dim(`(${cssFiles.length} files)`));
+  console.log(chalk8.gray("  Other:     "), formatBytes(totalSize - jsSize - cssSize));
+  console.log(chalk8.bold("\nLargest Files:"));
   files.slice(0, 10).forEach((file) => {
     const sizeStr = formatBytes(file.size).padStart(10);
-    console.log(chalk13.gray(`  ${sizeStr}`), file.path);
+    console.log(chalk8.gray(`  ${sizeStr}`), file.path);
   });
-  console.log(chalk13.bold("\n\u{1F4A1} Recommendations:"));
+  console.log(chalk8.bold("\n\u{1F4A1} Recommendations:"));
   if (totalSize > 1024 * 1024) {
-    console.log(chalk13.yellow("  \u26A0 Total bundle size is large (> 1MB)"));
-    console.log(chalk13.gray("    Consider code splitting or lazy loading"));
+    console.log(chalk8.yellow("  \u26A0 Total bundle size is large (> 1MB)"));
+    console.log(chalk8.gray("    Consider code splitting or lazy loading"));
   }
   if (jsSize > 500 * 1024) {
-    console.log(chalk13.yellow("  \u26A0 JavaScript bundle is large (> 500KB)"));
-    console.log(chalk13.gray("    Consider:"));
-    console.log(chalk13.gray("    - Tree shaking unused code"));
-    console.log(chalk13.gray("    - Lazy loading components"));
-    console.log(chalk13.gray("    - Using dynamic imports"));
+    console.log(chalk8.yellow("  \u26A0 JavaScript bundle is large (> 500KB)"));
+    console.log(chalk8.gray("    Consider:"));
+    console.log(chalk8.gray("    - Tree shaking unused code"));
+    console.log(chalk8.gray("    - Lazy loading components"));
+    console.log(chalk8.gray("    - Using dynamic imports"));
   }
   if (files.length > 100) {
-    console.log(chalk13.yellow(`  \u26A0 Large number of files (${files.length})`));
-    console.log(chalk13.gray("    Consider bundling or combining files"));
+    console.log(chalk8.yellow(`  \u26A0 Large number of files (${files.length})`));
+    console.log(chalk8.gray("    Consider bundling or combining files"));
   }
   console.log("");
 }
-async function analyzeRenderPerformance() {
-  console.log(chalk13.bold("\n\u26A1 Render Performance Analysis\n"));
-  console.log(chalk13.gray("Performance analysis features:"));
-  console.log(chalk13.gray("  \u2713 Expression caching enabled"));
-  console.log(chalk13.gray("  \u2713 Component memoization available"));
-  console.log(chalk13.gray("  \u2713 Virtual scrolling support for large lists"));
-  console.log(chalk13.bold("\n\u{1F4A1} Performance Tips:"));
-  console.log(chalk13.gray("  \u2022 Use virtual scrolling for lists > 100 items"));
-  console.log(chalk13.gray("  \u2022 Cache frequently evaluated expressions"));
-  console.log(chalk13.gray("  \u2022 Use React.memo for expensive components"));
-  console.log(chalk13.gray("  \u2022 Implement pagination for large datasets"));
-  console.log(chalk13.gray("  \u2022 Use code splitting for large apps"));
-  console.log("");
-}
 function formatBytes(bytes) {
   if (bytes === 0) return "0 B";
   const k = 1024;
@@ -1677,26 +1848,20 @@ function formatBytes(bytes) {
   const i = Math.floor(Math.log(bytes) / Math.log(k));
   return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
 }
-async function analyze(options = {}) {
-  console.log(chalk13.blue("\u{1F50D} ObjectUI Performance Analyzer\n"));
-  const runAll = !options.bundleSize && !options.renderPerformance;
-  if (options.bundleSize || runAll) {
-    await analyzeBundleSize();
-  }
-  if (options.renderPerformance || runAll) {
-    await analyzeRenderPerformance();
-  }
-  console.log(chalk13.green("\u2713 Analysis complete!\n"));
+async function analyze() {
+  console.log(chalk8.blue("\u{1F50D} ObjectUI Performance Analyzer\n"));
+  await analyzeBundleSize();
+  console.log(chalk8.green("\u2713 Analysis complete!\n"));
 }
 
 // src/cli.ts
 import { readFileSync as readFileSync4 } from "fs";
-import { fileURLToPath as fileURLToPath3 } from "url";
-import { dirname as dirname4, join as join11 } from "path";
-var __filename2 = fileURLToPath3(import.meta.url);
-var __dirname2 = dirname4(__filename2);
+import { fileURLToPath } from "url";
+import { dirname as dirname2, join as join8 } from "path";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname2(__filename);
 var packageJson = JSON.parse(
-  readFileSync4(join11(__dirname2, "../package.json"), "utf-8")
+  readFileSync4(join8(__dirname, "../package.json"), "utf-8")
 );
 var program = new Command();
 program.name("objectui").description("CLI tool for Object UI - Build applications from JSON schemas").version(packageJson.version);
@@ -1704,7 +1869,7 @@ program.command("serve").description("Start a development server with your JSON/
   try {
     await serve(schema, options);
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -1712,7 +1877,7 @@ program.command("dev").description("Start development server (alias for serve)")
   try {
     await dev(schema, options);
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -1720,7 +1885,7 @@ program.command("build").description("Build application for production").argumen
   try {
     await buildApp(schema, options);
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -1728,7 +1893,7 @@ program.command("start").description("Start production server").option("-p, --po
   try {
     await start(options);
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -1736,68 +1901,31 @@ program.command("init").description("Initialize a new Object UI application with
   try {
     await init(name, options);
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-});
-program.command("lint").description("Lint the generated application code").option("--fix", "Automatically fix linting issues").action(async (options) => {
-  try {
-    await lint(options);
-  } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-});
-program.command("test").description("Run tests for the application").option("-w, --watch", "Run tests in watch mode").option("-c, --coverage", "Generate test coverage report").option("--ui", "Run tests with Vitest UI").action(async (options) => {
-  try {
-    await test(options);
-  } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
-program.command("generate").alias("g").description("Generate new resources (objects, pages, plugins)").argument("<type>", "Type of resource to generate (resource/object, page, plugin)").argument("<name>", "Name of the resource").option("--from <source>", "Generate schema from external source (openapi.yaml, prisma.schema)").option("--output <dir>", "Output directory for generated schemas", "schemas/").action(async (type, name, options) => {
+program.command("generate").alias("g").description("Generate new resources (objects, pages, plugins)").argument("<type>", "Type of resource to generate (resource/object, page, plugin)").argument("<name>", "Name of the resource").action(async (type, name) => {
   try {
-    if (options.from) {
-      console.log(chalk14.yellow("\n\u26A0 Schema generation from external sources (OpenAPI/Prisma) is not yet implemented."));
-      console.log(chalk14.gray("This feature will be available in a future release.\n"));
-      process.exit(0);
-    }
     await generate(type, name);
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
-program.command("doctor").description("Diagnose and fix common issues").action(async () => {
+program.command("doctor").description("Diagnose common project setup issues (reports only, changes nothing)").action(async () => {
   try {
     await doctor();
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-});
-program.command("add").description("Add a new component renderer to your project").argument("<component>", "Component name (e.g. Input, Grid)").action(async (component) => {
-  try {
-    await add(component);
-  } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
-program.command("studio").description("Start the visual designer").action(async () => {
-  try {
-    await studio();
-  } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-});
-program.command("check").description("Validate schema files").action(async () => {
+program.command("check").description("Advisory JSON file sweep; run objectui validate for a verdict").action(async () => {
   try {
     await check();
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -1805,29 +1933,15 @@ program.command("validate").description("Validate a schema file against ObjectUI
   try {
     await validate(schema);
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-});
-program.command("create").description("Create new resources").argument("<type>", "Type of resource to create (plugin)").argument("<name>", "Name of the resource").action(async (type, name) => {
-  try {
-    if (type === "plugin") {
-      await createPlugin(name);
-    } else {
-      console.error(chalk14.red(`Unknown resource type: ${type}`));
-      console.log(chalk14.gray("Available types: plugin"));
-      process.exit(1);
-    }
-  } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
-program.command("analyze").description("Analyze application performance").option("--bundle-size", "Analyze bundle size").option("--render-performance", "Analyze render performance").action(async (options) => {
+program.command("analyze").description("Analyze application performance").action(async () => {
   try {
-    await analyze(options);
+    await analyze();
   } catch (error) {
-    console.error(chalk14.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(chalk9.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });