primitiv-ui 0.0.1 → 0.1.1

package/README.md

@@ -1,9 +1,44 @@
-# primitiv-ui (placeholder)
+# primitiv-ui
 
-Reserves the unscoped npm name **`primitiv-ui`** — the package that will ship the
-Primitiv design system CLI (command: `primitiv`). See
-[`docs/rfcs/0005-primitiv-cli.md`](../../docs/rfcs/0005-primitiv-cli.md).
+The **Primitiv UI** design-system CLI. Add headless, accessible,
+fully-styled components — and their design tokens — to any Vite or
+Next.js project from the command line.
 
-This is a placeholder that prints a "coming soon" notice. It will be replaced by
-the real CLI build at a higher version. Publishing instructions live in
-[`../README.md`](../README.md).
+## Install
+
+```sh
+npm i -D primitiv-ui
+# or: pnpm add -D primitiv-ui
+```
+
+This provides the `primitiv` command. The CLI is a small native binary
+(written in Rust); `primitiv-ui` is a thin launcher that pulls in the
+matching per-platform package via `optionalDependencies` and runs it — so
+you only download the one binary your machine needs.
+
+## Usage
+
+```sh
+primitiv init          # scaffold primitiv.json and wire up tokens/theme
+primitiv add button    # add a component: styled surface + headless React + contract
+primitiv tokens        # emit design tokens (CSS / SCSS / Tailwind)
+primitiv theme         # emit the theme overrides layer
+primitiv list          # list available components and what's installed
+```
+
+Pass `--help` to any command for its flags (e.g. `primitiv add --help`).
+
+## Supported platforms
+
+macOS (arm64, x64), Linux (x64, arm64 — glibc), and Windows (x64). On any
+other target, install the binary from source:
+
+```sh
+cargo install primitiv-cli
+```
+
+> **Native binary.** This won't run inside StackBlitz / WebContainer — their
+> in-browser WASM Node can't execute native binaries. Use a local, Codespace,
+> or Docker Node environment.
+
+Part of the [Primitiv](https://github.com/primitiv-ui/primitiv) design system.

package/bin/primitiv.mjs

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { spawnSync } from 'child_process';
+import { createRequire } from 'module';
+import { dirname, join } from 'path';
+import { existsSync } from 'fs';
+
+const require = createRequire(import.meta.url);
+
+const PLATFORM_PACKAGES = {
+  'darwin:arm64': '@primitiv-ui/cli-darwin-arm64',
+  'darwin:x64':   '@primitiv-ui/cli-darwin-x64',
+  'linux:x64':    '@primitiv-ui/cli-linux-x64-gnu',
+  'linux:arm64':  '@primitiv-ui/cli-linux-arm64-gnu',
+  'win32:x64':    '@primitiv-ui/cli-win32-x64',
+};
+
+const key = `${process.platform}:${process.arch}`;
+const pkg = PLATFORM_PACKAGES[key];
+
+if (!pkg) {
+  process.stderr.write(
+    `primitiv: unsupported platform (${process.platform}/${process.arch}).\n` +
+    `Install from source: cargo install primitiv-cli\n`
+  );
+  process.exit(1);
+}
+
+let binaryPath;
+try {
+  const pkgDir = dirname(require.resolve(`${pkg}/package.json`));
+  const binary = process.platform === 'win32' ? 'primitiv.exe' : 'primitiv';
+  binaryPath = join(pkgDir, binary);
+} catch {
+  process.stderr.write(
+    `primitiv: the ${pkg} platform package could not be found.\n` +
+    `Try reinstalling: pnpm add -D primitiv-ui\n` +
+    `Or install from source: cargo install primitiv-cli\n`
+  );
+  process.exit(1);
+}
+
+if (!existsSync(binaryPath)) {
+  process.stderr.write(
+    `primitiv: binary not found at ${binaryPath}.\n` +
+    `Try: cargo install primitiv-cli\n`
+  );
+  process.exit(1);
+}
+
+const { status } = spawnSync(binaryPath, process.argv.slice(2), { stdio: 'inherit' });
+process.exit(status ?? 1);

package/package.json

@@ -1,20 +1,25 @@
 {
   "name": "primitiv-ui",
-  "version": "0.0.1",
-  "description": "Primitiv design system CLI (placeholder; in development). Headless components ship as @primitiv-ui/react, /icons, /tokens.",
+  "version": "0.1.1",
+  "description": "Primitiv UI — the design system CLI. Run `primitiv add button` in any Vite or Next.js project.",
+  "keywords": ["primitiv", "design-system", "cli", "react", "tailwind"],
   "bin": {
-    "primitiv": "bin/primitiv.js"
+    "primitiv": "./bin/primitiv.mjs"
   },
-  "files": [
-    "bin"
-  ],
-  "keywords": [
-    "primitiv",
-    "primitiv-ui",
-    "design-system",
-    "cli"
-  ],
-  "publishConfig": {
-    "access": "public"
-  }
+  "files": ["bin"],
+  "engines": { "node": ">=18" },
+  "optionalDependencies": {
+    "@primitiv-ui/cli-darwin-arm64": "0.1.1",
+    "@primitiv-ui/cli-darwin-x64": "0.1.1",
+    "@primitiv-ui/cli-linux-x64-gnu": "0.1.1",
+    "@primitiv-ui/cli-linux-arm64-gnu": "0.1.1",
+    "@primitiv-ui/cli-win32-x64": "0.1.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/primitiv-ui/primitiv.git",
+    "directory": "npm/cli-wrapper"
+  },
+  "license": "MIT",
+  "publishConfig": { "access": "public" }
 }

package/bin/primitiv.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-// Placeholder for the Primitiv design system CLI (command: `primitiv`).
-// The real CLI is in development — see docs/rfcs/0005-primitiv-cli.md.
-console.log(
-  [
-    "primitiv-ui — coming soon.",
-    "The Primitiv design system CLI is in development.",
-    "Headless components are published as @primitiv-ui/react (and /icons, /tokens).",
-  ].join("\n")
-);