claw-design 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 prodoxx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# Claw Design
+
+Point at your running website. Describe what to change. Watch Claude edit the code live.
+
+[![npm version](https://img.shields.io/npm/v/claw-design)](https://www.npmjs.com/package/claw-design)
+[![license](https://img.shields.io/npm/l/claw-design)](./LICENSE)
+[![node](https://img.shields.io/node/v/claw-design)](https://nodejs.org)
+
+![Claw Design demo](./docs/demo.gif)
+
+## Why Claw Design?
+
+Web developers constantly context-switch between browser and editor. Claw Design eliminates this -- select any part of your running site, describe the change in plain English, and Claude Code edits the source files directly. Changes appear instantly via hot module reload.
+
+## Quick Start
+
+```bash
+npm install -g claw-design
+cd your-project
+clawdesign start
+```
+
+## Requirements
+
+- **Node.js >= 20** (LTS recommended)
+- **[Claude Code CLI](https://claude.ai/download)** installed and authenticated
+- A web project with a dev server
+
+## How It Works
+
+1. **Detects your dev server** from `package.json` scripts and starts it automatically
+2. **Opens a browser window** showing your running site with a selection overlay
+3. **You draw a selection** over any area and describe what you want to change
+4. **Claude Code edits your source files** based on the visual context and instruction -- HMR shows the result instantly
+
+## CLI Options
+
+| Flag | Description |
+|------|-------------|
+| `--cmd <command>` | Override dev server command (e.g. `--cmd "python -m http.server 8000"`) |
+| `--port <number>` | Specify dev server port instead of auto-detecting |
+| `--verbose` | Show dev server output in the terminal |
+| `--version` | Show version number |
+
+## Viewport Switching
+
+Switch between viewport presets using the toolbar buttons:
+
+- **Desktop** (1280x800)
+- **Tablet** (768x1024)
+- **Mobile** (375x812)
+
+## Framework Support
+
+Works with anything that serves on localhost:
+
+- React
+- Vue
+- Svelte
+- Next.js
+- Nuxt
+- Angular
+- Astro
+- Plain HTML
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT -- see [LICENSE](./LICENSE) for details.

package/dist/cli/commands/start.d.ts

@@ -0,0 +1,7 @@
+export interface StartOptions {
+    cmd?: string;
+    port?: string;
+    verbose?: boolean;
+}
+export declare function startCommand(options: StartOptions): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/cli/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkNvE"}

package/dist/cli/commands/start.js

@@ -0,0 +1,176 @@
+import { detectDevServerScript, detectPackageManager, spawnDevServer, DetectionError } from '../utils/dev-server.js';
+import { extractPortFromOutput, waitForPort, getProcessOnPort } from '../utils/port-detect.js';
+import { isClaudeInstalled, getClaudeAuthStatus } from '../utils/claude.js';
+import { checkNodeVersion, checkElectronBinary } from '../utils/preflight.js';
+import { spawnElectron } from '../utils/electron.js';
+import { registerShutdownHandlers } from '../utils/process.js';
+import { createSpinner, printReady, printError } from '../utils/output.js';
+import pc from 'picocolors';
+import path from 'node:path';
+import { readFileSync } from 'node:fs';
+import { createInterface } from 'node:readline';
+export async function startCommand(options) {
+    const verbose = options.verbose ?? false;
+    // Pre-flight checks (D-14): fast checks before any async work
+    const nodeCheck = checkNodeVersion();
+    if (!nodeCheck.ok) {
+        printError('Node.js 20+ required', `Found Node ${nodeCheck.version}.`, 'Update Node.js: https://nodejs.org');
+        process.exit(1);
+    }
+    if (!checkElectronBinary()) {
+        printError('Browser component not found', 'A required browser component is missing from the installation.', 'Reinstall: npm install -g claw-design');
+        process.exit(1);
+    }
+    // Step 1: Check Claude Code installed (per D-12)
+    if (!isClaudeInstalled()) {
+        printError('Claude Code not found', 'Claude Code CLI is not installed or not in PATH.', 'Install: https://claude.ai/download');
+        process.exit(1);
+    }
+    // Step 1b: Check Claude Code authentication
+    const authStatus = getClaudeAuthStatus();
+    if (!authStatus.loggedIn) {
+        printError('Claude Code not authenticated', 'You need to sign in before using clawdesign.', 'Run: claude login');
+        process.exit(1);
+    }
+    // Step 2: Detect dev server (per D-05, D-06)
+    let command;
+    const detectSpinner = createSpinner('Detecting dev server...');
+    if (options.cmd) {
+        command = options.cmd;
+        detectSpinner.succeed(`Using custom command: ${pc.cyan(command)}`);
+    }
+    else {
+        try {
+            const detected = await detectDevServerScript(process.cwd());
+            const pm = await detectPackageManager(process.cwd());
+            const runCmd = pm === 'npm' ? `npm run ${detected.name}` : `${pm} run ${detected.name}`;
+            command = runCmd;
+            detectSpinner.succeed(`Detected: ${pc.cyan(runCmd)} (from package.json)`);
+        }
+        catch (err) {
+            if (err instanceof DetectionError) {
+                detectSpinner.fail('No dev server detected');
+                printError('No dev server detected', err.message);
+            }
+            else {
+                detectSpinner.fail('Dev server detection failed');
+                printError('Dev server detection failed', err instanceof Error ? err.message : String(err));
+            }
+            process.exit(1);
+        }
+    }
+    // Read project name from package.json for Claw Design window title (D-03)
+    let projectName = 'unknown';
+    try {
+        const pkg = JSON.parse(readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'));
+        projectName = pkg.name || 'unknown';
+    }
+    catch {
+        // Not critical -- window title will show 'unknown'
+    }
+    // Step 3: Spawn dev server (per CLI-04)
+    const serverSpinner = createSpinner('Starting dev server...');
+    const devServer = spawnDevServer(command, verbose);
+    serverSpinner.succeed(`Dev server started ${pc.dim(command)}`);
+    // Step 4: Detect port (per D-07, D-08)
+    let port;
+    if (options.port) {
+        port = parseInt(options.port, 10);
+    }
+    else {
+        // Listen to stdout/stderr for port detection
+        const portSpinner = createSpinner('Detecting port from dev server output...');
+        let accumulatedOutput = '';
+        port = await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                cleanup();
+                reject(new Error('port-detect-timeout'));
+            }, 10_000);
+            function onData(chunk) {
+                accumulatedOutput += chunk.toString();
+                const detected = extractPortFromOutput(accumulatedOutput);
+                if (detected !== null) {
+                    cleanup();
+                    resolve(detected);
+                }
+            }
+            function cleanup() {
+                clearTimeout(timeout);
+                devServer.stdout?.removeListener('data', onData);
+                devServer.stderr?.removeListener('data', onData);
+            }
+            devServer.stdout?.on('data', onData);
+            devServer.stderr?.on('data', onData);
+        }).catch(async () => {
+            // Port not detected from stdout -- prompt user interactively (per D-07)
+            portSpinner.stop();
+            const rl = createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            return new Promise((resolve, reject) => {
+                rl.question(`${pc.yellow('  Could not detect port from dev server output.')}\n  Enter port number: `, (answer) => {
+                    rl.close();
+                    const parsed = parseInt(answer.trim(), 10);
+                    if (Number.isNaN(parsed) || parsed <= 0 || parsed > 65535) {
+                        reject(new Error('Invalid port number'));
+                    }
+                    else {
+                        resolve(parsed);
+                    }
+                });
+            });
+        });
+        portSpinner.succeed(`Port detected: ${pc.cyan(String(port))}`);
+    }
+    // Step 5: Wait for port readiness (per D-09, D-14, D-15)
+    const readySpinner = createSpinner(`Waiting for localhost:${port}...`);
+    const readyStart = Date.now();
+    const elapsedTimer = setInterval(() => {
+        const elapsed = Math.round((Date.now() - readyStart) / 1000);
+        readySpinner.text = `Waiting for localhost:${port}... ${pc.dim(`${elapsed}s`)}`;
+    }, 1000);
+    try {
+        await waitForPort(port, { timeout: 30_000 });
+        clearInterval(elapsedTimer);
+        readySpinner.succeed(`Dev server ready on ${pc.cyan(`http://localhost:${port}`)}`);
+    }
+    catch {
+        clearInterval(elapsedTimer);
+        readySpinner.fail(`Port ${port} not ready`);
+        // Check if port is in use by another process (per D-14)
+        const occupant = getProcessOnPort(port);
+        if (occupant) {
+            printError('Port already in use', `Port ${port} is occupied by ${occupant.name} (PID ${occupant.pid})`, `Try: kill ${occupant.pid} or clawdesign start --port <other>`);
+        }
+        else {
+            printError('Startup timeout', `Port ${port} not ready after 30s`, 'Try: clawdesign start --verbose\n  Or:  clawdesign start --port <port>');
+        }
+        process.exit(1);
+    }
+    // Step 6: Launch Electron window (per CLI-06)
+    // Pre-built by `npm run build` / prepublishOnly hook (D-18).
+    // No runtime build needed -- out/ is included in the npm package.
+    // Claude Code session is managed by AgentManager inside the Electron main process.
+    const electronSpinner = createSpinner('Starting Claw Design...');
+    const electronProcess = spawnElectron(`http://localhost:${port}`, projectName);
+    electronSpinner.succeed(`Claw Design ready ${pc.dim(`localhost:${port}`)}`);
+    // Step 7: Register shutdown and print ready (per D-01 final step)
+    // AgentManager handles its own cleanup from within Electron main process.
+    registerShutdownHandlers({
+        devServer: { pid: devServer.pid },
+        electronProcess: { pid: electronProcess.pid },
+    });
+    // Dev server crash handling (per D-13): notify but do NOT exit
+    devServer.on('exit', (code, signal) => {
+        console.log(pc.yellow('\n  Dev server exited.'));
+        console.log(pc.dim('  Press Ctrl+C to stop, then re-run clawdesign start'));
+    });
+    // Electron window closed -- trigger shutdown to kill dev server + Claude
+    electronProcess.on('exit', () => {
+        console.log(pc.dim('\n  Claw Design window closed.'));
+        process.emit('SIGINT');
+    });
+    printReady(port);
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACrH,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQhD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAqB;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;IAEzC,8DAA8D;IAC9D,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAClB,UAAU,CACR,sBAAsB,EACtB,cAAc,SAAS,CAAC,OAAO,GAAG,EAClC,oCAAoC,CACrC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAC3B,UAAU,CACR,6BAA6B,EAC7B,gEAAgE,EAChE,uCAAuC,CACxC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,iDAAiD;IACjD,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzB,UAAU,CACR,uBAAuB,EACvB,kDAAkD,EAClD,qCAAqC,CACtC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzB,UAAU,CACR,+BAA+B,EAC/B,8CAA8C,EAC9C,mBAAmB,CACpB,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6CAA6C;IAC7C,IAAI,OAAe,CAAC;IACpB,MAAM,aAAa,GAAG,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE/D,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;QACtB,aAAa,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5D,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxF,OAAO,GAAG,MAAM,CAAC;YACjB,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;gBAClC,aAAa,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;gBAC7C,UAAU,CAAC,wBAAwB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;gBAClD,UAAU,CACR,6BAA6B,EAC7B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,IAAI,WAAW,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACxF,WAAW,GAAG,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IAED,wCAAwC;IACxC,MAAM,aAAa,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAiB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjE,aAAa,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE/D,uCAAuC;IACvC,IAAI,IAAY,CAAC;IAEjB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,6CAA6C;QAC7C,MAAM,WAAW,GAAG,aAAa,CAAC,0CAA0C,CAAC,CAAC;QAC9E,IAAI,iBAAiB,GAAG,EAAE,CAAC;QAE3B,IAAI,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;YAC3C,CAAC,EAAE,MAAM,CAAC,CAAC;YAEX,SAAS,MAAM,CAAC,KAAa;gBAC3B,iBAAiB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACtC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;gBAC1D,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtB,OAAO,EAAE,CAAC;oBACV,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;YAED,SAAS,OAAO;gBACd,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACjD,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAED,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACrC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;YAClB,wEAAwE;YACxE,WAAW,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,EAAE,GAAG,eAAe,CAAC;gBACzB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YAEH,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC7C,EAAE,CAAC,QAAQ,CACT,GAAG,EAAE,CAAC,MAAM,CAAC,iDAAiD,CAAC,yBAAyB,EACxF,CAAC,MAAM,EAAE,EAAE;oBACT,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC3C,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;wBAC1D,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;oBAC3C,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,MAAM,CAAC,CAAC;oBAClB,CAAC;gBACH,CAAC,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,WAAW,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,yDAAyD;IACzD,MAAM,YAAY,GAAG,aAAa,CAAC,yBAAyB,IAAI,KAAK,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,YAAY,CAAC,IAAI,GAAG,yBAAyB,IAAI,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC;IAClF,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5B,YAAY,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,IAAI,CAAC,oBAAoB,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5B,YAAY,CAAC,IAAI,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAC;QAE5C,wDAAwD;QACxD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,QAAQ,EAAE,CAAC;YACb,UAAU,CACR,qBAAqB,EACrB,QAAQ,IAAI,mBAAmB,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,GAAG,GAAG,EACpE,aAAa,QAAQ,CAAC,GAAG,qCAAqC,CAC/D,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,UAAU,CACR,iBAAiB,EACjB,QAAQ,IAAI,sBAAsB,EAClC,wEAAwE,CACzE,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,8CAA8C;IAC9C,6DAA6D;IAC7D,kEAAkE;IAClE,mFAAmF;IACnF,MAAM,eAAe,GAAG,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACjE,MAAM,eAAe,GAAG,aAAa,CAAC,oBAAoB,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;IAC/E,eAAe,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAG5E,kEAAkE;IAClE,0EAA0E;IAC1E,wBAAwB,CAAC;QACvB,SAAS,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,GAAI,EAAE;QAClC,eAAe,EAAE,EAAE,GAAG,EAAE,eAAe,CAAC,GAAI,EAAE;KAC/C,CAAC,CAAC;IAEH,+DAA+D;IAC/D,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QACpC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { startCommand } from './commands/start.js';
+const require = createRequire(import.meta.url);
+const { version } = require('../../package.json');
+const program = new Command();
+program
+    .name('clawdesign')
+    .description('Visual web development tool powered by Claude Code')
+    .version(version);
+program
+    .command('start')
+    .description('Launch dev server and open visual editor')
+    .option('--cmd <command>', 'Override dev server command')
+    .option('--port <number>', 'Specify dev server port (skip auto-detection)')
+    .option('--verbose', 'Show dev server output')
+    .action(startCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,oDAAoD,CAAC;KACjE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,CAAC;KACxD,MAAM,CAAC,iBAAiB,EAAE,+CAA+C,CAAC;KAC1E,MAAM,CAAC,WAAW,EAAE,wBAAwB,CAAC;KAC7C,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/utils/claude.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Check if Claude Code CLI is installed and available in PATH.
+ * Synchronous check -- runs once at startup (per D-12).
+ */
+export declare function isClaudeInstalled(): boolean;
+export interface ClaudeAuthStatus {
+    loggedIn: boolean;
+    authMethod?: string;
+    apiProvider?: string;
+    apiKeySource?: string;
+    email?: string | null;
+}
+/**
+ * Check if the user is authenticated with Claude Code.
+ *
+ * Runs `claude auth status --json` and parses the result.
+ * Returns the parsed status, or `{ loggedIn: false }` if the command
+ * fails or produces unparseable output.
+ */
+export declare function getClaudeAuthStatus(): ClaudeAuthStatus;
+//# sourceMappingURL=claude.d.ts.map

package/dist/cli/utils/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/claude.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAkBtD"}

package/dist/cli/utils/claude.js

@@ -0,0 +1,42 @@
+import { execFileSync } from 'node:child_process';
+/**
+ * Check if Claude Code CLI is installed and available in PATH.
+ * Synchronous check -- runs once at startup (per D-12).
+ */
+export function isClaudeInstalled() {
+    try {
+        execFileSync('which', ['claude'], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if the user is authenticated with Claude Code.
+ *
+ * Runs `claude auth status --json` and parses the result.
+ * Returns the parsed status, or `{ loggedIn: false }` if the command
+ * fails or produces unparseable output.
+ */
+export function getClaudeAuthStatus() {
+    try {
+        const raw = execFileSync('claude', ['auth', 'status', '--json'], {
+            encoding: 'utf-8',
+            timeout: 10_000,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        const parsed = JSON.parse(raw.trim());
+        return {
+            loggedIn: Boolean(parsed.loggedIn),
+            authMethod: parsed.authMethod,
+            apiProvider: parsed.apiProvider,
+            apiKeySource: parsed.apiKeySource,
+            email: parsed.email,
+        };
+    }
+    catch {
+        return { loggedIn: false };
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/cli/utils/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/cli/utils/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE;YAC/D,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YAClC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/cli/utils/dev-server.d.ts

@@ -0,0 +1,14 @@
+import { type ChildProcess } from 'node:child_process';
+export declare const SCRIPT_PRIORITY: readonly ["dev", "start", "serve"];
+export declare class DetectionError extends Error {
+    constructor(message: string);
+}
+export interface DetectedScript {
+    name: string;
+    command: string;
+}
+export declare function detectDevServerScript(projectDir: string): Promise<DetectedScript>;
+export type PackageManager = 'npm' | 'pnpm' | 'bun';
+export declare function detectPackageManager(projectDir: string): Promise<PackageManager>;
+export declare function spawnDevServer(command: string, verbose: boolean): ChildProcess;
+//# sourceMappingURL=dev-server.d.ts.map

package/dist/cli/utils/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/dev-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,eAAO,MAAM,eAAe,oCAAqC,CAAC;AAElE,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CAoBzB;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AASpD,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAUtF;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,YAAY,CAad"}

package/dist/cli/utils/dev-server.js

@@ -0,0 +1,57 @@
+import { readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { spawn } from 'node:child_process';
+export const SCRIPT_PRIORITY = ['dev', 'start', 'serve'];
+export class DetectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DetectionError';
+    }
+}
+export async function detectDevServerScript(projectDir) {
+    const pkgPath = join(projectDir, 'package.json');
+    const raw = await readFile(pkgPath, 'utf-8');
+    const pkg = JSON.parse(raw);
+    if (!pkg.scripts) {
+        throw new DetectionError('No "scripts" field found in package.json');
+    }
+    for (const name of SCRIPT_PRIORITY) {
+        if (pkg.scripts[name]) {
+            return { name, command: pkg.scripts[name] };
+        }
+    }
+    throw new DetectionError(`No dev server script found in package.json.\n` +
+        `  Looked for: ${SCRIPT_PRIORITY.join(', ')}\n` +
+        `  Tip: use --cmd "your-dev-command" to specify manually`);
+}
+const LOCKFILE_MAP = [
+    ['bun.lock', 'bun'],
+    ['bun.lockb', 'bun'],
+    ['pnpm-lock.yaml', 'pnpm'],
+    ['package-lock.json', 'npm'],
+];
+export async function detectPackageManager(projectDir) {
+    for (const [lockfile, pm] of LOCKFILE_MAP) {
+        try {
+            await access(join(projectDir, lockfile));
+            return pm;
+        }
+        catch {
+            // lockfile not found, try next
+        }
+    }
+    return 'npm';
+}
+export function spawnDevServer(command, verbose) {
+    const child = spawn(command, {
+        shell: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        cwd: process.cwd(),
+    });
+    if (verbose) {
+        child.stdout?.pipe(process.stdout);
+        child.stderr?.pipe(process.stderr);
+    }
+    return child;
+}
+//# sourceMappingURL=dev-server.js.map

package/dist/cli/utils/dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../../../src/cli/utils/dev-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAE9D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAElE,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAOD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,IAAI,cAAc,CAAC,0CAA0C,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,IAAI,cAAc,CACtB,+CAA+C;QAC7C,iBAAiB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAC/C,yDAAyD,CAC5D,CAAC;AACJ,CAAC;AAID,MAAM,YAAY,GAAoC;IACpD,CAAC,UAAU,EAAE,KAAK,CAAC;IACnB,CAAC,WAAW,EAAE,KAAK,CAAC;IACpB,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1B,CAAC,mBAAmB,EAAE,KAAK,CAAC;CAC7B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IAC3D,KAAK,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;YACzC,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,OAAgB;IAEhB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC,CAAC;IAEH,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/utils/electron.d.ts

@@ -0,0 +1,7 @@
+import { type ChildProcess } from 'node:child_process';
+/**
+ * Spawn the Electron binary with the built main process script.
+ * Passes URL and project metadata via environment variables.
+ */
+export declare function spawnElectron(url: string, projectName: string): ChildProcess;
+//# sourceMappingURL=electron.d.ts.map

package/dist/cli/utils/electron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electron.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/electron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQ9D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CA4B5E"}

package/dist/cli/utils/electron.js

@@ -0,0 +1,36 @@
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Spawn the Electron binary with the built main process script.
+ * Passes URL and project metadata via environment variables.
+ */
+export function spawnElectron(url, projectName) {
+    // Resolve electron binary path from the electron npm package
+    const require = createRequire(import.meta.url);
+    const electronPath = require('electron');
+    // Path to built main process (from electron-vite build output)
+    const projectRoot = path.resolve(__dirname, '..', '..', '..');
+    const mainScript = path.join(projectRoot, 'out', 'main', 'index.js');
+    const child = spawn(electronPath, [mainScript], {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        env: {
+            ...process.env,
+            CLAW_URL: url,
+            CLAW_PROJECT_NAME: projectName,
+            CLAW_PROJECT_DIR: process.cwd(),
+        },
+    });
+    // Forward Electron main process logs to CLI terminal
+    child.stdout?.on('data', (chunk) => {
+        process.stdout.write(chunk);
+    });
+    child.stderr?.on('data', (chunk) => {
+        process.stderr.write(chunk);
+    });
+    return child;
+}
+//# sourceMappingURL=electron.js.map

package/dist/cli/utils/electron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electron.js","sourceRoot":"","sources":["../../../src/cli/utils/electron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,WAAmB;IAC5D,6DAA6D;IAC7D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAsB,CAAC;IAE9D,+DAA+D;IAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,EAAE;QAC9C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,QAAQ,EAAE,GAAG;YACb,iBAAiB,EAAE,WAAW;YAC9B,gBAAgB,EAAE,OAAO,CAAC,GAAG,EAAE;SAChC;KACF,CAAC,CAAC;IAEH,qDAAqD;IACrD,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/utils/output.d.ts

@@ -0,0 +1,6 @@
+import { type Ora } from 'ora';
+export declare function createSpinner(text: string): Ora;
+export declare function printHeader(version: string): void;
+export declare function printReady(port: number): void;
+export declare function printError(title: string, message: string, suggestion?: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/output.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAGpC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAE/C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI7C;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAMN"}

package/dist/cli/utils/output.js

@@ -0,0 +1,21 @@
+import ora from 'ora';
+import pc from 'picocolors';
+export function createSpinner(text) {
+    return ora(text).start();
+}
+export function printHeader(version) {
+    console.log(pc.bold(`clawdesign v${version}`));
+}
+export function printReady(port) {
+    console.log(`\n  ${pc.green('Ready!')}`);
+    console.log(pc.dim(`  Dev server: http://localhost:${port}`));
+    console.log(pc.dim('  Press Ctrl+C to stop'));
+}
+export function printError(title, message, suggestion) {
+    console.error(`\n  ${pc.red('\u2718')} ${pc.bold(title)}`);
+    console.error(`  ${message}`);
+    if (suggestion) {
+        console.error(pc.dim(`  ${suggestion}`));
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/cli/utils/output.ts"],"names":[],"mappings":"AAAA,OAAO,GAAiB,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,OAAe,EACf,UAAmB;IAEnB,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC9B,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/cli/utils/port-detect.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Ordered patterns for extracting port numbers from dev server stdout.
+ * Most specific first to avoid false positives (Pitfall 4 from research).
+ */
+export declare const PORT_PATTERNS: readonly RegExp[];
+/**
+ * Extract a port number from dev server output text.
+ * Tests patterns from most specific (URL) to least specific (colon:digits).
+ * Filters out error lines to avoid false positives from port-in-use messages.
+ * Returns null if no valid port found.
+ */
+export declare function extractPortFromOutput(output: string): number | null;
+/**
+ * Poll a TCP port until it accepts connections or timeout expires.
+ * Default timeout: 30s (per D-09). Default poll interval: 250ms.
+ */
+export declare function waitForPort(port: number, opts?: {
+    timeout?: number;
+    interval?: number;
+}): Promise<void>;
+/**
+ * Attempt to identify which process is listening on a given port.
+ * Best-effort -- returns null if lsof/ps unavailable or port is free.
+ * Used for D-14: port-in-use diagnostics.
+ */
+export declare function getProcessOnPort(port: number): {
+    pid: number;
+    name: string;
+} | null;
+//# sourceMappingURL=port-detect.d.ts.map

package/dist/cli/utils/port-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-detect.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/port-detect.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EASjC,CAAC;AASX;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAenE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBtC"}