@fluixi/head 0.1.0-alpha.21 → 1.0.0-alpha.100

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Fluixi
+Copyright (c) 2026 Ibrahima Touré
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -20,7 +20,7 @@ seo({
 
 - **Reactive** — pass a signal (or a function reading one) and the document updates live:
   ```ts
-  const [title, setTitle] = createSignal('Dashboard');
+  const title = $signal('Dashboard');
   seo(() => ({ title: title() })); // document.title tracks the signal — no reload
   ```
 - **SSR-first** — `renderHead(registry)` serializes the resolved tags into `<head>` markup plus

package/dist/components.cjs

@@ -0,0 +1,91 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components.ts
+var components_exports = {};
+__export(components_exports, {
+  Base: () => Base,
+  JsonLD: () => JsonLD,
+  Link: () => Link,
+  Meta: () => Meta,
+  Script: () => Script,
+  Title: () => Title
+});
+module.exports = __toCommonJS(components_exports);
+
+// src/core.ts
+var import_signal = require("@fluixi/reactive/signal");
+var slot = globalThis[/* @__PURE__ */ Symbol.for("fluixi.head")] ??= {
+  active: null,
+  scope: null
+};
+function getActiveHead() {
+  return slot.scope?.() ?? slot.active;
+}
+function useHead(input) {
+  const h = getActiveHead();
+  if (!h) {
+    const proc = globalThis.process;
+    if (proc?.env?.NODE_ENV !== "production") {
+      console.warn("[fluixi/head] useHead() called with no active head registry — ignored.");
+    }
+    return () => {
+    };
+  }
+  const dispose = h.push(input);
+  if (typeof window !== "undefined" && (0, import_signal.getOwner)()) (0, import_signal.onCleanup)(dispose);
+  return dispose;
+}
+
+// src/components.ts
+function read(v) {
+  return typeof v === "function" ? v() : v;
+}
+function Title(props) {
+  useHead(() => ({ title: read(props.children) }));
+  return null;
+}
+function Meta(props) {
+  useHead(() => ({ meta: [{ ...props, content: read(props.content) }] }));
+  return null;
+}
+function Link(props) {
+  useHead(() => {
+    const l = {};
+    for (const [k, v] of Object.entries(props)) l[k] = read(v);
+    return { link: [l] };
+  });
+  return null;
+}
+function Script(props) {
+  useHead(() => {
+    const s = {};
+    for (const [k, v] of Object.entries(props)) s[k] = read(v);
+    return { script: [s] };
+  });
+  return null;
+}
+function Base(props) {
+  useHead({ base: props.href });
+  return null;
+}
+function JsonLD(props) {
+  useHead(() => ({ jsonLd: read(props.data) }));
+  return null;
+}

package/dist/components.js

@@ -1,5 +1,5 @@
 /**
- * Declarative head components. They render nothing — each registers metadata via useHead() and
+ * Declarative head components. They render nothing, each registers metadata via useHead() and
  * returns null, so they compose anywhere in the tree and work identically on the server and client
  * (a signal passed to one updates the document live). Usage:
  *

package/dist/components.mjs

@@ -0,0 +1,68 @@
+// src/core.ts
+import { getOwner, onCleanup, createSignal } from "@fluixi/reactive/signal";
+var slot = globalThis[/* @__PURE__ */ Symbol.for("fluixi.head")] ??= {
+  active: null,
+  scope: null
+};
+function getActiveHead() {
+  return slot.scope?.() ?? slot.active;
+}
+function useHead(input) {
+  const h = getActiveHead();
+  if (!h) {
+    const proc = globalThis.process;
+    if (proc?.env?.NODE_ENV !== "production") {
+      console.warn("[fluixi/head] useHead() called with no active head registry — ignored.");
+    }
+    return () => {
+    };
+  }
+  const dispose = h.push(input);
+  if (typeof window !== "undefined" && getOwner()) onCleanup(dispose);
+  return dispose;
+}
+
+// src/components.ts
+function read(v) {
+  return typeof v === "function" ? v() : v;
+}
+function Title(props) {
+  useHead(() => ({ title: read(props.children) }));
+  return null;
+}
+function Meta(props) {
+  useHead(() => ({ meta: [{ ...props, content: read(props.content) }] }));
+  return null;
+}
+function Link(props) {
+  useHead(() => {
+    const l = {};
+    for (const [k, v] of Object.entries(props)) l[k] = read(v);
+    return { link: [l] };
+  });
+  return null;
+}
+function Script(props) {
+  useHead(() => {
+    const s = {};
+    for (const [k, v] of Object.entries(props)) s[k] = read(v);
+    return { script: [s] };
+  });
+  return null;
+}
+function Base(props) {
+  useHead({ base: props.href });
+  return null;
+}
+function JsonLD(props) {
+  useHead(() => ({ jsonLd: read(props.data) }));
+  return null;
+}
+export {
+  Base,
+  JsonLD,
+  Link,
+  Meta,
+  Script,
+  Title
+};

package/dist/core.cjs

@@ -0,0 +1,314 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core.ts
+var core_exports = {};
+__export(core_exports, {
+  createHead: () => createHead,
+  getActiveHead: () => getActiveHead,
+  resolveHead: () => resolveHead,
+  runWithHead: () => runWithHead,
+  seo: () => seo,
+  setActiveHead: () => setActiveHead,
+  setHeadScope: () => setHeadScope,
+  useHead: () => useHead
+});
+module.exports = __toCommonJS(core_exports);
+var import_signal = require("@fluixi/reactive/signal");
+function val(v) {
+  return typeof v === "function" ? v() : v;
+}
+function robotsToString(r) {
+  if (typeof r === "string") return r;
+  const out = [];
+  out.push(r.index === false ? "noindex" : "index");
+  out.push(r.follow === false ? "nofollow" : "follow");
+  if (r.noarchive) out.push("noarchive");
+  if (r.nosnippet) out.push("nosnippet");
+  if (r.noimageindex) out.push("noimageindex");
+  if (r.maxSnippet != null) out.push(`max-snippet:${r.maxSnippet}`);
+  if (r.maxImagePreview) out.push(`max-image-preview:${r.maxImagePreview}`);
+  if (r.maxVideoPreview != null) out.push(`max-video-preview:${r.maxVideoPreview}`);
+  return out.join(", ");
+}
+function createHead() {
+  const sources = [];
+  const [version, bump] = (0, import_signal.createSignal)(0);
+  return {
+    sources,
+    version,
+    push(input) {
+      sources.push(input);
+      bump((n) => n + 1);
+      return () => {
+        const i = sources.indexOf(input);
+        if (i !== -1) {
+          sources.splice(i, 1);
+          bump((n) => n + 1);
+        }
+      };
+    }
+  };
+}
+var slot = globalThis[/* @__PURE__ */ Symbol.for("fluixi.head")] ??= {
+  active: null,
+  scope: null
+};
+function setActiveHead(h) {
+  slot.active = h;
+}
+function getActiveHead() {
+  return slot.scope?.() ?? slot.active;
+}
+function runWithHead(h, fn) {
+  const prev = slot.active;
+  slot.active = h;
+  try {
+    return fn();
+  } finally {
+    slot.active = prev;
+  }
+}
+function setHeadScope(scope) {
+  slot.scope = scope;
+}
+function useHead(input) {
+  const h = getActiveHead();
+  if (!h) {
+    const proc = globalThis.process;
+    if (proc?.env?.NODE_ENV !== "production") {
+      console.warn("[fluixi/head] useHead() called with no active head registry — ignored.");
+    }
+    return () => {
+    };
+  }
+  const dispose = h.push(input);
+  if (typeof window !== "undefined" && (0, import_signal.getOwner)()) (0, import_signal.onCleanup)(dispose);
+  return dispose;
+}
+var seo = useHead;
+function djb2(s) {
+  let h = 5381;
+  for (let i = 0; i < s.length; i++) h = h * 33 ^ s.charCodeAt(i);
+  return (h >>> 0).toString(36);
+}
+function metaKey(a) {
+  if (a.charset != null) return "meta:charset";
+  if (a.property) return "meta:property:" + a.property;
+  if (a.name) return "meta:name:" + a.name;
+  if (a["http-equiv"]) return "meta:http-equiv:" + a["http-equiv"];
+  return "meta:" + djb2(JSON.stringify(a));
+}
+function pushImage(out, img) {
+  const o = typeof img === "string" ? { url: img } : img;
+  out.push({ tag: "meta", key: "meta:property:og:image:" + o.url, attrs: { property: "og:image", content: o.url } });
+  if (o.secureUrl) out.push({ tag: "meta", key: "meta:property:og:image:secure:" + o.url, attrs: { property: "og:image:secure_url", content: o.secureUrl } });
+  if (o.type) out.push({ tag: "meta", key: "meta:property:og:image:type:" + o.url, attrs: { property: "og:image:type", content: o.type } });
+  if (o.width != null) out.push({ tag: "meta", key: "meta:property:og:image:width:" + o.url, attrs: { property: "og:image:width", content: String(o.width) } });
+  if (o.height != null) out.push({ tag: "meta", key: "meta:property:og:image:height:" + o.url, attrs: { property: "og:image:height", content: String(o.height) } });
+  if (o.alt) out.push({ tag: "meta", key: "meta:property:og:image:alt:" + o.url, attrs: { property: "og:image:alt", content: o.alt } });
+}
+function expandOG(og, out) {
+  const m = (p, c) => {
+    if (c != null) out.push({ tag: "meta", key: "meta:property:og:" + p, attrs: { property: "og:" + p, content: c } });
+  };
+  m("title", og.title);
+  m("description", og.description);
+  m("type", og.type);
+  m("url", og.url);
+  m("site_name", og.siteName);
+  m("locale", og.locale);
+  for (const l of og.localeAlternate ?? []) out.push({ tag: "meta", key: "meta:property:og:locale:alt:" + l, attrs: { property: "og:locale:alternate", content: l } });
+  if (og.image != null) {
+    const imgs = Array.isArray(og.image) ? og.image : [og.image];
+    for (const i of imgs) pushImage(out, i);
+  }
+  if (og.video) {
+    const v = typeof og.video === "string" ? { url: og.video } : og.video;
+    m("video", v.url);
+    if ("type" in v && v.type) m("video:type", v.type);
+    if ("width" in v && v.width != null) m("video:width", String(v.width));
+    if ("height" in v && v.height != null) m("video:height", String(v.height));
+  }
+  if (og.audio) {
+    const a = typeof og.audio === "string" ? { url: og.audio } : og.audio;
+    m("audio", a.url);
+    if ("type" in a && a.type) m("audio:type", a.type);
+  }
+  if (og.article) {
+    const ar = og.article;
+    m("article:published_time", ar.publishedTime);
+    m("article:modified_time", ar.modifiedTime);
+    m("article:expiration_time", ar.expirationTime);
+    m("article:section", ar.section);
+    for (const au of [].concat(ar.author ?? [])) out.push({ tag: "meta", key: "meta:property:og:article:author:" + au, attrs: { property: "article:author", content: au } });
+    for (const t of [].concat(ar.tag ?? [])) out.push({ tag: "meta", key: "meta:property:og:article:tag:" + t, attrs: { property: "article:tag", content: t } });
+  }
+  if (og.book) {
+    const b = og.book;
+    m("book:isbn", b.isbn);
+    m("book:release_date", b.releaseDate);
+    for (const au of [].concat(b.author ?? [])) out.push({ tag: "meta", key: "meta:property:og:book:author:" + au, attrs: { property: "book:author", content: au } });
+    for (const t of [].concat(b.tag ?? [])) out.push({ tag: "meta", key: "meta:property:og:book:tag:" + t, attrs: { property: "book:tag", content: t } });
+  }
+  if (og.profile) {
+    const p = og.profile;
+    m("profile:first_name", p.firstName);
+    m("profile:last_name", p.lastName);
+    m("profile:username", p.username);
+    m("profile:gender", p.gender);
+  }
+}
+function expandTwitter(t, out) {
+  const m = (n, c) => {
+    if (c != null) out.push({ tag: "meta", key: "meta:name:twitter:" + n, attrs: { name: "twitter:" + n, content: c } });
+  };
+  m("card", t.card);
+  m("site", t.site);
+  m("creator", t.creator);
+  m("title", t.title);
+  m("description", t.description);
+  m("image", t.image);
+  m("image:alt", t.imageAlt);
+  m("player", t.player);
+  if (t.playerWidth != null) m("player:width", String(t.playerWidth));
+  if (t.playerHeight != null) m("player:height", String(t.playerHeight));
+  if (t.app) {
+    m("app:name:iphone", t.app.name);
+    m("app:id:iphone", t.app.idIphone);
+    m("app:id:ipad", t.app.idIpad);
+    m("app:id:googleplay", t.app.idGooglePlay);
+  }
+}
+function expandIcons(icons, out) {
+  const link = (key, attrs) => out.push({ tag: "link", key, attrs });
+  if (icons.icon != null) {
+    const arr = typeof icons.icon === "string" ? [{ url: icons.icon }] : icons.icon;
+    for (const i of arr) link("link:icon:" + i.url, { rel: "icon", href: i.url, ...i.type ? { type: i.type } : {}, ...i.sizes ? { sizes: i.sizes } : {} });
+  }
+  if (icons.apple != null) {
+    const arr = typeof icons.apple === "string" ? [{ url: icons.apple }] : icons.apple;
+    for (const i of arr) link("link:apple-touch-icon:" + i.url, { rel: "apple-touch-icon", href: i.url, ...i.sizes ? { sizes: i.sizes } : {} });
+  }
+  if (icons.mask) link("link:mask-icon", { rel: "mask-icon", href: icons.mask.url, ...icons.mask.color ? { color: icons.mask.color } : {} });
+  if (icons.shortcut) link("link:shortcut", { rel: "shortcut icon", href: icons.shortcut });
+  if (icons.msTileImage) out.push({ tag: "meta", key: "meta:name:msapplication-TileImage", attrs: { name: "msapplication-TileImage", content: icons.msTileImage } });
+  if (icons.msTileColor) out.push({ tag: "meta", key: "meta:name:msapplication-TileColor", attrs: { name: "msapplication-TileColor", content: icons.msTileColor } });
+}
+function expand(input, out, ts) {
+  const meta = (key, attrs) => out.push({ tag: "meta", key, attrs });
+  const title = val(input.title);
+  if (title !== void 0) ts.title = title;
+  if (input.titleTemplate !== void 0) ts.template = input.titleTemplate;
+  const lang = val(input.lang);
+  if (lang !== void 0) out.push({ tag: "htmlAttr", key: "html:lang", name: "lang", value: lang });
+  for (const [name, raw] of Object.entries(input.htmlAttrs ?? {})) {
+    const value = val(raw);
+    if (value !== void 0) out.push({ tag: "htmlAttr", key: `html:${name}`, name, value });
+  }
+  if (input.charset !== void 0) meta("meta:charset", { charset: input.charset });
+  if (input.viewport !== void 0) meta("meta:name:viewport", { name: "viewport", content: input.viewport });
+  const desc = val(input.description);
+  if (desc !== void 0) meta("meta:name:description", { name: "description", content: desc });
+  const kw = val(input.keywords);
+  if (kw !== void 0) meta("meta:name:keywords", { name: "keywords", content: Array.isArray(kw) ? kw.join(", ") : kw });
+  if (input.author !== void 0) meta("meta:name:author", { name: "author", content: input.author });
+  if (input.robots !== void 0) meta("meta:name:robots", { name: "robots", content: robotsToString(input.robots) });
+  if (input.generator !== void 0) meta("meta:name:generator", { name: "generator", content: input.generator });
+  if (input.applicationName !== void 0) meta("meta:name:application-name", { name: "application-name", content: input.applicationName });
+  if (input.referrer !== void 0) meta("meta:name:referrer", { name: "referrer", content: input.referrer });
+  const scheme = val(input.colorScheme);
+  if (scheme !== void 0) meta("meta:name:color-scheme", { name: "color-scheme", content: scheme });
+  const theme = val(input.themeColor);
+  if (typeof theme === "string") meta("meta:name:theme-color", { name: "theme-color", content: theme });
+  else if (theme) {
+    for (const { color, media } of theme) {
+      meta(`meta:name:theme-color${media ? `:${media}` : ""}`, media ? { name: "theme-color", content: color, media } : { name: "theme-color", content: color });
+    }
+  }
+  const canonical = val(input.canonical);
+  if (canonical !== void 0) out.push({ tag: "link", key: "link:rel:canonical", attrs: { rel: "canonical", href: canonical } });
+  if (input.manifest !== void 0) out.push({ tag: "link", key: "link:rel:manifest", attrs: { rel: "manifest", href: input.manifest } });
+  if (input.base !== void 0) out.push({ tag: "base", key: "base", attrs: { href: input.base } });
+  if (input.verification) {
+    const map = { google: "google-site-verification", bing: "msvalidate.01", yandex: "yandex-verification", pinterest: "p:domain_verify" };
+    for (const [k, v] of Object.entries(input.verification)) {
+      if (v == null) continue;
+      const name = map[k] ?? k;
+      meta("meta:name:" + name, { name, content: v });
+    }
+  }
+  for (const a of input.alternates ?? []) out.push({ tag: "link", key: "link:alternate:hreflang:" + a.hreflang, attrs: { rel: "alternate", hreflang: a.hreflang, href: a.href } });
+  for (const f of input.feeds ?? []) out.push({ tag: "link", key: "link:alternate:feed:" + f.href, attrs: { rel: "alternate", type: f.type ?? "application/rss+xml", href: f.href, ...f.title ? { title: f.title } : {} } });
+  if (input.og) expandOG(input.og, out);
+  if (input.twitter) expandTwitter(input.twitter, out);
+  if (input.icons) expandIcons(input.icons, out);
+  const ld = val(input.jsonLd);
+  if (ld !== void 0) {
+    const arr = Array.isArray(ld) ? ld : [ld];
+    for (const obj of arr) {
+      const json = JSON.stringify(obj);
+      out.push({ tag: "script", key: "script:ldjson:" + djb2(json), attrs: { type: "application/ld+json" }, children: json });
+    }
+  }
+  for (const m of input.meta ?? []) {
+    const attrs = {};
+    for (const [k, v] of Object.entries(m)) if (v != null) attrs[k === "httpEquiv" ? "http-equiv" : k] = v;
+    out.push({ tag: "meta", key: metaKey(attrs), attrs });
+  }
+  for (const l of input.link ?? []) {
+    const attrs = {};
+    for (const [k, v] of Object.entries(l)) if (v != null) attrs[k] = v;
+    out.push({ tag: "link", key: "link:" + (attrs.rel ?? "") + ":" + (attrs.href ?? djb2(JSON.stringify(attrs))), attrs });
+  }
+  for (const s of input.script ?? []) {
+    const attrs = {};
+    let children;
+    for (const [k, v] of Object.entries(s)) {
+      if (v == null) continue;
+      if (k === "children") children = v;
+      else attrs[k] = v;
+    }
+    out.push({ tag: "script", key: "script:" + (attrs.src ?? djb2((children ?? "") + JSON.stringify(attrs))), attrs, children });
+  }
+}
+function applyTemplate(tpl, title) {
+  return typeof tpl === "function" ? tpl(title) : tpl.includes("%s") ? tpl.replace("%s", title) : tpl;
+}
+function resolveHead(head) {
+  const raw = [];
+  const ts = {};
+  for (const src of head.sources) {
+    const input = typeof src === "function" ? src() : src;
+    expand(input, raw, ts);
+  }
+  if (ts.title !== void 0) {
+    raw.push({ tag: "title", key: "title", children: ts.template ? applyTemplate(ts.template, ts.title) : ts.title });
+  }
+  const byKey = /* @__PURE__ */ new Map();
+  const htmlAttrs = {};
+  for (const t of raw) {
+    if (t.tag === "htmlAttr") {
+      htmlAttrs[t.name] = t.value;
+      continue;
+    }
+    byKey.set(t.key, t);
+  }
+  return { tags: [...byKey.values()], htmlAttrs };
+}

package/dist/core.d.ts

@@ -1,9 +1,9 @@
 import { type Accessor } from '@fluixi/reactive/signal';
 import type { HeadSource, HeadTag } from './types.js';
 export interface HeadRegistry {
-    /** Ordered sources — layouts register before pages, so later entries override. */
+    /** Ordered sources: layouts register before pages, so later entries override. */
     readonly sources: HeadSource[];
-    /** Bumps when a source is added/removed — read it in an effect to re-run on route changes. */
+    /** Bumps when a source is added/removed: read it in an effect to re-run on route changes. */
     readonly version: Accessor<number>;
     push(input: HeadSource): () => void;
 }
@@ -12,11 +12,16 @@ export declare function setActiveHead(h: HeadRegistry | null): void;
 export declare function getActiveHead(): HeadRegistry | null;
 export declare function runWithHead<T>(h: HeadRegistry, fn: () => T): T;
 /**
- * Register metadata for the current page/layout. Static, async-resolved, or reactive — values
+ * Resolve the active registry from a host's own request scope, e.g. its AsyncLocalStorage.
+ * Returning nothing falls back to `setActiveHead`. `null` removes the scope.
+ */
+export declare function setHeadScope(scope: (() => HeadRegistry | null | undefined) | null): void;
+/**
+ * Register metadata for the current page/layout. Static, async-resolved, or reactive, values
  * that are signals update the document live on the client. Returns a disposer (client dynamic use).
  */
 export declare function useHead(input: HeadSource): () => void;
-/** Ergonomic alias — `seo({ title, description })`. */
+/** Ergonomic alias: `seo({ title, description })`. */
 export declare const seo: typeof useHead;
 export interface ResolvedHead {
     tags: HeadTag[];
@@ -24,7 +29,7 @@ export interface ResolvedHead {
 }
 /**
  * Flatten every source (in registration order: layouts first, page last) into tags, then
- * deduplicate by key — last write wins for singletons (title, description, canonical, …),
+ * deduplicate by key: last write wins for singletons (title, description, canonical, …),
  * while repeatable tags (extra og:image, hreflang alternates, json-ld) accumulate.
  */
 export declare function resolveHead(head: HeadRegistry): ResolvedHead;

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,KAAK,EAEV,UAAU,EACV,OAAO,EAOR,MAAM,YAAY,CAAC;AAyBpB,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI,CAAC;CACrC;AAED,wBAAgB,UAAU,IAAI,YAAY,CAkBzC;AAKD,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE1D;AACD,wBAAgB,aAAa,IAAI,YAAY,GAAG,IAAI,CAEnD;AACD,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ9D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI,CAerD;AAED,uDAAuD;AACvD,eAAO,MAAM,GAAG,gBAAU,CAAC;AAmM3B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAqB5D"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,KAAK,EAEV,UAAU,EACV,OAAO,EAOR,MAAM,YAAY,CAAC;AAyBpB,MAAM,WAAW,YAAY;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAC/B,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI,CAAC;CACrC;AAED,wBAAgB,UAAU,IAAI,YAAY,CAkBzC;AAmBD,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE1D;AACD,wBAAgB,aAAa,IAAI,YAAY,GAAG,IAAI,CAEnD;AACD,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ9D;AACD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,IAAI,CAExF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI,CAerD;AAED,sDAAsD;AACtD,eAAO,MAAM,GAAG,gBAAU,CAAC;AA8M3B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAqB5D"}

package/dist/core.js

@@ -42,27 +42,35 @@ export function createHead() {
         },
     };
 }
-// The "active" registry. The server integration sets this per request (around the render);
-// on the client there is a single registry for the document. Kept tiny and synchronous.
-let active = null;
+const slot = (globalThis[Symbol.for('fluixi.head')] ??= {
+    active: null,
+    scope: null,
+});
 export function setActiveHead(h) {
-    active = h;
+    slot.active = h;
 }
 export function getActiveHead() {
-    return active;
+    return slot.scope?.() ?? slot.active;
 }
 export function runWithHead(h, fn) {
-    const prev = active;
-    active = h;
+    const prev = slot.active;
+    slot.active = h;
     try {
         return fn();
     }
     finally {
-        active = prev;
+        slot.active = prev;
     }
 }
 /**
- * Register metadata for the current page/layout. Static, async-resolved, or reactive — values
+ * Resolve the active registry from a host's own request scope, e.g. its AsyncLocalStorage.
+ * Returning nothing falls back to `setActiveHead`. `null` removes the scope.
+ */
+export function setHeadScope(scope) {
+    slot.scope = scope;
+}
+/**
+ * Register metadata for the current page/layout. Static, async-resolved, or reactive, values
  * that are signals update the document live on the client. Returns a disposer (client dynamic use).
  */
 export function useHead(input) {
@@ -75,14 +83,14 @@ export function useHead(input) {
         return () => { };
     }
     const dispose = h.push(input);
-    // Drop the source when the owner (page/layout component) unmounts — this is what makes route
+    // Drop the source when the owner (page/layout component) unmounts, this is what makes route
     // transitions update the head on the client. NOT on the server: there it's a single render and
     // we serialize the head before the root disposes, so the source must survive until then.
     if (typeof window !== 'undefined' && getOwner())
         onCleanup(dispose);
     return dispose;
 }
-/** Ergonomic alias — `seo({ title, description })`. */
+/** Ergonomic alias: `seo({ title, description })`. */
 export const seo = useHead;
 // ---------------------------------------------------------------------------
 // Resolution (expand → dedupe)
@@ -231,6 +239,11 @@ function expand(input, out, ts) {
     const lang = val(input.lang);
     if (lang !== undefined)
         out.push({ tag: 'htmlAttr', key: 'html:lang', name: 'lang', value: lang });
+    for (const [name, raw] of Object.entries(input.htmlAttrs ?? {})) {
+        const value = val(raw);
+        if (value !== undefined)
+            out.push({ tag: 'htmlAttr', key: `html:${name}`, name, value });
+    }
     if (input.charset !== undefined)
         meta('meta:charset', { charset: input.charset });
     if (input.viewport !== undefined)
@@ -251,11 +264,18 @@ function expand(input, out, ts) {
         meta('meta:name:application-name', { name: 'application-name', content: input.applicationName });
     if (input.referrer !== undefined)
         meta('meta:name:referrer', { name: 'referrer', content: input.referrer });
-    if (input.colorScheme !== undefined)
-        meta('meta:name:color-scheme', { name: 'color-scheme', content: input.colorScheme });
+    const scheme = val(input.colorScheme);
+    if (scheme !== undefined)
+        meta('meta:name:color-scheme', { name: 'color-scheme', content: scheme });
     const theme = val(input.themeColor);
-    if (theme !== undefined)
+    if (typeof theme === 'string')
         meta('meta:name:theme-color', { name: 'theme-color', content: theme });
+    // One tag per media query, keyed by it: a later source replaces the same media, not the others.
+    else if (theme) {
+        for (const { color, media } of theme) {
+            meta(`meta:name:theme-color${media ? `:${media}` : ''}`, media ? { name: 'theme-color', content: color, media } : { name: 'theme-color', content: color });
+        }
+    }
     const canonical = val(input.canonical);
     if (canonical !== undefined)
         out.push({ tag: 'link', key: 'link:rel:canonical', attrs: { rel: 'canonical', href: canonical } });
@@ -323,7 +343,7 @@ function applyTemplate(tpl, title) {
 }
 /**
  * Flatten every source (in registration order: layouts first, page last) into tags, then
- * deduplicate by key — last write wins for singletons (title, description, canonical, …),
+ * deduplicate by key: last write wins for singletons (title, description, canonical, …),
  * while repeatable tags (extra og:image, hreflang alternates, json-ld) accumulate.
  */
 export function resolveHead(head) {