@mdocui/cli 0.5.0 → 0.6.0

package/README.md

@@ -18,15 +18,18 @@ pnpm add -g @mdocui/cli
 
 ### `init`
 
-Scaffold a new mdocUI config file with starter components.
+Scaffold a complete mdocUI integration. Detects your framework (Next.js, Vite, Remix) and generates all required files.
 
 ```bash
 npx @mdocui/cli init
 ```
 
 Creates:
-- `mdocui.config.ts` — component definitions and config
-- `generated/` — output directory for system prompts
+- `mdocui.config.ts` — config with all 24 component definitions
+- `src/lib/mdoc-registry.ts` — component registry setup
+- `src/components/mdoc-message.tsx` — streaming message component using `useRenderer`
+- `.env.example` — API key placeholders
+- `src/app/api/chat/route.ts` — streaming API route (Next.js only)
 
 ### `generate`
 
@@ -40,12 +43,15 @@ Reads `mdocui.config.ts` and writes the prompt to the configured `output` path (
 
 ### `preview`
 
-Print the generated system prompt to stdout for review.
+Start a local dev server with a split-pane editor for live markup rendering and parse validation.
 
 ```bash
 npx @mdocui/cli preview
+npx @mdocui/cli preview --port 3000
 ```
 
+Opens a browser UI where you type mdocUI markup on the left and see it rendered on the right in real-time. Great for prompt iteration without burning API calls.
+
 ## Config File
 
 ```typescript

package/dist/index.js

@@ -49,79 +49,911 @@ async function generate(cwd2) {
 // src/commands/init.ts
 import fs3 from "fs";
 import path3 from "path";
-var CONFIG_TEMPLATE = `import { defineComponent } from '@mdocui/core'
-import { z } from 'zod'
-
-const button = defineComponent({
-  name: 'button',
-  description: 'Clickable action button',
-  props: z.object({
-    action: z.string().describe('Action to perform'),
-    label: z.string().describe('Button text'),
-  }),
-  children: 'none',
-})
+function detectFramework(cwd2) {
+  const pkgPath = path3.resolve(cwd2, "package.json");
+  const hasSrc = fs3.existsSync(path3.resolve(cwd2, "src"));
+  const hasApp = fs3.existsSync(path3.resolve(cwd2, "src/app")) || fs3.existsSync(path3.resolve(cwd2, "app"));
+  const hasPages = fs3.existsSync(path3.resolve(cwd2, "src/pages")) || fs3.existsSync(path3.resolve(cwd2, "pages"));
+  if (!fs3.existsSync(pkgPath)) {
+    return { framework: "unknown", hasSrc, hasApp, hasPages };
+  }
+  const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
+  const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+  if (allDeps.next) return { framework: "nextjs", hasSrc, hasApp, hasPages };
+  if (allDeps["@remix-run/react"] || allDeps.remix)
+    return { framework: "remix", hasSrc, hasApp, hasPages };
+  if (allDeps.vite) return { framework: "vite", hasSrc, hasApp, hasPages };
+  return { framework: "unknown", hasSrc, hasApp, hasPages };
+}
+function registryTemplate() {
+  return `import { createDefaultRegistry } from '@mdocui/react'
+
+// Pre-built registry with all 24 built-in mdocUI components:
+//   Layout:      stack, grid, card, divider, accordion, tabs, tab
+//   Interactive: button, button-group, input, textarea, select, checkbox, toggle, form
+//   Data:        chart, table, stat, progress
+//   Content:     callout, badge, image, code-block, link
+//
+// To add custom components, use the ComponentRegistry API directly:
+//   import { ComponentRegistry } from '@mdocui/core'
+//   import { allDefinitions } from '@mdocui/react'
+
+export const registry = createDefaultRegistry()
+`;
+}
+function mdocMessageTemplate() {
+  return `'use client'
+
+import { useCallback, useRef } from 'react'
+import { Renderer, useRenderer, defaultComponents } from '@mdocui/react'
+import type { ActionHandler } from '@mdocui/react'
+import { registry } from '@/lib/mdoc-registry'
+
+interface MdocMessageProps {
+  /** Called when the user clicks a button or submits a form */
+  onAction?: ActionHandler
+  /** Called when a "continue" action fires \u2014 typically sends the label as a new user message */
+  onSend?: (message: string) => void
+  /** Custom prose renderer, e.g. for markdown-to-HTML */
+  renderProse?: (content: string, key: string) => React.ReactNode
+  /** CSS class overrides per component name */
+  classNames?: Record<string, string>
+}
+
+export function MdocMessage({ onAction, onSend, renderProse, classNames }: MdocMessageProps) {
+  const { nodes, isStreaming, push, done, reset } = useRenderer({ registry })
+  const abortRef = useRef<AbortController | null>(null)
+
+  const handleAction: ActionHandler = useCallback(
+    (action, params) => {
+      if (action === 'continue' && onSend) {
+        onSend(params?.label ?? action)
+        return
+      }
+      onAction?.(action, params)
+    },
+    [onAction, onSend],
+  )
+
+  /** Stream a response from your API endpoint */
+  const stream = useCallback(
+    async (url: string, body: Record<string, unknown>) => {
+      abortRef.current?.abort()
+      reset()
+
+      const controller = new AbortController()
+      abortRef.current = controller
+
+      const res = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+        signal: controller.signal,
+      })
+
+      if (!res.ok || !res.body) {
+        throw new Error(\`Stream request failed: \${res.status}\`)
+      }
+
+      const reader = res.body.getReader()
+      const decoder = new TextDecoder()
+
+      while (true) {
+        const { done: readerDone, value } = await reader.read()
+        if (readerDone) break
+        push(decoder.decode(value, { stream: true }))
+      }
+
+      done()
+    },
+    [push, done, reset],
+  )
+
+  return (
+    <Renderer
+      nodes={nodes}
+      components={defaultComponents}
+      onAction={handleAction}
+      isStreaming={isStreaming}
+      renderProse={renderProse}
+      classNames={classNames}
+    />
+  )
+}
+
+// Export the stream helper so parent components can drive it
+export type { MdocMessageProps }
+export { MdocMessage as default }
+`;
+}
+function envExampleTemplate() {
+  return `# mdocUI \u2014 LLM API keys
+# Copy this file to .env.local and fill in your keys.
 
-const callout = defineComponent({
-  name: 'callout',
-  description: 'Highlighted message block',
-  props: z.object({
-    type: z.enum(['info', 'warning', 'error', 'success']).describe('Severity'),
-    title: z.string().optional().describe('Heading'),
-  }),
-  children: 'any',
+# Anthropic (Claude)
+ANTHROPIC_API_KEY=
+
+# OpenAI
+OPENAI_API_KEY=
+`;
+}
+function nextjsRouteTemplate() {
+  return `import { type NextRequest, NextResponse } from 'next/server'
+import { generatePrompt } from '@mdocui/core'
+import { allDefinitions, defaultGroups } from '@mdocui/react'
+
+// Build the system prompt once at module level
+const systemPrompt = generatePrompt({
+  components: allDefinitions,
+  groups: defaultGroups,
+  preamble: 'You are a helpful assistant. Use mdocUI components to create rich, interactive responses.',
 })
 
+export async function POST(req: NextRequest) {
+  const { messages, provider = 'anthropic' } = await req.json()
+
+  if (provider === 'openai') {
+    return streamOpenAI(messages)
+  }
+
+  return streamAnthropic(messages)
+}
+
+// \u2500\u2500 Anthropic (Claude) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+async function streamAnthropic(messages: Array<{ role: string; content: string }>) {
+  const apiKey = process.env.ANTHROPIC_API_KEY
+  if (!apiKey) {
+    return NextResponse.json({ error: 'ANTHROPIC_API_KEY not set' }, { status: 500 })
+  }
+
+  const res = await fetch('https://api.anthropic.com/v1/messages', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01',
+    },
+    body: JSON.stringify({
+      model: 'claude-sonnet-4-20250514',
+      max_tokens: 4096,
+      system: systemPrompt,
+      messages,
+      stream: true,
+    }),
+  })
+
+  if (!res.ok || !res.body) {
+    const text = await res.text()
+    return NextResponse.json({ error: text }, { status: res.status })
+  }
+
+  const encoder = new TextEncoder()
+  const stream = new ReadableStream({
+    async start(controller) {
+      const reader = res.body!.getReader()
+      const decoder = new TextDecoder()
+      let buffer = ''
+
+      while (true) {
+        const { done, value } = await reader.read()
+        if (done) break
+        buffer += decoder.decode(value, { stream: true })
+
+        const lines = buffer.split('\\n')
+        buffer = lines.pop() ?? ''
+
+        for (const line of lines) {
+          if (!line.startsWith('data: ')) continue
+          const data = line.slice(6)
+          if (data === '[DONE]') continue
+
+          try {
+            const event = JSON.parse(data)
+            if (event.type === 'content_block_delta' && event.delta?.text) {
+              controller.enqueue(encoder.encode(event.delta.text))
+            }
+          } catch {
+            // skip malformed events
+          }
+        }
+      }
+
+      controller.close()
+    },
+  })
+
+  return new Response(stream, {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  })
+}
+
+// \u2500\u2500 OpenAI \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+async function streamOpenAI(messages: Array<{ role: string; content: string }>) {
+  const apiKey = process.env.OPENAI_API_KEY
+  if (!apiKey) {
+    return NextResponse.json({ error: 'OPENAI_API_KEY not set' }, { status: 500 })
+  }
+
+  const res = await fetch('https://api.openai.com/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: \`Bearer \${apiKey}\`,
+    },
+    body: JSON.stringify({
+      model: 'gpt-4o',
+      messages: [{ role: 'system', content: systemPrompt }, ...messages],
+      stream: true,
+    }),
+  })
+
+  if (!res.ok || !res.body) {
+    const text = await res.text()
+    return NextResponse.json({ error: text }, { status: res.status })
+  }
+
+  const encoder = new TextEncoder()
+  const stream = new ReadableStream({
+    async start(controller) {
+      const reader = res.body!.getReader()
+      const decoder = new TextDecoder()
+      let buffer = ''
+
+      while (true) {
+        const { done, value } = await reader.read()
+        if (done) break
+        buffer += decoder.decode(value, { stream: true })
+
+        const lines = buffer.split('\\n')
+        buffer = lines.pop() ?? ''
+
+        for (const line of lines) {
+          if (!line.startsWith('data: ')) continue
+          const data = line.slice(6)
+          if (data === '[DONE]') continue
+
+          try {
+            const event = JSON.parse(data)
+            const content = event.choices?.[0]?.delta?.content
+            if (content) {
+              controller.enqueue(encoder.encode(content))
+            }
+          } catch {
+            // skip malformed events
+          }
+        }
+      }
+
+      controller.close()
+    },
+  })
+
+  return new Response(stream, {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  })
+}
+`;
+}
+function configTemplate() {
+  return `import { allDefinitions, defaultGroups } from '@mdocui/react'
+
 export default {
-  components: [button, callout],
+  components: allDefinitions,
+  groups: defaultGroups,
   output: './generated/system-prompt.txt',
-  preamble: 'You are a helpful assistant.',
-  additionalRules: [
-    'End responses with follow-up buttons using action="continue"',
-  ],
+  preamble: 'You are a helpful assistant. Use mdocUI components to create rich, interactive responses.',
 }
 `;
+}
+function writeIfMissing(cwd2, file) {
+  const abs = path3.resolve(cwd2, file.relativePath);
+  if (fs3.existsSync(abs)) {
+    console.log(`  skip  ${file.relativePath}  (already exists)`);
+    return false;
+  }
+  fs3.mkdirSync(path3.dirname(abs), { recursive: true });
+  fs3.writeFileSync(abs, file.content, "utf-8");
+  return true;
+}
 async function init(cwd2) {
-  const configPath = path3.resolve(cwd2, "mdocui.config.ts");
+  const project = detectFramework(cwd2);
+  console.log("");
+  console.log(`  Detected: ${frameworkLabel(project.framework)}`);
+  console.log("");
+  const files = [];
+  files.push({ relativePath: "src/lib/mdoc-registry.ts", content: registryTemplate() });
+  files.push({ relativePath: "src/components/mdoc-message.tsx", content: mdocMessageTemplate() });
+  files.push({ relativePath: ".env.example", content: envExampleTemplate() });
+  files.push({ relativePath: "mdocui.config.ts", content: configTemplate() });
+  if (project.framework === "nextjs") {
+    const routeDir = project.hasSrc ? "src/app/api/chat" : "app/api/chat";
+    files.push({ relativePath: `${routeDir}/route.ts`, content: nextjsRouteTemplate() });
+  }
+  const created = [];
+  const skipped = [];
+  for (const file of files) {
+    if (writeIfMissing(cwd2, file)) {
+      created.push(file.relativePath);
+    } else {
+      skipped.push(file.relativePath);
+    }
+  }
   const generatedDir = path3.resolve(cwd2, "generated");
-  if (fs3.existsSync(configPath)) {
-    console.log("mdocui.config.ts already exists \u2014 skipping");
-    return;
-  }
-  fs3.writeFileSync(configPath, CONFIG_TEMPLATE, "utf-8");
-  fs3.mkdirSync(generatedDir, { recursive: true });
-  fs3.writeFileSync(path3.resolve(generatedDir, ".gitkeep"), "", "utf-8");
-  console.log("Created:");
-  console.log("  mdocui.config.ts    \u2014 component definitions + config");
-  console.log("  generated/          \u2014 output directory for system prompts");
+  if (!fs3.existsSync(generatedDir)) {
+    fs3.mkdirSync(generatedDir, { recursive: true });
+    fs3.writeFileSync(path3.resolve(generatedDir, ".gitkeep"), "", "utf-8");
+    created.push("generated/");
+  }
   console.log("");
-  console.log("Next steps:");
-  console.log("  1. Edit mdocui.config.ts \u2014 add your components");
-  console.log("  2. Run: npx @mdocui/cli generate");
+  if (created.length > 0) {
+    console.log("  Created:");
+    for (const f of created) {
+      console.log(`    + ${f}`);
+    }
+  }
+  if (skipped.length > 0) {
+    console.log("  Skipped (already exist):");
+    for (const f of skipped) {
+      console.log(`    - ${f}`);
+    }
+  }
+  console.log("");
+  console.log("  Next steps:");
+  console.log("    1. Copy .env.example to .env.local and add your API keys");
+  console.log("    2. Install dependencies:");
+  console.log("       npm install @mdocui/core @mdocui/react");
+  console.log("    3. Generate the system prompt:");
+  console.log("       npx @mdocui/cli generate");
+  if (project.framework === "nextjs") {
+    console.log("    4. Import <MdocMessage /> in your chat page");
+    console.log('       and call stream("/api/chat", { messages })');
+  } else {
+    console.log("    4. Import <MdocMessage /> in your chat component");
+    console.log("       and wire up streaming from your backend");
+  }
+  console.log("");
+}
+function frameworkLabel(fw) {
+  switch (fw) {
+    case "nextjs":
+      return "Next.js";
+    case "vite":
+      return "Vite";
+    case "remix":
+      return "Remix";
+    case "unknown":
+      return "Unknown framework (generating generic files)";
+  }
 }
 
 // src/commands/preview.ts
-import { ComponentRegistry as ComponentRegistry2, generatePrompt as generatePrompt2 } from "@mdocui/core";
-async function preview(cwd2) {
-  const config = await loadConfig(cwd2);
-  const registry = new ComponentRegistry2();
-  registry.registerAll(config.components);
-  const prompt = generatePrompt2(registry, toPromptOptions(config));
-  console.log(prompt);
+import http from "http";
+import { StreamingParser } from "@mdocui/core";
+async function preview(cwd2, options) {
+  const port = options?.port ?? 4321;
+  let knownTags;
+  try {
+    const config = await loadConfig(cwd2);
+    knownTags = new Set(config.components.map((c) => c.name));
+    console.log(`Loaded config with ${knownTags.size} components: ${[...knownTags].join(", ")}`);
+  } catch {
+    console.log("No config found \u2014 all tags treated as known");
+  }
+  const server = http.createServer((req, res) => {
+    if (req.method === "POST" && req.url === "/api/parse") {
+      let body = "";
+      req.on("data", (chunk) => {
+        body += chunk.toString();
+      });
+      req.on("end", () => {
+        try {
+          const { content } = JSON.parse(body);
+          const parser = new StreamingParser(
+            knownTags ? { knownTags, dropUnknown: false } : void 0
+          );
+          parser.write(content);
+          parser.flush();
+          const nodes = parser.getNodes();
+          const meta = parser.getMeta();
+          res.writeHead(200, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ nodes, meta }));
+        } catch (err) {
+          res.writeHead(400, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: err.message }));
+        }
+      });
+      return;
+    }
+    if (req.method === "GET" && (req.url === "/" || req.url === "/index.html")) {
+      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+      res.end(buildHTML(knownTags));
+      return;
+    }
+    res.writeHead(404, { "Content-Type": "text/plain" });
+    res.end("Not found");
+  });
+  server.listen(port, () => {
+    console.log(`
+mdocui preview server running at:
+`);
+    console.log(`  http://localhost:${port}
+`);
+    console.log("Press Ctrl+C to stop.\n");
+  });
+}
+function buildHTML(knownTags) {
+  const tagList = knownTags ? JSON.stringify([...knownTags]) : "[]";
+  return (
+    /* html */
+    `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>mdocui preview</title>
+<style>
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+:root {
+  --bg: #0a0a0a;
+  --bg-surface: #141414;
+  --bg-surface-2: #1e1e1e;
+  --border: #2a2a2a;
+  --text: #e4e4e4;
+  --text-dim: #888;
+  --accent: #7c6bff;
+  --accent-dim: #5a4fbb;
+  --error: #f06;
+  --tag-bg: #1a1a2e;
+  --tag-border: #2a2a4e;
+  --prose-bg: #0f1a0f;
+  --prose-border: #1a3a1a;
+  --font-mono: 'SF Mono', 'Fira Code', 'JetBrains Mono', Menlo, monospace;
+  --font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}
+
+html, body { height: 100%; background: var(--bg); color: var(--text); font-family: var(--font-sans); }
+
+.app {
+  display: flex;
+  flex-direction: column;
+  height: 100vh;
+}
+
+header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 10px 20px;
+  border-bottom: 1px solid var(--border);
+  background: var(--bg-surface);
+}
+
+header h1 {
+  font-size: 14px;
+  font-weight: 600;
+  letter-spacing: 0.5px;
+  color: var(--accent);
+}
+
+header .meta {
+  font-size: 12px;
+  color: var(--text-dim);
+}
+
+.panels {
+  display: flex;
+  flex: 1;
+  min-height: 0;
+}
+
+.panel {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+}
+
+.panel + .panel {
+  border-left: 1px solid var(--border);
+}
+
+.panel-header {
+  padding: 8px 16px;
+  font-size: 11px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  color: var(--text-dim);
+  background: var(--bg-surface);
+  border-bottom: 1px solid var(--border);
+}
+
+textarea {
+  flex: 1;
+  width: 100%;
+  padding: 16px;
+  background: var(--bg);
+  color: var(--text);
+  border: none;
+  resize: none;
+  font-family: var(--font-mono);
+  font-size: 13px;
+  line-height: 1.6;
+  outline: none;
+  tab-size: 2;
+}
+
+textarea::placeholder { color: var(--text-dim); }
+
+.preview {
+  flex: 1;
+  overflow-y: auto;
+  padding: 16px;
+  background: var(--bg);
+}
+
+/* AST node rendering */
+
+.node-prose {
+  background: var(--prose-bg);
+  border: 1px solid var(--prose-border);
+  border-radius: 6px;
+  padding: 12px 16px;
+  margin-bottom: 8px;
+  font-size: 14px;
+  line-height: 1.7;
+}
+
+.node-prose p { margin-bottom: 0.5em; }
+.node-prose p:last-child { margin-bottom: 0; }
+.node-prose strong { color: #fff; }
+.node-prose em { color: #ccc; font-style: italic; }
+.node-prose code {
+  background: var(--bg-surface-2);
+  padding: 2px 6px;
+  border-radius: 3px;
+  font-family: var(--font-mono);
+  font-size: 12px;
+}
+.node-prose a { color: var(--accent); text-decoration: underline; }
+.node-prose ul, .node-prose ol { padding-left: 1.5em; margin-bottom: 0.5em; }
+.node-prose h1, .node-prose h2, .node-prose h3 {
+  color: #fff;
+  margin-bottom: 0.4em;
+}
+.node-prose h1 { font-size: 1.4em; }
+.node-prose h2 { font-size: 1.2em; }
+.node-prose h3 { font-size: 1.05em; }
+
+.node-component {
+  background: var(--tag-bg);
+  border: 1px solid var(--tag-border);
+  border-radius: 6px;
+  margin-bottom: 8px;
+  overflow: hidden;
+}
+
+.node-component-header {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 12px;
+  background: rgba(124, 107, 255, 0.08);
+  border-bottom: 1px solid var(--tag-border);
+}
+
+.node-component-name {
+  font-family: var(--font-mono);
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--accent);
+}
+
+.node-component-badge {
+  font-size: 10px;
+  padding: 2px 6px;
+  border-radius: 3px;
+  background: var(--accent-dim);
+  color: #fff;
+}
+
+.node-component-props {
+  padding: 8px 12px;
+}
+
+.prop-row {
+  display: flex;
+  gap: 8px;
+  font-size: 12px;
+  font-family: var(--font-mono);
+  padding: 2px 0;
+}
+
+.prop-key { color: #82aaff; }
+.prop-eq { color: var(--text-dim); }
+.prop-val { color: #c3e88d; }
+
+.node-component-children {
+  padding: 8px 12px;
+  border-top: 1px solid var(--tag-border);
+}
+
+.node-component-children-label {
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  color: var(--text-dim);
+  margin-bottom: 6px;
+}
+
+.errors {
+  padding: 8px 16px;
+  background: rgba(255, 0, 102, 0.08);
+  border-top: 1px solid rgba(255, 0, 102, 0.2);
+}
+
+.error-item {
+  font-size: 12px;
+  color: var(--error);
+  font-family: var(--font-mono);
+  padding: 2px 0;
+}
+
+.error-item::before { content: '\\26A0  '; }
+
+.status-bar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 4px 16px;
+  font-size: 11px;
+  color: var(--text-dim);
+  border-top: 1px solid var(--border);
+  background: var(--bg-surface);
+}
+
+.empty-state {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  color: var(--text-dim);
+  font-size: 13px;
+  text-align: center;
+  line-height: 1.8;
+}
+</style>
+</head>
+<body>
+<div class="app">
+  <header>
+    <h1>mdocui preview</h1>
+    <span class="meta" id="tag-count"></span>
+  </header>
+  <div class="panels">
+    <div class="panel">
+      <div class="panel-header">Input</div>
+      <textarea id="editor" spellcheck="false" placeholder="Type mdocUI markup here...
+
+Example:
+Here is a **weather card**:
+
+{% WeatherCard city=&quot;San Francisco&quot; temp=72 unit=&quot;F&quot; /%}
+
+Or with body content:
+
+{% Alert type=&quot;info&quot; %}
+This is an informational alert with **markdown** inside.
+{% /Alert %}"></textarea>
+    </div>
+    <div class="panel">
+      <div class="panel-header">Preview</div>
+      <div class="preview" id="preview">
+        <div class="empty-state">Start typing mdocUI markup<br/>to see the live preview</div>
+      </div>
+      <div class="errors" id="errors" style="display:none"></div>
+    </div>
+  </div>
+  <div class="status-bar">
+    <span id="status">Ready</span>
+    <span id="node-count"></span>
+  </div>
+</div>
+
+<script>
+(function() {
+  const knownTags = ${tagList};
+  const editor = document.getElementById('editor');
+  const preview = document.getElementById('preview');
+  const errors = document.getElementById('errors');
+  const status = document.getElementById('status');
+  const nodeCount = document.getElementById('node-count');
+  const tagCountEl = document.getElementById('tag-count');
+
+  if (knownTags.length > 0) {
+    tagCountEl.textContent = knownTags.length + ' registered component' + (knownTags.length === 1 ? '' : 's');
+  } else {
+    tagCountEl.textContent = 'no config \u2014 all tags accepted';
+  }
+
+  let timer = null;
+
+  editor.addEventListener('input', function() {
+    clearTimeout(timer);
+    timer = setTimeout(parse, 150);
+  });
+
+  // also handle paste
+  editor.addEventListener('paste', function() {
+    clearTimeout(timer);
+    timer = setTimeout(parse, 50);
+  });
+
+  async function parse() {
+    const content = editor.value;
+    if (!content.trim()) {
+      preview.innerHTML = '<div class="empty-state">Start typing mdocUI markup<br/>to see the live preview</div>';
+      errors.style.display = 'none';
+      status.textContent = 'Ready';
+      nodeCount.textContent = '';
+      return;
+    }
+
+    status.textContent = 'Parsing...';
+
+    try {
+      const res = await fetch('/api/parse', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ content }),
+      });
+
+      const data = await res.json();
+
+      if (data.error) {
+        status.textContent = 'Error: ' + data.error;
+        return;
+      }
+
+      preview.innerHTML = renderNodes(data.nodes);
+      nodeCount.textContent = data.meta.nodeCount + ' node' + (data.meta.nodeCount === 1 ? '' : 's');
+
+      if (data.meta.errors && data.meta.errors.length > 0) {
+        errors.style.display = 'block';
+        errors.innerHTML = data.meta.errors
+          .map(function(e) { return '<div class="error-item">' + escapeHtml(e.message) + '</div>'; })
+          .join('');
+        status.textContent = 'Parsed with ' + data.meta.errors.length + ' warning(s)';
+      } else {
+        errors.style.display = 'none';
+        status.textContent = 'OK';
+      }
+    } catch (err) {
+      status.textContent = 'Fetch error: ' + err.message;
+    }
+  }
+
+  function renderNodes(nodes) {
+    if (!nodes || nodes.length === 0) return '<div class="empty-state">No nodes parsed</div>';
+    return nodes.map(renderNode).join('');
+  }
+
+  function renderNode(node) {
+    if (node.type === 'prose') {
+      return '<div class="node-prose">' + markdownToHtml(node.content) + '</div>';
+    }
+
+    if (node.type === 'component') {
+      var html = '<div class="node-component">';
+      html += '<div class="node-component-header">';
+      html += '<span class="node-component-name">' + escapeHtml(node.name) + '</span>';
+      if (node.selfClosing) {
+        html += '<span class="node-component-badge">self-closing</span>';
+      }
+      html += '</div>';
+
+      var propKeys = Object.keys(node.props || {});
+      if (propKeys.length > 0) {
+        html += '<div class="node-component-props">';
+        propKeys.forEach(function(key) {
+          var val = node.props[key];
+          var display = typeof val === 'string' ? '"' + escapeHtml(val) + '"' : String(val);
+          html += '<div class="prop-row">';
+          html += '<span class="prop-key">' + escapeHtml(key) + '</span>';
+          html += '<span class="prop-eq">=</span>';
+          html += '<span class="prop-val">' + display + '</span>';
+          html += '</div>';
+        });
+        html += '</div>';
+      }
+
+      if (node.children && node.children.length > 0) {
+        html += '<div class="node-component-children">';
+        html += '<div class="node-component-children-label">Children</div>';
+        html += renderNodes(node.children);
+        html += '</div>';
+      }
+
+      html += '</div>';
+      return html;
+    }
+
+    return '';
+  }
+
+  /** Minimal markdown-to-HTML for prose content */
+  function markdownToHtml(text) {
+    var html = escapeHtml(text);
+
+    // headings
+    html = html.replace(/^### (.+)$/gm, '<h3>$1</h3>');
+    html = html.replace(/^## (.+)$/gm, '<h2>$1</h2>');
+    html = html.replace(/^# (.+)$/gm, '<h1>$1</h1>');
+
+    // bold + italic
+    html = html.replace(/\\*\\*\\*(.+?)\\*\\*\\*/g, '<strong><em>$1</em></strong>');
+    html = html.replace(/\\*\\*(.+?)\\*\\*/g, '<strong>$1</strong>');
+    html = html.replace(/\\*(.+?)\\*/g, '<em>$1</em>');
+
+    // inline code
+    html = html.replace(/\`([^\`]+)\`/g, '<code>$1</code>');
+
+    // links
+    html = html.replace(/\\[([^\\]]+)\\]\\(([^)]+)\\)/g, '<a href="$2" target="_blank">$1</a>');
+
+    // unordered lists
+    html = html.replace(/^- (.+)$/gm, '<li>$1</li>');
+    html = html.replace(/(<li>.*<\\/li>\\n?)+/g, function(m) { return '<ul>' + m + '</ul>'; });
+
+    // paragraphs: split on double newlines
+    html = html.split(/\\n\\n+/).map(function(block) {
+      block = block.trim();
+      if (!block) return '';
+      if (/^<(h[1-3]|ul|ol|li)/.test(block)) return block;
+      return '<p>' + block.replace(/\\n/g, '<br/>') + '</p>';
+    }).join('');
+
+    return html;
+  }
+
+  function escapeHtml(str) {
+    return String(str)
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;');
+  }
+})();
+</script>
+</body>
+</html>`
+  );
 }
 
 // src/index.ts
 var args = process.argv.slice(2);
 var command = args[0];
 var cwd = process.cwd();
+function parseFlag(flag) {
+  const idx = args.indexOf(flag);
+  if (idx !== -1 && idx + 1 < args.length) return args[idx + 1];
+  const eq = args.find((a) => a.startsWith(`${flag}=`));
+  if (eq) return eq.split("=")[1];
+  return void 0;
+}
 async function main() {
   switch (command) {
     case "generate":
       await generate(cwd);
       break;
-    case "preview":
-      await preview(cwd);
+    case "preview": {
+      const portStr = parseFlag("--port");
+      await preview(cwd, portStr ? { port: Number(portStr) } : void 0);
       break;
+    }
     case "init":
       await init(cwd);
       break;
@@ -141,14 +973,18 @@ function printHelp() {
 mdocui \u2014 CLI for mdocUI generative UI library
 
 Commands:
-  init        Scaffold a new mdocui config file
+  init        Scaffold mdocUI integration (registry, components, API route)
   generate    Generate system prompt from component registry
-  preview     Print generated system prompt to stdout
+  preview     Start local dev server with live mdocUI markup preview
+
+Options:
+  --port <n>  Port for preview server (default: 4321)
 
 Usage:
   npx @mdocui/cli init
   npx @mdocui/cli generate
   npx @mdocui/cli preview
+  npx @mdocui/cli preview --port 3000
 `);
 }
 main().catch((err) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/generate.ts","../src/config.ts","../src/commands/init.ts","../src/commands/preview.ts","../src/index.ts"],"sourcesContent":["import fs from 'node:fs'\nimport path from 'node:path'\nimport { ComponentRegistry, generatePrompt } from '@mdocui/core'\nimport { loadConfig, toPromptOptions } from '../config'\n\nexport async function generate(cwd: string) {\n\tconst config = await loadConfig(cwd)\n\tconst registry = new ComponentRegistry()\n\tregistry.registerAll(config.components)\n\n\tconst prompt = generatePrompt(registry, toPromptOptions(config))\n\tconst outputPath = path.resolve(cwd, config.output ?? 'system-prompt.txt')\n\n\tfs.mkdirSync(path.dirname(outputPath), { recursive: true })\n\tfs.writeFileSync(outputPath, prompt, 'utf-8')\n\n\tconsole.log(`Generated system prompt → ${path.relative(cwd, outputPath)}`)\n\tconsole.log(`${registry.names().length} components, ${prompt.length} chars`)\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport type { ComponentDefinition, ComponentGroup, PromptOptions } from '@mdocui/core'\n\nexport interface MdocUIConfig {\n\tcomponents: ComponentDefinition[]\n\toutput?: string\n\tpreamble?: string\n\tadditionalRules?: string[]\n\texamples?: string[]\n\tgroups?: ComponentGroup[]\n}\n\nconst CONFIG_FILES = ['mdocui.config.ts', 'mdocui.config.js', 'mdocui.config.mjs']\n\nexport async function loadConfig(cwd: string): Promise<MdocUIConfig> {\n\tfor (const name of CONFIG_FILES) {\n\t\tconst configPath = path.resolve(cwd, name)\n\t\tif (!fs.existsSync(configPath)) continue\n\n\t\tconst url = pathToFileURL(configPath).href\n\t\tconst mod = await import(url)\n\t\tconst config = mod.default ?? mod\n\n\t\tif (!config.components || !Array.isArray(config.components)) {\n\t\t\tthrow new Error(`${name}: \"components\" must be an array of ComponentDefinition`)\n\t\t}\n\n\t\treturn config as MdocUIConfig\n\t}\n\n\tthrow new Error(`No config file found. Create one of: ${CONFIG_FILES.join(', ')}`)\n}\n\nexport function toPromptOptions(config: MdocUIConfig): PromptOptions {\n\treturn {\n\t\tpreamble: config.preamble,\n\t\tadditionalRules: config.additionalRules,\n\t\texamples: config.examples,\n\t\tgroups: config.groups,\n\t}\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\n\nconst CONFIG_TEMPLATE = `import { defineComponent } from '@mdocui/core'\nimport { z } from 'zod'\n\nconst button = defineComponent({\n  name: 'button',\n  description: 'Clickable action button',\n  props: z.object({\n    action: z.string().describe('Action to perform'),\n    label: z.string().describe('Button text'),\n  }),\n  children: 'none',\n})\n\nconst callout = defineComponent({\n  name: 'callout',\n  description: 'Highlighted message block',\n  props: z.object({\n    type: z.enum(['info', 'warning', 'error', 'success']).describe('Severity'),\n    title: z.string().optional().describe('Heading'),\n  }),\n  children: 'any',\n})\n\nexport default {\n  components: [button, callout],\n  output: './generated/system-prompt.txt',\n  preamble: 'You are a helpful assistant.',\n  additionalRules: [\n    'End responses with follow-up buttons using action=\"continue\"',\n  ],\n}\n`\n\nexport async function init(cwd: string) {\n\tconst configPath = path.resolve(cwd, 'mdocui.config.ts')\n\tconst generatedDir = path.resolve(cwd, 'generated')\n\n\tif (fs.existsSync(configPath)) {\n\t\tconsole.log('mdocui.config.ts already exists — skipping')\n\t\treturn\n\t}\n\n\tfs.writeFileSync(configPath, CONFIG_TEMPLATE, 'utf-8')\n\tfs.mkdirSync(generatedDir, { recursive: true })\n\tfs.writeFileSync(path.resolve(generatedDir, '.gitkeep'), '', 'utf-8')\n\n\tconsole.log('Created:')\n\tconsole.log('  mdocui.config.ts    — component definitions + config')\n\tconsole.log('  generated/          — output directory for system prompts')\n\tconsole.log('')\n\tconsole.log('Next steps:')\n\tconsole.log('  1. Edit mdocui.config.ts — add your components')\n\tconsole.log('  2. Run: npx @mdocui/cli generate')\n}\n","import { ComponentRegistry, generatePrompt } from '@mdocui/core'\nimport { loadConfig, toPromptOptions } from '../config'\n\nexport async function preview(cwd: string) {\n\tconst config = await loadConfig(cwd)\n\tconst registry = new ComponentRegistry()\n\tregistry.registerAll(config.components)\n\n\tconst prompt = generatePrompt(registry, toPromptOptions(config))\n\tconsole.log(prompt)\n}\n","import { generate } from './commands/generate'\nimport { init } from './commands/init'\nimport { preview } from './commands/preview'\n\nconst args = process.argv.slice(2)\nconst command = args[0]\nconst cwd = process.cwd()\n\nasync function main() {\n\tswitch (command) {\n\t\tcase 'generate':\n\t\t\tawait generate(cwd)\n\t\t\tbreak\n\t\tcase 'preview':\n\t\t\tawait preview(cwd)\n\t\t\tbreak\n\t\tcase 'init':\n\t\t\tawait init(cwd)\n\t\t\tbreak\n\t\tcase '--help':\n\t\tcase '-h':\n\t\tcase undefined:\n\t\t\tprintHelp()\n\t\t\tbreak\n\t\tdefault:\n\t\t\tconsole.error(`Unknown command: ${command}`)\n\t\t\tprintHelp()\n\t\t\tprocess.exit(1)\n\t}\n}\n\nfunction printHelp() {\n\tconsole.log(`\nmdocui — CLI for mdocUI generative UI library\n\nCommands:\n  init        Scaffold a new mdocui config file\n  generate    Generate system prompt from component registry\n  preview     Print generated system prompt to stdout\n\nUsage:\n  npx @mdocui/cli init\n  npx @mdocui/cli generate\n  npx @mdocui/cli preview\n`)\n}\n\nmain().catch((err) => {\n\tconsole.error(err.message)\n\tprocess.exit(1)\n})\n"],"mappings":"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","names":["fs","path","cwd","cwd","path","fs","fs","path","cwd","ComponentRegistry","generatePrompt","cwd","ComponentRegistry","generatePrompt"]}
+{"version":3,"sources":["../src/commands/generate.ts","../src/config.ts","../src/commands/init.ts","../src/commands/preview.ts","../src/index.ts"],"sourcesContent":["import fs from 'node:fs'\nimport path from 'node:path'\nimport { ComponentRegistry, generatePrompt } from '@mdocui/core'\nimport { loadConfig, toPromptOptions } from '../config'\n\nexport async function generate(cwd: string) {\n\tconst config = await loadConfig(cwd)\n\tconst registry = new ComponentRegistry()\n\tregistry.registerAll(config.components)\n\n\tconst prompt = generatePrompt(registry, toPromptOptions(config))\n\tconst outputPath = path.resolve(cwd, config.output ?? 'system-prompt.txt')\n\n\tfs.mkdirSync(path.dirname(outputPath), { recursive: true })\n\tfs.writeFileSync(outputPath, prompt, 'utf-8')\n\n\tconsole.log(`Generated system prompt → ${path.relative(cwd, outputPath)}`)\n\tconsole.log(`${registry.names().length} components, ${prompt.length} chars`)\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport type { ComponentDefinition, ComponentGroup, PromptOptions } from '@mdocui/core'\n\nexport interface MdocUIConfig {\n\tcomponents: ComponentDefinition[]\n\toutput?: string\n\tpreamble?: string\n\tadditionalRules?: string[]\n\texamples?: string[]\n\tgroups?: ComponentGroup[]\n}\n\nconst CONFIG_FILES = ['mdocui.config.ts', 'mdocui.config.js', 'mdocui.config.mjs']\n\nexport async function loadConfig(cwd: string): Promise<MdocUIConfig> {\n\tfor (const name of CONFIG_FILES) {\n\t\tconst configPath = path.resolve(cwd, name)\n\t\tif (!fs.existsSync(configPath)) continue\n\n\t\tconst url = pathToFileURL(configPath).href\n\t\tconst mod = await import(url)\n\t\tconst config = mod.default ?? mod\n\n\t\tif (!config.components || !Array.isArray(config.components)) {\n\t\t\tthrow new Error(`${name}: \"components\" must be an array of ComponentDefinition`)\n\t\t}\n\n\t\treturn config as MdocUIConfig\n\t}\n\n\tthrow new Error(`No config file found. Create one of: ${CONFIG_FILES.join(', ')}`)\n}\n\nexport function toPromptOptions(config: MdocUIConfig): PromptOptions {\n\treturn {\n\t\tpreamble: config.preamble,\n\t\tadditionalRules: config.additionalRules,\n\t\texamples: config.examples,\n\t\tgroups: config.groups,\n\t}\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\n\ntype Framework = 'nextjs' | 'vite' | 'remix' | 'unknown'\n\ninterface DetectedProject {\n\tframework: Framework\n\thasSrc: boolean\n\thasApp: boolean // Next.js app router\n\thasPages: boolean // Next.js pages router\n}\n\nfunction detectFramework(cwd: string): DetectedProject {\n\tconst pkgPath = path.resolve(cwd, 'package.json')\n\tconst hasSrc = fs.existsSync(path.resolve(cwd, 'src'))\n\tconst hasApp =\n\t\tfs.existsSync(path.resolve(cwd, 'src/app')) || fs.existsSync(path.resolve(cwd, 'app'))\n\tconst hasPages =\n\t\tfs.existsSync(path.resolve(cwd, 'src/pages')) || fs.existsSync(path.resolve(cwd, 'pages'))\n\n\tif (!fs.existsSync(pkgPath)) {\n\t\treturn { framework: 'unknown', hasSrc, hasApp, hasPages }\n\t}\n\n\tconst pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'))\n\tconst allDeps = { ...pkg.dependencies, ...pkg.devDependencies }\n\n\tif (allDeps.next) return { framework: 'nextjs', hasSrc, hasApp, hasPages }\n\tif (allDeps['@remix-run/react'] || allDeps.remix)\n\t\treturn { framework: 'remix', hasSrc, hasApp, hasPages }\n\tif (allDeps.vite) return { framework: 'vite', hasSrc, hasApp, hasPages }\n\n\treturn { framework: 'unknown', hasSrc, hasApp, hasPages }\n}\n\n// ── File templates ─────────────────────────────────────────\n\nfunction registryTemplate(): string {\n\treturn `import { createDefaultRegistry } from '@mdocui/react'\n\n// Pre-built registry with all 24 built-in mdocUI components:\n//   Layout:      stack, grid, card, divider, accordion, tabs, tab\n//   Interactive: button, button-group, input, textarea, select, checkbox, toggle, form\n//   Data:        chart, table, stat, progress\n//   Content:     callout, badge, image, code-block, link\n//\n// To add custom components, use the ComponentRegistry API directly:\n//   import { ComponentRegistry } from '@mdocui/core'\n//   import { allDefinitions } from '@mdocui/react'\n\nexport const registry = createDefaultRegistry()\n`\n}\n\nfunction mdocMessageTemplate(): string {\n\treturn `'use client'\n\nimport { useCallback, useRef } from 'react'\nimport { Renderer, useRenderer, defaultComponents } from '@mdocui/react'\nimport type { ActionHandler } from '@mdocui/react'\nimport { registry } from '@/lib/mdoc-registry'\n\ninterface MdocMessageProps {\n  /** Called when the user clicks a button or submits a form */\n  onAction?: ActionHandler\n  /** Called when a \"continue\" action fires — typically sends the label as a new user message */\n  onSend?: (message: string) => void\n  /** Custom prose renderer, e.g. for markdown-to-HTML */\n  renderProse?: (content: string, key: string) => React.ReactNode\n  /** CSS class overrides per component name */\n  classNames?: Record<string, string>\n}\n\nexport function MdocMessage({ onAction, onSend, renderProse, classNames }: MdocMessageProps) {\n  const { nodes, isStreaming, push, done, reset } = useRenderer({ registry })\n  const abortRef = useRef<AbortController | null>(null)\n\n  const handleAction: ActionHandler = useCallback(\n    (action, params) => {\n      if (action === 'continue' && onSend) {\n        onSend(params?.label ?? action)\n        return\n      }\n      onAction?.(action, params)\n    },\n    [onAction, onSend],\n  )\n\n  /** Stream a response from your API endpoint */\n  const stream = useCallback(\n    async (url: string, body: Record<string, unknown>) => {\n      abortRef.current?.abort()\n      reset()\n\n      const controller = new AbortController()\n      abortRef.current = controller\n\n      const res = await fetch(url, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify(body),\n        signal: controller.signal,\n      })\n\n      if (!res.ok || !res.body) {\n        throw new Error(\\`Stream request failed: \\${res.status}\\`)\n      }\n\n      const reader = res.body.getReader()\n      const decoder = new TextDecoder()\n\n      while (true) {\n        const { done: readerDone, value } = await reader.read()\n        if (readerDone) break\n        push(decoder.decode(value, { stream: true }))\n      }\n\n      done()\n    },\n    [push, done, reset],\n  )\n\n  return (\n    <Renderer\n      nodes={nodes}\n      components={defaultComponents}\n      onAction={handleAction}\n      isStreaming={isStreaming}\n      renderProse={renderProse}\n      classNames={classNames}\n    />\n  )\n}\n\n// Export the stream helper so parent components can drive it\nexport type { MdocMessageProps }\nexport { MdocMessage as default }\n`\n}\n\nfunction envExampleTemplate(): string {\n\treturn `# mdocUI — LLM API keys\n# Copy this file to .env.local and fill in your keys.\n\n# Anthropic (Claude)\nANTHROPIC_API_KEY=\n\n# OpenAI\nOPENAI_API_KEY=\n`\n}\n\nfunction nextjsRouteTemplate(): string {\n\treturn `import { type NextRequest, NextResponse } from 'next/server'\nimport { generatePrompt } from '@mdocui/core'\nimport { allDefinitions, defaultGroups } from '@mdocui/react'\n\n// Build the system prompt once at module level\nconst systemPrompt = generatePrompt({\n  components: allDefinitions,\n  groups: defaultGroups,\n  preamble: 'You are a helpful assistant. Use mdocUI components to create rich, interactive responses.',\n})\n\nexport async function POST(req: NextRequest) {\n  const { messages, provider = 'anthropic' } = await req.json()\n\n  if (provider === 'openai') {\n    return streamOpenAI(messages)\n  }\n\n  return streamAnthropic(messages)\n}\n\n// ── Anthropic (Claude) ─────────────────────────────────────\n\nasync function streamAnthropic(messages: Array<{ role: string; content: string }>) {\n  const apiKey = process.env.ANTHROPIC_API_KEY\n  if (!apiKey) {\n    return NextResponse.json({ error: 'ANTHROPIC_API_KEY not set' }, { status: 500 })\n  }\n\n  const res = await fetch('https://api.anthropic.com/v1/messages', {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      'x-api-key': apiKey,\n      'anthropic-version': '2023-06-01',\n    },\n    body: JSON.stringify({\n      model: 'claude-sonnet-4-20250514',\n      max_tokens: 4096,\n      system: systemPrompt,\n      messages,\n      stream: true,\n    }),\n  })\n\n  if (!res.ok || !res.body) {\n    const text = await res.text()\n    return NextResponse.json({ error: text }, { status: res.status })\n  }\n\n  const encoder = new TextEncoder()\n  const stream = new ReadableStream({\n    async start(controller) {\n      const reader = res.body!.getReader()\n      const decoder = new TextDecoder()\n      let buffer = ''\n\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) break\n        buffer += decoder.decode(value, { stream: true })\n\n        const lines = buffer.split('\\\\n')\n        buffer = lines.pop() ?? ''\n\n        for (const line of lines) {\n          if (!line.startsWith('data: ')) continue\n          const data = line.slice(6)\n          if (data === '[DONE]') continue\n\n          try {\n            const event = JSON.parse(data)\n            if (event.type === 'content_block_delta' && event.delta?.text) {\n              controller.enqueue(encoder.encode(event.delta.text))\n            }\n          } catch {\n            // skip malformed events\n          }\n        }\n      }\n\n      controller.close()\n    },\n  })\n\n  return new Response(stream, {\n    headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n  })\n}\n\n// ── OpenAI ─────────────────────────────────────────────────\n\nasync function streamOpenAI(messages: Array<{ role: string; content: string }>) {\n  const apiKey = process.env.OPENAI_API_KEY\n  if (!apiKey) {\n    return NextResponse.json({ error: 'OPENAI_API_KEY not set' }, { status: 500 })\n  }\n\n  const res = await fetch('https://api.openai.com/v1/chat/completions', {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n      Authorization: \\`Bearer \\${apiKey}\\`,\n    },\n    body: JSON.stringify({\n      model: 'gpt-4o',\n      messages: [{ role: 'system', content: systemPrompt }, ...messages],\n      stream: true,\n    }),\n  })\n\n  if (!res.ok || !res.body) {\n    const text = await res.text()\n    return NextResponse.json({ error: text }, { status: res.status })\n  }\n\n  const encoder = new TextEncoder()\n  const stream = new ReadableStream({\n    async start(controller) {\n      const reader = res.body!.getReader()\n      const decoder = new TextDecoder()\n      let buffer = ''\n\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) break\n        buffer += decoder.decode(value, { stream: true })\n\n        const lines = buffer.split('\\\\n')\n        buffer = lines.pop() ?? ''\n\n        for (const line of lines) {\n          if (!line.startsWith('data: ')) continue\n          const data = line.slice(6)\n          if (data === '[DONE]') continue\n\n          try {\n            const event = JSON.parse(data)\n            const content = event.choices?.[0]?.delta?.content\n            if (content) {\n              controller.enqueue(encoder.encode(content))\n            }\n          } catch {\n            // skip malformed events\n          }\n        }\n      }\n\n      controller.close()\n    },\n  })\n\n  return new Response(stream, {\n    headers: { 'Content-Type': 'text/plain; charset=utf-8' },\n  })\n}\n`\n}\n\nfunction configTemplate(): string {\n\treturn `import { allDefinitions, defaultGroups } from '@mdocui/react'\n\nexport default {\n  components: allDefinitions,\n  groups: defaultGroups,\n  output: './generated/system-prompt.txt',\n  preamble: 'You are a helpful assistant. Use mdocUI components to create rich, interactive responses.',\n}\n`\n}\n\n// ── Scaffolder ─────────────────────────────────────────────\n\ninterface ScaffoldedFile {\n\trelativePath: string\n\tcontent: string\n}\n\nfunction writeIfMissing(cwd: string, file: ScaffoldedFile): boolean {\n\tconst abs = path.resolve(cwd, file.relativePath)\n\tif (fs.existsSync(abs)) {\n\t\tconsole.log(`  skip  ${file.relativePath}  (already exists)`)\n\t\treturn false\n\t}\n\tfs.mkdirSync(path.dirname(abs), { recursive: true })\n\tfs.writeFileSync(abs, file.content, 'utf-8')\n\treturn true\n}\n\nexport async function init(cwd: string) {\n\tconst project = detectFramework(cwd)\n\n\tconsole.log('')\n\tconsole.log(`  Detected: ${frameworkLabel(project.framework)}`)\n\tconsole.log('')\n\n\tconst files: ScaffoldedFile[] = []\n\n\t// Always generate these\n\tfiles.push({ relativePath: 'src/lib/mdoc-registry.ts', content: registryTemplate() })\n\tfiles.push({ relativePath: 'src/components/mdoc-message.tsx', content: mdocMessageTemplate() })\n\tfiles.push({ relativePath: '.env.example', content: envExampleTemplate() })\n\tfiles.push({ relativePath: 'mdocui.config.ts', content: configTemplate() })\n\n\t// Framework-specific files\n\tif (project.framework === 'nextjs') {\n\t\tconst routeDir = project.hasSrc ? 'src/app/api/chat' : 'app/api/chat'\n\t\tfiles.push({ relativePath: `${routeDir}/route.ts`, content: nextjsRouteTemplate() })\n\t}\n\n\t// Write files\n\tconst created: string[] = []\n\tconst skipped: string[] = []\n\n\tfor (const file of files) {\n\t\tif (writeIfMissing(cwd, file)) {\n\t\t\tcreated.push(file.relativePath)\n\t\t} else {\n\t\t\tskipped.push(file.relativePath)\n\t\t}\n\t}\n\n\t// Ensure generated/ dir\n\tconst generatedDir = path.resolve(cwd, 'generated')\n\tif (!fs.existsSync(generatedDir)) {\n\t\tfs.mkdirSync(generatedDir, { recursive: true })\n\t\tfs.writeFileSync(path.resolve(generatedDir, '.gitkeep'), '', 'utf-8')\n\t\tcreated.push('generated/')\n\t}\n\n\t// Summary\n\tconsole.log('')\n\tif (created.length > 0) {\n\t\tconsole.log('  Created:')\n\t\tfor (const f of created) {\n\t\t\tconsole.log(`    + ${f}`)\n\t\t}\n\t}\n\tif (skipped.length > 0) {\n\t\tconsole.log('  Skipped (already exist):')\n\t\tfor (const f of skipped) {\n\t\t\tconsole.log(`    - ${f}`)\n\t\t}\n\t}\n\n\tconsole.log('')\n\tconsole.log('  Next steps:')\n\tconsole.log('    1. Copy .env.example to .env.local and add your API keys')\n\tconsole.log('    2. Install dependencies:')\n\tconsole.log('       npm install @mdocui/core @mdocui/react')\n\tconsole.log('    3. Generate the system prompt:')\n\tconsole.log('       npx @mdocui/cli generate')\n\tif (project.framework === 'nextjs') {\n\t\tconsole.log('    4. Import <MdocMessage /> in your chat page')\n\t\tconsole.log('       and call stream(\"/api/chat\", { messages })')\n\t} else {\n\t\tconsole.log('    4. Import <MdocMessage /> in your chat component')\n\t\tconsole.log('       and wire up streaming from your backend')\n\t}\n\tconsole.log('')\n}\n\nfunction frameworkLabel(fw: Framework): string {\n\tswitch (fw) {\n\t\tcase 'nextjs':\n\t\t\treturn 'Next.js'\n\t\tcase 'vite':\n\t\t\treturn 'Vite'\n\t\tcase 'remix':\n\t\t\treturn 'Remix'\n\t\tcase 'unknown':\n\t\t\treturn 'Unknown framework (generating generic files)'\n\t}\n}\n","import http from 'node:http'\nimport type { ASTNode } from '@mdocui/core'\nimport { StreamingParser } from '@mdocui/core'\nimport { loadConfig } from '../config'\n\nexport interface PreviewOptions {\n\tport?: number\n}\n\nexport async function preview(cwd: string, options?: PreviewOptions) {\n\tconst port = options?.port ?? 4321\n\tlet knownTags: Set<string> | undefined\n\n\ttry {\n\t\tconst config = await loadConfig(cwd)\n\t\tknownTags = new Set(config.components.map((c) => c.name))\n\t\tconsole.log(`Loaded config with ${knownTags.size} components: ${[...knownTags].join(', ')}`)\n\t} catch {\n\t\tconsole.log('No config found — all tags treated as known')\n\t}\n\n\tconst server = http.createServer((req, res) => {\n\t\tif (req.method === 'POST' && req.url === '/api/parse') {\n\t\t\tlet body = ''\n\t\t\treq.on('data', (chunk: Buffer) => {\n\t\t\t\tbody += chunk.toString()\n\t\t\t})\n\t\t\treq.on('end', () => {\n\t\t\t\ttry {\n\t\t\t\t\tconst { content } = JSON.parse(body) as { content: string }\n\t\t\t\t\tconst parser = new StreamingParser(\n\t\t\t\t\t\tknownTags ? { knownTags, dropUnknown: false } : undefined,\n\t\t\t\t\t)\n\t\t\t\t\tparser.write(content)\n\t\t\t\t\tparser.flush()\n\t\t\t\t\tconst nodes: ASTNode[] = parser.getNodes()\n\t\t\t\t\tconst meta = parser.getMeta()\n\n\t\t\t\t\tres.writeHead(200, { 'Content-Type': 'application/json' })\n\t\t\t\t\tres.end(JSON.stringify({ nodes, meta }))\n\t\t\t\t} catch (err) {\n\t\t\t\t\tres.writeHead(400, { 'Content-Type': 'application/json' })\n\t\t\t\t\tres.end(JSON.stringify({ error: (err as Error).message }))\n\t\t\t\t}\n\t\t\t})\n\t\t\treturn\n\t\t}\n\n\t\tif (req.method === 'GET' && (req.url === '/' || req.url === '/index.html')) {\n\t\t\tres.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })\n\t\t\tres.end(buildHTML(knownTags))\n\t\t\treturn\n\t\t}\n\n\t\tres.writeHead(404, { 'Content-Type': 'text/plain' })\n\t\tres.end('Not found')\n\t})\n\n\tserver.listen(port, () => {\n\t\tconsole.log(`\\nmdocui preview server running at:\\n`)\n\t\tconsole.log(`  http://localhost:${port}\\n`)\n\t\tconsole.log('Press Ctrl+C to stop.\\n')\n\t})\n}\n\nfunction buildHTML(knownTags?: Set<string>): string {\n\tconst tagList = knownTags ? JSON.stringify([...knownTags]) : '[]'\n\n\treturn /* html */ `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\" />\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n<title>mdocui preview</title>\n<style>\n*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }\n\n:root {\n  --bg: #0a0a0a;\n  --bg-surface: #141414;\n  --bg-surface-2: #1e1e1e;\n  --border: #2a2a2a;\n  --text: #e4e4e4;\n  --text-dim: #888;\n  --accent: #7c6bff;\n  --accent-dim: #5a4fbb;\n  --error: #f06;\n  --tag-bg: #1a1a2e;\n  --tag-border: #2a2a4e;\n  --prose-bg: #0f1a0f;\n  --prose-border: #1a3a1a;\n  --font-mono: 'SF Mono', 'Fira Code', 'JetBrains Mono', Menlo, monospace;\n  --font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n}\n\nhtml, body { height: 100%; background: var(--bg); color: var(--text); font-family: var(--font-sans); }\n\n.app {\n  display: flex;\n  flex-direction: column;\n  height: 100vh;\n}\n\nheader {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 10px 20px;\n  border-bottom: 1px solid var(--border);\n  background: var(--bg-surface);\n}\n\nheader h1 {\n  font-size: 14px;\n  font-weight: 600;\n  letter-spacing: 0.5px;\n  color: var(--accent);\n}\n\nheader .meta {\n  font-size: 12px;\n  color: var(--text-dim);\n}\n\n.panels {\n  display: flex;\n  flex: 1;\n  min-height: 0;\n}\n\n.panel {\n  flex: 1;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n}\n\n.panel + .panel {\n  border-left: 1px solid var(--border);\n}\n\n.panel-header {\n  padding: 8px 16px;\n  font-size: 11px;\n  font-weight: 600;\n  text-transform: uppercase;\n  letter-spacing: 1px;\n  color: var(--text-dim);\n  background: var(--bg-surface);\n  border-bottom: 1px solid var(--border);\n}\n\ntextarea {\n  flex: 1;\n  width: 100%;\n  padding: 16px;\n  background: var(--bg);\n  color: var(--text);\n  border: none;\n  resize: none;\n  font-family: var(--font-mono);\n  font-size: 13px;\n  line-height: 1.6;\n  outline: none;\n  tab-size: 2;\n}\n\ntextarea::placeholder { color: var(--text-dim); }\n\n.preview {\n  flex: 1;\n  overflow-y: auto;\n  padding: 16px;\n  background: var(--bg);\n}\n\n/* AST node rendering */\n\n.node-prose {\n  background: var(--prose-bg);\n  border: 1px solid var(--prose-border);\n  border-radius: 6px;\n  padding: 12px 16px;\n  margin-bottom: 8px;\n  font-size: 14px;\n  line-height: 1.7;\n}\n\n.node-prose p { margin-bottom: 0.5em; }\n.node-prose p:last-child { margin-bottom: 0; }\n.node-prose strong { color: #fff; }\n.node-prose em { color: #ccc; font-style: italic; }\n.node-prose code {\n  background: var(--bg-surface-2);\n  padding: 2px 6px;\n  border-radius: 3px;\n  font-family: var(--font-mono);\n  font-size: 12px;\n}\n.node-prose a { color: var(--accent); text-decoration: underline; }\n.node-prose ul, .node-prose ol { padding-left: 1.5em; margin-bottom: 0.5em; }\n.node-prose h1, .node-prose h2, .node-prose h3 {\n  color: #fff;\n  margin-bottom: 0.4em;\n}\n.node-prose h1 { font-size: 1.4em; }\n.node-prose h2 { font-size: 1.2em; }\n.node-prose h3 { font-size: 1.05em; }\n\n.node-component {\n  background: var(--tag-bg);\n  border: 1px solid var(--tag-border);\n  border-radius: 6px;\n  margin-bottom: 8px;\n  overflow: hidden;\n}\n\n.node-component-header {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  padding: 8px 12px;\n  background: rgba(124, 107, 255, 0.08);\n  border-bottom: 1px solid var(--tag-border);\n}\n\n.node-component-name {\n  font-family: var(--font-mono);\n  font-size: 13px;\n  font-weight: 600;\n  color: var(--accent);\n}\n\n.node-component-badge {\n  font-size: 10px;\n  padding: 2px 6px;\n  border-radius: 3px;\n  background: var(--accent-dim);\n  color: #fff;\n}\n\n.node-component-props {\n  padding: 8px 12px;\n}\n\n.prop-row {\n  display: flex;\n  gap: 8px;\n  font-size: 12px;\n  font-family: var(--font-mono);\n  padding: 2px 0;\n}\n\n.prop-key { color: #82aaff; }\n.prop-eq { color: var(--text-dim); }\n.prop-val { color: #c3e88d; }\n\n.node-component-children {\n  padding: 8px 12px;\n  border-top: 1px solid var(--tag-border);\n}\n\n.node-component-children-label {\n  font-size: 10px;\n  text-transform: uppercase;\n  letter-spacing: 0.5px;\n  color: var(--text-dim);\n  margin-bottom: 6px;\n}\n\n.errors {\n  padding: 8px 16px;\n  background: rgba(255, 0, 102, 0.08);\n  border-top: 1px solid rgba(255, 0, 102, 0.2);\n}\n\n.error-item {\n  font-size: 12px;\n  color: var(--error);\n  font-family: var(--font-mono);\n  padding: 2px 0;\n}\n\n.error-item::before { content: '\\\\26A0  '; }\n\n.status-bar {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 4px 16px;\n  font-size: 11px;\n  color: var(--text-dim);\n  border-top: 1px solid var(--border);\n  background: var(--bg-surface);\n}\n\n.empty-state {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  height: 100%;\n  color: var(--text-dim);\n  font-size: 13px;\n  text-align: center;\n  line-height: 1.8;\n}\n</style>\n</head>\n<body>\n<div class=\"app\">\n  <header>\n    <h1>mdocui preview</h1>\n    <span class=\"meta\" id=\"tag-count\"></span>\n  </header>\n  <div class=\"panels\">\n    <div class=\"panel\">\n      <div class=\"panel-header\">Input</div>\n      <textarea id=\"editor\" spellcheck=\"false\" placeholder=\"Type mdocUI markup here...\n\nExample:\nHere is a **weather card**:\n\n{% WeatherCard city=&quot;San Francisco&quot; temp=72 unit=&quot;F&quot; /%}\n\nOr with body content:\n\n{% Alert type=&quot;info&quot; %}\nThis is an informational alert with **markdown** inside.\n{% /Alert %}\"></textarea>\n    </div>\n    <div class=\"panel\">\n      <div class=\"panel-header\">Preview</div>\n      <div class=\"preview\" id=\"preview\">\n        <div class=\"empty-state\">Start typing mdocUI markup<br/>to see the live preview</div>\n      </div>\n      <div class=\"errors\" id=\"errors\" style=\"display:none\"></div>\n    </div>\n  </div>\n  <div class=\"status-bar\">\n    <span id=\"status\">Ready</span>\n    <span id=\"node-count\"></span>\n  </div>\n</div>\n\n<script>\n(function() {\n  const knownTags = ${tagList};\n  const editor = document.getElementById('editor');\n  const preview = document.getElementById('preview');\n  const errors = document.getElementById('errors');\n  const status = document.getElementById('status');\n  const nodeCount = document.getElementById('node-count');\n  const tagCountEl = document.getElementById('tag-count');\n\n  if (knownTags.length > 0) {\n    tagCountEl.textContent = knownTags.length + ' registered component' + (knownTags.length === 1 ? '' : 's');\n  } else {\n    tagCountEl.textContent = 'no config — all tags accepted';\n  }\n\n  let timer = null;\n\n  editor.addEventListener('input', function() {\n    clearTimeout(timer);\n    timer = setTimeout(parse, 150);\n  });\n\n  // also handle paste\n  editor.addEventListener('paste', function() {\n    clearTimeout(timer);\n    timer = setTimeout(parse, 50);\n  });\n\n  async function parse() {\n    const content = editor.value;\n    if (!content.trim()) {\n      preview.innerHTML = '<div class=\"empty-state\">Start typing mdocUI markup<br/>to see the live preview</div>';\n      errors.style.display = 'none';\n      status.textContent = 'Ready';\n      nodeCount.textContent = '';\n      return;\n    }\n\n    status.textContent = 'Parsing...';\n\n    try {\n      const res = await fetch('/api/parse', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ content }),\n      });\n\n      const data = await res.json();\n\n      if (data.error) {\n        status.textContent = 'Error: ' + data.error;\n        return;\n      }\n\n      preview.innerHTML = renderNodes(data.nodes);\n      nodeCount.textContent = data.meta.nodeCount + ' node' + (data.meta.nodeCount === 1 ? '' : 's');\n\n      if (data.meta.errors && data.meta.errors.length > 0) {\n        errors.style.display = 'block';\n        errors.innerHTML = data.meta.errors\n          .map(function(e) { return '<div class=\"error-item\">' + escapeHtml(e.message) + '</div>'; })\n          .join('');\n        status.textContent = 'Parsed with ' + data.meta.errors.length + ' warning(s)';\n      } else {\n        errors.style.display = 'none';\n        status.textContent = 'OK';\n      }\n    } catch (err) {\n      status.textContent = 'Fetch error: ' + err.message;\n    }\n  }\n\n  function renderNodes(nodes) {\n    if (!nodes || nodes.length === 0) return '<div class=\"empty-state\">No nodes parsed</div>';\n    return nodes.map(renderNode).join('');\n  }\n\n  function renderNode(node) {\n    if (node.type === 'prose') {\n      return '<div class=\"node-prose\">' + markdownToHtml(node.content) + '</div>';\n    }\n\n    if (node.type === 'component') {\n      var html = '<div class=\"node-component\">';\n      html += '<div class=\"node-component-header\">';\n      html += '<span class=\"node-component-name\">' + escapeHtml(node.name) + '</span>';\n      if (node.selfClosing) {\n        html += '<span class=\"node-component-badge\">self-closing</span>';\n      }\n      html += '</div>';\n\n      var propKeys = Object.keys(node.props || {});\n      if (propKeys.length > 0) {\n        html += '<div class=\"node-component-props\">';\n        propKeys.forEach(function(key) {\n          var val = node.props[key];\n          var display = typeof val === 'string' ? '\"' + escapeHtml(val) + '\"' : String(val);\n          html += '<div class=\"prop-row\">';\n          html += '<span class=\"prop-key\">' + escapeHtml(key) + '</span>';\n          html += '<span class=\"prop-eq\">=</span>';\n          html += '<span class=\"prop-val\">' + display + '</span>';\n          html += '</div>';\n        });\n        html += '</div>';\n      }\n\n      if (node.children && node.children.length > 0) {\n        html += '<div class=\"node-component-children\">';\n        html += '<div class=\"node-component-children-label\">Children</div>';\n        html += renderNodes(node.children);\n        html += '</div>';\n      }\n\n      html += '</div>';\n      return html;\n    }\n\n    return '';\n  }\n\n  /** Minimal markdown-to-HTML for prose content */\n  function markdownToHtml(text) {\n    var html = escapeHtml(text);\n\n    // headings\n    html = html.replace(/^### (.+)$/gm, '<h3>$1</h3>');\n    html = html.replace(/^## (.+)$/gm, '<h2>$1</h2>');\n    html = html.replace(/^# (.+)$/gm, '<h1>$1</h1>');\n\n    // bold + italic\n    html = html.replace(/\\\\*\\\\*\\\\*(.+?)\\\\*\\\\*\\\\*/g, '<strong><em>$1</em></strong>');\n    html = html.replace(/\\\\*\\\\*(.+?)\\\\*\\\\*/g, '<strong>$1</strong>');\n    html = html.replace(/\\\\*(.+?)\\\\*/g, '<em>$1</em>');\n\n    // inline code\n    html = html.replace(/\\`([^\\`]+)\\`/g, '<code>$1</code>');\n\n    // links\n    html = html.replace(/\\\\[([^\\\\]]+)\\\\]\\\\(([^)]+)\\\\)/g, '<a href=\"$2\" target=\"_blank\">$1</a>');\n\n    // unordered lists\n    html = html.replace(/^- (.+)$/gm, '<li>$1</li>');\n    html = html.replace(/(<li>.*<\\\\/li>\\\\n?)+/g, function(m) { return '<ul>' + m + '</ul>'; });\n\n    // paragraphs: split on double newlines\n    html = html.split(/\\\\n\\\\n+/).map(function(block) {\n      block = block.trim();\n      if (!block) return '';\n      if (/^<(h[1-3]|ul|ol|li)/.test(block)) return block;\n      return '<p>' + block.replace(/\\\\n/g, '<br/>') + '</p>';\n    }).join('');\n\n    return html;\n  }\n\n  function escapeHtml(str) {\n    return String(str)\n      .replace(/&/g, '&amp;')\n      .replace(/</g, '&lt;')\n      .replace(/>/g, '&gt;')\n      .replace(/\"/g, '&quot;');\n  }\n})();\n</script>\n</body>\n</html>`\n}\n","import { generate } from './commands/generate'\nimport { init } from './commands/init'\nimport { preview } from './commands/preview'\n\nconst args = process.argv.slice(2)\nconst command = args[0]\nconst cwd = process.cwd()\n\nfunction parseFlag(flag: string): string | undefined {\n\tconst idx = args.indexOf(flag)\n\tif (idx !== -1 && idx + 1 < args.length) return args[idx + 1]\n\tconst eq = args.find((a) => a.startsWith(`${flag}=`))\n\tif (eq) return eq.split('=')[1]\n\treturn undefined\n}\n\nasync function main() {\n\tswitch (command) {\n\t\tcase 'generate':\n\t\t\tawait generate(cwd)\n\t\t\tbreak\n\t\tcase 'preview': {\n\t\t\tconst portStr = parseFlag('--port')\n\t\t\tawait preview(cwd, portStr ? { port: Number(portStr) } : undefined)\n\t\t\tbreak\n\t\t}\n\t\tcase 'init':\n\t\t\tawait init(cwd)\n\t\t\tbreak\n\t\tcase '--help':\n\t\tcase '-h':\n\t\tcase undefined:\n\t\t\tprintHelp()\n\t\t\tbreak\n\t\tdefault:\n\t\t\tconsole.error(`Unknown command: ${command}`)\n\t\t\tprintHelp()\n\t\t\tprocess.exit(1)\n\t}\n}\n\nfunction printHelp() {\n\tconsole.log(`\nmdocui — CLI for mdocUI generative UI library\n\nCommands:\n  init        Scaffold mdocUI integration (registry, components, API route)\n  generate    Generate system prompt from component registry\n  preview     Start local dev server with live mdocUI markup preview\n\nOptions:\n  --port <n>  Port for preview server (default: 4321)\n\nUsage:\n  npx @mdocui/cli init\n  npx @mdocui/cli generate\n  npx @mdocui/cli preview\n  npx @mdocui/cli preview --port 3000\n`)\n}\n\nmain().catch((err) => {\n\tconsole.error(err.message)\n\tprocess.exit(1)\n})\n"],"mappings":"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AA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAsRG,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqK7B;;;AC3fA,IAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,IAAM,UAAU,KAAK,CAAC;AACtB,IAAM,MAAM,QAAQ,IAAI;AAExB,SAAS,UAAU,MAAkC;AACpD,QAAM,MAAM,KAAK,QAAQ,IAAI;AAC7B,MAAI,QAAQ,MAAM,MAAM,IAAI,KAAK,OAAQ,QAAO,KAAK,MAAM,CAAC;AAC5D,QAAM,KAAK,KAAK,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,CAAC;AACpD,MAAI,GAAI,QAAO,GAAG,MAAM,GAAG,EAAE,CAAC;AAC9B,SAAO;AACR;AAEA,eAAe,OAAO;AACrB,UAAQ,SAAS;AAAA,IAChB,KAAK;AACJ,YAAM,SAAS,GAAG;AAClB;AAAA,IACD,KAAK,WAAW;AACf,YAAM,UAAU,UAAU,QAAQ;AAClC,YAAM,QAAQ,KAAK,UAAU,EAAE,MAAM,OAAO,OAAO,EAAE,IAAI,MAAS;AAClE;AAAA,IACD;AAAA,IACA,KAAK;AACJ,YAAM,KAAK,GAAG;AACd;AAAA,IACD,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACJ,gBAAU;AACV;AAAA,IACD;AACC,cAAQ,MAAM,oBAAoB,OAAO,EAAE;AAC3C,gBAAU;AACV,cAAQ,KAAK,CAAC;AAAA,EAChB;AACD;AAEA,SAAS,YAAY;AACpB,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAgBZ;AACD;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACrB,UAAQ,MAAM,IAAI,OAAO;AACzB,UAAQ,KAAK,CAAC;AACf,CAAC;","names":["fs","path","cwd","cwd","path","fs","fs","path","cwd","cwd"]}

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@mdocui/cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "CLI for mdocUI — scaffold, generate system prompts, preview",
   "type": "module",
   "bin": {
     "mdocui": "./dist/index.js"
   },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -13,13 +19,14 @@
   ],
   "dependencies": {
     "zod": "^4.3.0",
-    "@mdocui/core": "0.5.0"
+    "@mdocui/core": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
     "tsup": "^8.5.1",
     "vitest": "^4.1.0"
   },
+  "homepage": "https://mdocui.github.io",
   "license": "MIT",
   "repository": {
     "type": "git",