get-ui-cli 0.0.0-stage → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yash Jaiswal
+
+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,63 @@
-# Temporary Holding Version
+# get-ui
 
-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.
+**Every UI component. One command.**
+
+Search, preview and install copy-paste React + Tailwind components from nine open-source libraries, with everything each one depends on.
+
+```bash
+npx get-ui-cli add magicui/shimmer-button
+```
+
+Or install it once and use the short command:
+
+```bash
+npm i -g get-ui-cli
+get-ui add magicui/shimmer-button
+```
+
+Browse and live-preview everything at **[get-ui.dev](https://get-ui.dev)**.
+
+## What it does
+
+`get-ui add` reads your project (path aliases, Tailwind version, global CSS file, package manager) and then:
+
+- **Resolves the whole tree.** Sub-components from any library come along, e.g. a Kokonut UI component that needs shadcn/ui's Button, Textarea and Dropdown Menu.
+- **Writes the files** with imports rewritten to your aliases.
+- **Merges CSS** (theme variables, keyframes) into your global stylesheet without overwriting anything you already have. In a project that never ran `shadcn init`, it adds shadcn's base theme the first time a component needs it.
+- **Installs only the missing npm packages**, with your package manager. If you already use `motion`, `framer-motion` imports are rewritten instead of installing both.
+
+## Libraries
+
+| Library | Free components |
+| --- | ---: |
+| [shadcn/ui](https://ui.shadcn.com) | 61 |
+| [Magic UI](https://magicui.design) | 78 |
+| [Aceternity UI](https://ui.aceternity.com) | 119 |
+| [ReUI](https://reui.io) | 1,254 |
+| [Kokonut UI](https://kokonutui.com) | 46 |
+| [Cult UI](https://www.cult-ui.com) | 154 |
+| [Motion Primitives](https://motion-primitives.com) | 33 |
+| [Unlumen UI](https://ui.unlumen.com) | 109 |
+| [Amicro](https://amicro.vercel.app) | 169 |
+
+Paid ("Pro") items are listed but can't be installed without the library's own licence.
+
+## Commands
+
+```bash
+npx get-ui-cli add <id|name|search text...>   # install one or more components
+npx get-ui-cli search <query>                 # search the index
+npx get-ui-cli list [-l <library>]            # counts per library / category
+npx get-ui-cli view <id>                      # files and dependencies, no writes
+npx get-ui-cli init                           # add lib/utils.ts (cn helper)
+```
+
+Useful `add` flags: `--dry-run` (show the plan only), `-y` (no prompts), `-o` (overwrite), `-l <library>` (restrict matches), `--no-install` (print the install command instead of running it), `--cwd <dir>`.
+
+## Credit
+
+get-ui is an index, not a host. Component code is fetched from each library at install time and stays under its author's licence. Credit the creators you ship.
+
+## License
+
+MIT

package/dist/core/css.d.ts

@@ -0,0 +1,25 @@
+import type { CssTree, CssVars } from './resolve.js';
+interface Block {
+    prelude: string;
+    /** index right after `{` */
+    bodyStart: number;
+    /** index of the closing `}` */
+    bodyEnd: number;
+    depth: number;
+}
+/** Minimal CSS block scanner: records every `{...}` with its prelude. */
+export declare function scanBlocks(css: string): Block[];
+export interface MergeCssInput {
+    cssVars?: CssVars;
+    css?: CssTree;
+    tailwindVersion?: 3 | 4 | null;
+}
+export interface MergeCssResult {
+    css: string;
+    changed: boolean;
+    /** Human-readable list of what was added. */
+    added: string[];
+    warnings: string[];
+}
+export declare function mergeCss(source: string, input: MergeCssInput): MergeCssResult;
+export {};

package/dist/core/css.js

@@ -0,0 +1,129 @@
+// Merge registry `cssVars` / `css` into a global stylesheet without clobbering
+// anything that already exists. Pure string manipulation.
+function normPrelude(s) {
+    return s.replace(/\/\*[\s\S]*?\*\//g, '').replace(/\s+/g, ' ').trim();
+}
+/** Minimal CSS block scanner: records every `{...}` with its prelude. */
+export function scanBlocks(css) {
+    const blocks = [];
+    const stack = [];
+    let preludeStart = 0;
+    for (let i = 0; i < css.length; i++) {
+        const ch = css[i];
+        if (ch === '/' && css[i + 1] === '*') {
+            const end = css.indexOf('*/', i + 2);
+            i = end === -1 ? css.length : end + 1;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            const end = css.indexOf(ch, i + 1);
+            i = end === -1 ? css.length : end;
+            continue;
+        }
+        if (ch === '{') {
+            stack.push({ prelude: normPrelude(css.slice(preludeStart, i)), bodyStart: i + 1 });
+            preludeStart = i + 1;
+        }
+        else if (ch === '}') {
+            const open = stack.pop();
+            if (open)
+                blocks.push({ prelude: open.prelude, bodyStart: open.bodyStart, bodyEnd: i, depth: stack.length });
+            preludeStart = i + 1;
+        }
+        else if (ch === ';') {
+            preludeStart = i + 1;
+        }
+    }
+    return blocks;
+}
+function findBlock(css, prelude) {
+    const want = normPrelude(prelude);
+    return scanBlocks(css).find((b) => b.prelude === want);
+}
+function existingVars(body) {
+    return new Set([...body.matchAll(/(--[\w-]+)\s*:/g)].map((m) => m[1]));
+}
+function serialize(key, value, indent = '') {
+    if (typeof value === 'string')
+        return `${indent}${key}: ${value};`;
+    const entries = Object.entries(value);
+    if (!entries.length && /^@(plugin|import|custom-variant|source)\b/.test(key))
+        return `${indent}${key};`;
+    const inner = entries.map(([k, v]) => serialize(k, v, indent + '  ')).join('\n');
+    return `${indent}${key} {\n${inner}\n${indent}}`;
+}
+function addVars(css, prelude, vars, added) {
+    const entries = Object.entries(vars);
+    if (!entries.length)
+        return css;
+    const block = findBlock(css, prelude);
+    const have = block ? existingVars(css.slice(block.bodyStart, block.bodyEnd)) : new Set();
+    const missing = entries.filter(([k]) => !have.has(`--${k.replace(/^--/, '')}`));
+    if (!missing.length)
+        return css;
+    const lines = missing.map(([k, v]) => `  --${k.replace(/^--/, '')}: ${v};`);
+    added.push(`${prelude}: ${missing.map(([k]) => `--${k.replace(/^--/, '')}`).join(', ')}`);
+    if (block) {
+        const before = css.slice(0, block.bodyEnd).replace(/\s*$/, '');
+        return `${before}\n${lines.join('\n')}\n${css.slice(block.bodyEnd)}`;
+    }
+    return `${css.replace(/\s*$/, '')}\n\n${prelude} {\n${lines.join('\n')}\n}\n`;
+}
+function hasRule(css, key) {
+    const want = normPrelude(key);
+    if (want.startsWith('@keyframes ')) {
+        const name = want.slice('@keyframes '.length).trim();
+        return new RegExp(`@(-webkit-)?keyframes\\s+${name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*\\{`).test(css);
+    }
+    return scanBlocks(css).some((b) => b.prelude === want);
+}
+export function mergeCss(source, input) {
+    let css = source;
+    const added = [];
+    const warnings = [];
+    const v4 = input.tailwindVersion !== 3;
+    const { theme = {}, light = {}, dark = {} } = input.cssVars ?? {};
+    if (Object.keys(theme).length) {
+        if (v4) {
+            const prelude = findBlock(css, '@theme inline') || !findBlock(css, '@theme') ? '@theme inline' : '@theme';
+            css = addVars(css, prelude, theme, added);
+        }
+        else {
+            warnings.push(`Tailwind v3: add these theme values to tailwind.config manually: ${Object.entries(theme)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(', ')}`);
+        }
+    }
+    css = addVars(css, ':root', light, added);
+    css = addVars(css, '.dark', dark, added);
+    for (const [key, value] of Object.entries(input.css ?? {})) {
+        const k = normPrelude(key);
+        if (/^@(plugin|import|custom-variant|source)\b/.test(k) && (typeof value === 'string' || !Object.keys(value).length)) {
+            const stmt = typeof value === 'string' && value ? `${k} ${value};` : `${k};`;
+            if (css.includes(k))
+                continue;
+            const lastImport = [...css.matchAll(/^@(import|plugin)[^\n]*\n/gm)].pop();
+            if (lastImport) {
+                const at = lastImport.index + lastImport[0].length;
+                css = `${css.slice(0, at)}${stmt}\n${css.slice(at)}`;
+            }
+            else
+                css = `${stmt}\n${css}`;
+            added.push(k);
+            continue;
+        }
+        if (k.startsWith('@layer') && typeof value === 'object') {
+            const missing = Object.entries(value).filter(([sel]) => !hasRule(css, sel));
+            if (!missing.length)
+                continue;
+            css = `${css.replace(/\s*$/, '')}\n\n${serialize(k, Object.fromEntries(missing))}\n`;
+            added.push(`${k} { ${missing.map(([s]) => s).join(', ')} }`);
+            continue;
+        }
+        if (hasRule(css, k))
+            continue;
+        css = `${css.replace(/\s*$/, '')}\n\n${serialize(k, value)}\n`;
+        added.push(k);
+    }
+    return { css, changed: css !== source, added, warnings };
+}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from './search.js';
+export * from './resolve.js';
+export * from './transform.js';
+export * from './css.js';
+export type * from '../registry-types.js';
+export * from './shadcn-theme.js';
+export * from './versions.js';

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export * from './search.js';
+export * from './resolve.js';
+export * from './transform.js';
+export * from './css.js';
+export * from './shadcn-theme.js';
+export * from './versions.js';

package/dist/core/resolve.d.ts

@@ -0,0 +1,58 @@
+import { type LibraryId, type Registry, type RegistryItem } from '../registry-types.js';
+export declare const SHADCN_BASE = "https://ui.shadcn.com/r/styles/new-york-v4/";
+export declare const SHADCN_REGISTRIES_URL = "https://ui.shadcn.com/r/registries.json";
+export interface CssVars {
+    theme?: Record<string, string>;
+    light?: Record<string, string>;
+    dark?: Record<string, string>;
+}
+/** A nested CSS object as used by the shadcn registry `css` field. */
+export type CssTree = {
+    [selector: string]: string | CssTree;
+};
+export interface ResolvedFile {
+    path: string;
+    content: string;
+    type: string;
+    target?: string;
+    /** Registry item this file came from (e.g. `shadcn/button`). */
+    item: string;
+    /** Library context of the item that shipped this file. */
+    library: LibraryId | 'external';
+}
+export interface ResolveResult {
+    files: ResolvedFile[];
+    dependencies: string[];
+    devDependencies: string[];
+    cssVars: CssVars;
+    css: CssTree;
+    warnings: string[];
+    /** Items that were pulled in, root first (e.g. `kokonutui/ai-prompt`, `shadcn/button`). */
+    tree: string[];
+}
+export interface ResolveOptions {
+    fetch?: typeof fetch;
+    /** Extra headers per request (e.g. a licence key for paid registries). */
+    headers?: (url: string) => Record<string, string> | undefined;
+    /** Shared cache across calls (url -> parsed JSON / text). */
+    cache?: Map<string, Promise<unknown>>;
+    concurrency?: number;
+    /** Request timeout per fetch (ms). */
+    timeoutMs?: number;
+}
+export declare class FetchError extends Error {
+    status: number;
+    url: string;
+    constructor(message: string, status: number, url: string);
+}
+/** `motion@^11` -> `motion`, `@scope/pkg@1` -> `@scope/pkg` */
+export declare function packageName(dep: string): string;
+export declare function createFetcher(opts?: ResolveOptions): {
+    json(url: string): Promise<unknown>;
+    text(url: string): Promise<string>;
+};
+/**
+ * Fetch an item and all of its registryDependencies (recursively, deduped,
+ * cycle-safe, concurrently).
+ */
+export declare function resolveItem(registry: Registry, item: RegistryItem, opts?: ResolveOptions): Promise<ResolveResult>;