@stackvibe-studio/cli 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StackVibe
+
+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,33 @@
-# Temporary Holding Version
+# @stackvibe-studio/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.
+CLI for scaffolding and installing StackVibe packages into React apps.
+
+## Highlights
+
+- Initialize a project with StackVibe UI dependencies
+- Add individual components by name
+- Keeps project setup quick for design-system adoption
+- Updated in v0.2.0 with more package coverage and component commands
+
+## Install
+
+```bash
+npm install -g @stackvibe-studio/cli
+```
+
+## Commands
+
+```bash
+stackvibe init
+stackvibe add button
+stackvibe add tabs
+stackvibe add spotlight-card
+stackvibe add orb-cluster
+```
+
+## Usage
+
+```bash
+npx @stackvibe-studio/cli init
+npx @stackvibe-studio/cli add button
+```

package/dist/index.cjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/index.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+var import_node_url = require("url");
+var import_meta = {};
+var args = process.argv.slice(2);
+var command = args[0] ?? "help";
+var projectRoot = process.cwd();
+var cliRoot = (0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(import_meta.url));
+function printHelp() {
+  console.log(`StackVibe CLI
+
+Usage:
+  npx @stackvibe-studio/cli init
+  npx @stackvibe-studio/cli add <component>
+
+Available components:
+  button
+  tabs
+  skeleton
+  spotlight-card
+  fade-in-section
+  glass-3d-card
+  orb-cluster
+`);
+}
+function ensurePackageJson() {
+  const pkgPath = (0, import_node_path.join)(projectRoot, "package.json");
+  try {
+    const raw = (0, import_node_fs.readFileSync)(pkgPath, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    console.error(
+      "No package.json found in the target project. Run this inside a React app directory."
+    );
+    process.exit(1);
+  }
+}
+function addComponent(component) {
+  const pkg = ensurePackageJson();
+  const packageMap = {
+    button: "@stackvibe-studio/ui",
+    tabs: "@stackvibe-studio/ui",
+    skeleton: "@stackvibe-studio/ui",
+    "spotlight-card": "@stackvibe-studio/motion",
+    "fade-in-section": "@stackvibe-studio/motion",
+    "glass-3d-card": "@stackvibe-studio/three",
+    "orb-cluster": "@stackvibe-studio/three"
+  };
+  const selected = packageMap[component];
+  if (!selected) {
+    console.error(`Component "${component}" is not available in the registry.`);
+    process.exit(1);
+  }
+  pkg.dependencies ??= {};
+  pkg.dependencies[selected] = pkg.dependencies[selected] ?? "latest";
+  (0, import_node_fs.writeFileSync)((0, import_node_path.join)(projectRoot, "package.json"), `${JSON.stringify(pkg, null, 2)}
+`);
+  console.log(`Added ${component} via ${selected}.`);
+}
+switch (command) {
+  case "init": {
+    const pkg = ensurePackageJson();
+    pkg.dependencies ??= {};
+    pkg.dependencies["@stackvibe-studio/ui"] ??= "latest";
+    (0, import_node_fs.writeFileSync)((0, import_node_path.join)(projectRoot, "package.json"), `${JSON.stringify(pkg, null, 2)}
+`);
+    console.log("StackVibe UI initialized in this project.");
+    break;
+  }
+  case "add": {
+    const component = args[1];
+    if (!component) {
+      console.error("Please provide a component name, for example: stackvibe add button");
+      process.exit(1);
+    }
+    addComponent(component);
+    break;
+  }
+  case "help":
+  default:
+    printHelp();
+    break;
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { readFileSync, writeFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var args = process.argv.slice(2);
+var command = args[0] ?? "help";
+var projectRoot = process.cwd();
+var cliRoot = dirname(fileURLToPath(import.meta.url));
+function printHelp() {
+  console.log(`StackVibe CLI
+
+Usage:
+  npx @stackvibe-studio/cli init
+  npx @stackvibe-studio/cli add <component>
+
+Available components:
+  button
+  tabs
+  skeleton
+  spotlight-card
+  fade-in-section
+  glass-3d-card
+  orb-cluster
+`);
+}
+function ensurePackageJson() {
+  const pkgPath = join(projectRoot, "package.json");
+  try {
+    const raw = readFileSync(pkgPath, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    console.error(
+      "No package.json found in the target project. Run this inside a React app directory."
+    );
+    process.exit(1);
+  }
+}
+function addComponent(component) {
+  const pkg = ensurePackageJson();
+  const packageMap = {
+    button: "@stackvibe-studio/ui",
+    tabs: "@stackvibe-studio/ui",
+    skeleton: "@stackvibe-studio/ui",
+    "spotlight-card": "@stackvibe-studio/motion",
+    "fade-in-section": "@stackvibe-studio/motion",
+    "glass-3d-card": "@stackvibe-studio/three",
+    "orb-cluster": "@stackvibe-studio/three"
+  };
+  const selected = packageMap[component];
+  if (!selected) {
+    console.error(`Component "${component}" is not available in the registry.`);
+    process.exit(1);
+  }
+  pkg.dependencies ??= {};
+  pkg.dependencies[selected] = pkg.dependencies[selected] ?? "latest";
+  writeFileSync(join(projectRoot, "package.json"), `${JSON.stringify(pkg, null, 2)}
+`);
+  console.log(`Added ${component} via ${selected}.`);
+}
+switch (command) {
+  case "init": {
+    const pkg = ensurePackageJson();
+    pkg.dependencies ??= {};
+    pkg.dependencies["@stackvibe-studio/ui"] ??= "latest";
+    writeFileSync(join(projectRoot, "package.json"), `${JSON.stringify(pkg, null, 2)}
+`);
+    console.log("StackVibe UI initialized in this project.");
+    break;
+  }
+  case "add": {
+    const component = args[1];
+    if (!component) {
+      console.error("Please provide a component name, for example: stackvibe add button");
+      process.exit(1);
+    }
+    addComponent(component);
+    break;
+  }
+  case "help":
+  default:
+    printHelp();
+    break;
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@stackvibe-studio/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "type": "module",
+  "description": "CLI for installing and scaffolding StackVibe UI packages.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/StackVibe-Studio/stackvibe-ui.git"
+  },
+  "homepage": "https://stackvibe-studio.github.io/stackvibe-ui/",
+  "bugs": {
+    "url": "https://github.com/StackVibe-Studio/stackvibe-ui/issues"
+  },
+  "license": "MIT",
+  "bin": {
+    "stackvibe": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.1.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --clean && tsc --project tsconfig.json --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit",
+    "dev": "node --loader tsx src/index.ts"
+  }
 }