npm - @pyreon/head - Versions diffs - 0.5.6 → 0.6.0 - Mend

@pyreon/head 0.5.6 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/lib/analysis/index.js.html +1 -1
package/lib/analysis/provider.js.html +1 -1
package/lib/index.js +2 -4
package/lib/index.js.map +1 -1
package/lib/provider.js +2 -4
package/lib/provider.js.map +1 -1
package/lib/types/index.d.ts +206 -283
package/lib/types/index.d.ts.map +1 -1
package/lib/types/ssr.d.ts +28 -87
package/lib/types/ssr.d.ts.map +1 -1
package/lib/types/use-head.d.ts +126 -202
package/lib/types/use-head.d.ts.map +1 -1
package/package.json +4 -4
package/src/provider.ts +3 -7

package/lib/types/ssr.d.ts CHANGED Viewed

@@ -1,90 +1,31 @@
-import { createContext, h, pushContext } from "@pyreon/core";
-import { renderToString } from "@pyreon/runtime-server";
+import { VNode } 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;
-    }
-  };
+//#region src/ssr.d.ts
+/**
+ * Render a Pyreon app to an HTML fragment + a serialized <head> string.
+ *
+ * The returned `head` string can be injected directly into your HTML template:
+ *
+ * @example
+ * const { html, head } = await renderWithHead(h(App, null))
+ * const page = `<!DOCTYPE html>
+ * <html>
+ *   <head>
+ *     <meta charset="UTF-8" />
+ *     ${head}
+ *   </head>
+ *   <body><div id="app">${html}</div></body>
+ * </html>`
+ */
+interface RenderWithHeadResult {
+  html: string;
+  head: string;
+  /** Attributes to set on the <html> element */
+  htmlAttrs: Record<string, string>;
+  /** Attributes to set on the <body> element */
+  bodyAttrs: Record<string, string>;
 }
-async function renderWithHead(app) {
-  const ctx = createHeadContext();
-  function HeadInjector() {
-    pushContext(new Map([[HeadContext.id, ctx]]));
-    return app;
-  }
-  const html = await renderToString(h(HeadInjector, null));
-  const titleTemplate = ctx.resolveTitleTemplate();
-  return {
-    html,
-    head: ctx.resolve().map(tag => serializeTag(tag, titleTemplate)).join("\n  "),
-    htmlAttrs: ctx.resolveHtmlAttrs(),
-    bodyAttrs: ctx.resolveBodyAttrs()
-  };
-}
-function serializeTag(tag, titleTemplate) {
-  if (tag.tag === "title") {
-    const raw = tag.children || "";
-    return `<title>${esc(titleTemplate ? typeof titleTemplate === "function" ? titleTemplate(raw) : titleTemplate.replace(/%s/g, raw) : raw)}</title>`;
-  }
-  const props = tag.props;
-  const attrs = props ? Object.entries(props).map(([k, v]) => `${k}="${esc(v)}"`).join(" ") : "";
-  const open = attrs ? `<${tag.tag} ${attrs}` : `<${tag.tag}`;
-  if (VOID_TAGS.has(tag.tag)) return `${open} />`;
-  return `${open}>${(tag.children || "").replace(/<\/(script|style|noscript)/gi, "<\\/$1").replace(/<!--/g, "<\\!--")}</${tag.tag}>`;
-}
-function esc(s) {
-  return ESC_RE.test(s) ? s.replace(ESC_RE, ch => ESC_MAP[ch]) : s;
-}
+declare function renderWithHead(app: VNode): Promise<RenderWithHeadResult>;
 //#endregion
-export { renderWithHead };
-//# sourceMappingURL=ssr.d.ts.map
+export { RenderWithHeadResult, renderWithHead };
+//# sourceMappingURL=ssr2.d.ts.map

package/lib/types/ssr.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"~~ssr~~.d.ts","names":[],"sources":["../../../src/~~context.ts","../../../src/~~ssr.ts"],"mappings":"~~;;;;AAqKA~~,~~SAAgB,iBAAA,CAAA,EAAsC~~;~~EACpD~~,~~MAAM,GAAA,GAAA,eAAM,IAAI,GAAA,CAAA,CAAwB;EAGxC,IAAI,KAAA,GAAQ,~~IAAA;~~EACZ~~,IAAI,UAAA,GAAwB,EAAE;EAC9B,IAAI,mBAAA;EACJ,IAAI,eAAA,GAA0C,CAAA,CAAE;EAChD,IAAI,eAAA,GAA0C,CAAA,CAAE;EAEhD,SAAS,OAAA,CAAA,EAAgB;IACvB,IAAI,CAAC,KAAA,EAAO;IACZ,KAAA,GAAQ,KAAA;IAER,MAAM,KAAA,GAAA,eAAQ,IAAI,GAAA,CAAA,CAAsB;IACxC,MAAM,OAAA,GAAqB,EAAE;IAC7B,IAAI,aAAA;IACJ,MAAM,SAAA,GAAoC,CAAA,CAAE;IAC5C,MAAM,SAAA,GAAoC,CAAA,CAAE;IAE5C,KAAK,MAAM,KAAA,IAAS,GAAA,CAAI,MAAA,CAAA,CAAQ,EAAE;MAChC,KAAK,MAAM,GAAA,IAAO,KAAA,CAAM,IAAA~~,EACtB,IAAI,GAAA,CAAI,GAAA,EAAK,KAAA,CAAM,GAAA,CAAI,GAAA,CAAI,GAAA,EAAK,GAAA,CAAI,CAAA,KAC/B,OAAA,CAAQ,IAAA,CAAK,GAAA,CAAI~~;~~MAExB,IAAI,KAAA,CAAM,aAAA,KAAkB,KAAA,CAAA,EAAW,aAAA,GAAgB,KAAA,CAAM,aAAA~~;~~MAC7D~~,~~IAAI,KAAA,CAAM,~~SAAA,EAAW,MAAA~~,CAAO,MAAA,CAAO,SAAA,EAAW,KAAA,CAAM,SAAA,CAAU~~;~~MAC9D~~,~~IAAI,KAAA,CAAM,~~SAAA,EAAW,MAAA~~,CAAO,MAAA,CAAO,SAAA,EAAW,KAAA,CAAM,SAAA,CAAU;;IAGhE,UAAA,GAAa,CAAC,GAAG,KAAA,CAAM,MAAA,CAAA,CAAQ,EAAE,GAAG,OAAA,CAAQ~~;~~IAC5C,mBAAA,GAAsB,aAAA~~;~~IACtB~~,~~eAAA~~,GAAkB,SAAA;IAClB,eAAA,GAAkB,SAAA;;EAGpB,OAAO;IACL,GAAA,CAAI,EAAA,EAAI,KAAA,EAAO;MACb,GAAA,CAAI,GAAA,CAAI,EAAA,EAAI,KAAA,CAAM;MAClB,KAAA,GAAQ,IAAA;;IAEV,MAAA,CAAO,EAAA,EAAI;MACT,GAAA,CAAI,MAAA,CAAO,EAAA,CAAG;MACd,KAAA,GAAQ,IAAA;;IAEV,OAAA,CAAA,EAAU;MACR,OAAA,CAAA,CAAS;MACT,OAAO,UAAA;;IAET,oBAAA,CAAA,EAAuB;MACrB,OAAA,CAAA,CAAS;MACT,OAAO,mBAAA;;IAET,gBAAA,CAAA,EAAmB;MACjB,OAAA,CAAA,CAAS;MACT,OAAO,eAAA;;IAET,gBAAA,CAAA,EAAmB;MACjB,OAAA,CAAA,CAAS;MACT,OAAO,eAAA;;GAEV;;ACjMH,eAAsB,cAAA,CAAe,GAAA,EAA2C;EAC9E,MAAM,GAAA,GAAM,iBAAA,CAAA,CAAmB;EAI/B,SAAS,YAAA,CAAA,EAAsB;IAC7B,WAAA,CAAY,IAAI,GAAA,CAAI,CAAC,CAAC,WAAA,CAAY,EAAA,EAAI,GAAA,CAAI,CAAC,CAAC,CAAC;IAC7C,OAAO,GAAA;;EAGT,MAAM,IAAA,GAAO,MAAM,cAAA,CAAe,CAAA,CAAE,YAAA,EAA6B,IAAA,CAAK,CAAC;EACvE,MAAM,aAAA,GAAgB,GAAA,CAAI,oBAAA,CAAA,CAAsB;EAKhD,OAAO;IACL,IAAA;IACA,IAAA,EANW,GAAA,CACV,OAAA,CAAA,CAAS,CACT,GAAA,CAAK,GAAA,IAAQ,YAAA,CAAa,GAAA,EAAK,aAAA,CAAc,CAAC,CAC9C,IAAA,CAAK,MAAA,CAAO;IAIb,SAAA,EAAW,GAAA,CAAI,gBAAA,CAAA,CAAkB;IACjC,SAAA,EAAW,GAAA,CAAI,gBAAA,CAAA;GAChB;;AAGH,SAAS,YAAA,CAAa,GAAA,EAAc,aAAA,EAA8D;EAChG,IAAI,GAAA,CAAI,GAAA,KAAQ,OAAA,EAAS;IACvB,MAAM,GAAA,GAAM,GAAA,CAAI,QAAA,IAAY,EAAA;IAM5B,OAAO,UAAU,GAAA,CALH,aAAA,GACV,OAAO,aAAA,KAAkB,UAAA,GACvB,aAAA,CAAc,GAAA,CAAI,GAClB,aAAA,CAAc,OAAA,CAAQ,KAAA,~~EAAO,GAAA,CAAI,GACnC,GAAA,CACuB,UAAC;;EAE9B,MAAM,KAAA,~~GAAQ,~~GAAA,CAAI,KAAA;EAClB,MAAM,KAAA,GAAQ,KAAA,GACV,MAAA,CAAO,~~OAAA,CAAQ,KAAA,CAAM,CAClB,GAAA,CAAA,CAAK,CAAC,CAAA,EAAG,CAAA,CAAA,KAAO,GAAG,CAAA,KAAM,GAAA,CAAI,CAAA,CAAE,GAAC,CAAG,CACnC,IAAA,CAAK,GAAA,CAAI,GACZ,EAAA;EACJ,MAAM,IAAA,GAAO,KAAA,GAAQ,IAAI,GAAA,CAAI,GAAA,IAAO,KAAA,EAAA,GAAU,IAAI,GAAA,CAAI,GAAA,EAAA;EACtD,IAAI,SAAA,CAAU,GAAA,CAAI,GAAA,CAAI,GAAA,CAAI,EAAE,OAAO,GAAG,IAAA,KAAK;EAM3C,OAAO,GAAG,IAAA,IAAK,CALC,GAAA,CAAI,QAAA,IAAY,EAAA,EAIX,OAAA,CAAQ,8BAAA,EAAgC,QAAA,CAAS,CAAC,OAAA,CAAQ,OAAA,EAAS,QAAA,CAAS,KACtE,GAAA,CAAI,GAAA,GAAI;;AAMrC,SAAS,GAAA,CAAI,CAAA,EAAmB;EAC9B,OAAO,MAAA,CAAO,IAAA,CAAK,CAAA,CAAE,GAAG,CAAA,CAAE,OAAA,CAAQ,MAAA,EAAS,EAAA,IAAO,OAAA,CAAQ,EAAA,CAAA,CAAc,GAAG,CAAA"}
1	+ {"version":3,"file":"ssr2.d.ts","names":[],"sources":["../../../src/ssr.ts"],"mappings":";;;;;AAwBA;;;;;;;;;;;;AASA;;UATiB,oBAAA;EACf,IAAA;EACA,IAAA;EAOgD;EALhD,SAAA,EAAW,MAAA;EAK4C;EAHvD,SAAA,EAAW,MAAA;AAAA;AAAA,iBAGS,cAAA,CAAe,GAAA,EAAK,KAAA,GAAQ,OAAA,CAAQ,oBAAA"}

package/lib/types/use-head.d.ts CHANGED Viewed

@@ -1,212 +1,136 @@
-import { createContext, onMount, onUnmount, useContext } from "@pyreon/core";
-import { effect } from "@pyreon/reactivity";
-//#region src/context.ts
-/**
-* Sync the resolved head tags to the real DOM <head>.
-* Uses incremental diffing: matches existing elements by key, patches attributes
-* in-place, adds new elements, and removes stale ones.
-* Also syncs htmlAttrs, bodyAttrs, and applies titleTemplate.
-* No-op on the server (typeof document === "undefined").
-*/
-function patchExistingTag(found, tag, kept) {
-  kept.add(found.getAttribute(ATTR));
-  patchAttrs(found, tag.props);
-  const content = String(tag.children);
-  if (found.textContent !== content) found.textContent = content;
+//#region src/context.d.ts
+/** 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;
 }
-function createNewTag(tag) {
-  const el = document.createElement(tag.tag);
-  const key = tag.key;
-  el.setAttribute(ATTR, key);
-  for (const [k, v] of Object.entries(tag.props)) el.setAttribute(k, v);
-  if (tag.children) el.textContent = tag.children;
-  document.head.appendChild(el);
-  managedElements.set(key, el);
+/** 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;
 }
-function syncDom(ctx) {
-  if (typeof document === "undefined") return;
-  const tags = ctx.resolve();
-  const titleTemplate = ctx.resolveTitleTemplate();
-  let needsSeed = managedElements.size === 0;
-  if (!needsSeed) {
-    const sample = managedElements.values().next().value;
-    if (sample && !sample.isConnected) {
-      managedElements.clear();
-      needsSeed = true;
-    }
-  }
-  if (needsSeed) {
-    const existing = document.head.querySelectorAll(`[${ATTR}]`);
-    for (const el of existing) managedElements.set(el.getAttribute(ATTR), el);
-  }
-  const kept = /* @__PURE__ */new Set();
-  for (const tag of tags) {
-    if (tag.tag === "title") {
-      document.title = applyTitleTemplate(String(tag.children), titleTemplate);
-      continue;
-    }
-    const key = tag.key;
-    const found = managedElements.get(key);
-    if (found && found.tagName.toLowerCase() === tag.tag) patchExistingTag(found, tag, kept);else {
-      if (found) {
-        found.remove();
-        managedElements.delete(key);
-      }
-      createNewTag(tag);
-      kept.add(key);
-    }
-  }
-  for (const [key, el] of managedElements) if (!kept.has(key)) {
-    el.remove();
-    managedElements.delete(key);
-  }
-  syncElementAttrs(document.documentElement, ctx.resolveHtmlAttrs());
-  syncElementAttrs(document.body, ctx.resolveBodyAttrs());
+/** 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;
 }
-/** Patch an element's attributes to match the desired props. */
-function patchAttrs(el, props) {
-  for (let i = el.attributes.length - 1; i >= 0; i--) {
-    const attr = el.attributes[i];
-    if (!attr || attr.name === ATTR) continue;
-    if (!(attr.name in props)) el.removeAttribute(attr.name);
-  }
-  for (const [k, v] of Object.entries(props)) if (el.getAttribute(k) !== v) el.setAttribute(k, v);
+/** 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;
 }
-function applyTitleTemplate(title, template) {
-  if (!template) return title;
-  if (typeof template === "function") return template(title);
-  return template.replace(/%s/g, title);
+/** 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";
 }
-/** Sync pyreon-managed attributes on <html> or <body>. */
-function syncElementAttrs(el, attrs) {
-  const managed = el.getAttribute(`${ATTR}-attrs`);
-  if (managed) {
-    for (const name of managed.split(",")) if (name && !(name in attrs)) el.removeAttribute(name);
-  }
-  const keys = [];
-  for (const [k, v] of Object.entries(attrs)) {
-    keys.push(k);
-    if (el.getAttribute(k) !== v) el.setAttribute(k, v);
-  }
-  if (keys.length > 0) el.setAttribute(`${ATTR}-attrs`, keys.join(","));else if (managed) el.removeAttribute(`${ATTR}-attrs`);
+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>[];
+  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>;
 }
 //#endregion
-//#region src/use-head.ts
-/** Cast a strict tag interface to the internal props format, stripping undefined values */
-function toProps(obj) {
-  const result = {};
-  for (const [k, v] of Object.entries(obj)) if (v !== void 0) result[k] = v;
-  return result;
-}
-function buildEntry(o) {
-  const tags = [];
-  if (o.title != null) tags.push({
-    tag: "title",
-    key: "title",
-    children: o.title
-  });
-  o.meta?.forEach((m, i) => {
-    tags.push({
-      tag: "meta",
-      key: m.name ?? m.property ?? `meta-${i}`,
-      props: toProps(m)
-    });
-  });
-  o.link?.forEach((l, i) => {
-    tags.push({
-      tag: "link",
-      key: l.href ? `link-${l.rel || ""}-${l.href}` : l.rel ? `link-${l.rel}` : `link-${i}`,
-      props: toProps(l)
-    });
-  });
-  o.script?.forEach((s, i) => {
-    const {
-      children,
-      ...rest
-    } = s;
-    tags.push({
-      tag: "script",
-      key: s.src ?? `script-${i}`,
-      props: toProps(rest),
-      ...(children != null ? {
-        children
-      } : {})
-    });
-  });
-  o.style?.forEach((s, i) => {
-    const {
-      children,
-      ...rest
-    } = s;
-    tags.push({
-      tag: "style",
-      key: `style-${i}`,
-      props: toProps(rest),
-      children
-    });
-  });
-  o.noscript?.forEach((ns, i) => {
-    tags.push({
-      tag: "noscript",
-      key: `noscript-${i}`,
-      children: ns.children
-    });
-  });
-  if (o.jsonLd) tags.push({
-    tag: "script",
-    key: "jsonld",
-    props: {
-      type: "application/ld+json"
-    },
-    children: JSON.stringify(o.jsonLd)
-  });
-  if (o.base) tags.push({
-    tag: "base",
-    key: "base",
-    props: toProps(o.base)
-  });
-  return {
-    tags,
-    titleTemplate: o.titleTemplate,
-    htmlAttrs: o.htmlAttrs,
-    bodyAttrs: o.bodyAttrs
-  };
-}
+//#region src/use-head.d.ts
 /**
-* Register head tags (title, meta, link, script, style, noscript, base, jsonLd)
-* for the current component.
-*
-* Accepts a static object or a reactive getter:
-*   useHead({ title: "My Page", meta: [{ name: "description", content: "..." }] })
-*   useHead(() => ({ title: `${count()} items` }))  // updates when signal changes
-*
-* Tags are deduplicated by key — innermost component wins.
-* Requires a <HeadProvider> (CSR) or renderWithHead() (SSR) ancestor.
-*/
-function useHead(input) {
-  const ctx = useContext(HeadContext);
-  if (!ctx) return;
-  const id = Symbol();
-  if (typeof input === "function") {
-    if (typeof document !== "undefined") effect(() => {
-      ctx.add(id, buildEntry(input()));
-      syncDom(ctx);
-    });else ctx.add(id, buildEntry(input()));
-  } else {
-    ctx.add(id, buildEntry(input));
-    onMount(() => {
-      syncDom(ctx);
-    });
-  }
-  onUnmount(() => {
-    ctx.remove(id);
-    syncDom(ctx);
-  });
-}
+ * Register head tags (title, meta, link, script, style, noscript, base, jsonLd)
+ * for the current component.
+ *
+ * Accepts a static object or a reactive getter:
+ *   useHead({ title: "My Page", meta: [{ name: "description", content: "..." }] })
+ *   useHead(() => ({ title: `${count()} items` }))  // updates when signal changes
+ *
+ * Tags are deduplicated by key — innermost component wins.
+ * Requires a <HeadProvider> (CSR) or renderWithHead() (SSR) ancestor.
+ */
+declare function useHead(input: UseHeadInput | (() => UseHeadInput)): void;
 //#endregion
 export { useHead };
-//# sourceMappingURL=use-head.d.ts.map
+//# sourceMappingURL=use-head2.d.ts.map

package/lib/types/use-head.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"use-~~head~~.d.ts","names":[],"sources":["../../../src/context.ts","../../../src/~~dom.ts","../../../src/~~use-head.ts"],"mappings":"~~;;;;;;;;;;;;ACcA~~,~~SAAS~~,~~gBAAA,CACP,KAAA,EACA,GAAA,EACA,~~IAAA,~~EACM~~;~~EACN~~,~~IAAA,CAAK,GAAA,CAAI,KAAA,CAAM,~~YAAA~~,CAAa,IAAA,CAAK,CAAW~~;~~EAC5C,UAAA,CAAW,KAAA,EAAO,GAAA,CAAI,KAAA,CAAgC~~;~~EACtD~~,~~MAAM,~~OAAA~~,GAAU,MAAA,CAAO,GAAA,CAAI,QAAA,CAAS~~;~~EACpC~~,~~IAAI,KAAA,CAAM,WAAA,KAAgB,~~OAAA~~,EAAS,KAAA,CAAM,WAAA,GAAc,OAAA;;AAGzD,SAAS,YAAA,CAAa,GAAA,EAKb~~;~~EACP~~,~~MAAM,EAAA,GAAK,~~QAAA~~,CAAS,aAAA,CAAc,GAAA,CAAI,GAAA,CAAI~~;~~EAC1C,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA~~;~~EAChB~~,~~EAAA,CAAG,YAAA,CAAa,IAAA,EAAM,GAAA,CAAI;EAC1B,KAAK,MAAM,CAAC,CAAA,EAAG,CAAA,CAAA,IAAM,MAAA,CAAO,OAAA,CAAQ,GAAA,CAAI,~~KAAA~~,CAAgC,EACtE,EAAA,CAAG,YAAA,CAAa,CAAA,EAAG,CAAA,CAAE~~;~~EAEvB,IAAI,GAAA,CAAI,QAAA,EAAU,EAAA,CAAG,WAAA,GAAc,GAAA,CAAI,QAAA;EACvC,QAAA,CAAS,IAAA,CAAK,WAAA,CAAY,EAAA,CAAG;EAC7B,eAAA,CAAgB,GAAA,CAAI,GAAA,EAAK,EAAA,CAAG~~;;~~AAG9B~~,~~SAAgB,~~OAAA~~,CAAQ,GAAA,EAA6B~~;~~EACnD,IAAI,OAAO,QAAA,KAAa,WAAA,EAAa~~;~~EAErC~~,~~MAAM,IAAA,GAAO,~~GAAA~~,CAAI,OAAA,CAAA,CAAS~~;~~EAC1B,MAAM,aAAA,GAAgB,GAAA,CAAI,oBAAA,CAAA,CAAsB~~;~~EAGhD~~,~~IAAI,SAAA,GAAY,eAAA,CAAgB,~~IAAA~~,KAAS,CAAA~~;~~EACzC~~,~~IAAI,CAAC,SAAA,EAAW~~;~~IAEd~~,~~MAAM,MAAA,GAAS,eAAA,CAAgB,MAAA,CAAA,CAAQ,CAAC,~~IAAA~~,CAAA,CAAM,CAAC,KAAA~~;~~IAC/C,IAAI,MAAA,IAAU,CAAC,MAAA,CAAO,WAAA,EAAa~~;~~MACjC~~,~~eAAA,CAAgB,~~KAAA~~,CAAA,CAAO~~;~~MACvB,SAAA,GAAY,IAAA;;;EAGhB,IAAI,SAAA,EAAW~~;~~IACb~~,~~MAAM,QAAA,GAAW,QAAA,CAAS,IAAA,CAAK,gBAAA,CAAiB,IAAI,IAAA,GAAK,CAAG~~;~~IAC5D,KAAK,MAAM,EAAA,IAAM,QAAA,EACf,eAAA,CAAgB,GAAA,CAAI,EAAA,CAAG,YAAA,CAAa,IAAA,CAAK,EAAY,EAAA,CAAG;;EAI5D,MAAM,IAAA,GAAA,eAAO,IAAI,GAAA,CAAA,CAAa~~;~~EAE9B~~,~~KAAK,MAAM,GAAA,IAAO,IAAA,EAAM~~;~~IACtB,IAAI,GAAA,CAAI,GAAA,KAAQ,OAAA,EAAS~~;~~MACvB~~,~~QAAA,CAAS,~~KAAA~~,GAAQ,kBAAA,CAAmB,MAAA,CAAO,GAAA,CAAI,QAAA,CAAS,EAAE,aAAA,CAAc~~;~~MACxE;;IAGF,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA~~;~~IAChB~~,~~MAAM,KAAA,GAAQ,eAAA,CAAgB,GAAA,CAAI,GAAA,CAAI~~;~~IAEtC,IAAI,KAAA,IAAS,KAAA,CAAM,OAAA,CAAQ,WAAA,CAAA,CAAa,KAAK,GAAA,CAAI,GAAA,EAC/C,gBAAA,CAAiB,KAAA,EAAO,GAAA,EAA6D,IAAA,CAAK,CAAA,KACrF~~;~~MACL~~,~~IAAI,~~KAAA~~,EAAO~~;~~QACT,KAAA,CAAM,MAAA,CAAA,CAAQ~~;~~QACd~~,~~eAAA,CAAgB,MAAA,CAAO,GAAA,CAAI;;MAE7B,YAAA,CACE,GAAA,CACD~~;~~MACD,IAAA,CAAK,GAAA,CAAI,GAAA,CAAI;;;EAKjB,KAAK,MAAM,CAAC,GAAA,EAAK,EAAA,CAAA,IAAO,eAAA,EACtB,IAAI,CAAC,IAAA,CAAK,GAAA,CAAI,GAAA,CAAI,EAAE~~;~~IAClB~~,~~EAAA,CAAG,MAAA,CAAA,CAAQ~~;~~IACX,eAAA,CAAgB,MAAA,CAAO,GAAA,CAAI;;EAI/B,gBAAA,CAAiB,QAAA,CAAS,eAAA,EAAiB,GAAA,CAAI,gBAAA,CAAA,CAAkB,CAAC~~;~~EAClE~~,~~gBAAA,CAAiB,QAAA,CAAS,IAAA,EAAM,GAAA,CAAI,gBAAA,CAAA,CAAkB,CAAC;;;AAIzD,SAAS,UAAA,CAAW,EAAA,EAAa,KAAA,EAAqC~~;~~EACpE,KAAK,IAAI,CAAA,GAAI,EAAA,CAAG,UAAA,CAAW,MAAA,GAAS,CAAA,EAAG,CAAA,IAAK,CAAA,EAAG,CAAA,EAAA,EAAK~~;~~IAClD~~,~~MAAM,IAAA,GAAO,EAAA,CAAG,~~UAAA~~,CAAW,CAAA,CAAA~~;~~IAC3B,IAAI,CAAC,IAAA,IAAQ,IAAA,CAAK,IAAA,KAAS,IAAA,EAAM~~;~~IACjC~~,IAAI,EAAE,IAAA,CAAK,IAAA,IAAQ,KAAA,CAAA,EAAQ,EAAA,CAAG,eAAA,CAAgB,IAAA,CAAK,IAAA,CAAK;;EAE1D,KAAK,MAAM,CAAC,CAAA,EAAG,CAAA,CAAA,IAAM,MAAA,CAAO,OAAA,CAAQ,KAAA,CAAM,EACxC,IAAI,EAAA,CAAG,YAAA,CAAa,CAAA,CAAE,KAAK,CAAA,EAAG,EAAA,CAAG,YAAA,CAAa,CAAA,EAAG,CAAA,CAAE;;AAIvD,SAAS,kBAAA,CACP,KAAA,EACA,QAAA~~,EACQ~~;~~EACR,IAAI,CAAC,QAAA,EAAU,OAAO,KAAA~~;~~EACtB~~,~~IAAI,OAAO,QAAA,KAAa,UAAA,EAAY,OAAO,QAAA,CAAS,~~KAAA~~,CAAM~~;~~EAC1D~~,~~OAAO,QAAA,CAAS,OAAA,CAAQ,KAAA,EAAO,KAAA,CAAM;;;AAIvC,SAAS,gBAAA,CAAiB,EAAA,EAAa,KAAA,EAAqC~~;~~EAE1E,MAAM,OAAA,GAAU,EAAA,CAAG,YAAA,CAAa,GAAG,IAAA,QAAK,CAAQ~~;~~EAChD~~,~~IAAI,OAAA,EACF;SAAK,MAAM,IAAA,IAAQ,OAAA,CAAQ,KAAA,CAAM,~~GAAA~~,CAAI,EACnC,IAAI,IAAA,IAAQ,EAAE,IAAA,IAAQ,KAAA,CAAA,EAAQ,EAAA,CAAG,eAAA,CAAgB,IAAA,CAAK;;EAG1D,MAAM,IAAA,GAAiB,EAAE~~;~~EACzB,KAAK,MAAM,CAAC,CAAA,EAAG,CAAA,CAAA,IAAM,MAAA,CAAO,OAAA,CAAQ,KAAA,CAAM,EAAE~~;~~IAC1C~~,IAAA~~,CAAK,IAAA,CAAK,CAAA,CAAE;IACZ,IAAI,EAAA,CAAG,YAAA,CAAa,CAAA,CAAE,KAAK,CAAA,EAAG,EAAA,CAAG,YAAA,CAAa,CAAA,EAAG,CAAA,CAAE~~;;~~EAErD~~,IAAI,IAAA,CAAK,MAAA,GAAS,CAAA,EAChB,EAAA,CAAG,YAAA,CAAa,GAAG,IAAA,QAAK,EAAS,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,CAAC,CAAA,SACvC,OAAA,EACT,EAAA,CAAG,eAAA,CAAgB,GAAG,IAAA,QAAK,CAAQ;;;;;;ACrIvC,SAAS,OAAA,CAAQ,GAAA,EAAiE;~~EAChF,MAAM,MAAA,GAAiC,CAAA,CAAE~~;~~EACzC~~,~~KAAK,MAAM,CAAC,CAAA,EAAG,CAAA,CAAA,IAAM,MAAA,CAAO,OAAA,CAAQ,GAAA,CAAI,EACtC,IAAI,CAAA,KAAM,~~KAAA~~,CAAA,EAAW,MAAA,CAAO,CAAA,CAAA,GAAK,CAAA~~;~~EAEnC,OAAO,MAAA;;AAGT,SAAS,UAAA,CAAW,CAAA,EAA4B~~;~~EAC9C~~,~~MAAM,IAAA,GAAkB,EAAE~~;~~EAC1B,IAAI,CAAA,CAAE,KAAA,IAAS,IAAA,EAAM,IAAA,CAAK,IAAA,CAAK~~;~~IAAE~~,~~GAAA,EAAK,OAAA~~;~~IAAS,GAAA,EAAK,OAAA~~;~~IAAS~~,QAAA~~,EAAU,CAAA,CAAE~~;~~GAAO,CAAC~~;~~EACjF~~,~~CAAA,CAAE,IAAA,EAAM,OAAA,CAAA,CAAS,CAAA,EAAG,CAAA,KAAM~~;~~IACxB,IAAA,CAAK,IAAA,CAAK~~;~~MACR~~,~~GAAA,EAAK,MAAA~~;~~MACL~~,~~GAAA,EAAK,CAAA,CAAE,IAAA,IAAQ,CAAA,CAAE,~~QAAA~~,IAAY,QAAQ,CAAA,EAAA~~;~~MACrC~~,~~KAAA,EAAO,OAAA,CAAQ,CAAA~~;~~KAChB,CAAC~~;~~IACF;EACF~~,~~CAAA,CAAE,IAAA,EAAM,OAAA,CAAA,CAAS,CAAA,EAAG,CAAA,KAAM~~;~~IACxB,IAAA,CAAK,IAAA,CAAK~~;~~MACR~~,~~GAAA,EAAK,MAAA~~;~~MACL,GAAA,EAAK,CAAA,CAAE,IAAA,GAAO,QAAQ,CAAA,CAAE,GAAA,IAAO,EAAA,IAAM,CAAA,CAAE,IAAA,EAAA,GAAS,CAAA,CAAE,GAAA,GAAM,QAAQ,CAAA,CAAE,GAAA,EAAA,GAAQ,QAAQ,CAAA,EAAA~~;~~MAClF~~,KAAA~~,EAAO,OAAA,CAAQ,CAAA~~;~~KAChB,CAAC~~;~~IACF;EACF~~,~~CAAA,CAAE,MAAA,EAAQ,OAAA,CAAA,CAAS,CAAA,EAAG,CAAA,KAAM~~;~~IAC1B,MAAM~~;~~MAAE~~,QAAA;~~MAAU~~,~~GAAG~~;~~IAAA,CAAA,GAAS,CAAA~~;~~IAC9B~~,IAAA~~,CAAK,IAAA,CAAK~~;~~MACR,GAAA,EAAK,QAAA~~;~~MACL~~,~~GAAA,EAAK,CAAA,CAAE,GAAA,IAAO,UAAU,CAAA,EAAA~~;~~MACxB,KAAA,EAAO,OAAA,CAAQ,IAAA,CAA2C~~;~~MAC1D~~,~~IAAI~~,~~QAAA,IAAY,IAAA,GAAO~~;~~QAAE;MAAA~~,~~CAAU,GAAG,CAAA,CAAE~~;~~KACzC~~,~~CAAC;IACF;EACF~~,~~CAAA~~,~~CAAE,~~KAAA~~,EAAO,OAAA,CAAA,CAAS,CAAA,EAAG,CAAA,KAAM~~;~~IACzB~~,~~MAAM;MAAE,QAAA;MAAU,GAAG;~~IAAA,~~CAAA~~,~~GAAS,CAAA~~;~~IAC9B~~,IAAA,~~CAAK~~,~~IAAA,CAAK;MACR,GAAA,EAAK,~~OAAA;~~MACL~~,~~GAAA~~,~~EAAK~~,~~SAAS,CAAA,EAAA~~;~~MACd~~,KAAA,~~EAAO~~,~~OAAA,CAAQ,IAAA,CAA2C;MAC1D;KACD,CAAC;IACF;EACF,CAAA,CAAE,~~QAAA~~,EAAU,OAAA,CAAA,CAAS,EAAA,EAAI,CAAA,KAAM~~;~~IAC7B~~,~~IAAA,CAAK,IAAA,CAAK;MAAE,GAAA,EAAK,UAAA;MAAY,GAAA,EAAK,YAAY,CAAA,EAAA;MAAK,~~QAAA~~,EAAU,EAAA,CAAG~~;~~KAAU~~,~~CAAC;IAC3E;EACF,IAAI,CAAA,CAAE,MAAA,EACJ,IAAA,CAAK,IAAA,CAAK;IACR,GAAA,EAAK,~~QAAA;~~IACL~~,~~GAAA,EAAK,QAAA;IACL,KAAA,EAAO;MAAE,IAAA,EAAM;IAAA,CAAuB;IACtC,QAAA,EAAU,IAAA,CAAK,SAAA,CAAU,CAAA,CAAE,~~MAAA~~;GAC5B~~,~~CAAC;EAEJ~~,~~IAAI,CAAA,CAAE,IAAA,EACJ,IAAA,CAAK,IAAA,CAAK;IACR,GAAA,EAAK,~~MAAA~~;IACL~~,~~GAAA~~,~~EAAK,~~MAAA;~~IACL~~,~~KAAA~~,~~EAAO~~,OAAA,~~CAAQ,CAAA,CAAE,IAAA;GAClB,CAAC;EACJ,OAAO;IACL,IAAA;IACA,aAAA,EAAe,CAAA,CAAE,aAAA;IACjB,~~SAAA,~~EAAW~~,~~CAAA~~,~~CAAE,~~SAAA~~;IACb~~,~~SAAA~~,~~EAAW,CAAA,CAAE;GACd;;;;;;;;;;;;;AAcH,SAAgB,OAAA,CAAQ,KAAA,EAAkD;EACxE,MAAM,GAAA,GAAM,UAAA,CAAW,WAAA,CAAY;EACnC,IAAI,CAAC,GAAA,EAAK;EAEV,MAAM,EAAA,GAAK,~~MAAA~~,CAAA,CAAQ~~;~~EAEnB~~,~~IAAI,OAAO,KAAA,KAAU,UAAA;IACnB,IAAI,OAAO,QAAA,KAAa,WAAA,EAEtB,MAAA,CAAA,MAAa;MACX,GAAA,CAAI,GAAA,CAAI,EAAA,EAAI,UAAA,CAAW,KAAA,CAAA,CAAO,CAAC,CAAC;MAChC,~~OAAA,CAAQ,~~GAAA,CAAI;MACZ,CAAA,KAGF,GAAA,CAAI,GAAA,CAAI,EAAA,EAAI,UAAA,CAAW,~~KAAA,~~CAAA~~,~~CAAO~~,~~CAAC~~,CAAC;EAAA,OAE7B;IACL,GAAA,CAAI,GAAA,CAAI,EAAA,EAAI,UAAA,CAAW,KAAA,CAAM,CAAC;IAC9B,OAAA,CAAA,MAAc;MACZ,OAAA,CAAQ,GAAA,CAAI;MACZ;;EAGJ,SAAA,CAAA,MAAgB;IACd,GAAA,CAAI,MAAA,CAAO,EAAA,CAAG;IACd,OAAA,CAAQ,GAAA,CAAI;IACZ"}
1	+ {"version":3,"file":"use-head2.d.ts","names":[],"sources":["../../../src/context.ts","../../../src/use-head.ts"],"mappings":";;UAsBiB,OAAA;EAkBA;EAhBf,IAAA;;EAEA,QAAA;EAgBA;EAdA,YAAA;EAkBA;EAhBA,OAAA;EAoBA;EAlBA,OAAA;EAsBA;EApBA,QAAA;EAwBA;EAtBA,KAAA;AAAA;;UAIe,OAAA;EA4Bf;EA1BA,GAAA;EA8BA;EA5BA,IAAA;EA4BK;EA1BL,EAAA;EA8BwB;EA5BxB,IAAA;EA4BwB;EA1BxB,KAAA;EA8BA;EA5BA,WAAA;EAgCA;EA9BA,SAAA;EAkCA;EAhCA,KAAA;EAoCA;EAlCA,QAAA;EAsCA;EApCA,KAAA;EAoCQ;EAlCR,aAAA;EAsCuB;EApCvB,cAAA;EAoCuB;EAlCvB,WAAA;EAsCA;EApCA,UAAA;EAwCA;EAtCA,QAAA;EAwCQ;EAtCR,KAAA;AAAA;;UAIe,SAAA;EAwCf;EAtCA,GAAA;EA2Ce;EAzCf,IAAA;;EAEA,KAAA;EAgDO;EA9CP,KAAA;EAgDQ;EA9CR,WAAA;EAiDmC;EA/CnC,SAAA;EAkDY;EAhDZ,QAAA;EAkDkB;EAhDlB,cAAA;EA8BA;EA5BA,aAAA;EAkC2B;EAhC3B,QAAA;AAAA;;UAIe,QAAA;EA+Bf;EA7BA,QAAA;EA8BA;EA5BA,KAAA;EA6BA;EA3BA,KAAA;EA6BA;EA3BA,KAAA;EA2BmC;EAzBnC,QAAA;AAAA;;UAIe,OAAA;EA0Bf;EAxBA,IAAA;EAwBkB;EAtBlB,MAAA;AAAA;AAAA,UAGe,YAAA;EACf,KAAA;ECpCc;;;;;ED0Cd,aAAA,cAA2B,KAAA;EAC3B,IAAA,GAAO,OAAA;EACP,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,SAAA;EACT,KAAA,GAAQ,QAAA;EACR,QAAA;IAAa,QAAA;EAAA;;EAEb,MAAA,GAAS,MAAA,oBAA0B,MAAA;EACnC,IAAA,GAAO,OAAA;;EAEP,SAAA,GAAY,MAAA;;EAEZ,SAAA,GAAY,MAAA;AAAA;;;;;AAtHd;;;;;;;;;iBCgEgB,OAAA,CAAQ,KAAA,EAAO,YAAA,UAAsB,YAAA"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/head",
-  "version": "0.5.6",
+  "version": "0.6.0",
   "description": "Head tag management for Pyreon — works in SSR and CSR",
   "license": "MIT",
   "repository": {
@@ -54,9 +54,9 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@pyreon/core": "^0.5.6",
-    "@pyreon/reactivity": "^0.5.6",
-    "@pyreon/runtime-server": "^0.5.6"
+    "@pyreon/core": "^0.6.0",
+    "@pyreon/reactivity": "^0.6.0",
+    "@pyreon/runtime-server": "^0.6.0"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "*",

package/src/provider.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import type { ComponentFn, Props, VNodeChild } from "@pyreon/core"
-import { onUnmount, popContext, pushContext } from "@pyreon/core"
+import { provide } from "@pyreon/core"
 import type { HeadContextValue } from "./context"
 import { createHeadContext, HeadContext } from "./context"
@@ -24,12 +24,8 @@ export interface HeadProviderProps extends Props {
  */
 export const HeadProvider: ComponentFn<HeadProviderProps> = (props) => {
   const ctx = props.context ?? createHeadContext()
-  // Push context frame synchronously (before children mount) so all descendants
-  // can read HeadContext via useContext(). Pop on unmount for correct cleanup.
-  const frame = new Map([[HeadContext.id, ctx]])
-  pushContext(frame)
-  onUnmount(() => popContext())
+  provide(HeadContext, ctx)
   const ch = props.children
-  return (typeof ch === "function" ? (ch as () => VNodeChild)() : ch) as ReturnType<ComponentFn>
+  return typeof ch === "function" ? (ch as () => VNodeChild)() : ch
 }