@mdocui/cli 0.0.1 → 0.4.0

package/README.md

@@ -0,0 +1,79 @@
+# @mdocui/cli
+
+CLI for [mdocUI](https://github.com/mdocui/mdocui) — scaffold projects, generate system prompts, and preview output.
+
+## Install
+
+```bash
+npx @mdocui/cli init
+```
+
+Or install globally:
+
+```bash
+pnpm add -g @mdocui/cli
+```
+
+## Commands
+
+### `init`
+
+Scaffold a new mdocUI config file with starter components.
+
+```bash
+npx @mdocui/cli init
+```
+
+Creates:
+- `mdocui.config.ts` — component definitions and config
+- `generated/` — output directory for system prompts
+
+### `generate`
+
+Generate a system prompt from your component registry and write it to a file.
+
+```bash
+npx @mdocui/cli generate
+```
+
+Reads `mdocui.config.ts` and writes the prompt to the configured `output` path (default: `system-prompt.txt`).
+
+### `preview`
+
+Print the generated system prompt to stdout for review.
+
+```bash
+npx @mdocui/cli preview
+```
+
+## Config File
+
+```typescript
+// mdocui.config.ts
+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',
+})
+
+export default {
+  components: [button],
+  output: './generated/system-prompt.txt',
+  preamble: 'You are a helpful assistant.',
+  additionalRules: ['End responses with follow-up buttons'],
+  groups: [{ name: 'Interactive', components: ['button'] }],
+}
+```
+
+## Links
+
+- [GitHub Repository](https://github.com/mdocui/mdocui)
+- [@mdocui/core](https://github.com/mdocui/mdocui/tree/main/packages/core)
+- [@mdocui/react](https://github.com/mdocui/mdocui/tree/main/packages/react)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+
+// src/commands/generate.ts
+import fs2 from "fs";
+import path2 from "path";
+import { ComponentRegistry, generatePrompt } from "@mdocui/core";
+
+// src/config.ts
+import { pathToFileURL } from "url";
+import path from "path";
+import fs from "fs";
+var CONFIG_FILES = [
+  "mdocui.config.ts",
+  "mdocui.config.js",
+  "mdocui.config.mjs"
+];
+async function loadConfig(cwd2) {
+  for (const name of CONFIG_FILES) {
+    const configPath = path.resolve(cwd2, name);
+    if (!fs.existsSync(configPath)) continue;
+    const url = pathToFileURL(configPath).href;
+    const mod = await import(url);
+    const config = mod.default ?? mod;
+    if (!config.components || !Array.isArray(config.components)) {
+      throw new Error(`${name}: "components" must be an array of ComponentDefinition`);
+    }
+    return config;
+  }
+  throw new Error(
+    `No config file found. Create one of: ${CONFIG_FILES.join(", ")}`
+  );
+}
+function toPromptOptions(config) {
+  return {
+    preamble: config.preamble,
+    additionalRules: config.additionalRules,
+    examples: config.examples,
+    groups: config.groups
+  };
+}
+
+// src/commands/generate.ts
+async function generate(cwd2) {
+  const config = await loadConfig(cwd2);
+  const registry = new ComponentRegistry();
+  registry.registerAll(config.components);
+  const prompt = generatePrompt(registry, toPromptOptions(config));
+  const outputPath = path2.resolve(cwd2, config.output ?? "system-prompt.txt");
+  fs2.mkdirSync(path2.dirname(outputPath), { recursive: true });
+  fs2.writeFileSync(outputPath, prompt, "utf-8");
+  console.log(`Generated system prompt \u2192 ${path2.relative(cwd2, outputPath)}`);
+  console.log(`${registry.names().length} components, ${prompt.length} chars`);
+}
+
+// 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',
+})
+
+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',
+})
+
+export default {
+  components: [button, callout],
+  output: './generated/system-prompt.txt',
+  preamble: 'You are a helpful assistant.',
+  additionalRules: [
+    'End responses with follow-up buttons using action="continue"',
+  ],
+}
+`;
+async function init(cwd2) {
+  const configPath = path3.resolve(cwd2, "mdocui.config.ts");
+  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");
+  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");
+}
+
+// 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);
+}
+
+// src/index.ts
+var args = process.argv.slice(2);
+var command = args[0];
+var cwd = process.cwd();
+async function main() {
+  switch (command) {
+    case "generate":
+      await generate(cwd);
+      break;
+    case "preview":
+      await preview(cwd);
+      break;
+    case "init":
+      await init(cwd);
+      break;
+    case "--help":
+    case "-h":
+    case void 0:
+      printHelp();
+      break;
+    default:
+      console.error(`Unknown command: ${command}`);
+      printHelp();
+      process.exit(1);
+  }
+}
+function printHelp() {
+  console.log(`
+mdocui \u2014 CLI for mdocUI generative UI library
+
+Commands:
+  init        Scaffold a new mdocui config file
+  generate    Generate system prompt from component registry
+  preview     Print generated system prompt to stdout
+
+Usage:
+  npx @mdocui/cli init
+  npx @mdocui/cli generate
+  npx @mdocui/cli preview
+`);
+}
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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 { pathToFileURL } from 'node:url'\nimport path from 'node:path'\nimport fs from 'node:fs'\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 = [\n\t'mdocui.config.ts',\n\t'mdocui.config.js',\n\t'mdocui.config.mjs',\n]\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(\n\t\t`No config file found. Create one of: ${CONFIG_FILES.join(', ')}`,\n\t)\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(\n\t\tpath.resolve(generatedDir, '.gitkeep'),\n\t\t'',\n\t\t'utf-8',\n\t)\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"]}

package/package.json

@@ -1,16 +1,24 @@
 {
   "name": "@mdocui/cli",
-  "version": "0.0.1",
+  "version": "0.4.0",
   "description": "CLI for mdocUI — scaffold, generate system prompts, preview",
   "type": "module",
   "bin": {
     "mdocui": "./dist/index.js"
   },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@mdocui/core": "0.1.2"
+    "zod": "^4.3.0",
+    "@mdocui/core": "0.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsup": "^8.5.1",
+    "vitest": "^4.1.0"
   },
   "license": "MIT",
   "repository": {
@@ -22,7 +30,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "echo 'stub — no build yet'",
+    "build": "tsup",
+    "test": "vitest run",
     "clean": "rm -rf dist"
   }
 }