aback-ui 0.0.0-stage → 0.2.1

package/dist/commands/doctor.js

@@ -0,0 +1,45 @@
+import { findProjectRoot } from "../config.js";
+import { diagnoseProject } from "../doctor.js";
+import { commandError } from "../errors.js";
+const SYMBOL = {
+    pass: "✓",
+    warn: "!",
+    fail: "✗",
+    skip: "–",
+};
+export async function runDoctor(options) {
+    const root = await findProjectRoot(options.cwd);
+    if (!root) {
+        throw commandError(`No package.json found from ${options.cwd}. Run this inside a JavaScript project.`);
+    }
+    const report = await diagnoseProject({ root });
+    if (options.json) {
+        options.logger.raw(JSON.stringify(report, null, 2));
+        return report.summary.ok ? 0 : 1;
+    }
+    const { logger } = options;
+    logger.raw("Aback UI doctor");
+    logger.dim(report.root);
+    logger.raw("");
+    for (const check of report.checks) {
+        logger.raw(`${SYMBOL[check.status]} ${check.title}: ${check.detail}`);
+        if (check.hint && check.status !== "pass") {
+            logger.dim(`  → ${check.hint}`);
+        }
+    }
+    const { passed, warnings, errors, skipped } = report.summary;
+    logger.raw("");
+    logger.raw(`${passed} passed, ${warnings} warning${warnings === 1 ? "" : "s"}, ` +
+        `${errors} error${errors === 1 ? "" : "s"}${skipped ? `, ${skipped} skipped` : ""}.`);
+    if (errors > 0) {
+        logger.warn("Fix the errors above, then run `aback-ui doctor` again.");
+    }
+    else if (warnings > 0) {
+        logger.info("No blocking problems. Review the warnings above.");
+    }
+    else {
+        logger.success("Everything checks out.");
+    }
+    return report.summary.ok ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAS5C,MAAM,MAAM,GAAiC;IAC3C,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;CACV,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA6B;IAC3D,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,YAAY,CAChB,8BAA8B,OAAO,CAAC,GAAG,yCAAyC,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7D,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,CAAC,GAAG,CACR,GAAG,MAAM,YAAY,QAAQ,WAAW,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI;QACnE,GAAG,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CACvF,CAAC;IAEF,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACzE,CAAC;SAAM,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,19 @@
+import { type InstallDependenciesOptions } from "../install.js";
+import type { Logger } from "../logger.js";
+import type { Prompter } from "../prompt.js";
+import type { RegistryFetch } from "../types.js";
+export interface InitCommandOptions {
+    cwd: string;
+    yes?: boolean;
+    force?: boolean;
+    css?: string;
+    noInstall?: boolean;
+    dryRun?: boolean;
+    registry?: string;
+    logger: Logger;
+    prompter: Prompter;
+    fetchImpl?: RegistryFetch;
+    installPackages?: (options: InstallDependenciesOptions) => Promise<void>;
+}
+export declare function runInit(options: InitCommandOptions): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAgBA,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiH1E"}

package/dist/commands/init.js

@@ -0,0 +1,97 @@
+import path from "node:path";
+import { createConfig, detectAlias, detectCssFile, detectFramework, detectPackageManager, detectTailwindMajor, findProjectRoot, loadConfig, readPackageJson, readTsconfig, resolveInstallDirs, writeConfig, } from "../config.js";
+import { ensureThemeImport, installDependencies, writeItemFiles, } from "../install.js";
+import { safeJoin } from "../paths.js";
+import { RegistryClient, defaultRegistry } from "../registry.js";
+import { commandError } from "../errors.js";
+export async function runInit(options) {
+    const { logger } = options;
+    const projectRoot = await findProjectRoot(options.cwd);
+    if (!projectRoot) {
+        throw commandError(`No package.json found from ${options.cwd}. Run this inside a React project.`);
+    }
+    const existingConfig = await loadConfig(projectRoot);
+    if (existingConfig && !options.force) {
+        logger.info("aback-ui.json already exists. Nothing to do.");
+        logger.dim("Use `aback-ui add <component>` to install a component, or --force to rewrite the config.");
+        return 0;
+    }
+    const pkg = await readPackageJson(projectRoot);
+    const tailwindMajor = detectTailwindMajor(pkg);
+    if (tailwindMajor === null) {
+        throw commandError("Tailwind CSS is not installed. Aback UI needs Tailwind CSS v4; install it before running init.");
+    }
+    if (tailwindMajor < 4) {
+        throw commandError(`Tailwind CSS v${tailwindMajor} detected. The Aback theme uses Tailwind v4 directives (@theme inline); upgrade to v4 first.`);
+    }
+    const framework = detectFramework(pkg);
+    const tsconfig = await readTsconfig(projectRoot);
+    const alias = detectAlias(tsconfig, projectRoot);
+    if (!alias) {
+        logger.warn("No path alias found in tsconfig.json. Writing components with @/… aliases; add \"@/*\": [\"./src/*\"] to compilerOptions.paths if your build cannot resolve them.");
+    }
+    const cssRelative = options.css ?? existingConfig?.tailwind?.css ?? (await detectCssFile(projectRoot));
+    if (!cssRelative) {
+        throw commandError("Could not find your global stylesheet. Pass it explicitly, for example --css app/globals.css.");
+    }
+    const cssFile = safeJoin(projectRoot, cssRelative.replace(/^\.\//, ""));
+    const config = createConfig({
+        aliasPrefix: alias?.prefix ?? "@",
+        css: cssRelative.replace(/^\.\//, ""),
+        rsc: framework === "next",
+        tsx: true,
+        framework,
+    });
+    const registryBase = options.registry ?? process.env.ABACK_UI_REGISTRY ?? defaultRegistry();
+    const client = new RegistryClient({
+        registry: registryBase,
+        cwd: projectRoot,
+        registries: config.registries,
+        fetchImpl: options.fetchImpl,
+    });
+    logger.step("Adding the theme and shared utilities");
+    const items = await client.collect(["utils", "theme"]);
+    const dirs = await resolveInstallDirs(projectRoot, config);
+    const themeFile = path.join(dirs.styles, "aback.css");
+    if (!options.dryRun) {
+        await writeConfig(projectRoot, config);
+        logger.success("Wrote aback-ui.json");
+    }
+    else {
+        logger.info("Would write aback-ui.json");
+    }
+    await writeItemFiles({
+        items,
+        projectRoot,
+        dirs,
+        overwrite: options.yes ? "never" : "prompt",
+        dryRun: options.dryRun,
+        log: logger,
+        prompt: options.prompter,
+    });
+    const themeImport = await ensureThemeImport({
+        cssFile,
+        themeFile,
+        dryRun: options.dryRun,
+        log: logger,
+    });
+    if (themeImport === "missing") {
+        logger.warn(`Stylesheet ${cssRelative} does not exist. Add the theme import manually.`);
+    }
+    const install = options.installPackages ?? installDependencies;
+    await install({
+        cwd: projectRoot,
+        packageManager: await detectPackageManager(projectRoot),
+        dependencies: items.flatMap((item) => item.dependencies ?? []),
+        noInstall: options.noInstall,
+        dryRun: options.dryRun,
+        log: logger,
+    });
+    logger.raw("");
+    logger.success("Aback UI is ready.");
+    logger.info("Next steps:");
+    logger.dim("  aback-ui add button");
+    logger.dim("  aback-ui list");
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from "../logger.js";
+import type { RegistryFetch } from "../types.js";
+export interface ListCommandOptions {
+    registry?: string;
+    query?: string;
+    json?: boolean;
+    logger: Logger;
+    fetchImpl?: RegistryFetch;
+}
+export declare function runList(options: ListCommandOptions): Promise<number>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgD1E"}

package/dist/commands/list.js

@@ -0,0 +1,42 @@
+import { RegistryClient, defaultRegistry } from "../registry.js";
+export async function runList(options) {
+    const client = new RegistryClient({
+        registry: options.registry ?? process.env.ABACK_UI_REGISTRY ?? defaultRegistry(),
+        fetchImpl: options.fetchImpl,
+    });
+    const index = await client.index();
+    const term = options.query?.trim().toLowerCase() ?? "";
+    const items = index.items.filter((item) => {
+        if (!term)
+            return true;
+        const haystack = `${item.name} ${item.title} ${item.description} ${(item.categories ?? []).join(" ")}`;
+        return haystack.toLowerCase().includes(term);
+    });
+    if (options.json) {
+        options.logger.raw(JSON.stringify(items, null, 2));
+        return 0;
+    }
+    if (items.length === 0) {
+        options.logger.warn(`No registry items matched "${options.query}".`);
+        return 1;
+    }
+    const width = Math.min(30, Math.max(...items.map((item) => item.name.length)));
+    const groups = new Map();
+    for (const item of items) {
+        const group = item.categories?.[0] ?? (item.type === "registry:ui" ? "Components" : "Other");
+        const list = groups.get(group) ?? [];
+        list.push(item);
+        groups.set(group, list);
+    }
+    for (const group of [...groups.keys()].sort((a, b) => a.localeCompare(b))) {
+        const list = groups.get(group) ?? [];
+        options.logger.raw(`${group} (${list.length})`);
+        for (const item of list.sort((a, b) => a.title.localeCompare(b.title))) {
+            options.logger.raw(`  ${item.name.padEnd(width)}  ${item.description}`);
+        }
+        options.logger.raw("");
+    }
+    options.logger.dim(`Install with: aback-ui add <name>`);
+    return 0;
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/view.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from "../logger.js";
+import type { RegistryFetch } from "../types.js";
+export interface ViewCommandOptions {
+    item: string;
+    registry?: string;
+    json?: boolean;
+    logger: Logger;
+    fetchImpl?: RegistryFetch;
+}
+export declare function runView(options: ViewCommandOptions): Promise<number>;
+//# sourceMappingURL=view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/commands/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0C1E"}

package/dist/commands/view.js

@@ -0,0 +1,43 @@
+import { RegistryClient, defaultRegistry } from "../registry.js";
+export async function runView(options) {
+    const client = new RegistryClient({
+        registry: options.registry ?? process.env.ABACK_UI_REGISTRY ?? defaultRegistry(),
+        fetchImpl: options.fetchImpl,
+    });
+    const item = await client.item(options.item);
+    if (options.json) {
+        options.logger.raw(JSON.stringify(item, null, 2));
+        return 0;
+    }
+    const { logger } = options;
+    logger.raw(item.title ?? item.name);
+    logger.dim(`${item.name} · ${item.type}`);
+    logger.raw("");
+    logger.raw(item.description ?? "No description.");
+    logger.raw("");
+    const sections = [];
+    if (item.categories?.length)
+        sections.push(["Categories", item.categories.join(", ")]);
+    if (item.dependencies?.length)
+        sections.push(["Dependencies", item.dependencies.join(", ")]);
+    if (item.devDependencies?.length) {
+        sections.push(["Dev dependencies", item.devDependencies.join(", ")]);
+    }
+    if (item.registryDependencies?.length) {
+        sections.push(["Registry dependencies", item.registryDependencies.join(", ")]);
+    }
+    if (item.meta?.status)
+        sections.push(["Status", String(item.meta.status)]);
+    if (item.docs)
+        sections.push(["Docs", item.docs]);
+    for (const [label, value] of sections) {
+        logger.raw(`${label.padEnd(20)} ${value}`);
+    }
+    logger.raw("");
+    logger.raw("Files");
+    for (const file of item.files) {
+        logger.raw(`  ${file.target ?? file.path}`);
+    }
+    return 0;
+}
+//# sourceMappingURL=view.js.map

package/dist/commands/view.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,66 @@
+import type { AbackConfig, InstallDirs, PackageManager } from "./types.js";
+export interface PackageJson {
+    name?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    packageManager?: string;
+    [key: string]: unknown;
+}
+export interface TsconfigPaths {
+    baseUrl?: string;
+    paths: Record<string, string[]>;
+}
+export interface AliasInfo {
+    /** The alias prefix, including the trailing slash, for example `@/`. */
+    prefix: string;
+    /** Absolute directory the alias resolves to. */
+    base: string;
+    /** Every raw path mapping from tsconfig, for custom alias lookups. */
+    paths: Record<string, string[]>;
+}
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare function existsPath(file: string): Promise<boolean>;
+/** Walk upward from `start` until a package.json is found. */
+export declare function findProjectRoot(start: string): Promise<string | null>;
+export declare function readPackageJson(root: string): Promise<PackageJson>;
+export declare function detectPackageManager(root: string): Promise<PackageManager>;
+export declare function detectFramework(pkg: PackageJson): "next" | "vite" | "remix" | "astro" | "unknown";
+/** Major version of the installed Tailwind package, or null when absent. */
+export declare function detectTailwindMajor(pkg: PackageJson): number | null;
+export declare function detectSrcDir(root: string): Promise<string>;
+/**
+ * Strip comments and trailing commas from a JSON-with-comments file. The scan
+ * skips over strings, because tsconfig paths such as "@/*" and "**\/*.ts"
+ * look like comment markers.
+ */
+export declare function parseJsonc(source: string): unknown;
+export declare function readTsconfig(root: string): Promise<TsconfigPaths>;
+/**
+ * Resolve a path alias such as `@/components/ui` against the tsconfig paths.
+ * Returns null when the alias has no mapping or escapes the project.
+ */
+export declare function resolveAlias(alias: string, tsconfig: TsconfigPaths, root: string): {
+    absolute: string;
+    prefix: string;
+} | null;
+/** Best-effort alias from the tsconfig: prefer `@/*`, otherwise the first wildcard. */
+export declare function detectAlias(tsconfig: TsconfigPaths, root: string): AliasInfo | null;
+export declare function detectCssFile(root: string): Promise<string | null>;
+/** The project configuration file `aback-ui init` writes. */
+export declare const CONFIG_FILE = "aback-ui.json";
+export declare function loadConfig(root: string): Promise<AbackConfig | null>;
+export declare function writeConfig(root: string, config: AbackConfig): Promise<void>;
+export interface ConfigInput {
+    aliasPrefix: string;
+    css: string;
+    rsc: boolean;
+    tsx: boolean;
+    framework: ReturnType<typeof detectFramework>;
+}
+export declare function createConfig({ aliasPrefix, css, rsc, tsx, framework }: ConfigInput): AbackConfig;
+/** Project directories for each alias, resolved against the project root. */
+export declare function resolveInstallDirs(root: string, config: AbackConfig): Promise<InstallDirs>;
+export declare function ensureDirectory(directory: string): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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