adjacent-cli 0.1.0

package/dist/init.js

@@ -0,0 +1,275 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ADJACENT_PACKAGES, matchesWorkspaceGlob, resolveAdjacentDependencies, } from "./dependencies.js";
+import { createProjectEdits } from "./edits.js";
+import { resolvePackageManager, } from "./package-manager.js";
+import { runInheritedCommand } from "./process.js";
+import { TERMINAL_REPORTER } from "./reporter.js";
+import { createNextConfig, injectAdjacentStyles, wrapNextConfig, wrapRootLayout, } from "./rewrite.js";
+import { renderTemplateTree } from "./template.js";
+import { surveyProject } from "./survey.js";
+function moduleDirectory() {
+    return dirname(fileURLToPath(import.meta.url));
+}
+export function defaultTemplatesRoot(from = moduleDirectory()) {
+    return resolve(from, "..", "templates");
+}
+/**
+ * Finds the framework's `packages/` directory when this CLI runs from a
+ * checkout, so a generated application can depend on the local sources. Returns
+ * nothing once the CLI is installed from a registry.
+ */
+export async function findWorkspacePackagesRoot(from = moduleDirectory()) {
+    let current = resolve(from);
+    while (true) {
+        // A directory name alone is not distinctive, so the manifest inside it
+        // has to be the one this CLI expects before the checkout counts as ours.
+        const candidate = join(current, "packages", "adjacent-core", "package.json");
+        const manifest = await readFile(candidate, "utf8").catch(() => undefined);
+        if (manifest !== undefined) {
+            const parsed = JSON.parse(manifest);
+            if (parsed.name === "adjacent-core")
+                return join(current, "packages");
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+/**
+ * Whether a project sits inside the framework's own Bun workspace. A member is
+ * linked with `workspace:*`, which is the only form that survives a clean
+ * checkout: Bun resolves it, so the framework's packages find each other
+ * wherever they are installed from.
+ */
+export async function isWorkspaceMember(workspaceRoot, projectRoot) {
+    const raw = await readFile(join(workspaceRoot, "package.json"), "utf8").catch(() => undefined);
+    if (raw === undefined)
+        return false;
+    let globs = [];
+    try {
+        const manifest = JSON.parse(raw);
+        if (Array.isArray(manifest.workspaces)) {
+            globs = manifest.workspaces.filter((glob) => typeof glob === "string");
+        }
+    }
+    catch {
+        return false;
+    }
+    const location = relative(workspaceRoot, projectRoot).split(sep).join("/");
+    if (location === "" || location.startsWith(".."))
+        return false;
+    return globs.some((glob) => matchesWorkspaceGlob(location, glob));
+}
+/**
+ * Adds the Adjacent packages to an existing manifest, leaving every other field
+ * alone. A `typecheck` script is added only when the project has none.
+ */
+export function addAdjacentDependencies(manifest, dependencies) {
+    const existing = typeof manifest.dependencies === "object" && manifest.dependencies !== null
+        ? manifest.dependencies
+        : {};
+    const scripts = typeof manifest.scripts === "object" && manifest.scripts !== null
+        ? manifest.scripts
+        : {};
+    const merged = {
+        ...manifest,
+        dependencies: Object.fromEntries(Object.entries({ ...existing, ...dependencies.dependencies }).sort(([a], [b]) => a.localeCompare(b))),
+        // `next typegen` first, because Next.js generates the route types the App
+        // Router relies on (LayoutProps and friends) and tsc cannot see them until
+        // it has run at least once.
+        scripts: {
+            ...scripts,
+            ...(scripts.typecheck ? null : { typecheck: "next typegen && tsc --noEmit" }),
+        },
+    };
+    if (dependencies.overrides) {
+        const configured = typeof manifest.overrides === "object" && manifest.overrides !== null
+            ? manifest.overrides
+            : {};
+        merged.overrides = { ...configured, ...dependencies.overrides };
+    }
+    return merged;
+}
+async function installDependencies(root, options = {}) {
+    const manager = await resolvePackageManager({ projectRoot: root });
+    const { args, command } = manager.install(options);
+    await runInheritedCommand(command, args, { cwd: root }).catch((error) => {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not install dependencies in ${root}: ${detail}\n` +
+            `Adjacent was added to the project. Install by hand with: ${command} ${args.join(" ")}`);
+    });
+}
+async function applyRewrite({ edits, file, manual, outcome, }) {
+    if (outcome.kind === "rewritten") {
+        await edits.rewriteFile(file, outcome.contents);
+        return;
+    }
+    if (outcome.kind === "manual") {
+        manual.push({ file, instruction: outcome.instruction });
+    }
+}
+/**
+ * Adds Adjacent to an existing Next.js App Router application: the files it
+ * needs, the wrapping of the two files the application owns, and the packages
+ * it depends on. Anything that cannot be rewritten safely is reported instead.
+ */
+export async function runInit(options, ports = {}) {
+    const report = ports.reporter ?? TERMINAL_REPORTER;
+    const root = resolve(options.projectRoot);
+    const survey = await surveyProject(root);
+    const templatesRoot = ports.templatesRoot ?? defaultTemplatesRoot();
+    const manager = await resolvePackageManager({ projectRoot: root });
+    const packagesRoot = await findWorkspacePackagesRoot();
+    const dependencies = ports.dependencies ??
+        resolveAdjacentDependencies({
+            ...(packagesRoot === undefined ? null : { packagesRoot }),
+            projectRoot: root,
+            workspaceMember: packagesRoot !== undefined &&
+                (await isWorkspaceMember(dirname(packagesRoot), root)),
+        });
+    const installOptions = { isolated: dependencies.pathLinked };
+    const edits = createProjectEdits(root);
+    const manual = [];
+    // `src/app` means the project keeps its sources under `src/`, so anything
+    // Adjacent adds beside the app directory belongs there too.
+    const sourceRoot = dirname(survey.appDirectory);
+    const relocate = (path) => sourceRoot === "." ? path : join(sourceRoot, path);
+    try {
+        // app.config.ts stays at the project root while everything else follows the
+        // app directory, so a project keeping its sources under src/ needs one more
+        // level than one that does not.
+        const configFromApp = sourceRoot === "." ? "../app.config" : "../../app.config";
+        const values = {
+            appName: survey.identity.appName,
+            configFromApp,
+            configFromRoute: `../${configFromApp}`,
+            packageName: survey.identity.packageName,
+            shortName: survey.identity.shortName,
+            slug: survey.identity.slug,
+        };
+        const injected = await renderTemplateTree({
+            relocate: (path) => 
+            // app.config.ts and public/ stay at the project root; the rest follows
+            // the app directory.
+            path === "app.config.ts" || path.startsWith("public/")
+                ? path
+                : relocate(path),
+            sink: (path, contents) => edits.addFile(path, contents),
+            templateRoot: join(templatesRoot, "adjacent"),
+            values,
+        });
+        // Nothing Adjacent injects overwrites a file that is already there, so an
+        // application with its own components/navigation.tsx keeps it and never
+        // receives Adjacent's. Silently importing the wrong component from the
+        // layout is the one outcome worth refusing, so say so instead.
+        const navigationFile = relocate("components/navigation.tsx");
+        if (!injected.includes(navigationFile)) {
+            manual.push({
+                file: navigationFile,
+                instruction: "A file of this name already exists, so Adjacent's navigation was " +
+                    "not written and nothing here imports it yet.\n\n" +
+                    "Either rename the existing file and run `adj init` again, or build " +
+                    "the navigation yourself with `Tabs` and `Tab` from `adjacent-ui`, " +
+                    "and render it through the `navigation` prop of `NavigationShell`.",
+            });
+        }
+        if (options.scaffold) {
+            await renderTemplateTree({
+                relocate,
+                sink: (path, contents) => edits.addFile(path, contents),
+                templateRoot: join(templatesRoot, "starter"),
+                values,
+            });
+            // The starter route group owns the index route, so the placeholder page
+            // create-next-app wrote is removed rather than left to conflict with it.
+            await edits.removeFile(join(survey.appDirectory, "page.tsx"));
+        }
+        const nextConfigFile = survey.nextConfigFile ?? "next.config.ts";
+        const nextConfigSource = await edits.readFile(nextConfigFile);
+        if (nextConfigSource === undefined) {
+            await edits.addFile(nextConfigFile, createNextConfig());
+        }
+        else {
+            await applyRewrite({
+                edits,
+                file: nextConfigFile,
+                manual,
+                outcome: wrapNextConfig(nextConfigSource),
+            });
+        }
+        const layoutSource = await edits.readFile(survey.layoutFile);
+        if (layoutSource !== undefined) {
+            await applyRewrite({
+                edits,
+                file: survey.layoutFile,
+                manual,
+                outcome: wrapRootLayout(layoutSource, {
+                    configImportPath: sourceRoot === "." ? "../app.config" : "../../app.config",
+                    scaffolded: options.scaffold === true,
+                }),
+            });
+        }
+        if (survey.globalsCss) {
+            const styles = await edits.readFile(survey.globalsCss);
+            if (styles !== undefined) {
+                await applyRewrite({
+                    edits,
+                    file: survey.globalsCss,
+                    manual,
+                    outcome: injectAdjacentStyles(styles, { tailwind: survey.hasTailwind }),
+                });
+            }
+        }
+        await edits.rewriteFile("package.json", `${JSON.stringify(addAdjacentDependencies(survey.packageJson, dependencies), null, 2)}\n`);
+    }
+    catch (error) {
+        await edits.rollback();
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not add Adjacent to ${root}: ${detail}`);
+    }
+    const summary = edits.summary();
+    report.success(`Added ${summary.added.length} file${summary.added.length === 1 ? "" : "s"} and updated ${summary.rewritten.length}`);
+    let installed = false;
+    if (options.install) {
+        report.step("Installing dependencies with Bun");
+        await (ports.install ?? installDependencies)(root, installOptions);
+        installed = true;
+        report.success("Installed dependencies");
+    }
+    for (const step of manual) {
+        report.step(`${step.file} needs one edit by hand:\n\n${step.instruction}\n`);
+    }
+    return {
+        added: summary.added,
+        installed,
+        installOptions,
+        manual,
+        packageManager: manager,
+        rewritten: summary.rewritten,
+        root,
+        survey,
+    };
+}
+/** `adj init` as a command: the injection, framed with progress and next steps. */
+export async function runInitCommand(options, ports = {}) {
+    const report = ports.reporter ?? TERMINAL_REPORTER;
+    report.intro("Adjacent");
+    const result = await runInit(options, { ...ports, reporter: report });
+    const install = result.packageManager.install(result.installOptions);
+    const dev = result.packageManager.run("dev");
+    const steps = [
+        ...(result.installed ? [] : [`${install.command} ${install.args.join(" ")}`]),
+        `${dev.command} ${dev.args.join(" ")}`,
+        "adj dev --android",
+    ];
+    report.step(`Next steps:\n${steps.map((command) => `  ${command}`).join("\n")}`);
+    report.outro(result.manual.length === 0
+        ? `${result.survey.identity.appName} is an Adjacent app.`
+        : `${result.survey.identity.appName} needs the ${result.manual.length} edit${result.manual.length === 1 ? "" : "s"} above.`);
+    return result;
+}
+export { ADJACENT_PACKAGES };
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/keys.d.ts

@@ -0,0 +1,14 @@
+import { type DevCommand } from "./dev-channel.js";
+export type KeyAction = "clear-cache" | "help" | "interrupt" | "open" | "quit" | "reload";
+export declare function resolveKeyAction(key: string): KeyAction | undefined;
+export declare function commandForAction(action: KeyAction): DevCommand | undefined;
+export declare const KEY_HELP = "Press r to reload, c to clear caches and reload, o to reopen on the device, q to quit.";
+export interface KeyHandlers {
+    readonly onInterrupt: () => void;
+    readonly onOpen: () => Promise<void>;
+    readonly onQuit: () => void;
+    readonly onSend: (command: DevCommand) => Promise<void>;
+    readonly onShowHelp: () => void;
+}
+export declare function watchKeys(handlers: KeyHandlers): () => void;
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,MAAM,GACN,WAAW,GACX,MAAM,GACN,MAAM,GACN,QAAQ,CAAC;AAKb,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAQnE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAI1E;AAED,eAAO,MAAM,QAAQ,2FACqE,CAAC;AAE3F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,IAAI,CAsC3D"}

package/dist/keys.js

@@ -0,0 +1,66 @@
+import { DEV_COMMAND } from "./dev-channel.js";
+const END_OF_TEXT = "\u0003";
+const END_OF_TRANSMISSION = "\u0004";
+export function resolveKeyAction(key) {
+    if (key === END_OF_TEXT)
+        return "interrupt";
+    if (key === END_OF_TRANSMISSION || key === "q")
+        return "quit";
+    if (key === "r")
+        return "reload";
+    if (key === "c")
+        return "clear-cache";
+    if (key === "o")
+        return "open";
+    if (key === "?" || key === "h")
+        return "help";
+    return undefined;
+}
+export function commandForAction(action) {
+    if (action === "reload")
+        return { type: DEV_COMMAND.reload };
+    if (action === "clear-cache")
+        return { type: DEV_COMMAND.clearCache };
+    return undefined;
+}
+export const KEY_HELP = "Press r to reload, c to clear caches and reload, o to reopen on the device, q to quit.";
+export function watchKeys(handlers) {
+    const input = process.stdin;
+    if (!input.isTTY)
+        return () => undefined;
+    input.setRawMode(true);
+    input.resume();
+    input.setEncoding("utf8");
+    const onData = (key) => {
+        const action = resolveKeyAction(key);
+        if (action === undefined)
+            return;
+        if (action === "interrupt") {
+            handlers.onInterrupt();
+            return;
+        }
+        if (action === "quit") {
+            handlers.onQuit();
+            return;
+        }
+        if (action === "help") {
+            handlers.onShowHelp();
+            return;
+        }
+        if (action === "open") {
+            void handlers.onOpen();
+            return;
+        }
+        const command = commandForAction(action);
+        if (command)
+            void handlers.onSend(command);
+    };
+    input.on("data", onData);
+    return () => {
+        input.off("data", onData);
+        if (input.isTTY)
+            input.setRawMode(false);
+        input.pause();
+    };
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,kBAAkB,CAAC;AAUhE,MAAM,WAAW,GAAG,QAAQ,CAAC;AAC7B,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAErC,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,GAAG,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,GAAG,KAAK,mBAAmB,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAC9D,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,aAAa,CAAC;IACtC,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAC/B,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAC9C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;IAC7D,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;IACtE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GACnB,wFAAwF,CAAC;AAU3F,MAAM,UAAU,SAAS,CAAC,QAAqB;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAEzC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,CAAC,GAAW,EAAQ,EAAE;QACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,QAAQ,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,OAAO;YAAE,KAAK,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzB,OAAO,GAAG,EAAE;QACV,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACzC,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/package-manager.d.ts

@@ -0,0 +1,40 @@
+export type PackageManagerName = "bun" | "npm" | "pnpm" | "yarn";
+export interface Invocation {
+    readonly args: readonly string[];
+    readonly command: string;
+}
+export interface InstallOptions {
+    /**
+     * True when the project depends on Adjacent through `file:` paths. Bun's
+     * default hoisted linker copies those into `node_modules`, and Turbopack
+     * fails to resolve the copy; the isolated linker symlinks them, which is
+     * what Bun did before 1.4 and what every other manager still does.
+     */
+    readonly isolated?: boolean;
+}
+export interface PackageManager {
+    /** Runs a one-off package, the way `npx` and `bunx` do. */
+    readonly exec: (specifier: string, args: readonly string[]) => Invocation;
+    readonly install: (options?: InstallOptions) => Invocation;
+    readonly name: PackageManagerName;
+    /** The flag `create-next-app` takes to scaffold with this manager. */
+    readonly scaffoldFlag: string;
+    readonly run: (script: string, args?: readonly string[]) => Invocation;
+}
+export declare function packageManager(name: PackageManagerName): PackageManager;
+/** Reads the manager out of the `npm_config_user_agent` every manager sets. */
+export declare function parseUserAgent(userAgent: string | undefined): PackageManagerName | undefined;
+/** The manager a project is already using, judged by the lockfile it committed. */
+export declare function detectFromLockfile(projectRoot: string): Promise<PackageManagerName | undefined>;
+export interface ResolvePackageManagerOptions {
+    /** Looked at first, so an existing project keeps the manager it already uses. */
+    readonly projectRoot?: string;
+    readonly userAgent?: string;
+}
+/**
+ * Picks the manager to shell out to. A project's own lockfile wins, then
+ * whichever manager invoked this command, then bun, then npm. npm is the last
+ * resort rather than an error because it ships with Node.
+ */
+export declare function resolvePackageManager(options?: ResolvePackageManagerOptions): Promise<PackageManager>;
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../src/package-manager.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,UAAU,CAAC;IAC1E,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,KAAK,UAAU,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,KAAK,UAAU,CAAC;CACxE;AAyDD,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAEvE;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAM5F;AAED,mFAAmF;AACnF,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAMzC;AASD,MAAM,WAAW,4BAA4B;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,cAAc,CAAC,CAWzB"}

package/dist/package-manager.js

@@ -0,0 +1,98 @@
+import { stat } from "node:fs/promises";
+import { join } from "node:path";
+import { runCommand } from "./process.js";
+/** The lockfile each manager leaves behind, in the order they are checked. */
+const LOCKFILES = [
+    ["bun", "bun.lock"],
+    ["bun", "bun.lockb"],
+    ["pnpm", "pnpm-lock.yaml"],
+    ["yarn", "yarn.lock"],
+    ["npm", "package-lock.json"],
+];
+/**
+ * npm, pnpm and yarn need `--` before a script's own arguments; bun and pnpm
+ * forward them as they are. Getting this wrong sends `--port` to the manager
+ * rather than to the script, which fails in a way that reads like a bug in the
+ * script.
+ */
+const MANAGERS = {
+    bun: {
+        exec: (specifier, args) => ({ args: [specifier, ...args], command: "bunx" }),
+        install: ({ isolated = false } = {}) => ({
+            args: isolated ? ["install", "--linker=isolated"] : ["install"],
+            command: "bun",
+        }),
+        name: "bun",
+        run: (script, args = []) => ({ args: ["run", script, ...args], command: "bun" }),
+        scaffoldFlag: "--use-bun",
+    },
+    npm: {
+        exec: (specifier, args) => ({
+            args: ["--yes", specifier, ...args],
+            command: "npx",
+        }),
+        install: () => ({ args: ["install"], command: "npm" }),
+        name: "npm",
+        run: (script, args = []) => ({
+            args: ["run", script, ...(args.length > 0 ? ["--", ...args] : [])],
+            command: "npm",
+        }),
+        scaffoldFlag: "--use-npm",
+    },
+    pnpm: {
+        exec: (specifier, args) => ({ args: ["dlx", specifier, ...args], command: "pnpm" }),
+        install: () => ({ args: ["install"], command: "pnpm" }),
+        name: "pnpm",
+        run: (script, args = []) => ({ args: ["run", script, ...args], command: "pnpm" }),
+        scaffoldFlag: "--use-pnpm",
+    },
+    yarn: {
+        exec: (specifier, args) => ({ args: ["dlx", specifier, ...args], command: "yarn" }),
+        install: () => ({ args: ["install"], command: "yarn" }),
+        name: "yarn",
+        run: (script, args = []) => ({ args: [script, ...args], command: "yarn" }),
+        scaffoldFlag: "--use-yarn",
+    },
+};
+export function packageManager(name) {
+    return MANAGERS[name];
+}
+/** Reads the manager out of the `npm_config_user_agent` every manager sets. */
+export function parseUserAgent(userAgent) {
+    if (!userAgent)
+        return undefined;
+    const [first] = userAgent.split("/");
+    return first !== undefined && first in MANAGERS
+        ? first
+        : undefined;
+}
+/** The manager a project is already using, judged by the lockfile it committed. */
+export async function detectFromLockfile(projectRoot) {
+    for (const [name, lockfile] of LOCKFILES) {
+        const found = await stat(join(projectRoot, lockfile)).catch(() => undefined);
+        if (found?.isFile())
+            return name;
+    }
+    return undefined;
+}
+async function isInstalled(command) {
+    return runCommand(command, ["--version"]).then(() => true, () => false);
+}
+/**
+ * Picks the manager to shell out to. A project's own lockfile wins, then
+ * whichever manager invoked this command, then bun, then npm. npm is the last
+ * resort rather than an error because it ships with Node.
+ */
+export async function resolvePackageManager(options = {}) {
+    const { projectRoot, userAgent = process.env.npm_config_user_agent } = options;
+    const fromLockfile = projectRoot ? await detectFromLockfile(projectRoot) : undefined;
+    if (fromLockfile)
+        return MANAGERS[fromLockfile];
+    const fromAgent = parseUserAgent(userAgent);
+    if (fromAgent)
+        return MANAGERS[fromAgent];
+    if (await isInstalled("bun"))
+        return MANAGERS.bun;
+    return MANAGERS.npm;
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/package-manager.js.map

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

package/dist/process.d.ts

@@ -0,0 +1,33 @@
+import { type ChildProcess, type StdioOptions } from "node:child_process";
+export interface CommandResult {
+    readonly stderr: string;
+    readonly stdout: string;
+}
+export interface CommandOptions {
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+}
+export interface StartCommandOptions {
+    readonly cwd: string;
+    /** Makes the child a process group leader so its own children can be signalled. */
+    readonly detached?: boolean;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly stdio?: StdioOptions;
+}
+export declare function runCommand(command: string, args: readonly string[], options?: CommandOptions): Promise<CommandResult>;
+/**
+ * Runs a command with its output streamed straight to this terminal, for the
+ * long operations where watching progress is the point. `runCommand` captures
+ * output instead, which is right for commands whose result is parsed.
+ */
+export declare function runInheritedCommand(command: string, args: readonly string[], options?: CommandOptions): Promise<void>;
+export declare function startCommand(command: string, args: readonly string[], options: StartCommandOptions): ChildProcess;
+export declare function hasExited(child: ChildProcess): boolean;
+/**
+ * `bun run dev` spawns Next.js, which spawns its own workers. Signalling only
+ * the direct child leaves that subtree holding the port, so the whole process
+ * group is signalled instead.
+ */
+export declare function killProcessTree(child: ChildProcess, signal: NodeJS.Signals): void;
+export declare function terminateProcessTree(child: ChildProcess, graceMilliseconds?: number): Promise<void>;
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA6BxB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CAOd;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,CAAC,OAAO,GACrB,IAAI,CAcN;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,EACnB,iBAAiB,SAAQ,GACxB,OAAO,CAAC,IAAI,CAAC,CAiBf"}