@prestyj/cli 5.24.0 → 5.25.0

package/dist/core/ui-adoption.js

@@ -0,0 +1,300 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import ts from "typescript";
+import { compatibilityPatch } from "./ui-compatibility.js";
+import { localOperations, readFileBounded } from "../tools/operations.js";
+import { registryPath, payloadHash } from "./ui-registry.js";
+async function contained(root, target) {
+    if (path.isAbsolute(target) || target.includes("\\"))
+        throw new Error("Absolute adoption target refused");
+    const safe = registryPath(target);
+    if (safe !== target ||
+        safe
+            .split("/")
+            .some((p) => p.startsWith(".") ||
+            /^(con|prn|aux|nul|com[0-9]|lpt[0-9])(?:\.|$)/i.test(p) ||
+            /[. ]$/.test(p)))
+        throw new Error("Reserved adoption path");
+    const resolved = path.resolve(root, safe);
+    if (!path.relative(root, resolved) || path.relative(root, resolved).startsWith(".."))
+        throw new Error("Target escapes workspace");
+    let current = root;
+    for (const part of safe.split("/")) {
+        current = path.join(current, part);
+        try {
+            const stat = await fs.lstat(current);
+            if (stat.isSymbolicLink())
+                throw new Error("Symlink adoption path refused");
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+    }
+    return resolved;
+}
+async function readOptional(root, target) {
+    try {
+        return (await readFileBounded(await contained(root, target), 1000000)).toString("utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+export function moduleSpecifiers(content) {
+    const source = ts.createSourceFile("component.tsx", content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+    const specs = [];
+    const visit = (node) => {
+        let spec;
+        if (ts.isImportDeclaration(node) || ts.isExportDeclaration(node))
+            spec = node.moduleSpecifier;
+        if (ts.isCallExpression(node) &&
+            (node.expression.kind === ts.SyntaxKind.ImportKeyword ||
+                (ts.isIdentifier(node.expression) && node.expression.text === "require")))
+            spec = node.arguments[0];
+        if (spec && ts.isStringLiteralLike(spec))
+            specs.push({ start: spec.getStart(source) + 1, end: spec.getEnd() - 1, value: spec.text });
+        ts.forEachChild(node, visit);
+    };
+    visit(source);
+    return specs;
+}
+const withoutExtension = (value) => value.replace(/\.(tsx?|jsx?)$/, "");
+export function relocateImports(content, resolve) {
+    for (const spec of moduleSpecifiers(content).reverse()) {
+        const relocated = resolve(spec.value);
+        content = content.slice(0, spec.start) + relocated + content.slice(spec.end);
+    }
+    return content;
+}
+export async function planAdoption(cwd, registry, entry, signal) {
+    const root = await fs.realpath(cwd);
+    const pkg = JSON.parse((await readOptional(root, "package.json")) ?? "{}");
+    const installed = { ...pkg.dependencies, ...pkg.devDependencies };
+    const framework = installed.next
+        ? "next"
+        : installed.vite && installed.react
+            ? "vite-react"
+            : "unsupported";
+    const blockers = framework === "unsupported"
+        ? ["Only existing React Vite and Next projects are supported."]
+        : [];
+    const packageManager = (await readOptional(root, "pnpm-lock.yaml")) !== undefined
+        ? "pnpm"
+        : (await readOptional(root, "yarn.lock")) !== undefined
+            ? "yarn"
+            : (await readOptional(root, "bun.lock")) !== undefined
+                ? "bun"
+                : "npm";
+    const components = JSON.parse((await readOptional(root, "components.json")) ?? "{}");
+    const configText = (await readOptional(root, "tsconfig.json")) ??
+        (await readOptional(root, "jsconfig.json")) ??
+        "{}";
+    const parsed = ts.parseConfigFileTextToJson("tsconfig.json", configText);
+    if (parsed.error)
+        throw new Error("Cannot parse project aliases");
+    const config = parsed.config;
+    const paths = config.compilerOptions?.paths ?? {};
+    const baseUrl = config.compilerOptions?.baseUrl ?? ".";
+    const hasSrc = await fs.stat(path.join(root, "src")).then((s) => s.isDirectory(), () => false);
+    const defaultRoot = hasSrc ? "src" : "";
+    const aliasTarget = (alias) => {
+        const matches = Object.entries(paths).flatMap(([pattern, targets]) => {
+            const prefix = pattern.replace(/\*$/, "");
+            if (alias === pattern || (pattern.endsWith("*") && alias.startsWith(prefix))) {
+                return targets.map((target) => path.posix.join(baseUrl, target.replace(/\*$/, "") + alias.slice(prefix.length)));
+            }
+            return [];
+        });
+        if (matches.length > 1)
+            throw new Error(`Ambiguous alias: ${alias}`);
+        if (matches.length === 1)
+            return registryPath(matches[0]);
+        if (alias.startsWith("@/"))
+            return path.posix.join(defaultRoot, alias.slice(2));
+        throw new Error(`Unresolved alias: ${alias}. Configure project paths first.`);
+    };
+    const aliases = {
+        ui: "@/components/ui",
+        components: "@/components",
+        hooks: "@/hooks",
+        lib: "@/lib",
+        utils: "@/lib/utils",
+        ...components.aliases,
+    };
+    const sources = await registry.closure(entry, signal);
+    const files = [];
+    const targetSet = new Set();
+    const styles = [];
+    const compatibility = [];
+    const missing = new Set();
+    for (const source of sources) {
+        for (const dep of [
+            ...(source.item.dependencies ?? []),
+            ...(source.item.devDependencies ?? []),
+        ]) {
+            if (!/^(?:@[a-z0-9._-]+\/)?[a-z0-9._-]+(?:@[a-zA-Z0-9.^~<>=|*+ -]+)?$/.test(dep))
+                throw new Error(`Unsupported package specifier: ${dep}`);
+            const name = dep.replace(/(?<!^)@[^/]*$/, "");
+            if (!installed[name])
+                missing.add(dep);
+            if (/iconist/i.test(name))
+                blockers.push(`Review nonstandard/unknown license for ${name} before production use.`);
+        }
+        if (source.item.css || source.item.cssVars || source.item.tailwind)
+            styles.push({
+                id: source.id,
+                css: source.item.css,
+                cssVars: source.item.cssVars,
+                tailwind: source.item.tailwind,
+            });
+        for (const [index, file] of source.item.files.entries()) {
+            const sourcePath = registryPath(file.path);
+            let target;
+            if (file.target) {
+                if (file.target.startsWith("/"))
+                    throw new Error("Absolute installation target refused");
+                target = file.target.replace(/^~\//, `${defaultRoot ? `${defaultRoot}/` : ""}`);
+            }
+            else {
+                const type = file.type ?? source.item.type;
+                const directory = type === "registry:hook"
+                    ? aliases.hooks
+                    : type === "registry:lib"
+                        ? aliases.lib
+                        : type === "registry:ui"
+                            ? aliases.ui
+                            : aliases.components;
+                target = path.posix.join(aliasTarget(directory), path.posix.basename(sourcePath));
+            }
+            if (!/\.(tsx?|jsx?|css)$/.test(target) ||
+                /(?:^|\/)(?:page|layout|route|middleware|instrumentation|.*\.config)\.[^.]+$/.test(target) ||
+                /(?:^|\/)(?:node_modules|public|dist|scripts|app|pages)(?:\/|$)/.test(target))
+                throw new Error(`Reserved or non-component target: ${target}`);
+            await contained(root, target);
+            if (targetSet.has(target.toLowerCase()))
+                throw new Error(`Ambiguous installation target: ${target}`);
+            targetSet.add(target.toLowerCase());
+            const patched = compatibilityPatch(source.id, sourcePath, file.content);
+            if (patched.notice)
+                compatibility.push(patched.notice);
+            files.push({
+                sourceId: `${source.id}#${index}`,
+                sourcePath,
+                target,
+                content: patched.content,
+                status: "new",
+            });
+        }
+    }
+    for (const file of files) {
+        file.content = relocateImports(file.content, (specifier) => {
+            if (!specifier.startsWith(".") && !specifier.startsWith("@/")) {
+                if (specifier.startsWith("next/") && framework !== "next")
+                    blockers.push(`${file.sourceId} requires Next.js (${specifier}); no framework shims are installed.`);
+                return specifier;
+            }
+            const candidate = specifier.startsWith(".")
+                ? path.posix.normalize(path.posix.join(path.posix.dirname(file.sourcePath), specifier))
+                : specifier.slice(2);
+            const matches = files.filter((f) => withoutExtension(f.sourcePath) === withoutExtension(candidate) ||
+                withoutExtension(f.sourcePath).endsWith(`/${withoutExtension(candidate)}`));
+            if (matches.length > 1)
+                throw new Error(`Ambiguous source import: ${specifier}`);
+            let destination = matches[0]?.target;
+            if (!destination && specifier === "@/lib/utils")
+                destination = aliasTarget(aliases.utils) + ".ts";
+            if (!destination && specifier.startsWith("@/"))
+                destination = aliasTarget(specifier);
+            if (!destination)
+                return specifier;
+            let relative = path.posix.relative(path.posix.dirname(file.target), withoutExtension(destination));
+            if (!relative.startsWith("."))
+                relative = `./${relative}`;
+            return relative;
+        });
+        const existing = await readOptional(root, file.target);
+        if (existing !== undefined) {
+            // Existing shadcn primitives are authoritative, not silently replaced.
+            file.status =
+                existing === file.content || file.sourceId.startsWith("shadcn:") ? "reuse" : "conflict";
+        }
+    }
+    for (const file of files) {
+        for (const spec of moduleSpecifiers(file.content)) {
+            if (!spec.value.startsWith("."))
+                continue;
+            const target = path.posix.normalize(path.posix.join(path.posix.dirname(file.target), spec.value));
+            const available = files.some((f) => withoutExtension(f.target) === withoutExtension(target));
+            if (!available) {
+                const candidates = [
+                    target,
+                    `${target}.ts`,
+                    `${target}.tsx`,
+                    `${target}.js`,
+                    `${target}.jsx`,
+                    `${target}/index.ts`,
+                    `${target}/index.tsx`,
+                ];
+                let exists = false;
+                for (const candidate of candidates)
+                    if ((await readOptional(root, candidate)) !== undefined) {
+                        exists = true;
+                        break;
+                    }
+                if (!exists)
+                    blockers.push(`Missing local prerequisite: ${spec.value} consumed by ${file.target}. Resolve it before adoption.`);
+            }
+        }
+    }
+    const plan = {
+        entry,
+        framework,
+        packageManager,
+        tailwind: installed.tailwindcss ?? null,
+        files,
+        missingPackages: [...missing].sort(),
+        blockers: [...new Set(blockers)],
+        styles,
+        attribution: [
+            ...sources.map((s) => `${s.id}: ${s.attribution} Hosted SHA256 ${s.payloadHash}; inventory revision ${s.inventoryRevision ?? "unknown"}; equivalence not verified.`),
+            ...compatibility,
+        ],
+        instructions: [
+            "Install missing packages only through normal authorized dependency changes; this tool never runs install scripts.",
+            "Review required CSS/providers against existing theme tokens. Preserve notices and library styling. Build a real consumer and verify callbacks, keyboard behavior, reduced motion and repeated cleanup.",
+            "Existing shadcn primitives take precedence. Reused files may have different contracts: inspect their exports before integrating.",
+        ],
+    };
+    return { ...plan, hash: payloadHash(JSON.stringify(plan)) };
+}
+/** Same write tool pipeline, but the final filesystem operation exclusively creates new files. */
+export function adoptionOperations(cwd) {
+    return {
+        ...localOperations,
+        writeFile: async (target, content) => {
+            const root = await fs.realpath(cwd);
+            const relative = path.relative(path.resolve(cwd), target).split(path.sep).join("/");
+            const resolved = await contained(root, relative);
+            await fs.mkdir(path.dirname(resolved), { recursive: true });
+            await contained(root, relative);
+            await fs.writeFile(resolved, content, { encoding: "utf8", flag: "wx" });
+        },
+    };
+}
+export async function preflightAdoption(cwd, plan) {
+    if (plan.blockers.length || plan.files.some((f) => f.status === "conflict"))
+        throw new Error("Adoption blocked: resolve prerequisites and file conflicts first");
+    const root = await fs.realpath(cwd);
+    for (const file of plan.files) {
+        await contained(root, file.target);
+        const existing = await readOptional(root, file.target);
+        if (file.status === "new" && existing !== undefined)
+            throw new Error(`File appeared after planning: ${file.target}`);
+        if (file.status === "reuse" && existing === undefined)
+            throw new Error(`Reused file disappeared: ${file.target}`);
+    }
+}
+//# sourceMappingURL=ui-adoption.js.map

package/dist/core/ui-adoption.js.map

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

package/dist/core/ui-compatibility.d.ts

@@ -0,0 +1,10 @@
+export declare const MOUSE_CARD_SOURCE_HASH = "3a1a1c3308214e69a6a1129e2d1191cae87b6d071b70a8a1ded0253b263d7483";
+/** Reviewed cleanup recipe: retain the repeating animation's own cancellation handle. */
+export declare function patchMouseCard(source: string): string;
+export declare function compatibilityPatch(id: string, sourcePath: string, content: string): {
+    content: string;
+    notice?: undefined;
+} | {
+    content: string;
+    notice: string;
+};

package/dist/core/ui-compatibility.js

@@ -0,0 +1,51 @@
+import { payloadHash } from "./ui-registry.js";
+export const MOUSE_CARD_SOURCE_HASH = "3a1a1c3308214e69a6a1129e2d1191cae87b6d071b70a8a1ded0253b263d7483";
+/** Reviewed cleanup recipe: retain the repeating animation's own cancellation handle. */
+export function patchMouseCard(source) {
+    if (payloadHash(source) !== MOUSE_CARD_SOURCE_HASH)
+        throw new Error("Mouse Effect Card source differs from reviewed snapshot; review before patching");
+    const replace = (from, to) => {
+        if (source.split(from).length !== 2)
+            throw new Error("Ambiguous Mouse Effect Card cleanup patch");
+        source = source.replace(from, to);
+    };
+    replace('import { motion, useMotionValue, useSpring, useTransform } from "motion/react";', 'import { animate, motion, useMotionValue, useSpring, useTransform } from "motion/react";');
+    replace("  const delay = (index * OPACITY_DELAY_STEP) % OPACITY_DELAY_CYCLE;", `  const delay = (index * OPACITY_DELAY_STEP) % OPACITY_DELAY_CYCLE;
+  const opacity = useSpring(minOpacityWithBoost, {
+    stiffness: 150,
+    damping: 25,
+  });
+
+  useEffect(() => {
+    // A following spring can replace MotionValue.animation. Keep a separate
+    // handle for the repeating pulse so unmount always stops its frame driver.
+    const pulse = animate(opacity, [baseMinOpacity, baseMaxOpacity, baseMinOpacity], {
+      duration: OPACITY_DURATION_BASE + (index % 4) * OPACITY_DURATION_VARIATION,
+      repeat: Number.POSITIVE_INFINITY,
+      ease: OPACITY_EASE,
+      delay,
+      times: [0, 0.5, 1],
+    });
+    return () => pulse.stop();
+  }, [opacity, baseMinOpacity, baseMaxOpacity, index, delay]);`);
+    replace("      animate={{\n        opacity: [baseMinOpacity, baseMaxOpacity, baseMinOpacity],\n      }}\n", "");
+    replace("        opacity: useSpring(minOpacityWithBoost, {\n          stiffness: 150,\n          damping: 25,\n        }),", "        opacity,");
+    replace("      transition={{\n        opacity: {\n          duration:\n            OPACITY_DURATION_BASE + (index % 4) * OPACITY_DURATION_VARIATION,\n          repeat: Number.POSITIVE_INFINITY,\n          ease: OPACITY_EASE,\n          delay,\n          times: [0, 0.5, 1],\n        },\n      }}\n", "");
+    return source;
+}
+export function compatibilityPatch(id, sourcePath, content) {
+    if (id !== "kokonut:mouse-effect-card" || !sourcePath.endsWith("/mouse-effect-card.tsx"))
+        return { content };
+    const originalHash = payloadHash(content);
+    if (originalHash !== MOUSE_CARD_SOURCE_HASH)
+        return {
+            content,
+            notice: "Mouse Effect Card cleanup recipe not applied: unreviewed source hash. Verify animation teardown independently.",
+        };
+    const patched = patchMouseCard(content);
+    return {
+        content: patched,
+        notice: `Mouse Effect Card owned-animation cleanup: original SHA256 ${originalHash}; patched SHA256 ${payloadHash(patched)}. Import relocation is a separate subsequent transformation.`,
+    };
+}
+//# sourceMappingURL=ui-compatibility.js.map

package/dist/core/ui-compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-compatibility.js","sourceRoot":"","sources":["../../src/core/ui-compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,sBAAsB,GACjC,kEAAkE,CAAC;AAErE,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,sBAAsB;QAChD,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAU,EAAQ,EAAE;QACjD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,OAAO,CACL,iFAAiF,EACjF,0FAA0F,CAC3F,CAAC;IACF,OAAO,CACL,qEAAqE,EACrE;;;;;;;;;;;;;;;;;+DAiB2D,CAC5D,CAAC;IACF,OAAO,CACL,kGAAkG,EAClG,EAAE,CACH,CAAC;IACF,OAAO,CACL,mHAAmH,EACnH,kBAAkB,CACnB,CAAC;IACF,OAAO,CACL,kSAAkS,EAClS,EAAE,CACH,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,UAAkB,EAAE,OAAe;IAChF,IAAI,EAAE,KAAK,2BAA2B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACtF,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,YAAY,KAAK,sBAAsB;QACzC,OAAO;YACL,OAAO;YACP,MAAM,EACJ,gHAAgH;SACnH,CAAC;IACJ,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,8DAA8D,YAAY,oBAAoB,WAAW,CAAC,OAAO,CAAC,8DAA8D;KACzL,CAAC;AACJ,CAAC"}

package/dist/core/ui-registry.d.ts

@@ -0,0 +1,101 @@
+import { z } from "zod";
+import { type GetNetworkPolicy } from "./network-guard.js";
+export declare const UI_PROVIDERS: {
+    readonly bklit: {
+        readonly repo: "bklit/bklit-ui";
+        readonly revision: "0dfdfc57ca068470ccfb93c4501cebc555c9054d";
+        readonly manifest: "packages/ui/registry.json";
+        readonly root: "https://ui.bklit.com/r/";
+    };
+    readonly kokonut: {
+        readonly repo: "kokonut-labs/kokonutui";
+        readonly revision: "83eec6d982d400a18438001a8efdbac1f159dd43";
+        readonly manifest: "registry.json";
+        readonly root: "https://kokonutui.com/r/";
+    };
+};
+declare const itemSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "registry:component": "registry:component";
+        "registry:block": "registry:block";
+        "registry:example": "registry:example";
+        "registry:hook": "registry:hook";
+        "registry:lib": "registry:lib";
+        "registry:ui": "registry:ui";
+        "registry:style": "registry:style";
+        "registry:theme": "registry:theme";
+        "registry:file": "registry:file";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+        target: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    devDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    registryDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    css: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cssVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    docs: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    $schema: z.ZodOptional<z.ZodString>;
+    tailwind: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type RegistryItem = z.infer<typeof itemSchema>;
+export interface RegistrySource {
+    id: string;
+    item: RegistryItem;
+    url: string;
+    payloadHash: string;
+    inventoryRevision?: string;
+    hostedMatchesRevision: "not-verified";
+    dependencies: string[];
+    attribution: string;
+}
+export declare const payloadHash: (text: string) => string;
+export declare function registryPath(value: string): string;
+export declare function registryUrl(value: string): URL;
+export declare function registryKey(value: string): string;
+export declare function validateRegistryItem(input: unknown, source?: boolean): RegistryItem;
+export declare function resolveRegistryFile(source: RegistrySource, selector: string): {
+    path: string;
+    type?: string | undefined;
+    target?: string | undefined;
+    content?: string | undefined;
+};
+export declare const MOTION_GUIDANCE: {
+    kind: string;
+    package: string;
+    import: string;
+    documentation: string;
+    guidance: string;
+    families: string[];
+};
+/** Lazy, bounded per-session cache; every fetch and redirect respects current network policy. */
+export declare class UiRegistry {
+    private getNetworkPolicy?;
+    private fetcher;
+    private cache;
+    private cacheBytes;
+    constructor(getNetworkPolicy?: GetNetworkPolicy | undefined, fetcher?: typeof fetch);
+    fetchText(value: string, signal?: AbortSignal): Promise<{
+        text: string;
+        url: string;
+        hash: string;
+    }>;
+    search(query?: string, signal?: AbortSignal): Promise<{
+        id: string;
+        name: string;
+        description?: string;
+        type: string;
+    }[]>;
+    inspect(value: string, signal?: AbortSignal): Promise<RegistrySource>;
+    closure(value: string, signal?: AbortSignal): Promise<RegistrySource[]>;
+}
+export {};