dekit-cli 0.2.3 → 0.4.0

package/README.md

@@ -54,6 +54,22 @@ When the agent starts the preview server, open the browser to review. Right-clic
 > The hero section $${home@.hero} needs more padding, and make the CTA button blue
 ```
 
+**Initialize in an existing project:**
+
+```
+> Initialize a dekit design project in the design/ directory using the dashboard template
+```
+
+The agent creates a `design/` subdirectory with all the scaffolding, without touching your existing code.
+
+**Build reusable components:**
+
+```
+> Create a ui-card component with an image slot and body slot, then build a showcase page that uses it
+```
+
+The agent creates Web Components with `<template>` + scoped CSS, registers them in `dekit.yaml`, and uses them in pages like `<ui-card>`.
+
 **Add a page to an existing design:**
 
 ```

package/bin/dekit.ts

@@ -11,13 +11,14 @@ Commands:
   init [path]          Initialize a new design project
   add <type> <name>    Add a page or component
   ls                   List pages and components
-  serve                Start the preview server (default)
+  serve                Start the preview server (default, port 7980)
   screenshot <ref>     Take a screenshot of a page or element
   resolve <ref>        Resolve a ref to file path and line range
   usage                Print the agent usage guide
 
 Options:
   -c, --config         Path to dekit.yaml
+  -p, --port           Editor server port (default: 7980)
   -h, --help           Show this help message
 
 Run 'dekit <command> --help' for command-specific help.
@@ -25,7 +26,12 @@ Run 'dekit <command> --help' for command-specific help.
 }
 
 function findDefaultConfig(): string | undefined {
-  for (const name of ["dekit.yaml", "dekit.yml", "design.yaml", "design.yml"]) {
+  for (const name of [
+    ".dekit/dekit.yaml",
+    ".dekit/dekit.yml",
+    "dekit.yaml",
+    "dekit.yml",
+  ]) {
     const p = resolve(name);
     if (existsSync(p)) return p;
   }
@@ -56,7 +62,7 @@ async function loadConfig(configArg?: string) {
   const configPath = configArg ? resolve(configArg) : findDefaultConfig();
   if (!configPath) {
     console.error(
-      "Error: no dekit.yaml found in current directory. Use -c to specify a config file.\n"
+      "Error: no .dekit/dekit.yaml found. Run 'dekit init' or use -c to specify a config file.\n"
     );
     process.exit(1);
   }
@@ -102,16 +108,10 @@ async function main() {
     }
     case "serve": {
       const config = await loadConfig(configArg);
-      const port = parseInt(
-        commandArgs.find((_, i, a) => a[i - 1] === "-p") ?? "3000",
-        10
-      );
-      const designPort = parseInt(
-        commandArgs.find((_, i, a) => a[i - 1] === "--design-port") ?? "3001",
-        10
-      );
+      const portArg = commandArgs.find((_, i, a) => a[i - 1] === "-p");
+      const port = portArg ? parseInt(portArg, 10) : undefined;
       const noOpen = commandArgs.includes("--no-open");
-      await startServers({ config, port, designPort, noOpen });
+      await startServers({ config, port, noOpen });
       break;
     }
     case "screenshot": {