@kinetixui/cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KinetixUI
+
+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/dist/index.js

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import pc3 from "picocolors";
+
+// src/commands/add.ts
+import { existsSync as existsSync4 } from "fs";
+import path4 from "path";
+import pc from "picocolors";
+
+// src/lib/apply.ts
+import { existsSync as existsSync2 } from "fs";
+import { mkdir, writeFile as writeFile2 } from "fs/promises";
+import path2 from "path";
+
+// src/lib/config.ts
+import { existsSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import path from "path";
+var CONFIG_FILE = "kinetixui.json";
+var DEFAULT_CONFIG = {
+  $schema: "https://kinetixui.com/schema/config.json",
+  tailwind: { css: "app/globals.css" },
+  aliases: {
+    components: "@/components",
+    ui: "@/components/ui",
+    lib: "@/lib",
+    utils: "@/lib/utils"
+  },
+  srcDir: false
+};
+async function readConfig(cwd) {
+  const file = path.join(cwd, CONFIG_FILE);
+  if (!existsSync(file)) return null;
+  return JSON.parse(await readFile(file, "utf8"));
+}
+async function writeConfig(cwd, config) {
+  await writeFile(path.join(cwd, CONFIG_FILE), JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+function resolveAliasDir(cwd, config, alias) {
+  const raw = config.aliases[alias].replace(/^@\//, "");
+  return path.join(cwd, config.srcDir ? "src" : "", raw);
+}
+
+// src/lib/apply.ts
+function targetPath(cwd, config, file) {
+  if (file.target === "app/globals.css") {
+    return path2.join(cwd, config.srcDir ? "src" : "", config.tailwind.css);
+  }
+  const dir = file.type === "registry:lib" ? resolveAliasDir(cwd, config, "lib") : resolveAliasDir(cwd, config, "ui");
+  return path2.join(dir, path2.basename(file.target));
+}
+async function writeItems(cwd, config, items, overwrite) {
+  const deps = /* @__PURE__ */ new Set();
+  const written = [];
+  const skipped = [];
+  for (const item of items) {
+    for (const dep of item.dependencies ?? []) deps.add(dep);
+    for (const file of item.files) {
+      const dest = targetPath(cwd, config, file);
+      const rel = path2.relative(cwd, dest);
+      if (existsSync2(dest) && !overwrite) {
+        skipped.push(rel);
+        continue;
+      }
+      await mkdir(path2.dirname(dest), { recursive: true });
+      await writeFile2(dest, file.content, "utf8");
+      written.push(rel);
+    }
+  }
+  return { deps, written, skipped };
+}
+
+// src/lib/pm.ts
+import { existsSync as existsSync3 } from "fs";
+import { spawn } from "child_process";
+import path3 from "path";
+function detectPackageManager(cwd) {
+  if (existsSync3(path3.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync3(path3.join(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync3(path3.join(cwd, "bun.lockb"))) return "bun";
+  return "npm";
+}
+function installArgs(pm, packages) {
+  return pm === "npm" ? ["install", ...packages] : ["add", ...packages];
+}
+function runInstall(cwd, pm, packages) {
+  if (packages.length === 0) return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    const child = spawn(pm, installArgs(pm, packages), {
+      cwd,
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`"${pm} ${installArgs(pm, packages).join(" ")}" exited with code ${code}`));
+    });
+  });
+}
+
+// src/lib/registry.ts
+async function fetchRegistryItem(registryUrl, name) {
+  const url = `${registryUrl.replace(/\/$/, "")}/${name}.json`;
+  const res = await fetch(url);
+  if (!res.ok) {
+    throw new Error(`Could not find "${name}" in the registry (${res.status} at ${url}).`);
+  }
+  return await res.json();
+}
+async function resolveTree(registryUrl, names) {
+  const resolved = /* @__PURE__ */ new Map();
+  const queue = [...names];
+  while (queue.length) {
+    const name = queue.shift();
+    if (!name || resolved.has(name)) continue;
+    const item = await fetchRegistryItem(registryUrl, name);
+    resolved.set(name, item);
+    for (const dep of item.registryDependencies ?? []) {
+      if (!resolved.has(dep)) queue.push(dep);
+    }
+  }
+  return resolved;
+}
+
+// src/commands/add.ts
+async function add(names, options) {
+  const cwd = process.cwd();
+  const config = await readConfig(cwd) ?? DEFAULT_CONFIG;
+  if (!existsSync4(path4.join(cwd, CONFIG_FILE))) {
+    console.log(pc.yellow("!"), `No ${CONFIG_FILE} found \u2014 using defaults. Run "kinetixui init" first to set your own aliases.`);
+  }
+  console.log(`Resolving ${names.join(", ")}\u2026`);
+  const items = await resolveTree(options.registry, names);
+  const { deps, written, skipped } = await writeItems(cwd, config, items.values(), options.overwrite);
+  for (const file of written) console.log(pc.green("\u2714"), `Added ${file}`);
+  for (const file of skipped) console.log(pc.yellow("skip"), `${file} already exists (pass --overwrite to replace it)`);
+  if (deps.size > 0) {
+    const pm = detectPackageManager(cwd);
+    console.log();
+    console.log(`Installing ${[...deps].join(", ")} with ${pm}\u2026`);
+    await runInstall(cwd, pm, [...deps]);
+  }
+  console.log();
+  console.log(pc.green("Done."));
+}
+
+// src/commands/init.ts
+import { existsSync as existsSync5 } from "fs";
+import path5 from "path";
+import pc2 from "picocolors";
+import prompts from "prompts";
+async function init(options) {
+  const cwd = process.cwd();
+  const configPath = path5.join(cwd, CONFIG_FILE);
+  if (existsSync5(configPath) && !options.yes) {
+    const { proceed } = await prompts({
+      type: "confirm",
+      name: "proceed",
+      message: `${CONFIG_FILE} already exists. Overwrite it?`,
+      initial: false
+    });
+    if (!proceed) {
+      console.log("Cancelled.");
+      return;
+    }
+  }
+  const srcDirDetected = existsSync5(path5.join(cwd, "src"));
+  const answers = options.yes ? {
+    srcDir: srcDirDetected,
+    css: DEFAULT_CONFIG.tailwind.css,
+    components: DEFAULT_CONFIG.aliases.components,
+    utils: DEFAULT_CONFIG.aliases.utils
+  } : await prompts([
+    {
+      type: "toggle",
+      name: "srcDir",
+      message: "Use a src/ directory?",
+      initial: srcDirDetected,
+      active: "yes",
+      inactive: "no"
+    },
+    {
+      type: "text",
+      name: "css",
+      message: "Where's your global CSS file?",
+      initial: DEFAULT_CONFIG.tailwind.css
+    },
+    {
+      type: "text",
+      name: "components",
+      message: "Import alias for components?",
+      initial: DEFAULT_CONFIG.aliases.components
+    },
+    {
+      type: "text",
+      name: "utils",
+      message: "Import alias for utils?",
+      initial: DEFAULT_CONFIG.aliases.utils
+    }
+  ]);
+  if (answers.css === void 0) {
+    console.log("Cancelled.");
+    return;
+  }
+  const config = {
+    ...DEFAULT_CONFIG,
+    srcDir: !!answers.srcDir,
+    tailwind: { css: answers.css },
+    aliases: {
+      components: answers.components,
+      ui: `${answers.components}/ui`,
+      lib: answers.utils.replace(/\/utils$/, ""),
+      utils: answers.utils
+    }
+  };
+  await writeConfig(cwd, config);
+  console.log(pc2.green("\u2714"), `Created ${CONFIG_FILE}`);
+  const items = await resolveTree(options.registry, ["tokens"]);
+  const { written, skipped } = await writeItems(cwd, config, items.values(), false);
+  for (const file of written) console.log(pc2.green("\u2714"), `Wrote ${file}`);
+  for (const file of skipped) {
+    console.log(pc2.yellow("!"), `${file} already exists \u2014 merge the token contract in by hand, or delete it and re-run init.`);
+  }
+  console.log();
+  console.log(`Next: ${pc2.cyan("npx @kinetixui/cli add button")}`);
+}
+
+// src/index.ts
+var DEFAULT_REGISTRY = "https://kinetixui.com/r";
+var program = new Command();
+program.name("kinetixui").description("Add KinetixUI components and tokens to your project.").version("0.2.0");
+program.command("init").description("Set up kinetixui.json and pull in the token contract.").option("-y, --yes", "skip prompts and use defaults", false).option("-r, --registry <url>", "registry base URL", DEFAULT_REGISTRY).action(async (opts) => {
+  try {
+    await init({ registry: opts.registry, yes: opts.yes });
+  } catch (err) {
+    console.error(pc3.red("\u2716"), err.message);
+    process.exitCode = 1;
+  }
+});
+program.command("add").description("Add one or more components to your project.").argument("<components...>", "component names, e.g. button card").option("-o, --overwrite", "overwrite existing files", false).option("-r, --registry <url>", "registry base URL", DEFAULT_REGISTRY).action(async (components, opts) => {
+  try {
+    await add(components, { registry: opts.registry, overwrite: opts.overwrite });
+  } catch (err) {
+    console.error(pc3.red("\u2716"), err.message);
+    process.exitCode = 1;
+  }
+});
+program.parseAsync();

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kinetixui/cli",
+  "version": "0.2.0",
+  "description": "Add KinetixUI components and tokens to your project.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://kinetixui.com",
+  "repository": {
+    "type": "git",
+    "url": "ziadfteha/kinetixui"
+  },
+  "bin": {
+    "kinetixui": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsup src/index.ts --format esm --watch --onSuccess \"node dist/index.js\""
+  }
+}