@zentauri-ui/zentauri-components 2.1.5 → 2.1.7

package/README.md

@@ -15,7 +15,7 @@ Published artifacts live under `dist/`. Imports use **per-entry subpaths**: `@ze
 
 | Surface             | Count | Import shape                                          |
 | ------------------- | ----: | ----------------------------------------------------- |
-| Static UI entries   |    41 | `@zentauri-ui/zentauri-components/ui/<name>`          |
+| Static UI entries   |    42 | `@zentauri-ui/zentauri-components/ui/<name>`          |
 | Animated UI entries |    27 | `@zentauri-ui/zentauri-components/ui/<name>/animated` |
 | Animation entries   |    41 | `@zentauri-ui/zentauri-components/animations/<name>`  |
 | Chart entries       |     9 | `@zentauri-ui/zentauri-components/charts/<type>`      |
@@ -29,16 +29,16 @@ Generated from the component package Vitest JSON report via `pnpm --filter @zent
 
 | Metric     | Result           |
 | ---------- | ---------------- |
-| Test files | 94 passed (94)   |
-| Tests      | 754 passed (754) |
+| Test files | 97 passed (97)   |
+| Tests      | 808 passed (808) |
 
 | Area                           | Test files | Tests |
 | ------------------------------ | ---------- | ----- |
-| Components and UI utilities    | 46         | 456   |
+| Components and UI utilities    | 48         | 503   |
 | Standalone animations          | 1          | 45    |
 | React hooks                    | 41         | 174   |
 | Design system facade           | 1          | 11    |
-| CLI and import rewriting       | 3          | 26    |
+| CLI and import rewriting       | 4          | 33    |
 | Accessibility (axe + keyboard) | 2          | 42    |
 
 ### Per-suite snapshot
@@ -48,13 +48,15 @@ Generated from the component package Vitest JSON report via `pnpm --filter @zent
 | `src/animations/animations.test.tsx`                                    |    45 |
 | `src/ui/buttons/button.test.tsx`                                        |    44 |
 | `src/ui/inputs/input.test.tsx`                                          |    40 |
+| `src/ui/audio-player/audio-player.test.tsx`                             |    34 |
 | `src/ui/peer-isolation.test.ts`                                         |    29 |
 | `src/accessibility/axe-core.test.tsx`                                   |    24 |
 | `src/ui/combobox/combobox.test.tsx`                                     |    24 |
-| `cli/cli.integration.test.ts`                                           |    20 |
+| `cli/cli.integration.test.ts`                                           |    21 |
 | `src/accessibility/keyboard-interaction.test.tsx`                       |    18 |
 | `src/ui/pagination/pagination.test.tsx`                                 |    15 |
 | `src/ui/timeline/timeline.test.tsx`                                     |    14 |
+| `src/ui/data-table/data-table.test.tsx`                                 |    13 |
 | `src/ui/context-menu/context-menu.test.tsx`                             |    12 |
 | `src/lib/facade.test.ts`                                                |    11 |
 | `src/ui/alert/alert.test.tsx`                                           |    11 |
@@ -77,6 +79,7 @@ Generated from the component package Vitest JSON report via `pnpm --filter @zent
 | `src/ui/progress/progress.test.tsx`                                     |     8 |
 | `src/ui/scroll-area/scroll-area.test.tsx`                               |     8 |
 | `src/ui/spinner/animated/spinner.test.tsx`                              |     8 |
+| `cli/rewrite-imports.test.ts`                                           |     7 |
 | `src/hooks/useDynamicStepper/useDynamicStepper.test.ts`                 |     7 |
 | `src/hooks/useHotkeys/useHotkeys.test.ts`                               |     7 |
 | `src/hooks/useTableSort/useTableSort.test.ts`                           |     7 |
@@ -100,7 +103,6 @@ Generated from the component package Vitest JSON report via `pnpm --filter @zent
 | `src/ui/empty-state/empty-state.test.tsx`                               |     6 |
 | `src/ui/search/filter-search-suggestions.test.ts`                       |     6 |
 | `src/ui/toast/toast.test.tsx`                                           |     6 |
-| `cli/rewrite-imports.test.ts`                                           |     5 |
 | `src/hooks/useCookie/useCookie.test.ts`                                 |     5 |
 | `src/hooks/useDisclosure/useDisclosure.test.ts`                         |     5 |
 | `src/hooks/useEventListener/useEventListener.test.ts`                   |     5 |
@@ -109,6 +111,7 @@ Generated from the component package Vitest JSON report via `pnpm --filter @zent
 | `src/ui/popover/popover.test.tsx`                                       |     5 |
 | `src/ui/radio-group/radio-group.test.tsx`                               |     5 |
 | `src/ui/toggle/toggle.test.tsx`                                         |     5 |
+| `cli/index.test.ts`                                                     |     4 |
 | `src/hooks/useBodyScrollLock/useBodyScrollLock.test.ts`                 |     4 |
 | `src/hooks/useControllableState/useControllableState.test.ts`           |     4 |
 | `src/hooks/useDebouncedValue/useDebouncedValue.test.ts`                 |     4 |
@@ -219,6 +222,7 @@ Import static primitives from `@zentauri-ui/zentauri-components/ui/<subpath>` wh
 | Command         | `command`         | `command/animated`                 |
 | Context menu    | `context-menu`    | —                                  |
 | Copy button     | `copy-button`     | `copy-button/animated`             |
+| DataTable       | `data-table`      | —                                  |
 | Divider         | `divider`         | `divider/animated`                 |
 | Drawer          | `drawer`          | `drawer/animated`                  |
 | Dropdown        | `dropdown`        | —                                  |
@@ -848,7 +852,7 @@ From this package directory in the monorepo:
 
 - `pnpm build` (or `npm run build`) — production bundle via `tsup` (Rollup treeshake + `scripts/prepend-use-client.mjs` via `onSuccess` so each UI entry under `dist/ui/`, animation entry under `dist/animations/`, chart entry under `dist/charts/`, and `dist/ui/<name>/animated.*` starts with `"use client"` where needed)
 - `pnpm dev` — `tsup` watch mode (same `onSuccess` hook after each rebuild)
-- `pnpm test` / `pnpm test:watch` — **Vitest** and **Testing Library** unit tests // currently covered 754 test cases in total
+- `pnpm test` / `pnpm test:watch` — **Vitest** and **Testing Library** unit tests // currently covered 808 test cases in total
 - `pnpm test:a11y` — focused accessibility coverage for package-level UI primitives and compound components: **axe-core** audits for every interactive component plus **keyboard-interaction** tests (focus order, arrow-key nav, Home/End, Escape/Enter) for the compound components
 - `pnpm check:tokens` — enforce the `--zui-*` token contract across design-system, variant, and local custom-property usage without generating a large checked-in token catalog
 - **`pnpm run generate:registry`** — runs `scripts/generate-registry.mjs`, which reads **`uiComponentNames`**, **`uiAnimatedComponentNames`**, **`animationEntryNames`**, **`chartEntryNames`**, and **`hooksEntryNames`** from `tsup.config.ts`, applies fixed **`nameAliases`**, scans each component/chart source to build **`peerHints`**, and writes **`cli/registry.json`** (`components` + `animations` + `hooks` + `peerHints`). Run this after adding or renaming UI, animation, chart, or hook entries so the CLI stays in sync (the script prints counts).

package/cli/cli.integration.test.ts

@@ -295,6 +295,42 @@ describe("zentauri-ui CLI", () => {
     }
   });
 
+  it("should add data-table with vendored sibling UI dependencies", () => {
+    const dir = mkdtempSync(join(tmpdir(), "zentauri-cli-data-table-"));
+    try {
+      runCli(dir, ["init"]);
+      const out = runCli(dir, ["add", "data-table"]);
+      expect(
+        existsSync(join(dir, "src/components/ui/data-table/data-table.tsx")),
+      ).toBe(true);
+      expect(
+        existsSync(join(dir, "src/components/ui/buttons/button.tsx")),
+      ).toBe(true);
+      expect(
+        existsSync(join(dir, "src/components/ui/checkbox/checkbox.tsx")),
+      ).toBe(true);
+      expect(existsSync(join(dir, "src/components/ui/inputs/input.tsx"))).toBe(
+        true,
+      );
+      expect(
+        existsSync(join(dir, "src/components/ui/pagination/pagination.tsx")),
+      ).toBe(true);
+      expect(existsSync(join(dir, "src/components/ui/table/table.tsx"))).toBe(
+        true,
+      );
+      const base = readFileSync(
+        join(dir, "src/components/ui/data-table/data-table-base.tsx"),
+        "utf8",
+      );
+      expect(base).toContain('from "@/components/ui/buttons"');
+      expect(base).not.toContain('from "../buttons"');
+      expect(out).toContain("Adding data-table…");
+      expect(out).toContain("Adding buttons…");
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
   it("should print react-icons peer hint for components that use icons", () => {
     const dir = mkdtempSync(join(tmpdir(), "zentauri-cli-peer-"));
     try {

package/cli/index.mjs

@@ -84,7 +84,7 @@
  *   command, or refused `init` overwrite. Successful runs leave default exit 0.
  */
 
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, realpathSync } from "node:fs";
 import {
   readFile,
   writeFile,
@@ -548,6 +548,27 @@ function isAnimatedComponent(name, registry) {
   return (registry.animatedComponents ?? []).includes(name);
 }
 
+function expandComponentDependencies(names, registry) {
+  const dependencies = registry.componentDependencies ?? {};
+  const expanded = [];
+  const seen = new Set();
+  const queue = [...names];
+
+  while (queue.length > 0) {
+    const name = queue.shift();
+    if (seen.has(name)) {
+      continue;
+    }
+    seen.add(name);
+    expanded.push(name);
+    for (const dependency of dependencies[name] ?? []) {
+      queue.push(dependency);
+    }
+  }
+
+  return expanded;
+}
+
 function printList(registry) {
   const ui = Array.from(
     new Set([
@@ -922,7 +943,13 @@ async function collectHookTransitiveClosure(packageRoot, seedHooks) {
  * // src/components/ui/buttons/Button.tsx
  * // with imports pointing at @/lib/utils, @/hooks/useX, etc.
  */
-async function copyUiComponent(componentName, config, configDir, packageRoot) {
+async function copyUiComponent(
+  componentName,
+  config,
+  configDir,
+  packageRoot,
+  registry,
+) {
   const isChartEntry = componentName.startsWith("charts/");
   const isAnimationEntry = componentName.startsWith("animations/");
   const animationName = componentName.slice("animations/".length);
@@ -979,6 +1006,7 @@ async function copyUiComponent(componentName, config, configDir, packageRoot) {
         utilsAlias: config.aliases.utils,
         hooksAlias: config.aliases.hooks,
         uiAlias: config.aliases.ui,
+        uiComponents: registry.uiComponents ?? [],
       });
       const rewrittenCode = designSystemImportTarget
         ? rewriteDesignSystemBarrelImports(code, designSystemImportTarget)
@@ -1310,8 +1338,9 @@ async function cmdAdd(names, cwd, options = {}) {
   }
 
   const resolvedNames = payload.map((n) => resolveComponentName(n, registry));
+  const requestedNames = [...resolvedNames];
   if (animated) {
-    for (const name of resolvedNames) {
+    for (const name of requestedNames) {
       if (!isAnimatedComponent(name, registry)) {
         console.error(`Component "${name}" has no animated entry.`);
         process.exitCode = 1;
@@ -1319,17 +1348,24 @@ async function cmdAdd(names, cwd, options = {}) {
       }
     }
   }
+  const namesToCopy = expandComponentDependencies(requestedNames, registry);
 
   await ensureUtilsFile(config, configDir, packageRoot);
-  await copyDesignSystemFiles(resolvedNames, config, configDir, packageRoot);
+  await copyDesignSystemFiles(namesToCopy, config, configDir, packageRoot);
 
   const allHooks = new Set();
-  for (const name of resolvedNames) {
+  for (const name of namesToCopy) {
     console.log(`Adding ${name}…`);
-    if (animated) {
+    if (animated && requestedNames.includes(name)) {
       console.log(`Including animated entry for ${name}…`);
     }
-    const uh = await copyUiComponent(name, config, configDir, packageRoot);
+    const uh = await copyUiComponent(
+      name,
+      config,
+      configDir,
+      packageRoot,
+      registry,
+    );
     for (const h of uh) {
       allHooks.add(h);
     }
@@ -1345,7 +1381,7 @@ async function cmdAdd(names, cwd, options = {}) {
   }
 
   console.log("Done.");
-  printAdoptionHints(resolvedNames, registry, config, configDir);
+  printAdoptionHints(namesToCopy, registry, config, configDir);
 }
 
 async function cmdTheme(hex, options, cwd) {
@@ -1464,7 +1500,50 @@ async function main() {
   process.exitCode = 1;
 }
 
-main().catch((err) => {
-  console.error(err instanceof Error ? err.message : err);
-  process.exitCode = 1;
-});
+export {
+  buildCompactThemeCss,
+  cmdAdd,
+  cmdInit,
+  cmdTheme,
+  collectHookTransitiveClosure,
+  copyDesignSystemFiles,
+  copyHookFolder,
+  copyUiComponent,
+  defaultConfig,
+  detectFramework,
+  findComponentsJson,
+  getMissingDependencies,
+  importPathFor,
+  isTestFile,
+  loadRegistry,
+  main,
+  normalizeHexColor,
+  printAdoptionHints,
+  printInfo,
+  printList,
+  resolveComponentName,
+  resolveHookName,
+  validateConfig,
+  walkFiles,
+};
+
+function isDirectCliRun() {
+  if (!process.argv[1]) {
+    return false;
+  }
+  try {
+    return (
+      realpathSync(process.argv[1]) ===
+      realpathSync(fileURLToPath(import.meta.url))
+    );
+  } catch {
+    return resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+  }
+}
+
+if (isDirectCliRun()) {
+  main().catch((err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exitCode = 1;
+  });
+}

package/cli/index.test.ts

@@ -0,0 +1,180 @@
+import {
+  existsSync,
+  mkdtempSync,
+  readFileSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+import {
+  cmdAdd,
+  cmdInit,
+  cmdTheme,
+  defaultConfig,
+  importPathFor,
+  normalizeHexColor,
+  resolveComponentName,
+  resolveHookName,
+  validateConfig,
+} from "./index.mjs";
+
+type TestRegistry = Parameters<typeof resolveComponentName>[1] &
+  Parameters<typeof resolveHookName>[1];
+
+function makeTempDir(prefix: string) {
+  return mkdtempSync(join(tmpdir(), prefix));
+}
+
+function silenceConsole() {
+  const logs: string[] = [];
+  const errors: string[] = [];
+
+  vi.spyOn(console, "log").mockImplementation((...args) => {
+    logs.push(args.join(" "));
+  });
+  vi.spyOn(console, "error").mockImplementation((...args) => {
+    errors.push(args.join(" "));
+  });
+
+  return { errors, logs };
+}
+
+describe("CLI module commands", () => {
+  afterEach(() => {
+    vi.restoreAllMocks();
+    process.exitCode = undefined;
+  });
+
+  it("resolves aliases, hooks, imports, hex colors, and config validation", () => {
+    const registry: TestRegistry = {
+      components: ["buttons", "card", "charts/line"],
+      hooks: ["useWindowSize"],
+      nameAliases: { button: "buttons" },
+      animatedComponents: ["buttons", "spinner"],
+      uiComponents: ["buttons", "card"],
+    };
+
+    expect(resolveComponentName("button", registry)).toBe("buttons");
+    expect(resolveComponentName("CARD", registry)).toBe("card");
+    expect(resolveHookName("usewindowsize", registry)).toBe("useWindowSize");
+    expect(importPathFor("useWindowSize", "hook", registry)).toBe(
+      "@zentauri-ui/zentauri-components/hooks/useWindowSize",
+    );
+    expect(importPathFor("charts/line", "component", registry)).toBe(
+      "@zentauri-ui/zentauri-components/charts/line",
+    );
+    expect(importPathFor("spinner", "component", registry)).toBe(
+      "@zentauri-ui/zentauri-components/ui/spinner/animated",
+    );
+    expect(normalizeHexColor("38b")).toBe("#3388bb");
+    expect(() => validateConfig(defaultConfig())).not.toThrow();
+    expect(() => resolveComponentName("missing", registry)).toThrow(
+      /Unknown component/,
+    );
+    expect(() => normalizeHexColor("not-a-color")).toThrow(
+      /Invalid brand color/,
+    );
+  });
+
+  it("initializes components.json with framework-aware guidance", async () => {
+    const dir = makeTempDir("zentauri-cli-module-init-");
+    const { errors, logs } = silenceConsole();
+
+    try {
+      writeFileSync(
+        join(dir, "package.json"),
+        JSON.stringify({ dependencies: { next: "16.0.0" } }),
+      );
+
+      await cmdInit(dir);
+
+      expect(existsSync(join(dir, "components.json"))).toBe(true);
+      expect(
+        JSON.parse(readFileSync(join(dir, "components.json"), "utf8")),
+      ).toEqual(defaultConfig());
+      expect(logs.join("\n")).toContain("Detected framework: Next.js");
+      expect(logs.join("\n")).toContain('@source "./src/components/ui";');
+
+      await cmdInit(dir);
+
+      expect(process.exitCode).toBe(1);
+      expect(errors.join("\n")).toContain("Refusing to overwrite existing");
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  it("vendors components, animated entries, design tokens, and transitive hooks", async () => {
+    const dir = makeTempDir("zentauri-cli-module-add-");
+    const { logs } = silenceConsole();
+
+    try {
+      await cmdInit(dir);
+      await cmdAdd(["button"], dir);
+      await cmdAdd(["hook", "usePrefersReducedMotion"], dir);
+      await cmdAdd(["button"], dir, { animated: true });
+
+      expect(
+        existsSync(join(dir, "src/components/ui/buttons/button.tsx")),
+      ).toBe(true);
+      expect(
+        existsSync(join(dir, "src/components/ui/buttons/animated/index.ts")),
+      ).toBe(true);
+      expect(
+        existsSync(join(dir, "src/components/design-system/button.ts")),
+      ).toBe(true);
+      expect(
+        existsSync(join(dir, "src/components/design-system/tokens.ts")),
+      ).toBe(true);
+      expect(
+        existsSync(
+          join(
+            dir,
+            "src/hooks/usePrefersReducedMotion/usePrefersReducedMotion.ts",
+          ),
+        ),
+      ).toBe(true);
+      expect(
+        existsSync(join(dir, "src/hooks/useMediaQuery/useMediaQuery.ts")),
+      ).toBe(true);
+      expect(
+        readFileSync(
+          join(dir, "src/components/ui/buttons/button-base.tsx"),
+          "utf8",
+        ),
+      ).toContain('from "@/lib/utils"');
+      expect(logs.join("\n")).toContain("Including animated entry for buttons");
+      expect(logs.join("\n")).toContain("Missing peer dependencies");
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  it("generates theme CSS to stdout or a requested file", async () => {
+    const dir = makeTempDir("zentauri-cli-module-theme-");
+    const { errors, logs } = silenceConsole();
+
+    try {
+      await cmdTheme("#2563eb", { dark: "#60a5fa" }, dir);
+      expect(logs.join("\n")).toContain("--zui-brand: #2563eb;");
+      expect(logs.join("\n")).toContain("--zui-brand-dark: #60a5fa;");
+
+      await cmdTheme("38bdf8", { out: "src/styles/zentauri-theme.css" }, dir);
+      const themePath = join(dir, "src/styles/zentauri-theme.css");
+      expect(existsSync(themePath)).toBe(true);
+      expect(readFileSync(themePath, "utf8")).toContain(
+        "--zui-brand: #38bdf8;",
+      );
+
+      await cmdTheme("", {}, dir);
+      expect(process.exitCode).toBe(1);
+      expect(errors.join("\n")).toContain("Usage: zentauri-components theme");
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+});