@kestack/web-platform 0.0.0-stage → 0.0.0

package/dist/pwa/shared/commands/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","names":[],"sources":["../../../../src/pwa/shared/commands/commands.ts"],"sourcesContent":["import * as Option from 'effect/Option';\nimport * as Schema from 'effect/Schema';\n\n/**\n * FROZEN. The one message a page sends a worker outside Worker RPC: it goes\n * to the waiting worker, a newer build than the page, so every worker\n * version ever shipped must understand these shapes. Never change or remove\n * a field; add a new `type` instead. A worker ignores a `type` it does not\n * know and sends no reply, so senders must time out.\n */\nexport const COMMAND_KEY = '__pwaToolkit';\nconst Envelope = { [COMMAND_KEY]: Schema.Literal(1) } as const;\n\n/** Client → worker, via `worker.postMessage(command, [port])`. */\nexport const Command = Schema.Struct({\n  ...Envelope,\n  type: Schema.Literal('SKIP_WAITING'),\n});\nexport type Command = typeof Command.Type;\nexport type CommandType = Command['type'];\n\n/** Worker → client, posted once on the command's transferred `MessagePort`. */\nexport const CommandReply = Schema.Union([\n  Schema.Struct({ ...Envelope, type: Schema.Literal('DONE') }),\n  Schema.Struct({\n    ...Envelope,\n    type: Schema.Literal('FAILED'),\n    message: Schema.String,\n  }),\n]);\nexport type CommandReply = typeof CommandReply.Type;\n\nexport const makeCommand = (type: CommandType): Command => ({\n  [COMMAND_KEY]: 1,\n  type,\n});\n\nexport const commandReply = {\n  done: (): CommandReply => ({ [COMMAND_KEY]: 1, type: 'DONE' }),\n  failed: (message: string): CommandReply => ({\n    [COMMAND_KEY]: 1,\n    type: 'FAILED',\n    message,\n  }),\n};\n\n/** Whether `data` carries the command key at all (another listener's message if not). */\nexport const isCommandEnvelope = (data: unknown): boolean =>\n  typeof data === 'object' && data !== null && COMMAND_KEY in data;\n\nconst decodeCommand = Schema.decodeUnknownOption(Command);\nconst decodeReply = Schema.decodeUnknownOption(CommandReply);\n\nexport const matchCommand = (data: unknown): Option.Option<Command> =>\n  isCommandEnvelope(data) ? decodeCommand(data) : Option.none();\n\nexport const matchCommandReply = (\n  data: unknown,\n): Option.Option<CommandReply> =>\n  isCommandEnvelope(data) ? decodeReply(data) : Option.none();\n"],"mappings":";;;;;;;;;;AAUA,MAAa,cAAc;AAC3B,MAAM,WAAW,GAAG,cAAc,OAAO,QAAQ,CAAC,EAAE;;AAGpD,MAAa,UAAU,OAAO,OAAO;CACnC,GAAG;CACH,MAAM,OAAO,QAAQ,cAAc;AACrC,CAAC;;AAKD,MAAa,eAAe,OAAO,MAAM,CACvC,OAAO,OAAO;CAAE,GAAG;CAAU,MAAM,OAAO,QAAQ,MAAM;AAAE,CAAC,GAC3D,OAAO,OAAO;CACZ,GAAG;CACH,MAAM,OAAO,QAAQ,QAAQ;CAC7B,SAAS,OAAO;AAClB,CAAC,CACH,CAAC;AAGD,MAAa,eAAe,UAAgC;EACzD,cAAc;CACf;AACF;AAEA,MAAa,eAAe;CAC1B,aAA2B;GAAG,cAAc;EAAG,MAAM;CAAO;CAC5D,SAAS,aAAmC;GACzC,cAAc;EACf,MAAM;EACN;CACF;AACF;;AAGA,MAAa,qBAAqB,SAChC,OAAO,SAAS,YAAY,SAAS,QAAA,kBAAuB;AAE9D,MAAM,gBAAgB,OAAO,oBAAoB,OAAO;AACxD,MAAM,cAAc,OAAO,oBAAoB,YAAY;AAE3D,MAAa,gBAAgB,SAC3B,kBAAkB,IAAI,IAAI,cAAc,IAAI,IAAI,OAAO,KAAK;AAE9D,MAAa,qBACX,SAEA,kBAAkB,IAAI,IAAI,YAAY,IAAI,IAAI,OAAO,KAAK"}

package/dist/pwa/shared/commands/index.d.ts

@@ -0,0 +1,2 @@
+import { COMMAND_KEY, Command, CommandReply, CommandType, commandReply, isCommandEnvelope, makeCommand, matchCommand, matchCommandReply } from "./commands.js";
+export { COMMAND_KEY, Command, CommandReply, type CommandType, commandReply, isCommandEnvelope, makeCommand, matchCommand, matchCommandReply };

package/dist/pwa/shared/commands/index.js

@@ -0,0 +1,2 @@
+import { COMMAND_KEY, Command, CommandReply, commandReply, isCommandEnvelope, makeCommand, matchCommand, matchCommandReply } from "./commands.js";
+export { COMMAND_KEY, Command, CommandReply, commandReply, isCommandEnvelope, makeCommand, matchCommand, matchCommandReply };

package/dist/pwa/shared/config/config.d.ts

@@ -0,0 +1,231 @@
+import { WebAppManifest } from "../manifest/manifest.js";
+import "../manifest/index.js";
+import { StrategyRule } from "../strategy/strategy.js";
+import "../strategy/index.js";
+import { PRESET_NAMES } from "./presets.js";
+import * as Schema from "effect/Schema";
+//#region src/pwa/shared/config/config.d.ts
+/** How navigations resolve: network, then App Shell, then Offline Fallback. */
+export declare const NavigationConfig: Schema.Struct<{
+  readonly shell: Schema.Boolean;
+  readonly shellPath: Schema.String;
+  readonly offlineFallback: Schema.String;
+  readonly networkTimeoutMs: Schema.Int;
+  readonly cachePages: Schema.Boolean;
+  /** Path prefixes whose navigations the worker never handles. */
+  readonly denylist: Schema.$Array<Schema.String>;
+}>;
+export type NavigationConfig = typeof NavigationConfig.Type;
+/** The page never reloads unasked; it only checks for a newer build this often. */
+export declare const UpdateConfig: Schema.Struct<{
+  readonly checkIntervalMinutes: Schema.Int;
+}>;
+export type UpdateConfig = typeof UpdateConfig.Type;
+/** `include` and `exclude` are globs relative to the client outDir. */
+declare const PrecacheConfig: Schema.Struct<{
+  readonly include: Schema.$Array<Schema.String>;
+  readonly exclude: Schema.$Array<Schema.String>;
+  readonly warnAboveBytes: Schema.Int;
+}>;
+/** Options to `pwa({...})`. Everything is optional; see `resolvePwaConfig`. */
+export declare const PwaOptions: Schema.Struct<{
+  readonly enabled: Schema.optionalKey<Schema.Boolean>;
+  readonly dev: Schema.optionalKey<Schema.Boolean>;
+  readonly preset: Schema.optionalKey<Schema.Literals<readonly ["app", "content"]>>;
+  readonly manifest: Schema.optionalKey<Schema.Struct<{
+    readonly id: Schema.optionalKey<Schema.String>;
+    readonly name: Schema.NonEmptyString;
+    readonly short_name: Schema.optionalKey<Schema.String>;
+    readonly description: Schema.optionalKey<Schema.String>;
+    readonly lang: Schema.optionalKey<Schema.String>;
+    readonly dir: Schema.optionalKey<Schema.Literals<readonly ["ltr", "rtl", "auto"]>>;
+    readonly start_url: Schema.optionalKey<Schema.String>;
+    readonly scope: Schema.optionalKey<Schema.String>;
+    readonly display: Schema.optionalKey<Schema.Literals<readonly ["fullscreen", "standalone", "minimal-ui", "browser"]>>;
+    readonly display_override: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["fullscreen", "standalone", "minimal-ui", "browser", "window-controls-overlay", "tabbed"]>>>;
+    readonly orientation: Schema.optionalKey<Schema.Literals<readonly ["any", "natural", "landscape", "landscape-primary", "landscape-secondary", "portrait", "portrait-primary", "portrait-secondary"]>>;
+    readonly theme_color: Schema.optionalKey<Schema.String>;
+    readonly background_color: Schema.optionalKey<Schema.String>;
+    readonly categories: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly icons: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly src: Schema.NonEmptyString;
+      readonly sizes: Schema.optionalKey<Schema.String>;
+      readonly type: Schema.optionalKey<Schema.String>;
+      readonly purpose: Schema.optionalKey<Schema.String>;
+    }>>>;
+    readonly screenshots: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly src: Schema.NonEmptyString;
+      readonly sizes: Schema.optionalKey<Schema.String>;
+      readonly type: Schema.optionalKey<Schema.String>;
+      readonly purpose: Schema.optionalKey<Schema.String>;
+      readonly form_factor: Schema.optionalKey<Schema.Literals<readonly ["narrow", "wide"]>>;
+      readonly label: Schema.optionalKey<Schema.String>;
+      readonly platform: Schema.optionalKey<Schema.String>;
+    }>>>;
+    readonly shortcuts: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly name: Schema.NonEmptyString;
+      readonly short_name: Schema.optionalKey<Schema.String>;
+      readonly description: Schema.optionalKey<Schema.String>;
+      readonly url: Schema.NonEmptyString;
+      readonly icons: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly src: Schema.NonEmptyString;
+        readonly sizes: Schema.optionalKey<Schema.String>;
+        readonly type: Schema.optionalKey<Schema.String>;
+        readonly purpose: Schema.optionalKey<Schema.String>;
+      }>>>;
+    }>>>;
+  }>>;
+  readonly precache: Schema.optionalKey<Schema.Struct<{
+    readonly include: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly exclude: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly warnAboveBytes: Schema.optionalKey<Schema.Int>;
+  }>>;
+  readonly strategies: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly match: Schema.Struct<{
+      readonly origin: Schema.withDecodingDefaultKey<Schema.String, never>;
+      readonly pathPrefix: Schema.optionalKey<Schema.String>;
+      readonly pattern: Schema.optionalKey<Schema.String>;
+      readonly destination: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    }>;
+    readonly strategy: Schema.Literals<readonly ["network-first", "cache-first", "stale-while-revalidate", "network-only", "cache-only"]>;
+    readonly cacheName: Schema.String;
+    readonly networkTimeoutMs: Schema.optionalKey<Schema.Int>;
+    readonly maxEntries: Schema.optionalKey<Schema.Int>;
+    readonly maxAgeSeconds: Schema.optionalKey<Schema.Int>;
+  }>>>;
+  readonly navigation: Schema.optionalKey<Schema.Struct<{
+    readonly shell: Schema.optionalKey<Schema.Boolean>;
+    readonly shellPath: Schema.optionalKey<Schema.String>;
+    readonly offlineFallback: Schema.optionalKey<Schema.String>;
+    readonly networkTimeoutMs: Schema.optionalKey<Schema.Int>;
+    readonly cachePages: Schema.optionalKey<Schema.Boolean>;
+    readonly denylist: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  }>>;
+  readonly neverCache: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly update: Schema.optionalKey<Schema.Struct<{
+    readonly checkIntervalMinutes: Schema.optionalKey<Schema.Int>;
+  }>>;
+  /** Worker entry, relative to the Vite root. Default: `src/sw.ts` if it exists, else the built-in entry. */
+  readonly worker: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly swUrl: Schema.optionalKey<Schema.String>;
+  /**
+   * What the page reports about its build. Default: the time the build
+   * runs, and `git rev-parse --short HEAD` (with `-dirty` for uncommitted
+   * changes), or none when git is not available.
+   */
+  readonly version: Schema.optionalKey<Schema.Struct<{
+    readonly commit: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly builtAt: Schema.optionalKey<Schema.NonEmptyString>;
+  }>>;
+}>;
+/** What the user writes. */
+export type PwaOptions = typeof PwaOptions.Encoded;
+export interface ResolvedPwaConfig {
+  readonly enabled: boolean;
+  readonly dev: boolean;
+  readonly preset: (typeof PRESET_NAMES)[number];
+  readonly manifest: WebAppManifest | null;
+  readonly precache: typeof PrecacheConfig.Type;
+  readonly strategies: ReadonlyArray<StrategyRule>;
+  readonly navigation: NavigationConfig;
+  readonly neverCache: ReadonlyArray<string>;
+  readonly update: UpdateConfig;
+  /** `null` means: `src/sw.ts` if it exists, else the built-in entry. */
+  readonly worker: string | null;
+  readonly swUrl: string;
+  /** Overrides from `version`; the plugin fills the rest when it starts. */
+  readonly version: {
+    readonly commit: string | null;
+    readonly builtAt: string | null;
+  };
+}
+/**
+ * Fills every default. Precedence: explicit option, then preset, then base.
+ * User `strategies` rules come first, then the preset's (first match wins).
+ */
+export declare const resolvePwaConfig: (options: typeof PwaOptions.Type) => ResolvedPwaConfig;
+/** The config the worker runs with; part of the Build ID input. */
+export declare const WorkerConfig: Schema.Struct<{
+  readonly strategies: Schema.$Array<Schema.Struct<{
+    readonly match: Schema.Struct<{
+      readonly origin: Schema.withDecodingDefaultKey<Schema.String, never>;
+      readonly pathPrefix: Schema.optionalKey<Schema.String>;
+      readonly pattern: Schema.optionalKey<Schema.String>;
+      readonly destination: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    }>;
+    readonly strategy: Schema.Literals<readonly ["network-first", "cache-first", "stale-while-revalidate", "network-only", "cache-only"]>;
+    readonly cacheName: Schema.String;
+    readonly networkTimeoutMs: Schema.optionalKey<Schema.Int>;
+    readonly maxEntries: Schema.optionalKey<Schema.Int>;
+    readonly maxAgeSeconds: Schema.optionalKey<Schema.Int>;
+  }>>;
+  readonly navigation: Schema.Struct<{
+    readonly shell: Schema.Boolean;
+    readonly shellPath: Schema.String;
+    readonly offlineFallback: Schema.String;
+    readonly networkTimeoutMs: Schema.Int;
+    readonly cachePages: Schema.Boolean;
+    /** Path prefixes whose navigations the worker never handles. */
+    readonly denylist: Schema.$Array<Schema.String>;
+  }>;
+  readonly neverCache: Schema.$Array<Schema.String>;
+}>;
+export type WorkerConfig = typeof WorkerConfig.Type;
+export declare const workerConfigOf: (config: ResolvedPwaConfig) => WorkerConfig;
+/** Default export of `virtual:pwa-toolkit/build` (worker bundle only). */
+export declare const WorkerBuildInfo: Schema.Struct<{
+  readonly buildId: Schema.brand<Schema.NonEmptyString, "BuildId">;
+  readonly precache: Schema.$Array<Schema.Struct<{
+    readonly url: Schema.String;
+    readonly revision: Schema.NonEmptyString;
+  }>>;
+  readonly config: Schema.Struct<{
+    readonly strategies: Schema.$Array<Schema.Struct<{
+      readonly match: Schema.Struct<{
+        readonly origin: Schema.withDecodingDefaultKey<Schema.String, never>;
+        readonly pathPrefix: Schema.optionalKey<Schema.String>;
+        readonly pattern: Schema.optionalKey<Schema.String>;
+        readonly destination: Schema.optionalKey<Schema.$Array<Schema.String>>;
+      }>;
+      readonly strategy: Schema.Literals<readonly ["network-first", "cache-first", "stale-while-revalidate", "network-only", "cache-only"]>;
+      readonly cacheName: Schema.String;
+      readonly networkTimeoutMs: Schema.optionalKey<Schema.Int>;
+      readonly maxEntries: Schema.optionalKey<Schema.Int>;
+      readonly maxAgeSeconds: Schema.optionalKey<Schema.Int>;
+    }>>;
+    readonly navigation: Schema.Struct<{
+      readonly shell: Schema.Boolean;
+      readonly shellPath: Schema.String;
+      readonly offlineFallback: Schema.String;
+      readonly networkTimeoutMs: Schema.Int;
+      readonly cachePages: Schema.Boolean;
+      /** Path prefixes whose navigations the worker never handles. */
+      readonly denylist: Schema.$Array<Schema.String>;
+    }>;
+    readonly neverCache: Schema.$Array<Schema.String>;
+  }>;
+}>;
+export type WorkerBuildInfo = typeof WorkerBuildInfo.Type;
+/**
+ * Default export of `virtual:pwa-toolkit/client` (client and ssr).
+ * `buildId` is `null` in the client environment, which builds before the ID
+ * exists; the page reads it from the Build ID meta tag instead.
+ */
+export declare const ClientBuildInfo: Schema.Struct<{
+  readonly enabled: Schema.Boolean;
+  readonly swUrl: Schema.String;
+  readonly scope: Schema.String;
+  readonly update: Schema.Struct<{
+    readonly checkIntervalMinutes: Schema.Int;
+  }>;
+  readonly buildId: Schema.NullOr<Schema.brand<Schema.NonEmptyString, "BuildId">>;
+  /** When the build ran (ISO 8601). Server environment only, like `buildId`. */
+  readonly builtAt: Schema.NullOr<Schema.String>;
+  /** The git commit the build came from. Server environment only. */
+  readonly commit: Schema.NullOr<Schema.String>;
+  readonly manifestUrl: Schema.NullOr<Schema.String>;
+  readonly appleTouchIconUrl: Schema.NullOr<Schema.String>;
+}>;
+export type ClientBuildInfo = typeof ClientBuildInfo.Type;
+//#endregion
+//# sourceMappingURL=config.d.ts.map

package/dist/pwa/shared/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../../../../src/pwa/shared/config/config.ts"],"mappings":";;;;;;;;qBAUa,kBAAgB,OAAA;;;;;;;;;YASjB,0BAA0B,iBAAiB;;qBAG1C,cAAY,OAAA;;;YAGb,sBAAsB,aAAa;;cAGzC,gBAAc,OAAA;;;;;;qBAOP,YAAU,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA6CX,oBAAoB,WAAW;iBAE1B;WACN;WACA;WACA,gBAAgB;WAChB,UAAU;WACV,iBAAiB,eAAe;WAChC,YAAY,cAAc;WAC1B,YAAY;WACZ,YAAY;WACZ,QAAQ;;WAER;WACA;;WAEA;aACE;aACA;;;;;;;qBAQA,mBAAgB,gBACX,WAAW,SAC1B;;qBAqCU,cAAY,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;YAKb,sBAAsB,aAAa;qBAElC,iBAAc,QAAY,sBAAoB;;qBAO9C,iBAAe,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAKhB,yBAAyB,gBAAgB;;;;;;qBAOxC,iBAAe,OAAA;;;;;;;;;;;;;;;YAahB,yBAAyB,gBAAgB"}

package/dist/pwa/shared/config/config.js

@@ -0,0 +1,136 @@
+import { BuildId, PrecacheList } from "../build/build.js";
+import { StrategyRule } from "../strategy/strategy.js";
+import { WebAppManifest } from "../manifest/manifest.js";
+import { PRESETS, PRESET_NAMES } from "./presets.js";
+import * as Schema from "effect/Schema";
+//#region src/pwa/shared/config/config.ts
+const Path = Schema.String.check(Schema.isStartingWith("/"));
+const PositiveInt = Schema.Int.check(Schema.isGreaterThan(0));
+/** How navigations resolve: network, then App Shell, then Offline Fallback. */
+const NavigationConfig = Schema.Struct({
+	shell: Schema.Boolean,
+	shellPath: Path,
+	offlineFallback: Path,
+	networkTimeoutMs: PositiveInt,
+	cachePages: Schema.Boolean,
+	/** Path prefixes whose navigations the worker never handles. */
+	denylist: Schema.Array(Path)
+});
+/** The page never reloads unasked; it only checks for a newer build this often. */
+const UpdateConfig = Schema.Struct({ checkIntervalMinutes: PositiveInt });
+/** `include` and `exclude` are globs relative to the client outDir. */
+const PrecacheConfig = Schema.Struct({
+	include: Schema.Array(Schema.String),
+	exclude: Schema.Array(Schema.String),
+	warnAboveBytes: PositiveInt
+});
+/** Options to `pwa({...})`. Everything is optional; see `resolvePwaConfig`. */
+const PwaOptions = Schema.Struct({
+	enabled: Schema.optionalKey(Schema.Boolean),
+	dev: Schema.optionalKey(Schema.Boolean),
+	preset: Schema.optionalKey(Schema.Literals(PRESET_NAMES)),
+	manifest: Schema.optionalKey(WebAppManifest),
+	precache: Schema.optionalKey(PrecacheConfig.mapFields((f) => ({
+		include: Schema.optionalKey(f.include),
+		exclude: Schema.optionalKey(f.exclude),
+		warnAboveBytes: Schema.optionalKey(f.warnAboveBytes)
+	}))),
+	strategies: Schema.optionalKey(Schema.Array(StrategyRule)),
+	navigation: Schema.optionalKey(NavigationConfig.mapFields((f) => ({
+		shell: Schema.optionalKey(f.shell),
+		shellPath: Schema.optionalKey(f.shellPath),
+		offlineFallback: Schema.optionalKey(f.offlineFallback),
+		networkTimeoutMs: Schema.optionalKey(f.networkTimeoutMs),
+		cachePages: Schema.optionalKey(f.cachePages),
+		denylist: Schema.optionalKey(f.denylist)
+	}))),
+	neverCache: Schema.optionalKey(Schema.Array(Path)),
+	update: Schema.optionalKey(UpdateConfig.mapFields((f) => ({ checkIntervalMinutes: Schema.optionalKey(f.checkIntervalMinutes) }))),
+	/** Worker entry, relative to the Vite root. Default: `src/sw.ts` if it exists, else the built-in entry. */
+	worker: Schema.optionalKey(Schema.NonEmptyString),
+	swUrl: Schema.optionalKey(Path),
+	/**
+	* What the page reports about its build. Default: the time the build
+	* runs, and `git rev-parse --short HEAD` (with `-dirty` for uncommitted
+	* changes), or none when git is not available.
+	*/
+	version: Schema.optionalKey(Schema.Struct({
+		commit: Schema.optionalKey(Schema.NonEmptyString),
+		builtAt: Schema.optionalKey(Schema.NonEmptyString)
+	}))
+});
+/**
+* Fills every default. Precedence: explicit option, then preset, then base.
+* User `strategies` rules come first, then the preset's (first match wins).
+*/
+const resolvePwaConfig = (options) => {
+	const preset = options.preset ?? "app";
+	const defaults = PRESETS[preset];
+	return {
+		enabled: options.enabled ?? true,
+		dev: options.dev ?? false,
+		preset,
+		manifest: options.manifest ?? null,
+		precache: {
+			include: options.precache?.include ?? [],
+			exclude: options.precache?.exclude ?? [],
+			warnAboveBytes: options.precache?.warnAboveBytes ?? 5242880
+		},
+		strategies: [...options.strategies ?? [], ...defaults.strategies],
+		navigation: {
+			shell: options.navigation?.shell ?? defaults.navigation.shell,
+			shellPath: options.navigation?.shellPath ?? "/_shell",
+			offlineFallback: options.navigation?.offlineFallback ?? "/offline",
+			networkTimeoutMs: options.navigation?.networkTimeoutMs ?? 3e3,
+			cachePages: options.navigation?.cachePages ?? defaults.navigation.cachePages,
+			denylist: options.navigation?.denylist ?? []
+		},
+		neverCache: options.neverCache ?? ["/api/auth/"],
+		update: { checkIntervalMinutes: options.update?.checkIntervalMinutes ?? 60 },
+		worker: options.worker ?? null,
+		swUrl: options.swUrl ?? "/sw.js",
+		version: {
+			commit: options.version?.commit ?? null,
+			builtAt: options.version?.builtAt ?? null
+		}
+	};
+};
+/** The config the worker runs with; part of the Build ID input. */
+const WorkerConfig = Schema.Struct({
+	strategies: Schema.Array(StrategyRule),
+	navigation: NavigationConfig,
+	neverCache: Schema.Array(Path)
+});
+const workerConfigOf = (config) => ({
+	strategies: config.strategies,
+	navigation: config.navigation,
+	neverCache: config.neverCache
+});
+/** Default export of `virtual:pwa-toolkit/build` (worker bundle only). */
+const WorkerBuildInfo = Schema.Struct({
+	buildId: BuildId,
+	precache: PrecacheList,
+	config: WorkerConfig
+});
+/**
+* Default export of `virtual:pwa-toolkit/client` (client and ssr).
+* `buildId` is `null` in the client environment, which builds before the ID
+* exists; the page reads it from the Build ID meta tag instead.
+*/
+const ClientBuildInfo = Schema.Struct({
+	enabled: Schema.Boolean,
+	swUrl: Path,
+	scope: Path,
+	update: UpdateConfig,
+	buildId: Schema.NullOr(BuildId),
+	/** When the build ran (ISO 8601). Server environment only, like `buildId`. */
+	builtAt: Schema.NullOr(Schema.String),
+	/** The git commit the build came from. Server environment only. */
+	commit: Schema.NullOr(Schema.String),
+	manifestUrl: Schema.NullOr(Path),
+	appleTouchIconUrl: Schema.NullOr(Schema.String)
+});
+//#endregion
+export { ClientBuildInfo, NavigationConfig, PwaOptions, UpdateConfig, WorkerBuildInfo, WorkerConfig, resolvePwaConfig, workerConfigOf };
+
+//# sourceMappingURL=config.js.map

package/dist/pwa/shared/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../../../src/pwa/shared/config/config.ts"],"sourcesContent":["import * as Schema from 'effect/Schema';\nimport { BuildId, PrecacheList } from '../build/index.js';\nimport { WebAppManifest } from '../manifest/index.js';\nimport { StrategyRule } from '../strategy/index.js';\nimport { PRESET_NAMES, PRESETS } from './presets.js';\n\nconst Path = Schema.String.check(Schema.isStartingWith('/'));\nconst PositiveInt = Schema.Int.check(Schema.isGreaterThan(0));\n\n/** How navigations resolve: network, then App Shell, then Offline Fallback. */\nexport const NavigationConfig = Schema.Struct({\n  shell: Schema.Boolean,\n  shellPath: Path,\n  offlineFallback: Path,\n  networkTimeoutMs: PositiveInt,\n  cachePages: Schema.Boolean,\n  /** Path prefixes whose navigations the worker never handles. */\n  denylist: Schema.Array(Path),\n});\nexport type NavigationConfig = typeof NavigationConfig.Type;\n\n/** The page never reloads unasked; it only checks for a newer build this often. */\nexport const UpdateConfig = Schema.Struct({\n  checkIntervalMinutes: PositiveInt,\n});\nexport type UpdateConfig = typeof UpdateConfig.Type;\n\n/** `include` and `exclude` are globs relative to the client outDir. */\nconst PrecacheConfig = Schema.Struct({\n  include: Schema.Array(Schema.String),\n  exclude: Schema.Array(Schema.String),\n  warnAboveBytes: PositiveInt,\n});\n\n/** Options to `pwa({...})`. Everything is optional; see `resolvePwaConfig`. */\nexport const PwaOptions = Schema.Struct({\n  enabled: Schema.optionalKey(Schema.Boolean),\n  dev: Schema.optionalKey(Schema.Boolean),\n  preset: Schema.optionalKey(Schema.Literals(PRESET_NAMES)),\n  manifest: Schema.optionalKey(WebAppManifest),\n  precache: Schema.optionalKey(\n    PrecacheConfig.mapFields((f) => ({\n      include: Schema.optionalKey(f.include),\n      exclude: Schema.optionalKey(f.exclude),\n      warnAboveBytes: Schema.optionalKey(f.warnAboveBytes),\n    })),\n  ),\n  strategies: Schema.optionalKey(Schema.Array(StrategyRule)),\n  navigation: Schema.optionalKey(\n    NavigationConfig.mapFields((f) => ({\n      shell: Schema.optionalKey(f.shell),\n      shellPath: Schema.optionalKey(f.shellPath),\n      offlineFallback: Schema.optionalKey(f.offlineFallback),\n      networkTimeoutMs: Schema.optionalKey(f.networkTimeoutMs),\n      cachePages: Schema.optionalKey(f.cachePages),\n      denylist: Schema.optionalKey(f.denylist),\n    })),\n  ),\n  neverCache: Schema.optionalKey(Schema.Array(Path)),\n  update: Schema.optionalKey(\n    UpdateConfig.mapFields((f) => ({\n      checkIntervalMinutes: Schema.optionalKey(f.checkIntervalMinutes),\n    })),\n  ),\n  /** Worker entry, relative to the Vite root. Default: `src/sw.ts` if it exists, else the built-in entry. */\n  worker: Schema.optionalKey(Schema.NonEmptyString),\n  swUrl: Schema.optionalKey(Path),\n  /**\n   * What the page reports about its build. Default: the time the build\n   * runs, and `git rev-parse --short HEAD` (with `-dirty` for uncommitted\n   * changes), or none when git is not available.\n   */\n  version: Schema.optionalKey(\n    Schema.Struct({\n      commit: Schema.optionalKey(Schema.NonEmptyString),\n      builtAt: Schema.optionalKey(Schema.NonEmptyString),\n    }),\n  ),\n});\n/** What the user writes. */\nexport type PwaOptions = typeof PwaOptions.Encoded;\n\nexport interface ResolvedPwaConfig {\n  readonly enabled: boolean;\n  readonly dev: boolean;\n  readonly preset: (typeof PRESET_NAMES)[number];\n  readonly manifest: WebAppManifest | null;\n  readonly precache: typeof PrecacheConfig.Type;\n  readonly strategies: ReadonlyArray<StrategyRule>;\n  readonly navigation: NavigationConfig;\n  readonly neverCache: ReadonlyArray<string>;\n  readonly update: UpdateConfig;\n  /** `null` means: `src/sw.ts` if it exists, else the built-in entry. */\n  readonly worker: string | null;\n  readonly swUrl: string;\n  /** Overrides from `version`; the plugin fills the rest when it starts. */\n  readonly version: {\n    readonly commit: string | null;\n    readonly builtAt: string | null;\n  };\n}\n\n/**\n * Fills every default. Precedence: explicit option, then preset, then base.\n * User `strategies` rules come first, then the preset's (first match wins).\n */\nexport const resolvePwaConfig = (\n  options: typeof PwaOptions.Type,\n): ResolvedPwaConfig => {\n  const preset = options.preset ?? 'app';\n  const defaults = PRESETS[preset];\n  return {\n    enabled: options.enabled ?? true,\n    dev: options.dev ?? false,\n    preset,\n    manifest: options.manifest ?? null,\n    precache: {\n      include: options.precache?.include ?? [],\n      exclude: options.precache?.exclude ?? [],\n      warnAboveBytes: options.precache?.warnAboveBytes ?? 5 * 1024 * 1024,\n    },\n    strategies: [...(options.strategies ?? []), ...defaults.strategies],\n    navigation: {\n      shell: options.navigation?.shell ?? defaults.navigation.shell,\n      shellPath: options.navigation?.shellPath ?? '/_shell',\n      offlineFallback: options.navigation?.offlineFallback ?? '/offline',\n      networkTimeoutMs: options.navigation?.networkTimeoutMs ?? 3000,\n      cachePages:\n        options.navigation?.cachePages ?? defaults.navigation.cachePages,\n      denylist: options.navigation?.denylist ?? [],\n    },\n    neverCache: options.neverCache ?? ['/api/auth/'],\n    update: {\n      checkIntervalMinutes: options.update?.checkIntervalMinutes ?? 60,\n    },\n    worker: options.worker ?? null,\n    swUrl: options.swUrl ?? '/sw.js',\n    version: {\n      commit: options.version?.commit ?? null,\n      builtAt: options.version?.builtAt ?? null,\n    },\n  };\n};\n\n/** The config the worker runs with; part of the Build ID input. */\nexport const WorkerConfig = Schema.Struct({\n  strategies: Schema.Array(StrategyRule),\n  navigation: NavigationConfig,\n  neverCache: Schema.Array(Path),\n});\nexport type WorkerConfig = typeof WorkerConfig.Type;\n\nexport const workerConfigOf = (config: ResolvedPwaConfig): WorkerConfig => ({\n  strategies: config.strategies,\n  navigation: config.navigation,\n  neverCache: config.neverCache,\n});\n\n/** Default export of `virtual:pwa-toolkit/build` (worker bundle only). */\nexport const WorkerBuildInfo = Schema.Struct({\n  buildId: BuildId,\n  precache: PrecacheList,\n  config: WorkerConfig,\n});\nexport type WorkerBuildInfo = typeof WorkerBuildInfo.Type;\n\n/**\n * Default export of `virtual:pwa-toolkit/client` (client and ssr).\n * `buildId` is `null` in the client environment, which builds before the ID\n * exists; the page reads it from the Build ID meta tag instead.\n */\nexport const ClientBuildInfo = Schema.Struct({\n  enabled: Schema.Boolean,\n  swUrl: Path,\n  scope: Path,\n  update: UpdateConfig,\n  buildId: Schema.NullOr(BuildId),\n  /** When the build ran (ISO 8601). Server environment only, like `buildId`. */\n  builtAt: Schema.NullOr(Schema.String),\n  /** The git commit the build came from. Server environment only. */\n  commit: Schema.NullOr(Schema.String),\n  manifestUrl: Schema.NullOr(Path),\n  appleTouchIconUrl: Schema.NullOr(Schema.String),\n});\nexport type ClientBuildInfo = typeof ClientBuildInfo.Type;\n"],"mappings":"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"}

package/dist/pwa/shared/config/index.d.ts

@@ -0,0 +1,2 @@
+import { ClientBuildInfo, NavigationConfig, PwaOptions, ResolvedPwaConfig, UpdateConfig, WorkerBuildInfo, WorkerConfig, resolvePwaConfig, workerConfigOf } from "./config.js";
+export { ClientBuildInfo, NavigationConfig, PwaOptions, type ResolvedPwaConfig, UpdateConfig, WorkerBuildInfo, WorkerConfig, resolvePwaConfig, workerConfigOf };

package/dist/pwa/shared/config/index.js

@@ -0,0 +1,2 @@
+import { ClientBuildInfo, NavigationConfig, PwaOptions, UpdateConfig, WorkerBuildInfo, WorkerConfig, resolvePwaConfig, workerConfigOf } from "./config.js";
+export { ClientBuildInfo, NavigationConfig, PwaOptions, UpdateConfig, WorkerBuildInfo, WorkerConfig, resolvePwaConfig, workerConfigOf };

package/dist/pwa/shared/config/presets.d.ts

@@ -0,0 +1,19 @@
+import { StrategyRule } from "../strategy/strategy.js";
+import "../strategy/index.js";
+//#region src/pwa/shared/config/presets.d.ts
+export declare const PRESET_NAMES: readonly ['app', 'content'];
+export type PresetName = (typeof PRESET_NAMES)[number];
+interface Preset {
+  readonly strategies: ReadonlyArray<StrategyRule>;
+  readonly navigation: {
+    readonly shell: boolean;
+    readonly cachePages: boolean;
+  };
+}
+/**
+ * `app` for signed-in dashboards and tools, `content` for docs and content
+ * sites (settled from the playground's lifecycle runs). Images are left out of the Precache, so every preset caches them at runtime.
+ */
+export declare const PRESETS: Record<PresetName, Preset>;
+//#endregion
+//# sourceMappingURL=presets.d.ts.map

package/dist/pwa/shared/config/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","names":[],"sources":["../../../../src/pwa/shared/config/presets.ts"],"mappings":";;;qBAEa;YACD,qBAAqB;UAEvB;WACC,YAAY,cAAc;WAC1B;aACE;aACA;;;;;;;qBAUA,SAAS,OAAO,YAAY"}

package/dist/pwa/shared/config/presets.js

@@ -0,0 +1,45 @@
+//#region src/pwa/shared/config/presets.ts
+const PRESET_NAMES = ["app", "content"];
+const DAY_SECONDS = 86400;
+/**
+* `app` for signed-in dashboards and tools, `content` for docs and content
+* sites (settled from the playground's lifecycle runs). Images are left out of the Precache, so every preset caches them at runtime.
+*/
+const PRESETS = {
+	app: {
+		strategies: [{
+			match: {
+				origin: "same-origin",
+				destination: ["image"]
+			},
+			strategy: "cache-first",
+			cacheName: "images",
+			maxEntries: 200,
+			maxAgeSeconds: 30 * DAY_SECONDS
+		}],
+		navigation: {
+			shell: true,
+			cachePages: false
+		}
+	},
+	content: {
+		strategies: [{
+			match: {
+				origin: "same-origin",
+				destination: ["image"]
+			},
+			strategy: "stale-while-revalidate",
+			cacheName: "images",
+			maxEntries: 300,
+			maxAgeSeconds: 30 * DAY_SECONDS
+		}],
+		navigation: {
+			shell: false,
+			cachePages: true
+		}
+	}
+};
+//#endregion
+export { PRESETS, PRESET_NAMES };
+
+//# sourceMappingURL=presets.js.map

package/dist/pwa/shared/config/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","names":[],"sources":["../../../../src/pwa/shared/config/presets.ts"],"sourcesContent":["import type { StrategyRule } from '../strategy/index.js';\n\nexport const PRESET_NAMES = ['app', 'content'] as const;\nexport type PresetName = (typeof PRESET_NAMES)[number];\n\ninterface Preset {\n  readonly strategies: ReadonlyArray<StrategyRule>;\n  readonly navigation: {\n    readonly shell: boolean;\n    readonly cachePages: boolean;\n  };\n}\n\nconst DAY_SECONDS = 24 * 60 * 60;\n\n/**\n * `app` for signed-in dashboards and tools, `content` for docs and content\n * sites (settled from the playground's lifecycle runs). Images are left out of the Precache, so every preset caches them at runtime.\n */\nexport const PRESETS: Record<PresetName, Preset> = {\n  app: {\n    strategies: [\n      {\n        match: { origin: 'same-origin', destination: ['image'] },\n        strategy: 'cache-first',\n        cacheName: 'images',\n        maxEntries: 200,\n        maxAgeSeconds: 30 * DAY_SECONDS,\n      },\n    ],\n    navigation: { shell: true, cachePages: false },\n  },\n  content: {\n    strategies: [\n      {\n        match: { origin: 'same-origin', destination: ['image'] },\n        strategy: 'stale-while-revalidate',\n        cacheName: 'images',\n        maxEntries: 300,\n        maxAgeSeconds: 30 * DAY_SECONDS,\n      },\n    ],\n    navigation: { shell: false, cachePages: true },\n  },\n};\n"],"mappings":";AAEA,MAAa,eAAe,CAAC,OAAO,SAAS;AAW7C,MAAM,cAAc;;;;;AAMpB,MAAa,UAAsC;CACjD,KAAK;EACH,YAAY,CACV;GACE,OAAO;IAAE,QAAQ;IAAe,aAAa,CAAC,OAAO;GAAE;GACvD,UAAU;GACV,WAAW;GACX,YAAY;GACZ,eAAe,KAAK;EACtB,CACF;EACA,YAAY;GAAE,OAAO;GAAM,YAAY;EAAM;CAC/C;CACA,SAAS;EACP,YAAY,CACV;GACE,OAAO;IAAE,QAAQ;IAAe,aAAa,CAAC,OAAO;GAAE;GACvD,UAAU;GACV,WAAW;GACX,YAAY;GACZ,eAAe,KAAK;EACtB,CACF;EACA,YAAY;GAAE,OAAO;GAAO,YAAY;EAAK;CAC/C;AACF"}

package/dist/pwa/shared/manifest/index.d.ts

@@ -0,0 +1,2 @@
+import { WebAppManifest, manifestIconUrls, withManifestDefaults } from "./manifest.js";
+export { WebAppManifest, manifestIconUrls, withManifestDefaults };

package/dist/pwa/shared/manifest/index.js

@@ -0,0 +1,2 @@
+import { WebAppManifest, manifestIconUrls, withManifestDefaults } from "./manifest.js";
+export { WebAppManifest, manifestIconUrls, withManifestDefaults };

package/dist/pwa/shared/manifest/manifest.d.ts

@@ -0,0 +1,53 @@
+import * as Schema from "effect/Schema";
+//#region src/pwa/shared/manifest/manifest.d.ts
+/** The W3C Web App Manifest fields the toolkit understands. */
+export declare const WebAppManifest: Schema.Struct<{
+  readonly id: Schema.optionalKey<Schema.String>;
+  readonly name: Schema.NonEmptyString;
+  readonly short_name: Schema.optionalKey<Schema.String>;
+  readonly description: Schema.optionalKey<Schema.String>;
+  readonly lang: Schema.optionalKey<Schema.String>;
+  readonly dir: Schema.optionalKey<Schema.Literals<readonly ["ltr", "rtl", "auto"]>>;
+  readonly start_url: Schema.optionalKey<Schema.String>;
+  readonly scope: Schema.optionalKey<Schema.String>;
+  readonly display: Schema.optionalKey<Schema.Literals<readonly ["fullscreen", "standalone", "minimal-ui", "browser"]>>;
+  readonly display_override: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["fullscreen", "standalone", "minimal-ui", "browser", "window-controls-overlay", "tabbed"]>>>;
+  readonly orientation: Schema.optionalKey<Schema.Literals<readonly ["any", "natural", "landscape", "landscape-primary", "landscape-secondary", "portrait", "portrait-primary", "portrait-secondary"]>>;
+  readonly theme_color: Schema.optionalKey<Schema.String>;
+  readonly background_color: Schema.optionalKey<Schema.String>;
+  readonly categories: Schema.optionalKey<Schema.$Array<Schema.String>>;
+  readonly icons: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly src: Schema.NonEmptyString;
+    readonly sizes: Schema.optionalKey<Schema.String>;
+    readonly type: Schema.optionalKey<Schema.String>;
+    readonly purpose: Schema.optionalKey<Schema.String>;
+  }>>>;
+  readonly screenshots: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly src: Schema.NonEmptyString;
+    readonly sizes: Schema.optionalKey<Schema.String>;
+    readonly type: Schema.optionalKey<Schema.String>;
+    readonly purpose: Schema.optionalKey<Schema.String>;
+    readonly form_factor: Schema.optionalKey<Schema.Literals<readonly ["narrow", "wide"]>>;
+    readonly label: Schema.optionalKey<Schema.String>;
+    readonly platform: Schema.optionalKey<Schema.String>;
+  }>>>;
+  readonly shortcuts: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly name: Schema.NonEmptyString;
+    readonly short_name: Schema.optionalKey<Schema.String>;
+    readonly description: Schema.optionalKey<Schema.String>;
+    readonly url: Schema.NonEmptyString;
+    readonly icons: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly src: Schema.NonEmptyString;
+      readonly sizes: Schema.optionalKey<Schema.String>;
+      readonly type: Schema.optionalKey<Schema.String>;
+      readonly purpose: Schema.optionalKey<Schema.String>;
+    }>>>;
+  }>>>;
+}>;
+export type WebAppManifest = typeof WebAppManifest.Type;
+/** The manifest as emitted: `start_url` and `scope` `/`, `display` `standalone`, `id` = `start_url`. */
+export declare const withManifestDefaults: (manifest: WebAppManifest) => WebAppManifest;
+/** Icon URLs to precache: every icon, never screenshots. */
+export declare const manifestIconUrls: (manifest: WebAppManifest) => ReadonlyArray<string>;
+//#endregion
+//# sourceMappingURL=manifest.d.ts.map

package/dist/pwa/shared/manifest/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","names":[],"sources":["../../../../src/pwa/shared/manifest/manifest.ts"],"mappings":";;;qBA2Da,gBAAc,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAmBf,wBAAwB,eAAe;;qBAGtC,uBAAoB,UACrB,mBACT;;qBAYU,mBAAgB,UACjB,mBACT"}

package/dist/pwa/shared/manifest/manifest.js

@@ -0,0 +1,87 @@
+import * as Schema from "effect/Schema";
+//#region src/pwa/shared/manifest/manifest.ts
+const Display = Schema.Literals([
+	"fullscreen",
+	"standalone",
+	"minimal-ui",
+	"browser"
+]);
+const DisplayOverride = Schema.Literals([
+	"fullscreen",
+	"standalone",
+	"minimal-ui",
+	"browser",
+	"window-controls-overlay",
+	"tabbed"
+]);
+const Orientation = Schema.Literals([
+	"any",
+	"natural",
+	"landscape",
+	"landscape-primary",
+	"landscape-secondary",
+	"portrait",
+	"portrait-primary",
+	"portrait-secondary"
+]);
+/** `purpose` is a space-separated list of `any`, `maskable`, `monochrome`. */
+const ManifestImage = Schema.Struct({
+	src: Schema.NonEmptyString,
+	sizes: Schema.optionalKey(Schema.String),
+	type: Schema.optionalKey(Schema.String),
+	purpose: Schema.optionalKey(Schema.String.check(Schema.isPattern(/^(any|maskable|monochrome)( (any|maskable|monochrome))*$/)))
+});
+const Screenshot = Schema.Struct({
+	...ManifestImage.fields,
+	form_factor: Schema.optionalKey(Schema.Literals(["narrow", "wide"])),
+	label: Schema.optionalKey(Schema.String),
+	platform: Schema.optionalKey(Schema.String)
+});
+const Shortcut = Schema.Struct({
+	name: Schema.NonEmptyString,
+	short_name: Schema.optionalKey(Schema.String),
+	description: Schema.optionalKey(Schema.String),
+	url: Schema.NonEmptyString,
+	icons: Schema.optionalKey(Schema.Array(ManifestImage))
+});
+/** The W3C Web App Manifest fields the toolkit understands. */
+const WebAppManifest = Schema.Struct({
+	id: Schema.optionalKey(Schema.String),
+	name: Schema.NonEmptyString,
+	short_name: Schema.optionalKey(Schema.String),
+	description: Schema.optionalKey(Schema.String),
+	lang: Schema.optionalKey(Schema.String),
+	dir: Schema.optionalKey(Schema.Literals([
+		"ltr",
+		"rtl",
+		"auto"
+	])),
+	start_url: Schema.optionalKey(Schema.String),
+	scope: Schema.optionalKey(Schema.String),
+	display: Schema.optionalKey(Display),
+	display_override: Schema.optionalKey(Schema.Array(DisplayOverride)),
+	orientation: Schema.optionalKey(Orientation),
+	theme_color: Schema.optionalKey(Schema.String),
+	background_color: Schema.optionalKey(Schema.String),
+	categories: Schema.optionalKey(Schema.Array(Schema.String)),
+	icons: Schema.optionalKey(Schema.Array(ManifestImage)),
+	screenshots: Schema.optionalKey(Schema.Array(Screenshot)),
+	shortcuts: Schema.optionalKey(Schema.Array(Shortcut))
+});
+/** The manifest as emitted: `start_url` and `scope` `/`, `display` `standalone`, `id` = `start_url`. */
+const withManifestDefaults = (manifest) => {
+	const start_url = manifest.start_url ?? "/";
+	return {
+		...manifest,
+		id: manifest.id ?? start_url,
+		start_url,
+		scope: manifest.scope ?? "/",
+		display: manifest.display ?? "standalone"
+	};
+};
+/** Icon URLs to precache: every icon, never screenshots. */
+const manifestIconUrls = (manifest) => [...manifest.icons ?? [], ...(manifest.shortcuts ?? []).flatMap((shortcut) => shortcut.icons ?? [])].map((icon) => icon.src);
+//#endregion
+export { WebAppManifest, manifestIconUrls, withManifestDefaults };
+
+//# sourceMappingURL=manifest.js.map