adjacent-cli 0.1.0

package/dist/process.js

@@ -0,0 +1,95 @@
+import { spawn } from "node:child_process";
+export async function runCommand(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const stderr = [];
+        const stdout = [];
+        child.stderr.on("data", (chunk) => stderr.push(chunk));
+        child.stdout.on("data", (chunk) => stdout.push(chunk));
+        child.once("error", (error) => reject(error));
+        child.once("exit", (code) => {
+            const result = {
+                stderr: Buffer.concat(stderr).toString().trim(),
+                stdout: Buffer.concat(stdout).toString().trim(),
+            };
+            if (code === 0) {
+                resolve(result);
+            }
+            else {
+                reject(new Error(`${command} ${args.join(" ")} failed (${code ?? "signal"}): ${result.stderr || result.stdout}`));
+            }
+        });
+    });
+}
+/**
+ * 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 async function runInheritedCommand(command, args, options = {}) {
+    const exitCode = await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ["ignore", "inherit", "inherit"],
+        });
+        child.once("error", (error) => reject(error));
+        child.once("exit", (code, signal) => resolve(code ?? (signal ? 1 : 0)));
+    });
+    if (exitCode !== 0) {
+        throw new Error(`${command} ${args.join(" ")} exited with code ${exitCode}.`);
+    }
+}
+export function startCommand(command, args, options) {
+    return spawn(command, args, {
+        cwd: options.cwd,
+        detached: options.detached ?? false,
+        env: options.env,
+        stdio: options.stdio ?? "inherit",
+    });
+}
+export function hasExited(child) {
+    return child.exitCode !== null || child.signalCode !== null;
+}
+/**
+ * `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 function killProcessTree(child, signal) {
+    if (hasExited(child) || child.pid === undefined)
+        return;
+    try {
+        process.kill(-child.pid, signal);
+        return;
+    }
+    catch {
+        // Not a group leader, or the group is already gone.
+    }
+    try {
+        child.kill(signal);
+    }
+    catch {
+        // Already gone.
+    }
+}
+export async function terminateProcessTree(child, graceMilliseconds = 5_000) {
+    if (hasExited(child))
+        return;
+    const exited = new Promise((resolve) => {
+        child.once("exit", () => resolve());
+    });
+    killProcessTree(child, "SIGTERM");
+    const escalation = setTimeout(() => killProcessTree(child, "SIGKILL"), graceMilliseconds);
+    try {
+        await exited;
+    }
+    finally {
+        clearTimeout(escalation);
+    }
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAwC,MAAM,oBAAoB,CAAC;AAoBjF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,IAAuB,EACvB,UAA0B,EAAE;IAE5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG;gBACb,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;gBAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;aAChD,CAAC;YACF,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,MAAM,CACJ,IAAI,KAAK,CACP,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,QAAQ,MAAM,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAC/F,CACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,IAAuB,EACvB,UAA0B,EAAE;IAE5B,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;SACxC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,QAAQ,GAAG,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,IAAuB,EACvB,OAA4B;IAE5B,OAAO,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;QACnC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAmB;IAC3C,OAAO,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAmB,EACnB,MAAsB;IAEtB,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO;IAExD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;IACD,IAAI,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAmB,EACnB,iBAAiB,GAAG,KAAK;IAEzB,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO;IAE7B,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,EACvC,iBAAiB,CAClB,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC;IACf,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/project-name.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The name a generated project is known by, in the several forms the generated
+ * files need. Every form is derived from one validated package name so an
+ * application cannot be created with a manifest it would fail to validate.
+ */
+export interface ProjectIdentity {
+    /** Readable title used for the application name and page copy. */
+    readonly appName: string;
+    /** The npm package name, and the default destination directory. */
+    readonly packageName: string;
+    /** Bounded to the 12 characters an Adjacent short name allows. */
+    readonly shortName: string;
+    /** The Adjacent configuration slug, which owns the service worker caches. */
+    readonly slug: string;
+}
+/**
+ * Accepts the lowercase, hyphen-separated names that are simultaneously a valid
+ * npm package name, a valid Adjacent slug, and a safe single path segment.
+ */
+export declare function assertProjectName(name: string): string;
+/** "my-todo-app" becomes "My Todo App". */
+export declare function deriveAppName(packageName: string): string;
+/**
+ * A short name has to fit 12 characters. The first word is preferred over a
+ * truncated title because "My Todo App" reading as "My Todo App" is better than
+ * "My Todo App…" and far better than a manifest that fails validation.
+ */
+export declare function deriveShortName(appName: string): string;
+export declare function deriveProjectIdentity(name: string): ProjectIdentity;
+//# sourceMappingURL=project-name.d.ts.map

package/dist/project-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-name.d.ts","sourceRoot":"","sources":["../src/project-name.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAmBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoCtD;AAMD,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAUnE"}

package/dist/project-name.js

@@ -0,0 +1,73 @@
+/** Mirrors the slug contract in `adjacent-core`, which the CLI must not import. */
+const PACKAGE_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** The Adjacent configuration schema caps a short name at 12 characters. */
+const SHORT_NAME_LIMIT = 12;
+/** npm refuses these outright, so a project named for one could never install. */
+const RESERVED_NAMES = new Set(["favicon.ico", "node_modules"]);
+/** A manifest name has to be at least two characters, and so does what derives it. */
+const MIN_LENGTH = 2;
+const MAX_LENGTH = 214;
+function fail(name, reason) {
+    throw new Error(`Invalid project name "${name}": ${reason}`);
+}
+/**
+ * Accepts the lowercase, hyphen-separated names that are simultaneously a valid
+ * npm package name, a valid Adjacent slug, and a safe single path segment.
+ */
+export function assertProjectName(name) {
+    if (name.trim().length === 0) {
+        throw new Error("A project name is required, for example: adj create my-app");
+    }
+    const value = name.trim();
+    if (value.includes("/") || value.includes("\\")) {
+        fail(value, "a name cannot contain a path separator. Use --directory to choose where the project is written.");
+    }
+    if (value === "." || value === ".." || value.startsWith(".")) {
+        fail(value, "a name cannot begin with a dot.");
+    }
+    if (value.length < MIN_LENGTH) {
+        fail(value, `a name has to be at least ${MIN_LENGTH} characters, because a web app manifest rejects a shorter one.`);
+    }
+    if (value.length > MAX_LENGTH) {
+        fail(value, `a name cannot be longer than ${MAX_LENGTH} characters.`);
+    }
+    if (RESERVED_NAMES.has(value)) {
+        fail(value, "that name is reserved by npm.");
+    }
+    if (value !== value.toLowerCase()) {
+        fail(value, `a name must be lowercase. Try "${value.toLowerCase()}".`);
+    }
+    if (!PACKAGE_NAME.test(value)) {
+        fail(value, "a name must be lowercase letters and digits separated by single hyphens, for example: my-app.");
+    }
+    return value;
+}
+function toTitleCase(word) {
+    return word.charAt(0).toUpperCase() + word.slice(1);
+}
+/** "my-todo-app" becomes "My Todo App". */
+export function deriveAppName(packageName) {
+    return packageName.split("-").map(toTitleCase).join(" ");
+}
+/**
+ * A short name has to fit 12 characters. The first word is preferred over a
+ * truncated title because "My Todo App" reading as "My Todo App" is better than
+ * "My Todo App…" and far better than a manifest that fails validation.
+ */
+export function deriveShortName(appName) {
+    if (appName.length <= SHORT_NAME_LIMIT)
+        return appName;
+    const [firstWord = appName] = appName.split(" ");
+    return firstWord.slice(0, SHORT_NAME_LIMIT);
+}
+export function deriveProjectIdentity(name) {
+    const packageName = assertProjectName(name);
+    const appName = deriveAppName(packageName);
+    return {
+        appName,
+        packageName,
+        shortName: deriveShortName(appName),
+        slug: packageName,
+    };
+}
+//# sourceMappingURL=project-name.js.map

package/dist/project-name.js.map

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

package/dist/reporter.d.ts

@@ -0,0 +1,12 @@
+/** Everything a command prints, so a caller can silence or capture it. */
+export interface Reporter {
+    readonly intro: (message: string) => void;
+    readonly outro: (message: string) => void;
+    readonly step: (message: string) => void;
+    readonly success: (message: string) => void;
+    readonly task: <T>(message: string, operation: () => Promise<T>) => Promise<T>;
+}
+export declare const TERMINAL_REPORTER: Reporter;
+/** Used by tests, and by any caller that wants the result rather than the noise. */
+export declare const SILENT_REPORTER: Reporter;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF;AAED,eAAO,MAAM,iBAAiB,EAAE,QAAgD,CAAC;AAEjF,oFAAoF;AACpF,eAAO,MAAM,eAAe,EAAE,QAM7B,CAAC"}

package/dist/reporter.js

@@ -0,0 +1,11 @@
+import { intro, outro, step, success, task } from "./ui.js";
+export const TERMINAL_REPORTER = { intro, outro, step, success, task };
+/** Used by tests, and by any caller that wants the result rather than the noise. */
+export const SILENT_REPORTER = {
+    intro: () => undefined,
+    outro: () => undefined,
+    step: () => undefined,
+    success: () => undefined,
+    task: (_message, operation) => operation(),
+};
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAW5D,MAAM,CAAC,MAAM,iBAAiB,GAAa,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAEjF,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;IACtB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;IACrB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;IACxB,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE;CAC3C,CAAC"}

package/dist/rewrite.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Rewrites of files the application owns. Every rewrite recognises a shape
+ * before touching anything: an unfamiliar file is reported with the edit to
+ * make by hand rather than guessed at.
+ */
+export type RewriteOutcome = 
+/** The file already does what Adjacent needs. */
+{
+    readonly kind: "unchanged";
+} | {
+    readonly contents: string;
+    readonly kind: "rewritten";
+}
+/** The shape was not recognised, so the edit is described instead. */
+ | {
+    readonly instruction: string;
+    readonly kind: "manual";
+};
+/** Inserts an import after the last existing one, or at the top of the file. */
+export declare function addImport(source: string, statement: string): string;
+/** The config written when a project has none at all. */
+export declare function createNextConfig(): string;
+/**
+ * Wraps the default export in `withAdjacent()`. The recognised shape is
+ * `export default <identifier>` or `export default { ... }`, which covers what
+ * `create-next-app` writes and most hand-written configs.
+ */
+export declare function wrapNextConfig(source: string): RewriteOutcome;
+export interface WrapLayoutOptions {
+    /** Import specifier for `app.config`, relative to the layout. */
+    readonly configImportPath: string;
+    /**
+     * True when this layout was just generated by `create-next-app`. Any
+     * `metadata` in it is that tool's placeholder rather than the application's,
+     * so it is dropped instead of kept.
+     */
+    readonly scaffolded?: boolean;
+}
+/**
+ * Wraps the root layout. Any `metadata` the application already exports is kept
+ * and passed through `createAdjacent`, which merges it with the PWA metadata
+ * derived from `app.config.ts`, because both cannot be exported at once.
+ */
+export declare function wrapRootLayout(source: string, { configImportPath, scaffolded }: WrapLayoutOptions): RewriteOutcome;
+export interface AdjacentStyleOptions {
+    readonly tailwind: boolean;
+}
+/**
+ * Appends the tokens Adjacent components read. Marked with sentinels so a
+ * second run replaces the block rather than appending another copy, and so a
+ * token the application already defines is never overwritten.
+ */
+export declare function injectAdjacentStyles(source: string, { tailwind }: AdjacentStyleOptions): RewriteOutcome;
+//# sourceMappingURL=rewrite.d.ts.map

package/dist/rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../src/rewrite.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc;AACxB,iDAAiD;AAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE;AAC3D,sEAAsE;GACpE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAQ9D,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAanE;AAOD,yDAAyD;AACzD,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAsC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AA8BD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,EAAE,gBAAgB,EAAE,UAAkB,EAAE,EAAE,iBAAiB,GAC1D,cAAc,CAoDhB;AA6GD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GACjC,cAAc,CA8BhB"}

package/dist/rewrite.js

@@ -0,0 +1,262 @@
+const ADJACENT_NEXT = "adjacent-next";
+function hasImportFrom(source, module) {
+    return new RegExp(`from\\s+["']${module.replace("/", "\\/")}["']`).test(source);
+}
+/** Inserts an import after the last existing one, or at the top of the file. */
+export function addImport(source, statement) {
+    if (source.includes(statement))
+        return source;
+    // Deliberately not consuming the trailing newlines, so a blank line the
+    // author left after their imports survives the insertion.
+    const imports = [...source.matchAll(/^import\s[^\n]*;[ \t]*$/gm)];
+    const last = imports.at(-1);
+    if (last === undefined || last.index === undefined) {
+        return `${statement}\n${source}`;
+    }
+    const end = last.index + last[0].length;
+    return `${source.slice(0, end)}\n${statement}${source.slice(end)}`;
+}
+const NEXT_CONFIG_OPTIONS = `{
+  connectivityRecovery: true,
+  partialPrefetching: true,
+}`;
+/** The config written when a project has none at all. */
+export function createNextConfig() {
+    return `import { withAdjacent } from "${ADJACENT_NEXT}";
+
+export default withAdjacent(${NEXT_CONFIG_OPTIONS});
+`;
+}
+/**
+ * Wraps the default export in `withAdjacent()`. The recognised shape is
+ * `export default <identifier>` or `export default { ... }`, which covers what
+ * `create-next-app` writes and most hand-written configs.
+ */
+export function wrapNextConfig(source) {
+    if (source.includes("withAdjacent"))
+        return { kind: "unchanged" };
+    const identifier = /^export\s+default\s+([A-Za-z_$][\w$]*)\s*;?\s*$/m.exec(source);
+    if (identifier?.[1]) {
+        const wrapped = source.replace(identifier[0], `export default withAdjacent({\n  connectivityRecovery: true,\n  partialPrefetching: true,\n  ${identifier[1] === "nextConfig" ? "nextConfig" : `nextConfig: ${identifier[1]}`},\n});`);
+        return {
+            contents: addImport(wrapped, `import { withAdjacent } from "${ADJACENT_NEXT}";`),
+            kind: "rewritten",
+        };
+    }
+    const inline = /^export\s+default\s+(\{[\s\S]*\})\s*(?:as\s+\w+\s*)?;?\s*$/m.exec(source);
+    if (inline?.[1]) {
+        const wrapped = source.replace(inline[0], `export default withAdjacent({\n  connectivityRecovery: true,\n  partialPrefetching: true,\n  nextConfig: ${inline[1]},\n});`);
+        return {
+            contents: addImport(wrapped, `import { withAdjacent } from "${ADJACENT_NEXT}";`),
+            kind: "rewritten",
+        };
+    }
+    return {
+        instruction: `Wrap the Next.js config so Adjacent can configure development origins, headers, and package transpilation:\n\n` +
+            `  import { withAdjacent } from "${ADJACENT_NEXT}";\n\n` +
+            `  export default withAdjacent({\n` +
+            `    connectivityRecovery: true,\n` +
+            `    partialPrefetching: true,\n` +
+            `    nextConfig: yourExistingConfig,\n` +
+            `  });`,
+        kind: "manual",
+    };
+}
+const LAYOUT_INSTRUCTION = (configImportPath) => `Wrap the root layout so Adjacent can supply metadata and inject its browser runtime:\n\n` +
+    `  import { createAdjacent, withAdjacentLayout } from "${ADJACENT_NEXT}";\n` +
+    `  import config from "${configImportPath}";\n\n` +
+    `  const adjacent = createAdjacent(config);\n` +
+    `  export const { metadata, viewport } = adjacent;\n\n` +
+    `  function RootLayout({ children }) { /* your existing layout */ }\n\n` +
+    `  export default withAdjacentLayout(adjacent)(RootLayout);`;
+/**
+ * The placeholder `create-next-app` writes. Kept, it would win over everything
+ * `app.config.ts` derives, so an application scaffolded as "Photos" would call
+ * itself Create Next App in the tab, the share preview and the install prompt.
+ */
+const METADATA_TYPE_IMPORT = /^import\s+type\s*\{\s*Metadata\s*\}\s*from\s*"next";\n/m;
+const SCAFFOLDED_METADATA = /^export\s+const\s+metadata(?:\s*:\s*Metadata)?\s*=\s*\{[^{}]*\};?\n+/m;
+/** Removes the placeholder, and the type import it was the only use of. */
+function dropScaffoldedMetadata(source) {
+    const without = source.replace(SCAFFOLDED_METADATA, "");
+    if (without === source || /\bMetadata\b/.test(without.replace(METADATA_TYPE_IMPORT, ""))) {
+        return without;
+    }
+    return without.replace(METADATA_TYPE_IMPORT, "");
+}
+/**
+ * Wraps the root layout. Any `metadata` the application already exports is kept
+ * and passed through `createAdjacent`, which merges it with the PWA metadata
+ * derived from `app.config.ts`, because both cannot be exported at once.
+ */
+export function wrapRootLayout(source, { configImportPath, scaffolded = false }) {
+    if (source.includes("withAdjacentLayout"))
+        return { kind: "unchanged" };
+    const defaultExport = /^export\s+default\s+(?:async\s+)?function\s+([A-Za-z_$][\w$]*)\s*\(/m.exec(source);
+    if (!defaultExport?.[1]) {
+        return { instruction: LAYOUT_INSTRUCTION(configImportPath), kind: "manual" };
+    }
+    const layoutName = defaultExport[1];
+    // Only when we scaffolded, because then the metadata is known to be the
+    // placeholder. On a project that already exists it is the application's own.
+    let contents = scaffolded ? dropScaffoldedMetadata(source) : source;
+    // The application's own metadata becomes an input to createAdjacent rather
+    // than a second export of the same name.
+    const metadataExport = /^export\s+const\s+metadata(\s*:\s*Metadata)?\s*=/m.exec(contents);
+    const hasOwnMetadata = metadataExport !== null;
+    if (metadataExport) {
+        contents = contents.replace(metadataExport[0], `const applicationMetadata${metadataExport[1] ?? ""} =`);
+    }
+    if (/^export\s+const\s+viewport\b/m.test(contents)) {
+        return { instruction: LAYOUT_INSTRUCTION(configImportPath), kind: "manual" };
+    }
+    contents = contents.replace(defaultExport[0], defaultExport[0].replace(/^export\s+default\s+/, ""));
+    contents = addImport(contents, `import { createAdjacent, withAdjacentLayout } from "${ADJACENT_NEXT}";`);
+    if (!hasImportFrom(contents, configImportPath)) {
+        contents = addImport(contents, `import config from "${configImportPath}";`);
+    }
+    const creation = hasOwnMetadata
+        ? `const adjacent = createAdjacent(config, { metadata: applicationMetadata });`
+        : `const adjacent = createAdjacent(config);`;
+    return {
+        contents: `${contents.trimEnd()}\n\n${creation}\n\nexport const { metadata, viewport } = adjacent;\n\n` +
+            `export default withAdjacentLayout(adjacent)(${layoutName});\n`,
+        kind: "rewritten",
+    };
+}
+const STYLE_START = "/* adjacent:start */";
+const STYLE_END = "/* adjacent:end */";
+/** The design tokens Adjacent components read, beyond what Next.js ships. */
+const ADJACENT_TOKENS = `:root {
+  --primary: #171717;
+  --primary-foreground: #ffffff;
+  --secondary: #f4f4f5;
+  --secondary-foreground: #171717;
+  --accent: #f4f4f5;
+  --accent-foreground: #171717;
+  --muted: #f4f4f5;
+  --muted-foreground: #71717a;
+  --destructive: #b3261e;
+  --border: #e4e4e7;
+  --ring: #171717;
+
+  /* The navigation rail is a sidebar, and reads these from 768px up. */
+  --sidebar: #fafafa;
+  --sidebar-foreground: #171717;
+  --sidebar-accent: #e4e4e7;
+  --sidebar-accent-foreground: #171717;
+
+  --radius: 0.625rem;
+  --radius-sm: 0.375rem;
+  --radius-lg: 0.75rem;
+  --radius-full: 9999px;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --primary: #fafafa;
+    --primary-foreground: #0c0c0e;
+    --secondary: #27272a;
+    --secondary-foreground: #fafafa;
+    --accent: #27272a;
+    --accent-foreground: #fafafa;
+    --muted: #27272a;
+    --muted-foreground: #a1a1aa;
+    --destructive: #f2b8b5;
+    --border: #27272a;
+    --ring: #fafafa;
+
+    --sidebar: #17171a;
+    --sidebar-foreground: #fafafa;
+    --sidebar-accent: #27272a;
+    --sidebar-accent-foreground: #fafafa;
+  }
+}`;
+const TAILWIND_THEME = `@theme inline {
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-destructive: var(--destructive);
+  --color-border: var(--border);
+  --color-ring: var(--ring);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+}`;
+const SHELL_STYLES = `body {
+  /* Keeps iOS from rubber-banding the document out from under fixed chrome. */
+  overscroll-behavior-y: none;
+}
+
+html {
+  /*
+   * Anything scrolled to stops above the navigation rather than under it. The
+   * shell already reserves the room; this covers an anchor jump, a focused
+   * field, and scrollIntoView, which would otherwise ignore it. The same at the
+   * top, where a sticky header would otherwise cover what was scrolled to.
+   */
+  scroll-padding-block-start: var(--adj-header-inset-block-start, 0px);
+  scroll-padding-block-end: var(--adj-navigation-inset-block-end, 0px);
+}
+
+/*
+ * An installed app should not show a browser's scrollbar down its edge. Keyed
+ * on a coarse pointer rather than a narrow width, so a touch device is what
+ * this hides for and a narrow desktop window keeps the scrollbar it needs.
+ * Scrolling itself is untouched: the bar goes, the page still moves.
+ */
+@media (pointer: coarse) {
+  html {
+    /* The standard property, and the one that does the work. */
+    scrollbar-width: none;
+  }
+
+  /*
+   * For iOS Safari before 18.2 and Chrome before 121, which is a real share of
+   * phones. Delete this once the floor is above both and scrollbar-width is
+   * enough on its own.
+   */
+  html::-webkit-scrollbar,
+  body::-webkit-scrollbar {
+    display: none;
+  }
+}`;
+/**
+ * Appends the tokens Adjacent components read. Marked with sentinels so a
+ * second run replaces the block rather than appending another copy, and so a
+ * token the application already defines is never overwritten.
+ */
+export function injectAdjacentStyles(source, { tailwind }) {
+    const block = [
+        STYLE_START,
+        "/* Adjacent components read these tokens. Edit them to restyle the app. */",
+        ADJACENT_TOKENS,
+        ...(tailwind ? [TAILWIND_THEME] : []),
+        SHELL_STYLES,
+        STYLE_END,
+    ].join("\n\n");
+    const start = source.indexOf(STYLE_START);
+    if (start !== -1) {
+        const end = source.indexOf(STYLE_END);
+        if (end === -1) {
+            return {
+                instruction: `The Adjacent block in this stylesheet has a ${STYLE_START} marker but no ` +
+                    `${STYLE_END} marker, so it cannot be replaced safely. Close the block, or ` +
+                    `delete both markers and run this again.`,
+                kind: "manual",
+            };
+        }
+        const replaced = source.slice(0, start) + block + source.slice(end + STYLE_END.length);
+        return replaced === source
+            ? { kind: "unchanged" }
+            : { contents: replaced, kind: "rewritten" };
+    }
+    return { contents: `${source.trimEnd()}\n\n${block}\n`, kind: "rewritten" };
+}
+//# sourceMappingURL=rewrite.js.map

package/dist/rewrite.js.map

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

package/dist/shutdown.d.ts

@@ -0,0 +1,24 @@
+export declare const FORCE_EXIT_MILLISECONDS = 5000;
+export interface ShutdownOptions {
+    readonly exit: (code: number) => void;
+    readonly forceMilliseconds?: number;
+    /** Synchronous last-resort kills for anything `release` would have stopped. */
+    readonly kill: () => void;
+    readonly notify?: (message: string) => void;
+    readonly release: () => Promise<void>;
+    /** Restores the terminal. Must be synchronous and repeatable. */
+    readonly restore: () => void;
+}
+export interface Shutdown {
+    readonly listen: () => () => void;
+    readonly release: () => Promise<void>;
+    readonly request: (code?: number) => void;
+}
+/**
+ * A Clack spinner registers a SIGINT listener that only draws a cancel message,
+ * which also suppresses Node's default terminate-on-SIGINT. Quitting therefore
+ * has to exit explicitly, survive a teardown step that never settles, and stay
+ * interruptible so a second interrupt is not silently ignored.
+ */
+export declare function createShutdown(options: ShutdownOptions): Shutdown;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAe7C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAoEjE"}