@object-ui/cli 17.3.0 → 17.6.0

package/dist/cli.js

@@ -3,10 +3,12 @@ import {
   createTempApp,
   createTempAppWithRouting,
   init,
-  parseSchemaFile,
-  scanPagesDirectory,
+  isWorkspaceRoot,
+  prepareWorkspaceTempApp,
+  reportProjectSource,
+  resolveProjectSource,
   serve
-} from "./chunk-EV2DCI7W.js";
+} from "./chunk-AP2INOE7.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -15,87 +17,22 @@ import chalk14 from "chalk";
 // src/commands/dev.ts
 import { createServer } from "vite";
 import react from "@vitejs/plugin-react";
-import { existsSync, mkdirSync, unlinkSync, statSync } from "fs";
-import { join, resolve, dirname } from "path";
+import { mkdirSync } from "fs";
+import { join } from "path";
 import chalk from "chalk";
 import { execSync } from "child_process";
-import { createRequire } from "module";
 async function dev(schemaPath, options) {
   const cwd = process.cwd();
-  let _projectRoot = cwd;
-  const targetSchemaPath = schemaPath;
-  let hasPagesDir = false;
-  let pagesDir = "";
-  let appConfig = null;
-  const absoluteSchemaPath = resolve(cwd, schemaPath);
-  if (existsSync(absoluteSchemaPath) && statSync(absoluteSchemaPath).isFile()) {
-    const fileDir = dirname(absoluteSchemaPath);
-    const potentialPagesDir = join(fileDir, "pages");
-    if (existsSync(potentialPagesDir)) {
-      console.log(chalk.blue(`\u{1F4C2} Detected project structure at ${fileDir}`));
-      _projectRoot = fileDir;
-      hasPagesDir = true;
-      pagesDir = potentialPagesDir;
-      try {
-        appConfig = parseSchemaFile(absoluteSchemaPath);
-        console.log(chalk.blue("\u2699\uFE0F  Loaded App Config from app.json"));
-      } catch (_e) {
-        console.warn("Failed to parse app config");
-      }
-    }
-  }
-  if (!hasPagesDir) {
-    const localPagesDir = join(cwd, "pages");
-    if (existsSync(localPagesDir)) {
-      hasPagesDir = true;
-      pagesDir = localPagesDir;
-      const appJsonPath = join(cwd, "app.json");
-      if (existsSync(appJsonPath)) {
-        try {
-          appConfig = parseSchemaFile(appJsonPath);
-          console.log(chalk.blue("\u2699\uFE0F  Loaded App Config from app.json"));
-        } catch (_e) {
-          console.warn("Failed to parse app.json config");
-        }
-      }
-    }
-  }
-  const require2 = createRequire(join(cwd, "package.json"));
-  let routes = [];
-  let schema = null;
-  let useFileSystemRouting = false;
-  if (hasPagesDir) {
-    console.log(chalk.blue(`\u{1F4C1} Using file-system routing from ${pagesDir}`));
-    routes = scanPagesDirectory(pagesDir);
-    useFileSystemRouting = true;
-    if (routes.length === 0) {
-      throw new Error(`No schema files found in ${pagesDir}`);
-    }
-    console.log(chalk.green(`\u2713 Found ${routes.length} route(s)`));
-    routes.forEach((route) => {
-      console.log(chalk.dim(`  ${route.path} \u2192 ${route.filePath.replace(cwd, ".")}`));
-    });
-  } else {
-    const fullSchemaPath = resolve(cwd, schemaPath);
-    if (!existsSync(fullSchemaPath)) {
-      throw new Error(`Schema file not found: ${schemaPath}
-Run 'objectui init' to create a sample schema.`);
-    }
-    console.log(chalk.blue("\u{1F4CB} Loading schema:"), chalk.cyan(schemaPath));
-    try {
-      schema = parseSchemaFile(fullSchemaPath);
-    } catch (error) {
-      throw new Error(`Invalid schema file: ${error instanceof Error ? error.message : error}`);
-    }
-  }
+  const source = resolveProjectSource(cwd, schemaPath);
+  reportProjectSource(source, cwd);
   const tmpDir = join(cwd, ".objectui-tmp");
   mkdirSync(tmpDir, { recursive: true });
-  if (useFileSystemRouting) {
-    createTempAppWithRouting(tmpDir, routes, appConfig);
+  if (source.mode === "routes") {
+    createTempAppWithRouting(tmpDir, source.routes, source.appConfig);
   } else {
-    createTempApp(tmpDir, schema);
+    createTempApp(tmpDir, source.schema);
   }
-  const isMonorepo = existsSync(join(cwd, "pnpm-workspace.yaml"));
+  const isMonorepo = isWorkspaceRoot(cwd);
   if (isMonorepo) {
     console.log(chalk.blue("\u{1F4E6} Detected monorepo - using root node_modules"));
   } else {
@@ -113,6 +50,10 @@ Run 'objectui init' to create a sample schema.`);
   }
   console.log(chalk.green("\u2713 Schema loaded successfully"));
   console.log(chalk.blue("\u{1F680} Starting development server...\n"));
+  if (isMonorepo) {
+    console.log(chalk.blue("\u{1F4E6} Detected monorepo - configuring workspace aliases"));
+  }
+  const workspaceConfig = isMonorepo ? await prepareWorkspaceTempApp(cwd, tmpDir) : {};
   const viteConfig = {
     root: tmpDir,
     server: {
@@ -124,51 +65,9 @@ Run 'objectui init' to create a sample schema.`);
         allow: [cwd]
       }
     },
-    resolve: {
-      alias: {}
-    },
-    plugins: [react()]
+    plugins: [react()],
+    ...workspaceConfig
   };
-  if (isMonorepo) {
-    console.log(chalk.blue("\u{1F4E6} Detected monorepo - configuring workspace aliases"));
-    const postcssPath = join(tmpDir, "postcss.config.js");
-    if (existsSync(postcssPath)) {
-      unlinkSync(postcssPath);
-    }
-    viteConfig.resolve.alias = {
-      "@object-ui/react": join(cwd, "packages/react/src/index.ts"),
-      "@object-ui/components": join(cwd, "packages/components/src/index.ts"),
-      "@object-ui/core": join(cwd, "packages/core/src/index.ts"),
-      "@object-ui/types": join(cwd, "packages/types/src/index.ts"),
-      "@object-ui/plugin-charts": join(cwd, "packages/plugin-charts/src/index.tsx"),
-      "@object-ui/plugin-editor": join(cwd, "packages/plugin-editor/src/index.tsx"),
-      "@object-ui/plugin-kanban": join(cwd, "packages/plugin-kanban/src/index.tsx"),
-      "@object-ui/plugin-markdown": join(cwd, "packages/plugin-markdown/src/index.tsx"),
-      "@object-ui/plugin-form": join(cwd, "packages/plugin-form/src/index.tsx"),
-      "@object-ui/plugin-grid": join(cwd, "packages/plugin-grid/src/index.tsx"),
-      "@object-ui/plugin-view": join(cwd, "packages/plugin-view/src/index.tsx")
-    };
-    try {
-      const lucidePath = require2.resolve("lucide-react", { paths: [join(cwd, "packages/components")] });
-      viteConfig.resolve.alias["lucide-react"] = lucidePath;
-    } catch (e) {
-      console.warn("\u26A0\uFE0F Could not resolve lucide-react automatically:", e);
-    }
-    try {
-      const tailwindcss = require2("tailwindcss");
-      const autoprefixer = require2("autoprefixer");
-      viteConfig.css = {
-        postcss: {
-          plugins: [
-            tailwindcss(join(tmpDir, "tailwind.config.js")),
-            autoprefixer()
-          ]
-        }
-      };
-    } catch (_e) {
-      console.warn(chalk.yellow("\u26A0\uFE0F Failed to load PostCSS plugins from root node_modules. Styles might not work correctly."));
-    }
-  }
   const server = await createServer(viteConfig);
   await server.listen();
   const { port, host } = server.config.server;
@@ -186,62 +85,47 @@ Run 'objectui init' to create a sample schema.`);
 // src/commands/build.ts
 import { build as viteBuild } from "vite";
 import react2 from "@vitejs/plugin-react";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, cpSync, rmSync } from "fs";
-import { join as join2, resolve as resolve2 } from "path";
+import { existsSync, mkdirSync as mkdirSync2, cpSync, rmSync } from "fs";
+import { join as join2, resolve } from "path";
 import chalk2 from "chalk";
 import { execSync as execSync2 } from "child_process";
 async function buildApp(schemaPath, options) {
   const cwd = process.cwd();
   const outDir = options.outDir || "dist";
-  const outputPath = resolve2(cwd, outDir);
+  const outputPath = resolve(cwd, outDir);
   console.log(chalk2.blue("\u{1F528} Building application for production..."));
   console.log();
-  const pagesDir = join2(cwd, "pages");
-  const hasPagesDir = existsSync2(pagesDir);
-  let routes = [];
-  let schema = null;
-  let useFileSystemRouting = false;
-  if (hasPagesDir) {
-    console.log(chalk2.blue("\u{1F4C1} Using file-system routing"));
-    routes = scanPagesDirectory(pagesDir);
-    useFileSystemRouting = true;
-    if (routes.length === 0) {
-      throw new Error("No schema files found in pages/ directory");
-    }
-    console.log(chalk2.green(`\u2713 Found ${routes.length} route(s)`));
-  } else {
-    const fullSchemaPath = resolve2(cwd, schemaPath);
-    if (!existsSync2(fullSchemaPath)) {
-      throw new Error(`Schema file not found: ${schemaPath}
-Run 'objectui init' to create a sample schema.`);
-    }
-    console.log(chalk2.blue("\u{1F4CB} Loading schema:"), chalk2.cyan(schemaPath));
-    try {
-      schema = parseSchemaFile(fullSchemaPath);
-    } catch (error) {
-      throw new Error(`Invalid schema file: ${error instanceof Error ? error.message : error}`);
-    }
-  }
+  const source = resolveProjectSource(cwd, schemaPath);
+  reportProjectSource(source, cwd);
   const tmpDir = join2(cwd, ".objectui-tmp");
   mkdirSync2(tmpDir, { recursive: true });
-  if (useFileSystemRouting) {
-    createTempAppWithRouting(tmpDir, routes);
+  if (source.mode === "routes") {
+    createTempAppWithRouting(tmpDir, source.routes, source.appConfig);
   } else {
-    createTempApp(tmpDir, schema);
+    createTempApp(tmpDir, source.schema);
   }
-  console.log(chalk2.blue("\u{1F4E6} Installing dependencies..."));
-  try {
-    execSync2("npm install --silent --prefer-offline", {
-      cwd: tmpDir,
-      stdio: "pipe"
-    });
-    console.log(chalk2.green("\u2713 Dependencies installed"));
-  } catch {
-    throw new Error("Failed to install dependencies. Please check your internet connection and try again.");
+  const isMonorepo = isWorkspaceRoot(cwd);
+  if (isMonorepo) {
+    console.log(chalk2.blue("\u{1F4E6} Detected monorepo - using root node_modules"));
+  } else {
+    console.log(chalk2.blue("\u{1F4E6} Installing dependencies..."));
+    try {
+      execSync2("npm install --silent --prefer-offline", {
+        cwd: tmpDir,
+        stdio: "pipe"
+      });
+      console.log(chalk2.green("\u2713 Dependencies installed"));
+    } catch {
+      throw new Error("Failed to install dependencies. Please check your internet connection and try again.");
+    }
+  }
+  if (isMonorepo) {
+    console.log(chalk2.blue("\u{1F4E6} Detected monorepo - configuring workspace aliases"));
   }
+  const workspaceConfig = isMonorepo ? await prepareWorkspaceTempApp(cwd, tmpDir) : {};
   console.log(chalk2.blue("\u2699\uFE0F  Building with Vite..."));
   console.log();
-  if (options.clean && existsSync2(outputPath)) {
+  if (options.clean && existsSync(outputPath)) {
     console.log(chalk2.dim(`  Cleaning ${outDir}/ directory...`));
     rmSync(outputPath, { recursive: true, force: true });
   }
@@ -254,7 +138,8 @@ Run 'objectui init' to create a sample schema.`);
         reportCompressedSize: true
       },
       plugins: [react2()],
-      logLevel: "info"
+      logLevel: "info",
+      ...workspaceConfig
     });
     mkdirSync2(outputPath, { recursive: true });
     cpSync(join2(tmpDir, "dist"), outputPath, { recursive: true });
@@ -274,21 +159,21 @@ Run 'objectui init' to create a sample schema.`);
 // src/commands/start.ts
 import express from "express";
 import rateLimit from "express-rate-limit";
-import { existsSync as existsSync3 } from "fs";
-import { join as join3, resolve as resolve3 } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { join as join3, resolve as resolve2 } from "path";
 import chalk3 from "chalk";
 async function start(options) {
   const cwd = process.cwd();
   const distDir = options.dir || "dist";
-  const distPath = resolve3(cwd, distDir);
-  if (!existsSync3(distPath)) {
+  const distPath = resolve2(cwd, distDir);
+  if (!existsSync2(distPath)) {
     throw new Error(
       `Build directory not found: ${distDir}
 Run 'objectui build' first to create a production build.`
     );
   }
   const indexPath = join3(distPath, "index.html");
-  if (!existsSync3(indexPath)) {
+  if (!existsSync2(indexPath)) {
     throw new Error(
       `index.html not found in ${distDir}/
 Make sure you have a valid production build.`
@@ -329,14 +214,14 @@ Make sure you have a valid production build.`
 
 // src/commands/lint.ts
 import { execSync as execSync3 } from "child_process";
-import { existsSync as existsSync4 } from "fs";
+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 = existsSync4(tmpDir);
+  const hasTempApp = existsSync3(tmpDir);
   if (!hasTempApp) {
     throw new Error(
       "No Object UI application found. Run 'objectui dev' first to generate the application."
@@ -344,7 +229,7 @@ async function lint(options) {
   }
   const packageJsonPath = join4(tmpDir, "package.json");
   const nodeModulesPath = join4(tmpDir, "node_modules");
-  if (!existsSync4(packageJsonPath) || !existsSync4(nodeModulesPath)) {
+  if (!existsSync3(packageJsonPath) || !existsSync3(nodeModulesPath)) {
     throw new Error(
       "Dependencies not installed. Run 'objectui dev' first to set up the application."
     );
@@ -374,14 +259,14 @@ async function lint(options) {
 
 // src/commands/test.ts
 import { execSync as execSync4 } from "child_process";
-import { existsSync as existsSync5 } from "fs";
+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 = existsSync5(tmpDir);
+  const hasTempApp = existsSync4(tmpDir);
   if (!hasTempApp) {
     throw new Error(
       "No Object UI application found. Run 'objectui dev' first to generate the application."
@@ -389,7 +274,7 @@ async function test(options) {
   }
   const packageJsonPath = join5(tmpDir, "package.json");
   const nodeModulesPath = join5(tmpDir, "node_modules");
-  if (!existsSync5(packageJsonPath) || !existsSync5(nodeModulesPath)) {
+  if (!existsSync4(packageJsonPath) || !existsSync4(nodeModulesPath)) {
     throw new Error(
       "Dependencies not installed. Run 'objectui dev' first to set up the application."
     );
@@ -427,7 +312,7 @@ async function test(options) {
 
 // src/commands/generate.ts
 import chalk6 from "chalk";
-import { existsSync as existsSync6, mkdirSync as mkdirSync3, writeFileSync } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, writeFileSync } from "fs";
 import { join as join6 } from "path";
 async function generate(type, name) {
   const cwd = process.cwd();
@@ -450,10 +335,10 @@ async function generate(type, name) {
 }
 function generateResource(cwd, name) {
   const dir = join6(cwd, "objects");
-  if (!existsSync6(dir)) mkdirSync3(dir, { recursive: true });
+  if (!existsSync5(dir)) mkdirSync3(dir, { recursive: true });
   const fileName = `${name.toLowerCase()}.json`;
   const filePath = join6(dir, fileName);
-  if (existsSync6(filePath)) {
+  if (existsSync5(filePath)) {
     console.log(chalk6.yellow(`Object ${name} already exists at ${filePath}`));
     return;
   }
@@ -468,10 +353,10 @@ function generateResource(cwd, name) {
 }
 function generatePage(cwd, name) {
   const dir = join6(cwd, "pages");
-  if (!existsSync6(dir)) mkdirSync3(dir, { recursive: true });
+  if (!existsSync5(dir)) mkdirSync3(dir, { recursive: true });
   const fileName = `${name.toLowerCase()}.json`;
   const filePath = join6(dir, fileName);
-  if (existsSync6(filePath)) {
+  if (existsSync5(filePath)) {
     console.log(chalk6.yellow(`Page ${name} already exists at ${filePath}`));
     return;
   }
@@ -490,7 +375,7 @@ function generatePage(cwd, name) {
 }
 function generatePlugin(cwd, name) {
   const dir = join6(cwd, "plugins", name);
-  if (existsSync6(dir)) {
+  if (existsSync5(dir)) {
     console.log(chalk6.yellow(`Plugin ${name} already exists`));
     return;
   }
@@ -509,95 +394,223 @@ export const ${name}Plugin = {
 
 // src/commands/doctor.ts
 import chalk7 from "chalk";
-import { existsSync as existsSync7, readFileSync } from "fs";
-import { join as join7 } from "path";
-async function doctor() {
-  console.log(chalk7.bold("Object UI Doctor"));
-  console.log("Diagnosis in progress...\n");
-  const cwd = process.cwd();
-  let issues = 0;
+import { existsSync as existsSync6, readFileSync } from "fs";
+import { dirname, join as join7, resolve as resolvePath } from "path";
+var CSS_ENTRY_CANDIDATES = [
+  "src/index.css",
+  "src/main.css",
+  "src/styles.css",
+  "src/style.css",
+  "src/app.css",
+  "src/global.css",
+  "src/globals.css",
+  "app/globals.css",
+  "app/global.css",
+  "styles/globals.css",
+  "index.css",
+  "styles.css"
+];
+var TAILWIND_CONFIG_CANDIDATES = [
+  "tailwind.config.js",
+  "tailwind.config.cjs",
+  "tailwind.config.mjs",
+  "tailwind.config.ts"
+];
+var POSTCSS_CONFIG_CANDIDATES = [
+  "postcss.config.js",
+  "postcss.config.cjs",
+  "postcss.config.mjs",
+  "postcss.config.ts"
+];
+var V4_CSS_IMPORT = /@import\s+["']tailwindcss["']/;
+var V3_CSS_DIRECTIVE = /@tailwind\s+(?:base|components|utilities|screens|variants)\b/;
+var CSS_SOURCE_DIRECTIVE = /@source\s+["']/;
+var CSS_CONFIG_DIRECTIVE = /@config\s+["']/;
+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;
+  } catch {
+    return null;
+  }
+}
+function findFile(cwd, candidates) {
+  for (const rel of candidates) {
+    const abs = join7(cwd, rel);
+    if (existsSync6(abs)) return abs;
+  }
+  return null;
+}
+function majorOf(range) {
+  const match = /(\d+)/.exec(range);
+  if (!match) return null;
+  const major = Number.parseInt(match[1], 10);
+  return Number.isNaN(major) ? null : major;
+}
+function isInstalledFrom(cwd, specifier) {
+  let dir = resolvePath(cwd);
+  for (; ; ) {
+    if (existsSync6(join7(dir, "node_modules", ...specifier.split("/")))) return true;
+    const parent = dirname(dir);
+    if (parent === dir) return false;
+    dir = parent;
+  }
+}
+function runDiagnostics(cwd) {
+  const results = [];
+  const ok = (id, message) => {
+    results.push({ id, level: "ok", message });
+  };
+  const warn = (id, message) => {
+    results.push({ id, level: "warn", message });
+  };
+  const error = (id, message) => {
+    results.push({ id, level: "error", message });
+  };
   const pkgPath = join7(cwd, "package.json");
-  if (existsSync7(pkgPath)) {
+  const pkgRaw = readIfExists(pkgPath);
+  let pkg = null;
+  if (pkgRaw === null) {
+    error("package-json-missing", "package.json not found");
+  } else {
     try {
-      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-      const reactVer = pkg.dependencies?.react || pkg.devDependencies?.react;
-      if (reactVer) {
-        console.log(chalk7.green("\u2713 React installed"));
+      pkg = JSON.parse(pkgRaw);
+    } catch {
+      error("package-json-unreadable", "Failed to parse package.json");
+    }
+  }
+  const deps = pkg ? { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} } : {};
+  if (pkg) {
+    if (deps.react) {
+      ok("react-installed", "React installed");
+    } else {
+      warn("react-missing", "React not found in dependencies");
+    }
+  }
+  const tailwindRange = pkg ? deps.tailwindcss : void 0;
+  if (pkg && !tailwindRange) {
+    warn("tailwind-missing", "Tailwind CSS not found in dependencies");
+  }
+  if (tailwindRange) {
+    const major = majorOf(tailwindRange);
+    if (major !== null && major < 4) {
+      warn(
+        "tailwind-major-legacy",
+        `Tailwind CSS ${tailwindRange} detected \u2014 ObjectUI targets Tailwind 4. Upgrade with \`npx @tailwindcss/upgrade\`, then move configuration into your CSS entry (\`@import 'tailwindcss'\`, \`@theme\`, \`@source\`).`
+      );
+    } else {
+      ok("tailwind-installed", `Tailwind CSS ${tailwindRange} installed`);
+    }
+    if (deps["@tailwindcss/postcss"]) {
+      ok("tailwind-postcss-declared", "@tailwindcss/postcss declared");
+    } else if (isInstalledFrom(cwd, "@tailwindcss/postcss")) {
+      ok(
+        "tailwind-postcss-installed",
+        "@tailwindcss/postcss installed (provided by the workspace)"
+      );
+    } else {
+      error(
+        "tailwind-postcss-missing",
+        "Tailwind CSS 4 needs @tailwindcss/postcss, which is neither declared nor installed here. v4 moved the PostCSS plugin out of `tailwindcss` into its own package; without it PostCSS fails to load and no styles are emitted. Install it: `npm i -D @tailwindcss/postcss`."
+      );
+    }
+    const postcssConfigPath = findFile(cwd, POSTCSS_CONFIG_CANDIDATES);
+    if (postcssConfigPath) {
+      const postcssConfig = readIfExists(postcssConfigPath) ?? "";
+      const hasV4Plugin = V4_POSTCSS_PLUGIN.test(postcssConfig);
+      const hasV3Plugin = V3_POSTCSS_PLUGIN.test(postcssConfig);
+      if (hasV3Plugin) {
+        error(
+          "postcss-plugin-v3",
+          "PostCSS config names `tailwindcss` as a plugin \u2014 the Tailwind 3 spelling. In v4 that entry resolves to a shim whose only job is to throw. Replace it with `'@tailwindcss/postcss': {}`."
+        );
+      } else if (hasV4Plugin) {
+        ok("postcss-plugin-v4", "PostCSS config uses @tailwindcss/postcss");
       } else {
-        console.log(chalk7.yellow("\u26A0\uFE0F React not found in dependencies"));
-        issues++;
+        warn(
+          "postcss-plugin-absent",
+          "PostCSS config does not register a Tailwind plugin. Add `'@tailwindcss/postcss': {}` so Tailwind runs during the build."
+        );
       }
-      const tailwindVer = pkg.dependencies?.tailwindcss || pkg.devDependencies?.tailwindcss;
-      if (tailwindVer) {
-        console.log(chalk7.green("\u2713 Tailwind CSS installed"));
-      } else {
-        console.log(chalk7.yellow("\u26A0\uFE0F Tailwind CSS not found"));
-        issues++;
+    }
+    const cssEntries = CSS_ENTRY_CANDIDATES.map((rel) => ({
+      rel,
+      content: readIfExists(join7(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));
+    const declaresSource = cssEntries.some((entry) => CSS_SOURCE_DIRECTIVE.test(entry.content));
+    const optsIntoJsConfig = cssEntries.some((entry) => CSS_CONFIG_DIRECTIVE.test(entry.content));
+    if (cssEntries.length === 0) {
+    } else if (importsTailwind) {
+      ok("css-entry-v4-import", "CSS entry runs `@import 'tailwindcss'`");
+      if (declaresSource) {
+        ok("css-entry-source", "CSS entry declares `@source` scanning paths");
       }
-    } catch (e) {
-      console.log(chalk7.red("x Failed to read package.json"));
-      issues++;
+    } else if (usesV3Directives) {
+      error(
+        "css-entry-v3-directives",
+        "CSS entry still uses the Tailwind 3 `@tailwind base/components/utilities` directives. Tailwind 4 replaces all three with a single `@import 'tailwindcss';`."
+      );
+    } else {
+      warn(
+        "css-entry-no-tailwind",
+        `No CSS entry runs \`@import 'tailwindcss'\`, so Tailwind never starts. Checked: ${cssEntries.map((entry) => entry.rel).join(", ")}.`
+      );
     }
-  } else {
-    console.log(chalk7.red("x package.json not found"));
-    issues++;
-  }
-  const tailwindConfigPath = join7(cwd, "tailwind.config.js");
-  const tailwindTsPath = join7(cwd, "tailwind.config.ts");
-  if (existsSync7(tailwindConfigPath) || existsSync7(tailwindTsPath)) {
-    const configFile = existsSync7(tailwindConfigPath) ? "tailwind.config.js" : "tailwind.config.ts";
-    const configPath = existsSync7(tailwindConfigPath) ? tailwindConfigPath : tailwindTsPath;
-    console.log(chalk7.green(`\u2713 ${configFile} found`));
-    try {
-      const configContent = readFileSync(configPath, "utf-8");
-      if (configContent.includes("content") && (configContent.includes("./src") || configContent.includes("./app") || configContent.includes("./pages"))) {
-        console.log(chalk7.green("\u2713 Tailwind content paths configured"));
+    const tailwindConfigPath = findFile(cwd, TAILWIND_CONFIG_CANDIDATES);
+    if (tailwindConfigPath && !optsIntoJsConfig) {
+      const rel = tailwindConfigPath.slice(cwd.length + 1);
+      warn(
+        "tailwind-config-inert",
+        `${rel} exists but nothing opts into it \u2014 Tailwind 4 ignores a JS config unless a stylesheet declares \`@config\`. Anything it sets (theme, content/@source paths, plugins) has no effect today. Either delete it and move the settings into your CSS entry, or add \`@config '${rel}';\` there.`
+      );
+    } else if (tailwindConfigPath) {
+      ok("tailwind-config-active", "JS Tailwind config is loaded via `@config`");
+    }
+  }
+  if (existsSync6(join7(cwd, "tsconfig.json"))) {
+    ok("tsconfig-found", "tsconfig.json found");
+    const tsRange = deps.typescript;
+    if (tsRange) {
+      const major = majorOf(tsRange);
+      if (major !== null && major < 5) {
+        warn("typescript-legacy", `TypeScript ${tsRange} detected \u2014 version 5.0+ recommended`);
       } else {
-        console.log(chalk7.yellow("\u26A0\uFE0F Tailwind content paths may not be configured. Ensure your content array includes source directories."));
-        issues++;
+        ok("typescript-version", `TypeScript ${tsRange} (5.0+ required)`);
       }
-    } catch (_e) {
     }
   } else {
-    console.log(chalk7.yellow("\u26A0\uFE0F tailwind.config.js not found"));
-    issues++;
+    warn("tsconfig-missing", "tsconfig.json not found");
   }
-  const tsConfigPath = join7(cwd, "tsconfig.json");
-  if (existsSync7(tsConfigPath)) {
-    console.log(chalk7.green("\u2713 tsconfig.json found"));
-    try {
-      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-      const tsVer = pkg.devDependencies?.typescript || pkg.dependencies?.typescript;
-      if (tsVer) {
-        const majorVer = parseInt(tsVer.replace(/[^0-9.]/g, "").split(".")[0], 10);
-        if (majorVer >= 5) {
-          console.log(chalk7.green(`\u2713 TypeScript ${tsVer} (5.0+ required)`));
-        } else {
-          console.log(chalk7.yellow(`\u26A0\uFE0F TypeScript ${tsVer} detected \u2014 version 5.0+ recommended`));
-          issues++;
-        }
-      }
-    } catch (_e) {
+  if (pkg) {
+    if (deps["@object-ui/react"] && !deps.react) {
+      warn("peer-react", "@object-ui/react requires react as a peer dependency");
+    }
+    if (deps["@object-ui/components"] && !deps.tailwindcss) {
+      warn("peer-tailwind", "@object-ui/components requires tailwindcss as a peer dependency");
     }
-  } else {
-    console.log(chalk7.yellow("\u26A0\uFE0F tsconfig.json not found"));
-    issues++;
   }
-  if (existsSync7(pkgPath)) {
-    try {
-      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-      const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-      if (allDeps["@object-ui/react"] && !allDeps["react"]) {
-        console.log(chalk7.yellow("\u26A0\uFE0F @object-ui/react requires react as a peer dependency"));
-        issues++;
-      }
-      if (allDeps["@object-ui/components"] && !allDeps["tailwindcss"]) {
-        console.log(chalk7.yellow("\u26A0\uFE0F @object-ui/components requires tailwindcss as a peer dependency"));
-        issues++;
-      }
-    } catch (_e) {
+  return results;
+}
+function countIssues(results) {
+  return results.filter((result) => result.level !== "ok").length;
+}
+async function doctor() {
+  console.log(chalk7.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}`));
+    } else if (result.level === "warn") {
+      console.log(chalk7.yellow(`\u26A0\uFE0F ${result.message}`));
+    } else {
+      console.log(chalk7.red(`x ${result.message}`));
     }
   }
+  const issues = countIssues(results);
   console.log("\nResult:");
   if (issues === 0) {
     console.log(chalk7.green("Everything looks good! \u2728"));
@@ -617,8 +630,8 @@ async function add(component) {
 // src/commands/studio.ts
 import chalk9 from "chalk";
 import { spawn } from "child_process";
-import { existsSync as existsSync8 } from "fs";
-import { join as join8, resolve as resolve4, dirname as dirname2 } from "path";
+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"));
@@ -627,12 +640,12 @@ async function studio() {
   const __dirname3 = dirname2(__filename3);
   const candidates = [
     join8(cwd, "apps/console"),
-    resolve4(__dirname3, "../../apps/console"),
-    resolve4(__dirname3, "../../../apps/console")
+    resolve3(__dirname3, "../../apps/console"),
+    resolve3(__dirname3, "../../../apps/console")
   ];
   let consolePath = null;
   for (const candidate of candidates) {
-    if (existsSync8(join8(candidate, "package.json"))) {
+    if (existsSync7(join8(candidate, "package.json"))) {
       consolePath = candidate;
       break;
     }
@@ -664,41 +677,735 @@ import chalk10 from "chalk";
 import { globSync } from "glob";
 import { readFileSync as readFileSync2 } from "fs";
 import { join as join9 } from "path";
-async function check() {
+import { parse as parseJsonc, printParseErrorCode } from "jsonc-parser";
+
+// src/utils/known-schema-types.ts
+var KNOWN_SCHEMA_TYPES = [
+  "a",
+  "abbr",
+  "accordion",
+  "action:bar",
+  "action:button",
+  "action:group",
+  "action:icon",
+  "action:menu",
+  "address",
+  "advanced-chart",
+  "ai-form-assist",
+  "ai-recommendations",
+  "ai:feedback",
+  "ai:input",
+  "ai:suggestion",
+  "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",
+  "br",
+  "branding-editor",
+  "breadcrumb",
+  "button",
+  "button-group",
+  "calendar",
+  "calendar-view",
+  "card",
+  "carousel",
+  "chart",
+  "chart:bar",
+  "chatbot",
+  "chatbot-enhanced",
+  "chatbot-floating",
+  "checkbox",
+  "checkboxes",
+  "cite",
+  "cloud-connection:panel",
+  "cloud:ai-model-status",
+  "cloud:onboarding-next",
+  "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",
+  "detail-section",
+  "detail-view",
+  "dialog",
+  "div",
+  "dl",
+  "donut-chart",
+  "drawer",
+  "dropdown-menu",
+  "dt",
+  "element:button",
+  "element:definition-list",
+  "element:divider",
+  "element:image",
+  "element:metadata_viewer",
+  "element:number",
+  "element:record_picker",
+  "element:repeater",
+  "element:text",
+  "element:text_input",
+  "em",
+  "email",
+  "embeddable-form",
+  "empty",
+  "field-designer",
+  "field:address",
+  "field:audio",
+  "field:auto_number",
+  "field:avatar",
+  "field:boolean",
+  "field:checkboxes",
+  "field:code",
+  "field:color",
+  "field:currency",
+  "field:date",
+  "field:datetime",
+  "field:duration",
+  "field:email",
+  "field:file",
+  "field:filter-condition",
+  "field:formula",
+  "field:geolocation",
+  "field:grid",
+  "field:html",
+  "field:image",
+  "field:json",
+  "field:location",
+  "field:lookup",
+  "field:markdown",
+  "field:master_detail",
+  "field:multiselect",
+  "field:number",
+  "field:object",
+  "field:object-ref",
+  "field:password",
+  "field:percent",
+  "field:permission-facet-link",
+  "field:phone",
+  "field:progress",
+  "field:qrcode",
+  "field:radio",
+  "field:rating",
+  "field:recipient-picker",
+  "field:richtext",
+  "field:select",
+  "field:signature",
+  "field:slider",
+  "field:summary",
+  "field:tags",
+  "field:text",
+  "field:textarea",
+  "field:time",
+  "field:tree",
+  "field:url",
+  "field:user",
+  "field:vector",
+  "field:video",
+  "figcaption",
+  "figure",
+  "file",
+  "file-upload",
+  "filter-builder",
+  "filter-ui",
+  "flex",
+  "footer",
+  "form",
+  "form-analytics",
+  "formula",
+  "gantt",
+  "geolocation",
+  "global:notifications",
+  "global:search",
+  "grid",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "header",
+  "header-bar",
+  "home",
+  "hover-card",
+  "hr",
+  "html",
+  "i",
+  "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",
+  "object-form",
+  "object-gallery",
+  "object-gantt",
+  "object-grid",
+  "object-kanban",
+  "object-manager",
+  "object-map",
+  "object-master-detail-form",
+  "object-metric",
+  "object-pivot",
+  "object-timeline",
+  "object-tree",
+  "object-view",
+  "ol",
+  "p",
+  "page",
+  "page-designer",
+  "page-header",
+  "page:accordion",
+  "page:card",
+  "page:footer",
+  "page:header",
+  "page:section",
+  "page:sidebar",
+  "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",
+  "plugin-map:object-map",
+  "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",
+  "process-designer",
+  "progress",
+  "protocol-placeholder:ai:feedback",
+  "protocol-placeholder:ai:input",
+  "protocol-placeholder:ai:suggestion",
+  "protocol-placeholder:app:launcher",
+  "protocol-placeholder:field:address",
+  "protocol-placeholder:field:audio",
+  "protocol-placeholder:field:avatar",
+  "protocol-placeholder:field:boolean",
+  "protocol-placeholder:field:checkboxes",
+  "protocol-placeholder:field:code",
+  "protocol-placeholder:field:color",
+  "protocol-placeholder:field:currency",
+  "protocol-placeholder:field:date",
+  "protocol-placeholder:field:datetime",
+  "protocol-placeholder:field:duration",
+  "protocol-placeholder:field:email",
+  "protocol-placeholder:field:file",
+  "protocol-placeholder:field:html",
+  "protocol-placeholder:field:image",
+  "protocol-placeholder:field:json",
+  "protocol-placeholder:field:location",
+  "protocol-placeholder:field:lookup",
+  "protocol-placeholder:field:markdown",
+  "protocol-placeholder:field:master_detail",
+  "protocol-placeholder:field:multiselect",
+  "protocol-placeholder:field:number",
+  "protocol-placeholder:field:password",
+  "protocol-placeholder:field:percent",
+  "protocol-placeholder:field:phone",
+  "protocol-placeholder:field:progress",
+  "protocol-placeholder:field:qrcode",
+  "protocol-placeholder:field:radio",
+  "protocol-placeholder:field:rating",
+  "protocol-placeholder:field:select",
+  "protocol-placeholder:field:signature",
+  "protocol-placeholder:field:slider",
+  "protocol-placeholder:field:text",
+  "protocol-placeholder:field:textarea",
+  "protocol-placeholder:field:time",
+  "protocol-placeholder:field:tree",
+  "protocol-placeholder:field:url",
+  "protocol-placeholder:field:video",
+  "protocol-placeholder:global:notifications",
+  "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",
+  "protocol-placeholder:page:header",
+  "protocol-placeholder:page:sidebar",
+  "protocol-placeholder:page:tabs",
+  "protocol-placeholder:record:activity",
+  "protocol-placeholder:record:chatter",
+  "protocol-placeholder:record:details",
+  "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",
+  "protocol-placeholder:view:gantt",
+  "protocol-placeholder:view:grid",
+  "protocol-placeholder:view:kanban",
+  "protocol-placeholder:view:map",
+  "protocol-placeholder:view:modal",
+  "protocol-placeholder:view:simple",
+  "protocol-placeholder:view:split",
+  "protocol-placeholder:view:tabbed",
+  "protocol-placeholder:view:timeline",
+  "protocol-placeholder:view:wizard",
+  "protocol-placeholder:widget:bar",
+  "protocol-placeholder:widget:funnel",
+  "protocol-placeholder:widget:heatmap",
+  "protocol-placeholder:widget:image",
+  "protocol-placeholder:widget:line",
+  "protocol-placeholder:widget:metric",
+  "protocol-placeholder:widget:pie",
+  "protocol-placeholder:widget:pivot",
+  "protocol-placeholder:widget:radar",
+  "protocol-placeholder:widget:scatter",
+  "protocol-placeholder:widget:table",
+  "protocol-placeholder:widget:text",
+  "q",
+  "qrcode",
+  "radar-chart",
+  "radio",
+  "radio-group",
+  "rating",
+  "record",
+  "record:activity",
+  "record:alert",
+  "record:approvals",
+  "record:attachments",
+  "record:chatter",
+  "record:details",
+  "record:discussion",
+  "record:highlights",
+  "record:history",
+  "record:line_items",
+  "record:path",
+  "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",
+  "statistic",
+  "strong",
+  "sub",
+  "summary",
+  "sup",
+  "switch",
+  "table",
+  "tabs",
+  "tags",
+  "text",
+  "textarea",
+  "time",
+  "timeline",
+  "toast",
+  "toaster",
+  "toggle",
+  "toggle-group",
+  "tooltip",
+  "tree",
+  "tree-view",
+  "u",
+  "ui:a",
+  "ui:abbr",
+  "ui:accordion",
+  "ui:address",
+  "ui:alert",
+  "ui:alert-dialog",
+  "ui:article",
+  "ui:aside",
+  "ui:aspect-ratio",
+  "ui:avatar",
+  "ui:b",
+  "ui:badge",
+  "ui:blockquote",
+  "ui:br",
+  "ui:breadcrumb",
+  "ui:button",
+  "ui:button-group",
+  "ui:calendar",
+  "ui:card",
+  "ui:carousel",
+  "ui:checkbox",
+  "ui:cite",
+  "ui:collapsible",
+  "ui:combobox",
+  "ui:command",
+  "ui:container",
+  "ui:context-menu",
+  "ui:data-table",
+  "ui:date-picker",
+  "ui:dd",
+  "ui:del",
+  "ui:dialog",
+  "ui:div",
+  "ui:dl",
+  "ui:drawer",
+  "ui:dropdown-menu",
+  "ui:dt",
+  "ui:em",
+  "ui:email",
+  "ui:empty",
+  "ui:figcaption",
+  "ui:figure",
+  "ui:file-upload",
+  "ui:filter-builder",
+  "ui:flex",
+  "ui:footer",
+  "ui:grid",
+  "ui:h1",
+  "ui:h2",
+  "ui:h3",
+  "ui:h4",
+  "ui:h5",
+  "ui:h6",
+  "ui:header",
+  "ui:header-bar",
+  "ui:hover-card",
+  "ui:hr",
+  "ui:html",
+  "ui:i",
+  "ui:icon",
+  "ui:image",
+  "ui:img",
+  "ui:input",
+  "ui:input-otp",
+  "ui:ins",
+  "ui:kbd",
+  "ui:label",
+  "ui:li",
+  "ui:list",
+  "ui:loading",
+  "ui:main",
+  "ui:mark",
+  "ui:menubar",
+  "ui:nav",
+  "ui:navigation-menu",
+  "ui:ol",
+  "ui:p",
+  "ui:pagination",
+  "ui:password",
+  "ui:popover",
+  "ui:pre",
+  "ui:progress",
+  "ui:q",
+  "ui:radio-group",
+  "ui:resizable",
+  "ui:scroll-area",
+  "ui:section",
+  "ui:select",
+  "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",
+  "ui:sonner",
+  "ui:span",
+  "ui:spinner",
+  "ui:stack",
+  "ui:statistic",
+  "ui:strong",
+  "ui:sub",
+  "ui:sup",
+  "ui:switch",
+  "ui:table",
+  "ui:tabs",
+  "ui:text",
+  "ui:textarea",
+  "ui:time",
+  "ui:toast",
+  "ui:toaster",
+  "ui:toggle",
+  "ui:toggle-group",
+  "ui:tooltip",
+  "ui:tree-view",
+  "ui:u",
+  "ui:ul",
+  "ul",
+  "url",
+  "user",
+  "user:profile",
+  "utility",
+  "vector",
+  "view",
+  "view-switcher",
+  "view:calendar",
+  "view:chart",
+  "view:dashboard",
+  "view:detail",
+  "view:drawer",
+  "view:filter-ui",
+  "view:form",
+  "view:gallery",
+  "view:gantt",
+  "view:grid",
+  "view:kanban",
+  "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",
+  "widget:funnel",
+  "widget:heatmap",
+  "widget:image",
+  "widget:line",
+  "widget:metric",
+  "widget:pie",
+  "widget:pivot",
+  "widget:radar",
+  "widget:scatter",
+  "widget:table",
+  "widget:text"
+];
+var KNOWN_SCHEMA_TYPE_SET = new Set(KNOWN_SCHEMA_TYPES);
+function isKnownSchemaType(type) {
+  return KNOWN_SCHEMA_TYPE_SET.has(type);
+}
+
+// src/commands/check.ts
+var OBJECTUI_STRUCTURAL_KEYS = [
+  // Composition — the `children`/`body`-class keys the ruling names.
+  "body",
+  "children",
+  // Presentation.
+  "className",
+  "style",
+  "placeholder",
+  // Conditional rendering and interaction state.
+  "visible",
+  "visibleWhen",
+  "visibleOn",
+  "hidden",
+  "hiddenOn",
+  "disabled",
+  "disabledOn",
+  // Test and accessibility handles.
+  "testId",
+  "ariaLabel"
+];
+function isObjectUiSchemaFile(content) {
+  return OBJECTUI_STRUCTURAL_KEYS.some((key) => key in content);
+}
+function describeParseError(text, error) {
+  const upTo = text.slice(0, error.offset);
+  const line = upTo.split("\n").length;
+  const column = error.offset - (upTo.lastIndexOf("\n") + 1) + 1;
+  return `${printParseErrorCode(error.error)} at line ${line} column ${column}`;
+}
+async function check(cwd = process.cwd()) {
   console.log(chalk10.bold("Object UI Schema Check"));
-  const cwd = process.cwd();
   const files = globSync("**/*.{json,yaml,yml}", {
     cwd,
     ignore: ["node_modules/**", "dist/**", ".git/**"]
   });
   console.log(`Analyzing ${files.length} files...`);
   let errors = 0;
+  let skipped = 0;
   for (const file of files) {
     try {
       if (file.endsWith(".json")) {
-        const content = JSON.parse(readFileSync2(join9(cwd, file), "utf-8"));
+        const text = readFileSync2(join9(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)}`)
+          );
+          errors++;
+          continue;
+        }
         if (content && typeof content === "object" && content.type) {
-          const knownTypes = [
-            "page",
-            "form",
-            "grid",
-            "crud",
-            "kanban",
-            "calendar",
-            "dashboard",
-            "chart",
-            "detail",
-            "list",
-            "timeline",
-            "gantt",
-            "map",
-            "gallery",
-            "object-view",
-            "detail-view",
-            "object-chart"
-          ];
-          if (typeof content.type === "string" && !knownTypes.includes(content.type)) {
-            console.log(chalk10.yellow(`\u26A0\uFE0F Unknown schema type "${content.type}" in ${file}`));
+          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}`));
+            }
           }
         }
       }
@@ -707,6 +1414,18 @@ async function check() {
       errors++;
     }
   }
+  if (skipped > 0) {
+    console.log(
+      chalk10.dim(
+        `Skipped ${skipped} file${skipped === 1 ? "" : "s"} with a root "type" and no ObjectUI schema marker.`
+      )
+    );
+    console.log(
+      chalk10.dim(
+        `  A file is checked when its root carries an ObjectUI structural key: ${OBJECTUI_STRUCTURAL_KEYS.join(", ")}.`
+      )
+    );
+  }
   if (errors === 0) {
     console.log(chalk10.green("\u2713 All checks passed"));
   } else {
@@ -717,8 +1436,8 @@ async function check() {
 
 // src/commands/validate.ts
 import chalk11 from "chalk";
-import { readFileSync as readFileSync3, existsSync as existsSync9 } from "fs";
-import { resolve as resolve5 } from "path";
+import { readFileSync as readFileSync3, existsSync as existsSync8 } from "fs";
+import { resolve as resolve4 } from "path";
 import { load as loadYaml } from "js-yaml";
 import { safeValidateSchema } from "@object-ui/types/zod";
 
@@ -754,8 +1473,8 @@ function findSpecVocabularyFormFields(node, path = "") {
 // src/commands/validate.ts
 async function validate(schemaPath) {
   console.log(chalk11.blue("\u{1F50D} ObjectUI Schema Validator\n"));
-  const resolvedPath = resolve5(process.cwd(), schemaPath);
-  if (!existsSync9(resolvedPath)) {
+  const resolvedPath = resolve4(process.cwd(), schemaPath);
+  if (!existsSync8(resolvedPath)) {
     console.error(chalk11.red(`\u2717 Error: Schema file not found: ${schemaPath}`));
     process.exit(1);
   }
@@ -846,17 +1565,17 @@ ${index + 1}. ${issue.message}`));
 // src/commands/create-plugin.ts
 import chalk12 from "chalk";
 import { spawn as spawn2 } from "child_process";
-import { resolve as resolve6, dirname as dirname3 } from "path";
+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 = resolve6(
+  const createPluginScript = resolve5(
     __dirname,
     "../../../create-plugin/dist/index.js"
   );
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve7, reject) => {
     const child = spawn2("node", [createPluginScript, pluginName], {
       stdio: "inherit",
       shell: true
@@ -867,7 +1586,7 @@ async function createPlugin(pluginName) {
     });
     child.on("exit", (code) => {
       if (code === 0) {
-        resolve8();
+        resolve7();
       } else {
         reject(new Error(`create-plugin exited with code ${code}`));
       }
@@ -877,12 +1596,12 @@ async function createPlugin(pluginName) {
 
 // src/commands/analyze.ts
 import chalk13 from "chalk";
-import { existsSync as existsSync10, statSync as statSync2, readdirSync } from "fs";
-import { resolve as resolve7, join as join10, extname } from "path";
+import { existsSync as existsSync9, statSync, readdirSync } from "fs";
+import { resolve as resolve6, join as join10, extname } from "path";
 async function analyzeBundleSize() {
   console.log(chalk13.bold("\n\u{1F4E6} Bundle Size Analysis\n"));
-  const distDir = resolve7(process.cwd(), "dist");
-  if (!existsSync10(distDir)) {
+  const distDir = resolve6(process.cwd(), "dist");
+  if (!existsSync9(distDir)) {
     console.log(chalk13.yellow("\u26A0 No dist directory found. Run build first."));
     return;
   }
@@ -891,7 +1610,7 @@ async function analyzeBundleSize() {
     const items = readdirSync(dir);
     for (const item of items) {
       const fullPath = join10(dir, item);
-      const stat = statSync2(fullPath);
+      const stat = statSync(fullPath);
       if (stat.isDirectory()) {
         scanDirectory(fullPath);
       } else {
@@ -981,7 +1700,7 @@ var packageJson = JSON.parse(
 );
 var program = new Command();
 program.name("objectui").description("CLI tool for Object UI - Build applications from JSON schemas").version(packageJson.version);
-program.command("serve").description("Start a development server with your JSON/YAML schema").argument("[schema]", "Path to JSON/YAML schema file", "app.json").option("-p, --port <port>", "Port to run the server on", "3000").option("-h, --host <host>", "Host to bind the server to", "localhost").action(async (schema, options) => {
+program.command("serve").description("Start a development server with your JSON/YAML schema").argument("[schema]", "Path to JSON/YAML schema file, or a project / pages directory", "app.json").option("-p, --port <port>", "Port to run the server on", "3000").option("-h, --host <host>", "Host to bind the server to", "localhost").option("--no-open", "Do not open browser automatically").action(async (schema, options) => {
   try {
     await serve(schema, options);
   } catch (error) {
@@ -989,7 +1708,7 @@ program.command("serve").description("Start a development server with your JSON/
     process.exit(1);
   }
 });
-program.command("dev").description("Start development server (alias for serve)").argument("[schema]", "Path to JSON/YAML schema file", "app.json").option("-p, --port <port>", "Port to run the server on", "3000").option("-h, --host <host>", "Host to bind the server to", "localhost").option("--no-open", "Do not open browser automatically").action(async (schema, options) => {
+program.command("dev").description("Start development server (alias for serve)").argument("[schema]", "Path to JSON/YAML schema file, or a project / pages directory", "app.json").option("-p, --port <port>", "Port to run the server on", "3000").option("-h, --host <host>", "Host to bind the server to", "localhost").option("--no-open", "Do not open browser automatically").action(async (schema, options) => {
   try {
     await dev(schema, options);
   } catch (error) {
@@ -997,7 +1716,7 @@ program.command("dev").description("Start development server (alias for serve)")
     process.exit(1);
   }
 });
-program.command("build").description("Build application for production").argument("[schema]", "Path to JSON/YAML schema file", "app.json").option("-o, --out-dir <dir>", "Output directory", "dist").option("--clean", "Clean output directory before build", false).action(async (schema, options) => {
+program.command("build").description("Build application for production").argument("[schema]", "Path to JSON/YAML schema file, or a project / pages directory", "app.json").option("-o, --out-dir <dir>", "Output directory", "dist").option("--clean", "Clean output directory before build", false).action(async (schema, options) => {
   try {
     await buildApp(schema, options);
   } catch (error) {