@object-ui/cli 17.5.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-2MZA766D.js";
+} from "./chunk-AP2INOE7.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -15,103 +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 loadTempAppPostcssPlugins() {
-  try {
-    const [tailwindPostcss, autoprefixer] = await Promise.all([
-      import("@tailwindcss/postcss"),
-      import("autoprefixer")
-    ]);
-    return [tailwindPostcss.default(), autoprefixer.default()];
-  } catch (error) {
-    throw new Error(
-      `Failed to load the Tailwind CSS PostCSS pipeline: ${error instanceof Error ? error.message : error}
-  Both '@tailwindcss/postcss' and 'autoprefixer' are dependencies of @object-ui/cli \u2014 a
-  broken install of the CLI is the likeliest cause; reinstall it and try again.
-  (Refusing to start unstyled: that failure is silent in the browser.)`
-    );
-  }
-}
 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 {
@@ -129,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: {
@@ -140,38 +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);
-    }
-    viteConfig.css = { postcss: { plugins: await loadTempAppPostcssPlugins() } };
-  }
   const server = await createServer(viteConfig);
   await server.listen();
   const { port, host } = server.config.server;
@@ -189,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 });
   }
@@ -257,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 });
@@ -277,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.`
@@ -332,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."
@@ -347,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."
     );
@@ -377,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."
@@ -392,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."
     );
@@ -430,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();
@@ -453,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;
   }
@@ -471,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;
   }
@@ -493,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;
   }
@@ -512,8 +394,8 @@ export const ${name}Plugin = {
 
 // src/commands/doctor.ts
 import chalk7 from "chalk";
-import { existsSync as existsSync7, readFileSync } from "fs";
-import { dirname as dirname2, join as join7, resolve as resolvePath } from "path";
+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",
@@ -548,7 +430,7 @@ var V4_POSTCSS_PLUGIN = /@tailwindcss\/postcss/;
 var V3_POSTCSS_PLUGIN = /["']tailwindcss["']|(?:^|[{,\s])tailwindcss\s*:/m;
 function readIfExists(path) {
   try {
-    return existsSync7(path) ? readFileSync(path, "utf-8") : null;
+    return existsSync6(path) ? readFileSync(path, "utf-8") : null;
   } catch {
     return null;
   }
@@ -556,7 +438,7 @@ function readIfExists(path) {
 function findFile(cwd, candidates) {
   for (const rel of candidates) {
     const abs = join7(cwd, rel);
-    if (existsSync7(abs)) return abs;
+    if (existsSync6(abs)) return abs;
   }
   return null;
 }
@@ -569,8 +451,8 @@ function majorOf(range) {
 function isInstalledFrom(cwd, specifier) {
   let dir = resolvePath(cwd);
   for (; ; ) {
-    if (existsSync7(join7(dir, "node_modules", ...specifier.split("/")))) return true;
-    const parent = dirname2(dir);
+    if (existsSync6(join7(dir, "node_modules", ...specifier.split("/")))) return true;
+    const parent = dirname(dir);
     if (parent === dir) return false;
     dir = parent;
   }
@@ -688,7 +570,7 @@ function runDiagnostics(cwd) {
       ok("tailwind-config-active", "JS Tailwind config is loaded via `@config`");
     }
   }
-  if (existsSync7(join7(cwd, "tsconfig.json"))) {
+  if (existsSync6(join7(cwd, "tsconfig.json"))) {
     ok("tsconfig-found", "tsconfig.json found");
     const tsRange = deps.typescript;
     if (tsRange) {
@@ -748,22 +630,22 @@ 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 dirname3 } 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"));
   const cwd = process.cwd();
   const __filename3 = fileURLToPath(import.meta.url);
-  const __dirname3 = dirname3(__filename3);
+  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;
     }
@@ -795,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}`));
+            }
           }
         }
       }
@@ -838,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 {
@@ -848,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";
 
@@ -885,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);
   }
@@ -977,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 dirname4 } 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 = dirname4(__filename);
+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
@@ -998,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}`));
       }
@@ -1008,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;
   }
@@ -1022,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 {
@@ -1104,15 +1692,15 @@ async function analyze(options = {}) {
 // src/cli.ts
 import { readFileSync as readFileSync4 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import { dirname as dirname5, join as join11 } from "path";
+import { dirname as dirname4, join as join11 } from "path";
 var __filename2 = fileURLToPath3(import.meta.url);
-var __dirname2 = dirname5(__filename2);
+var __dirname2 = dirname4(__filename2);
 var packageJson = JSON.parse(
   readFileSync4(join11(__dirname2, "../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);
-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) {
@@ -1120,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) {
@@ -1128,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) {