inai-react-components 0.1.6 → 1.2.1

package/README.md

@@ -0,0 +1,80 @@
+# inai-react-components
+
+CLI for the InAI UI component library. Installs components, blocks, and templates from a private registry into your React project following the shadcn/ui copy-paste philosophy.
+
+## Install
+
+```bash
+npx inai-react-components init
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `inai-ui init [repo-url]` | Initialize InAI UI in the current project (detects framework, writes `components.json`, copies tokens). |
+| `inai-ui add [component]` | Install a component/block/template. Flags: `-a/--all`, `-f/--force`, `--dry-run`, `--skip-existing`. Transitive `registryDependencies` are installed automatically. |
+| `inai-ui sync` | Pull the latest registry cache from the remote repository. |
+| `inai-ui list` | List all available components. Flag: `-c/--category`. |
+| `inai-ui status` | Report component health: `HEALTHY` / `DRIFT` / `OUTDATED` / `MISSING`. Flag: `--json`. |
+| `inai-ui diff <component>` | Unified LCS-based diff between the local component and the registry version. |
+| `inai-ui update <component>` | Update a component with a 3-way merge against the snapshot captured at install time. |
+| `inai-ui theme create` | Create a custom theme based on an existing one. |
+| `inai-ui mcp` | Start the MCP server so AI assistants can drive the CLI. |
+| `inai-ui mcp init` | Print the JSON config fragment for Claude Desktop / Cursor. |
+
+## Framework detection
+
+`inai-ui init` auto-detects the host framework and picks a sensible CSS entry point:
+
+| Framework | CSS entry point |
+|---|---|
+| Next.js (App Router) | `app/globals.css` |
+| Next.js (Pages Router) | `styles/globals.css` |
+| Vite | `src/index.css` |
+| Remix | `app/styles/globals.css` |
+| Astro | `src/styles/globals.css` |
+| TanStack Start | `src/styles/app.css` |
+
+## Snapshots & 3-way merge
+
+Every `inai-ui add` captures an original-content snapshot at `.inai-ui/snapshots/<name>.json`. `inai-ui update` uses this snapshot as the common ancestor of a 3-way merge (local vs registry), so local edits survive upgrades. Overlapping edits produce standard git-style conflict markers (`<<<<<<<` / `=======` / `>>>>>>>`) that you resolve in your editor.
+
+`inai-ui status` uses the same snapshot hashes to report whether a component has drifted from its installed baseline.
+
+## MCP server
+
+The CLI ships an MCP (Model Context Protocol) server so AI assistants (Claude Desktop, Cursor, any MCP-compatible host) can browse and install components on your behalf.
+
+### Register with Claude Desktop / Cursor
+
+```bash
+inai-ui mcp init
+```
+
+This prints a JSON fragment — drop it into your MCP host's `mcpServers` config:
+
+```json
+{
+  "mcpServers": {
+    "inai-ui": {
+      "command": "inai-ui",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### Exposed tools
+
+| Tool | Purpose |
+|---|---|
+| `list_components` | List the full registry. Optional `category` filter. |
+| `view_component` | Return the source of a single component (files wrapped in fenced blocks). |
+| `add_component` | Install a component and its transitive deps into the current project. |
+| `diff_component` | Unified diff between local and registry. |
+| `update_component` | Non-interactive update via 3-way merge. |
+| `list_themes` | Enumerate the 34 built-in themes with categories. |
+| `project_status` | JSON status report (`HEALTHY` / `DRIFT` / `OUTDATED` / `MISSING` per component). |
+
+The server talks stdio — your MCP host spawns `inai-ui mcp` and communicates with it over stdin/stdout.

package/dist/commands/add.d.ts

@@ -1,16 +1,47 @@
 import { type RegistryComponent } from "./status.js";
+export interface AddOptions {
+    /** Overwrite existing files without prompting. */
+    force?: boolean;
+    /** Print actions without writing files. */
+    dryRun?: boolean;
+    /** If a file already exists, skip it silently. */
+    skipExisting?: boolean;
+    /** Use cached registries without network access. */
+    offline?: boolean;
+    /** Skip automatic npm dependency installation. */
+    skipInstall?: boolean;
+}
 export interface AddResult {
     added: boolean;
     message: string;
     files: string[];
     npmDeps: string[];
     internalDeps: string[];
+    /** Registry deps resolved transitively (empty if none). */
+    resolvedDeps?: string[];
+    /** Files that were skipped because they already existed. */
+    skipped?: string[];
+    /** Fuzzy search suggestions when component name was not found. */
+    suggestions?: {
+        name: string;
+        score: number;
+    }[];
 }
 /**
- * Parse a component spec like "button", "block/auth-login", or "template/admin-dashboard"
- * into its type prefix and name.
+ * Parse a component spec into its registry namespace, type prefix and name.
+ *
+ * Supported forms:
+ * - `button`                       → { registry: null, prefix: null, name: "button" }
+ * - `block/auth-login`             → { registry: null, prefix: "block", name: "auth-login" }
+ * - `template/admin-dashboard`     → { registry: null, prefix: "template", name: "admin-dashboard" }
+ * - `@acme/custom-button`          → { registry: "acme", prefix: null, name: "custom-button" }
+ * - `@acme/block/hero`             → { registry: "acme", prefix: "block", name: "hero" }
+ *
+ * `registry` is null when the caller did not specify a `@namespace/` — the
+ * default registry (from `components.json`) should then be used.
  */
 export declare function parseComponentSpec(spec: string): {
+    registry: string | null;
     prefix: string | null;
     name: string;
 };
@@ -28,9 +59,12 @@ export declare function findInRegistry(registry: {
 export declare function getTargetDir(component: RegistryComponent, aliases: {
     components: string;
     blocks: string;
+    templates?: string;
 }): string;
-export declare function runAdd(componentSpec: string, rootDir: string): Promise<AddResult>;
-export declare function addCommand(componentSpec?: string, options?: {
+export declare function runAdd(componentSpec: string, rootDir: string, options?: AddOptions): Promise<AddResult>;
+export interface AddCommandOptions extends AddOptions {
     all?: boolean;
-}): Promise<void>;
+    skipInstall?: boolean;
+}
+export declare function addCommand(componentSpec?: string, options?: AddCommandOptions): Promise<void>;
 //# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,aAAa,CAAC;AASrB,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAChD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAQA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE;IAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAAE,EAC1G,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,iBAAiB,GAAG,IAAI,CAc1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C,MAAM,CAUR;AAED,wBAAsB,MAAM,CAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CAsHpB;AAuBD,wBAAsB,UAAU,CAC9B,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgCf"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,iBAAiB,EAIvB,MAAM,aAAa,CAAC;AAmBrB,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAsCA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE;IAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAAE,EAC1G,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,iBAAiB,GAAG,IAAI,CAc1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClE,MAAM,CAgBR;AA0JD,wBAAsB,MAAM,CAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CAmMpB;AAqCD,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,UAAU,CAC9B,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqIf"}