paperlamp 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 peach0x33a
+
+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

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# paperlamp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+纸灯 / Paperlamp 的命令行工具：把组件源码复制进你的 Vue 3 + Tailwind CSS v4 项目，源码归你所有、随你修改。
+
+文档与组件一览：<https://peach0x33a.github.io/paperlamp/>
+
+```bash
+npx paperlamp@latest init              # 写入主题、cn() 工具与 paperlamp.json，并安装依赖
+npx paperlamp@latest add button card   # 复制组件及其依赖的组件
+npx paperlamp@latest list              # 列出全部组件
+```
+
+在文档站的「构建」页调好基色、主题色、字体与圆角后，用 `init --preset <code>` 应用。

package/dist/index.js

@@ -0,0 +1,512 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import process from "node:process";
+// package.json
+var package_default = {
+  name: "paperlamp",
+  version: "0.1.1",
+  description: "纸灯 / Paperlamp CLI — copy Paperlamp Vue components into your project",
+  license: "MIT",
+  type: "module",
+  bin: {
+    paperlamp: "dist/index.js"
+  },
+  files: [
+    "dist"
+  ],
+  engines: {
+    node: ">=18.17"
+  },
+  keywords: [
+    "vue",
+    "components",
+    "tailwindcss",
+    "reka-ui",
+    "design-system",
+    "cli"
+  ],
+  repository: {
+    type: "git",
+    url: "git+https://github.com/peach0x33a/paperlamp.git",
+    directory: "packages/cli"
+  },
+  scripts: {
+    build: "bun build src/index.ts --target node --outfile dist/index.js"
+  },
+  homepage: "https://peach0x33a.github.io/paperlamp/"
+};
+
+// src/preset.ts
+var RADII = [
+  { name: "none", label: "直角", value: "0px" },
+  { name: "small", label: "小", value: "4px" },
+  { name: "default", label: "默认", value: "8px" },
+  { name: "medium", label: "中", value: "10px" },
+  { name: "large", label: "大", value: "14px" }
+];
+var scale = (s) => s.split(" ");
+var [s50, s100, s200, , s400, s500, , , s800, s900, s950] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+var BASES = [
+  { name: "paper", label: "纸白", swatch: "#2C2C2C", scale: null },
+  { name: "zinc", label: "锌灰", swatch: "#71717A", scale: scale("#FAFAFA #F4F4F5 #E4E4E7 #D4D4D8 #A1A1AA #71717A #52525B #3F3F46 #27272A #18181B #09090B") },
+  { name: "stone", label: "石色", swatch: "#78716C", scale: scale("#FAFAF9 #F5F5F4 #E7E5E4 #D6D3D1 #A8A29E #78716C #57534E #44403C #292524 #1C1917 #0C0A09") },
+  { name: "slate", label: "板岩", swatch: "#64748B", scale: scale("#F8FAFC #F1F5F9 #E2E8F0 #CBD5E1 #94A3B8 #64748B #475569 #334155 #1E293B #0F172A #020617") },
+  { name: "neutral", label: "中性", swatch: "#737373", scale: scale("#FAFAFA #F5F5F5 #E5E5E5 #D4D4D4 #A3A3A3 #737373 #525252 #404040 #262626 #171717 #0A0A0A") }
+];
+var THEMES = [
+  { name: "ink", label: "墨色", swatch: "#2C2C2C", light: null, dark: null },
+  { name: "indigo", label: "靛蓝", swatch: "#4F46E5", light: ["#4F46E5", "#FFFFFF"], dark: ["#818CF8", "#1E1B4B"] },
+  { name: "blue", label: "蓝", swatch: "#2563EB", light: ["#2563EB", "#FFFFFF"], dark: ["#60A5FA", "#172554"] },
+  { name: "teal", label: "青绿", swatch: "#0D9488", light: ["#0D9488", "#FFFFFF"], dark: ["#2DD4BF", "#042F2E"] },
+  { name: "green", label: "绿", swatch: "#16A34A", light: ["#16A34A", "#FFFFFF"], dark: ["#4ADE80", "#052E16"] },
+  { name: "amber", label: "琥珀", swatch: "#F59E0B", light: ["#F59E0B", "#451A03"], dark: ["#FBBF24", "#451A03"] },
+  { name: "rose", label: "玫红", swatch: "#E11D48", light: ["#E11D48", "#FFFFFF"], dark: ["#FB7185", "#4C0519"] },
+  { name: "violet", label: "紫", swatch: "#7C3AED", light: ["#7C3AED", "#FFFFFF"], dark: ["#A78BFA", "#2E1065"] }
+];
+var FONTS = [
+  { name: "wenkai", label: "霞鹜文楷", value: null },
+  { name: "sans", label: "黑体", value: `system-ui, -apple-system, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Noto Sans SC", sans-serif` },
+  { name: "song", label: "宋体", value: `"Noto Serif SC", "Source Han Serif SC", "Songti SC", STSong, "SimSun", serif` }
+];
+var DEFAULT_PRESET = { radius: "default", base: "paper", theme: "ink", font: "wenkai" };
+var VERSION = "a";
+var FIELDS = [
+  { key: "radius", options: RADII.map((r) => r.name) },
+  { key: "base", options: BASES.map((b) => b.name) },
+  { key: "theme", options: THEMES.map((t) => t.name) },
+  { key: "font", options: FONTS.map((f) => f.name) }
+];
+function encodePreset(p) {
+  return VERSION + FIELDS.map((f) => Math.max(0, f.options.indexOf(p[f.key])).toString(36)).join("");
+}
+function decodePreset(code) {
+  const c = code.trim().replace(/^--preset[=\s]+/, "");
+  if (!c.startsWith(VERSION) || !/^[a-z][0-9a-z]*$/.test(c) || c.length > FIELDS.length + 1)
+    return null;
+  const out = { ...DEFAULT_PRESET };
+  for (const [i, f] of FIELDS.entries()) {
+    const ch = c[i + 1];
+    if (ch === undefined)
+      continue;
+    const opt = f.options[parseInt(ch, 36)];
+    if (!opt)
+      return null;
+    out[f.key] = opt;
+  }
+  return out;
+}
+var radiusValue = (name) => RADII.find((r) => r.name === name).value;
+function presetVars(p) {
+  const light = {};
+  const dark = {};
+  if (p.radius !== DEFAULT_PRESET.radius)
+    light["--radius"] = radiusValue(p.radius);
+  const font = FONTS.find((f) => f.name === p.font)?.value;
+  if (font)
+    light["--font-serif"] = font;
+  const sc = BASES.find((b) => b.name === p.base)?.scale;
+  if (sc) {
+    const wash = (c, pct) => `color-mix(in oklab, ${c} ${pct}%, transparent)`;
+    const darkBg = `color-mix(in oklab, ${sc[s900]}, ${sc[s950]})`;
+    Object.assign(light, {
+      "--background": sc[s100],
+      "--foreground": sc[s800],
+      "--card": "#FFFFFF",
+      "--card-foreground": sc[s800],
+      "--popover": "#FFFFFF",
+      "--popover-foreground": sc[s800],
+      "--primary": sc[s800],
+      "--primary-hover": wash(sc[s800], 90),
+      "--primary-foreground": sc[s50],
+      "--secondary": wash(sc[s200], 60),
+      "--secondary-foreground": sc[s800],
+      "--muted": wash(sc[s200], 40),
+      "--muted-foreground": sc[s500],
+      "--accent": wash(sc[s200], 50),
+      "--accent-foreground": sc[s800],
+      "--border": sc[s200],
+      "--input": sc[s200],
+      "--ring": sc[s800],
+      "--overlay": wash(sc[s100], 80)
+    });
+    Object.assign(dark, {
+      "--background": darkBg,
+      "--foreground": sc[s200],
+      "--card": sc[s900],
+      "--card-foreground": sc[s200],
+      "--popover": sc[s900],
+      "--popover-foreground": sc[s200],
+      "--primary": sc[s200],
+      "--primary-hover": wash(sc[s200], 90),
+      "--primary-foreground": sc[s950],
+      "--secondary": wash(sc[s800], 60),
+      "--secondary-foreground": sc[s200],
+      "--muted": wash(sc[s800], 40),
+      "--muted-foreground": sc[s400],
+      "--accent": wash(sc[s800], 50),
+      "--accent-foreground": sc[s200],
+      "--border": sc[s800],
+      "--input": sc[s800],
+      "--ring": sc[s200],
+      "--overlay": wash(darkBg, 80)
+    });
+  }
+  const theme = THEMES.find((t) => t.name === p.theme);
+  if (theme.light && theme.dark) {
+    for (const [vars, [c, on]] of [[light, theme.light], [dark, theme.dark]]) {
+      Object.assign(vars, {
+        "--primary": c,
+        "--primary-hover": `color-mix(in oklab, ${c} 90%, transparent)`,
+        "--primary-foreground": on,
+        "--ring": c
+      });
+    }
+  }
+  return { light, dark };
+}
+function applyPreset(css, p, radius) {
+  const { light, dark } = presetVars(p);
+  if (radius)
+    light["--radius"] = radius;
+  const patch = (block, vars) => Object.entries(vars).reduce((b, [k, v]) => b.replace(new RegExp(`(\\n\\s*${k}:)\\s*[^;]+;`), `$1 ${v};`), block);
+  return css.replace(/:root\s*\{[^}]*\}/, (b) => patch(b, light)).replace(/\.dark\s*\{[^}]*\}/, (b) => patch(b, dark));
+}
+
+// src/index.ts
+var CONFIG_FILE = "paperlamp.json";
+var DEFAULT_REGISTRY = "https://peach0x33a.github.io/paperlamp/r";
+var CATEGORY_LABELS = {
+  general: "通用",
+  layout: "布局",
+  navigation: "导航",
+  form: "数据录入",
+  data: "数据展示",
+  feedback: "反馈",
+  other: "其他"
+};
+var tty = process.stdout.isTTY && !process.env.NO_COLOR;
+var paint = (code) => (s) => tty ? `\x1B[${code}m${s}\x1B[0m` : s;
+var dim = paint(2);
+var bold = paint(1);
+var green = paint(32);
+var yellow = paint(33);
+var red = paint(31);
+
+class CliError extends Error {
+}
+var fail = (msg) => {
+  throw new CliError(msg);
+};
+function parseArgs(argv) {
+  const out = { _: [], flags: {} };
+  const bool = new Set(["all", "overwrite", "yes", "no-install", "help", "version", "h", "v"]);
+  for (let i = 0;i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      const [k, v] = a.slice(2).split("=", 2);
+      if (v !== undefined)
+        out.flags[k] = v;
+      else if (bool.has(k) || argv[i + 1] === undefined || argv[i + 1].startsWith("-"))
+        out.flags[k] = true;
+      else
+        out.flags[k] = argv[++i];
+    } else if (a.startsWith("-") && a.length === 2) {
+      out.flags[a.slice(1)] = true;
+    } else {
+      out._.push(a);
+    }
+  }
+  return out;
+}
+var str = (v) => typeof v === "string" ? v : undefined;
+function readJson(file) {
+  if (!existsSync(file))
+    return null;
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return fail(`${file} 不是合法的 JSON`);
+  }
+}
+function write(file, content) {
+  mkdirSync(dirname(file), { recursive: true });
+  writeFileSync(file, content);
+}
+function packageManager(cwd) {
+  if (existsSync(join(cwd, "bun.lock")) || existsSync(join(cwd, "bun.lockb")))
+    return { name: "bun", add: ["add"] };
+  if (existsSync(join(cwd, "pnpm-lock.yaml")))
+    return { name: "pnpm", add: ["add"] };
+  if (existsSync(join(cwd, "yarn.lock")))
+    return { name: "yarn", add: ["add"] };
+  return { name: "npm", add: ["install"] };
+}
+function install(cwd, specs, skip) {
+  const pj = readJson(join(cwd, "package.json"));
+  const have = new Set(Object.keys({ ...pj?.dependencies, ...pj?.devDependencies }));
+  const nameOf = (s) => s.replace(/(?<=.)@[^@]*$/, "");
+  const missing = [...new Set(specs)].filter((s) => !have.has(nameOf(s))).sort();
+  if (!missing.length)
+    return;
+  const pm = packageManager(cwd);
+  if (skip) {
+    console.log(`${yellow("!")} 跳过依赖安装，请手动运行：${pm.name} ${pm.add.join(" ")} ${missing.join(" ")}`);
+    return;
+  }
+  console.log(`${dim("›")} ${pm.name} ${pm.add.join(" ")} ${missing.join(" ")}`);
+  const r = spawnSync(pm.name, [...pm.add, ...missing], { cwd, stdio: "inherit", shell: process.platform === "win32" });
+  if (r.status !== 0)
+    fail(`依赖安装失败（${pm.name} 退出码 ${r.status ?? "?"}），可以手动重试上面的命令`);
+}
+async function fetchItem(base, name) {
+  const url = `${base}/${name}.json`;
+  let res;
+  try {
+    res = await fetch(url);
+  } catch (e) {
+    return fail(`连不上 registry：${url}
+  ${e.message}`);
+  }
+  if (res.status === 404 || res.ok && !isJson(res))
+    return fail(`registry 里没有「${name}」。运行 paperlamp list 查看可用组件`);
+  if (!res.ok)
+    return fail(`读取 ${url} 失败：HTTP ${res.status}`);
+  return await res.json();
+}
+var isJson = (res) => (res.headers.get("content-type") ?? "").includes("json");
+async function resolveTree(base, names) {
+  const seen = new Map;
+  const order = [];
+  async function visit(name, path) {
+    if (path.includes(name))
+      return;
+    if (seen.has(name))
+      return;
+    const item = await fetchItem(base, name);
+    seen.set(name, item);
+    for (const d of item.registryDependencies)
+      await visit(d, [...path, name]);
+    order.push(item);
+  }
+  for (const n of names)
+    await visit(n, []);
+  return order;
+}
+var normalizeRegistry = (url) => {
+  if (!/^https?:\/\//.test(url))
+    fail(`registry 地址需要以 http:// 或 https:// 开头：${url}`);
+  return url.replace(/\/+$/, "").replace(/\/index\.json$/, "");
+};
+function loadConfig(cwd) {
+  const c = readJson(join(cwd, CONFIG_FILE));
+  if (!c)
+    fail(`当前目录没有 ${CONFIG_FILE}。先运行 paperlamp init`);
+  return c;
+}
+function defaultPaths(cwd) {
+  const nuxt = ["nuxt.config.ts", "nuxt.config.js", "nuxt.config.mjs"].some((f) => existsSync(join(cwd, f)));
+  const base = nuxt && !existsSync(join(cwd, "src")) ? "" : "src/";
+  return { ui: `${base}components/ui`, lib: `${base}lib` };
+}
+var CSS_CANDIDATES = [
+  "src/style.css",
+  "src/styles.css",
+  "src/index.css",
+  "src/main.css",
+  "src/assets/main.css",
+  "src/assets/css/main.css",
+  "app/assets/css/main.css",
+  "assets/css/main.css"
+];
+function hasAtAlias(cwd) {
+  for (const f of ["tsconfig.json", "tsconfig.app.json", "jsconfig.json"]) {
+    const p = join(cwd, f);
+    if (existsSync(p) && readFileSync(p, "utf8").includes('"@/*"'))
+      return true;
+  }
+  return existsSync(join(cwd, "nuxt.config.ts")) || existsSync(join(cwd, "nuxt.config.js"));
+}
+function presetFrom(flags) {
+  const presetFlag = str(flags.preset);
+  if (presetFlag) {
+    const p = decodePreset(presetFlag);
+    if (!p)
+      fail(`无法识别的 preset：${presetFlag}`);
+    return { preset: p, radius: radiusValue(p.radius), code: encodePreset(p) };
+  }
+  const r = str(flags.radius);
+  if (!r)
+    return { preset: DEFAULT_PRESET, radius: radiusValue(DEFAULT_PRESET.radius), code: encodePreset(DEFAULT_PRESET) };
+  const named = RADII.find((x) => x.name === r);
+  if (named) {
+    const p = { ...DEFAULT_PRESET, radius: named.name };
+    return { preset: p, radius: named.value, code: encodePreset(p) };
+  }
+  if (/^\d+(\.\d+)?(px|rem|em)$|^0$/.test(r))
+    return { preset: DEFAULT_PRESET, radius: r };
+  return fail(`--radius 只接受 ${RADII.map((x) => x.name).join(" / ")}，或一个长度值（如 6px、0.5rem）`);
+}
+function ensureImports(file, imports) {
+  const wanted = imports.map((i) => `@import "${i}";`);
+  const body = existsSync(file) ? readFileSync(file, "utf8") : "";
+  const rest = body.split(/\r?\n/).filter((line) => !wanted.includes(line.trim().replace(/'/g, '"'))).join(`
+`).replace(/^\s+/, "");
+  write(file, `${wanted.join(`
+`)}
+${rest ? `
+${rest}` : ""}`);
+}
+async function init(cwd, flags) {
+  if (!existsSync(join(cwd, "package.json")))
+    fail("当前目录没有 package.json，请在项目根目录运行");
+  const existing = readJson(join(cwd, CONFIG_FILE));
+  const registry = normalizeRegistry(str(flags.registry) ?? process.env.PAPERLAMP_REGISTRY ?? existing?.registry ?? DEFAULT_REGISTRY);
+  const cssFile = str(flags.css) ?? existing?.css ?? CSS_CANDIDATES.find((f) => existsSync(join(cwd, f))) ?? "src/style.css";
+  const createdCss = !existsSync(join(cwd, cssFile));
+  const { preset: chosen, radius, code: preset } = presetFrom(flags);
+  const config = {
+    registry,
+    css: cssFile,
+    radius,
+    ...preset ? { preset } : {},
+    paths: existing?.paths ?? defaultPaths(cwd),
+    aliases: existing?.aliases ?? { ui: "@/components/ui", lib: "@/lib" }
+  };
+  const [style, ...rest] = await resolveTree(registry, ["paperlamp"]).then((items) => {
+    const s = items.find((i) => i.type === "style");
+    if (!s)
+      fail("registry 里缺少主题条目 paperlamp");
+    return [s, ...items.filter((i) => i !== s)];
+  });
+  const themeFile = join(dirname(join(cwd, cssFile)), "paperlamp.css");
+  write(themeFile, applyPreset(style.files[0].content, chosen, radius));
+  let themeImport = relative(dirname(join(cwd, cssFile)), themeFile).replace(/\\/g, "/");
+  if (!themeImport.startsWith("."))
+    themeImport = `./${themeImport}`;
+  ensureImports(join(cwd, cssFile), [...style.cssImports ?? [], themeImport]);
+  const written = writeItems(cwd, config, rest, Boolean(flags.overwrite));
+  write(join(cwd, CONFIG_FILE), `${JSON.stringify(config, null, 2)}
+`);
+  console.log(`${green("✓")} ${"主题".padEnd(14)}${relative(cwd, themeFile)}  ${dim(preset ? `preset ${preset}` : `--radius: ${radius}`)}`);
+  console.log(`${green("✓")} ${"样式".padEnd(14)}${cssFile}${createdCss ? dim("（新建）") : ""}`);
+  for (const w of written)
+    console.log(w);
+  console.log(`${green("✓")} ${"配置".padEnd(14)}${CONFIG_FILE}`);
+  install(cwd, [...style.dependencies, ...rest.flatMap((i) => i.dependencies)], Boolean(flags["no-install"]));
+  if (createdCss)
+    console.log(`${yellow("!")} 新建了 ${cssFile}，记得在入口文件里 import 它`);
+  if (!hasAtAlias(cwd))
+    console.log(`${yellow("!")} 没找到 "@/*" 路径别名。组件用 @/components/ui 与 @/lib 互相引用，请在 tsconfig 与 vite.config 里把 @ 指向 src`);
+  console.log(`
+现在可以添加组件：${bold("npx paperlamp add button")}`);
+}
+function rewriteImports(content, aliases) {
+  return content.replace(/(["'])@\/components\/ui\//g, `$1${aliases.ui}/`).replace(/(["'])@\/lib\//g, `$1${aliases.lib}/`);
+}
+function writeItems(cwd, config, items, overwrite) {
+  const lines = [];
+  for (const item of items) {
+    if (item.type === "style")
+      continue;
+    let wrote = 0;
+    let kept = 0;
+    for (const f of item.files) {
+      const root = f.target === "lib" ? config.paths.lib : config.paths.ui;
+      const dest = join(cwd, root, f.path);
+      if (existsSync(dest) && !overwrite) {
+        kept++;
+        continue;
+      }
+      write(dest, rewriteImports(f.content, config.aliases));
+      wrote++;
+    }
+    const where = item.type === "lib" ? config.paths.lib : `${config.paths.ui}/${item.name}`;
+    if (wrote)
+      lines.push(`${green("✓")} ${item.name.padEnd(14)}${where}`);
+    else if (kept)
+      lines.push(`${dim("·")} ${item.name.padEnd(14)}${dim("已存在，跳过（--overwrite 覆盖）")}`);
+  }
+  return lines;
+}
+async function add(cwd, names, flags) {
+  const config = loadConfig(cwd);
+  const registry = normalizeRegistry(str(flags.registry) ?? config.registry);
+  if (flags.all) {
+    const index = await fetchIndex(registry);
+    names = index.items.filter((i) => i.type === "ui").map((i) => i.name);
+  }
+  if (!names.length)
+    fail("要添加哪个组件？例如 paperlamp add button tool-card");
+  const items = await resolveTree(registry, names);
+  const written = writeItems(cwd, config, items, Boolean(flags.overwrite));
+  for (const w of written)
+    console.log(w);
+  install(cwd, items.flatMap((i) => i.dependencies), Boolean(flags["no-install"]));
+}
+async function fetchIndex(registry) {
+  const res = await fetch(`${registry}/index.json`).catch((e) => fail(`连不上 registry：${registry}
+  ${e.message}`));
+  if (!res.ok || !isJson(res))
+    fail(`${registry} 不是纸灯 registry（${registry}/index.json 不存在）`);
+  return await res.json();
+}
+async function list(cwd, flags) {
+  const registry = normalizeRegistry(str(flags.registry) ?? readJson(join(cwd, CONFIG_FILE))?.registry ?? process.env.PAPERLAMP_REGISTRY ?? DEFAULT_REGISTRY);
+  const { items } = await fetchIndex(registry);
+  const groups = new Map;
+  for (const i of items.filter((x) => x.type === "ui")) {
+    const k = i.category ?? "other";
+    groups.set(k, [...groups.get(k) ?? [], i]);
+  }
+  const order = Object.keys(CATEGORY_LABELS);
+  const rank = (k) => order.includes(k) ? order.indexOf(k) : order.length;
+  for (const [cat, group] of [...groups].sort(([a], [b]) => rank(a) - rank(b))) {
+    console.log(bold(CATEGORY_LABELS[cat] ?? "其他"));
+    for (const i of group)
+      console.log(`  ${i.name.padEnd(16)}${dim(i.title)}`);
+  }
+}
+var HELP = `${bold("paperlamp")} ${dim(package_default.version)} — 把纸灯组件源码复制进你的 Vue 项目
+
+用法
+  paperlamp init                    写入主题、cn() 工具与 paperlamp.json
+      --registry <url>              组件来源（默认 ${DEFAULT_REGISTRY}）
+      --preset <code>               使用 /create 构建器生成的 preset
+      --radius <name|长度>          ${RADII.map((r) => r.name).join(" / ")}，或 6px、0.5rem
+      --css <file>                  主样式文件（默认自动查找，找不到则新建 src/style.css）
+  paperlamp add <组件...>           复制组件及其依赖的组件，并安装 npm 依赖
+      --all                         添加全部组件
+      --overwrite                   覆盖已存在的文件
+  paperlamp list                    列出 registry 里的组件
+
+通用选项
+  --cwd <dir>        在指定目录运行
+  --no-install       只写文件，不安装依赖
+  -v, --version      显示版本
+`;
+async function main() {
+  const { _: [cmd, ...rest], flags } = parseArgs(process.argv.slice(2));
+  const cwd = resolve(str(flags.cwd) ?? process.cwd());
+  if (flags.version || flags.v)
+    return console.log(package_default.version);
+  if (!cmd || flags.help || flags.h || cmd === "help")
+    return console.log(HELP);
+  if (cmd === "init")
+    return init(cwd, flags);
+  if (cmd === "add")
+    return add(cwd, rest, flags);
+  if (cmd === "list" || cmd === "ls")
+    return list(cwd, flags);
+  fail(`未知命令：${cmd}。运行 paperlamp --help 查看用法`);
+}
+main().catch((e) => {
+  if (e instanceof CliError) {
+    console.error(`${red("✗")} ${e.message}`);
+    process.exit(1);
+  }
+  throw e;
+});

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "paperlamp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "纸灯 / Paperlamp CLI — copy Paperlamp Vue components into your project",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "paperlamp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "keywords": [
+    "vue",
+    "components",
+    "tailwindcss",
+    "reka-ui",
+    "design-system",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/peach0x33a/paperlamp.git",
+    "directory": "packages/cli"
+  },
+  "scripts": {
+    "build": "bun build src/index.ts --target node --outfile dist/index.js"
+  },
+  "homepage": "https://peach0x33a.github.io/paperlamp/"
+}