adjacent-cli 0.1.0

package/dist/shutdown.js

@@ -0,0 +1,67 @@
+export const FORCE_EXIT_MILLISECONDS = 5_000;
+const SHUTDOWN_SIGNALS = [
+    "SIGHUP",
+    "SIGINT",
+    "SIGTERM",
+];
+/** Bun types `process.removeListener` too narrowly to pass a signal name. */
+const lifecycle = process;
+/**
+ * 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 function createShutdown(options) {
+    const { exit, forceMilliseconds = FORCE_EXIT_MILLISECONDS, kill, notify, release: releaseResources, restore, } = options;
+    let releasing = false;
+    let forced = false;
+    const force = (code) => {
+        if (forced)
+            return;
+        forced = true;
+        restore();
+        kill();
+        exit(code);
+    };
+    const release = async () => {
+        if (releasing)
+            return;
+        releasing = true;
+        restore();
+        await releaseResources();
+    };
+    const request = (code = 130) => {
+        if (releasing) {
+            force(code);
+            return;
+        }
+        notify?.("Stopping. Press Ctrl-C again to force.");
+        const deadline = setTimeout(() => force(code), forceMilliseconds);
+        void release().then(() => {
+            clearTimeout(deadline);
+            if (forced)
+                return;
+            forced = true;
+            kill();
+            exit(code);
+        }, () => {
+            clearTimeout(deadline);
+            force(1);
+        });
+    };
+    const listen = () => {
+        const onSignal = () => request(130);
+        const onExit = () => restore();
+        SHUTDOWN_SIGNALS.forEach((signal) => lifecycle.on(signal, onSignal));
+        lifecycle.once("exit", onExit);
+        return () => {
+            SHUTDOWN_SIGNALS.forEach((signal) => {
+                lifecycle.removeListener(signal, onSignal);
+            });
+            lifecycle.removeListener("exit", onExit);
+        };
+    };
+    return { listen, release, request };
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,MAAM,gBAAgB,GAA8B;IAClD,QAAQ;IACR,QAAQ;IACR,SAAS;CACV,CAAC;AAEF,6EAA6E;AAC7E,MAAM,SAAS,GAAG,OAIjB,CAAC;AAmBF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,MAAM,EACJ,IAAI,EACJ,iBAAiB,GAAG,uBAAuB,EAC3C,IAAI,EACJ,MAAM,EACN,OAAO,EAAE,gBAAgB,EACzB,OAAO,GACR,GAAG,OAAO,CAAC;IAEZ,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAQ,EAAE;QACnC,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,CAAC;QACP,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,IAAI,SAAS;YAAE,OAAO;QACtB,SAAS,GAAG,IAAI,CAAC;QACjB,OAAO,EAAE,CAAC;QACV,MAAM,gBAAgB,EAAE,CAAC;IAC3B,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,IAAI,GAAG,GAAG,EAAQ,EAAE;QACnC,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,EAAE,CAAC,wCAAwC,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAElE,KAAK,OAAO,EAAE,CAAC,IAAI,CACjB,GAAG,EAAE;YACH,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,EAAE,CAAC;YACP,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,CAAC,EACD,GAAG,EAAE;YACH,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,KAAK,CAAC,CAAC,CAAC,CAAC;QACX,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,GAAiB,EAAE;QAChC,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,GAAS,EAAE,CAAC,OAAO,EAAE,CAAC;QAErC,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrE,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE/B,OAAO,GAAG,EAAE;YACV,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAClC,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC"}

package/dist/survey.d.ts

@@ -0,0 +1,33 @@
+import { type ProjectIdentity } from "./project-name.js";
+/** What Adjacent needs to know about an application before injecting anything. */
+export interface ProjectSurvey {
+    /** Relative to the root: `app` or `src/app`. */
+    readonly appDirectory: string;
+    /** Relative path of the stylesheet the root layout imports, when there is one. */
+    readonly globalsCss?: string;
+    /** True once `app.config.ts` exists, which makes a second run a no-op. */
+    readonly hasAdjacentConfig: boolean;
+    readonly hasTailwind: boolean;
+    readonly identity: ProjectIdentity;
+    /** Relative path of the root layout. */
+    readonly layoutFile: string;
+    /** Relative path of the Next.js config, when the project has one. */
+    readonly nextConfigFile?: string;
+    readonly packageJson: Record<string, unknown>;
+    readonly root: string;
+    readonly typescript: boolean;
+}
+/**
+ * A project name has to survive being turned into an Adjacent slug. An existing
+ * application may be called anything at all, including a scoped name, so the
+ * unusable parts are dropped rather than refusing to work on the project.
+ */
+export declare function toProjectName(packageName: unknown, fallback: string): string;
+export declare class NotANextApplicationError extends Error {
+}
+/**
+ * Reads the shape of an existing Next.js application. Everything Adjacent later
+ * writes or rewrites is decided from this, so detection stays in one place.
+ */
+export declare function surveyProject(root: string): Promise<ProjectSurvey>;
+//# sourceMappingURL=survey.d.ts.map

package/dist/survey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey.d.ts","sourceRoot":"","sources":["../src/survey.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEhF,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAwCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU5E;AAED,qBAAa,wBAAyB,SAAQ,KAAK;CAAG;AAEtD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA6DxE"}

package/dist/survey.js

@@ -0,0 +1,94 @@
+import { readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { deriveProjectIdentity } from "./project-name.js";
+const APP_DIRECTORIES = ["app", join("src", "app")];
+const LAYOUT_NAMES = ["layout.tsx", "layout.jsx", "layout.ts", "layout.js"];
+const NEXT_CONFIG_NAMES = [
+    "next.config.ts",
+    "next.config.mjs",
+    "next.config.js",
+    "next.config.mts",
+];
+const STYLESHEET_NAMES = ["globals.css", "global.css", "index.css"];
+async function exists(path) {
+    return stat(path).then(() => true, () => false);
+}
+async function firstExisting(root, candidates) {
+    for (const candidate of candidates) {
+        if (await exists(join(root, candidate)))
+            return candidate;
+    }
+    return undefined;
+}
+function readDependencyNames(manifest) {
+    const names = new Set();
+    for (const field of ["dependencies", "devDependencies"]) {
+        const section = manifest[field];
+        if (typeof section === "object" && section !== null) {
+            Object.keys(section).forEach((name) => names.add(name));
+        }
+    }
+    return names;
+}
+/**
+ * A project name has to survive being turned into an Adjacent slug. An existing
+ * application may be called anything at all, including a scoped name, so the
+ * unusable parts are dropped rather than refusing to work on the project.
+ */
+export function toProjectName(packageName, fallback) {
+    const raw = typeof packageName === "string" ? packageName : "";
+    const withoutScope = raw.includes("/") ? (raw.split("/").pop() ?? "") : raw;
+    const cleaned = withoutScope
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-");
+    return cleaned.length > 0 ? cleaned : fallback;
+}
+export class NotANextApplicationError extends Error {
+}
+/**
+ * Reads the shape of an existing Next.js application. Everything Adjacent later
+ * writes or rewrites is decided from this, so detection stays in one place.
+ */
+export async function surveyProject(root) {
+    const manifestPath = join(root, "package.json");
+    const rawManifest = await readFile(manifestPath, "utf8").catch(() => undefined);
+    if (rawManifest === undefined) {
+        throw new NotANextApplicationError(`No package.json found in ${root}. Run this inside a Next.js application, or create one with: adj create my-app`);
+    }
+    let packageJson;
+    try {
+        packageJson = JSON.parse(rawManifest);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new NotANextApplicationError(`Could not read ${manifestPath}: ${detail}`);
+    }
+    const dependencies = readDependencyNames(packageJson);
+    if (!dependencies.has("next")) {
+        throw new NotANextApplicationError(`${root} does not depend on Next.js. Adjacent adds to a Next.js application; create one with: adj create my-app`);
+    }
+    const appDirectory = await firstExisting(root, APP_DIRECTORIES);
+    if (appDirectory === undefined) {
+        throw new NotANextApplicationError(`No App Router directory found in ${root}. Adjacent needs an app/ or src/app/ directory; the Pages Router is not supported.`);
+    }
+    const layoutFile = await firstExisting(root, LAYOUT_NAMES.map((name) => join(appDirectory, name)));
+    if (layoutFile === undefined) {
+        throw new NotANextApplicationError(`No root layout found in ${join(root, appDirectory)}. Adjacent wraps the root layout, so one has to exist.`);
+    }
+    const globalsCss = await firstExisting(root, STYLESHEET_NAMES.map((name) => join(appDirectory, name)));
+    return {
+        appDirectory,
+        ...(globalsCss === undefined ? null : { globalsCss }),
+        hasAdjacentConfig: await exists(join(root, "app.config.ts")),
+        hasTailwind: dependencies.has("tailwindcss") || dependencies.has("@tailwindcss/postcss"),
+        identity: deriveProjectIdentity(toProjectName(packageJson.name, "adjacent-app")),
+        layoutFile,
+        ...(await firstExisting(root, NEXT_CONFIG_NAMES).then((file) => file === undefined ? null : { nextConfigFile: file })),
+        packageJson,
+        root,
+        typescript: layoutFile.endsWith(".tsx") || layoutFile.endsWith(".ts"),
+    };
+}
+//# sourceMappingURL=survey.js.map

package/dist/survey.js.map

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

package/dist/template.d.ts

@@ -0,0 +1,29 @@
+/** Values substituted into template files. */
+export type TemplateValues = Readonly<Record<string, string>>;
+export declare function isTextTemplate(path: string): boolean;
+export declare function applyTemplateName(name: string): string;
+/**
+ * Substitutes `{{placeholder}}` values. An unknown placeholder is an authoring
+ * mistake in the bundled template, so it fails loudly rather than shipping a
+ * project with `{{appName}}` rendered into its manifest.
+ */
+export declare function renderTemplate(source: string, values: TemplateValues): string;
+export interface TemplateEntry {
+    /** Path relative to the template root, using forward slashes. */
+    readonly path: string;
+}
+/** Lists a template directory depth first. */
+export declare function collectTemplateEntries(templateRoot: string, base?: string): Promise<readonly TemplateEntry[]>;
+export declare function toDestinationPath(templateRelativePath: string): string;
+/** Receives each rendered file. Returning false means one was already there. */
+export type TemplateSink = (destinationPath: string, contents: Buffer | string) => Promise<boolean>;
+export interface RenderTemplateTreeOptions {
+    /** Rewrites a destination path, for a project that keeps sources under `src/`. */
+    readonly relocate?: (destinationPath: string) => string;
+    readonly sink: TemplateSink;
+    readonly templateRoot: string;
+    readonly values: TemplateValues;
+}
+/** Renders a bundled template tree through the sink: text rendered, binary copied. */
+export declare function renderTemplateTree({ relocate, sink, templateRoot, values, }: RenderTemplateTreeOptions): Promise<readonly string[]>;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAGA,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAqB9D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAQ7E;AAED,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,8CAA8C;AAC9C,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,IAAI,SAAK,GACR,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAgBnC;AAED,wBAAgB,iBAAiB,CAAC,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,CACzB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GAAG,MAAM,KACtB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,MAAM,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,sFAAsF;AACtF,wBAAsB,kBAAkB,CAAC,EACvC,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,MAAM,GACP,EAAE,yBAAyB,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAiBxD"}

package/dist/template.js

@@ -0,0 +1,77 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Only these are rendered. Everything else is copied byte for byte, so an icon
+ * is never corrupted by being decoded as text.
+ */
+const TEXT_EXTENSIONS = new Set([".css", ".json", ".md", ".svg", ".ts", ".tsx"]);
+/**
+ * A leading dot would make the template's own ignore file apply to this
+ * repository, so it is stored without one and restored on the way out.
+ */
+const FILENAME_OVERRIDES = {
+    _gitignore: ".gitignore",
+};
+const PLACEHOLDER = /\{\{\s*([a-zA-Z][a-zA-Z0-9]*)\s*\}\}/g;
+/** Platform noise that never belongs in a generated project. */
+const IGNORED_ENTRIES = new Set([".DS_Store"]);
+export function isTextTemplate(path) {
+    const dot = path.lastIndexOf(".");
+    return dot === -1 ? false : TEXT_EXTENSIONS.has(path.slice(dot));
+}
+export function applyTemplateName(name) {
+    return FILENAME_OVERRIDES[name] ?? name;
+}
+/**
+ * Substitutes `{{placeholder}}` values. An unknown placeholder is an authoring
+ * mistake in the bundled template, so it fails loudly rather than shipping a
+ * project with `{{appName}}` rendered into its manifest.
+ */
+export function renderTemplate(source, values) {
+    return source.replace(PLACEHOLDER, (_match, key) => {
+        const value = values[key];
+        if (value === undefined) {
+            throw new Error(`The bundled template referenced an unknown value: {{${key}}}`);
+        }
+        return value;
+    });
+}
+/** Lists a template directory depth first. */
+export async function collectTemplateEntries(templateRoot, base = "") {
+    const entries = await readdir(join(templateRoot, base), { withFileTypes: true });
+    const collected = [];
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (IGNORED_ENTRIES.has(entry.name))
+            continue;
+        const sourcePath = base === "" ? entry.name : `${base}/${entry.name}`;
+        if (entry.isDirectory()) {
+            collected.push(...(await collectTemplateEntries(templateRoot, sourcePath)));
+            continue;
+        }
+        collected.push({ path: sourcePath });
+    }
+    return collected;
+}
+export function toDestinationPath(templateRelativePath) {
+    return templateRelativePath
+        .split("/")
+        .map((segment) => applyTemplateName(segment))
+        .join("/");
+}
+/** Renders a bundled template tree through the sink: text rendered, binary copied. */
+export async function renderTemplateTree({ relocate, sink, templateRoot, values, }) {
+    const entries = await collectTemplateEntries(templateRoot);
+    const written = [];
+    for (const entry of entries) {
+        const source = join(templateRoot, ...entry.path.split("/"));
+        const mapped = toDestinationPath(entry.path);
+        const destinationPath = relocate ? relocate(mapped) : mapped;
+        const contents = isTextTemplate(entry.path)
+            ? renderTemplate(await readFile(source, "utf8"), values)
+            : await readFile(source);
+        if (await sink(destinationPath, contents))
+            written.push(destinationPath);
+    }
+    return written;
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

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

package/dist/ui.d.ts

@@ -0,0 +1,14 @@
+export declare function intro(message: string): void;
+export declare function step(message: string): void;
+export declare function success(message: string): void;
+export declare function outro(message: string): void;
+export declare function selectItem<T>(options: {
+    readonly message: string;
+    readonly items: readonly {
+        readonly hint?: string;
+        readonly label: string;
+        readonly value: T;
+    }[];
+}): Promise<T>;
+export declare function task<T>(message: string, operation: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAEA,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG3C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG3C;AAED,wBAAsB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS;QACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;KACnB,EAAE,CAAC;CACL,GAAG,OAAO,CAAC,CAAC,CAAC,CAYb;AAED,wBAAsB,IAAI,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/ui.js

@@ -0,0 +1,50 @@
+import * as prompts from "@clack/prompts";
+export function intro(message) {
+    if (process.stdout.isTTY)
+        prompts.intro(message);
+    else
+        console.log(message);
+}
+export function step(message) {
+    prompts.log.step(message);
+}
+export function success(message) {
+    prompts.log.success(message);
+}
+export function outro(message) {
+    if (process.stdout.isTTY)
+        prompts.outro(message);
+    else
+        console.log(message);
+}
+export async function selectItem(options) {
+    const selected = await prompts.select({
+        message: options.message,
+        options: options.items.map((item, index) => item.hint
+            ? { hint: item.hint, label: item.label, value: index }
+            : { label: item.label, value: index }),
+    });
+    if (prompts.isCancel(selected)) {
+        prompts.cancel("Operation cancelled.");
+        throw new Error("Operation cancelled.");
+    }
+    return options.items[selected].value;
+}
+export async function task(message, operation) {
+    if (!process.stdout.isTTY) {
+        step(message);
+        return operation();
+    }
+    const progress = prompts.spinner();
+    progress.start(message);
+    try {
+        const result = await operation();
+        progress.stop(message);
+        return result;
+    }
+    catch (error) {
+        progress.stop(`Failed: ${message}`);
+        throw error;
+    }
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;;QAC5C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;;QAC5C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAI,OAOnC;IACC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAS;QAC5C,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI;YACnD,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;YACtD,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;KACzC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,KAAK,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAe,EACf,SAA2B;IAE3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,CAAC;QACd,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QACpC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "adjacent-cli",
+  "version": "0.1.0",
+  "description": "The adj command: create and convert Adjacent apps, and run them on Android over a trusted tunnel.",
+  "keywords": [
+    "cli",
+    "pwa",
+    "android",
+    "twa",
+    "adjacent"
+  ],
+  "license": "MIT",
+  "author": "Eric Kweyunga",
+  "homepage": "https://github.com/erickweyunga/adjacent-framework/blob/main/docs/cli.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/erickweyunga/adjacent-framework.git",
+    "directory": "packages/adjacent-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/erickweyunga/adjacent-framework/issues"
+  },
+  "type": "module",
+  "bin": {
+    "adj": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "cac": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.13",
+    "@types/node": "^20",
+    "typescript": "^5"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/templates/adjacent/app/manifest.ts

@@ -0,0 +1,5 @@
+import { createAdjacentManifest } from "adjacent-next";
+
+import config from "{{configFromApp}}";
+
+export default createAdjacentManifest(config);

package/templates/adjacent/app/sw.js/route.ts

@@ -0,0 +1,5 @@
+import { createAdjacentServiceWorker } from "adjacent-next";
+
+import config from "{{configFromRoute}}";
+
+export const { GET } = createAdjacentServiceWorker(config);

package/templates/adjacent/app.config.ts

@@ -0,0 +1,21 @@
+import { defineConfig } from "adjacent-core";
+
+export default defineConfig({
+  app: {
+    description: "A mobile-first progressive web application built with Adjacent.",
+    name: "{{appName}}",
+    shortName: "{{shortName}}",
+    slug: "{{slug}}",
+  },
+  appearance: {
+    backgroundColor: "#ffffff",
+    themeColor: "#171717",
+  },
+  // The Android wrapper reads these through the generated web manifest.
+  android: {
+    navigationColor: "#ffffff",
+    navigationColorDark: "#0c0c0e",
+    themeColorDark: "#0c0c0e",
+  },
+  offline: true,
+});

package/templates/adjacent/components/navigation.tsx

@@ -0,0 +1,46 @@
+"use client";
+
+import { Tab, Tabs } from "adjacent-ui/navigation";
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+
+function HomeIcon() {
+  return (
+    <svg aria-hidden="true" viewBox="0 0 24 24" width="24" height="24" fill="currentColor">
+      <path d="M12 3 3 10.5V21h6v-6h6v6h6V10.5L12 3Z" />
+    </svg>
+  );
+}
+
+function SettingsIcon() {
+  return (
+    <svg aria-hidden="true" viewBox="0 0 24 24" width="24" height="24" fill="currentColor">
+      <path d="M12 15.5A3.5 3.5 0 1 1 12 8.5a3.5 3.5 0 0 1 0 7Zm7.4-2.5a7.6 7.6 0 0 0 0-2l2-1.6-2-3.4-2.4 1a7.6 7.6 0 0 0-1.7-1L14.9 3H9.1l-.4 2.6a7.6 7.6 0 0 0-1.7 1l-2.4-1-2 3.4L4.6 11a7.6 7.6 0 0 0 0 2l-2 1.6 2 3.4 2.4-1a7.6 7.6 0 0 0 1.7 1l.4 2.6h5.8l.4-2.6a7.6 7.6 0 0 0 1.7-1l2.4 1 2-3.4-2-1.6Z" />
+    </svg>
+  );
+}
+
+/**
+ * One navigation, two presentations: a bottom bar on a phone and a left rail
+ * from 768px. Which one shows is decided in CSS, so there is no hydration flash.
+ */
+export function Navigation() {
+  const pathname = usePathname();
+
+  return (
+    <Tabs>
+      <Tab
+        active={pathname === "/"}
+        icon={<HomeIcon />}
+        label="Home"
+        render={<Link href="/" />}
+      />
+      <Tab
+        active={pathname.startsWith("/settings")}
+        icon={<SettingsIcon />}
+        label="Settings"
+        render={<Link href="/settings" />}
+      />
+    </Tabs>
+  );
+}

package/templates/adjacent/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" role="img" aria-label="App icon">
+  <rect width="100" height="100" fill="#171717" />
+  <path fill="#ffffff" fill-rule="evenodd" d="M 50.0 3.0 L 98.5 97.0 L 1.5 97.0 Z M 50.0 25.29 L 71.01 66.0 L 28.99 66.0 Z M 23.06 77.5 L 76.94 77.5 L 87.0 97.0 L 13.0 97.0 Z" />
+</svg>

package/templates/starter/app/(app)/layout.tsx

@@ -0,0 +1,12 @@
+import { NavigationShell } from "adjacent-ui/navigation";
+import type { ReactNode } from "react";
+
+import { Navigation } from "@/components/navigation";
+
+export default function AppLayout({ children }: { readonly children: ReactNode }) {
+  return (
+    <NavigationShell className="bg-background" navigation={<Navigation />}>
+      {children}
+    </NavigationShell>
+  );
+}