adjacent-core 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## Unpublished
+
+### 🛠 Breaking changes
+
+### 🎉 New features
+
+### 🐛 Bug fixes
+
+### 💡 Others
+
+## 0.1.0 - 2026-08-29
+
+_This version does not introduce any user-facing changes._

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric Kweyunga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# adjacent-core
+
+Configuration contract, web app manifest, and metadata primitives for Adjacent.
+
+## Documentation
+
+- [Application configuration](https://github.com/erickweyunga/adjacent-framework/blob/main/docs/configuration.md)
+- [All the documentation](https://github.com/erickweyunga/adjacent-framework/blob/main/docs/README.md)
+
+## Installation
+
+```bash
+npm install adjacent-core
+```
+
+Most projects get this through the CLI instead, which installs and wires it up:
+
+```bash
+npx adjacent-cli init
+```
+
+One `app.config.ts` is the source for the web app manifest, the Next.js
+metadata and viewport, and the offline policy the service worker is generated
+from. Everything is validated before any of it is derived, so an invalid
+configuration fails the build rather than producing a half-valid PWA.
+
+## Issues
+
+If you hit a problem using this package, please
+[report it here](https://github.com/erickweyunga/adjacent-framework/issues/new).
+
+## Contributing
+
+Issues and pull requests are welcome. Please read the
+[contributing guide](https://github.com/erickweyunga/adjacent-framework/blob/main/CONTRIBUTING.md)
+first.
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,281 @@
+import { z } from "zod";
+/**
+ * Wrapper chrome the web manifest has no vocabulary for. A web manifest carries
+ * a single `theme_color` and no notion of the Android navigation bar, so these
+ * reach the Android wrapper through Adjacent rather than through the manifest.
+ */
+export declare const AndroidConfigSchema: z.ZodObject<{
+    navigationColor: z.ZodOptional<z.ZodString>;
+    navigationColorDark: z.ZodOptional<z.ZodString>;
+    navigationDividerColor: z.ZodOptional<z.ZodString>;
+    navigationDividerColorDark: z.ZodOptional<z.ZodString>;
+    themeColorDark: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const AdjacentConfigSchema: z.ZodObject<{
+    android: z.ZodOptional<z.ZodObject<{
+        navigationColor: z.ZodOptional<z.ZodString>;
+        navigationColorDark: z.ZodOptional<z.ZodString>;
+        navigationDividerColor: z.ZodOptional<z.ZodString>;
+        navigationDividerColorDark: z.ZodOptional<z.ZodString>;
+        themeColorDark: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    app: z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        dir: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            ltr: "ltr";
+            rtl: "rtl";
+        }>>;
+        id: z.ZodOptional<z.ZodString>;
+        lang: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        shortName: z.ZodOptional<z.ZodString>;
+        slug: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    appearance: z.ZodOptional<z.ZodObject<{
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        display: z.ZodOptional<z.ZodEnum<{
+            browser: "browser";
+            fullscreen: "fullscreen";
+            "minimal-ui": "minimal-ui";
+            standalone: "standalone";
+        }>>;
+        orientation: z.ZodOptional<z.ZodEnum<{
+            any: "any";
+            landscape: "landscape";
+            "landscape-primary": "landscape-primary";
+            "landscape-secondary": "landscape-secondary";
+            natural: "natural";
+            portrait: "portrait";
+            "portrait-primary": "portrait-primary";
+            "portrait-secondary": "portrait-secondary";
+        }>>;
+        themeColor: z.ZodOptional<z.ZodString>;
+        themeColorDark: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    manifest: z.ZodOptional<z.ZodObject<{
+        categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        displayOverride: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            browser: "browser";
+            fullscreen: "fullscreen";
+            "minimal-ui": "minimal-ui";
+            standalone: "standalone";
+            tabbed: "tabbed";
+            "window-controls-overlay": "window-controls-overlay";
+        }>>>;
+        edgeSidePanel: z.ZodOptional<z.ZodObject<{
+            preferredWidth: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        fileHandlers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            accept: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+            action: z.ZodString;
+            icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                purpose: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    any: "any";
+                    maskable: "maskable";
+                    monochrome: "monochrome";
+                }>>>;
+                sizes: z.ZodOptional<z.ZodString>;
+                src: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            launchType: z.ZodOptional<z.ZodEnum<{
+                "multiple-clients": "multiple-clients";
+                "single-client": "single-client";
+            }>>;
+        }, z.core.$strict>>>;
+        iarcRatingId: z.ZodOptional<z.ZodString>;
+        icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            purpose: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                any: "any";
+                maskable: "maskable";
+                monochrome: "monochrome";
+            }>>>;
+            sizes: z.ZodOptional<z.ZodString>;
+            src: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        launchHandler: z.ZodOptional<z.ZodObject<{
+            clientMode: z.ZodUnion<readonly [z.ZodEnum<{
+                auto: "auto";
+                "focus-existing": "focus-existing";
+                "navigate-existing": "navigate-existing";
+                "navigate-new": "navigate-new";
+            }>, z.ZodArray<z.ZodEnum<{
+                auto: "auto";
+                "focus-existing": "focus-existing";
+                "navigate-existing": "navigate-existing";
+                "navigate-new": "navigate-new";
+            }>>]>;
+        }, z.core.$strict>>;
+        localized: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            shortName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        noteTaking: z.ZodOptional<z.ZodObject<{
+            newNoteUrl: z.ZodString;
+        }, z.core.$strict>>;
+        preferRelatedApplications: z.ZodOptional<z.ZodBoolean>;
+        protocolHandlers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            protocol: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strict>>>;
+        relatedApplications: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            platform: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        scopeExtensions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            origin: z.ZodString;
+        }, z.core.$strict>>>;
+        screenshots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodOptional<z.ZodString>;
+            sizes: z.ZodOptional<z.ZodString>;
+            src: z.ZodString;
+            formFactor: z.ZodOptional<z.ZodEnum<{
+                narrow: "narrow";
+                wide: "wide";
+            }>>;
+            label: z.ZodOptional<z.ZodString>;
+            platform: z.ZodOptional<z.ZodEnum<{
+                android: "android";
+                chrome_web_store: "chrome_web_store";
+                chromeos: "chromeos";
+                ios: "ios";
+                ipados: "ipados";
+                itunes: "itunes";
+                kaios: "kaios";
+                macos: "macos";
+                "microsoft-inbox": "microsoft-inbox";
+                "microsoft-store": "microsoft-store";
+                play: "play";
+                windows: "windows";
+                xbox: "xbox";
+            }>>;
+        }, z.core.$strict>>>;
+        shareTarget: z.ZodOptional<z.ZodObject<{
+            action: z.ZodString;
+            enctype: z.ZodOptional<z.ZodEnum<{
+                "application/x-www-form-urlencoded": "application/x-www-form-urlencoded";
+                "multipart/form-data": "multipart/form-data";
+            }>>;
+            method: z.ZodOptional<z.ZodEnum<{
+                GET: "GET";
+                POST: "POST";
+            }>>;
+            params: z.ZodObject<{
+                files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    accept: z.ZodArray<z.ZodString>;
+                    name: z.ZodString;
+                }, z.core.$strict>>>;
+                text: z.ZodOptional<z.ZodString>;
+                title: z.ZodOptional<z.ZodString>;
+                url: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        shortcuts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                purpose: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    any: "any";
+                    maskable: "maskable";
+                    monochrome: "monochrome";
+                }>>>;
+                sizes: z.ZodOptional<z.ZodString>;
+                src: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            name: z.ZodString;
+            shortName: z.ZodOptional<z.ZodString>;
+            url: z.ZodString;
+        }, z.core.$strict>>>;
+        widgets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            backgrounds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                purpose: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    any: "any";
+                    maskable: "maskable";
+                    monochrome: "monochrome";
+                }>>>;
+                sizes: z.ZodOptional<z.ZodString>;
+                src: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            data: z.ZodString;
+            description: z.ZodString;
+            icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                purpose: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    any: "any";
+                    maskable: "maskable";
+                    monochrome: "monochrome";
+                }>>>;
+                sizes: z.ZodOptional<z.ZodString>;
+                src: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            msAcTemplate: z.ZodString;
+            multiple: z.ZodOptional<z.ZodBoolean>;
+            name: z.ZodString;
+            screenshots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                type: z.ZodOptional<z.ZodString>;
+                sizes: z.ZodOptional<z.ZodString>;
+                src: z.ZodString;
+                formFactor: z.ZodOptional<z.ZodEnum<{
+                    narrow: "narrow";
+                    wide: "wide";
+                }>>;
+                label: z.ZodOptional<z.ZodString>;
+                platform: z.ZodOptional<z.ZodEnum<{
+                    android: "android";
+                    chrome_web_store: "chrome_web_store";
+                    chromeos: "chromeos";
+                    ios: "ios";
+                    ipados: "ipados";
+                    itunes: "itunes";
+                    kaios: "kaios";
+                    macos: "macos";
+                    "microsoft-inbox": "microsoft-inbox";
+                    "microsoft-store": "microsoft-store";
+                    play: "play";
+                    windows: "windows";
+                    xbox: "xbox";
+                }>>;
+            }, z.core.$strict>>>;
+            shortName: z.ZodOptional<z.ZodString>;
+            tag: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            update: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    navigation: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodOptional<z.ZodCustom<`/${string}`, `/${string}`>>;
+        startUrl: z.ZodOptional<z.ZodCustom<`/${string}`, `/${string}`>>;
+    }, z.core.$strict>>;
+    selfDestroying: z.ZodOptional<z.ZodBoolean>;
+    offline: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        assetLimit: z.ZodOptional<z.ZodNumber>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodCustom<`/${string}`, `/${string}`>>>;
+        fallback: z.ZodOptional<z.ZodCustom<`/${string}`, `/${string}`>>;
+        navigation: z.ZodOptional<z.ZodEnum<{
+            "cache-first": "cache-first";
+            "network-first": "network-first";
+        }>>;
+    }, z.core.$strict>]>>;
+    plugins: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodTuple<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>], null>]>>>>;
+}, z.core.$strict>;
+export type AdjacentConfig = z.infer<typeof AdjacentConfigSchema>;
+export type AndroidConfig = z.infer<typeof AndroidConfigSchema>;
+export type AdjacentCommand = "build" | "dev" | "doctor" | "export";
+export interface ConfigContext {
+    readonly command: AdjacentCommand;
+    readonly mode: "development" | "production" | "test";
+    readonly projectRoot: string;
+}
+export type AdjacentConfigFactory = (context: ConfigContext) => AdjacentConfig | Promise<AdjacentConfig>;
+export type AdjacentConfigExport = AdjacentConfig | AdjacentConfigFactory;
+export declare function defineConfig(config: AdjacentConfig): AdjacentConfig;
+export declare function defineConfig(config: AdjacentConfigFactory): AdjacentConfigFactory;
+export declare function parseConfig(config: unknown): AdjacentConfig;
+export declare function resolveConfig(exportedConfig: AdjacentConfigExport, context: ConfigContext): Promise<AdjacentConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;kBAM9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8F/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AACD,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,aAAa,KACnB,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAC9C,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAE1E,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAAC;AACrE,wBAAgB,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,CAAC;AAKnF,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAE3D;AAED,wBAAsB,aAAa,CACjC,cAAc,EAAE,oBAAoB,EACpC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,cAAc,CAAC,CAOzB"}

package/dist/config.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { ManifestConfigSchema } from "./manifest/schema.js";
+const CssColorSchema = z.string().trim().min(1, "Expected a CSS color value");
+const PathSchema = z.custom((value) => typeof value === "string" && value.startsWith("/"), "Expected an absolute URL path beginning with /");
+/**
+ * Wrapper chrome the web manifest has no vocabulary for. A web manifest carries
+ * a single `theme_color` and no notion of the Android navigation bar, so these
+ * reach the Android wrapper through Adjacent rather than through the manifest.
+ */
+export const AndroidConfigSchema = z.strictObject({
+    navigationColor: CssColorSchema.optional(),
+    navigationColorDark: CssColorSchema.optional(),
+    navigationDividerColor: CssColorSchema.optional(),
+    navigationDividerColorDark: CssColorSchema.optional(),
+    themeColorDark: CssColorSchema.optional(),
+});
+export const AdjacentConfigSchema = z.strictObject({
+    android: AndroidConfigSchema.optional(),
+    app: z.strictObject({
+        description: z.string().min(1).optional(),
+        /** Which way the name and description read, for a host that mixes scripts. */
+        dir: z.enum(["auto", "ltr", "rtl"]).optional(),
+        id: z.string().min(1).optional(),
+        /** BCP 47 tag for the language the name and description are written in. */
+        lang: z
+            .string()
+            .regex(/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/, "Expected a BCP 47 language tag")
+            .optional(),
+        name: z.string().min(2),
+        shortName: z.string().min(1).max(12).optional(),
+        slug: z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/),
+        version: z.string().min(1).optional(),
+    }),
+    appearance: z
+        .strictObject({
+        backgroundColor: CssColorSchema.optional(),
+        display: z.enum(["browser", "fullscreen", "minimal-ui", "standalone"]).optional(),
+        orientation: z
+            .enum([
+            "any",
+            "landscape",
+            "landscape-primary",
+            "landscape-secondary",
+            "natural",
+            "portrait",
+            "portrait-primary",
+            "portrait-secondary",
+        ])
+            .optional(),
+        themeColor: CssColorSchema.optional(),
+        /**
+         * The browser's own chrome in dark mode. Emitted as a second
+         * `theme-color` discriminated by `prefers-color-scheme`, which is the
+         * only way one document can offer two. The Android wrapper falls back to
+         * it when `android.themeColorDark` says nothing.
+         */
+        themeColorDark: CssColorSchema.optional(),
+    })
+        .optional(),
+    manifest: ManifestConfigSchema.optional(),
+    navigation: z
+        .strictObject({
+        scope: PathSchema.optional(),
+        startUrl: PathSchema.optional(),
+    })
+        .optional(),
+    /**
+     * Replaces the service worker with one that removes itself: it unregisters,
+     * deletes the caches Adjacent made, and reloads open windows. Ship it to
+     * retire a progressive web app, because simply not serving a worker leaves
+     * the installed one in charge of every visitor who already has it.
+     */
+    selfDestroying: z.boolean().optional(),
+    offline: z
+        .union([
+        z.boolean(),
+        z.strictObject({
+            /**
+             * How many assets the runtime cache keeps. Without a bound it grows
+             * until the origin's storage quota is reached, and a media-heavy
+             * application reaches it.
+             */
+            assetLimit: z.number().int().positive().optional(),
+            /**
+             * Paths this application never wants cached, beyond the ones Adjacent
+             * already leaves alone. A path matches itself and everything under it,
+             * so `/admin` covers `/admin` and `/admin/users`.
+             */
+            exclude: z
+                .array(PathSchema.refine((path) => path !== "/", "Excluding / would exclude everything; use offline: false instead"))
+                .optional(),
+            fallback: PathSchema.optional(),
+            navigation: z.enum(["cache-first", "network-first"]).optional(),
+        }),
+    ])
+        .optional(),
+    plugins: z
+        .array(z.union([
+        z.string().min(1),
+        z.tuple([z.string().min(1), z.record(z.string(), z.unknown())]),
+    ]))
+        .readonly()
+        .optional(),
+});
+export function defineConfig(config) {
+    return config;
+}
+export function parseConfig(config) {
+    return AdjacentConfigSchema.parse(config);
+}
+export async function resolveConfig(exportedConfig, context) {
+    const config = typeof exportedConfig === "function"
+        ? await exportedConfig(context)
+        : exportedConfig;
+    return parseConfig(config);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/dev-protocol.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export declare const DEV_COMMAND: {
+    readonly clearCache: "ADJACENT_DEV_CLEAR_CACHE";
+    readonly navigate: "ADJACENT_DEV_NAVIGATE";
+    readonly reload: "ADJACENT_DEV_RELOAD";
+};
+export declare const AdjacentDevCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"ADJACENT_DEV_RELOAD">;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"ADJACENT_DEV_CLEAR_CACHE">;
+}, z.core.$strict>, z.ZodObject<{
+    path: z.ZodCustom<`/${string}`, `/${string}`>;
+    type: z.ZodLiteral<"ADJACENT_DEV_NAVIGATE">;
+}, z.core.$strict>], "type">;
+export type AdjacentDevCommand = z.infer<typeof AdjacentDevCommandSchema>;
+export type AdjacentDevCommandType = AdjacentDevCommand["type"];
+export declare function parseDevCommand(value: unknown): AdjacentDevCommand;
+export declare function safeParseDevCommand(value: unknown): AdjacentDevCommand | undefined;
+//# sourceMappingURL=dev-protocol.d.ts.map

package/dist/dev-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-protocol.d.ts","sourceRoot":"","sources":["../src/dev-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAWX,eAAO,MAAM,wBAAwB;;;;;;;4BAOnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEhE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAElE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,kBAAkB,GAAG,SAAS,CAGhC"}

package/dist/dev-protocol.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export const DEV_COMMAND = {
+    clearCache: "ADJACENT_DEV_CLEAR_CACHE",
+    navigate: "ADJACENT_DEV_NAVIGATE",
+    reload: "ADJACENT_DEV_RELOAD",
+};
+const DevPathSchema = z.custom((value) => typeof value === "string" &&
+    value.startsWith("/") &&
+    value[1] !== "/" &&
+    value[1] !== "\\", "Expected a same-origin path beginning with a single /");
+export const AdjacentDevCommandSchema = z.discriminatedUnion("type", [
+    z.strictObject({ type: z.literal(DEV_COMMAND.reload) }),
+    z.strictObject({ type: z.literal(DEV_COMMAND.clearCache) }),
+    z.strictObject({
+        path: DevPathSchema,
+        type: z.literal(DEV_COMMAND.navigate),
+    }),
+]);
+export function parseDevCommand(value) {
+    return AdjacentDevCommandSchema.parse(value);
+}
+export function safeParseDevCommand(value) {
+    const result = AdjacentDevCommandSchema.safeParse(value);
+    return result.success ? result.data : undefined;
+}
+//# sourceMappingURL=dev-protocol.js.map

package/dist/dev-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-protocol.js","sourceRoot":"","sources":["../src/dev-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,0BAA0B;IACtC,QAAQ,EAAE,uBAAuB;IACjC,MAAM,EAAE,qBAAqB;CACrB,CAAC;AAEX,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;IACrB,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;IAChB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EACnB,uDAAuD,CACxD,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IACvD,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;IAC3D,CAAC,CAAC,YAAY,CAAC;QACb,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC;KACtC,CAAC;CACH,CAAC,CAAC;AAKH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { defineConfig, parseConfig, resolveConfig, type AdjacentCommand, type AdjacentConfig, type AdjacentConfigExport, type AdjacentConfigFactory, type AndroidConfig, type ConfigContext, } from "./config.js";
+export { ANDROID_MANIFEST_KEY, resolveManifest, type ResolvedManifest, } from "./manifest/resolve-manifest.js";
+export { AdjacentDevCommandSchema, DEV_COMMAND, parseDevCommand, safeParseDevCommand, type AdjacentDevCommand, type AdjacentDevCommandType, } from "./dev-protocol.js";
+export { resolveMetadata, resolveViewport, type ResolvedMetadata, type ResolvedViewport, } from "./metadata.js";
+export type { FileHandler, ImageResource, ManifestConfig, ManifestShortcut, Screenshot, ShareTarget, } from "./manifest/schema.js";
+export { WORKER_COMMAND, type AdjacentCacheTarget, type AdjacentWorkerCommand, type AdjacentWorkerResponse, } from "./worker-protocol.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,YAAY,EACZ,WAAW,EACX,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { defineConfig, parseConfig, resolveConfig, } from "./config.js";
+export { ANDROID_MANIFEST_KEY, resolveManifest, } from "./manifest/resolve-manifest.js";
+export { AdjacentDevCommandSchema, DEV_COMMAND, parseDevCommand, safeParseDevCommand, } from "./dev-protocol.js";
+export { resolveMetadata, resolveViewport, } from "./metadata.js";
+export { WORKER_COMMAND, } from "./worker-protocol.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,YAAY,EACZ,WAAW,EACX,aAAa,GAOd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oBAAoB,EACpB,eAAe,GAEhB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,eAAe,GAGhB,MAAM,eAAe,CAAC;AASvB,OAAO,EACL,cAAc,GAIf,MAAM,sBAAsB,CAAC"}

package/dist/manifest/resolve-manifest.d.ts

@@ -0,0 +1,18 @@
+import type { AdjacentConfig } from "../config.js";
+export interface ResolvedManifest extends Record<string, unknown> {
+    readonly background_color: string;
+    readonly display: string;
+    readonly icons: readonly Record<string, unknown>[];
+    readonly name: string;
+    readonly short_name: string;
+    readonly start_url: string;
+    readonly theme_color: string;
+}
+/**
+ * The key the Android wrapper settings travel under. Unknown members are
+ * ignored by browsers, so the manifest stays valid while the CLI can read
+ * values it must never import from `app.config.ts`.
+ */
+export declare const ANDROID_MANIFEST_KEY = "adjacent_android";
+export declare function resolveManifest(config: AdjacentConfig): ResolvedManifest;
+//# sourceMappingURL=resolve-manifest.d.ts.map

package/dist/manifest/resolve-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-manifest.d.ts","sourceRoot":"","sources":["../../src/manifest/resolve-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAuED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAcvD,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAkExE"}