ply-ui-cli 1.1.118

package/dist/commands/add.js

@@ -0,0 +1,432 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/commands/add.ts
+var add_exports = {};
+__export(add_exports, {
+  add: () => add
+});
+module.exports = __toCommonJS(add_exports);
+var import_fs4 = __toESM(require("fs"));
+var import_path5 = __toESM(require("path"));
+var import_vendor2 = require("../vendor");
+var import_registry = require("../registry");
+
+// src/lockfile.ts
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_crypto = __toESM(require("crypto"));
+var LOCKFILE_NAME = "base-ui-lock.json";
+var LOCKFILE_VERSION = 1;
+function hashContent(content) {
+  return import_crypto.default.createHash("sha256").update(content, "utf8").digest("hex");
+}
+function lockfilePath() {
+  return import_path.default.resolve(process.cwd(), LOCKFILE_NAME);
+}
+function readLockFile() {
+  const p = lockfilePath();
+  if (!import_fs.default.existsSync(p)) {
+    return { version: LOCKFILE_VERSION, components: {} };
+  }
+  try {
+    const parsed = JSON.parse(import_fs.default.readFileSync(p, "utf8"));
+    if (parsed && typeof parsed === "object" && parsed.components) {
+      return { version: parsed.version ?? LOCKFILE_VERSION, components: parsed.components };
+    }
+  } catch {
+  }
+  return { version: LOCKFILE_VERSION, components: {} };
+}
+function writeLockFile(lock) {
+  import_fs.default.writeFileSync(lockfilePath(), JSON.stringify(lock, null, 2) + "\n", "utf8");
+}
+function recordComponent(lock, name, tier, files) {
+  const fileHashes = {};
+  for (const f of files) {
+    fileHashes[f.name] = hashContent(f.content);
+  }
+  lock.components[name] = {
+    tier,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    files: fileHashes
+  };
+}
+
+// src/config.ts
+var import_fs2 = __toESM(require("fs"));
+var import_path2 = __toESM(require("path"));
+
+// src/brand.ts
+var CLI_BIN = "ply-ui-cli";
+var CLI_NPX = `npx ${CLI_BIN}`;
+var MCP_PACKAGE = "ply-ui-mcp";
+var MCP_NPX = `npx -y ${MCP_PACKAGE}`;
+
+// src/config.ts
+function readConfig() {
+  const configPath = import_path2.default.resolve(process.cwd(), "base-ui.json");
+  if (!import_fs2.default.existsSync(configPath)) {
+    console.error(`base-ui.json not found. Please run "${CLI_NPX} init" first.`);
+    return null;
+  }
+  try {
+    const config = JSON.parse(import_fs2.default.readFileSync(configPath, "utf8"));
+    if (!config || !config.aliases || !config.aliases.components) {
+      throw new Error("Missing aliases.components in base-ui.json");
+    }
+    return config;
+  } catch (err) {
+    console.error(`Error reading base-ui.json: ${err.message}`);
+    return null;
+  }
+}
+
+// src/path-safety.ts
+var import_path3 = __toESM(require("path"));
+function isSafeFileName(name) {
+  if (import_path3.default.isAbsolute(name) || /^[a-zA-Z]:[\\/]/.test(name)) return false;
+  const segments = name.split(/[\\/]/);
+  return segments.every((s) => s !== "" && s !== "..");
+}
+
+// src/integrity.ts
+function isSafeNpmDependency(spec) {
+  return /^(?:@[a-z0-9][a-z0-9-._~]*\/)?[a-z0-9][a-z0-9-._~]*$/.test(spec) && spec.length <= 214;
+}
+
+// src/commands/pick-components.ts
+var import_vendor = require("../vendor");
+
+// src/categories.ts
+var CATEGORY_TITLES = {
+  application: "Applications",
+  "page-layout": "Page layouts",
+  block: "Blocks",
+  widget: "Widgets",
+  shell: "Shells",
+  component: "Components"
+};
+var CATEGORY_ORDER = [
+  "application",
+  "page-layout",
+  "block",
+  "widget",
+  "shell",
+  "component"
+];
+function categoryTitle(category) {
+  const key = category || "component";
+  return CATEGORY_TITLES[key] || key;
+}
+
+// src/commands/pick-components.ts
+var ADD_NEEDS_NAME = `Pass a component name: ${CLI_NPX} add <name>
+  Or run without --yes in a terminal to pick from the catalog.`;
+function canPromptInteractively(options, tty = Boolean(process.stdin.isTTY && process.stdout.isTTY)) {
+  return !options.yes && tty;
+}
+function filterCatalog(index, filter) {
+  if (filter === "all") return index;
+  if (filter === "free" || filter === "pro") {
+    return index.filter((item) => item.tier === filter);
+  }
+  if (filter.startsWith("category:")) {
+    const category = filter.slice("category:".length);
+    return index.filter((item) => (item.category || "component") === category);
+  }
+  return index;
+}
+function catalogFilterChoices(index) {
+  const count = (pred) => index.filter(pred).length;
+  const choices = [
+    { title: `All (${index.length})`, value: "all" },
+    { title: `Free (${count((item) => item.tier === "free")})`, value: "free" },
+    { title: `Pro (${count((item) => item.tier === "pro")})`, value: "pro" }
+  ];
+  for (const category of CATEGORY_ORDER) {
+    const n = count((item) => (item.category || "component") === category);
+    if (!n) continue;
+    choices.push({
+      title: `${CATEGORY_TITLES[category]} (${n})`,
+      value: `category:${category}`
+    });
+  }
+  return choices;
+}
+function pickerTitle(item) {
+  const keywords = (item.keywords || []).slice(0, 6).join(" ");
+  const label = `${item.name}  (${item.tier} \xB7 ${categoryTitle(item.category)})`;
+  return keywords ? `${label}  ${keywords}` : label;
+}
+function toPickerChoices(index) {
+  return [...index].sort((a, b) => a.name.localeCompare(b.name)).map((item) => ({
+    title: pickerTitle(item),
+    value: item.name
+  }));
+}
+async function pickComponents(index) {
+  const filterRes = await (0, import_vendor.prompts)({
+    type: "select",
+    name: "filter",
+    message: "Filter the catalog",
+    choices: catalogFilterChoices(index)
+  });
+  if (!filterRes.filter) return [];
+  const filtered = filterCatalog(index, String(filterRes.filter));
+  if (!filtered.length) {
+    console.error("No components in that filter.");
+    return [];
+  }
+  const picked = await (0, import_vendor.prompts)({
+    type: "autocompleteMultiselect",
+    name: "components",
+    message: "Select components to add",
+    hint: "- Type to filter. Space to select. Enter to confirm",
+    instructions: false,
+    min: 1,
+    choices: toPickerChoices(filtered)
+  });
+  const selected = picked.components;
+  if (!Array.isArray(selected) || selected.length === 0) return [];
+  return selected.map(String);
+}
+
+// src/aliases.ts
+var COMPONENT_ALIASES = {
+  sheet: "drawer",
+  "side-sheet": "drawer",
+  carousel: "slider",
+  gallery: "slider",
+  "image-slider": "slider",
+  range: "range-slider",
+  "slider-input": "range-slider",
+  "input-slider": "range-slider"
+};
+function canonicalComponentName(name) {
+  const key = name.trim().toLowerCase();
+  return COMPONENT_ALIASES[key] ?? name.trim();
+}
+
+// src/snapshot.ts
+var import_fs3 = __toESM(require("fs"));
+var import_path4 = __toESM(require("path"));
+var SNAPSHOT_ROOT = ".base-ui/snapshots";
+function snapshotPath(component, file) {
+  return import_path4.default.resolve(process.cwd(), SNAPSHOT_ROOT, component, file);
+}
+function writeSnapshot(component, file, content) {
+  if (!isSafeFileName(file) || !isSafeFileName(component)) return;
+  const dest = snapshotPath(component, file);
+  import_fs3.default.mkdirSync(import_path4.default.dirname(dest), { recursive: true });
+  import_fs3.default.writeFileSync(dest, content, "utf8");
+}
+
+// src/commands/add.ts
+function detectPackageManager(cwd) {
+  if (import_fs4.default.existsSync(import_path5.default.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (import_fs4.default.existsSync(import_path5.default.join(cwd, "yarn.lock"))) return "yarn";
+  if (import_fs4.default.existsSync(import_path5.default.join(cwd, "bun.lockb")) || import_fs4.default.existsSync(import_path5.default.join(cwd, "bun.lock"))) return "bun";
+  return "npm";
+}
+function installedNpmDeps(cwd) {
+  try {
+    const pkg = JSON.parse(import_fs4.default.readFileSync(import_path5.default.join(cwd, "package.json"), "utf8"));
+    return /* @__PURE__ */ new Set([
+      ...Object.keys(pkg.dependencies || {}),
+      ...Object.keys(pkg.devDependencies || {})
+    ]);
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+async function add(components, options = {}) {
+  let names = (components || []).map((name) => name.trim()).filter(Boolean);
+  names = names.map((name) => {
+    const canonical = canonicalComponentName(name);
+    if (canonical !== name) {
+      console.log(`\u2139 ${name} \u2192 ${canonical}`);
+    }
+    return canonical;
+  });
+  names = [...new Set(names)];
+  if (names.length === 0 && !canPromptInteractively(options)) {
+    console.error(ADD_NEEDS_NAME);
+    process.exitCode = 1;
+    return;
+  }
+  const config = readConfig();
+  if (!config) {
+    process.exitCode = 1;
+    return;
+  }
+  const componentsRoot = import_path5.default.resolve(process.cwd(), config.aliases.components);
+  const indexSpinner = (0, import_vendor2.ora)("Loading registry index...").start();
+  let index;
+  try {
+    index = await (0, import_registry.fetchIndex)();
+    indexSpinner.succeed("Registry index loaded.");
+  } catch (err) {
+    indexSpinner.fail(err.message);
+    process.exitCode = 1;
+    return;
+  }
+  if (names.length === 0) {
+    names = await pickComponents(index);
+    if (names.length === 0) {
+      console.log("Nothing to install.");
+      return;
+    }
+  }
+  const byName = new Map(index.map((i) => [i.name, i]));
+  let hadError = false;
+  for (const name of names) {
+    if (!(0, import_registry.isSafeItemName)(name) || !byName.has(name)) {
+      hadError = true;
+      const suggestions = (0, import_registry.suggestNames)(name, index.map((i) => i.name));
+      console.error(`\u2716 Unknown component: '${name}'.`);
+      if (suggestions.length) {
+        console.error(`  Did you mean: ${suggestions.join(", ")}?`);
+      }
+      console.error(`  Run "${CLI_NPX} list" to see every available component.`);
+    }
+  }
+  if (hadError) {
+    process.exitCode = 1;
+    return;
+  }
+  const requested = new Set(names);
+  const toInstall = /* @__PURE__ */ new Map();
+  const queue = [...names];
+  while (queue.length) {
+    const name = queue.shift();
+    if (toInstall.has(name)) continue;
+    const entry = byName.get(name);
+    if (!entry) {
+      console.error(`\u2716 Registry index is missing dependency '${name}'. Aborting.`);
+      process.exitCode = 1;
+      return;
+    }
+    const targetDir = import_path5.default.join(componentsRoot, name);
+    if (!requested.has(name) && import_fs4.default.existsSync(targetDir)) continue;
+    toInstall.set(name, entry);
+    queue.push(...entry.registryDependencies);
+  }
+  const proItems = [...toInstall.values()].filter((i) => i.tier === "pro");
+  if (proItems.length && !(0, import_registry.getLicenseKey)()) {
+    console.error(`\u2716 The following components require a Ply Pro license: ${proItems.map((i) => i.name).join(", ")}`);
+    console.error(`  Set the PLY_LICENSE_KEY environment variable to your license key.`);
+    console.error(`  (BASE_UI_LICENSE_KEY is still accepted.)`);
+    console.error(`  Get a license at ${import_registry.SITE_URL}/pricing.`);
+    process.exitCode = 1;
+    return;
+  }
+  for (const name of requested) {
+    const targetDir = import_path5.default.join(componentsRoot, name);
+    if (!import_fs4.default.existsSync(targetDir)) continue;
+    if (options.overwrite || options.yes) continue;
+    const res = await (0, import_vendor2.prompts)({
+      type: "confirm",
+      name: "overwrite",
+      message: `${import_path5.default.relative(process.cwd(), targetDir)} already exists. Overwrite it?`,
+      initial: false
+    });
+    if (!res.overwrite) {
+      toInstall.delete(name);
+      console.log(`  Skipped ${name}.`);
+    }
+  }
+  if (toInstall.size === 0) {
+    console.log("Nothing to install.");
+    return;
+  }
+  const npmDeps = /* @__PURE__ */ new Set();
+  const installedItems = [];
+  const lock = readLockFile();
+  for (const [name, entry] of toInstall) {
+    const spinner = (0, import_vendor2.ora)(`Fetching ${name}...`).start();
+    let item;
+    try {
+      item = await (0, import_registry.fetchItem)(name, entry.tier, entry.digest);
+    } catch (err) {
+      spinner.fail(`Failed to fetch ${name}: ${err.code === "NOT_FOUND" ? "not found in registry." : err.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    const unsafeFile = item.files.find((f) => !isSafeFileName(f.name));
+    if (unsafeFile) {
+      spinner.fail(`Registry payload for ${name} contains an unsafe file path ('${unsafeFile.name}') \u2014 nothing was written.`);
+      process.exitCode = 1;
+      return;
+    }
+    const unsafeDep = item.dependencies.find((d) => !isSafeNpmDependency(d));
+    if (unsafeDep) {
+      spinner.fail(`Registry payload for ${name} lists an invalid npm dependency ('${unsafeDep}') \u2014 nothing was written.`);
+      process.exitCode = 1;
+      return;
+    }
+    const targetDir = import_path5.default.join(componentsRoot, name);
+    try {
+      for (const file of item.files) {
+        const filePath = import_path5.default.join(targetDir, file.name);
+        import_fs4.default.mkdirSync(import_path5.default.dirname(filePath), { recursive: true });
+        import_fs4.default.writeFileSync(filePath, file.content, "utf8");
+        writeSnapshot(name, file.name, file.content);
+      }
+    } catch (err) {
+      spinner.fail(`Failed to write ${name}: ${err.message}`);
+      process.exitCode = 1;
+      return;
+    }
+    item.dependencies.forEach((d) => npmDeps.add(d));
+    installedItems.push(name);
+    recordComponent(lock, name, entry.tier, item.files);
+    spinner.succeed(`${name} \u2192 ${import_path5.default.relative(process.cwd(), targetDir)}${entry.tier === "pro" ? "  (pro)" : ""}`);
+  }
+  if (installedItems.length) {
+    writeLockFile(lock);
+  }
+  const existing = installedNpmDeps(process.cwd());
+  const missingDeps = [...npmDeps].filter((d) => !existing.has(d));
+  if (missingDeps.length) {
+    const pm = detectPackageManager(process.cwd());
+    const cmd = pm === "npm" ? `npm install ${missingDeps.join(" ")}` : `${pm} add ${missingDeps.join(" ")}`;
+    console.log(
+      `
+Install missing npm ${missingDeps.length === 1 ? "dependency" : "dependencies"}:
+  ${cmd}`
+    );
+  }
+  console.log(`
+\u2714 Added ${installedItems.length} ${installedItems.length === 1 ? "component" : "components"}: ${installedItems.join(", ")}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  add
+});

package/dist/commands/changelog.js

@@ -0,0 +1,112 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/commands/changelog.ts
+var changelog_exports = {};
+__export(changelog_exports, {
+  changelog: () => changelog
+});
+module.exports = __toCommonJS(changelog_exports);
+var import_registry = require("../registry");
+
+// src/brand.ts
+var CLI_BIN = "ply-ui-cli";
+var CLI_NPX = `npx ${CLI_BIN}`;
+var MCP_PACKAGE = "ply-ui-mcp";
+var MCP_NPX = `npx -y ${MCP_PACKAGE}`;
+
+// src/commands/changelog.ts
+var CHANGELOG_URL = process.env.PLY_CHANGELOG_URL?.trim() || process.env.BASE_UI_CHANGELOG_URL?.trim() || `${import_registry.SITE_URL}/assets/changelog.json`;
+function flattenEntries(payload) {
+  const out = [];
+  for (const month of payload.months ?? []) {
+    if (!month || typeof month !== "object") continue;
+    const block = month;
+    const entries = block.entries?.length ? block.entries : (block.sections ?? []).flatMap((section) => section.entries ?? []);
+    out.push(...entries);
+  }
+  return out;
+}
+function matchesName(entry, name) {
+  if (entry.scope === name) return true;
+  return Array.isArray(entry.components) && entry.components.includes(name);
+}
+async function changelog(names) {
+  const name = names[0]?.trim();
+  if (!name || names.length !== 1) {
+    console.error(`Usage: ${CLI_NPX} changelog <name>`);
+    process.exitCode = 1;
+    return;
+  }
+  if (!(0, import_registry.isSafeItemName)(name)) {
+    console.error(`\u2716 Invalid component name: '${name}'.`);
+    process.exitCode = 1;
+    return;
+  }
+  let payload;
+  try {
+    const res = await fetch(CHANGELOG_URL);
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}`);
+    }
+    payload = await res.json();
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`\u2716 Could not load changelog (${message}).`);
+    console.error(`  ${import_registry.SITE_URL}/changelog`);
+    process.exitCode = 1;
+    return;
+  }
+  const hits = flattenEntries(payload).filter((entry) => matchesName(entry, name));
+  if (!hits.length) {
+    try {
+      const index = await (0, import_registry.fetchIndex)();
+      const known = index.some((item) => item.name === name) || name === "cli" || name === "mcp";
+      if (!known) {
+        const suggestions = (0, import_registry.suggestNames)(
+          name,
+          index.map((item) => item.name)
+        );
+        console.error(`\u2716 Unknown component: '${name}'.`);
+        if (suggestions.length) {
+          console.error(`  Did you mean: ${suggestions.join(", ")}`);
+        }
+        process.exitCode = 1;
+        return;
+      }
+    } catch {
+    }
+    console.log(`No changelog entries for '${name}' yet.`);
+    console.log(`Full history: ${import_registry.SITE_URL}/changelog`);
+    return;
+  }
+  console.log(`${name} \u2014 ${hits.length} matching update${hits.length === 1 ? "" : "s"}
+`);
+  for (const entry of hits) {
+    const type = (entry.type || "other").padEnd(8);
+    const bang = entry.breaking ? " BREAKING" : "";
+    console.log(`${entry.date}  ${type}  ${entry.hash}${bang}  ${entry.description}`);
+  }
+  console.log(`
+Full history: ${import_registry.SITE_URL}/changelog`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  changelog
+});