aback-ui 0.0.0-stage → 0.2.0

package/dist/install.js

@@ -0,0 +1,119 @@
+import { spawnSync } from "node:child_process";
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { ensureDirectory, existsPath } from "./config.js";
+import { relativeImport, resolveTargetPath, toPosix } from "./paths.js";
+/**
+ * Write every registry file into the project. Existing files are kept unless
+ * the caller explicitly allows overwriting, so a local edit is never lost
+ * silently.
+ */
+export async function writeItemFiles({ items, projectRoot, dirs, overwrite = "prompt", dryRun = false, log, prompt, }) {
+    const results = [];
+    for (const item of items) {
+        for (const file of item.files) {
+            const target = file.target ?? file.path;
+            const absolutePath = resolveTargetPath(target, dirs, projectRoot);
+            const display = toPosix(path.relative(projectRoot, absolutePath));
+            let existing = null;
+            if (await existsPath(absolutePath)) {
+                existing = await readFile(absolutePath, "utf8");
+            }
+            if (existing === file.content) {
+                results.push({ item: item.name, target: display, absolutePath, status: "unchanged" });
+                continue;
+            }
+            if (existing !== null) {
+                if (dryRun) {
+                    log.warn(`${display} already exists; a real run would ask before replacing it.`);
+                    results.push({ item: item.name, target: display, absolutePath, status: "skipped" });
+                    continue;
+                }
+                if (overwrite === "never") {
+                    log.warn(`Kept existing ${display}.`);
+                    results.push({ item: item.name, target: display, absolutePath, status: "skipped" });
+                    continue;
+                }
+                if (overwrite === "prompt") {
+                    const confirmed = await prompt.confirm(`${display} already exists. Replace it with the registry version?`, false);
+                    if (!confirmed) {
+                        log.warn(`Kept existing ${display}.`);
+                        results.push({ item: item.name, target: display, absolutePath, status: "skipped" });
+                        continue;
+                    }
+                }
+            }
+            if (dryRun) {
+                log.info(`Would write ${display}`);
+                results.push({ item: item.name, target: display, absolutePath, status: "written" });
+                continue;
+            }
+            await ensureDirectory(path.dirname(absolutePath));
+            await writeFile(absolutePath, file.content, "utf8");
+            log.success(`Wrote ${display}`);
+            results.push({ item: item.name, target: display, absolutePath, status: "written" });
+        }
+    }
+    return results;
+}
+export function dependencyCommand(packageManager, packages, dev) {
+    switch (packageManager) {
+        case "bun":
+            return { command: "bun", args: ["add", ...(dev ? ["-d"] : []), ...packages] };
+        case "pnpm":
+            return { command: "pnpm", args: ["add", ...(dev ? ["-D"] : []), ...packages] };
+        case "yarn":
+            return { command: "yarn", args: ["add", ...(dev ? ["-D"] : []), ...packages] };
+        case "npm":
+        default:
+            return { command: "npm", args: ["install", ...(dev ? ["--save-dev"] : []), ...packages] };
+    }
+}
+export async function installDependencies({ cwd, packageManager, dependencies = [], devDependencies = [], noInstall = false, dryRun = false, log, runner = spawnSync, }) {
+    const groups = [
+        { packages: [...new Set(dependencies)].sort(), dev: false },
+        { packages: [...new Set(devDependencies)].sort(), dev: true },
+    ];
+    for (const group of groups) {
+        if (group.packages.length === 0)
+            continue;
+        const { command, args } = dependencyCommand(packageManager, group.packages, group.dev);
+        const printable = `${command} ${args.join(" ")}`;
+        if (noInstall || dryRun) {
+            log.info(`Install dependencies with: ${printable}`);
+            continue;
+        }
+        log.step(`Installing ${group.packages.length} package(s) with ${packageManager}`);
+        const result = runner(command, args, { cwd, stdio: "inherit" });
+        if (result.status !== 0) {
+            throw new Error(`Dependency installation failed (${printable}). Run it manually to see the full output.`);
+        }
+    }
+}
+/**
+ * Insert the theme import directly after the Tailwind import so theme
+ * variables exist before any utility is generated.
+ */
+export async function ensureThemeImport({ cssFile, themeFile, dryRun = false, log, }) {
+    if (!(await existsPath(cssFile)))
+        return "missing";
+    const content = await readFile(cssFile, "utf8");
+    const specifier = relativeImport(cssFile, themeFile);
+    if (content.includes(specifier) || content.includes("aback.css"))
+        return "present";
+    const importLine = `@import "${specifier}";`;
+    const tailwind = /^[ \t]*@import\s+["']tailwindcss(?:\/[^"']*)?["'];?[^\n]*\n?/m.exec(content);
+    let next;
+    if (tailwind) {
+        const index = tailwind.index + tailwind[0].length;
+        next = `${content.slice(0, index)}${importLine}\n${content.slice(index)}`;
+    }
+    else {
+        next = `${importLine}\n${content}`;
+    }
+    if (!dryRun)
+        await writeFile(cssFile, next, "utf8");
+    log.success(`${dryRun ? "Would add" : "Added"} the Aback theme import to ${toPosix(path.basename(cssFile))}`);
+    return "added";
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,14 @@
+import type { Writable } from "node:stream";
+export interface Logger {
+    info(message: string): void;
+    step(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    dim(message: string): void;
+    raw(message: string): void;
+}
+export declare function createLogger(out?: Writable, err?: Writable): Logger;
+export declare const silentOut: Writable;
+export declare const silentErr: Writable;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAkBD,wBAAgB,YAAY,CAC1B,GAAG,GAAE,QAAyB,EAC9B,GAAG,GAAE,QAAyB,GAC7B,MAAM,CAmBR;AAED,eAAO,MAAM,SAAS,EAKN,QAAQ,CAAC;AAEzB,eAAO,MAAM,SAAS,EAKN,QAAQ,CAAC"}

package/dist/logger.js

@@ -0,0 +1,47 @@
+const ANSI = {
+    reset: "\u001b[0m",
+    dim: "\u001b[2m",
+    bold: "\u001b[1m",
+    green: "\u001b[32m",
+    red: "\u001b[31m",
+    yellow: "\u001b[33m",
+    blue: "\u001b[34m",
+};
+function shouldColor(stream) {
+    if (process.env.NO_COLOR)
+        return false;
+    if (process.env.FORCE_COLOR)
+        return true;
+    return Boolean(stream.isTTY);
+}
+export function createLogger(out = process.stdout, err = process.stderr) {
+    const colorOut = shouldColor(out);
+    const colorErr = shouldColor(err);
+    function paint(stream, enabled, code, message) {
+        stream.write(enabled ? `${code}${message}${ANSI.reset}\n` : `${message}\n`);
+    }
+    return {
+        info: (message) => paint(out, colorOut, "", message),
+        step: (message) => paint(out, colorOut, ANSI.blue, `→ ${message}`),
+        success: (message) => paint(out, colorOut, ANSI.green, `✓ ${message}`),
+        warn: (message) => paint(err, colorErr, ANSI.yellow, `! ${message}`),
+        error: (message) => paint(err, colorErr, ANSI.red, `✗ ${message}`),
+        dim: (message) => paint(out, colorOut, ANSI.dim, message),
+        raw: (message) => {
+            out.write(`${message}\n`);
+        },
+    };
+}
+export const silentOut = {
+    isTTY: false,
+    write() {
+        return true;
+    },
+};
+export const silentErr = {
+    isTTY: false,
+    write() {
+        return true;
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAYA,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,YAAY;IACnB,GAAG,EAAE,YAAY;IACjB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,YAAY;CACV,CAAC;AAEX,SAAS,WAAW,CAAC,MAAgB;IACnC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,OAAO,CAAE,MAAyC,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAgB,OAAO,CAAC,MAAM,EAC9B,MAAgB,OAAO,CAAC,MAAM;IAE9B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAElC,SAAS,KAAK,CAAC,MAAgB,EAAE,OAAgB,EAAE,IAAY,EAAE,OAAe;QAC9E,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC;QACpD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QAClE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,OAAO,EAAE,CAAC;QACtE,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,OAAO,EAAE,CAAC;QACpE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,OAAO,EAAE,CAAC;QAClE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC;QACzD,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;YACf,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,KAAK;IACZ,KAAK;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACqB,CAAC;AAEzB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,KAAK;IACZ,KAAK;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACqB,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,18 @@
+import type { InstallDirs } from "./types.js";
+export declare class PathSafetyError extends Error {
+    constructor(message: string);
+}
+/** Resolve a project-relative path and refuse anything that escapes the root. */
+export declare function safeJoin(root: string, relative: string): string;
+/**
+ * Map a registry `target` to a file inside the consumer project.
+ *
+ * `components/ui/button.tsx` -> the configured ui alias,
+ * `lib/utils.ts` -> the configured lib alias,
+ * `~/styles/aback.css` -> the project styles directory.
+ */
+export declare function resolveTargetPath(target: string, dirs: InstallDirs, projectRoot: string): string;
+export declare function toPosix(value: string): string;
+/** A relative import specifier from one file to another, always with `./`. */
+export declare function relativeImport(fromFile: string, toFile: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkB/D;AAWD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,CAiCR;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvE"}

package/dist/paths.js

@@ -0,0 +1,76 @@
+import path from "node:path";
+export class PathSafetyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PathSafetyError";
+    }
+}
+/** Resolve a project-relative path and refuse anything that escapes the root. */
+export function safeJoin(root, relative) {
+    if (relative.includes("\0")) {
+        throw new PathSafetyError(`Invalid path: ${JSON.stringify(relative)}`);
+    }
+    if (path.isAbsolute(relative)) {
+        throw new PathSafetyError(`Refusing absolute install target "${relative}". Targets must be project-relative.`);
+    }
+    const absolute = path.resolve(root, relative);
+    const check = path.relative(root, absolute);
+    if (check === ".." || check.startsWith(`..${path.sep}`) || path.isAbsolute(check)) {
+        throw new PathSafetyError(`Refusing install target "${relative}": it resolves outside the project root.`);
+    }
+    return absolute;
+}
+const TARGET_PREFIXES = [
+    "components/ui",
+    "components/blocks",
+    "components",
+    "lib",
+    "hooks",
+    "styles",
+];
+/**
+ * Map a registry `target` to a file inside the consumer project.
+ *
+ * `components/ui/button.tsx` -> the configured ui alias,
+ * `lib/utils.ts` -> the configured lib alias,
+ * `~/styles/aback.css` -> the project styles directory.
+ */
+export function resolveTargetPath(target, dirs, projectRoot) {
+    if (!target || target.trim().length === 0) {
+        throw new PathSafetyError("Registry item contains a file with an empty target.");
+    }
+    const normalized = target.replace(/^~\//, "").replace(/^@\//, "").replace(/\\/g, "/");
+    if (normalized.split("/").includes("..")) {
+        throw new PathSafetyError(`Refusing install target "${target}": path traversal segment.`);
+    }
+    for (const prefix of TARGET_PREFIXES) {
+        if (normalized === prefix) {
+            throw new PathSafetyError(`Refusing install target "${target}": expected a file, not a directory.`);
+        }
+        if (normalized.startsWith(`${prefix}/`)) {
+            const rest = normalized.slice(prefix.length + 1);
+            const base = prefix === "components/ui"
+                ? dirs.ui
+                : prefix === "components/blocks"
+                    ? dirs.blocks
+                    : prefix === "components"
+                        ? dirs.components
+                        : prefix === "lib"
+                            ? dirs.lib
+                            : prefix === "hooks"
+                                ? dirs.hooks
+                                : dirs.styles;
+            return safeJoin(base, rest);
+        }
+    }
+    return safeJoin(projectRoot, normalized);
+}
+export function toPosix(value) {
+    return value.split(path.sep).join("/");
+}
+/** A relative import specifier from one file to another, always with `./`. */
+export function relativeImport(fromFile, toFile) {
+    const relative = toPosix(path.relative(path.dirname(fromFile), toFile));
+    return relative.startsWith(".") ? relative : `./${relative}`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}

package/dist/prompt.d.ts

@@ -0,0 +1,13 @@
+export interface Prompter {
+    confirm(message: string, defaultValue?: boolean): Promise<boolean>;
+}
+interface ReadableInput {
+    isTTY?: boolean;
+}
+interface WritableOutput {
+    write(chunk: string): boolean;
+}
+/** Interactive prompt that returns the default answer when stdin is not a TTY. */
+export declare function createPrompter(input?: ReadableInput, output?: WritableOutput): Prompter;
+export {};
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,cAAc;IACtB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,KAAK,GAAE,aAA8C,EACrD,MAAM,GAAE,cAAiD,GACxD,QAAQ,CAmBV"}

package/dist/prompt.js

@@ -0,0 +1,25 @@
+import { createInterface } from "node:readline/promises";
+/** Interactive prompt that returns the default answer when stdin is not a TTY. */
+export function createPrompter(input = process.stdin, output = process.stdout) {
+    return {
+        async confirm(message, defaultValue = false) {
+            if (!input.isTTY)
+                return defaultValue;
+            const suffix = defaultValue ? " [Y/n] " : " [y/N] ";
+            const readline = createInterface({
+                input: input,
+                output: output,
+            });
+            try {
+                const answer = (await readline.question(`${message}${suffix}`)).trim().toLowerCase();
+                if (!answer)
+                    return defaultValue;
+                return answer === "y" || answer === "yes";
+            }
+            finally {
+                readline.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAczD,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAC5B,QAAuB,OAAO,CAAC,KAAsB,EACrD,SAAyB,OAAO,CAAC,MAAwB;IAEzD,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK;YACzC,IAAI,CAAC,KAAK,CAAC,KAAK;gBAAE,OAAO,YAAY,CAAC;YAEtC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YACpD,MAAM,QAAQ,GAAG,eAAe,CAAC;gBAC/B,KAAK,EAAE,KAA0B;gBACjC,MAAM,EAAE,MAA+B;aACxC,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACrF,IAAI,CAAC,MAAM;oBAAE,OAAO,YAAY,CAAC;gBACjC,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;YAC5C,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,49 @@
+import type { RegistryFetch, RegistryIndex, RegistryItem } from "./types.js";
+/**
+ * The canonical address of the Aback UI registry. Item files reference each
+ * other by URLs under it, and a project's aback-ui.json names it as "@aback".
+ */
+export declare const DEFAULT_REGISTRY = "https://abackui.com/r";
+/**
+ * The registry copy shipped inside this package, at `<package>/registry`.
+ * Installing from it needs no network and always matches the CLI version.
+ * Returns null when running from source before `bun run build`.
+ */
+export declare function bundledRegistry(): string | null;
+/** The bundled registry when present, otherwise the hosted one. */
+export declare function defaultRegistry(): string;
+export declare class RegistryError extends Error {
+    constructor(message: string);
+}
+export interface RegistryClientOptions {
+    /** Registry base URL or a local directory containing `{name}.json` files. */
+    registry?: string;
+    /** Working directory used for local file specifiers. */
+    cwd?: string;
+    /** Named registry templates from aback-ui.json. */
+    registries?: Record<string, string>;
+    fetchImpl?: RegistryFetch;
+}
+export declare class RegistryClient {
+    private readonly base;
+    private readonly cwd;
+    private readonly registries;
+    private readonly fetchImpl;
+    private readonly items;
+    private indexCache;
+    constructor(options?: RegistryClientOptions);
+    index(): Promise<RegistryIndex>;
+    item(specifier: string): Promise<RegistryItem>;
+    /** Resolve a set of items and their dependencies, dependencies first. */
+    collect(specifiers: string[]): Promise<RegistryItem[]>;
+    private resolveSpecifier;
+    /**
+     * Map an abackui.com item URL onto the active registry base. Returns the
+     * input unchanged when the URL belongs to another registry or the default
+     * production registry is already in use.
+     */
+    private localiseDependency;
+    private readJson;
+}
+export declare function validateItem(raw: unknown, source: string): RegistryItem;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAG/C;AAED,mEAAmE;AACnE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAGD,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAUD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,OAAO,CAAC,UAAU,CAA8B;gBAEpC,OAAO,GAAE,qBAA0B;IAQzC,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAa/B,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAYpD,yEAAyE;IACnE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA0B5D,OAAO,CAAC,gBAAgB;IA+CxB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;YAwBZ,QAAQ;CA+BvB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAoBvE"}

package/dist/registry.js

@@ -0,0 +1,216 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * The canonical address of the Aback UI registry. Item files reference each
+ * other by URLs under it, and a project's aback-ui.json names it as "@aback".
+ */
+export const DEFAULT_REGISTRY = "https://abackui.com/r";
+/**
+ * The registry copy shipped inside this package, at `<package>/registry`.
+ * Installing from it needs no network and always matches the CLI version.
+ * Returns null when running from source before `bun run build`.
+ */
+export function bundledRegistry() {
+    const directory = fileURLToPath(new URL("../registry", import.meta.url));
+    return existsSync(path.join(directory, "index.json")) ? directory : null;
+}
+/** The bundled registry when present, otherwise the hosted one. */
+export function defaultRegistry() {
+    return bundledRegistry() ?? DEFAULT_REGISTRY;
+}
+const NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export class RegistryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RegistryError";
+    }
+}
+function isUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+function isLocalBase(base) {
+    return !isUrl(base);
+}
+export class RegistryClient {
+    base;
+    cwd;
+    registries;
+    fetchImpl;
+    items = new Map();
+    indexCache = null;
+    constructor(options = {}) {
+        this.base = (options.registry ?? DEFAULT_REGISTRY).replace(/\/$/, "");
+        this.cwd = options.cwd ?? process.cwd();
+        this.registries = options.registries ?? {};
+        this.fetchImpl =
+            options.fetchImpl ?? ((url) => fetch(url, { signal: AbortSignal.timeout(20_000) }));
+    }
+    async index() {
+        if (this.indexCache)
+            return this.indexCache;
+        const target = isUrl(this.base)
+            ? `${this.base}/index.json`
+            : path.join(this.base, "index.json");
+        const raw = await this.readJson(target);
+        if (!raw || typeof raw !== "object" || !Array.isArray(raw.items)) {
+            throw new RegistryError(`Registry index at ${target} is missing an items array.`);
+        }
+        this.indexCache = raw;
+        return this.indexCache;
+    }
+    async item(specifier) {
+        const { target, label } = this.resolveSpecifier(specifier);
+        const cached = this.items.get(label);
+        if (cached)
+            return cached;
+        const raw = await this.readJson(target);
+        const item = validateItem(raw, label);
+        this.items.set(item.name, item);
+        this.items.set(label, item);
+        return item;
+    }
+    /** Resolve a set of items and their dependencies, dependencies first. */
+    async collect(specifiers) {
+        const ordered = [];
+        const done = new Set();
+        const visiting = new Set();
+        const visit = async (specifier) => {
+            const item = await this.item(specifier);
+            if (done.has(item.name))
+                return;
+            if (visiting.has(item.name)) {
+                throw new RegistryError(`Circular registry dependency detected at "${item.name}".`);
+            }
+            visiting.add(item.name);
+            for (const dependency of item.registryDependencies ?? []) {
+                await visit(dependency);
+            }
+            visiting.delete(item.name);
+            done.add(item.name);
+            ordered.push(item);
+        };
+        for (const specifier of specifiers) {
+            await visit(specifier);
+        }
+        return ordered;
+    }
+    resolveSpecifier(specifier) {
+        const trimmed = specifier.trim();
+        if (!trimmed)
+            throw new RegistryError("Empty registry item name.");
+        if (isUrl(trimmed)) {
+            // Registry items carry absolute dependency URLs generated for the
+            // production registry. When a mirror, a staging host, or a local build
+            // is configured, resolve those same items against the active registry
+            // instead of reaching back out to abackui.com.
+            return { target: this.localiseDependency(trimmed), label: trimmed };
+        }
+        if (trimmed.startsWith("@")) {
+            const separator = trimmed.indexOf("/");
+            if (separator === -1) {
+                throw new RegistryError(`Registry alias "${trimmed}" must look like @aback/button.`);
+            }
+            const scope = trimmed.slice(0, separator);
+            const name = trimmed.slice(separator + 1);
+            const template = this.registries[scope];
+            if (!template) {
+                throw new RegistryError(`Unknown registry alias "${scope}". Add it to aback-ui.json under "registries".`);
+            }
+            const expanded = template.replace("{name}", name);
+            return this.resolveSpecifier(expanded);
+        }
+        if (trimmed.endsWith(".json")) {
+            const file = path.resolve(this.cwd, trimmed);
+            if (existsSync(file))
+                return { target: file, label: trimmed };
+        }
+        const name = trimmed.replace(/\.json$/, "");
+        if (!NAME_PATTERN.test(name)) {
+            throw new RegistryError(`Invalid item name "${specifier}". Use a lowercase kebab-case name, a URL, or @scope/name.`);
+        }
+        if (isLocalBase(this.base)) {
+            return { target: path.join(this.base, `${name}.json`), label: name };
+        }
+        return { target: `${this.base}/${name}.json`, label: name };
+    }
+    /**
+     * Map an abackui.com item URL onto the active registry base. Returns the
+     * input unchanged when the URL belongs to another registry or the default
+     * production registry is already in use.
+     */
+    localiseDependency(url) {
+        if (this.base === DEFAULT_REGISTRY)
+            return url;
+        // The bundled copy and any mirror serve the same file names.
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch {
+            return url;
+        }
+        const production = new URL(DEFAULT_REGISTRY);
+        if (parsed.origin !== production.origin || !parsed.pathname.startsWith("/r/")) {
+            return url;
+        }
+        const file = parsed.pathname.slice("/r/".length);
+        if (!file.endsWith(".json"))
+            return url;
+        const name = file.slice(0, -5);
+        if (!NAME_PATTERN.test(name))
+            return url;
+        return isLocalBase(this.base) ? path.join(this.base, file) : `${this.base}/${file}`;
+    }
+    async readJson(target) {
+        if (isUrl(target)) {
+            let response;
+            try {
+                response = await this.fetchImpl(target);
+            }
+            catch (error) {
+                throw new RegistryError(`Could not reach ${target}: ${error.message}`);
+            }
+            if (!response.ok) {
+                throw new RegistryError(response.status === 404
+                    ? `Registry item not found: ${target}`
+                    : `Registry request failed (${response.status}): ${target}`);
+            }
+            try {
+                return await response.json();
+            }
+            catch {
+                throw new RegistryError(`Registry response at ${target} is not valid JSON.`);
+            }
+        }
+        if (!existsSync(target)) {
+            throw new RegistryError(`Registry item not found: ${target}`);
+        }
+        try {
+            return JSON.parse(await readFile(target, "utf8"));
+        }
+        catch (error) {
+            throw new RegistryError(`Could not parse ${target}: ${error.message}`);
+        }
+    }
+}
+export function validateItem(raw, source) {
+    if (!raw || typeof raw !== "object") {
+        throw new RegistryError(`Registry item at ${source} is not an object.`);
+    }
+    const item = raw;
+    if (!item.name || !NAME_PATTERN.test(item.name)) {
+        throw new RegistryError(`Registry item at ${source} has an invalid name.`);
+    }
+    if (!Array.isArray(item.files) || item.files.length === 0) {
+        throw new RegistryError(`Registry item "${item.name}" has no files.`);
+    }
+    for (const file of item.files) {
+        if (!file || typeof file.content !== "string" || typeof file.target !== "string") {
+            throw new RegistryError(`Registry item "${item.name}" has a file without string content and target.`);
+        }
+    }
+    return item;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}