adjacent-cli 0.1.0

package/dist/dev.js

@@ -0,0 +1,12 @@
+import { resolve } from "node:path";
+import { sendDevCommand } from "./dev-channel.js";
+import { step, success } from "./ui.js";
+export async function runDevCommand(projectRoot, command) {
+    const clients = await sendDevCommand(resolve(projectRoot), command);
+    if (clients === 0) {
+        step("No open app is connected. Open the app on the device and try again.");
+        return;
+    }
+    success(`Sent ${command.type} to ${clients} connected app${clients === 1 ? "" : "s"}.`);
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,OAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,qEAAqE,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IACD,OAAO,CAAC,QAAQ,OAAO,CAAC,IAAI,OAAO,OAAO,iBAAiB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AAC1F,CAAC"}

package/dist/doctor.d.ts

@@ -0,0 +1,46 @@
+import { type ProjectSurvey } from "./survey.js";
+/**
+ * What every check is given. Read once here rather than by each check, so a
+ * dozen checks do not each stat the same files.
+ */
+export interface CheckContext {
+    readonly projectRoot: string;
+    readonly read: (relativePath: string) => Promise<string | undefined>;
+    readonly survey: ProjectSurvey;
+    /** Only present when a deployed URL was passed, which few checks want. */
+    readonly url?: string;
+}
+export interface CheckResult {
+    /** What to do about it. Printed under the issues, once. */
+    readonly advice?: string;
+    readonly issues: readonly string[];
+    readonly ok: boolean;
+}
+export interface DoctorCheck {
+    /** Shown as the check runs, so a slow one says what it is waiting on. */
+    readonly description: string;
+    readonly run: (context: CheckContext) => Promise<CheckResult>;
+}
+export declare const passed: CheckResult;
+export declare function failed(issues: readonly string[], advice?: string): CheckResult;
+export interface DoctorReport {
+    readonly failures: number;
+    readonly ran: number;
+}
+export interface RunChecksOptions {
+    readonly checks: readonly DoctorCheck[];
+    readonly projectRoot: string;
+    readonly url?: string;
+}
+/** Runs every check against one project and reports what failed. */
+export declare function runChecks({ checks, projectRoot, url, }: RunChecksOptions): Promise<DoctorReport>;
+export interface DoctorOptions {
+    /** Checks contributed by the development client, when it is installed. */
+    readonly androidChecks?: readonly DoctorCheck[];
+    readonly checks: readonly DoctorCheck[];
+    readonly projectRoot: string;
+    /** Public URL to check against the Trusted Web Activity quality criteria. */
+    readonly url?: string;
+}
+export declare function runDoctor({ androidChecks, checks, projectRoot, url, }: DoctorOptions): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/D;AAED,eAAO,MAAM,MAAM,EAAE,WAAsC,CAAC;AAE5D,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAE9E;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,oEAAoE;AACpE,wBAAsB,SAAS,CAAC,EAC9B,MAAM,EACN,WAAW,EACX,GAAG,GACJ,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6B1C;AAED,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,SAAS,CAAC,EAC9B,aAAkB,EAClB,MAAM,EACN,WAAW,EACX,GAAG,GACJ,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwBvC"}

package/dist/doctor.js

@@ -0,0 +1,52 @@
+import { readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { surveyProject } from "./survey.js";
+import { intro, outro, step, success } from "./ui.js";
+export const passed = { issues: [], ok: true };
+export function failed(issues, advice) {
+    return { ...(advice === undefined ? null : { advice }), issues, ok: false };
+}
+/** Runs every check against one project and reports what failed. */
+export async function runChecks({ checks, projectRoot, url, }) {
+    const root = resolve(projectRoot);
+    const survey = await surveyProject(root);
+    const context = {
+        projectRoot: root,
+        read: (relativePath) => readFile(join(root, relativePath), "utf8").catch(() => undefined),
+        survey,
+        ...(url === undefined ? null : { url }),
+    };
+    let failures = 0;
+    for (const check of checks) {
+        const result = await check.run(context);
+        if (result.ok) {
+            success(check.description);
+            continue;
+        }
+        failures += 1;
+        step([
+            check.description,
+            ...result.issues.map((issue) => `  - ${issue}`),
+            ...(result.advice === undefined ? [] : ["", `  ${result.advice}`]),
+        ].join("\n"));
+    }
+    return { failures, ran: checks.length };
+}
+export async function runDoctor({ androidChecks = [], checks, projectRoot, url, }) {
+    intro("Adjacent doctor");
+    const report = await runChecks({
+        checks: [...checks, ...androidChecks],
+        projectRoot,
+        ...(url === undefined ? null : { url }),
+    });
+    if (androidChecks.length === 0) {
+        step("Android was not checked. Install adjacent-dev-client to include the " +
+            "toolchain a device needs.");
+    }
+    if (report.failures === 0) {
+        outro(`${report.ran} checks passed.`);
+        return report;
+    }
+    throw new Error(`${report.failures} of ${report.ran} checks failed. Each one above says what to do.`);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/edits.d.ts

@@ -0,0 +1,26 @@
+export interface EditSummary {
+    /** Paths this run created, relative to the project root. */
+    readonly added: readonly string[];
+    /** Paths this run changed in place, relative to the project root. */
+    readonly rewritten: readonly string[];
+    /** Paths that already held what Adjacent needed. */
+    readonly skipped: readonly string[];
+}
+/**
+ * Applies changes to a project that may already contain the user's own work.
+ * Everything created and everything overwritten is recorded, so a failure part
+ * way through restores the project rather than leaving it half converted.
+ */
+export interface ProjectEdits {
+    /** Writes a file only when it is absent. Returns false when one was there. */
+    readonly addFile: (relativePath: string, contents: Buffer | string) => Promise<boolean>;
+    readonly readFile: (relativePath: string) => Promise<string | undefined>;
+    readonly removeFile: (relativePath: string) => Promise<void>;
+    /** Overwrites an existing file, keeping the original for a rollback. */
+    readonly rewriteFile: (relativePath: string, contents: string) => Promise<void>;
+    readonly rollback: () => Promise<void>;
+    readonly root: string;
+    readonly summary: () => EditSummary;
+}
+export declare function createProjectEdits(root: string): ProjectEdits;
+//# sourceMappingURL=edits.d.ts.map

package/dist/edits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edits.d.ts","sourceRoot":"","sources":["../src/edits.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,CAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GAAG,MAAM,KACtB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzE,QAAQ,CAAC,UAAU,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,WAAW,CAAC;CACrC;AAsBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAgG7D"}

package/dist/edits.js

@@ -0,0 +1,101 @@
+import { mkdir, readFile, rmdir, stat, unlink, writeFile } from "node:fs/promises";
+import { dirname, relative, resolve, sep } from "node:path";
+async function exists(path) {
+    return stat(path).then(() => true, () => false);
+}
+/** Every write and every removal is checked to be inside the project. */
+function assertInsideProject(root, path) {
+    const relation = relative(root, path);
+    if (relation === "" || relation.startsWith("..") || relation.startsWith(sep)) {
+        throw new Error(`Refusing to touch a path outside the project: ${path}`);
+    }
+}
+export function createProjectEdits(root) {
+    const projectRoot = resolve(root);
+    const added = [];
+    const rewritten = [];
+    const skipped = [];
+    const createdDirectories = [];
+    const restores = [];
+    async function ensureDirectory(path) {
+        if (await exists(path))
+            return;
+        if (!path.startsWith(projectRoot))
+            return;
+        await ensureDirectory(dirname(path));
+        if (await exists(path))
+            return;
+        await mkdir(path);
+        createdDirectories.push(path);
+    }
+    function target(relativePath) {
+        const path = resolve(projectRoot, relativePath);
+        assertInsideProject(projectRoot, path);
+        return path;
+    }
+    return {
+        root: projectRoot,
+        async addFile(relativePath, contents) {
+            const path = target(relativePath);
+            if (await exists(path)) {
+                skipped.push(relativePath);
+                return false;
+            }
+            await ensureDirectory(dirname(path));
+            await writeFile(path, contents);
+            restores.push({ contents: undefined, path });
+            added.push(relativePath);
+            return true;
+        },
+        readFile: (relativePath) => readFile(target(relativePath), "utf8").catch(() => undefined),
+        async removeFile(relativePath) {
+            const path = target(relativePath);
+            const original = await readFile(path).catch(() => undefined);
+            if (original === undefined)
+                return;
+            restores.push({ contents: original, path });
+            await unlink(path);
+        },
+        async rewriteFile(relativePath, contents) {
+            const path = target(relativePath);
+            const original = await readFile(path).catch(() => undefined);
+            await ensureDirectory(dirname(path));
+            await writeFile(path, contents);
+            if (original === undefined) {
+                restores.push({ contents: undefined, path });
+                added.push(relativePath);
+            }
+            else {
+                restores.push({ contents: original, path });
+                rewritten.push(relativePath);
+            }
+        },
+        async rollback() {
+            // Reverse order, so a file created inside a created directory is gone
+            // before the directory it lives in is removed.
+            for (const restore of [...restores].reverse()) {
+                assertInsideProject(projectRoot, restore.path);
+                if (restore.contents === undefined) {
+                    await unlink(restore.path).catch(() => undefined);
+                }
+                else {
+                    await writeFile(restore.path, restore.contents).catch(() => undefined);
+                }
+            }
+            for (const directory of [...createdDirectories].reverse()) {
+                assertInsideProject(projectRoot, directory);
+                await rmdir(directory).catch(() => undefined);
+            }
+            restores.length = 0;
+            createdDirectories.length = 0;
+            added.length = 0;
+            rewritten.length = 0;
+        },
+        summary: () => ({
+            added: [...added],
+            rewritten: [...rewritten],
+            skipped: [...skipped],
+        }),
+    };
+}
+//# sourceMappingURL=edits.js.map

package/dist/edits.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { resolveAndroidDevOptions, resolveAndroidInstallOptions, resolveCreateOptions, resolveDevCommandProject, resolveInitOptions, resolveNavigatePath, type AndroidCliOptions, type AndroidDevOptions, type AndroidInstallOptions, type CreateCliOptions, type CreateOptionsInput, type InitCliOptions, type InitOptionsInput, } from "./arguments.js";
+export { runCreate, type CreateOptions, type CreatePorts, type CreateResult, } from "./create.js";
+export { runInit, runInitCommand, type InitOptions, type InitPorts, type InitResult, } from "./init.js";
+export { runDevCommand } from "./dev.js";
+export { PROJECT_CHECKS } from "./checks.js";
+export { failed, passed, runChecks, runDoctor, type CheckContext, type CheckResult, type DoctorCheck, type DoctorOptions, type DoctorReport, } from "./doctor.js";
+export { clearDevChannelState, DEV_COMMAND, readDevChannelState, sendDevCommand, startDevChannel, writeDevChannelState, type DevChannel, type DevChannelState, type DevCommand, } from "./dev-channel.js";
+export { KEY_HELP, watchKeys, type KeyHandlers } from "./keys.js";
+export { resolvePackageManager, type PackageManager, } from "./package-manager.js";
+export { killProcessTree, runCommand, runInheritedCommand, startCommand, terminateProcessTree, type CommandOptions, type CommandResult, } from "./process.js";
+export { createShutdown, type Shutdown, type ShutdownOptions } from "./shutdown.js";
+export { intro, outro, selectItem, step, success, task } from "./ui.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,OAAO,EACP,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,MAAM,EACN,MAAM,EACN,SAAS,EACT,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+export { resolveAndroidDevOptions, resolveAndroidInstallOptions, resolveCreateOptions, resolveDevCommandProject, resolveInitOptions, resolveNavigatePath, } from "./arguments.js";
+export { runCreate, } from "./create.js";
+export { runInit, runInitCommand, } from "./init.js";
+export { runDevCommand } from "./dev.js";
+export { PROJECT_CHECKS } from "./checks.js";
+export { failed, passed, runChecks, runDoctor, } from "./doctor.js";
+/*
+ * The development harness. A device is reached through a package that is not
+ * installed unless someone wants one, so these are exported rather than kept
+ * private: `adjacent-dev-client` is built on them.
+ */
+export { clearDevChannelState, DEV_COMMAND, readDevChannelState, sendDevCommand, startDevChannel, writeDevChannelState, } from "./dev-channel.js";
+export { KEY_HELP, watchKeys } from "./keys.js";
+export { resolvePackageManager, } from "./package-manager.js";
+export { killProcessTree, runCommand, runInheritedCommand, startCommand, terminateProcessTree, } from "./process.js";
+export { createShutdown } from "./shutdown.js";
+export { intro, outro, selectItem, step, success, task } from "./ui.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,GAQpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,GAIV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,OAAO,EACP,cAAc,GAIf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,MAAM,EACN,MAAM,EACN,SAAS,EACT,SAAS,GAMV,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,oBAAoB,GAIrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAoB,MAAM,WAAW,CAAC;AAClE,OAAO,EACL,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GAGrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAuC,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,62 @@
+import { ADJACENT_PACKAGES, type AdjacentDependencies } from "./dependencies.js";
+import { type InstallOptions, type PackageManager } from "./package-manager.js";
+import { type Reporter } from "./reporter.js";
+import { type ProjectSurvey } from "./survey.js";
+export interface InitOptions {
+    readonly install: boolean;
+    readonly projectRoot: string;
+    /** Adds the starter route group. Only `adj create` asks for this. */
+    readonly scaffold?: boolean;
+}
+export interface InitPorts {
+    readonly dependencies?: AdjacentDependencies;
+    readonly install?: (root: string, options?: InstallOptions) => Promise<void>;
+    readonly reporter?: Reporter;
+    readonly templatesRoot?: string;
+}
+/** An edit Adjacent would not make on its own, described for the author. */
+export interface ManualStep {
+    readonly file: string;
+    readonly instruction: string;
+}
+export interface InitResult {
+    readonly added: readonly string[];
+    readonly installed: boolean;
+    /** What this project installs with, so a caller can name it in its own output. */
+    readonly packageManager: PackageManager;
+    /** How to install: `file:`-linked projects need Bun's isolated linker. */
+    readonly installOptions: InstallOptions;
+    readonly manual: readonly ManualStep[];
+    readonly rewritten: readonly string[];
+    readonly root: string;
+    readonly survey: ProjectSurvey;
+}
+export declare function defaultTemplatesRoot(from?: string): string;
+/**
+ * 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 declare function findWorkspacePackagesRoot(from?: string): Promise<string | undefined>;
+/**
+ * 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 declare function isWorkspaceMember(workspaceRoot: string, projectRoot: string): Promise<boolean>;
+/**
+ * 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 declare function addAdjacentDependencies(manifest: Record<string, unknown>, dependencies: AdjacentDependencies): Record<string, unknown>;
+/**
+ * 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 declare function runInit(options: InitOptions, ports?: InitPorts): Promise<InitResult>;
+/** `adj init` as a command: the injection, framed with progress and next steps. */
+export declare function runInitCommand(options: InitOptions, ports?: InitPorts): Promise<InitResult>;
+export { ADJACENT_PACKAGES };
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,iBAAiB,EAGjB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AASjE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAMD,wBAAgB,oBAAoB,CAAC,IAAI,SAAoB,GAAG,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,SAAoB,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB7B;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,YAAY,EAAE,oBAAoB,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCzB;AAwCD;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,KAAK,GAAE,SAAc,GACpB,OAAO,CAAC,UAAU,CAAC,CA8JrB;AAED,mFAAmF;AACnF,wBAAsB,cAAc,CAClC,OAAO,EAAE,WAAW,EACpB,KAAK,GAAE,SAAc,GACpB,OAAO,CAAC,UAAU,CAAC,CAqBrB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}