@warlock.js/web 5.0.0

package/esm/client/navigation/verbs.mjs

@@ -0,0 +1,66 @@
+import { currentNavigator } from "../../routing/navigator.mjs";
+
+//#region ../web/src/client/navigation/verbs.ts
+/**
+* The history verbs, under the names MRR spells them
+* (`@mongez/react-router` — `src/utilities.tsx`).
+*
+* A developer moving between a Mongez CSR app and a Warlock SSR app should not
+* relearn "go there" and "go back", so the names and call shapes are MRR's.
+* What is NOT MRR's is the mechanism: MRR's `navigateTo` reaches its router
+* singleton, and that singleton is the client-side matcher Warlock
+* deliberately does not have — the SERVER router is the only matcher
+* (canon `9c8f878b`). So `navigateTo` here delegates to the navigator the
+* client runtime registered, and knows nothing about paths beyond passing one
+* along.
+*
+* ## Why nothing in this file throws
+*
+* All three are importable from universal modules, which means all three can
+* be CALLED with no browser and no runtime: during the server render, and in
+* the gap between first paint and hydration. Each therefore has a defined
+* "did nothing" answer — `false`, a no-op, `""` — instead of an exception.
+* Throwing here would cost the page rather than the navigation.
+*/
+/**
+* Navigate to a path client-side.
+*
+* @param path where to go — passed through untouched; matching is the server's
+* job, so this is not parsed, resolved or prefixed here.
+* @param options `replace: true` swaps the current history entry instead of
+* pushing a new one, so Back skips it.
+* @returns `true` if the client runtime accepted the navigation. `false` means
+* nothing handled it — either no runtime is connected yet (server render, or
+* pre-hydration) or the runtime declined the URL. A `false` caller that needs
+* the user to arrive anyway should fall back to a real browser navigation.
+*/
+function navigateTo(path, options) {
+	const navigator = currentNavigator();
+	if (!navigator) return false;
+	return navigator(path, options);
+}
+/**
+* Go back one entry in browser history.
+*
+* This is the browser's own Back, not a re-navigation to a remembered URL, so
+* it restores scroll and forward history the way the button does. No-op
+* without a `window`.
+*/
+function navigateBack() {
+	if (typeof window === "undefined") return;
+	window.history.back();
+}
+/**
+* @returns the current url's hash WITHOUT its leading `#` — MRR's shape, so
+* `getHash() === "reviews"` for `/products#reviews`. `""` when there is no
+* hash, and `""` rather than `undefined` when there is no `window`, so callers
+* can treat the result as a string unconditionally.
+*/
+function getHash() {
+	if (typeof window === "undefined") return "";
+	return window.location.hash.replace("#", "");
+}
+
+//#endregion
+export { getHash, navigateBack, navigateTo };
+//# sourceMappingURL=verbs.mjs.map

package/esm/client/navigation/verbs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbs.mjs","names":[],"sources":["../../../../../../../../web/src/client/navigation/verbs.ts"],"sourcesContent":["import { currentNavigator } from \"../../routing/navigator\";\n\n/**\n * The history verbs, under the names MRR spells them\n * (`@mongez/react-router` — `src/utilities.tsx`).\n *\n * A developer moving between a Mongez CSR app and a Warlock SSR app should not\n * relearn \"go there\" and \"go back\", so the names and call shapes are MRR's.\n * What is NOT MRR's is the mechanism: MRR's `navigateTo` reaches its router\n * singleton, and that singleton is the client-side matcher Warlock\n * deliberately does not have — the SERVER router is the only matcher\n * (canon `9c8f878b`). So `navigateTo` here delegates to the navigator the\n * client runtime registered, and knows nothing about paths beyond passing one\n * along.\n *\n * ## Why nothing in this file throws\n *\n * All three are importable from universal modules, which means all three can\n * be CALLED with no browser and no runtime: during the server render, and in\n * the gap between first paint and hydration. Each therefore has a defined\n * \"did nothing\" answer — `false`, a no-op, `\"\"` — instead of an exception.\n * Throwing here would cost the page rather than the navigation.\n */\n\n/**\n * Navigate to a path client-side.\n *\n * @param path where to go — passed through untouched; matching is the server's\n * job, so this is not parsed, resolved or prefixed here.\n * @param options `replace: true` swaps the current history entry instead of\n * pushing a new one, so Back skips it.\n * @returns `true` if the client runtime accepted the navigation. `false` means\n * nothing handled it — either no runtime is connected yet (server render, or\n * pre-hydration) or the runtime declined the URL. A `false` caller that needs\n * the user to arrive anyway should fall back to a real browser navigation.\n */\nexport function navigateTo(path: string, options?: { replace?: boolean }): boolean {\n  const navigator = currentNavigator();\n\n  if (!navigator) return false;\n\n  return navigator(path, options);\n}\n\n/**\n * Go back one entry in browser history.\n *\n * This is the browser's own Back, not a re-navigation to a remembered URL, so\n * it restores scroll and forward history the way the button does. No-op\n * without a `window`.\n */\nexport function navigateBack(): void {\n  if (typeof window === \"undefined\") return;\n\n  window.history.back();\n}\n\n/**\n * @returns the current url's hash WITHOUT its leading `#` — MRR's shape, so\n * `getHash() === \"reviews\"` for `/products#reviews`. `\"\"` when there is no\n * hash, and `\"\"` rather than `undefined` when there is no `window`, so callers\n * can treat the result as a string unconditionally.\n */\nexport function getHash(): string {\n  if (typeof window === \"undefined\") return \"\";\n\n  return window.location.hash.replace(\"#\", \"\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,WAAW,MAAc,SAA0C;CACjF,MAAM,YAAY,iBAAiB;CAEnC,IAAI,CAAC,WAAW,OAAO;CAEvB,OAAO,UAAU,MAAM,OAAO;AAChC;;;;;;;;AASA,SAAgB,eAAqB;CACnC,IAAI,OAAO,WAAW,aAAa;CAEnC,OAAO,QAAQ,KAAK;AACtB;;;;;;;AAQA,SAAgB,UAAkB;CAChC,IAAI,OAAO,WAAW,aAAa,OAAO;CAE1C,OAAO,OAAO,SAAS,KAAK,QAAQ,KAAK,EAAE;AAC7C"}

package/esm/client/runtime/index.d.mts

@@ -0,0 +1,4 @@
+import { ClientPageEntry, ClientProjectedModule, ClientRouteComposition, ClientRouteLoad, ClientRouteMatch, ClientRouteParams } from "./types.mjs";
+import { loadClientRouteComposition, validateClientRouteManifest } from "./manifest.mjs";
+import { matchClientRoute } from "./matcher.mjs";
+export { type ClientPageEntry, type ClientProjectedModule, type ClientRouteComposition, type ClientRouteLoad, type ClientRouteMatch, type ClientRouteParams, loadClientRouteComposition, matchClientRoute, validateClientRouteManifest };

package/esm/client/runtime/index.mjs

@@ -0,0 +1,4 @@
+import { loadClientRouteComposition, validateClientRouteManifest } from "./manifest.mjs";
+import { matchClientRoute } from "./matcher.mjs";
+
+export { loadClientRouteComposition, matchClientRoute, validateClientRouteManifest };

package/esm/client/runtime/manifest.d.mts

@@ -0,0 +1,8 @@
+import { ClientPageEntry, ClientRouteComposition } from "./types.mjs";
+
+//#region ../web/src/client/runtime/manifest.d.ts
+declare function validateClientRouteManifest(input: unknown): readonly ClientPageEntry[];
+declare function loadClientRouteComposition(entry: ClientPageEntry): Promise<ClientRouteComposition>;
+//#endregion
+export { loadClientRouteComposition, validateClientRouteManifest };
+//# sourceMappingURL=manifest.d.mts.map

package/esm/client/runtime/manifest.mjs

@@ -0,0 +1,77 @@
+//#region ../web/src/client/runtime/manifest.ts
+const ENTRY_KEYS = [
+	"type",
+	"name",
+	"path",
+	"load"
+];
+const COMPOSITION_REQUIRED_KEYS = ["Page", "layouts"];
+const COMPOSITION_OPTIONAL_KEYS = ["App"];
+function isNonArrayObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function printableValue(value) {
+	if (typeof value === "string") return JSON.stringify(value);
+	try {
+		return String(value);
+	} catch {
+		return "<unprintable>";
+	}
+}
+function assertExactDataKeys(value, requiredKeys, optionalKeys, label) {
+	const allowedKeys = new Set([...requiredKeys, ...optionalKeys]);
+	const descriptors = Object.getOwnPropertyDescriptors(value);
+	const ownKeys = Reflect.ownKeys(value);
+	for (const key of ownKeys) if (typeof key !== "string" || !allowedKeys.has(key)) throw new TypeError(`${label} has unexpected own key ${JSON.stringify(String(key))}.`);
+	for (const key of requiredKeys) if (!Object.prototype.hasOwnProperty.call(descriptors, key)) throw new TypeError(`${label} is missing own key ${JSON.stringify(key)}.`);
+	for (const key of ownKeys) {
+		const descriptor = Object.getOwnPropertyDescriptor(value, key);
+		if (descriptor && !("value" in descriptor)) throw new TypeError(`${label} key ${JSON.stringify(String(key))} must be an own data property.`);
+	}
+}
+function validateEntry(input, index) {
+	const label = `Client route manifest entry at index ${index}`;
+	if (!isNonArrayObject(input)) throw new TypeError(`${label} must be a non-array object.`);
+	assertExactDataKeys(input, ENTRY_KEYS, [], label);
+	if (input.type !== "page") throw new TypeError(`${label} has unknown type ${printableValue(input.type)}; expected "page".`);
+	if (typeof input.name !== "string" || input.name.trim().length === 0) throw new TypeError(`${label} name must be a non-empty string.`);
+	if (typeof input.path !== "string" || input.path.trim().length === 0) throw new TypeError(`${label} path must be a non-empty string.`);
+	if (typeof input.load !== "function") throw new TypeError(`${label} load must be callable.`);
+	return input;
+}
+function validateProjectedModule(input, label) {
+	if (!isNonArrayObject(input)) throw new TypeError(`${label} must be a non-array module object.`);
+	return input;
+}
+function validateComposition(input) {
+	const label = "Loaded client route composition";
+	if (!isNonArrayObject(input)) throw new TypeError(`${label} must be a non-array object.`);
+	assertExactDataKeys(input, COMPOSITION_REQUIRED_KEYS, COMPOSITION_OPTIONAL_KEYS, label);
+	validateProjectedModule(input.Page, `${label} Page`);
+	if (!Array.isArray(input.layouts)) throw new TypeError(`${label} layouts must be an array.`);
+	input.layouts.forEach((layout, index) => {
+		validateProjectedModule(layout, `${label} layout at index ${index}`);
+	});
+	if (Object.prototype.hasOwnProperty.call(input, "App")) validateProjectedModule(input.App, `${label} App`);
+	return input;
+}
+function validateClientRouteManifest(input) {
+	if (!Array.isArray(input)) throw new TypeError("Client route manifest must be an array.");
+	const names = /* @__PURE__ */ new Set();
+	const paths = /* @__PURE__ */ new Set();
+	return input.map((candidate, index) => {
+		const entry = validateEntry(candidate, index);
+		if (names.has(entry.name)) throw new TypeError(`Client route manifest has duplicate name ${JSON.stringify(entry.name)}.`);
+		if (paths.has(entry.path)) throw new TypeError(`Client route manifest has duplicate path ${JSON.stringify(entry.path)}.`);
+		names.add(entry.name);
+		paths.add(entry.path);
+		return entry;
+	});
+}
+async function loadClientRouteComposition(entry) {
+	return validateComposition(await entry.load());
+}
+
+//#endregion
+export { loadClientRouteComposition, validateClientRouteManifest };
+//# sourceMappingURL=manifest.mjs.map

package/esm/client/runtime/manifest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.mjs","names":[],"sources":["../../../../../../../../web/src/client/runtime/manifest.ts"],"sourcesContent":["import type {\n  ClientPageEntry,\n  ClientProjectedModule,\n  ClientRouteComposition,\n} from \"./types\";\n\nconst ENTRY_KEYS = [\"type\", \"name\", \"path\", \"load\"] as const;\nconst COMPOSITION_REQUIRED_KEYS = [\"Page\", \"layouts\"] as const;\nconst COMPOSITION_OPTIONAL_KEYS = [\"App\"] as const;\n\ntype DataRecord = Record<PropertyKey, unknown>;\n\nfunction isNonArrayObject(value: unknown): value is DataRecord {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction printableValue(value: unknown): string {\n  if (typeof value === \"string\") return JSON.stringify(value);\n\n  try {\n    return String(value);\n  } catch {\n    return \"<unprintable>\";\n  }\n}\n\nfunction assertExactDataKeys(\n  value: DataRecord,\n  requiredKeys: readonly string[],\n  optionalKeys: readonly string[],\n  label: string,\n): void {\n  const allowedKeys = new Set([...requiredKeys, ...optionalKeys]);\n  const descriptors = Object.getOwnPropertyDescriptors(value);\n  const ownKeys = Reflect.ownKeys(value);\n\n  for (const key of ownKeys) {\n    if (typeof key !== \"string\" || !allowedKeys.has(key)) {\n      throw new TypeError(`${label} has unexpected own key ${JSON.stringify(String(key))}.`);\n    }\n  }\n\n  for (const key of requiredKeys) {\n    if (!Object.prototype.hasOwnProperty.call(descriptors, key)) {\n      throw new TypeError(`${label} is missing own key ${JSON.stringify(key)}.`);\n    }\n  }\n\n  for (const key of ownKeys) {\n    const descriptor = Object.getOwnPropertyDescriptor(value, key);\n    if (descriptor && !(\"value\" in descriptor)) {\n      throw new TypeError(\n        `${label} key ${JSON.stringify(String(key))} must be an own data property.`,\n      );\n    }\n  }\n}\n\nfunction validateEntry(input: unknown, index: number): ClientPageEntry {\n  const label = `Client route manifest entry at index ${index}`;\n\n  if (!isNonArrayObject(input)) {\n    throw new TypeError(`${label} must be a non-array object.`);\n  }\n\n  assertExactDataKeys(input, ENTRY_KEYS, [], label);\n\n  if (input.type !== \"page\") {\n    throw new TypeError(\n      `${label} has unknown type ${printableValue(input.type)}; expected \"page\".`,\n    );\n  }\n\n  if (typeof input.name !== \"string\" || input.name.trim().length === 0) {\n    throw new TypeError(`${label} name must be a non-empty string.`);\n  }\n\n  if (typeof input.path !== \"string\" || input.path.trim().length === 0) {\n    throw new TypeError(`${label} path must be a non-empty string.`);\n  }\n\n  if (typeof input.load !== \"function\") {\n    throw new TypeError(`${label} load must be callable.`);\n  }\n\n  return input as ClientPageEntry;\n}\n\nfunction validateProjectedModule(input: unknown, label: string): ClientProjectedModule {\n  if (!isNonArrayObject(input)) {\n    throw new TypeError(`${label} must be a non-array module object.`);\n  }\n\n  return input;\n}\n\nfunction validateComposition(input: unknown): ClientRouteComposition {\n  const label = \"Loaded client route composition\";\n\n  if (!isNonArrayObject(input)) {\n    throw new TypeError(`${label} must be a non-array object.`);\n  }\n\n  assertExactDataKeys(\n    input,\n    COMPOSITION_REQUIRED_KEYS,\n    COMPOSITION_OPTIONAL_KEYS,\n    label,\n  );\n  validateProjectedModule(input.Page, `${label} Page`);\n\n  if (!Array.isArray(input.layouts)) {\n    throw new TypeError(`${label} layouts must be an array.`);\n  }\n\n  input.layouts.forEach((layout, index) => {\n    validateProjectedModule(layout, `${label} layout at index ${index}`);\n  });\n\n  if (Object.prototype.hasOwnProperty.call(input, \"App\")) {\n    validateProjectedModule(input.App, `${label} App`);\n  }\n\n  return input as ClientRouteComposition;\n}\n\nexport function validateClientRouteManifest(input: unknown): readonly ClientPageEntry[] {\n  if (!Array.isArray(input)) {\n    throw new TypeError(\"Client route manifest must be an array.\");\n  }\n\n  const names = new Set<string>();\n  const paths = new Set<string>();\n\n  return input.map((candidate, index) => {\n    const entry = validateEntry(candidate, index);\n\n    if (names.has(entry.name)) {\n      throw new TypeError(\n        `Client route manifest has duplicate name ${JSON.stringify(entry.name)}.`,\n      );\n    }\n\n    if (paths.has(entry.path)) {\n      throw new TypeError(\n        `Client route manifest has duplicate path ${JSON.stringify(entry.path)}.`,\n      );\n    }\n\n    names.add(entry.name);\n    paths.add(entry.path);\n    return entry;\n  });\n}\n\nexport async function loadClientRouteComposition(\n  entry: ClientPageEntry,\n): Promise<ClientRouteComposition> {\n  const loaded = await entry.load();\n  return validateComposition(loaded);\n}\n"],"mappings":"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"}

package/esm/client/runtime/matcher.d.mts

@@ -0,0 +1,7 @@
+import { ClientPageEntry, ClientRouteMatch } from "./types.mjs";
+
+//#region ../web/src/client/runtime/matcher.d.ts
+declare function matchClientRoute(entries: readonly ClientPageEntry[], pathname: string): ClientRouteMatch | null;
+//#endregion
+export { matchClientRoute };
+//# sourceMappingURL=matcher.d.mts.map

package/esm/client/runtime/matcher.mjs

@@ -0,0 +1,169 @@
+//#region ../web/src/client/runtime/matcher.ts
+const PARAMETER_NAME = /^[A-Za-z0-9_]+$/;
+const REGEXP_SPECIAL = /[.*+?^${}()|[\]\\]/g;
+function escapeRegExp(value) {
+	return value.replace(REGEXP_SPECIAL, "\\$&");
+}
+function decodeReservedCharacter(high, low) {
+	return {
+		"23": "#",
+		"24": "$",
+		"25": "%",
+		"26": "&",
+		"2B": "+",
+		"2C": ",",
+		"2F": "/",
+		"3A": ":",
+		"3B": ";",
+		"3D": "=",
+		"3F": "?",
+		"40": "@"
+	}[`${high}${low}`.toUpperCase()] ?? null;
+}
+function sanitizePathname(pathname) {
+	if (typeof pathname !== "string" || !pathname.startsWith("/")) throw new Error("Client route pathname must start with '/'");
+	let path = pathname;
+	let shouldDecode = false;
+	let shouldDecodeParameters = false;
+	for (let index = 1; index < path.length; index++) {
+		if (path[index] !== "%") continue;
+		const reserved = decodeReservedCharacter(path[index + 1] ?? "", path[index + 2] ?? "");
+		if (reserved === null) {
+			shouldDecode = true;
+			continue;
+		}
+		shouldDecodeParameters = true;
+		if (reserved === "%") {
+			path = `${path.slice(0, index + 1)}25${path.slice(index + 1)}`;
+			shouldDecode = true;
+			index += 2;
+		}
+		index += 2;
+	}
+	try {
+		if (shouldDecode) path = decodeURI(path);
+	} catch {
+		return null;
+	}
+	if (path.length > 1 && path.endsWith("/")) path = path.slice(0, -1);
+	return {
+		path,
+		shouldDecodeParameters
+	};
+}
+function decodeParameter(value) {
+	let decoded = "";
+	for (let index = 0; index < value.length; index++) {
+		if (value[index] !== "%") {
+			decoded += value[index];
+			continue;
+		}
+		const reserved = decodeReservedCharacter(value[index + 1] ?? "", value[index + 2] ?? "");
+		if (reserved === null) return value;
+		decoded += reserved;
+		index += 2;
+	}
+	return decoded;
+}
+function parsePattern(entry) {
+	const original = entry.path;
+	const isExactRootCatchAll = original === "*";
+	if (!isExactRootCatchAll && !original.startsWith("/")) throw new Error(`Client route pattern '${original}' must start with '/'`);
+	const pattern = original.length > 1 && original.endsWith("/") ? original.slice(0, -1) : original;
+	const segments = isExactRootCatchAll ? ["*"] : pattern === "/" ? [] : pattern.slice(1).split("/");
+	const tokens = [];
+	const parameterNames = [];
+	for (let index = 0; index < segments.length; index++) {
+		const segment = segments[index];
+		if (!segment) throw new Error(`Client route pattern '${original}' contains an empty segment`);
+		if (segment === "*") {
+			if (index !== segments.length - 1) throw new Error(`Client route pattern '${original}' has a non-terminal catch-all`);
+			tokens.push({ type: "catch-all" });
+			parameterNames.push("*");
+			continue;
+		}
+		if (segment.startsWith(":")) {
+			const name = segment.slice(1);
+			if (!PARAMETER_NAME.test(name)) throw new Error(`Client route pattern '${original}' has an unsupported parameter segment`);
+			if (parameterNames.includes(name)) throw new Error(`Client route pattern '${original}' repeats parameter '${name}'`);
+			tokens.push({
+				type: "parameter",
+				name
+			});
+			parameterNames.push(name);
+			continue;
+		}
+		if (segment.includes(":") || segment.includes("*") || segment.includes("?") || segment.includes("%")) throw new Error(`Client route pattern '${original}' contains unsupported syntax`);
+		tokens.push({
+			type: "static",
+			value: segment
+		});
+	}
+	let source = "^";
+	for (let index = 0; index < tokens.length; index++) {
+		const token = tokens[index];
+		if (token.type === "static") source += `/${escapeRegExp(token.value)}`;
+		if (token.type === "parameter") source += "/([^/]{1,100})";
+		if (token.type === "catch-all") source += isExactRootCatchAll ? "(.*)" : index === 0 ? "/(.*)" : "/(.+)";
+	}
+	if (tokens.length === 0) source += "/";
+	source += "$";
+	const collisionKey = tokens.map((token) => {
+		if (token.type === "static") return `s:${token.value.toLowerCase()}`;
+		if (token.type === "parameter") return "p";
+		return "w";
+	}).join("/");
+	return {
+		entry,
+		tokens,
+		parameterNames,
+		expression: new RegExp(source, "i"),
+		collisionKey
+	};
+}
+function compareSpecificity(left, right) {
+	const rank = (token) => {
+		if (!token || token.type === "static") return 3;
+		if (token.type === "parameter") return 2;
+		return 1;
+	};
+	const length = Math.max(left.tokens.length, right.tokens.length);
+	for (let index = 0; index < length; index++) {
+		const difference = rank(right.tokens[index]) - rank(left.tokens[index]);
+		if (difference !== 0) return difference;
+	}
+	return 0;
+}
+function compileRoutes(entries) {
+	const collisions = /* @__PURE__ */ new Map();
+	return entries.map((entry) => {
+		const route = parsePattern(entry);
+		const existing = collisions.get(route.collisionKey);
+		if (existing) throw new Error(`Client route patterns '${existing.path}' and '${entry.path}' collide under server matching`);
+		collisions.set(route.collisionKey, entry);
+		return route;
+	}).sort(compareSpecificity);
+}
+function matchClientRoute(entries, pathname) {
+	const routes = compileRoutes(entries);
+	const sanitized = sanitizePathname(pathname);
+	if (!sanitized) return null;
+	for (const route of routes) {
+		const match = route.expression.exec(sanitized.path);
+		if (!match) continue;
+		const params = {};
+		for (let index = 0; index < route.parameterNames.length; index++) {
+			const value = match[index + 1];
+			params[route.parameterNames[index]] = sanitized.shouldDecodeParameters ? decodeParameter(value) : value;
+		}
+		return {
+			entry: route.entry,
+			params
+		};
+	}
+	return null;
+}
+
+//#endregion
+export { matchClientRoute };
+//# sourceMappingURL=matcher.mjs.map

package/esm/client/runtime/matcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.mjs","names":[],"sources":["../../../../../../../../web/src/client/runtime/matcher.ts"],"sourcesContent":["import type { ClientPageEntry, ClientRouteMatch } from \"./types\";\n\ntype RouteToken =\n  | { readonly type: \"static\"; readonly value: string }\n  | { readonly type: \"parameter\"; readonly name: string }\n  | { readonly type: \"catch-all\" };\n\ntype CompiledRoute = {\n  readonly entry: ClientPageEntry;\n  readonly tokens: readonly RouteToken[];\n  readonly parameterNames: readonly string[];\n  readonly expression: RegExp;\n  readonly collisionKey: string;\n};\n\ntype SanitizedPath = {\n  readonly path: string;\n  readonly shouldDecodeParameters: boolean;\n};\n\nconst PARAMETER_NAME = /^[A-Za-z0-9_]+$/;\nconst REGEXP_SPECIAL = /[.*+?^${}()|[\\]\\\\]/g;\n\nfunction escapeRegExp(value: string): string {\n  return value.replace(REGEXP_SPECIAL, \"\\\\$&\");\n}\n\nfunction decodeReservedCharacter(high: string, low: string): string | null {\n  const pair = `${high}${low}`.toUpperCase();\n  const reserved: Readonly<Record<string, string>> = {\n    \"23\": \"#\",\n    \"24\": \"$\",\n    \"25\": \"%\",\n    \"26\": \"&\",\n    \"2B\": \"+\",\n    \"2C\": \",\",\n    \"2F\": \"/\",\n    \"3A\": \":\",\n    \"3B\": \";\",\n    \"3D\": \"=\",\n    \"3F\": \"?\",\n    \"40\": \"@\",\n  };\n\n  return reserved[pair] ?? null;\n}\n\nfunction sanitizePathname(pathname: string): SanitizedPath | null {\n  if (typeof pathname !== \"string\" || !pathname.startsWith(\"/\")) {\n    throw new Error(\"Client route pathname must start with '/'\");\n  }\n\n  let path = pathname;\n  let shouldDecode = false;\n  let shouldDecodeParameters = false;\n\n  for (let index = 1; index < path.length; index++) {\n    if (path[index] !== \"%\") continue;\n\n    const high = path[index + 1] ?? \"\";\n    const low = path[index + 2] ?? \"\";\n    const reserved = decodeReservedCharacter(high, low);\n\n    if (reserved === null) {\n      shouldDecode = true;\n      continue;\n    }\n\n    shouldDecodeParameters = true;\n    if (reserved === \"%\") {\n      path = `${path.slice(0, index + 1)}25${path.slice(index + 1)}`;\n      shouldDecode = true;\n      index += 2;\n    }\n    index += 2;\n  }\n\n  try {\n    if (shouldDecode) path = decodeURI(path);\n  } catch {\n    return null;\n  }\n\n  if (path.length > 1 && path.endsWith(\"/\")) path = path.slice(0, -1);\n\n  return { path, shouldDecodeParameters };\n}\n\nfunction decodeParameter(value: string): string {\n  let decoded = \"\";\n\n  for (let index = 0; index < value.length; index++) {\n    if (value[index] !== \"%\") {\n      decoded += value[index];\n      continue;\n    }\n\n    const reserved = decodeReservedCharacter(value[index + 1] ?? \"\", value[index + 2] ?? \"\");\n    if (reserved === null) return value;\n\n    decoded += reserved;\n    index += 2;\n  }\n\n  return decoded;\n}\n\nfunction parsePattern(entry: ClientPageEntry): CompiledRoute {\n  const original = entry.path;\n  const isExactRootCatchAll = original === \"*\";\n  if (!isExactRootCatchAll && !original.startsWith(\"/\")) {\n    throw new Error(`Client route pattern '${original}' must start with '/'`);\n  }\n\n  const pattern = original.length > 1 && original.endsWith(\"/\")\n    ? original.slice(0, -1)\n    : original;\n  const segments = isExactRootCatchAll\n    ? [\"*\"]\n    : pattern === \"/\"\n      ? []\n      : pattern.slice(1).split(\"/\");\n  const tokens: RouteToken[] = [];\n  const parameterNames: string[] = [];\n\n  for (let index = 0; index < segments.length; index++) {\n    const segment = segments[index];\n    if (!segment) {\n      throw new Error(`Client route pattern '${original}' contains an empty segment`);\n    }\n\n    if (segment === \"*\") {\n      if (index !== segments.length - 1) {\n        throw new Error(`Client route pattern '${original}' has a non-terminal catch-all`);\n      }\n      tokens.push({ type: \"catch-all\" });\n      parameterNames.push(\"*\");\n      continue;\n    }\n\n    if (segment.startsWith(\":\")) {\n      const name = segment.slice(1);\n      if (!PARAMETER_NAME.test(name)) {\n        throw new Error(`Client route pattern '${original}' has an unsupported parameter segment`);\n      }\n      if (parameterNames.includes(name)) {\n        throw new Error(`Client route pattern '${original}' repeats parameter '${name}'`);\n      }\n      tokens.push({ type: \"parameter\", name });\n      parameterNames.push(name);\n      continue;\n    }\n\n    if (segment.includes(\":\") || segment.includes(\"*\") || segment.includes(\"?\") || segment.includes(\"%\")) {\n      throw new Error(`Client route pattern '${original}' contains unsupported syntax`);\n    }\n    tokens.push({ type: \"static\", value: segment });\n  }\n\n  let source = \"^\";\n  for (let index = 0; index < tokens.length; index++) {\n    const token = tokens[index];\n    if (token.type === \"static\") source += `/${escapeRegExp(token.value)}`;\n    if (token.type === \"parameter\") source += \"/([^/]{1,100})\";\n    if (token.type === \"catch-all\") {\n      source += isExactRootCatchAll ? \"(.*)\" : index === 0 ? \"/(.*)\" : \"/(.+)\";\n    }\n  }\n  if (tokens.length === 0) source += \"/\";\n  source += \"$\";\n\n  const collisionKey = tokens\n    .map((token) => {\n      if (token.type === \"static\") return `s:${token.value.toLowerCase()}`;\n      if (token.type === \"parameter\") return \"p\";\n      return \"w\";\n    })\n    .join(\"/\");\n\n  return {\n    entry,\n    tokens,\n    parameterNames,\n    expression: new RegExp(source, \"i\"),\n    collisionKey,\n  };\n}\n\nfunction compareSpecificity(left: CompiledRoute, right: CompiledRoute): number {\n  const rank = (token: RouteToken | undefined): number => {\n    if (!token || token.type === \"static\") return 3;\n    if (token.type === \"parameter\") return 2;\n    return 1;\n  };\n\n  const length = Math.max(left.tokens.length, right.tokens.length);\n  for (let index = 0; index < length; index++) {\n    const difference = rank(right.tokens[index]) - rank(left.tokens[index]);\n    if (difference !== 0) return difference;\n  }\n  return 0;\n}\n\nfunction compileRoutes(entries: readonly ClientPageEntry[]): readonly CompiledRoute[] {\n  const collisions = new Map<string, ClientPageEntry>();\n  const routes = entries.map((entry) => {\n    const route = parsePattern(entry);\n    const existing = collisions.get(route.collisionKey);\n    if (existing) {\n      throw new Error(\n        `Client route patterns '${existing.path}' and '${entry.path}' collide under server matching`,\n      );\n    }\n    collisions.set(route.collisionKey, entry);\n    return route;\n  });\n\n  return routes.sort(compareSpecificity);\n}\n\nexport function matchClientRoute(\n  entries: readonly ClientPageEntry[],\n  pathname: string,\n): ClientRouteMatch | null {\n  const routes = compileRoutes(entries);\n  const sanitized = sanitizePathname(pathname);\n  if (!sanitized) return null;\n\n  for (const route of routes) {\n    const match = route.expression.exec(sanitized.path);\n    if (!match) continue;\n\n    const params: Record<string, string> = {};\n    for (let index = 0; index < route.parameterNames.length; index++) {\n      const value = match[index + 1];\n      params[route.parameterNames[index]] = sanitized.shouldDecodeParameters\n        ? decodeParameter(value)\n        : value;\n    }\n    return { entry: route.entry, params };\n  }\n\n  return null;\n}\n"],"mappings":"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"}

package/esm/client/runtime/types.d.mts

@@ -0,0 +1,22 @@
+//#region ../web/src/client/runtime/types.d.ts
+type ClientProjectedModule = Readonly<Record<string, unknown>>;
+type ClientRouteComposition = {
+  readonly Page: ClientProjectedModule;
+  readonly layouts: readonly ClientProjectedModule[];
+  readonly App?: ClientProjectedModule;
+};
+type ClientRouteLoad = () => ClientRouteComposition | Promise<ClientRouteComposition>;
+type ClientPageEntry = {
+  readonly type: "page";
+  readonly name: string;
+  readonly path: string;
+  readonly load: ClientRouteLoad;
+};
+type ClientRouteParams = Readonly<Record<string, string>>;
+type ClientRouteMatch = {
+  readonly entry: ClientPageEntry;
+  readonly params: ClientRouteParams;
+};
+//#endregion
+export { ClientPageEntry, ClientProjectedModule, ClientRouteComposition, ClientRouteLoad, ClientRouteMatch, ClientRouteParams };
+//# sourceMappingURL=types.d.mts.map

package/esm/components/default-app.mjs

@@ -0,0 +1,32 @@
+import { useDocumentContext } from "./document-context.mjs";
+import { Head } from "./head.mjs";
+import { Scripts } from "./scripts.mjs";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../web/src/components/default-app.tsx
+/**
+* The framework's own root, used whenever an app defines no `root.tsx` (or
+* omits a default export). The framework's default App is ALSO a full
+* document — so every page renders a complete `<html>` regardless of
+* whether the app customized its root. The app owns the document: when a
+* custom `root.tsx` exists (`v5/app/src/web/root.tsx` is that example), it is
+* fully responsible for `lang`/`dir`/`<Scripts nonce>`/providers/its own
+* `<head>` tags. Only when no custom App exists does this fallback supply
+* `lang`/`dir`/nonce itself, sourced from the framework's document-context
+* slots rather than any app-owned data.
+*/
+function DefaultApp({ children }) {
+	const { lang, dir } = useDocumentContext("DefaultApp");
+	return /* @__PURE__ */ jsxs("html", {
+		lang,
+		dir,
+		children: [/* @__PURE__ */ jsx("head", { children: /* @__PURE__ */ jsx(Head, {}) }), /* @__PURE__ */ jsxs("body", { children: [/* @__PURE__ */ jsx("div", {
+			id: "root",
+			children
+		}), /* @__PURE__ */ jsx(Scripts, {})] })]
+	});
+}
+
+//#endregion
+export { DefaultApp as default };
+//# sourceMappingURL=default-app.mjs.map

package/esm/components/default-app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-app.mjs","names":[],"sources":["../../../../../../../web/src/components/default-app.tsx"],"sourcesContent":["import type { ReactElement, ReactNode } from \"react\";\nimport { useDocumentContext } from \"./document-context\";\nimport { Head } from \"./head\";\nimport { Scripts } from \"./scripts\";\n\nexport type DefaultAppProps = {\n  children: ReactNode;\n};\n\n/**\n * The framework's own root, used whenever an app defines no `root.tsx` (or\n * omits a default export). The framework's default App is ALSO a full\n * document — so every page renders a complete `<html>` regardless of\n * whether the app customized its root. The app owns the document: when a\n * custom `root.tsx` exists (`v5/app/src/web/root.tsx` is that example), it is\n * fully responsible for `lang`/`dir`/`<Scripts nonce>`/providers/its own\n * `<head>` tags. Only when no custom App exists does this fallback supply\n * `lang`/`dir`/nonce itself, sourced from the framework's document-context\n * slots rather than any app-owned data.\n */\nexport default function DefaultApp({ children }: DefaultAppProps): ReactElement {\n  const { lang, dir } = useDocumentContext(\"DefaultApp\");\n\n  return (\n    <html lang={lang} dir={dir}>\n      <head>\n        <Head />\n      </head>\n      <body>\n        {/*\n          The hydration mount point (documented previously as\n          `render-page.ts`'s own hardcoded shell, now moved here since the\n          root supplies the whole document itself). An app writing its own\n          custom `root.tsx` is responsible for its own equivalent if it wants\n          a stable hydration target — this default only covers the\n          no-custom-root case.\n        */}\n        <div id=\"root\">{children}</div>\n        {/* Prop-less: inherits the nonce slot via Scripts' own fallback\n            (scripts.ts) rather than reading document-context twice here. */}\n        <Scripts />\n      </body>\n    </html>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,SAAwB,WAAW,EAAE,YAA2C;CAC9E,MAAM,EAAE,MAAM,QAAQ,mBAAmB,YAAY;CAErD,OACE,qBAAC,QAAD;EAAY;EAAW;YAAvB,CACE,oBAAC,QAAD,YACE,oBAAC,MAAD,CAAO,GACH,IACN,qBAAC,QAAD,aASE,oBAAC,OAAD;GAAK,IAAG;GAAQ;EAAc,IAG9B,oBAAC,SAAD,CAAU,EACN,IACF;;AAEV"}

package/esm/components/document-context.d.mts

@@ -0,0 +1 @@
+export { };

package/esm/components/document-context.mjs

@@ -0,0 +1,24 @@
+import { createContext, useContext } from "react";
+
+//#region ../web/src/components/document-context.ts
+const PAYLOAD_SCRIPT_ID = "__WARLOCK_DATA__";
+const LINE_SEPARATOR = String.fromCharCode(8232);
+const PARAGRAPH_SEPARATOR = String.fromCharCode(8233);
+/** Escape JSON text for raw insertion into an application/json script. */
+function escapePayload(json) {
+	return json.split("<").join("\\u003c").split(">").join("\\u003e").split(LINE_SEPARATOR).join("\\u2028").split(PARAGRAPH_SEPARATOR).join("\\u2029");
+}
+const DocumentContext = createContext(void 0);
+/**
+* Require the page pipeline's universal document state. The payload id and
+* escaping helpers remain exported above for the existing server seam.
+*/
+function useDocumentContext(componentName) {
+	const value = useContext(DocumentContext);
+	if (!value) throw new Error(`<${componentName}/> was rendered outside the page pipeline's document context (web/src/components/document-context.ts). Fix: only render it inside an App/Layout/Page component tree the pipeline itself renders.`);
+	return value;
+}
+
+//#endregion
+export { DocumentContext, PAYLOAD_SCRIPT_ID, escapePayload, useDocumentContext };
+//# sourceMappingURL=document-context.mjs.map

package/esm/components/document-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-context.mjs","names":[],"sources":["../../../../../../../web/src/components/document-context.ts"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { MetadataOutput } from \"../metadata\";\n\nexport type HydrationDocumentPayloadSource = {\n  readonly appData: unknown;\n  readonly layoutData: unknown;\n  readonly pageData: unknown;\n  readonly shared: unknown;\n  /**\n   * The matched page manifest entry's stable `name` — the same field the\n   * manifest entry contract `{ type, name, path, load }` declares. It is on\n   * the wire so the browser can look up WHICH page the server rendered\n   * instead of re-matching `location.pathname` itself: re-matching is a\n   * second implementation of route semantics, and it can disagree with the\n   * server on the very request it is hydrating.\n   */\n  readonly name: string;\n  /**\n   * The params the SERVER matched for this request — `bundle.route.params`\n   * (`server/execute-page-request.ts:288`), carried untransformed. Same reason\n   * `name` is here: the browser must not re-derive them from\n   * `location.pathname`, because deriving them IS a second matcher.\n   *\n   * OPTIONAL, and ungated on purpose — see {@link metadata} below for the rule\n   * both new keys share. The server always emits it (`{}` for a route with no\n   * dynamic segments), so absence means the payload came from a producer that\n   * predates this key; `currentRoute()` then reports `{}` rather than failing a\n   * page over an accessor.\n   */\n  readonly params?: Readonly<Record<string, string>>;\n  /**\n   * The page metadata the server resolved at stage 8, carried WHOLE — the same\n   * `MetadataOutput` `<Head/>` rendered into the document on the first request.\n   *\n   * Why it has to be on the wire at all: `<Head/>` renders inside the App\n   * level, and the App level is not part of the hydrated tree (the client\n   * mounts at `#root`, which App contains). So on a client navigation there is\n   * no React render that can reach `<head>` — without this key the browser\n   * never learns the new page's title and the tab keeps the old one.\n   *\n   * OPTIONAL, deliberately: `bundle.metadata` is itself optional\n   * (`server/execute-page-request.ts:296`) — a page that exports no `metadata`\n   * produces none, and a loader short-circuit skips stage 8 entirely. Gating a\n   * key the server is right not to produce would make `readHydrationPayload`\n   * throw on a valid page. Present-but-not-an-object is still MALFORMED and\n   * still throws; only ABSENT is accepted.\n   */\n  readonly metadata?: MetadataOutput;\n};\n\nexport const PAYLOAD_SCRIPT_ID = \"__WARLOCK_DATA__\";\n\nconst LINE_SEPARATOR = String.fromCharCode(0x2028);\nconst PARAGRAPH_SEPARATOR = String.fromCharCode(0x2029);\n\n/** Escape JSON text for raw insertion into an application/json script. */\nexport function escapePayload(json: string): string {\n  return json\n    .split(\"<\")\n    .join(\"\\\\u003c\")\n    .split(\">\")\n    .join(\"\\\\u003e\")\n    .split(LINE_SEPARATOR)\n    .join(\"\\\\u2028\")\n    .split(PARAGRAPH_SEPARATOR)\n    .join(\"\\\\u2029\");\n}\n\n/**\n * What `<Head/>`/`<Scripts/>` need to render real elements instead of the\n * framework injecting them by string surgery post-render (Suki, room seq\n * 1205): the resolved page metadata and the exact payload the hydration\n * script will read back. Provided once, around the root element, before\n * `renderToString` runs (`render-page.ts`'s stage 9 — the bundle is already\n * complete by then). Universal: no server-only imports, so the client's\n * hydration entry (a later slice) can provide the same shape from the parsed\n * payload script.\n */\nexport type DocumentContextValue = {\n  metadata: MetadataOutput | undefined;\n  payload: HydrationDocumentPayloadSource;\n  /**\n   * The nonce/lang/dir SLOTS: fed by the render provider from CORE request\n   * fields — request nonce, request locale — never from app-owned `shared`\n   * keys, which an app can overwrite. The provider-side\n   * wiring is a separate slice, so these are absent at runtime until it\n   * lands; every reader must treat them as optional.\n   */\n  nonce?: string;\n  lang?: string;\n  dir?: string;\n};\n\nexport const DocumentContext = createContext<DocumentContextValue | undefined>(undefined);\n\n/**\n * Require the page pipeline's universal document state. The payload id and\n * escaping helpers remain exported above for the existing server seam.\n */\nexport function useDocumentContext(componentName: string): DocumentContextValue {\n  const value = useContext(DocumentContext);\n\n  if (!value) {\n    throw new Error(\n      `<${componentName}/> was rendered outside the page pipeline's document context ` +\n        \"(web/src/components/document-context.ts). Fix: only render it inside \" +\n        \"an App/Layout/Page component tree the pipeline itself renders.\",\n    );\n  }\n\n  return value;\n}\n"],"mappings":";;;AAkDA,MAAa,oBAAoB;AAEjC,MAAM,iBAAiB,OAAO,aAAa,IAAM;AACjD,MAAM,sBAAsB,OAAO,aAAa,IAAM;;AAGtD,SAAgB,cAAc,MAAsB;CAClD,OAAO,KACJ,MAAM,GAAG,CAAC,CACV,KAAK,SAAS,CAAC,CACf,MAAM,GAAG,CAAC,CACV,KAAK,SAAS,CAAC,CACf,MAAM,cAAc,CAAC,CACrB,KAAK,SAAS,CAAC,CACf,MAAM,mBAAmB,CAAC,CAC1B,KAAK,SAAS;AACnB;AA2BA,MAAa,kBAAkB,cAAgD,MAAS;;;;;AAMxF,SAAgB,mBAAmB,eAA6C;CAC9E,MAAM,QAAQ,WAAW,eAAe;CAExC,IAAI,CAAC,OACH,MAAM,IAAI,MACR,IAAI,cAAc,iMAGpB;CAGF,OAAO;AACT"}

package/esm/components/head.d.mts

@@ -0,0 +1,14 @@
+import { ReactElement } from "react";
+
+//#region ../web/src/components/head.d.ts
+/**
+ * OPTIONAL placement override for the framework's `<head>` injection — the
+ * page's `metadata` output, the stylesheet/preload tags and the
+ * canonical/alternate links land here when it is present, and at the default
+ * position when it is not (root.tsx:85-92). Takes no props: it says WHERE, and
+ * only that.
+ */
+declare function Head(): ReactElement;
+//#endregion
+export { Head };
+//# sourceMappingURL=head.d.mts.map

package/esm/components/head.mjs

@@ -0,0 +1,63 @@
+import { useDocumentContext } from "./document-context.mjs";
+import { Fragment, createElement } from "react";
+
+//#region ../web/src/components/head.ts
+/**
+* OPTIONAL placement override for the framework's `<head>` injection — the
+* page's `metadata` output, the stylesheet/preload tags and the
+* canonical/alternate links land here when it is present, and at the default
+* position when it is not (root.tsx:85-92). Takes no props: it says WHERE, and
+* only that.
+*/
+function Head() {
+	const { metadata } = useDocumentContext("Head");
+	const keywords = metadata?.keywords === void 0 ? void 0 : Array.isArray(metadata.keywords) ? metadata.keywords.join(", ") : metadata.keywords;
+	const openGraph = metadata?.openGraph;
+	const ogTitle = openGraph?.title ?? metadata?.title;
+	const ogDescription = openGraph?.description ?? metadata?.description;
+	const twitter = metadata?.twitter;
+	return createElement(Fragment, null, createElement("meta", { charSet: "utf-8" }), metadata?.title !== void 0 ? createElement("title", null, metadata.title) : null, metadata?.description !== void 0 ? createElement("meta", {
+		name: "description",
+		content: metadata.description
+	}) : null, keywords !== void 0 ? createElement("meta", {
+		name: "keywords",
+		content: keywords
+	}) : null, metadata?.canonical !== void 0 ? createElement("link", {
+		rel: "canonical",
+		href: metadata.canonical
+	}) : null, metadata?.robots !== void 0 ? createElement("meta", {
+		name: "robots",
+		content: metadata.robots
+	}) : null, openGraph !== void 0 && ogTitle !== void 0 ? createElement("meta", {
+		property: "og:title",
+		content: ogTitle
+	}) : null, openGraph !== void 0 && ogDescription !== void 0 ? createElement("meta", {
+		property: "og:description",
+		content: ogDescription
+	}) : null, openGraph?.image !== void 0 ? createElement("meta", {
+		property: "og:image",
+		content: openGraph.image
+	}) : null, openGraph?.url !== void 0 ? createElement("meta", {
+		property: "og:url",
+		content: openGraph.url
+	}) : null, openGraph?.type !== void 0 ? createElement("meta", {
+		property: "og:type",
+		content: openGraph.type
+	}) : null, twitter?.card !== void 0 ? createElement("meta", {
+		name: "twitter:card",
+		content: twitter.card
+	}) : null, twitter?.title !== void 0 ? createElement("meta", {
+		name: "twitter:title",
+		content: twitter.title
+	}) : null, twitter?.description !== void 0 ? createElement("meta", {
+		name: "twitter:description",
+		content: twitter.description
+	}) : null, twitter?.image !== void 0 ? createElement("meta", {
+		name: "twitter:image",
+		content: twitter.image
+	}) : null);
+}
+
+//#endregion
+export { Head };
+//# sourceMappingURL=head.mjs.map

package/esm/components/head.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.mjs","names":[],"sources":["../../../../../../../web/src/components/head.ts"],"sourcesContent":["import { createElement, Fragment, type ReactElement } from \"react\";\nimport { useDocumentContext } from \"./document-context\";\n\n/**\n * OPTIONAL placement override for the framework's `<head>` injection — the\n * page's `metadata` output, the stylesheet/preload tags and the\n * canonical/alternate links land here when it is present, and at the default\n * position when it is not (root.tsx:85-92). Takes no props: it says WHERE, and\n * only that.\n */\nexport function Head(): ReactElement {\n  const { metadata } = useDocumentContext(\"Head\");\n\n  const keywords =\n    metadata?.keywords === undefined\n      ? undefined\n      : Array.isArray(metadata.keywords)\n        ? metadata.keywords.join(\", \")\n        : metadata.keywords;\n\n  const openGraph = metadata?.openGraph;\n  // Falls back to the top-level fields — the only two fallbacks the type declares.\n  const ogTitle = openGraph?.title ?? metadata?.title;\n  const ogDescription = openGraph?.description ?? metadata?.description;\n\n  const twitter = metadata?.twitter;\n\n  return createElement(\n    Fragment,\n    null,\n    createElement(\"meta\", { charSet: \"utf-8\" }),\n    metadata?.title !== undefined ? createElement(\"title\", null, metadata.title) : null,\n    metadata?.description !== undefined\n      ? createElement(\"meta\", { name: \"description\", content: metadata.description })\n      : null,\n    keywords !== undefined ? createElement(\"meta\", { name: \"keywords\", content: keywords }) : null,\n    metadata?.canonical !== undefined\n      ? createElement(\"link\", { rel: \"canonical\", href: metadata.canonical })\n      : null,\n    metadata?.robots !== undefined\n      ? createElement(\"meta\", { name: \"robots\", content: metadata.robots })\n      : null,\n    openGraph !== undefined && ogTitle !== undefined\n      ? createElement(\"meta\", { property: \"og:title\", content: ogTitle })\n      : null,\n    openGraph !== undefined && ogDescription !== undefined\n      ? createElement(\"meta\", { property: \"og:description\", content: ogDescription })\n      : null,\n    openGraph?.image !== undefined\n      ? createElement(\"meta\", { property: \"og:image\", content: openGraph.image })\n      : null,\n    openGraph?.url !== undefined\n      ? createElement(\"meta\", { property: \"og:url\", content: openGraph.url })\n      : null,\n    openGraph?.type !== undefined\n      ? createElement(\"meta\", { property: \"og:type\", content: openGraph.type })\n      : null,\n    twitter?.card !== undefined\n      ? createElement(\"meta\", { name: \"twitter:card\", content: twitter.card })\n      : null,\n    twitter?.title !== undefined\n      ? createElement(\"meta\", { name: \"twitter:title\", content: twitter.title })\n      : null,\n    twitter?.description !== undefined\n      ? createElement(\"meta\", { name: \"twitter:description\", content: twitter.description })\n      : null,\n    twitter?.image !== undefined\n      ? createElement(\"meta\", { name: \"twitter:image\", content: twitter.image })\n      : null,\n  );\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,OAAqB;CACnC,MAAM,EAAE,aAAa,mBAAmB,MAAM;CAE9C,MAAM,WACJ,UAAU,aAAa,SACnB,SACA,MAAM,QAAQ,SAAS,QAAQ,IAC7B,SAAS,SAAS,KAAK,IAAI,IAC3B,SAAS;CAEjB,MAAM,YAAY,UAAU;CAE5B,MAAM,UAAU,WAAW,SAAS,UAAU;CAC9C,MAAM,gBAAgB,WAAW,eAAe,UAAU;CAE1D,MAAM,UAAU,UAAU;CAE1B,OAAO,cACL,UACA,MACA,cAAc,QAAQ,EAAE,SAAS,QAAQ,CAAC,GAC1C,UAAU,UAAU,SAAY,cAAc,SAAS,MAAM,SAAS,KAAK,IAAI,MAC/E,UAAU,gBAAgB,SACtB,cAAc,QAAQ;EAAE,MAAM;EAAe,SAAS,SAAS;CAAY,CAAC,IAC5E,MACJ,aAAa,SAAY,cAAc,QAAQ;EAAE,MAAM;EAAY,SAAS;CAAS,CAAC,IAAI,MAC1F,UAAU,cAAc,SACpB,cAAc,QAAQ;EAAE,KAAK;EAAa,MAAM,SAAS;CAAU,CAAC,IACpE,MACJ,UAAU,WAAW,SACjB,cAAc,QAAQ;EAAE,MAAM;EAAU,SAAS,SAAS;CAAO,CAAC,IAClE,MACJ,cAAc,UAAa,YAAY,SACnC,cAAc,QAAQ;EAAE,UAAU;EAAY,SAAS;CAAQ,CAAC,IAChE,MACJ,cAAc,UAAa,kBAAkB,SACzC,cAAc,QAAQ;EAAE,UAAU;EAAkB,SAAS;CAAc,CAAC,IAC5E,MACJ,WAAW,UAAU,SACjB,cAAc,QAAQ;EAAE,UAAU;EAAY,SAAS,UAAU;CAAM,CAAC,IACxE,MACJ,WAAW,QAAQ,SACf,cAAc,QAAQ;EAAE,UAAU;EAAU,SAAS,UAAU;CAAI,CAAC,IACpE,MACJ,WAAW,SAAS,SAChB,cAAc,QAAQ;EAAE,UAAU;EAAW,SAAS,UAAU;CAAK,CAAC,IACtE,MACJ,SAAS,SAAS,SACd,cAAc,QAAQ;EAAE,MAAM;EAAgB,SAAS,QAAQ;CAAK,CAAC,IACrE,MACJ,SAAS,UAAU,SACf,cAAc,QAAQ;EAAE,MAAM;EAAiB,SAAS,QAAQ;CAAM,CAAC,IACvE,MACJ,SAAS,gBAAgB,SACrB,cAAc,QAAQ;EAAE,MAAM;EAAuB,SAAS,QAAQ;CAAY,CAAC,IACnF,MACJ,SAAS,UAAU,SACf,cAAc,QAAQ;EAAE,MAAM;EAAiB,SAAS,QAAQ;CAAM,CAAC,IACvE,IACN;AACF"}