@expcat/tigercat-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yizhe Wang
+
+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,53 @@
+# @expcat/tigercat-cli
+
+CLI tooling for the [Tigercat](https://github.com/expcats/Tigercat) UI component library.
+
+## Installation
+
+```bash
+pnpm add -g @expcat/tigercat-cli
+# or
+npx @expcat/tigercat-cli
+```
+
+## Commands
+
+### `tigercat create <name>`
+
+Create a new project with Tigercat pre-configured.
+
+```bash
+tigercat create my-app --template vue3
+tigercat create my-app --template react
+```
+
+### `tigercat add <component>`
+
+Add a component to your project with import boilerplate.
+
+```bash
+tigercat add Button
+tigercat add Form Input Select DatePicker
+```
+
+### `tigercat playground`
+
+Launch an interactive playground for testing components.
+
+```bash
+tigercat playground
+tigercat playground --template react
+```
+
+### `tigercat generate docs`
+
+Generate API documentation from component type definitions.
+
+```bash
+tigercat generate docs
+tigercat generate docs --output ./docs/api
+```
+
+## License
+
+MIT

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,790 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import prompts from 'prompts';
+import { existsSync, readdirSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { resolve, join, dirname, basename } from 'path';
+import pc from 'picocolors';
+import { execSync } from 'child_process';
+
+// src/constants.ts
+var CLI_NAME = "tigercat";
+var CLI_VERSION = "0.9.0";
+var TEMPLATES = ["vue3", "react"];
+var COMPONENT_CATEGORIES = {
+  basic: [
+    "Alert",
+    "Avatar",
+    "AvatarGroup",
+    "Badge",
+    "Button",
+    "ButtonGroup",
+    "Code",
+    "Divider",
+    "Icon",
+    "Link",
+    "Tag",
+    "Text"
+  ],
+  form: [
+    "Checkbox",
+    "DatePicker",
+    "Form",
+    "Input",
+    "InputNumber",
+    "Radio",
+    "Select",
+    "Slider",
+    "Switch",
+    "Textarea",
+    "TimePicker",
+    "Upload"
+  ],
+  feedback: [
+    "Drawer",
+    "Loading",
+    "Message",
+    "Modal",
+    "Notification",
+    "Popconfirm",
+    "Popover",
+    "Progress",
+    "Tooltip"
+  ],
+  layout: ["Card", "Container", "Descriptions", "Grid", "Layout", "List", "Skeleton", "Space"],
+  navigation: ["Breadcrumb", "Dropdown", "Menu", "Pagination", "Steps", "Tabs", "Tree"],
+  data: ["Table", "Timeline"],
+  charts: [
+    "AreaChart",
+    "BarChart",
+    "DonutChart",
+    "LineChart",
+    "PieChart",
+    "RadarChart",
+    "ScatterChart"
+  ]
+};
+var ALL_COMPONENTS = Object.values(COMPONENT_CATEGORIES).flat();
+function logSuccess(msg) {
+  console.log(pc.green("\u2714") + " " + msg);
+}
+function logInfo(msg) {
+  console.log(pc.blue("\u2139") + " " + msg);
+}
+function logWarn(msg) {
+  console.log(pc.yellow("\u26A0") + " " + msg);
+}
+function logError(msg) {
+  console.error(pc.red("\u2716") + " " + msg);
+}
+function logStep(step, total, msg) {
+  console.log(pc.dim(`[${step}/${total}]`) + " " + msg);
+}
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function writeFileSafe(filePath, content) {
+  ensureDir(dirname(filePath));
+  writeFileSync(filePath, content, "utf-8");
+}
+function isDirEmpty(dir) {
+  if (!existsSync(dir)) return true;
+  return readdirSync(dir).length === 0;
+}
+function readFileSafe(filePath) {
+  if (!existsSync(filePath)) return null;
+  return readFileSync(filePath, "utf-8");
+}
+
+// src/templates/vue3.ts
+function getVue3Template(projectName) {
+  return {
+    "package.json": vue3PackageJson(projectName),
+    "tsconfig.json": vue3Tsconfig(),
+    "vite.config.ts": vue3ViteConfig(),
+    "index.html": vue3IndexHtml(projectName),
+    "src/main.ts": vue3Main(),
+    "src/App.vue": vue3App(),
+    "src/style.css": commonStyleCss(),
+    "src/env.d.ts": vue3EnvDts()
+  };
+}
+function vue3PackageJson(name) {
+  return JSON.stringify(
+    {
+      name,
+      version: "0.0.1",
+      private: true,
+      type: "module",
+      scripts: {
+        dev: "vite",
+        build: "vue-tsc && vite build",
+        preview: "vite preview"
+      },
+      dependencies: {
+        "@expcat/tigercat-vue": "^0.9.0",
+        vue: "^3.5.26"
+      },
+      devDependencies: {
+        "@tailwindcss/vite": "^4.1.18",
+        "@vitejs/plugin-vue": "^6.0.3",
+        "@vue/tsconfig": "^0.7.0",
+        tailwindcss: "^4.1.18",
+        typescript: "^5.9.3",
+        vite: "^7.3.0",
+        "vue-tsc": "^2.2.0"
+      }
+    },
+    null,
+    2
+  );
+}
+function vue3Tsconfig() {
+  return JSON.stringify(
+    {
+      extends: "@vue/tsconfig/tsconfig.dom.json",
+      compilerOptions: {
+        target: "ES2020",
+        module: "ESNext",
+        lib: ["ES2020", "DOM", "DOM.Iterable"],
+        skipLibCheck: true,
+        moduleResolution: "bundler",
+        resolveJsonModule: true,
+        isolatedModules: true,
+        jsx: "preserve",
+        strict: true,
+        noUnusedLocals: true,
+        noUnusedParameters: true,
+        noFallthroughCasesInSwitch: true,
+        baseUrl: ".",
+        paths: {
+          "@/*": ["./src/*"]
+        }
+      },
+      include: ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"],
+      exclude: ["node_modules"]
+    },
+    null,
+    2
+  );
+}
+function vue3ViteConfig() {
+  return `import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import tailwindcss from '@tailwindcss/vite'
+
+export default defineConfig({
+  plugins: [vue(), tailwindcss()]
+})
+`;
+}
+function vue3IndexHtml(name) {
+  return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>
+`;
+}
+function vue3Main() {
+  return `import { createApp } from 'vue'
+import App from './App.vue'
+import './style.css'
+
+createApp(App).mount('#app')
+`;
+}
+function vue3App() {
+  return `<script setup lang="ts">
+import { Button, Alert } from '@expcat/tigercat-vue'
+</script>
+
+<template>
+  <div class="min-h-screen bg-[var(--tiger-surface,#ffffff)] p-8">
+    <h1 class="text-2xl font-bold text-[var(--tiger-text,#111827)] mb-6">
+      Tigercat + Vue 3
+    </h1>
+
+    <div class="space-y-4">
+      <Alert variant="info">
+        Welcome to your Tigercat project! Edit src/App.vue to get started.
+      </Alert>
+
+      <div class="flex gap-2">
+        <Button variant="primary">Primary</Button>
+        <Button variant="secondary">Secondary</Button>
+        <Button variant="outline">Outline</Button>
+      </div>
+    </div>
+  </div>
+</template>
+`;
+}
+function vue3EnvDts() {
+  return `/// <reference types="vite/client" />
+
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue'
+  const component: DefineComponent<{}, {}, any>
+  export default component
+}
+`;
+}
+function commonStyleCss() {
+  return `@import "tailwindcss";
+
+:root {
+  --tiger-primary: #2563eb;
+  --tiger-primary-hover: #1d4ed8;
+  --tiger-surface: #ffffff;
+  --tiger-surface-muted: #f9fafb;
+  --tiger-text: #111827;
+  --tiger-text-muted: #6b7280;
+  --tiger-border: #e5e7eb;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --tiger-primary: #3b82f6;
+    --tiger-primary-hover: #2563eb;
+    --tiger-surface: #111827;
+    --tiger-surface-muted: #1f2937;
+    --tiger-text: #f9fafb;
+    --tiger-text-muted: #9ca3af;
+    --tiger-border: #374151;
+  }
+
+  html {
+    color-scheme: dark;
+  }
+}
+`;
+}
+
+// src/templates/react.ts
+function getReactTemplate(projectName) {
+  return {
+    "package.json": reactPackageJson(projectName),
+    "tsconfig.json": reactTsconfig(),
+    "tsconfig.node.json": reactTsconfigNode(),
+    "vite.config.ts": reactViteConfig(),
+    "index.html": reactIndexHtml(projectName),
+    "src/main.tsx": reactMain(),
+    "src/App.tsx": reactApp(),
+    "src/style.css": commonStyleCss2()
+  };
+}
+function reactPackageJson(name) {
+  return JSON.stringify(
+    {
+      name,
+      version: "0.0.1",
+      private: true,
+      type: "module",
+      scripts: {
+        dev: "vite",
+        build: "tsc && vite build",
+        preview: "vite preview"
+      },
+      dependencies: {
+        "@expcat/tigercat-react": "^0.9.0",
+        react: "^19.2.3",
+        "react-dom": "^19.2.3"
+      },
+      devDependencies: {
+        "@tailwindcss/vite": "^4.1.18",
+        "@types/react": "^19.2.7",
+        "@types/react-dom": "^19.2.2",
+        "@vitejs/plugin-react": "^4.3.4",
+        tailwindcss: "^4.1.18",
+        typescript: "^5.9.3",
+        vite: "^7.3.0"
+      }
+    },
+    null,
+    2
+  );
+}
+function reactTsconfig() {
+  return JSON.stringify(
+    {
+      compilerOptions: {
+        target: "ES2020",
+        useDefineForClassFields: true,
+        lib: ["ES2020", "DOM", "DOM.Iterable"],
+        module: "ESNext",
+        skipLibCheck: true,
+        moduleResolution: "bundler",
+        allowImportingTsExtensions: true,
+        resolveJsonModule: true,
+        isolatedModules: true,
+        noEmit: true,
+        jsx: "react-jsx",
+        strict: true,
+        noUnusedLocals: true,
+        noUnusedParameters: true,
+        noFallthroughCasesInSwitch: true,
+        forceConsistentCasingInFileNames: true,
+        baseUrl: ".",
+        paths: {
+          "@/*": ["./src/*"]
+        }
+      },
+      include: ["src"],
+      references: [{ path: "./tsconfig.node.json" }]
+    },
+    null,
+    2
+  );
+}
+function reactTsconfigNode() {
+  return JSON.stringify(
+    {
+      compilerOptions: {
+        composite: true,
+        skipLibCheck: true,
+        module: "ESNext",
+        moduleResolution: "bundler",
+        allowSyntheticDefaultImports: true
+      },
+      include: ["vite.config.ts"]
+    },
+    null,
+    2
+  );
+}
+function reactViteConfig() {
+  return `import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+
+export default defineConfig({
+  plugins: [react(), tailwindcss()]
+})
+`;
+}
+function reactIndexHtml(name) {
+  return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`;
+}
+function reactMain() {
+  return `import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import App from './App'
+import './style.css'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>
+)
+`;
+}
+function reactApp() {
+  return `import { Button, Alert } from '@expcat/tigercat-react'
+
+export default function App() {
+  return (
+    <div className="min-h-screen bg-[var(--tiger-surface,#ffffff)] p-8">
+      <h1 className="text-2xl font-bold text-[var(--tiger-text,#111827)] mb-6">
+        Tigercat + React
+      </h1>
+
+      <div className="space-y-4">
+        <Alert variant="info">
+          Welcome to your Tigercat project! Edit src/App.tsx to get started.
+        </Alert>
+
+        <div className="flex gap-2">
+          <Button variant="primary">Primary</Button>
+          <Button variant="secondary">Secondary</Button>
+          <Button variant="outline">Outline</Button>
+        </div>
+      </div>
+    </div>
+  )
+}
+`;
+}
+function commonStyleCss2() {
+  return `@import "tailwindcss";
+
+:root {
+  --tiger-primary: #2563eb;
+  --tiger-primary-hover: #1d4ed8;
+  --tiger-surface: #ffffff;
+  --tiger-surface-muted: #f9fafb;
+  --tiger-text: #111827;
+  --tiger-text-muted: #6b7280;
+  --tiger-border: #e5e7eb;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --tiger-primary: #3b82f6;
+    --tiger-primary-hover: #2563eb;
+    --tiger-surface: #111827;
+    --tiger-surface-muted: #1f2937;
+    --tiger-text: #f9fafb;
+    --tiger-text-muted: #9ca3af;
+    --tiger-border: #374151;
+  }
+
+  html {
+    color-scheme: dark;
+  }
+}
+`;
+}
+
+// src/commands/create.ts
+function createCreateCommand() {
+  return new Command("create").argument("<name>", "Project name").option("-t, --template <template>", "Project template (vue3 | react)").description("Create a new project with Tigercat pre-configured").action(async (name, opts) => {
+    await runCreate(name, opts.template);
+  });
+}
+async function runCreate(name, templateArg) {
+  let template;
+  if (templateArg && TEMPLATES.includes(templateArg)) {
+    template = templateArg;
+  } else {
+    const response = await prompts({
+      type: "select",
+      name: "template",
+      message: "Select a framework",
+      choices: [
+        { title: "Vue 3", value: "vue3" },
+        { title: "React", value: "react" }
+      ]
+    });
+    if (!response.template) {
+      logError("Operation cancelled");
+      process.exit(1);
+    }
+    template = response.template;
+  }
+  const targetDir = resolve(process.cwd(), name);
+  if (existsSync(targetDir) && !isDirEmpty(targetDir)) {
+    const { overwrite } = await prompts({
+      type: "confirm",
+      name: "overwrite",
+      message: `Directory "${name}" is not empty. Remove existing files and continue?`,
+      initial: false
+    });
+    if (!overwrite) {
+      logError("Operation cancelled");
+      process.exit(1);
+    }
+  }
+  logInfo(`Creating ${template} project in ${targetDir}...`);
+  const files = template === "vue3" ? getVue3Template(name) : getReactTemplate(name);
+  const totalSteps = Object.keys(files).length;
+  let step = 0;
+  ensureDir(targetDir);
+  for (const [filePath, content] of Object.entries(files)) {
+    step++;
+    logStep(step, totalSteps, filePath);
+    writeFileSafe(resolve(targetDir, filePath), content);
+  }
+  logSuccess(`Project "${name}" created successfully!
+`);
+  logInfo("Next steps:\n");
+  console.log(`  cd ${name}`);
+  console.log("  pnpm install");
+  console.log("  pnpm dev\n");
+}
+function createAddCommand() {
+  return new Command("add").argument("<components...>", "Component names to add (e.g. Button Input Select)").description("Add component import boilerplate to your project").action(async (components) => {
+    await runAdd(components);
+  });
+}
+function detectFramework(cwd) {
+  const pkg = readFileSafe(join(cwd, "package.json"));
+  if (!pkg) return null;
+  try {
+    const parsed = JSON.parse(pkg);
+    const allDeps = { ...parsed.dependencies, ...parsed.devDependencies };
+    if ("@expcat/tigercat-vue" in allDeps || "vue" in allDeps) return "vue3";
+    if ("@expcat/tigercat-react" in allDeps || "react" in allDeps) return "react";
+  } catch {
+  }
+  return null;
+}
+function validateComponents(names) {
+  const valid = [];
+  const invalid = [];
+  for (const name of names) {
+    const match = ALL_COMPONENTS.find((c) => c.toLowerCase() === name.toLowerCase());
+    if (match) {
+      valid.push(match);
+    } else {
+      invalid.push(name);
+    }
+  }
+  return { valid, invalid };
+}
+async function runAdd(components) {
+  const cwd = process.cwd();
+  const framework = detectFramework(cwd);
+  if (!framework) {
+    logError(
+      "Could not detect framework. Make sure you are in a project with @expcat/tigercat-vue or @expcat/tigercat-react installed."
+    );
+    process.exit(1);
+  }
+  const { valid, invalid } = validateComponents(components);
+  if (invalid.length > 0) {
+    logWarn(`Unknown components: ${invalid.join(", ")}`);
+    logInfo(`Available: ${ALL_COMPONENTS.join(", ")}`);
+  }
+  if (valid.length === 0) {
+    logError("No valid components specified");
+    process.exit(1);
+  }
+  const pkgName = framework === "vue3" ? "@expcat/tigercat-vue" : "@expcat/tigercat-react";
+  const importLine = `import { ${valid.join(", ")} } from '${pkgName}'`;
+  logSuccess(`Add this import to your project:
+`);
+  console.log(`  ${importLine}
+`);
+  if (framework === "vue3") {
+    logInfo("Vue 3 usage example:\n");
+    for (const comp of valid) {
+      console.log(`  <${comp} />`);
+    }
+  } else {
+    logInfo("React usage example:\n");
+    for (const comp of valid) {
+      console.log(`  <${comp} />`);
+    }
+  }
+  console.log();
+  const sampleDir = resolve(cwd, "src", "components");
+  if (!existsSync(sampleDir)) {
+    return;
+  }
+  for (const comp of valid) {
+    const ext = framework === "vue3" ? "vue" : "tsx";
+    const sampleFile = join(sampleDir, `${comp}Demo.${ext}`);
+    if (existsSync(sampleFile)) {
+      logWarn(`${sampleFile} already exists, skipping`);
+      continue;
+    }
+    const content = framework === "vue3" ? generateVue3Demo(comp, pkgName) : generateReactDemo(comp, pkgName);
+    writeFileSafe(sampleFile, content);
+    logSuccess(`Created ${sampleFile}`);
+  }
+}
+function generateVue3Demo(component, pkg) {
+  return `<script setup lang="ts">
+import { ${component} } from '${pkg}'
+</script>
+
+<template>
+  <div class="p-4">
+    <h2 class="text-lg font-semibold mb-4">${component} Demo</h2>
+    <${component} />
+  </div>
+</template>
+`;
+}
+function generateReactDemo(component, pkg) {
+  return `import { ${component} } from '${pkg}'
+
+export default function ${component}Demo() {
+  return (
+    <div className="p-4">
+      <h2 className="text-lg font-semibold mb-4">${component} Demo</h2>
+      <${component} />
+    </div>
+  )
+}
+`;
+}
+function createPlaygroundCommand() {
+  return new Command("playground").option("-t, --template <template>", "Framework template (vue3 | react)").option("-p, --port <port>", "Dev server port", "3456").description("Launch an interactive playground for testing components").action(async (opts) => {
+    await runPlayground(opts.template, opts.port);
+  });
+}
+async function runPlayground(templateArg, port = "3456") {
+  let template;
+  if (templateArg && TEMPLATES.includes(templateArg)) {
+    template = templateArg;
+  } else {
+    const response = await prompts({
+      type: "select",
+      name: "template",
+      message: "Select a framework for playground",
+      choices: [
+        { title: "Vue 3", value: "vue3" },
+        { title: "React", value: "react" }
+      ]
+    });
+    if (!response.template) {
+      logError("Operation cancelled");
+      process.exit(1);
+    }
+    template = response.template;
+  }
+  const tmpDir = resolve(process.cwd(), ".tigercat-playground");
+  const projectDir = join(tmpDir, `playground-${template}`);
+  if (!existsSync(projectDir)) {
+    logInfo(`Setting up ${template} playground...`);
+    const files = template === "vue3" ? getVue3Template("playground") : getReactTemplate("playground");
+    ensureDir(projectDir);
+    const totalSteps = Object.keys(files).length;
+    let step = 0;
+    for (const [filePath, content] of Object.entries(files)) {
+      step++;
+      logStep(step, totalSteps, filePath);
+      writeFileSafe(resolve(projectDir, filePath), content);
+    }
+    logInfo("Installing dependencies...");
+    try {
+      execSync("pnpm install", { cwd: projectDir, stdio: "inherit" });
+    } catch {
+      logError("Failed to install dependencies. Make sure pnpm is available.");
+      process.exit(1);
+    }
+  }
+  logSuccess(`Starting playground on port ${port}...
+`);
+  try {
+    const safePort = /^\d+$/.test(port) ? port : "3456";
+    execSync(`npx vite --port ${safePort}`, { cwd: projectDir, stdio: "inherit" });
+  } catch {
+  }
+}
+function createGenerateCommand() {
+  const cmd = new Command("generate").description("Code generation utilities");
+  cmd.command("docs").option("-i, --input <dir>", "Types directory", "packages/core/src/types").option("-o, --output <dir>", "Output directory", "docs/api").description("Generate API documentation from component type definitions").action(async (opts) => {
+    await runGenerateDocs(opts.input, opts.output);
+  });
+  return cmd;
+}
+function parseTypeFile(filePath) {
+  const content = readFileSync(filePath, "utf-8");
+  const fileName = basename(filePath, ".ts");
+  const interfaceRegex = /export\s+(?:interface|type)\s+(\w+Props)\s*(?:=\s*\{|(?:extends\s+[\w<>,\s]+)?\s*\{)/g;
+  const match = interfaceRegex.exec(content);
+  if (!match) return null;
+  const interfaceName = match[0];
+  const componentName = match[1].replace(/Props$/, "");
+  const startIdx = content.indexOf(interfaceName) + interfaceName.length;
+  let braceCount = 1;
+  let endIdx = startIdx;
+  for (let i = startIdx; i < content.length && braceCount > 0; i++) {
+    if (content[i] === "{") braceCount++;
+    if (content[i] === "}") braceCount--;
+    endIdx = i;
+  }
+  const body = content.slice(startIdx, endIdx);
+  const props = [];
+  const propRegex = /(?:\/\*\*\s*(.*?)\s*\*\/\s*)?(?:\/\/\s*(.*?)\s*\n\s*)?(\w+)(\?)?\s*:\s*([^;\n]+)/g;
+  let propMatch;
+  while ((propMatch = propRegex.exec(body)) !== null) {
+    const description = propMatch[1] || propMatch[2] || "";
+    const name = propMatch[3];
+    const required = !propMatch[4];
+    const type = propMatch[5].trim();
+    props.push({ name, type, required, description });
+  }
+  return { name: componentName, props, fileName };
+}
+function generateMarkdown(doc) {
+  const lines = [];
+  lines.push(`# ${doc.name}`);
+  lines.push("");
+  lines.push(`Source: \`${doc.fileName}.ts\``);
+  lines.push("");
+  if (doc.props.length > 0) {
+    lines.push("## Props");
+    lines.push("");
+    lines.push("| Prop | Type | Required | Description |");
+    lines.push("| ---- | ---- | -------- | ----------- |");
+    for (const prop of doc.props) {
+      const req = prop.required ? "\u2705" : "\u2014";
+      const desc = prop.description || "\u2014";
+      const type = prop.type.replace(/\|/g, "\\|");
+      lines.push(`| \`${prop.name}\` | \`${type}\` | ${req} | ${desc} |`);
+    }
+    lines.push("");
+  } else {
+    lines.push("_No props extracted._");
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+async function runGenerateDocs(inputDir, outputDir) {
+  const resolvedInput = resolve(process.cwd(), inputDir);
+  const resolvedOutput = resolve(process.cwd(), outputDir);
+  if (!existsSync(resolvedInput)) {
+    logError(`Input directory not found: ${resolvedInput}`);
+    process.exit(1);
+  }
+  const files = readdirSync(resolvedInput).filter((f) => f.endsWith(".ts") && f !== "index.ts").sort();
+  logInfo(`Found ${files.length} type files in ${inputDir}`);
+  ensureDir(resolvedOutput);
+  const docs = [];
+  let step = 0;
+  for (const file of files) {
+    step++;
+    logStep(step, files.length, file);
+    const doc = parseTypeFile(join(resolvedInput, file));
+    if (doc) {
+      docs.push(doc);
+      const md = generateMarkdown(doc);
+      writeFileSafe(join(resolvedOutput, `${doc.fileName}.md`), md);
+    }
+  }
+  const indexLines = [
+    "# Tigercat API Reference",
+    "",
+    `Generated from ${files.length} type files.`,
+    ""
+  ];
+  const grouped = /* @__PURE__ */ new Map();
+  for (const doc of docs) {
+    const initial = doc.name[0].toUpperCase();
+    if (!grouped.has(initial)) grouped.set(initial, []);
+    grouped.get(initial).push(doc);
+  }
+  for (const [letter, comps] of [...grouped.entries()].sort()) {
+    indexLines.push(`## ${letter}`);
+    indexLines.push("");
+    for (const comp of comps) {
+      indexLines.push(`- [${comp.name}](./${comp.fileName}.md) \u2014 ${comp.props.length} props`);
+    }
+    indexLines.push("");
+  }
+  writeFileSafe(join(resolvedOutput, "index.md"), indexLines.join("\n"));
+  logSuccess(`Generated docs for ${docs.length} components in ${outputDir}`);
+}
+
+// src/index.ts
+var program = new Command();
+program.name(CLI_NAME).description("CLI tooling for Tigercat UI library").version(CLI_VERSION);
+program.addCommand(createCreateCommand());
+program.addCommand(createAddCommand());
+program.addCommand(createPlaygroundCommand());
+program.addCommand(createGenerateCommand());
+program.parse();

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@expcat/tigercat-cli",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "CLI tooling for Tigercat UI library — project scaffolding, component generation, and more",
+  "license": "MIT",
+  "author": "Yizhe Wang",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/expcats/Tigercat.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/expcats/Tigercat#readme",
+  "bugs": {
+    "url": "https://github.com/expcats/Tigercat/issues"
+  },
+  "keywords": [
+    "tigercat",
+    "ui",
+    "cli",
+    "scaffolding",
+    "code-generator"
+  ],
+  "bin": {
+    "tigercat": "./dist/index.mjs"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "prompts": "^2.4.2",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "clean": "node ../../scripts/rimraf.mjs dist"
+  }
+}