@pyreon/head 0.20.0 → 0.22.0

package/lib/analysis/index.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"c3ae39c2-1","name":"context.ts"},{"uid":"c3ae39c2-3","name":"provider.ts"},{"uid":"c3ae39c2-5","name":"dom.ts"},{"uid":"c3ae39c2-7","name":"use-head.ts"},{"uid":"c3ae39c2-9","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"c3ae39c2-1":{"renderedLength":1373,"gzipLength":509,"brotliLength":0,"metaUid":"c3ae39c2-0"},"c3ae39c2-3":{"renderedLength":681,"gzipLength":408,"brotliLength":0,"metaUid":"c3ae39c2-2"},"c3ae39c2-5":{"renderedLength":3447,"gzipLength":1292,"brotliLength":0,"metaUid":"c3ae39c2-4"},"c3ae39c2-7":{"renderedLength":2634,"gzipLength":1093,"brotliLength":0,"metaUid":"c3ae39c2-6"},"c3ae39c2-9":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"c3ae39c2-8"}},"nodeMetas":{"c3ae39c2-0":{"id":"/src/context.ts","moduleParts":{"index.js":"c3ae39c2-1"},"imported":[{"uid":"c3ae39c2-10"}],"importedBy":[{"uid":"c3ae39c2-8"},{"uid":"c3ae39c2-2"},{"uid":"c3ae39c2-6"}]},"c3ae39c2-2":{"id":"/src/provider.ts","moduleParts":{"index.js":"c3ae39c2-3"},"imported":[{"uid":"c3ae39c2-10"},{"uid":"c3ae39c2-0"}],"importedBy":[{"uid":"c3ae39c2-8"}]},"c3ae39c2-4":{"id":"/src/dom.ts","moduleParts":{"index.js":"c3ae39c2-5"},"imported":[],"importedBy":[{"uid":"c3ae39c2-6"}]},"c3ae39c2-6":{"id":"/src/use-head.ts","moduleParts":{"index.js":"c3ae39c2-7"},"imported":[{"uid":"c3ae39c2-10"},{"uid":"c3ae39c2-11"},{"uid":"c3ae39c2-0"},{"uid":"c3ae39c2-4"}],"importedBy":[{"uid":"c3ae39c2-8"}]},"c3ae39c2-8":{"id":"/src/index.ts","moduleParts":{"index.js":"c3ae39c2-9"},"imported":[{"uid":"c3ae39c2-0"},{"uid":"c3ae39c2-2"},{"uid":"c3ae39c2-6"}],"importedBy":[],"isEntry":true},"c3ae39c2-10":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"c3ae39c2-0"},{"uid":"c3ae39c2-2"},{"uid":"c3ae39c2-6"}]},"c3ae39c2-11":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"c3ae39c2-6"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"19674450-1","name":"provider.ts"},{"uid":"19674450-3","name":"dom.ts"},{"uid":"19674450-5","name":"use-head.ts"},{"uid":"19674450-7","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"19674450-1":{"renderedLength":2127,"gzipLength":1080,"brotliLength":0,"metaUid":"19674450-0"},"19674450-3":{"renderedLength":3447,"gzipLength":1292,"brotliLength":0,"metaUid":"19674450-2"},"19674450-5":{"renderedLength":2636,"gzipLength":1095,"brotliLength":0,"metaUid":"19674450-4"},"19674450-7":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"19674450-6"}},"nodeMetas":{"19674450-0":{"id":"/src/provider.ts","moduleParts":{"index.js":"19674450-1"},"imported":[{"uid":"19674450-9"},{"uid":"19674450-8"}],"importedBy":[{"uid":"19674450-6"}]},"19674450-2":{"id":"/src/dom.ts","moduleParts":{"index.js":"19674450-3"},"imported":[],"importedBy":[{"uid":"19674450-4"}]},"19674450-4":{"id":"/src/use-head.ts","moduleParts":{"index.js":"19674450-5"},"imported":[{"uid":"19674450-9"},{"uid":"19674450-10"},{"uid":"19674450-8"},{"uid":"19674450-2"}],"importedBy":[{"uid":"19674450-6"}]},"19674450-6":{"id":"/src/index.ts","moduleParts":{"index.js":"19674450-7"},"imported":[{"uid":"19674450-8"},{"uid":"19674450-0"},{"uid":"19674450-4"}],"importedBy":[],"isEntry":true},"19674450-8":{"id":"@pyreon/head/context","moduleParts":{},"imported":[],"importedBy":[{"uid":"19674450-6"},{"uid":"19674450-0"},{"uid":"19674450-4"}]},"19674450-9":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"19674450-0"},{"uid":"19674450-4"}]},"19674450-10":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"19674450-4"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/analysis/provider.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"provider.js","children":[{"name":"src","children":[{"uid":"65ae058d-1","name":"context.ts"},{"uid":"65ae058d-3","name":"provider.ts"}]}]}],"isRoot":true},"nodeParts":{"65ae058d-1":{"renderedLength":1373,"gzipLength":509,"brotliLength":0,"metaUid":"65ae058d-0"},"65ae058d-3":{"renderedLength":681,"gzipLength":408,"brotliLength":0,"metaUid":"65ae058d-2"}},"nodeMetas":{"65ae058d-0":{"id":"/src/context.ts","moduleParts":{"provider.js":"65ae058d-1"},"imported":[{"uid":"65ae058d-4"}],"importedBy":[{"uid":"65ae058d-2"}]},"65ae058d-2":{"id":"/src/provider.ts","moduleParts":{"provider.js":"65ae058d-3"},"imported":[{"uid":"65ae058d-4"},{"uid":"65ae058d-0"}],"importedBy":[],"isEntry":true},"65ae058d-4":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"65ae058d-2"},{"uid":"65ae058d-0"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"provider.js","children":[{"name":"src/provider.ts","uid":"5e1e2d37-1"}]}],"isRoot":true},"nodeParts":{"5e1e2d37-1":{"renderedLength":2121,"gzipLength":1074,"brotliLength":0,"metaUid":"5e1e2d37-0"}},"nodeMetas":{"5e1e2d37-0":{"id":"/src/provider.ts","moduleParts":{"provider.js":"5e1e2d37-1"},"imported":[{"uid":"5e1e2d37-2"},{"uid":"5e1e2d37-3"}],"importedBy":[],"isEntry":true},"5e1e2d37-2":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"5e1e2d37-0"}]},"5e1e2d37-3":{"id":"@pyreon/head/context","moduleParts":{},"imported":[],"importedBy":[{"uid":"5e1e2d37-0"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/analysis/ssr.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"ssr.js","children":[{"name":"src","children":[{"uid":"b6fd5bb7-1","name":"context.ts"},{"uid":"b6fd5bb7-3","name":"ssr.ts"}]}]}],"isRoot":true},"nodeParts":{"b6fd5bb7-1":{"renderedLength":1373,"gzipLength":509,"brotliLength":0,"metaUid":"b6fd5bb7-0"},"b6fd5bb7-3":{"renderedLength":1370,"gzipLength":701,"brotliLength":0,"metaUid":"b6fd5bb7-2"}},"nodeMetas":{"b6fd5bb7-0":{"id":"/src/context.ts","moduleParts":{"ssr.js":"b6fd5bb7-1"},"imported":[{"uid":"b6fd5bb7-4"}],"importedBy":[{"uid":"b6fd5bb7-2"}]},"b6fd5bb7-2":{"id":"/src/ssr.ts","moduleParts":{"ssr.js":"b6fd5bb7-3"},"imported":[{"uid":"b6fd5bb7-4"},{"uid":"b6fd5bb7-5"},{"uid":"b6fd5bb7-0"}],"importedBy":[],"isEntry":true},"b6fd5bb7-4":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"b6fd5bb7-2"},{"uid":"b6fd5bb7-0"}]},"b6fd5bb7-5":{"id":"@pyreon/runtime-server","moduleParts":{},"imported":[],"importedBy":[{"uid":"b6fd5bb7-2"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"ssr.js","children":[{"name":"src/ssr.ts","uid":"6c67066c-1"}]}],"isRoot":true},"nodeParts":{"6c67066c-1":{"renderedLength":1370,"gzipLength":701,"brotliLength":0,"metaUid":"6c67066c-0"}},"nodeMetas":{"6c67066c-0":{"id":"/src/ssr.ts","moduleParts":{"ssr.js":"6c67066c-1"},"imported":[{"uid":"6c67066c-2"},{"uid":"6c67066c-3"},{"uid":"6c67066c-4"}],"importedBy":[],"isEntry":true},"6c67066c-2":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"6c67066c-0"}]},"6c67066c-3":{"id":"@pyreon/runtime-server","moduleParts":{},"imported":[],"importedBy":[{"uid":"6c67066c-0"}]},"6c67066c-4":{"id":"@pyreon/head/context","moduleParts":{},"imported":[],"importedBy":[{"uid":"6c67066c-0"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/analysis/use-head.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"use-head.js","children":[{"name":"src","children":[{"uid":"a2d4ff75-1","name":"context.ts"},{"uid":"a2d4ff75-3","name":"dom.ts"},{"uid":"a2d4ff75-5","name":"use-head.ts"}]}]}],"isRoot":true},"nodeParts":{"a2d4ff75-1":{"renderedLength":79,"gzipLength":85,"brotliLength":0,"metaUid":"a2d4ff75-0"},"a2d4ff75-3":{"renderedLength":3447,"gzipLength":1292,"brotliLength":0,"metaUid":"a2d4ff75-2"},"a2d4ff75-5":{"renderedLength":2634,"gzipLength":1093,"brotliLength":0,"metaUid":"a2d4ff75-4"}},"nodeMetas":{"a2d4ff75-0":{"id":"/src/context.ts","moduleParts":{"use-head.js":"a2d4ff75-1"},"imported":[{"uid":"a2d4ff75-6"}],"importedBy":[{"uid":"a2d4ff75-4"}]},"a2d4ff75-2":{"id":"/src/dom.ts","moduleParts":{"use-head.js":"a2d4ff75-3"},"imported":[],"importedBy":[{"uid":"a2d4ff75-4"}]},"a2d4ff75-4":{"id":"/src/use-head.ts","moduleParts":{"use-head.js":"a2d4ff75-5"},"imported":[{"uid":"a2d4ff75-6"},{"uid":"a2d4ff75-7"},{"uid":"a2d4ff75-0"},{"uid":"a2d4ff75-2"}],"importedBy":[],"isEntry":true},"a2d4ff75-6":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"a2d4ff75-4"},{"uid":"a2d4ff75-0"}]},"a2d4ff75-7":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"a2d4ff75-4"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"use-head.js","children":[{"name":"src","children":[{"uid":"e064605f-1","name":"dom.ts"},{"uid":"e064605f-3","name":"use-head.ts"}]}]}],"isRoot":true},"nodeParts":{"e064605f-1":{"renderedLength":3447,"gzipLength":1292,"brotliLength":0,"metaUid":"e064605f-0"},"e064605f-3":{"renderedLength":2634,"gzipLength":1093,"brotliLength":0,"metaUid":"e064605f-2"}},"nodeMetas":{"e064605f-0":{"id":"/src/dom.ts","moduleParts":{"use-head.js":"e064605f-1"},"imported":[],"importedBy":[{"uid":"e064605f-2"}]},"e064605f-2":{"id":"/src/use-head.ts","moduleParts":{"use-head.js":"e064605f-3"},"imported":[{"uid":"e064605f-4"},{"uid":"e064605f-5"},{"uid":"e064605f-6"},{"uid":"e064605f-0"}],"importedBy":[],"isEntry":true},"e064605f-4":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"e064605f-2"}]},"e064605f-5":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"e064605f-2"}]},"e064605f-6":{"id":"@pyreon/head/context","moduleParts":{},"imported":[],"importedBy":[{"uid":"e064605f-2"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/context.js

@@ -0,0 +1,62 @@
+import { createContext } from "@pyreon/core";
+
+//#region src/context.ts
+function createHeadContext() {
+	const map = /* @__PURE__ */ new Map();
+	let dirty = true;
+	let cachedTags = [];
+	let cachedTitleTemplate;
+	let cachedHtmlAttrs = {};
+	let cachedBodyAttrs = {};
+	function rebuild() {
+		if (!dirty) return;
+		dirty = false;
+		const keyed = /* @__PURE__ */ new Map();
+		const unkeyed = [];
+		let titleTemplate;
+		const htmlAttrs = {};
+		const bodyAttrs = {};
+		for (const entry of map.values()) {
+			for (const tag of entry.tags) if (tag.key) keyed.set(tag.key, tag);
+			else unkeyed.push(tag);
+			if (entry.titleTemplate !== void 0) titleTemplate = entry.titleTemplate;
+			if (entry.htmlAttrs) Object.assign(htmlAttrs, entry.htmlAttrs);
+			if (entry.bodyAttrs) Object.assign(bodyAttrs, entry.bodyAttrs);
+		}
+		cachedTags = [...keyed.values(), ...unkeyed];
+		cachedTitleTemplate = titleTemplate;
+		cachedHtmlAttrs = htmlAttrs;
+		cachedBodyAttrs = bodyAttrs;
+	}
+	return {
+		add(id, entry) {
+			map.set(id, entry);
+			dirty = true;
+		},
+		remove(id) {
+			map.delete(id);
+			dirty = true;
+		},
+		resolve() {
+			rebuild();
+			return cachedTags;
+		},
+		resolveTitleTemplate() {
+			rebuild();
+			return cachedTitleTemplate;
+		},
+		resolveHtmlAttrs() {
+			rebuild();
+			return cachedHtmlAttrs;
+		},
+		resolveBodyAttrs() {
+			rebuild();
+			return cachedBodyAttrs;
+		}
+	};
+}
+const HeadContext = createContext(null);
+
+//#endregion
+export { HeadContext, createHeadContext };
+//# sourceMappingURL=context.js.map

package/lib/index.js

@@ -1,81 +1,48 @@
-import { createContext, nativeCompat, onMount, onUnmount, provide, useContext } from "@pyreon/core";
+import { HeadContext, HeadContext as HeadContext$1, createHeadContext, createHeadContext as createHeadContext$1 } from "@pyreon/head/context";
+import { nativeCompat, onMount, onUnmount, provide, useContext } from "@pyreon/core";
 import { effect } from "@pyreon/reactivity";
 
-//#region src/context.ts
-function createHeadContext() {
-	const map = /* @__PURE__ */ new Map();
-	let dirty = true;
-	let cachedTags = [];
-	let cachedTitleTemplate;
-	let cachedHtmlAttrs = {};
-	let cachedBodyAttrs = {};
-	function rebuild() {
-		if (!dirty) return;
-		dirty = false;
-		const keyed = /* @__PURE__ */ new Map();
-		const unkeyed = [];
-		let titleTemplate;
-		const htmlAttrs = {};
-		const bodyAttrs = {};
-		for (const entry of map.values()) {
-			for (const tag of entry.tags) if (tag.key) keyed.set(tag.key, tag);
-			else unkeyed.push(tag);
-			if (entry.titleTemplate !== void 0) titleTemplate = entry.titleTemplate;
-			if (entry.htmlAttrs) Object.assign(htmlAttrs, entry.htmlAttrs);
-			if (entry.bodyAttrs) Object.assign(bodyAttrs, entry.bodyAttrs);
-		}
-		cachedTags = [...keyed.values(), ...unkeyed];
-		cachedTitleTemplate = titleTemplate;
-		cachedHtmlAttrs = htmlAttrs;
-		cachedBodyAttrs = bodyAttrs;
-	}
-	return {
-		add(id, entry) {
-			map.set(id, entry);
-			dirty = true;
-		},
-		remove(id) {
-			map.delete(id);
-			dirty = true;
-		},
-		resolve() {
-			rebuild();
-			return cachedTags;
-		},
-		resolveTitleTemplate() {
-			rebuild();
-			return cachedTitleTemplate;
-		},
-		resolveHtmlAttrs() {
-			rebuild();
-			return cachedHtmlAttrs;
-		},
-		resolveBodyAttrs() {
-			rebuild();
-			return cachedBodyAttrs;
-		}
-	};
-}
-const HeadContext = createContext(null);
-
-//#endregion
 //#region src/provider.ts
 /**
 * Provides a HeadContextValue to all descendant components.
 * Wrap your app root with this to enable useHead() throughout the tree.
 *
-* If no `context` prop is passed, a new HeadContext is created automatically.
+* Resolution order (first non-null wins):
+* 1. `props.context` — explicit context (documented SSR pattern).
+* 2. An outer `HeadContext` already in scope — inherited transparently.
+*    This is what makes `renderWithHead(h(HeadProvider, null, h(App)))`
+*    work without manual context plumbing: `renderWithHead` pushes its
+*    own `HeadContext` onto the per-request stack, and a nested
+*    `HeadProvider` (e.g. one zero's `App` renders unconditionally)
+*    inherits it instead of silently shadowing it with a fresh,
+*    write-only registry.
+* 3. A freshly-created `HeadContext` — root-level fallback (pure CSR).
+*
+* The inheritance step is load-bearing for any consumer wrapping
+* `<HeadProvider>` inside `renderWithHead()` (the documented JSDoc
+* pattern below) AND for the SSG / runtime-SSR pipeline in `@pyreon/zero`,
+* whose `createApp` always mounts `h(HeadProvider, null, …)` with no
+* `context` prop. Without inheritance, all `useHead()` calls in the
+* subtree wrote tags into the inner ctx while `renderWithHead` resolved
+* the outer ctx — producing an empty `<head>` for the whole app.
+*
+* Apps that genuinely need an isolated registry (e.g. iframe / micro-
+* frontend boundaries) can still opt out by passing
+* `context={createHeadContext()}` explicitly — `props.context` always wins.
 *
 * @example
-* // Auto-create context:
+* // Auto-create context (root of a CSR app):
 * <HeadProvider><App /></HeadProvider>
 *
 * // Explicit context (e.g. for SSR):
 * const headCtx = createHeadContext()
 * mount(h(HeadProvider, { context: headCtx }, h(App, null)), root)
+*
+* // Composes with `renderWithHead` out of the box — no plumbing needed:
+* const { html, head } = await renderWithHead(h(HeadProvider, null, h(App, null)))
 */
 const HeadProvider = (props) => {
-	provide(HeadContext, props.context ?? createHeadContext());
+	provide(HeadContext$1, props.context ?? useContext(HeadContext$1) ?? createHeadContext$1());
 	const ch = props.children;
 	return typeof ch === "function" ? ch() : ch;
 };
@@ -269,7 +236,7 @@ function buildEntry(o) {
 * Requires a <HeadProvider> (CSR) or renderWithHead() (SSR) ancestor.
 */
 function useHead(input) {
-	const ctx = useContext(HeadContext);
+	const ctx = useContext(HeadContext$1);
 	if (!ctx) return;
 	const id = Symbol();
 	if (typeof input === "function") if (typeof document !== "undefined") effect(() => {

package/lib/provider.js

@@ -1,80 +1,47 @@
-import { createContext, nativeCompat, provide } from "@pyreon/core";
+import { nativeCompat, provide, useContext } from "@pyreon/core";
+import { HeadContext, createHeadContext } from "@pyreon/head/context";
 
-//#region src/context.ts
-function createHeadContext() {
-	const map = /* @__PURE__ */ new Map();
-	let dirty = true;
-	let cachedTags = [];
-	let cachedTitleTemplate;
-	let cachedHtmlAttrs = {};
-	let cachedBodyAttrs = {};
-	function rebuild() {
-		if (!dirty) return;
-		dirty = false;
-		const keyed = /* @__PURE__ */ new Map();
-		const unkeyed = [];
-		let titleTemplate;
-		const htmlAttrs = {};
-		const bodyAttrs = {};
-		for (const entry of map.values()) {
-			for (const tag of entry.tags) if (tag.key) keyed.set(tag.key, tag);
-			else unkeyed.push(tag);
-			if (entry.titleTemplate !== void 0) titleTemplate = entry.titleTemplate;
-			if (entry.htmlAttrs) Object.assign(htmlAttrs, entry.htmlAttrs);
-			if (entry.bodyAttrs) Object.assign(bodyAttrs, entry.bodyAttrs);
-		}
-		cachedTags = [...keyed.values(), ...unkeyed];
-		cachedTitleTemplate = titleTemplate;
-		cachedHtmlAttrs = htmlAttrs;
-		cachedBodyAttrs = bodyAttrs;
-	}
-	return {
-		add(id, entry) {
-			map.set(id, entry);
-			dirty = true;
-		},
-		remove(id) {
-			map.delete(id);
-			dirty = true;
-		},
-		resolve() {
-			rebuild();
-			return cachedTags;
-		},
-		resolveTitleTemplate() {
-			rebuild();
-			return cachedTitleTemplate;
-		},
-		resolveHtmlAttrs() {
-			rebuild();
-			return cachedHtmlAttrs;
-		},
-		resolveBodyAttrs() {
-			rebuild();
-			return cachedBodyAttrs;
-		}
-	};
-}
-const HeadContext = createContext(null);
-
-//#endregion
 //#region src/provider.ts
 /**
 * Provides a HeadContextValue to all descendant components.
 * Wrap your app root with this to enable useHead() throughout the tree.
 *
-* If no `context` prop is passed, a new HeadContext is created automatically.
+* Resolution order (first non-null wins):
+* 1. `props.context` — explicit context (documented SSR pattern).
+* 2. An outer `HeadContext` already in scope — inherited transparently.
+*    This is what makes `renderWithHead(h(HeadProvider, null, h(App)))`
+*    work without manual context plumbing: `renderWithHead` pushes its
+*    own `HeadContext` onto the per-request stack, and a nested
+*    `HeadProvider` (e.g. one zero's `App` renders unconditionally)
+*    inherits it instead of silently shadowing it with a fresh,
+*    write-only registry.
+* 3. A freshly-created `HeadContext` — root-level fallback (pure CSR).
+*
+* The inheritance step is load-bearing for any consumer wrapping
+* `<HeadProvider>` inside `renderWithHead()` (the documented JSDoc
+* pattern below) AND for the SSG / runtime-SSR pipeline in `@pyreon/zero`,
+* whose `createApp` always mounts `h(HeadProvider, null, …)` with no
+* `context` prop. Without inheritance, all `useHead()` calls in the
+* subtree wrote tags into the inner ctx while `renderWithHead` resolved
+* the outer ctx — producing an empty `<head>` for the whole app.
+*
+* Apps that genuinely need an isolated registry (e.g. iframe / micro-
+* frontend boundaries) can still opt out by passing
+* `context={createHeadContext()}` explicitly — `props.context` always wins.
 *
 * @example
-* // Auto-create context:
+* // Auto-create context (root of a CSR app):
 * <HeadProvider><App /></HeadProvider>
 *
 * // Explicit context (e.g. for SSR):
 * const headCtx = createHeadContext()
 * mount(h(HeadProvider, { context: headCtx }, h(App, null)), root)
+*
+* // Composes with `renderWithHead` out of the box — no plumbing needed:
+* const { html, head } = await renderWithHead(h(HeadProvider, null, h(App, null)))
 */
 const HeadProvider = (props) => {
-	provide(HeadContext, props.context ?? createHeadContext());
+	provide(HeadContext, props.context ?? useContext(HeadContext) ?? createHeadContext());
 	const ch = props.children;
 	return typeof ch === "function" ? ch() : ch;
 };

package/lib/ssr.js

@@ -1,64 +1,7 @@
-import { createContext, h, pushContext } from "@pyreon/core";
+import { h, pushContext } from "@pyreon/core";
 import { renderToString } from "@pyreon/runtime-server";
+import { HeadContext, createHeadContext } from "@pyreon/head/context";
 
-//#region src/context.ts
-function createHeadContext() {
-	const map = /* @__PURE__ */ new Map();
-	let dirty = true;
-	let cachedTags = [];
-	let cachedTitleTemplate;
-	let cachedHtmlAttrs = {};
-	let cachedBodyAttrs = {};
-	function rebuild() {
-		if (!dirty) return;
-		dirty = false;
-		const keyed = /* @__PURE__ */ new Map();
-		const unkeyed = [];
-		let titleTemplate;
-		const htmlAttrs = {};
-		const bodyAttrs = {};
-		for (const entry of map.values()) {
-			for (const tag of entry.tags) if (tag.key) keyed.set(tag.key, tag);
-			else unkeyed.push(tag);
-			if (entry.titleTemplate !== void 0) titleTemplate = entry.titleTemplate;
-			if (entry.htmlAttrs) Object.assign(htmlAttrs, entry.htmlAttrs);
-			if (entry.bodyAttrs) Object.assign(bodyAttrs, entry.bodyAttrs);
-		}
-		cachedTags = [...keyed.values(), ...unkeyed];
-		cachedTitleTemplate = titleTemplate;
-		cachedHtmlAttrs = htmlAttrs;
-		cachedBodyAttrs = bodyAttrs;
-	}
-	return {
-		add(id, entry) {
-			map.set(id, entry);
-			dirty = true;
-		},
-		remove(id) {
-			map.delete(id);
-			dirty = true;
-		},
-		resolve() {
-			rebuild();
-			return cachedTags;
-		},
-		resolveTitleTemplate() {
-			rebuild();
-			return cachedTitleTemplate;
-		},
-		resolveHtmlAttrs() {
-			rebuild();
-			return cachedHtmlAttrs;
-		},
-		resolveBodyAttrs() {
-			rebuild();
-			return cachedBodyAttrs;
-		}
-	};
-}
-const HeadContext = createContext(null);
-
-//#endregion
 //#region src/ssr.ts
 const VOID_TAGS = new Set([
 	"meta",

package/lib/types/context.d.ts

@@ -0,0 +1,205 @@
+//#region src/context.d.ts
+interface HeadTag {
+  /** HTML tag name */
+  tag: 'title' | 'meta' | 'link' | 'script' | 'style' | 'base' | 'noscript';
+  /**
+   * Deduplication key. Tags with the same key replace each other;
+   * innermost component (last added) wins.
+   * Example: all components setting the page title use key "title".
+   */
+  key?: string;
+  /** HTML attributes for the tag */
+  props?: Record<string, string>;
+  /** Text content — for <title>, <script>, <style>, <noscript> */
+  children?: string;
+}
+/** Standard `<meta>` tag attributes. Catches typos like `{ naem: "description" }`. */
+interface MetaTag {
+  /** Standard meta name (e.g. "description", "viewport", "robots") */
+  name?: string;
+  /** Open Graph / social property (e.g. "og:title", "twitter:card") */
+  property?: string;
+  /** HTTP equivalent header (e.g. "refresh", "content-type") */
+  'http-equiv'?: string;
+  /** Value associated with name, property, or http-equiv */
+  content?: string;
+  /** Document character encoding (e.g. "utf-8") */
+  charset?: string;
+  /** Schema.org itemprop */
+  itemprop?: string;
+  /** Media condition for applicability (e.g. "(prefers-color-scheme: dark)") */
+  media?: string;
+}
+/** Standard `<link>` tag attributes. */
+interface LinkTag {
+  /** Relationship to the current document (e.g. "stylesheet", "icon", "canonical") */
+  rel?: string;
+  /** URL of the linked resource */
+  href?: string;
+  /** Resource type hint for preloading (e.g. "style", "script", "font") */
+  as?: string;
+  /** MIME type (e.g. "text/css", "image/png") */
+  type?: string;
+  /** Media query for conditional loading */
+  media?: string;
+  /** CORS mode */
+  crossorigin?: string;
+  /** Subresource integrity hash */
+  integrity?: string;
+  /** Icon sizes (e.g. "32x32", "any") */
+  sizes?: string;
+  /** Language of the linked resource */
+  hreflang?: string;
+  /** Title for the link (used for alternate stylesheets) */
+  title?: string;
+  /** Fetch priority hint */
+  fetchpriority?: 'high' | 'low' | 'auto';
+  /** Referrer policy */
+  referrerpolicy?: string;
+  /** Image source set for preloading responsive images */
+  imagesrcset?: string;
+  /** Image sizes for preloading responsive images */
+  imagesizes?: string;
+  /** Disable the resource (for stylesheets) */
+  disabled?: string;
+  /** Color for mask-icon */
+  color?: string;
+}
+/** Standard `<script>` tag attributes. */
+interface ScriptTag {
+  /** External script URL */
+  src?: string;
+  /** Script MIME type or module type (e.g. "module", "importmap") */
+  type?: string;
+  /** Load asynchronously */
+  async?: string;
+  /** Defer execution until document is parsed */
+  defer?: string;
+  /** CORS mode */
+  crossorigin?: string;
+  /** Subresource integrity hash */
+  integrity?: string;
+  /** Exclude from module-supporting browsers */
+  nomodule?: string;
+  /** Referrer policy */
+  referrerpolicy?: string;
+  /** Fetch priority hint */
+  fetchpriority?: string;
+  /** Inline script content */
+  children?: string;
+}
+/** Standard `<style>` tag attributes. */
+interface StyleTag {
+  /** Inline CSS content (required) */
+  children: string;
+  /** Media query for conditional styles */
+  media?: string;
+  /** Nonce for CSP */
+  nonce?: string;
+  /** Title for alternate stylesheets */
+  title?: string;
+  /** Render-blocking behavior */
+  blocking?: string;
+}
+/**
+ * How eagerly the browser should act on a speculation rule.
+ * Per the W3C Speculation Rules spec.
+ */
+type SpeculationEagerness = 'immediate' | 'eager' | 'moderate' | 'conservative';
+/**
+ * A single speculation rule (one entry in a `prefetch` / `prerender` list).
+ *
+ * - `source: 'list'` + `urls` — prefetch/prerender these explicit URLs.
+ * - `source: 'document'` + `where` — let the browser pick links from the
+ *   current document that match the predicate (e.g. a CSS selector via
+ *   `{ selector_matches: '.router-link' }`).
+ */
+interface SpeculationRule {
+  /** `'list'` (explicit `urls`) or `'document'` (predicate-driven). */
+  source?: 'list' | 'document';
+  /** Same-origin URLs to prefetch/prerender (for `source: 'list'`). */
+  urls?: string[];
+  /** Document predicate (for `source: 'document'`) — e.g. `{ selector_matches: 'a.next' }`. */
+  where?: Record<string, unknown>;
+  /** When the browser should fetch — defaults to the browser's per-source default. */
+  eagerness?: SpeculationEagerness;
+  /** Capability requirements, e.g. `['anonymous-client-ip-when-cross-origin']`. */
+  requires?: string[];
+  /** Referrer policy for the speculative request. */
+  referrer_policy?: string;
+}
+/**
+ * Declarative Speculation Rules — emitted as a single
+ * `<script type="speculationrules">` tag. Supported browsers prefetch or
+ * fully prerender the next document(s) so navigation is instant. Inert in
+ * non-supporting browsers (no polyfill needed). Opt-in: only emitted when
+ * `useHead({ speculationRules })` is called.
+ *
+ * @see https://developer.mozilla.org/docs/Web/API/Speculation_Rules_API
+ */
+interface SpeculationRules {
+  /** Lightweight: fetch the response, no rendering. */
+  prefetch?: SpeculationRule[];
+  /** Heavy: fully render the next document in the background. */
+  prerender?: SpeculationRule[];
+}
+/** Standard `<base>` tag attributes. */
+interface BaseTag {
+  /** Base URL for relative URLs in the document */
+  href?: string;
+  /** Default target for links and forms */
+  target?: '_blank' | '_self' | '_parent' | '_top';
+}
+interface UseHeadInput {
+  title?: string;
+  /**
+   * Title template — use `%s` as a placeholder for the page title.
+   * Applied to the resolved title after deduplication.
+   * @example useHead({ titleTemplate: "%s | My App" })
+   */
+  titleTemplate?: string | ((title: string) => string);
+  meta?: MetaTag[];
+  link?: LinkTag[];
+  script?: ScriptTag[];
+  style?: StyleTag[];
+  noscript?: {
+    children: string;
+  }[];
+  /** Convenience: emits a <script type="application/ld+json"> tag with JSON.stringify'd content */
+  jsonLd?: Record<string, unknown> | Record<string, unknown>[];
+  /**
+   * Convenience: emits a `<script type="speculationrules">` tag with the
+   * JSON.stringify'd rules. Supported browsers prefetch/prerender the next
+   * document(s) for near-instant navigation; inert elsewhere. Opt-in.
+   * @example useHead({ speculationRules: { prerender: [{ source: 'list', urls: ['/about'], eagerness: 'moderate' }] } })
+   */
+  speculationRules?: SpeculationRules;
+  base?: BaseTag;
+  /** Attributes to set on the <html> element (e.g. { lang: "en", dir: "ltr" }) */
+  htmlAttrs?: Record<string, string>;
+  /** Attributes to set on the <body> element (e.g. { class: "dark" }) */
+  bodyAttrs?: Record<string, string>;
+}
+interface HeadEntry {
+  tags: HeadTag[];
+  titleTemplate?: string | ((title: string) => string) | undefined;
+  htmlAttrs?: Record<string, string> | undefined;
+  bodyAttrs?: Record<string, string> | undefined;
+}
+interface HeadContextValue {
+  add(id: symbol, entry: HeadEntry): void;
+  remove(id: symbol): void;
+  /** Returns deduplicated tags — last-added entry wins per key */
+  resolve(): HeadTag[];
+  /** Returns the merged titleTemplate (last-added wins) */
+  resolveTitleTemplate(): (string | ((title: string) => string)) | undefined;
+  /** Returns merged htmlAttrs (later entries override earlier) */
+  resolveHtmlAttrs(): Record<string, string>;
+  /** Returns merged bodyAttrs (later entries override earlier) */
+  resolveBodyAttrs(): Record<string, string>;
+}
+declare function createHeadContext(): HeadContextValue;
+declare const HeadContext: import("@pyreon/core").Context<HeadContextValue | null>;
+//#endregion
+export { BaseTag, HeadContext, HeadContextValue, HeadEntry, HeadTag, LinkTag, MetaTag, ScriptTag, SpeculationEagerness, SpeculationRule, SpeculationRules, StyleTag, UseHeadInput, createHeadContext };
+//# sourceMappingURL=context2.d.ts.map