voidui-cli 0.1.0

package/dist/utils/registry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Registry API client for fetching component metadata
+ */
+import type { RegistryItem } from "../types/registry.js";
+/**
+ * Fetch component metadata from the registry
+ * Includes retry logic for network failures
+ *
+ * @param componentName - Name of the component (e.g., "separator")
+ * @param registryUrl - Base registry URL
+ * @returns Registry item or null if not found
+ */
+export declare function fetchRegistryItem(componentName: string, registryUrl: string): Promise<RegistryItem | null>;
+/**
+ * Fetch specific version of a component from the registry
+ * Note: This fetches from the versions endpoint in the registry
+ *
+ * @param componentName - Name of the component
+ * @param version - Semantic version (e.g., "1.0.0")
+ * @param registryUrl - Base registry URL
+ * @returns Component source code or null if not found
+ */
+export declare function fetchComponentVersion(componentName: string, version: string, registryUrl: string): Promise<string | null>;
+/**
+ * Extract component source code from a registry item
+ * Finds the main component file (usually in components/ui/)
+ *
+ * @param registryItem - Registry item metadata
+ * @returns Component source code
+ */
+export declare function extractComponentCode(registryItem: RegistryItem): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/utils/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAuB9B;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBxB;AAqDD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAavE"}

package/dist/utils/registry.js

@@ -0,0 +1,139 @@
+/**
+ * Registry API client for fetching component metadata
+ */
+import path from "path";
+import { readFile } from "fs/promises";
+import { fileExists } from "./file-operations.js";
+/**
+ * Fetch component metadata from the registry
+ * Includes retry logic for network failures
+ *
+ * @param componentName - Name of the component (e.g., "separator")
+ * @param registryUrl - Base registry URL
+ * @returns Registry item or null if not found
+ */
+export async function fetchRegistryItem(componentName, registryUrl) {
+    const url = `${registryUrl}/${componentName}.json`;
+    try {
+        const response = await fetchWithRetry(url, { maxRetries: 1 });
+        if (!response.ok) {
+            if (response.status === 404) {
+                return null;
+            }
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes("fetch failed")) {
+            throw new Error(`Failed to fetch registry data. Check your internet connection.\n   Tried: ${url}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Fetch specific version of a component from the registry
+ * Note: This fetches from the versions endpoint in the registry
+ *
+ * @param componentName - Name of the component
+ * @param version - Semantic version (e.g., "1.0.0")
+ * @param registryUrl - Base registry URL
+ * @returns Component source code or null if not found
+ */
+export async function fetchComponentVersion(componentName, version, registryUrl) {
+    const item = await fetchRegistryItem(componentName, registryUrl);
+    if (!item) {
+        return null;
+    }
+    // If requesting current version, return from files
+    if (item.meta?.versioning?.currentVersion === version) {
+        return extractComponentCode(item);
+    }
+    // For historical versions, try localhost file system fallback for local development
+    if (registryUrl.includes("localhost") || registryUrl.includes("127.0.0.1")) {
+        const localVersion = await tryFetchLocalVersion(componentName, version);
+        if (localVersion) {
+            return localVersion;
+        }
+    }
+    // For historical versions on production, we'd need to fetch from a versions endpoint
+    // This requires registry infrastructure to serve historical versions
+    return null;
+}
+/**
+ * Try to fetch a historical version from local file system
+ * Only used for local development testing
+ *
+ * @param componentName - Name of the component
+ * @param version - Semantic version
+ * @returns Component source code or null if not found
+ */
+async function tryFetchLocalVersion(componentName, version) {
+    // Try common local paths for version files
+    const possiblePaths = [
+        // From www-docs directory
+        path.join(process.cwd(), "registry", "components", "ui", `${componentName}.versions`, `${version}.tsx`),
+        // From monorepo root
+        path.join(process.cwd(), "apps", "www-docs", "registry", "components", "ui", `${componentName}.versions`, `${version}.tsx`),
+    ];
+    for (const versionPath of possiblePaths) {
+        if (await fileExists(versionPath)) {
+            try {
+                const content = await readFile(versionPath, "utf-8");
+                return content;
+            }
+            catch (error) {
+                // Continue trying other paths
+                continue;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Extract component source code from a registry item
+ * Finds the main component file (usually in components/ui/)
+ *
+ * @param registryItem - Registry item metadata
+ * @returns Component source code
+ */
+export function extractComponentCode(registryItem) {
+    // Find the main UI component file
+    const mainFile = registryItem.files.find((file) => file.type === "registry:ui" || file.path.includes("/components/ui/"));
+    if (!mainFile) {
+        // Fallback to first file if no UI file found
+        return registryItem.files[0]?.content || "";
+    }
+    return mainFile.content;
+}
+/**
+ * Fetch with retry logic
+ *
+ * @param url - URL to fetch
+ * @param options - Fetch options with maxRetries
+ * @returns Fetch response
+ */
+async function fetchWithRetry(url, options = {}) {
+    const maxRetries = options.maxRetries ?? 1;
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    "User-Agent": "voidui-cli",
+                },
+            });
+            return response;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Don't retry on last attempt
+            if (attempt < maxRetries) {
+                // Wait 2 seconds before retry
+                await new Promise((resolve) => setTimeout(resolve, 2000));
+            }
+        }
+    }
+    throw lastError || new Error("Fetch failed");
+}

package/dist/utils/shadcn.d.ts

@@ -0,0 +1,30 @@
+/**
+ * shadcn CLI integration utilities
+ * Handles executing shadcn CLI commands
+ */
+export interface ShadcnOptions {
+    /**
+     * Registry URL
+     */
+    registryUrl: string;
+    /**
+     * Whether to show command output
+     * @default true
+     */
+    silent?: boolean;
+}
+/**
+ * Execute shadcn add command to install a component
+ *
+ * @param componentName - Component to install
+ * @param options - Execution options
+ * @returns Promise that resolves when installation completes
+ */
+export declare function execShadcnAdd(componentName: string, options: ShadcnOptions): Promise<void>;
+/**
+ * Check if shadcn CLI is available
+ *
+ * @returns Promise that resolves to true if shadcn is available
+ */
+export declare function isShadcnAvailable(): Promise<boolean>;
+//# sourceMappingURL=shadcn.d.ts.map

package/dist/utils/shadcn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadcn.d.ts","sourceRoot":"","sources":["../../src/utils/shadcn.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAe1D"}

package/dist/utils/shadcn.js

@@ -0,0 +1,67 @@
+/**
+ * shadcn CLI integration utilities
+ * Handles executing shadcn CLI commands
+ */
+import { spawn } from "child_process";
+import chalk from "chalk";
+/**
+ * Execute shadcn add command to install a component
+ *
+ * @param componentName - Component to install
+ * @param options - Execution options
+ * @returns Promise that resolves when installation completes
+ */
+export async function execShadcnAdd(componentName, options) {
+    const { registryUrl, silent = false } = options;
+    // Build the component URL
+    const componentUrl = `${registryUrl}/${componentName}`;
+    if (!silent) {
+        console.log(chalk.blue(`\n📦 Installing ${componentName} via shadcn...\n`));
+    }
+    return new Promise((resolve, reject) => {
+        // Spawn npx shadcn@latest add <component-url>
+        const child = spawn("npx", [
+            "shadcn@latest",
+            "add",
+            componentUrl,
+            "--yes", // Auto-confirm prompts
+            "--overwrite", // Overwrite if exists (for --force mode)
+        ], {
+            stdio: silent ? "pipe" : "inherit", // Inherit to show output to user
+            shell: true,
+        });
+        child.on("error", (error) => {
+            reject(new Error(`Failed to execute shadcn CLI: ${error.message}\nMake sure npx is available in your PATH.`));
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                if (!silent) {
+                    console.log(chalk.green(`\n✓ Component installed successfully\n`));
+                }
+                resolve();
+            }
+            else {
+                reject(new Error(`shadcn CLI exited with code ${code}. Installation failed.`));
+            }
+        });
+    });
+}
+/**
+ * Check if shadcn CLI is available
+ *
+ * @returns Promise that resolves to true if shadcn is available
+ */
+export async function isShadcnAvailable() {
+    return new Promise((resolve) => {
+        const child = spawn("npx", ["shadcn@latest", "--version"], {
+            stdio: "pipe",
+            shell: true,
+        });
+        child.on("error", () => {
+            resolve(false);
+        });
+        child.on("close", (code) => {
+            resolve(code === 0);
+        });
+    });
+}

package/dist/validators/changelog.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+export declare const changelogChangeSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        added: "added";
+        changed: "changed";
+        deprecated: "deprecated";
+        removed: "removed";
+        fixed: "fixed";
+        security: "security";
+    }>;
+    description: z.ZodString;
+}, z.core.$strip>;
+export declare const changelogEntrySchema: z.ZodObject<{
+    version: z.ZodString;
+    date: z.ZodString;
+    changes: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            added: "added";
+            changed: "changed";
+            deprecated: "deprecated";
+            removed: "removed";
+            fixed: "fixed";
+            security: "security";
+        }>;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    breaking: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const componentChangelogSchema: z.ZodObject<{
+    component: z.ZodString;
+    currentVersion: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        version: z.ZodString;
+        date: z.ZodString;
+        changes: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                added: "added";
+                changed: "changed";
+                deprecated: "deprecated";
+                removed: "removed";
+                fixed: "fixed";
+                security: "security";
+            }>;
+            description: z.ZodString;
+        }, z.core.$strip>>;
+        breaking: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type { z } from "zod";
+//# sourceMappingURL=changelog.d.ts.map

package/dist/validators/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/validators/changelog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAUhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;iBAS/B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;iBAQnC,CAAC;AAEH,YAAY,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/validators/changelog.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export const changelogChangeSchema = z.object({
+    type: z.enum([
+        "added",
+        "changed",
+        "deprecated",
+        "removed",
+        "fixed",
+        "security",
+    ]),
+    description: z.string().min(1, "Description cannot be empty"),
+});
+export const changelogEntrySchema = z.object({
+    version: z
+        .string()
+        .regex(/^\d+\.\d+\.\d+$/, "Version must be in semver format (e.g., 1.0.0)"),
+    date: z.string().datetime("Date must be in ISO 8601 format"),
+    changes: z
+        .array(changelogChangeSchema)
+        .min(1, "At least one change is required"),
+    breaking: z.boolean().optional(),
+});
+export const componentChangelogSchema = z.object({
+    component: z.string().min(1, "Component name cannot be empty"),
+    currentVersion: z
+        .string()
+        .regex(/^\d+\.\d+\.\d+$/, "Version must be in semver format (e.g., 1.0.0)"),
+    entries: z
+        .array(changelogEntrySchema)
+        .min(1, "At least one changelog entry is required"),
+});

package/dist/validators/lock-file.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Zod validators for lock file structure
+ */
+import { z } from "zod";
+/**
+ * Schema for a single component lock entry
+ */
+export declare const componentLockEntrySchema: z.ZodObject<{
+    installedVersion: z.ZodString;
+    installedAt: z.ZodString;
+    checksum: z.ZodString;
+    registryUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for the complete lock file
+ */
+export declare const lockFileSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    components: z.ZodRecord<z.ZodString, z.ZodObject<{
+        installedVersion: z.ZodString;
+        installedAt: z.ZodString;
+        checksum: z.ZodString;
+        registryUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Infer TypeScript types from schemas
+ */
+export type ComponentLockEntry = z.infer<typeof componentLockEntrySchema>;
+export type LockFile = z.infer<typeof lockFileSchema>;
+//# sourceMappingURL=lock-file.d.ts.map

package/dist/validators/lock-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-file.d.ts","sourceRoot":"","sources":["../../src/validators/lock-file.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;iBAKnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;iBAIzB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/validators/lock-file.js

@@ -0,0 +1,39 @@
+/**
+ * Zod validators for lock file structure
+ */
+import { z } from "zod";
+/**
+ * Validates a semver version string (e.g., "1.2.0")
+ */
+const semverSchema = z.string().regex(/^\d+\.\d+\.\d+$/, {
+    message: "Version must be in semver format (e.g., 1.2.0)",
+});
+/**
+ * Validates a SHA-256 checksum string
+ */
+const checksumSchema = z.string().regex(/^sha256:[a-f0-9]{64}$/, {
+    message: "Checksum must be in format: sha256:[64 hex chars]",
+});
+/**
+ * Validates an ISO 8601 datetime string
+ */
+const isoDateSchema = z.string().datetime({
+    message: "Date must be in ISO 8601 format",
+});
+/**
+ * Schema for a single component lock entry
+ */
+export const componentLockEntrySchema = z.object({
+    installedVersion: semverSchema,
+    installedAt: isoDateSchema,
+    checksum: checksumSchema,
+    registryUrl: z.string().url().optional(),
+});
+/**
+ * Schema for the complete lock file
+ */
+export const lockFileSchema = z.object({
+    $schema: z.string().optional(),
+    version: z.string(),
+    components: z.record(z.string(), componentLockEntrySchema),
+});

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "voidui-cli",
+  "version": "0.1.0",
+  "description": "CLI tools for voidui component versioning",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mnove/voidui.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/mnove/voidui#readme",
+  "bugs": {
+    "url": "https://github.com/mnove/voidui/issues"
+  },
+  "keywords": [
+    "voidui",
+    "cli",
+    "component",
+    "versioning"
+  ],
+  "type": "module",
+  "bin": {
+    "voidui": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint . --max-warnings 0"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^12.1.0",
+    "diff": "^8.0.3",
+    "glob": "^10.3.10",
+    "node-diff3": "^3.1.2",
+    "prompts": "^2.4.2",
+    "zod": "^4.0.17"
+  },
+  "devDependencies": {
+    "@types/node": "^24.1.0",
+    "@types/prompts": "^2.4.9",
+    "@workspace/eslint-config": "workspace:*",
+    "@workspace/typescript-config": "workspace:*",
+    "eslint": "^9.32.0",
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}