@noarka/cli 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Noarka
+
+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,19 @@
-# Temporary Holding Version
+# @noarka/cli
 
-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.
+Scaffold Noarka UI primitives into your project, shadcn-style.
+
+```bash
+npx @noarka/cli init
+npx @noarka/cli add button
+npx @noarka/cli list
+```
+
+- `init` writes `utils/cn.ts` once per project.
+- `add <component>` copies the primitive to `components/ui/` (lowercase
+  basenames, same-dir imports rewritten) and writes `utils/cn.ts` if missing.
+  Components that use another primitive print a follow-up `add` command.
+- Templates ship inside `@noarka/ui` itself, so scaffolded code always
+  matches the installed library version.
+
+Options: `--dir <path>` scaffolds into another project root, `--overwrite`
+replaces existing files.

package/dist/cli.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import fs from "fs";
+import path from "path";
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+function cliVersion() {
+  try {
+    const pkg = require2("../package.json");
+    return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+function uiRoot() {
+  try {
+    return path.dirname(require2.resolve("@noarka/ui/package.json"));
+  } catch {
+    console.error(
+      "Could not find @noarka/ui. Install it first:\n  npm install @noarka/ui"
+    );
+    process.exit(1);
+  }
+}
+function primitivesDir() {
+  return path.join(uiRoot(), "src", "primitives");
+}
+function normalize(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function slugifyDir(dir) {
+  return dir.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function available() {
+  return fs.readdirSync(primitivesDir(), { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+}
+function findDir(name) {
+  const want = normalize(name);
+  return available().find((d) => normalize(d) === want) ?? null;
+}
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+function writeFile(target, content, overwrite) {
+  if (fs.existsSync(target) && !overwrite) {
+    return "skipped (exists, use --overwrite to replace)";
+  }
+  ensureDir(path.dirname(target));
+  fs.writeFileSync(target, content, "utf8");
+  return "created";
+}
+function readTemplate(rel) {
+  return fs.readFileSync(path.join(uiRoot(), rel), "utf8");
+}
+function scaffoldName(basename) {
+  return basename.charAt(0).toLowerCase() + basename.slice(1);
+}
+function rewriteImports(source) {
+  return source.replace(/from\s+["']\.\/([^"']+)["']/g, (_m, spec) => {
+    const parts = spec.split("/");
+    parts[parts.length - 1] = scaffoldName(parts[parts.length - 1]);
+    return `from "./${parts.join("/")}"`;
+  });
+}
+function ensureCn(projectDir, overwrite) {
+  const target = path.join(projectDir, "utils", "cn.ts");
+  const content = readTemplate(path.join("src", "utils", "cn.ts"));
+  return { target, status: writeFile(target, content, overwrite) };
+}
+function componentFiles(dir) {
+  return fs.readdirSync(path.join(primitivesDir(), dir)).filter((f) => f !== "index.ts" && (f.endsWith(".tsx") || f.endsWith(".ts"))).sort();
+}
+function peerDeps(dir) {
+  const deps = /* @__PURE__ */ new Set();
+  for (const file of componentFiles(dir)) {
+    const src = readTemplate(path.join("src", "primitives", dir, file));
+    for (const match of src.matchAll(/from\s+["']\.\.\/([^/"']+)/g)) {
+      if (match[1] === ".." || match[1] === "utils") continue;
+      if (match[1] !== dir) deps.add(slugifyDir(match[1]));
+    }
+  }
+  return [...deps].sort();
+}
+function cmdInit(projectDir, overwrite) {
+  const { target, status } = ensureCn(projectDir, overwrite);
+  console.log(`${status}: ${path.relative(process.cwd(), target)}`);
+  console.log("\nNext: import the design tokens once in your global CSS:");
+  console.log('  @import "@noarka/ui/styles/tokens.css";');
+  console.log('  @import "@noarka/ui/styles/base.css";');
+  console.log('  @source "../node_modules/@noarka/ui/dist/**/*.js";');
+}
+function cmdAdd(name, projectDir, overwrite) {
+  const dir = findDir(name);
+  if (!dir) {
+    console.error(`Unknown component "${name}".
+`);
+    cmdList();
+    process.exit(1);
+  }
+  for (const file of componentFiles(dir)) {
+    const src = readTemplate(path.join("src", "primitives", dir, file));
+    const target = path.join(projectDir, "components", "ui", scaffoldName(file));
+    console.log(`${writeFile(target, rewriteImports(src), overwrite)}: ${path.relative(process.cwd(), target)}`);
+  }
+  const cn = ensureCn(projectDir, overwrite);
+  console.log(`${cn.status}: ${path.relative(process.cwd(), cn.target)}`);
+  const peers = peerDeps(dir).filter((d) => normalize(d) !== normalize(dir));
+  if (peers.length > 0) {
+    console.log(`
+This component also uses: ${peers.join(", ")}`);
+    console.log(`Run: noarka add ${peers.join(" ")}`);
+  }
+}
+function cmdList() {
+  console.log("Available components:");
+  for (const dir of available()) {
+    console.log(`  ${slugifyDir(dir)}`);
+  }
+}
+function help() {
+  console.log(`noarka: scaffold Noarka UI primitives into your project.
+
+Usage:
+  noarka init [options]            write utils/cn.ts once per project
+  noarka add <component> [options]  copy a primitive to components/ui/
+  noarka list                      show available components
+
+Options:
+  --dir <path>   project root to scaffold into (default: current directory)
+  --overwrite    replace files that already exist
+  -h, --help     show this message
+  -v, --version  show the version`);
+}
+function parseArgs(argv) {
+  const opts2 = { dir: process.cwd(), overwrite: false };
+  const rest2 = [];
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === "--dir" && argv[i + 1]) {
+      opts2.dir = path.resolve(argv[i + 1]);
+      i += 1;
+    } else if (arg === "--overwrite") {
+      opts2.overwrite = true;
+    } else if (arg === "-h" || arg === "--help") {
+      help();
+      process.exit(0);
+    } else if (arg === "-v" || arg === "--version") {
+      console.log(cliVersion());
+      process.exit(0);
+    } else if (arg.startsWith("-")) {
+      console.error(`Unknown option "${arg}". See: noarka --help`);
+      process.exit(1);
+    } else {
+      rest2.push(arg);
+    }
+  }
+  return { opts: opts2, rest: rest2 };
+}
+var { opts, rest } = parseArgs(process.argv.slice(2));
+var [command, ...names] = rest;
+if (command === "init") {
+  cmdInit(opts.dir, opts.overwrite);
+} else if (command === "add") {
+  if (names.length === 0) {
+    console.error("Specify at least one component. See: noarka list");
+    process.exit(1);
+  }
+  for (const name of names) cmdAdd(name, opts.dir, opts.overwrite);
+} else if (command === "list") {
+  cmdList();
+} else if (!command) {
+  help();
+} else {
+  console.error(`Unknown command "${command}". See: noarka --help`);
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@noarka/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Scaffold Noarka UI primitives into your project, shadcn-style.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "noarka": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "noarka",
+    "ui",
+    "cli",
+    "scaffold",
+    "components"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@noarka/ui": "^0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --clean",
+    "typecheck": "tsc --noEmit"
+  }
 }