@nikala-ui/cli 0.6.0

package/dist/utils/theme.js

@@ -0,0 +1,173 @@
+export const BASE_PALETTES = {
+    zinc: {
+        lightBg: "#ffffff",
+        lightFg: "#09090b",
+        darkBg: "#09090b",
+        darkFg: "#fafafa",
+        lightMuted: "#f4f4f5",
+        lightMutedFg: "#71717a",
+        darkMuted: "#27272a",
+        darkMutedFg: "#a1a1aa",
+        lightBorder: "#e4e4e7",
+        darkBorder: "#27272a",
+        lightRing: "#18181b",
+        darkRing: "#d4d4d8",
+    },
+    slate: {
+        lightBg: "#ffffff",
+        lightFg: "#020617",
+        darkBg: "#020617",
+        darkFg: "#f8fafc",
+        lightMuted: "#f1f5f9",
+        lightMutedFg: "#64748b",
+        darkMuted: "#1e293b",
+        darkMutedFg: "#94a3b8",
+        lightBorder: "#e2e8f0",
+        darkBorder: "#1e293b",
+        lightRing: "#0f172a",
+        darkRing: "#cbd5e1",
+    },
+    gray: {
+        lightBg: "#ffffff",
+        lightFg: "#030712",
+        darkBg: "#030712",
+        darkFg: "#f9fafb",
+        lightMuted: "#f3f4f6",
+        lightMutedFg: "#6b7280",
+        darkMuted: "#1f2937",
+        darkMutedFg: "#9ca3af",
+        lightBorder: "#e5e7eb",
+        darkBorder: "#1f2937",
+        lightRing: "#111827",
+        darkRing: "#d1d5db",
+    },
+    neutral: {
+        lightBg: "#ffffff",
+        lightFg: "#0a0a0a",
+        darkBg: "#0a0a0a",
+        darkFg: "#fafafa",
+        lightMuted: "#f5f5f5",
+        lightMutedFg: "#737373",
+        darkMuted: "#262626",
+        darkMutedFg: "#a3a3a3",
+        lightBorder: "#e5e5e5",
+        darkBorder: "#262626",
+        lightRing: "#171717",
+        darkRing: "#d4d4d4",
+    },
+    stone: {
+        lightBg: "#ffffff",
+        lightFg: "#0c0a09",
+        darkBg: "#0c0a09",
+        darkFg: "#fafaf9",
+        lightMuted: "#f5f5f4",
+        lightMutedFg: "#78716c",
+        darkMuted: "#292524",
+        darkMutedFg: "#a8a29e",
+        lightBorder: "#e7e5e4",
+        darkBorder: "#292524",
+        lightRing: "#1c1917",
+        darkRing: "#d6d3d1",
+    },
+};
+export const PRIMARY_COLORS = {
+    wine: { light: "#722f37", dark: "#9e3b47", lightFg: "#ffffff", darkFg: "#ffffff" },
+    violet: { light: "#7c3aed", dark: "#8b5cf6", lightFg: "#ffffff", darkFg: "#ffffff" },
+    sky: { light: "#0284c7", dark: "#38bdf8", lightFg: "#ffffff", darkFg: "#0f172a" },
+    emerald: { light: "#059669", dark: "#34d399", lightFg: "#ffffff", darkFg: "#052e16" },
+    rose: { light: "#e11d48", dark: "#fb7185", lightFg: "#ffffff", darkFg: "#ffffff" },
+    amber: { light: "#d97706", dark: "#fbbf24", lightFg: "#ffffff", darkFg: "#111827" },
+    zinc: { light: "#18181b", dark: "#fafafa", lightFg: "#fafafa", darkFg: "#18181b" },
+};
+/**
+ * Generates Tailwind CSS v4 theme variables based on base palette and primary accent color.
+ */
+export function generateThemeCss(baseColor = "zinc", primaryColor = "wine") {
+    const base = BASE_PALETTES[baseColor] || BASE_PALETTES.zinc;
+    const primary = PRIMARY_COLORS[primaryColor] || PRIMARY_COLORS.wine;
+    return `@import "tailwindcss";
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --radius-lg: var(--radius);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-sm: calc(var(--radius) - 4px);
+}
+
+:root {
+  color-scheme: light;
+  --background: ${base.lightBg};
+  --foreground: ${base.lightFg};
+  --card: ${base.lightBg};
+  --card-foreground: ${base.lightFg};
+  --popover: ${base.lightBg};
+  --popover-foreground: ${base.lightFg};
+  --primary: ${primary.light};
+  --primary-foreground: ${primary.lightFg};
+  --secondary: ${base.lightMuted};
+  --secondary-foreground: ${base.lightFg};
+  --muted: ${base.lightMuted};
+  --muted-foreground: ${base.lightMutedFg};
+  --accent: ${base.lightMuted};
+  --accent-foreground: ${base.lightFg};
+  --destructive: #ef4444;
+  --destructive-foreground: #ffffff;
+  --border: ${base.lightBorder};
+  --input: ${base.lightBorder};
+  --ring: ${base.lightRing};
+  --radius: 0.5rem;
+}
+
+.dark {
+  color-scheme: dark;
+  --background: ${base.darkBg};
+  --foreground: ${base.darkFg};
+  --card: ${base.darkBg};
+  --card-foreground: ${base.darkFg};
+  --popover: ${base.darkBg};
+  --popover-foreground: ${base.darkFg};
+  --primary: ${primary.dark};
+  --primary-foreground: ${primary.darkFg};
+  --secondary: ${base.darkMuted};
+  --secondary-foreground: ${base.darkFg};
+  --muted: ${base.darkMuted};
+  --muted-foreground: ${base.darkMutedFg};
+  --accent: ${base.darkMuted};
+  --accent-foreground: ${base.darkFg};
+  --destructive: #7f1d1d;
+  --destructive-foreground: #ffffff;
+  --border: ${base.darkBorder};
+  --input: ${base.darkBorder};
+  --ring: ${base.darkRing};
+  --radius: 0.5rem;
+}
+
+@layer base {
+  * {
+    border-color: var(--border);
+  }
+  body {
+    background-color: var(--background);
+    color: var(--foreground);
+  }
+}
+`;
+}

package/dist/utils/validate/check-config.d.ts

@@ -0,0 +1,11 @@
+export interface CheckResult {
+    passed: boolean;
+    message: string;
+    details?: string;
+}
+/**
+ * Diagnostic check verifying existence and valid alias mapping in nikala.config.json.
+ *
+ * @param cwd - Working directory path of the target project
+ */
+export declare function checkConfig(cwd?: string): Promise<CheckResult>;

package/dist/utils/validate/check-config.js

@@ -0,0 +1,47 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { readConfig } from "../file.js";
+/**
+ * Diagnostic check verifying existence and valid alias mapping in nikala.config.json.
+ *
+ * @param cwd - Working directory path of the target project
+ */
+export async function checkConfig(cwd = process.cwd()) {
+    const configPath = path.join(cwd, "nikala.config.json");
+    if (!(await fs.pathExists(configPath))) {
+        return {
+            passed: false,
+            message: "nikala.config.json manifest missing",
+            details: "Run `nikala init` to initialize workspace configuration.",
+        };
+    }
+    try {
+        const config = await readConfig(cwd);
+        if (!config || !config.alias || !config.alias.components || !config.alias.utils) {
+            return {
+                passed: false,
+                message: "Invalid nikala.config.json structure",
+                details: "Required properties (alias.components, alias.utils) are missing.",
+            };
+        }
+        const componentsDir = path.resolve(cwd, config.alias.components);
+        if (!(await fs.pathExists(componentsDir))) {
+            return {
+                passed: false,
+                message: `Components directory not found: ${config.alias.components}`,
+                details: "Create the folder manually or update nikala.config.json alias.",
+            };
+        }
+        return {
+            passed: true,
+            message: "nikala.config.json configuration valid",
+        };
+    }
+    catch (error) {
+        return {
+            passed: false,
+            message: "Failed to parse nikala.config.json",
+            details: String(error),
+        };
+    }
+}

package/dist/utils/validate/check-css.d.ts

@@ -0,0 +1,7 @@
+import type { CheckResult } from "./check-config.js";
+/**
+ * Diagnostic check verifying existence and Tailwind v4 setup in target CSS file.
+ *
+ * @param cwd - Working directory path of the target project
+ */
+export declare function checkCss(cwd?: string): Promise<CheckResult>;

package/dist/utils/validate/check-css.js

@@ -0,0 +1,50 @@
+import fs from "fs-extra";
+import path from "node:path";
+import { readConfig } from "../file.js";
+/**
+ * Diagnostic check verifying existence and Tailwind v4 setup in target CSS file.
+ *
+ * @param cwd - Working directory path of the target project
+ */
+export async function checkCss(cwd = process.cwd()) {
+    const config = await readConfig(cwd);
+    const cssPathRelative = config?.css || "src/index.css";
+    const cssPath = path.resolve(cwd, cssPathRelative);
+    if (!(await fs.pathExists(cssPath))) {
+        return {
+            passed: false,
+            message: `CSS file missing: ${cssPathRelative}`,
+            details: "Ensure the primary CSS file specified in nikala.config.json exists.",
+        };
+    }
+    try {
+        const cssContent = await fs.readFile(cssPath, "utf-8");
+        if (!cssContent.includes('@import "tailwindcss"') && !cssContent.includes("@import 'tailwindcss'")) {
+            return {
+                passed: false,
+                message: `Tailwind CSS import missing in ${cssPathRelative}`,
+                details: 'Add `@import "tailwindcss";` to the top of your CSS file.',
+            };
+        }
+        const requiredTokens = ["--primary", "--background", "--foreground", "--border"];
+        const missingTokens = requiredTokens.filter((token) => !cssContent.includes(token));
+        if (missingTokens.length > 0) {
+            return {
+                passed: false,
+                message: `Incomplete CSS theme tokens in ${cssPathRelative}`,
+                details: `Missing variables: ${missingTokens.join(", ")}. Run \`nikala theme set\` to regenerate CSS setup.`,
+            };
+        }
+        return {
+            passed: true,
+            message: `CSS theme configuration valid in ${cssPathRelative}`,
+        };
+    }
+    catch (error) {
+        return {
+            passed: false,
+            message: `Failed to read ${cssPathRelative}`,
+            details: String(error),
+        };
+    }
+}

package/dist/utils/validate/check-deps.d.ts

@@ -0,0 +1,7 @@
+import type { CheckResult } from "./check-config.js";
+/**
+ * Diagnostic check verifying required runtime and Tailwind CSS v4 packages in target package.json.
+ *
+ * @param cwd - Working directory path of the target project
+ */
+export declare function checkDeps(cwd?: string): Promise<CheckResult>;

package/dist/utils/validate/check-deps.js

@@ -0,0 +1,52 @@
+import fs from "fs-extra";
+import path from "node:path";
+import stripJsonComments from "strip-json-comments";
+/**
+ * Diagnostic check verifying required runtime and Tailwind CSS v4 packages in target package.json.
+ *
+ * @param cwd - Working directory path of the target project
+ */
+export async function checkDeps(cwd = process.cwd()) {
+    const pkgPath = path.join(cwd, "package.json");
+    if (!(await fs.pathExists(pkgPath))) {
+        return {
+            passed: false,
+            message: "package.json file missing",
+            details: "Ensure you are running the command in the root of a Node/Bun workspace.",
+        };
+    }
+    try {
+        const raw = await fs.readFile(pkgPath, "utf-8");
+        const pkg = JSON.parse(stripJsonComments(raw));
+        const installed = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        const coreDeps = [
+            "clsx",
+            "tailwind-merge",
+            "class-variance-authority",
+            "tailwindcss",
+            "@tailwindcss/vite",
+        ];
+        const missing = coreDeps.filter((dep) => !installed[dep]);
+        if (missing.length > 0) {
+            return {
+                passed: false,
+                message: `Missing ${missing.length} core dependencies`,
+                details: `Missing packages: ${missing.join(", ")}. Run \`bun add ${missing.join(" ")}\` to install.`,
+            };
+        }
+        return {
+            passed: true,
+            message: "All core runtime and Tailwind CSS v4 packages installed",
+        };
+    }
+    catch (error) {
+        return {
+            passed: false,
+            message: "Failed to parse package.json",
+            details: String(error),
+        };
+    }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@nikala-ui/cli",
+  "version": "0.6.0",
+  "description": "Command line interface for Nikala UI",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "nikala": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "commander": "^15.0.0",
+    "fs-extra": "^11.3.6",
+    "picocolors": "^1.1.1",
+    "prompts": "^2.4.2",
+    "strip-json-comments": "^5.0.3"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^26.1.1",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.7.2"
+  }
+}