@pajecawav/yamf 0.0.9 → 0.0.11

package/dist/hooks/useHead.d.ts

@@ -1,17 +1,6 @@
 import { YamfHead } from "../shared/head.js";
-import { ClientUnhead } from "unhead/client";
 import { UseSeoMetaInput } from "unhead/types";
 //#region src/hooks/useHead.d.ts
-interface StreamQueue {
-  _q?: unknown[][];
-  push?: (batch: unknown[]) => void;
-}
-declare global {
-  interface Window {
-    __unhead__?: StreamQueue;
-    __yamfHead__?: ClientUnhead;
-  }
-}
 export declare const useHead: (input?: YamfHead) => void;
 export declare const useSeoMeta: (input?: UseSeoMetaInput) => void;
 //#endregion

package/dist/hooks/useHead.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHead.d.ts","names":[],"sources":["../../src/hooks/useHead.tsx"],"mappings":";;;;UAQU;EACT;EACA,QAAQ;;QAGM;YACJ;IACT,aAAa;IACb,eAAe;;;qBAqEJ,UAAW,QAAQ;qBA0BnB,aAAc,QAAQ"}
+{"version":3,"file":"useHead.d.ts","names":[],"sources":["../../src/hooks/useHead.tsx"],"mappings":";;;qBAkDa,UAAW,QAAQ;qBA0BnB,aAAc,QAAQ"}

package/dist/hooks/useHead.js

@@ -1,18 +1,9 @@
 import { useSSRContext } from "../context/ssr.js";
+import { ensureClientHead } from "../island/head.js";
 import { useEffect, useRef } from "hono/jsx";
 import { useHead, useSeoMeta } from "unhead";
-import { createHead } from "unhead/client";
 //#region src/hooks/useHead.tsx
-if (!import.meta.env.SSR) {
-	const head = createHead();
-	const drain = (batch) => {
-		for (const input of batch) head.push(input);
-	};
-	const queue = window.__unhead__?._q;
-	if (queue) for (const batch of queue) drain(batch);
-	window.__unhead__ = { push: drain };
-	window.__yamfHead__ = head;
-}
+if (!import.meta.env.SSR) ensureClientHead();
 /**
 * Binds an unhead entry to the calling component's lifecycle: the entry is
 * created once on mount, patched on every re-render with the latest input,

package/dist/hooks/useHead.js.map

@@ -1 +1 @@
-{"version":3,"file":"useHead.js","names":["useHead","_useHead","useSeoMeta","_useSeoMeta"],"sources":["../../src/hooks/useHead.tsx"],"sourcesContent":["import { useEffect, useRef } from \"hono/jsx\";\nimport { useHead as _useHead, useSeoMeta as _useSeoMeta } from \"unhead\";\nimport type { ClientUnhead } from \"unhead/client\";\nimport { createHead } from \"unhead/client\";\nimport type { ActiveHeadEntry, ResolvableHead, UseSeoMetaInput } from \"unhead/types\";\nimport { useSSRContext } from \"#/context/ssr\";\nimport type { YamfHead } from \"#/shared/head\";\n\ninterface StreamQueue {\n\t_q?: unknown[][];\n\tpush?: (batch: unknown[]) => void;\n}\n\ndeclare global {\n\tinterface Window {\n\t\t__unhead__?: StreamQueue;\n\t\t__yamfHead__?: ClientUnhead;\n\t}\n}\n\nif (!import.meta.env.SSR) {\n\tconst head = createHead();\n\n\tconst drain = (batch: unknown[]): void => {\n\t\tfor (const input of batch) {\n\t\t\thead.push(input as ResolvableHead);\n\t\t}\n\t};\n\n\t// inline scripts (the handshake payload and streamed suspense patches)\n\t// queue into window.__unhead__ while the document parses; this module is\n\t// part of the deferred client entry and runs after parsing, so by now the\n\t// queue holds everything the server sent — drain it into the client head\n\tconst queue = window.__unhead__?._q;\n\n\tif (queue) {\n\t\tfor (const batch of queue) {\n\t\t\tdrain(batch);\n\t\t}\n\t}\n\n\t// keep late patches (a stream that is still open) working\n\twindow.__unhead__ = { push: drain };\n\n\twindow.__yamfHead__ = head;\n}\n\n/**\n * Binds an unhead entry to the calling component's lifecycle: the entry is\n * created once on mount, patched on every re-render with the latest input,\n * and disposed on unmount. Without this, every re-render pushes a new entry\n * that is never removed — a leak and growing DOM render cost.\n */\nconst useHeadEntryLifecycle = <T,>(\n\tinput: T | undefined,\n\tcreateEntry: (head: ClientUnhead, input: T) => ActiveHeadEntry<T>,\n): void => {\n\tconst entryRef = useRef<ActiveHeadEntry<T> | null>(null);\n\n\tuseEffect(() => {\n\t\tconst head = window.__yamfHead__;\n\n\t\tif (!head || input === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst entry = createEntry(head, input);\n\n\t\tentryRef.current = entry;\n\n\t\treturn () => {\n\t\t\tentry.dispose();\n\t\t\tentryRef.current = null;\n\t\t};\n\t\t// mount-only: the entry is created once per component instance\n\t\t// oxlint-disable-next-line eslint(exhaustive-deps)\n\t}, []);\n\n\tuseEffect(() => {\n\t\tif (input !== undefined) {\n\t\t\tentryRef.current?.patch(input);\n\t\t}\n\t}, [input]);\n};\n\nexport const useHead = (input?: YamfHead): void => {\n\tif (import.meta.env.SSR) {\n\t\tif (input === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst ctx = useSSRContext();\n\n\t\tif (ctx?.head) {\n\t\t\t// the custom `seo` key is yamf sugar for useSeoMeta — process it\n\t\t\t// instead of passing an unknown key down to unhead\n\t\t\tconst { seo, ...rest } = input;\n\n\t\t\tif (seo !== undefined) {\n\t\t\t\t_useSeoMeta(ctx.head, seo);\n\t\t\t}\n\n\t\t\t_useHead(ctx.head, rest);\n\t\t}\n\n\t\treturn;\n\t}\n\n\tuseHeadEntryLifecycle(input, (head, resolved) => _useHead(head, resolved));\n};\n\nexport const useSeoMeta = (input?: UseSeoMetaInput): void => {\n\tif (import.meta.env.SSR) {\n\t\tif (input === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst ctx = useSSRContext();\n\n\t\tif (ctx?.head) {\n\t\t\t_useSeoMeta(ctx.head, input);\n\t\t}\n\n\t\treturn;\n\t}\n\n\tuseHeadEntryLifecycle(input, (head, resolved) => _useSeoMeta(head, resolved));\n};\n"],"mappings":";;;;;AAoBA,IAAI,CAAC,YAAY,IAAI,KAAK;CACzB,MAAM,OAAO,WAAW;CAExB,MAAM,SAAS,UAA2B;EACzC,KAAK,MAAM,SAAS,OACnB,KAAK,KAAK,KAAuB;CAEnC;CAMA,MAAM,QAAQ,OAAO,YAAY;CAEjC,IAAI,OACH,KAAK,MAAM,SAAS,OACnB,MAAM,KAAK;CAKb,OAAO,aAAa,EAAE,MAAM,MAAM;CAElC,OAAO,eAAe;AACvB;;;;;;;AAQA,MAAM,yBACL,OACA,gBACU;CACV,MAAM,WAAW,OAAkC,IAAI;CAEvD,gBAAgB;EACf,MAAM,OAAO,OAAO;EAEpB,IAAI,CAAC,QAAQ,UAAU,KAAA,GACtB;EAGD,MAAM,QAAQ,YAAY,MAAM,KAAK;EAErC,SAAS,UAAU;EAEnB,aAAa;GACZ,MAAM,QAAQ;GACd,SAAS,UAAU;EACpB;CAGD,GAAG,CAAC,CAAC;CAEL,gBAAgB;EACf,IAAI,UAAU,KAAA,GACb,SAAS,SAAS,MAAM,KAAK;CAE/B,GAAG,CAAC,KAAK,CAAC;AACX;AAEA,MAAaA,aAAW,UAA2B;CAClD,IAAI,YAAY,IAAI,KAAK;EACxB,IAAI,UAAU,KAAA,GACb;EAGD,MAAM,MAAM,cAAc;EAE1B,IAAI,KAAK,MAAM;GAGd,MAAM,EAAE,KAAK,GAAG,SAAS;GAEzB,IAAI,QAAQ,KAAA,GACX,WAAY,IAAI,MAAM,GAAG;GAG1B,QAAS,IAAI,MAAM,IAAI;EACxB;EAEA;CACD;CAEA,sBAAsB,QAAQ,MAAM,aAAaC,QAAS,MAAM,QAAQ,CAAC;AAC1E;AAEA,MAAaC,gBAAc,UAAkC;CAC5D,IAAI,YAAY,IAAI,KAAK;EACxB,IAAI,UAAU,KAAA,GACb;EAGD,MAAM,MAAM,cAAc;EAE1B,IAAI,KAAK,MACR,WAAY,IAAI,MAAM,KAAK;EAG5B;CACD;CAEA,sBAAsB,QAAQ,MAAM,aAAaC,WAAY,MAAM,QAAQ,CAAC;AAC7E"}
+{"version":3,"file":"useHead.js","names":["useHead","_useHead","useSeoMeta","_useSeoMeta"],"sources":["../../src/hooks/useHead.tsx"],"sourcesContent":["import { useEffect, useRef } from \"hono/jsx\";\nimport { useHead as _useHead, useSeoMeta as _useSeoMeta } from \"unhead\";\nimport type { ClientUnhead } from \"unhead/client\";\nimport type { ActiveHeadEntry, UseSeoMetaInput } from \"unhead/types\";\nimport { useSSRContext } from \"#/context/ssr\";\nimport { ensureClientHead } from \"#/island/head\";\nimport type { YamfHead } from \"#/shared/head\";\n\nif (!import.meta.env.SSR) {\n\tensureClientHead();\n}\n\n/**\n * Binds an unhead entry to the calling component's lifecycle: the entry is\n * created once on mount, patched on every re-render with the latest input,\n * and disposed on unmount. Without this, every re-render pushes a new entry\n * that is never removed — a leak and growing DOM render cost.\n */\nconst useHeadEntryLifecycle = <T,>(\n\tinput: T | undefined,\n\tcreateEntry: (head: ClientUnhead, input: T) => ActiveHeadEntry<T>,\n): void => {\n\tconst entryRef = useRef<ActiveHeadEntry<T> | null>(null);\n\n\tuseEffect(() => {\n\t\tconst head = window.__yamfHead__;\n\n\t\tif (!head || input === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst entry = createEntry(head, input);\n\n\t\tentryRef.current = entry;\n\n\t\treturn () => {\n\t\t\tentry.dispose();\n\t\t\tentryRef.current = null;\n\t\t};\n\t\t// mount-only: the entry is created once per component instance\n\t\t// oxlint-disable-next-line eslint(exhaustive-deps)\n\t}, []);\n\n\tuseEffect(() => {\n\t\tif (input !== undefined) {\n\t\t\tentryRef.current?.patch(input);\n\t\t}\n\t}, [input]);\n};\n\nexport const useHead = (input?: YamfHead): void => {\n\tif (import.meta.env.SSR) {\n\t\tif (input === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst ctx = useSSRContext();\n\n\t\tif (ctx?.head) {\n\t\t\t// the custom `seo` key is yamf sugar for useSeoMeta — process it\n\t\t\t// instead of passing an unknown key down to unhead\n\t\t\tconst { seo, ...rest } = input;\n\n\t\t\tif (seo !== undefined) {\n\t\t\t\t_useSeoMeta(ctx.head, seo);\n\t\t\t}\n\n\t\t\t_useHead(ctx.head, rest);\n\t\t}\n\n\t\treturn;\n\t}\n\n\tuseHeadEntryLifecycle(input, (head, resolved) => _useHead(head, resolved));\n};\n\nexport const useSeoMeta = (input?: UseSeoMetaInput): void => {\n\tif (import.meta.env.SSR) {\n\t\tif (input === undefined) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst ctx = useSSRContext();\n\n\t\tif (ctx?.head) {\n\t\t\t_useSeoMeta(ctx.head, input);\n\t\t}\n\n\t\treturn;\n\t}\n\n\tuseHeadEntryLifecycle(input, (head, resolved) => _useSeoMeta(head, resolved));\n};\n"],"mappings":";;;;;AAQA,IAAI,CAAC,YAAY,IAAI,KACpB,iBAAiB;;;;;;;AASlB,MAAM,yBACL,OACA,gBACU;CACV,MAAM,WAAW,OAAkC,IAAI;CAEvD,gBAAgB;EACf,MAAM,OAAO,OAAO;EAEpB,IAAI,CAAC,QAAQ,UAAU,KAAA,GACtB;EAGD,MAAM,QAAQ,YAAY,MAAM,KAAK;EAErC,SAAS,UAAU;EAEnB,aAAa;GACZ,MAAM,QAAQ;GACd,SAAS,UAAU;EACpB;CAGD,GAAG,CAAC,CAAC;CAEL,gBAAgB;EACf,IAAI,UAAU,KAAA,GACb,SAAS,SAAS,MAAM,KAAK;CAE/B,GAAG,CAAC,KAAK,CAAC;AACX;AAEA,MAAaA,aAAW,UAA2B;CAClD,IAAI,YAAY,IAAI,KAAK;EACxB,IAAI,UAAU,KAAA,GACb;EAGD,MAAM,MAAM,cAAc;EAE1B,IAAI,KAAK,MAAM;GAGd,MAAM,EAAE,KAAK,GAAG,SAAS;GAEzB,IAAI,QAAQ,KAAA,GACX,WAAY,IAAI,MAAM,GAAG;GAG1B,QAAS,IAAI,MAAM,IAAI;EACxB;EAEA;CACD;CAEA,sBAAsB,QAAQ,MAAM,aAAaC,QAAS,MAAM,QAAQ,CAAC;AAC1E;AAEA,MAAaC,gBAAc,UAAkC;CAC5D,IAAI,YAAY,IAAI,KAAK;EACxB,IAAI,UAAU,KAAA,GACb;EAGD,MAAM,MAAM,cAAc;EAE1B,IAAI,KAAK,MACR,WAAY,IAAI,MAAM,KAAK;EAG5B;CACD;CAEA,sBAAsB,QAAQ,MAAM,aAAaC,WAAY,MAAM,QAAQ,CAAC;AAC7E"}

package/dist/island/client.js

@@ -1,8 +1,10 @@
+import { ensureClientHead } from "./head.js";
 import { jsx } from "hono/jsx/jsx-runtime";
 import { parse } from "devalue";
 import { hydrateRoot } from "hono/jsx/dom/client";
 import { withLeadingSlash } from "ufo";
 //#region src/island/client.tsx
+ensureClientHead();
 const listeners = /* @__PURE__ */ new WeakMap();
 const observer = new IntersectionObserver((entries) => {
 	for (const entry of entries) if (entry.isIntersecting) {
@@ -31,7 +33,8 @@ const requestIdle = (callback) => {
 * element (src/client/index.ts) once this runtime module has been loaded.
 */
 const hydrateIsland = (island) => {
-	const islandProps = parse(island.getAttribute("island-props") ?? "{}");
+	const rawProps = island.getAttribute("island-props");
+	const islandProps = rawProps === null ? [] : parse(rawProps);
 	const islandSrc = island.getAttribute("island-src");
 	const islandEntry = island.getAttribute("island-entry");
 	const islandClient = island.getAttribute("island-client") ?? "load";

package/dist/island/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/island/client.tsx"],"sourcesContent":["import { parse } from \"devalue\";\nimport type { FC } from \"hono/jsx\";\nimport { hydrateRoot } from \"hono/jsx/dom/client\";\nimport { withLeadingSlash } from \"ufo\";\nimport type { IslandClientDirectiveSerialized } from \"./types\";\n\ndeclare let __yamf_raw_import__: <T>(file: string) => Promise<T>;\n\nconst listeners: WeakMap<Element, VoidFunction> = new WeakMap();\n\nconst observer: IntersectionObserver = new IntersectionObserver(entries => {\n\tfor (const entry of entries) {\n\t\tif (entry.isIntersecting) {\n\t\t\tlisteners.get(entry.target)?.();\n\t\t\tunobserve(entry.target);\n\t\t}\n\t}\n});\n\nconst observe = (target: Element, cb: VoidFunction) => {\n\tobserver.observe(target);\n\tlisteners.set(target, cb);\n};\n\nconst unobserve = (target: Element) => {\n\tobserver.unobserve(target);\n\tlisteners.delete(target);\n};\n\n// Safari does not enable requestIdleCallback by default in any stable\n// release — without a fallback, client:idle islands never hydrate there\nconst requestIdle = (callback: () => void): void => {\n\tconst ric = window.requestIdleCallback;\n\n\tif (typeof ric === \"function\") {\n\t\tric(callback);\n\t\treturn;\n\t}\n\n\tsetTimeout(callback, 1);\n};\n\n/**\n * Hydrates a single <yamf-island> island. Called by the bootstrap custom\n * element (src/client/index.ts) once this runtime module has been loaded.\n */\nexport const hydrateIsland = (island: HTMLElement): void => {\n\tconst islandProps = parse(island.getAttribute(\"island-props\") ?? \"{}\");\n\tconst islandSrc = island.getAttribute(\"island-src\");\n\tconst islandEntry = island.getAttribute(\"island-entry\");\n\t// oxlint-disable-next-line typescript/no-unsafe-type-assertion\n\tconst islandClient = (island.getAttribute(\"island-client\") ??\n\t\t\"load\") as IslandClientDirectiveSerialized;\n\n\tif (!islandSrc) {\n\t\tthrow new Error(\"Missing island-src attribute\");\n\t}\n\n\tif (!islandEntry) {\n\t\tthrow new Error(\"Missing island-entry attribute\");\n\t}\n\n\tconst hydrate = (mod: Record<string, FC>) => {\n\t\tconst Comp = mod[islandEntry];\n\n\t\tif (!Comp) {\n\t\t\tthrow new Error(`Missing island entry ${islandEntry} in ${islandSrc}`);\n\t\t}\n\n\t\thydrateRoot(island, <Comp {...islandProps} />);\n\t};\n\n\tconst initIsland = () => {\n\t\tconst src = withLeadingSlash(islandSrc);\n\t\tvoid __yamf_raw_import__<Record<string, FC>>(src).then(hydrate);\n\t};\n\n\tswitch (islandClient) {\n\t\tcase \"true\":\n\t\tcase \"load\":\n\t\t\tinitIsland();\n\t\t\tbreak;\n\t\tcase \"idle\":\n\t\t\trequestIdle(initIsland);\n\t\t\tbreak;\n\t\tcase \"visible\":\n\t\t\t// yamf-island has `display: contents` which breaks IntersectionObserver\n\t\t\t// so we have to observe the first child instead if it exists\n\t\t\tif (island.firstElementChild) {\n\t\t\t\tobserve(island.firstElementChild, initIsland);\n\t\t\t} else {\n\t\t\t\tinitIsland();\n\t\t\t}\n\t\t\tbreak;\n\t\tcase \"false\":\n\t\tcase \"skip\":\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tislandClient satisfies never;\n\t\t\t// oxlint-disable-next-line typescript/restrict-template-expressions\n\t\t\tthrow new Error(`Invalid island-client value: ${islandClient}`);\n\t}\n};\n"],"mappings":";;;;;AAQA,MAAM,4BAA4C,IAAI,QAAQ;AAE9D,MAAM,WAAiC,IAAI,sBAAqB,YAAW;CAC1E,KAAK,MAAM,SAAS,SACnB,IAAI,MAAM,gBAAgB;EACzB,UAAU,IAAI,MAAM,MAAM,CAAC,GAAG;EAC9B,UAAU,MAAM,MAAM;CACvB;AAEF,CAAC;AAED,MAAM,WAAW,QAAiB,OAAqB;CACtD,SAAS,QAAQ,MAAM;CACvB,UAAU,IAAI,QAAQ,EAAE;AACzB;AAEA,MAAM,aAAa,WAAoB;CACtC,SAAS,UAAU,MAAM;CACzB,UAAU,OAAO,MAAM;AACxB;AAIA,MAAM,eAAe,aAA+B;CACnD,MAAM,MAAM,OAAO;CAEnB,IAAI,OAAO,QAAQ,YAAY;EAC9B,IAAI,QAAQ;EACZ;CACD;CAEA,WAAW,UAAU,CAAC;AACvB;;;;;AAMA,MAAa,iBAAiB,WAA8B;CAC3D,MAAM,cAAc,MAAM,OAAO,aAAa,cAAc,KAAK,IAAI;CACrE,MAAM,YAAY,OAAO,aAAa,YAAY;CAClD,MAAM,cAAc,OAAO,aAAa,cAAc;CAEtD,MAAM,eAAgB,OAAO,aAAa,eAAe,KACxD;CAED,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,8BAA8B;CAG/C,IAAI,CAAC,aACJ,MAAM,IAAI,MAAM,gCAAgC;CAGjD,MAAM,WAAW,QAA4B;EAC5C,MAAM,OAAO,IAAI;EAEjB,IAAI,CAAC,MACJ,MAAM,IAAI,MAAM,wBAAwB,YAAY,MAAM,WAAW;EAGtE,YAAY,QAAQ,oBAAC,MAAD,EAAM,GAAI,YAAc,CAAA,CAAC;CAC9C;CAEA,MAAM,mBAAmB;EACxB,MAAM,MAAM,iBAAiB,SAAS;EACtC,oBAA6C,GAAG,CAAC,CAAC,KAAK,OAAO;CAC/D;CAEA,QAAQ,cAAR;EACC,KAAK;EACL,KAAK;GACJ,WAAW;GACX;EACD,KAAK;GACJ,YAAY,UAAU;GACtB;EACD,KAAK;GAGJ,IAAI,OAAO,mBACV,QAAQ,OAAO,mBAAmB,UAAU;QAE5C,WAAW;GAEZ;EACD,KAAK;EACL,KAAK,QACJ;EACD,SAGC,MAAM,IAAI,MAAM,gCAAgC,cAAc;CAChE;AACD"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/island/client.tsx"],"sourcesContent":["import { parse } from \"devalue\";\nimport type { FC } from \"hono/jsx\";\nimport { hydrateRoot } from \"hono/jsx/dom/client\";\nimport { withLeadingSlash } from \"ufo\";\nimport { ensureClientHead } from \"./head\";\nimport type { IslandClientDirectiveSerialized } from \"./types\";\n\ndeclare let __yamf_raw_import__: <T>(file: string) => Promise<T>;\n\n// this runtime loads whenever a page contains islands — set up the client\n// head here so the handshake payload and streamed head patches actually\n// apply, even when nothing imports the useHead hook\nensureClientHead();\n\nconst listeners: WeakMap<Element, VoidFunction> = new WeakMap();\n\nconst observer: IntersectionObserver = new IntersectionObserver(entries => {\n\tfor (const entry of entries) {\n\t\tif (entry.isIntersecting) {\n\t\t\tlisteners.get(entry.target)?.();\n\t\t\tunobserve(entry.target);\n\t\t}\n\t}\n});\n\nconst observe = (target: Element, cb: VoidFunction) => {\n\tobserver.observe(target);\n\tlisteners.set(target, cb);\n};\n\nconst unobserve = (target: Element) => {\n\tobserver.unobserve(target);\n\tlisteners.delete(target);\n};\n\n// Safari does not enable requestIdleCallback by default in any stable\n// release — without a fallback, client:idle islands never hydrate there\nconst requestIdle = (callback: () => void): void => {\n\tconst ric = window.requestIdleCallback;\n\n\tif (typeof ric === \"function\") {\n\t\tric(callback);\n\t\treturn;\n\t}\n\n\tsetTimeout(callback, 1);\n};\n\n/**\n * Hydrates a single <yamf-island> island. Called by the bootstrap custom\n * element (src/client/index.ts) once this runtime module has been loaded.\n */\nexport const hydrateIsland = (island: HTMLElement): void => {\n\t// skip islands omit the attribute entirely — parse after (and only if) it\n\t// exists, otherwise parse(\"{}\") would throw \"Invalid input\" and abort the\n\t// whole pending-hydration loop\n\tconst rawProps = island.getAttribute(\"island-props\");\n\tconst islandProps = rawProps === null ? [] : parse(rawProps);\n\tconst islandSrc = island.getAttribute(\"island-src\");\n\tconst islandEntry = island.getAttribute(\"island-entry\");\n\t// oxlint-disable-next-line typescript/no-unsafe-type-assertion\n\tconst islandClient = (island.getAttribute(\"island-client\") ??\n\t\t\"load\") as IslandClientDirectiveSerialized;\n\n\tif (!islandSrc) {\n\t\tthrow new Error(\"Missing island-src attribute\");\n\t}\n\n\tif (!islandEntry) {\n\t\tthrow new Error(\"Missing island-entry attribute\");\n\t}\n\n\tconst hydrate = (mod: Record<string, FC>) => {\n\t\tconst Comp = mod[islandEntry];\n\n\t\tif (!Comp) {\n\t\t\tthrow new Error(`Missing island entry ${islandEntry} in ${islandSrc}`);\n\t\t}\n\n\t\thydrateRoot(island, <Comp {...islandProps} />);\n\t};\n\n\tconst initIsland = () => {\n\t\tconst src = withLeadingSlash(islandSrc);\n\t\tvoid __yamf_raw_import__<Record<string, FC>>(src).then(hydrate);\n\t};\n\n\tswitch (islandClient) {\n\t\tcase \"true\":\n\t\tcase \"load\":\n\t\t\tinitIsland();\n\t\t\tbreak;\n\t\tcase \"idle\":\n\t\t\trequestIdle(initIsland);\n\t\t\tbreak;\n\t\tcase \"visible\":\n\t\t\t// yamf-island has `display: contents` which breaks IntersectionObserver\n\t\t\t// so we have to observe the first child instead if it exists\n\t\t\tif (island.firstElementChild) {\n\t\t\t\tobserve(island.firstElementChild, initIsland);\n\t\t\t} else {\n\t\t\t\tinitIsland();\n\t\t\t}\n\t\t\tbreak;\n\t\tcase \"false\":\n\t\tcase \"skip\":\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tislandClient satisfies never;\n\t\t\t// oxlint-disable-next-line typescript/restrict-template-expressions\n\t\t\tthrow new Error(`Invalid island-client value: ${islandClient}`);\n\t}\n};\n"],"mappings":";;;;;;AAYA,iBAAiB;AAEjB,MAAM,4BAA4C,IAAI,QAAQ;AAE9D,MAAM,WAAiC,IAAI,sBAAqB,YAAW;CAC1E,KAAK,MAAM,SAAS,SACnB,IAAI,MAAM,gBAAgB;EACzB,UAAU,IAAI,MAAM,MAAM,CAAC,GAAG;EAC9B,UAAU,MAAM,MAAM;CACvB;AAEF,CAAC;AAED,MAAM,WAAW,QAAiB,OAAqB;CACtD,SAAS,QAAQ,MAAM;CACvB,UAAU,IAAI,QAAQ,EAAE;AACzB;AAEA,MAAM,aAAa,WAAoB;CACtC,SAAS,UAAU,MAAM;CACzB,UAAU,OAAO,MAAM;AACxB;AAIA,MAAM,eAAe,aAA+B;CACnD,MAAM,MAAM,OAAO;CAEnB,IAAI,OAAO,QAAQ,YAAY;EAC9B,IAAI,QAAQ;EACZ;CACD;CAEA,WAAW,UAAU,CAAC;AACvB;;;;;AAMA,MAAa,iBAAiB,WAA8B;CAI3D,MAAM,WAAW,OAAO,aAAa,cAAc;CACnD,MAAM,cAAc,aAAa,OAAO,CAAC,IAAI,MAAM,QAAQ;CAC3D,MAAM,YAAY,OAAO,aAAa,YAAY;CAClD,MAAM,cAAc,OAAO,aAAa,cAAc;CAEtD,MAAM,eAAgB,OAAO,aAAa,eAAe,KACxD;CAED,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,8BAA8B;CAG/C,IAAI,CAAC,aACJ,MAAM,IAAI,MAAM,gCAAgC;CAGjD,MAAM,WAAW,QAA4B;EAC5C,MAAM,OAAO,IAAI;EAEjB,IAAI,CAAC,MACJ,MAAM,IAAI,MAAM,wBAAwB,YAAY,MAAM,WAAW;EAGtE,YAAY,QAAQ,oBAAC,MAAD,EAAM,GAAI,YAAc,CAAA,CAAC;CAC9C;CAEA,MAAM,mBAAmB;EACxB,MAAM,MAAM,iBAAiB,SAAS;EACtC,oBAA6C,GAAG,CAAC,CAAC,KAAK,OAAO;CAC/D;CAEA,QAAQ,cAAR;EACC,KAAK;EACL,KAAK;GACJ,WAAW;GACX;EACD,KAAK;GACJ,YAAY,UAAU;GACtB;EACD,KAAK;GAGJ,IAAI,OAAO,mBACV,QAAQ,OAAO,mBAAmB,UAAU;QAE5C,WAAW;GAEZ;EACD,KAAK;EACL,KAAK,QACJ;EACD,SAGC,MAAM,IAAI,MAAM,gCAAgC,cAAc;CAChE;AACD"}

package/dist/island/head.js

@@ -0,0 +1,27 @@
+import { createHead } from "unhead/client";
+//#region src/island/head.ts
+/**
+* Creates the client head, drains everything the server streamed into
+* `window.__unhead__` (the handshake payload and streamed suspense patches)
+* and upgrades the stub so late patches from an open stream keep applying.
+*
+* Idempotent: it is called from the island hydration runtime (which loads
+* whenever a page contains islands) and from the `useHead` hook module —
+* whichever runs first wins.
+*/
+const ensureClientHead = () => {
+	if (window.__yamfHead__) return window.__yamfHead__;
+	const head = createHead();
+	const drain = (batch) => {
+		for (const input of batch) head.push(input);
+	};
+	const queue = window.__unhead__?._q;
+	if (queue) for (const batch of queue) drain(batch);
+	window.__unhead__ = { push: drain };
+	window.__yamfHead__ = head;
+	return head;
+};
+//#endregion
+export { ensureClientHead };
+
+//# sourceMappingURL=head.js.map

package/dist/island/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","names":[],"sources":["../../src/island/head.ts"],"sourcesContent":["import { createHead } from \"unhead/client\";\nimport type { ClientUnhead } from \"unhead/client\";\nimport type { ResolvableHead } from \"unhead/types\";\n\ninterface StreamQueue {\n\t_q?: unknown[][];\n\tpush?: (batch: unknown[]) => void;\n}\n\ndeclare global {\n\tinterface Window {\n\t\t__unhead__?: StreamQueue;\n\t\t__yamfHead__?: ClientUnhead;\n\t}\n}\n\n/**\n * Creates the client head, drains everything the server streamed into\n * `window.__unhead__` (the handshake payload and streamed suspense patches)\n * and upgrades the stub so late patches from an open stream keep applying.\n *\n * Idempotent: it is called from the island hydration runtime (which loads\n * whenever a page contains islands) and from the `useHead` hook module —\n * whichever runs first wins.\n */\nexport const ensureClientHead = (): ClientUnhead => {\n\tif (window.__yamfHead__) {\n\t\treturn window.__yamfHead__;\n\t}\n\n\tconst head = createHead();\n\n\tconst drain = (batch: unknown[]): void => {\n\t\tfor (const input of batch) {\n\t\t\thead.push(input as ResolvableHead);\n\t\t}\n\t};\n\n\t// inline scripts (the handshake payload and streamed suspense patches)\n\t// queue into window.__unhead__ while the document parses; drain them into\n\t// the client head\n\tconst queue = window.__unhead__?._q;\n\n\tif (queue) {\n\t\tfor (const batch of queue) {\n\t\t\tdrain(batch);\n\t\t}\n\t}\n\n\t// keep late patches (a stream that is still open) working\n\twindow.__unhead__ = { push: drain };\n\n\twindow.__yamfHead__ = head;\n\n\treturn head;\n};\n"],"mappings":";;;;;;;;;;;AAyBA,MAAa,yBAAuC;CACnD,IAAI,OAAO,cACV,OAAO,OAAO;CAGf,MAAM,OAAO,WAAW;CAExB,MAAM,SAAS,UAA2B;EACzC,KAAK,MAAM,SAAS,OACnB,KAAK,KAAK,KAAuB;CAEnC;CAKA,MAAM,QAAQ,OAAO,YAAY;CAEjC,IAAI,OACH,KAAK,MAAM,SAAS,OACnB,MAAM,KAAK;CAKb,OAAO,aAAa,EAAE,MAAM,MAAM;CAElC,OAAO,eAAe;CAEtB,OAAO;AACR"}

package/dist/server/entry.mjs

@@ -13,7 +13,7 @@ for (const [relativePath, handler] of Object.entries(pages).toSorted((a, b) => a
 	const ext = path.extname(relativePath);
 	let route = path.relative("/src/pages", relativePath);
 	if (ext.length) route = route.slice(0, -ext.length);
-	route = route.replace(/\.[A-Za-z]+$/, "").replace(/\(([^(/\\]+)\)[/\\]/g, "").replace(/\[\.{3}]/g, "**").replace(/\[\.{3}([^\]]+)]/g, (_, p) => "**:" + p.replace(/[^\w-]/g, "_")).replace(/\[([^/\]]+)]/g, (_, p) => ":" + p.replace(/[^\w-]/g, "_")).replace(/(\/|^)index$/, "") || "/";
+	route = route.replace(/\.[A-Za-z]+$/, "").replace(/\(([^(/\\]+)\)[/\\]/g, "").replace(/\[\.{3}]/g, "**").replace(/\[\.{3}([^\]]+)]/g, (_, p) => "**:" + p.replace(/[^\w]/g, "_")).replace(/\[([^/\]]+)]/g, (_, p) => ":" + p.replace(/[^\w]/g, "_")).replace(/(\/|^)index$/, "") || "/";
 	route = withLeadingSlash(withoutTrailingSlash(route));
 	const conflictingFile = registeredRoutes.get(route);
 	if (conflictingFile && conflictingFile !== relativePath) console.warn(`[yamf] duplicate page route "${route}": ${conflictingFile} and ${relativePath} both map to it — the routes conflict`);

package/dist/server/entry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"entry.mjs","names":["pagesServerAssets"],"sources":["../../src/server/entry.tsx"],"sourcesContent":["import path from \"node:path\";\nimport {\n\tdefineHandler,\n\tEventHandler,\n\tH3Event,\n\tHTTPError,\n\twriteEarlyHints,\n\ttype EventHandlerRequest,\n\ttype EventHandlerWithFetch,\n} from \"nitro/h3\";\nimport { addRoute, createRouter, findRoute } from \"rou3\";\nimport { withLeadingSlash, withoutTrailingSlash } from \"ufo\";\nimport { clientAssets } from \"virtual:yamf:assets\";\nimport { errorHandler } from \"virtual:yamf:error-handler\";\nimport { pages, assets as pagesServerAssets } from \"virtual:yamf:pages\";\nimport { rootAssets } from \"virtual:yamf:root\";\nimport type { PageHandler } from \"#/page\";\nimport { YamfHead } from \"#/shared/head\";\n\ninterface Route {\n\thandler: () => Promise<PageHandler>;\n\tserverAssets?: ImportAssetsResult;\n}\n\nconst router = createRouter<Route>();\n\nconst registeredRoutes = new Map<string, string>();\n\nfor (const [relativePath, handler] of Object.entries(pages).toSorted((a, b) =>\n\ta[0].localeCompare(b[0]),\n)) {\n\tconst ext = path.extname(relativePath);\n\n\tlet route = path.relative(\"/src/pages\", relativePath);\n\n\tif (ext.length) {\n\t\troute = route.slice(0, -ext.length);\n\t}\n\n\troute =\n\t\troute\n\t\t\t.replace(/\\.[A-Za-z]+$/, \"\")\n\t\t\t.replace(/\\(([^(/\\\\]+)\\)[/\\\\]/g, \"\")\n\t\t\t.replace(/\\[\\.{3}]/g, \"**\")\n\t\t\t.replace(/\\[\\.{3}([^\\]]+)]/g, (_, p: string) => \"**:\" + p.replace(/[^\\w-]/g, \"_\"))\n\t\t\t.replace(/\\[([^/\\]]+)]/g, (_, p: string) => \":\" + p.replace(/[^\\w-]/g, \"_\"))\n\t\t\t.replace(/(\\/|^)index$/, \"\") || \"/\";\n\n\troute = withLeadingSlash(withoutTrailingSlash(route));\n\n\tconst conflictingFile = registeredRoutes.get(route);\n\n\tif (conflictingFile && conflictingFile !== relativePath) {\n\t\tconsole.warn(\n\t\t\t`[yamf] duplicate page route \"${route}\": ${conflictingFile} and ${relativePath} both map to it — the routes conflict`,\n\t\t);\n\t}\n\n\tregisteredRoutes.set(route, relativePath);\n\n\taddRoute(router, \"GET\", route, {\n\t\thandler,\n\t\tserverAssets: pagesServerAssets[relativePath],\n\t});\n}\n\nexport type ServerEntry = EventHandlerWithFetch<EventHandlerRequest, Promise<unknown>>;\n\nexport interface DefineServerEntryOptions {\n\thead?: YamfHead | ((event: H3Event) => YamfHead);\n\tdisableEarlyHints?: boolean;\n\t/**\n\t * CSP nonce for the inline scripts yamf injects (head handshake payload\n\t * and streamed head patches).\n\t *\n\t * Note: unhead's stream bootstrap script (`window.__unhead__||(…)`) does\n\t * not support a nonce in unhead 3.x — with a strict `script-src` CSP it\n\t * must be allowed separately (e.g. via a hash).\n\t */\n\tnonce?: string | ((event: H3Event) => string | undefined);\n}\n\nexport const defineServerEntry = (options?: DefineServerEntryOptions): ServerEntry => {\n\tconst rootHandler: EventHandler<EventHandlerRequest, Promise<unknown>> = async event => {\n\t\tconst route = findRoute(router, \"GET\", event.url.pathname);\n\n\t\tif (!route) {\n\t\t\tthrow new HTTPError(\"Not found\", { status: 404 });\n\t\t}\n\n\t\tconst { handler, serverAssets } = route.data;\n\t\tevent.context.params = route.params;\n\n\t\tconst assets = clientAssets.merge(...[rootAssets, serverAssets].filter(x => !!x));\n\n\t\t// early hints are pointless inside the prerender worker — nitro's\n\t\t// prerenderer buffers the response to a file and discards them\n\t\tif (!options?.disableEarlyHints && !event.req.headers.has(\"x-nitro-prerender\")) {\n\t\t\tconst link = [\n\t\t\t\t...assets.js.map(script => `<${script.href}>; rel=modulepreload`),\n\t\t\t\t...assets.css.map(style => `<${style.href}>; rel=preload; as=style`),\n\t\t\t];\n\n\t\t\tif (link.length) {\n\t\t\t\tawait writeEarlyHints(event, { link });\n\t\t\t}\n\t\t}\n\n\t\treturn (await handler())(event, {\n\t\t\tassets,\n\t\t\thead: typeof options?.head === \"function\" ? options.head(event) : options?.head,\n\t\t\tnonce: typeof options?.nonce === \"function\" ? options.nonce(event) : options?.nonce,\n\t\t});\n\t};\n\n\treturn defineHandler(async event => {\n\t\tif (!errorHandler) {\n\t\t\treturn rootHandler(event);\n\t\t}\n\n\t\ttry {\n\t\t\treturn await rootHandler(event);\n\t\t} catch (error) {\n\t\t\tconst httpError = error instanceof HTTPError ? error : new HTTPError({ cause: error });\n\n\t\t\treturn errorHandler(httpError, event);\n\t\t}\n\t});\n};\n"],"mappings":";;;;;;;;;AAwBA,MAAM,SAAS,aAAoB;AAEnC,MAAM,mCAAmB,IAAI,IAAoB;AAEjD,KAAK,MAAM,CAAC,cAAc,YAAY,OAAO,QAAQ,KAAK,CAAC,CAAC,UAAU,GAAG,MACxE,EAAE,EAAE,CAAC,cAAc,EAAE,EAAE,CACxB,GAAG;CACF,MAAM,MAAM,KAAK,QAAQ,YAAY;CAErC,IAAI,QAAQ,KAAK,SAAS,cAAc,YAAY;CAEpD,IAAI,IAAI,QACP,QAAQ,MAAM,MAAM,GAAG,CAAC,IAAI,MAAM;CAGnC,QACC,MACE,QAAQ,gBAAgB,EAAE,CAAC,CAC3B,QAAQ,wBAAwB,EAAE,CAAC,CACnC,QAAQ,aAAa,IAAI,CAAC,CAC1B,QAAQ,sBAAsB,GAAG,MAAc,QAAQ,EAAE,QAAQ,WAAW,GAAG,CAAC,CAAC,CACjF,QAAQ,kBAAkB,GAAG,MAAc,MAAM,EAAE,QAAQ,WAAW,GAAG,CAAC,CAAC,CAC3E,QAAQ,gBAAgB,EAAE,KAAK;CAElC,QAAQ,iBAAiB,qBAAqB,KAAK,CAAC;CAEpD,MAAM,kBAAkB,iBAAiB,IAAI,KAAK;CAElD,IAAI,mBAAmB,oBAAoB,cAC1C,QAAQ,KACP,gCAAgC,MAAM,KAAK,gBAAgB,OAAO,aAAa,sCAChF;CAGD,iBAAiB,IAAI,OAAO,YAAY;CAExC,SAAS,QAAQ,OAAO,OAAO;EAC9B;EACA,cAAcA,OAAkB;CACjC,CAAC;AACF;AAkBA,MAAa,qBAAqB,YAAoD;CACrF,MAAM,cAAmE,OAAM,UAAS;EACvF,MAAM,QAAQ,UAAU,QAAQ,OAAO,MAAM,IAAI,QAAQ;EAEzD,IAAI,CAAC,OACJ,MAAM,IAAI,UAAU,aAAa,EAAE,QAAQ,IAAI,CAAC;EAGjD,MAAM,EAAE,SAAS,iBAAiB,MAAM;EACxC,MAAM,QAAQ,SAAS,MAAM;EAE7B,MAAM,SAAS,aAAa,MAAM,GAAG,CAAC,YAAY,YAAY,CAAC,CAAC,QAAO,MAAK,CAAC,CAAC,CAAC,CAAC;EAIhF,IAAI,CAAC,SAAS,qBAAqB,CAAC,MAAM,IAAI,QAAQ,IAAI,mBAAmB,GAAG;GAC/E,MAAM,OAAO,CACZ,GAAG,OAAO,GAAG,KAAI,WAAU,IAAI,OAAO,KAAK,qBAAqB,GAChE,GAAG,OAAO,IAAI,KAAI,UAAS,IAAI,MAAM,KAAK,yBAAyB,CACpE;GAEA,IAAI,KAAK,QACR,MAAM,gBAAgB,OAAO,EAAE,KAAK,CAAC;EAEvC;EAEA,QAAQ,MAAM,QAAQ,EAAA,CAAG,OAAO;GAC/B;GACA,MAAM,OAAO,SAAS,SAAS,aAAa,QAAQ,KAAK,KAAK,IAAI,SAAS;GAC3E,OAAO,OAAO,SAAS,UAAU,aAAa,QAAQ,MAAM,KAAK,IAAI,SAAS;EAC/E,CAAC;CACF;CAEA,OAAO,cAAc,OAAM,UAAS;EACnC,IAAI,CAAC,cACJ,OAAO,YAAY,KAAK;EAGzB,IAAI;GACH,OAAO,MAAM,YAAY,KAAK;EAC/B,SAAS,OAAO;GACf,MAAM,YAAY,iBAAiB,YAAY,QAAQ,IAAI,UAAU,EAAE,OAAO,MAAM,CAAC;GAErF,OAAO,aAAa,WAAW,KAAK;EACrC;CACD,CAAC;AACF"}
+{"version":3,"file":"entry.mjs","names":["pagesServerAssets"],"sources":["../../src/server/entry.tsx"],"sourcesContent":["import path from \"node:path\";\nimport {\n\tdefineHandler,\n\tEventHandler,\n\tH3Event,\n\tHTTPError,\n\twriteEarlyHints,\n\ttype EventHandlerRequest,\n\ttype EventHandlerWithFetch,\n} from \"nitro/h3\";\nimport { addRoute, createRouter, findRoute } from \"rou3\";\nimport { withLeadingSlash, withoutTrailingSlash } from \"ufo\";\nimport { clientAssets } from \"virtual:yamf:assets\";\nimport { errorHandler } from \"virtual:yamf:error-handler\";\nimport { pages, assets as pagesServerAssets } from \"virtual:yamf:pages\";\nimport { rootAssets } from \"virtual:yamf:root\";\nimport type { PageHandler } from \"#/page\";\nimport { YamfHead } from \"#/shared/head\";\n\ninterface Route {\n\thandler: () => Promise<PageHandler>;\n\tserverAssets?: ImportAssetsResult;\n}\n\nconst router = createRouter<Route>();\n\nconst registeredRoutes = new Map<string, string>();\n\nfor (const [relativePath, handler] of Object.entries(pages).toSorted((a, b) =>\n\ta[0].localeCompare(b[0]),\n)) {\n\tconst ext = path.extname(relativePath);\n\n\tlet route = path.relative(\"/src/pages\", relativePath);\n\n\tif (ext.length) {\n\t\troute = route.slice(0, -ext.length);\n\t}\n\n\troute =\n\t\troute\n\t\t\t.replace(/\\.[A-Za-z]+$/, \"\")\n\t\t\t.replace(/\\(([^(/\\\\]+)\\)[/\\\\]/g, \"\")\n\t\t\t.replace(/\\[\\.{3}]/g, \"**\")\n\t\t\t.replace(/\\[\\.{3}([^\\]]+)]/g, (_, p: string) => \"**:\" + p.replace(/[^\\w]/g, \"_\"))\n\t\t\t.replace(/\\[([^/\\]]+)]/g, (_, p: string) => \":\" + p.replace(/[^\\w]/g, \"_\"))\n\t\t\t.replace(/(\\/|^)index$/, \"\") || \"/\";\n\n\troute = withLeadingSlash(withoutTrailingSlash(route));\n\n\tconst conflictingFile = registeredRoutes.get(route);\n\n\tif (conflictingFile && conflictingFile !== relativePath) {\n\t\tconsole.warn(\n\t\t\t`[yamf] duplicate page route \"${route}\": ${conflictingFile} and ${relativePath} both map to it — the routes conflict`,\n\t\t);\n\t}\n\n\tregisteredRoutes.set(route, relativePath);\n\n\taddRoute(router, \"GET\", route, {\n\t\thandler,\n\t\tserverAssets: pagesServerAssets[relativePath],\n\t});\n}\n\nexport type ServerEntry = EventHandlerWithFetch<EventHandlerRequest, Promise<unknown>>;\n\nexport interface DefineServerEntryOptions {\n\thead?: YamfHead | ((event: H3Event) => YamfHead);\n\tdisableEarlyHints?: boolean;\n\t/**\n\t * CSP nonce for the inline scripts yamf injects (head handshake payload\n\t * and streamed head patches).\n\t *\n\t * Note: unhead's stream bootstrap script (`window.__unhead__||(…)`) does\n\t * not support a nonce in unhead 3.x — with a strict `script-src` CSP it\n\t * must be allowed separately (e.g. via a hash).\n\t */\n\tnonce?: string | ((event: H3Event) => string | undefined);\n}\n\nexport const defineServerEntry = (options?: DefineServerEntryOptions): ServerEntry => {\n\tconst rootHandler: EventHandler<EventHandlerRequest, Promise<unknown>> = async event => {\n\t\tconst route = findRoute(router, \"GET\", event.url.pathname);\n\n\t\tif (!route) {\n\t\t\tthrow new HTTPError(\"Not found\", { status: 404 });\n\t\t}\n\n\t\tconst { handler, serverAssets } = route.data;\n\t\tevent.context.params = route.params;\n\n\t\tconst assets = clientAssets.merge(...[rootAssets, serverAssets].filter(x => !!x));\n\n\t\t// early hints are pointless inside the prerender worker — nitro's\n\t\t// prerenderer buffers the response to a file and discards them\n\t\tif (!options?.disableEarlyHints && !event.req.headers.has(\"x-nitro-prerender\")) {\n\t\t\tconst link = [\n\t\t\t\t...assets.js.map(script => `<${script.href}>; rel=modulepreload`),\n\t\t\t\t...assets.css.map(style => `<${style.href}>; rel=preload; as=style`),\n\t\t\t];\n\n\t\t\tif (link.length) {\n\t\t\t\tawait writeEarlyHints(event, { link });\n\t\t\t}\n\t\t}\n\n\t\treturn (await handler())(event, {\n\t\t\tassets,\n\t\t\thead: typeof options?.head === \"function\" ? options.head(event) : options?.head,\n\t\t\tnonce: typeof options?.nonce === \"function\" ? options.nonce(event) : options?.nonce,\n\t\t});\n\t};\n\n\treturn defineHandler(async event => {\n\t\tif (!errorHandler) {\n\t\t\treturn rootHandler(event);\n\t\t}\n\n\t\ttry {\n\t\t\treturn await rootHandler(event);\n\t\t} catch (error) {\n\t\t\tconst httpError = error instanceof HTTPError ? error : new HTTPError({ cause: error });\n\n\t\t\treturn errorHandler(httpError, event);\n\t\t}\n\t});\n};\n"],"mappings":";;;;;;;;;AAwBA,MAAM,SAAS,aAAoB;AAEnC,MAAM,mCAAmB,IAAI,IAAoB;AAEjD,KAAK,MAAM,CAAC,cAAc,YAAY,OAAO,QAAQ,KAAK,CAAC,CAAC,UAAU,GAAG,MACxE,EAAE,EAAE,CAAC,cAAc,EAAE,EAAE,CACxB,GAAG;CACF,MAAM,MAAM,KAAK,QAAQ,YAAY;CAErC,IAAI,QAAQ,KAAK,SAAS,cAAc,YAAY;CAEpD,IAAI,IAAI,QACP,QAAQ,MAAM,MAAM,GAAG,CAAC,IAAI,MAAM;CAGnC,QACC,MACE,QAAQ,gBAAgB,EAAE,CAAC,CAC3B,QAAQ,wBAAwB,EAAE,CAAC,CACnC,QAAQ,aAAa,IAAI,CAAC,CAC1B,QAAQ,sBAAsB,GAAG,MAAc,QAAQ,EAAE,QAAQ,UAAU,GAAG,CAAC,CAAC,CAChF,QAAQ,kBAAkB,GAAG,MAAc,MAAM,EAAE,QAAQ,UAAU,GAAG,CAAC,CAAC,CAC1E,QAAQ,gBAAgB,EAAE,KAAK;CAElC,QAAQ,iBAAiB,qBAAqB,KAAK,CAAC;CAEpD,MAAM,kBAAkB,iBAAiB,IAAI,KAAK;CAElD,IAAI,mBAAmB,oBAAoB,cAC1C,QAAQ,KACP,gCAAgC,MAAM,KAAK,gBAAgB,OAAO,aAAa,sCAChF;CAGD,iBAAiB,IAAI,OAAO,YAAY;CAExC,SAAS,QAAQ,OAAO,OAAO;EAC9B;EACA,cAAcA,OAAkB;CACjC,CAAC;AACF;AAkBA,MAAa,qBAAqB,YAAoD;CACrF,MAAM,cAAmE,OAAM,UAAS;EACvF,MAAM,QAAQ,UAAU,QAAQ,OAAO,MAAM,IAAI,QAAQ;EAEzD,IAAI,CAAC,OACJ,MAAM,IAAI,UAAU,aAAa,EAAE,QAAQ,IAAI,CAAC;EAGjD,MAAM,EAAE,SAAS,iBAAiB,MAAM;EACxC,MAAM,QAAQ,SAAS,MAAM;EAE7B,MAAM,SAAS,aAAa,MAAM,GAAG,CAAC,YAAY,YAAY,CAAC,CAAC,QAAO,MAAK,CAAC,CAAC,CAAC,CAAC;EAIhF,IAAI,CAAC,SAAS,qBAAqB,CAAC,MAAM,IAAI,QAAQ,IAAI,mBAAmB,GAAG;GAC/E,MAAM,OAAO,CACZ,GAAG,OAAO,GAAG,KAAI,WAAU,IAAI,OAAO,KAAK,qBAAqB,GAChE,GAAG,OAAO,IAAI,KAAI,UAAS,IAAI,MAAM,KAAK,yBAAyB,CACpE;GAEA,IAAI,KAAK,QACR,MAAM,gBAAgB,OAAO,EAAE,KAAK,CAAC;EAEvC;EAEA,QAAQ,MAAM,QAAQ,EAAA,CAAG,OAAO;GAC/B;GACA,MAAM,OAAO,SAAS,SAAS,aAAa,QAAQ,KAAK,KAAK,IAAI,SAAS;GAC3E,OAAO,OAAO,SAAS,UAAU,aAAa,QAAQ,MAAM,KAAK,IAAI,SAAS;EAC/E,CAAC;CACF;CAEA,OAAO,cAAc,OAAM,UAAS;EACnC,IAAI,CAAC,cACJ,OAAO,YAAY,KAAK;EAGzB,IAAI;GACH,OAAO,MAAM,YAAY,KAAK;EAC/B,SAAS,OAAO;GACf,MAAM,YAAY,iBAAiB,YAAY,QAAQ,IAAI,UAAU,EAAE,OAAO,MAAM,CAAC;GAErF,OAAO,aAAa,WAAW,KAAK;EACrC;CACD,CAAC;AACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pajecawav/yamf",
   "type": "module",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Yet another meta framework",
   "license": "MIT",
   "homepage": "https://github.com/pajecawav/yamf#readme",
@@ -43,30 +43,30 @@
     "@hono/react-compat": "^0.0.3",
     "@standard-schema/spec": "^1.1.0",
     "devalue": "^6.0.2",
-    "exsolve": "^1.1.1",
+    "exsolve": "^1.1.3",
     "nitro": "3.0.260903-beta",
     "rolldown-string": "^0.3.1",
-    "rou3": "^0.9.2",
+    "rou3": "^1.0.0",
     "ufo": "^1.6.4",
-    "unhead": "^3.4.1",
-    "wouter": "^3.11.0"
+    "unhead": "^3.4.2",
+    "wouter": "^3.13.0"
   },
   "devDependencies": {
     "@hono/react-compat": "^0.0.3",
-    "@pajecawav/tools": "^0.0.9",
+    "@pajecawav/tools": "^0.1.0",
     "@playwright/test": "^1.63.0",
-    "@types/node": "^26.6.2",
+    "@types/node": "^26.6.4",
     "cross-env": "^10.1.0",
-    "hono": "^4.13.9",
+    "hono": "^4.13.12",
     "husky": "^9.1.7",
     "npm-run-all2": "^9.0.3",
-    "oxfmt": "^0.70.0",
-    "oxlint": "^1.85.0",
+    "oxfmt": "^0.71.0",
+    "oxlint": "^1.86.0",
     "oxlint-tsgolint": "^7.0.2002",
-    "publint": "^0.3.24",
+    "publint": "^0.3.25",
     "tsdown": "0.23.0",
     "typescript": "~7.0.2",
-    "vite": "^8.3.0"
+    "vite": "^8.3.2"
   },
   "scripts": {
     "build": "tsdown",

package/src/hooks/useHead.tsx

@@ -1,48 +1,13 @@
 import { useEffect, useRef } from "hono/jsx";
 import { useHead as _useHead, useSeoMeta as _useSeoMeta } from "unhead";
 import type { ClientUnhead } from "unhead/client";
-import { createHead } from "unhead/client";
-import type { ActiveHeadEntry, ResolvableHead, UseSeoMetaInput } from "unhead/types";
+import type { ActiveHeadEntry, UseSeoMetaInput } from "unhead/types";
 import { useSSRContext } from "#/context/ssr";
+import { ensureClientHead } from "#/island/head";
 import type { YamfHead } from "#/shared/head";
 
-interface StreamQueue {
-	_q?: unknown[][];
-	push?: (batch: unknown[]) => void;
-}
-
-declare global {
-	interface Window {
-		__unhead__?: StreamQueue;
-		__yamfHead__?: ClientUnhead;
-	}
-}
-
 if (!import.meta.env.SSR) {
-	const head = createHead();
-
-	const drain = (batch: unknown[]): void => {
-		for (const input of batch) {
-			head.push(input as ResolvableHead);
-		}
-	};
-
-	// inline scripts (the handshake payload and streamed suspense patches)
-	// queue into window.__unhead__ while the document parses; this module is
-	// part of the deferred client entry and runs after parsing, so by now the
-	// queue holds everything the server sent — drain it into the client head
-	const queue = window.__unhead__?._q;
-
-	if (queue) {
-		for (const batch of queue) {
-			drain(batch);
-		}
-	}
-
-	// keep late patches (a stream that is still open) working
-	window.__unhead__ = { push: drain };
-
-	window.__yamfHead__ = head;
+	ensureClientHead();
 }
 
 /**

package/src/island/client.tsx

@@ -2,10 +2,16 @@ import { parse } from "devalue";
 import type { FC } from "hono/jsx";
 import { hydrateRoot } from "hono/jsx/dom/client";
 import { withLeadingSlash } from "ufo";
+import { ensureClientHead } from "./head";
 import type { IslandClientDirectiveSerialized } from "./types";
 
 declare let __yamf_raw_import__: <T>(file: string) => Promise<T>;
 
+// this runtime loads whenever a page contains islands — set up the client
+// head here so the handshake payload and streamed head patches actually
+// apply, even when nothing imports the useHead hook
+ensureClientHead();
+
 const listeners: WeakMap<Element, VoidFunction> = new WeakMap();
 
 const observer: IntersectionObserver = new IntersectionObserver(entries => {
@@ -45,7 +51,11 @@ const requestIdle = (callback: () => void): void => {
  * element (src/client/index.ts) once this runtime module has been loaded.
  */
 export const hydrateIsland = (island: HTMLElement): void => {
-	const islandProps = parse(island.getAttribute("island-props") ?? "{}");
+	// skip islands omit the attribute entirely — parse after (and only if) it
+	// exists, otherwise parse("{}") would throw "Invalid input" and abort the
+	// whole pending-hydration loop
+	const rawProps = island.getAttribute("island-props");
+	const islandProps = rawProps === null ? [] : parse(rawProps);
 	const islandSrc = island.getAttribute("island-src");
 	const islandEntry = island.getAttribute("island-entry");
 	// oxlint-disable-next-line typescript/no-unsafe-type-assertion

package/src/island/head.ts

@@ -0,0 +1,56 @@
+import { createHead } from "unhead/client";
+import type { ClientUnhead } from "unhead/client";
+import type { ResolvableHead } from "unhead/types";
+
+interface StreamQueue {
+	_q?: unknown[][];
+	push?: (batch: unknown[]) => void;
+}
+
+declare global {
+	interface Window {
+		__unhead__?: StreamQueue;
+		__yamfHead__?: ClientUnhead;
+	}
+}
+
+/**
+ * Creates the client head, drains everything the server streamed into
+ * `window.__unhead__` (the handshake payload and streamed suspense patches)
+ * and upgrades the stub so late patches from an open stream keep applying.
+ *
+ * Idempotent: it is called from the island hydration runtime (which loads
+ * whenever a page contains islands) and from the `useHead` hook module —
+ * whichever runs first wins.
+ */
+export const ensureClientHead = (): ClientUnhead => {
+	if (window.__yamfHead__) {
+		return window.__yamfHead__;
+	}
+
+	const head = createHead();
+
+	const drain = (batch: unknown[]): void => {
+		for (const input of batch) {
+			head.push(input as ResolvableHead);
+		}
+	};
+
+	// inline scripts (the handshake payload and streamed suspense patches)
+	// queue into window.__unhead__ while the document parses; drain them into
+	// the client head
+	const queue = window.__unhead__?._q;
+
+	if (queue) {
+		for (const batch of queue) {
+			drain(batch);
+		}
+	}
+
+	// keep late patches (a stream that is still open) working
+	window.__unhead__ = { push: drain };
+
+	window.__yamfHead__ = head;
+
+	return head;
+};

package/src/server/entry.tsx

@@ -42,8 +42,8 @@ for (const [relativePath, handler] of Object.entries(pages).toSorted((a, b) =>
 			.replace(/\.[A-Za-z]+$/, "")
 			.replace(/\(([^(/\\]+)\)[/\\]/g, "")
 			.replace(/\[\.{3}]/g, "**")
-			.replace(/\[\.{3}([^\]]+)]/g, (_, p: string) => "**:" + p.replace(/[^\w-]/g, "_"))
-			.replace(/\[([^/\]]+)]/g, (_, p: string) => ":" + p.replace(/[^\w-]/g, "_"))
+			.replace(/\[\.{3}([^\]]+)]/g, (_, p: string) => "**:" + p.replace(/[^\w]/g, "_"))
+			.replace(/\[([^/\]]+)]/g, (_, p: string) => ":" + p.replace(/[^\w]/g, "_"))
 			.replace(/(\/|^)index$/, "") || "/";
 
 	route = withLeadingSlash(withoutTrailingSlash(route));