alepha 0.21.2 → 0.22.0

package/dist/react/head/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.browser.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {\n      htmlAttributes: { lang: \"en\" },\n    };\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  /**\n   * Fully resolve all global $head entries (functions re-evaluated, objects kept as-is).\n   *\n   * Unlike resolveGlobalHead() which only extracts htmlAttributes for streaming,\n   * this resolves all head properties (meta, link, script, htmlAttributes, etc.).\n   *\n   * Used by BrowserHeadProvider.refreshGlobalHead() to re-apply global head to the DOM.\n   */\n  public resolveGlobal(): Head {\n    let head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      const { meta, link } = this.seoExpander.expand(resolved);\n      head = {\n        ...head,\n        ...resolved,\n        meta: [...(head.meta ?? []), ...meta, ...(resolved.meta ?? [])],\n        link: [...(head.link ?? []), ...link, ...(resolved.link ?? [])],\n        script: [...(head.script ?? []), ...(resolved.script ?? [])],\n      };\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n\n    // Defaults if none were set by global $head or page head\n    state.head.title ??= \"App\";\n    state.head.htmlAttributes = {\n      lang: \"en\",\n      ...state.head.htmlAttributes,\n    };\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  /**\n   * Re-evaluate all global $head entries and apply the result to the DOM.\n   *\n   * Call this when something that affects global $head output changes at runtime\n   * (e.g., theme switch). Page-level head (title, meta from routes) is not touched.\n   */\n  public refreshGlobalHead(): void {\n    const head = this.headProvider.resolveGlobal();\n    this.renderHead(this.document, head);\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          if (it.media) {\n            link.setAttribute(\"media\", it.media);\n          }\n          if (it.sizes) {\n            link.setAttribute(\"sizes\", it.sizes);\n          }\n          if (it.hreflang) {\n            link.setAttribute(\"hreflang\", it.hreflang);\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    // Plain string → inline script. Dedupe by exact content match against\n    // any existing inline script (handles SSR-emitted globals that would\n    // otherwise be re-appended on hydration).\n    if (typeof script === \"string\") {\n      if (this.findInlineScriptByContent(document, script)) return;\n      const el = document.createElement(\"script\");\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // src-based scripts: dedupe by src attribute (existing behaviour).\n    if (attrs.src) {\n      if (document.querySelector(`script[src=\"${attrs.src}\"]`)) return;\n    } else if (typeof attrs.id === \"string\") {\n      // id-based dedupe — single source of truth per id.\n      if (document.querySelector(`script#${CSS.escape(attrs.id)}`)) return;\n    } else if (content) {\n      // Inline scripts with `content` and no src/id: fall back to content match.\n      if (this.findInlineScriptByContent(document, content)) return;\n    }\n\n    const el = document.createElement(\"script\");\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n    if (content) {\n      el.textContent = content;\n    }\n    document.head.appendChild(el);\n  }\n\n  /**\n   * Find an existing inline `<script>` tag (no `src`) with matching textContent.\n   * Used to make `renderScriptTag` idempotent across hydration + navigation,\n   * so SSR-emitted global scripts aren't re-appended client-side.\n   */\n  protected findInlineScriptByContent(\n    document: Document,\n    content: string,\n  ): Element | null {\n    for (const existing of document.head.querySelectorAll(\n      \"script:not([src])\",\n    )) {\n      if (existing.textContent === content) return existing;\n    }\n    return null;\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    const headProvider = alepha.inject(BrowserHeadProvider);\n    const resolved =\n      typeof head === \"function\"\n        ? head(headProvider.getHead(window.document))\n        : head || {};\n    headProvider.renderHead(window.document, resolved);\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Alepha React Head Module\n *\n * @see {@link BrowserHeadProvider}\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [AlephaReact, BrowserHeadProvider],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.browser.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.browser.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {\n      htmlAttributes: { lang: \"en\" },\n    };\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  /**\n   * Fully resolve all global $head entries (functions re-evaluated, objects kept as-is).\n   *\n   * Unlike resolveGlobalHead() which only extracts htmlAttributes for streaming,\n   * this resolves all head properties (meta, link, script, htmlAttributes, etc.).\n   *\n   * Used by BrowserHeadProvider.refreshGlobalHead() to re-apply global head to the DOM.\n   */\n  public resolveGlobal(): Head {\n    let head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      const { meta, link } = this.seoExpander.expand(resolved);\n      head = {\n        ...head,\n        ...resolved,\n        meta: [...(head.meta ?? []), ...meta, ...(resolved.meta ?? [])],\n        link: [...(head.link ?? []), ...link, ...(resolved.link ?? [])],\n        script: [...(head.script ?? []), ...(resolved.script ?? [])],\n      };\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n\n    // Defaults if none were set by global $head or page head\n    state.head.title ??= \"App\";\n    state.head.htmlAttributes = {\n      lang: \"en\",\n      ...state.head.htmlAttributes,\n    };\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  /**\n   * Re-evaluate all global $head entries and apply the result to the DOM.\n   *\n   * Call this when something that affects global $head output changes at runtime\n   * (e.g., theme switch). Page-level head (title, meta from routes) is not touched.\n   */\n  public refreshGlobalHead(): void {\n    const head = this.headProvider.resolveGlobal();\n    this.renderHead(this.document, head);\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          if (it.media) {\n            link.setAttribute(\"media\", it.media);\n          }\n          if (it.sizes) {\n            link.setAttribute(\"sizes\", it.sizes);\n          }\n          if (it.hreflang) {\n            link.setAttribute(\"hreflang\", it.hreflang);\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    // Plain string → inline script. Dedupe by exact content match against\n    // any existing inline script (handles SSR-emitted globals that would\n    // otherwise be re-appended on hydration).\n    if (typeof script === \"string\") {\n      if (this.findInlineScriptByContent(document, script)) return;\n      const el = document.createElement(\"script\");\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // src-based scripts: dedupe by src attribute (existing behaviour).\n    if (attrs.src) {\n      if (document.querySelector(`script[src=\"${attrs.src}\"]`)) return;\n    } else if (typeof attrs.id === \"string\") {\n      // id-based dedupe — single source of truth per id.\n      if (document.querySelector(`script#${CSS.escape(attrs.id)}`)) return;\n    } else if (content) {\n      // Inline scripts with `content` and no src/id: fall back to content match.\n      if (this.findInlineScriptByContent(document, content)) return;\n    }\n\n    const el = document.createElement(\"script\");\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n    if (content) {\n      el.textContent = content;\n    }\n    document.head.appendChild(el);\n  }\n\n  /**\n   * Find an existing inline `<script>` tag (no `src`) with matching textContent.\n   * Used to make `renderScriptTag` idempotent across hydration + navigation,\n   * so SSR-emitted global scripts aren't re-appended client-side.\n   */\n  protected findInlineScriptByContent(\n    document: Document,\n    content: string,\n  ): Element | null {\n    for (const existing of document.head.querySelectorAll(\n      \"script:not([src])\",\n    )) {\n      if (existing.textContent === content) return existing;\n    }\n    return null;\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    const headProvider = alepha.inject(BrowserHeadProvider);\n    const resolved =\n      typeof head === \"function\"\n        ? head(headProvider.getHead(window.document))\n        : head || {};\n    headProvider.renderHead(window.document, resolved);\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Alepha React Head Module\n *\n * @see {@link BrowserHeadProvider}\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [AlephaReact, BrowserHeadProvider],\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAa,cAAb,MAAyB;CACvB,OAAc,MAGZ;EACA,MAAM,OAAmB,CAAC;EAC1B,MAAM,OAA6C,CAAC;EAapD,IAAI,EATF,KAAK,eACL,KAAK,SACL,KAAK,OACL,KAAK,YACL,KAAK,UACL,KAAK,QACL,KAAK,MACL,KAAK,UAGL,OAAO;GAAE;GAAM;EAAK;EAItB,IAAI,KAAK,aACP,KAAK,KAAK;GAAE,MAAM;GAAe,SAAS,KAAK;EAAY,CAAC;EAI9D,IAAI,KAAK,KACP,KAAK,KAAK;GAAE,KAAK;GAAa,MAAM,KAAK;EAAI,CAAC;EAIhD,KAAK,gBAAgB,MAAM,IAAI;EAG/B,KAAK,cAAc,MAAM,IAAI;EAE7B,OAAO;GAAE;GAAM;EAAK;CACtB;CAEA,gBAA0B,MAAY,MAAwB;EAC5D,MAAM,UAAU,KAAK,IAAI,SAAS,KAAK;EACvC,MAAM,gBAAgB,KAAK,IAAI,eAAe,KAAK;EACnD,MAAM,UAAU,KAAK,IAAI,SAAS,KAAK;EAEvC,IAAI,KAAK,QAAQ,SACf,KAAK,KAAK;GAAE,UAAU;GAAW,SAAS,KAAK,QAAQ;EAAU,CAAC;EAEpE,IAAI,KAAK,KACP,KAAK,KAAK;GAAE,UAAU;GAAU,SAAS,KAAK;EAAI,CAAC;EAErD,IAAI,SACF,KAAK,KAAK;GAAE,UAAU;GAAY,SAAS;EAAQ,CAAC;EAEtD,IAAI,eACF,KAAK,KAAK;GAAE,UAAU;GAAkB,SAAS;EAAc,CAAC;EAElE,IAAI,SAAS;GACX,KAAK,KAAK;IAAE,UAAU;IAAY,SAAS;GAAQ,CAAC;GACpD,IAAI,KAAK,YACP,KAAK,KAAK;IACR,UAAU;IACV,SAAS,OAAO,KAAK,UAAU;GACjC,CAAC;GAEH,IAAI,KAAK,aACP,KAAK,KAAK;IACR,UAAU;IACV,SAAS,OAAO,KAAK,WAAW;GAClC,CAAC;GAEH,IAAI,KAAK,UACP,KAAK,KAAK;IAAE,UAAU;IAAgB,SAAS,KAAK;GAAS,CAAC;EAElE;EACA,IAAI,KAAK,UACP,KAAK,KAAK;GAAE,UAAU;GAAgB,SAAS,KAAK;EAAS,CAAC;EAEhE,IAAI,KAAK,QACP,KAAK,KAAK;GAAE,UAAU;GAAa,SAAS,KAAK;EAAO,CAAC;CAE7D;CAEA,cAAwB,MAAY,MAAwB;EAC1D,MAAM,eAAe,KAAK,SAAS,SAAS,KAAK;EACjD,MAAM,qBAAqB,KAAK,SAAS,eAAe,KAAK;EAC7D,MAAM,eAAe,KAAK,SAAS,SAAS,KAAK;EAEjD,IAAI,KAAK,SAAS,QAAQ,gBAAgB,cACxC,KAAK,KAAK;GACR,MAAM;GACN,SACE,KAAK,SAAS,SACb,eAAe,wBAAwB;EAC5C,CAAC;EAEH,IAAI,KAAK,KACP,KAAK,KAAK;GAAE,MAAM;GAAe,SAAS,KAAK;EAAI,CAAC;EAEtD,IAAI,cACF,KAAK,KAAK;GAAE,MAAM;GAAiB,SAAS;EAAa,CAAC;EAE5D,IAAI,oBACF,KAAK,KAAK;GAAE,MAAM;GAAuB,SAAS;EAAmB,CAAC;EAExE,IAAI,cAAc;GAChB,KAAK,KAAK;IAAE,MAAM;IAAiB,SAAS;GAAa,CAAC;GAC1D,IAAI,KAAK,UACP,KAAK,KAAK;IAAE,MAAM;IAAqB,SAAS,KAAK;GAAS,CAAC;EAEnE;EACA,IAAI,KAAK,SAAS,MAChB,KAAK,KAAK;GAAE,MAAM;GAAgB,SAAS,KAAK,QAAQ;EAAK,CAAC;EAEhE,IAAI,KAAK,SAAS,SAChB,KAAK,KAAK;GAAE,MAAM;GAAmB,SAAS,KAAK,QAAQ;EAAQ,CAAC;CAExE;AACF;;;;;;;;;;;;AC/HA,IAAa,eAAb,MAA0B;CACxB,MAAyB,QAAQ;CACjC,cAAiC,QAAQ,WAAW;CAEpD,SAA6C,CAAC;;;;CAK9C,4BAAsC;;;;;;;;;;CAWtC,oBAAiC;EAC/B,MAAM,OAAa,EACjB,gBAAgB,EAAE,MAAM,KAAK,EAC/B;EAEA,KAAK,MAAM,KAAK,KAAK,UAAU,CAAC,GAAG;GACjC,MAAM,WAAW,OAAO,MAAM,aAAa,EAAE,IAAI;GACjD,IAAI,SAAS,gBACX,KAAK,iBAAiB;IACpB,GAAG,KAAK;IACR,GAAG,SAAS;GACd;EAEJ;EAEA,OAAO;CACT;;;;;;;;;CAUA,gBAA6B;EAC3B,IAAI,OAAa,CAAC;EAElB,KAAK,MAAM,KAAK,KAAK,UAAU,CAAC,GAAG;GACjC,MAAM,WAAW,OAAO,MAAM,aAAa,EAAE,IAAI;GACjD,MAAM,EAAE,MAAM,SAAS,KAAK,YAAY,OAAO,QAAQ;GACvD,OAAO;IACL,GAAG;IACH,GAAG;IACH,MAAM;KAAC,GAAI,KAAK,QAAQ,CAAC;KAAI,GAAG;KAAM,GAAI,SAAS,QAAQ,CAAC;IAAE;IAC9D,MAAM;KAAC,GAAI,KAAK,QAAQ,CAAC;KAAI,GAAG;KAAM,GAAI,SAAS,QAAQ,CAAC;IAAE;IAC9D,QAAQ,CAAC,GAAI,KAAK,UAAU,CAAC,GAAI,GAAI,SAAS,UAAU,CAAC,CAAE;GAC7D;EACF;EAEA,OAAO;CACT;CAEA,SAAgB,OAAkB;EAChC,MAAM,OAAO,EACX,GAAG,MAAM,KACX;EAEA,KAAK,MAAM,KAAK,KAAK,UAAU,CAAC,GAAG;GACjC,MAAM,OAAO,OAAO,MAAM,aAAa,EAAE,IAAI;GAC7C,KAAK,UAAU,OAAO,IAAI;EAC5B;EAEA,KAAK,MAAM,SAAS,MAAM,QACxB,IAAI,MAAM,OAAO,QAAQ,CAAC,MAAM,OAC9B,KAAK,eAAe,MAAM,OAAO,OAAO,MAAM,SAAS,CAAC,CAAC;EAK7D,MAAM,KAAK,UAAU;EACrB,MAAM,KAAK,iBAAiB;GAC1B,MAAM;GACN,GAAG,MAAM,KAAK;EAChB;CACF;CAEA,UAAoB,OAAkB,MAAkB;EAEtD,MAAM,EAAE,MAAM,SAAS,KAAK,YAAY,OAAO,IAAI;EACnD,MAAM,OAAO;GACX,GAAG,MAAM;GACT,GAAG;GACH,MAAM;IAAC,GAAI,MAAM,KAAK,QAAQ,CAAC;IAAI,GAAG;IAAM,GAAI,KAAK,QAAQ,CAAC;GAAE;GAChE,MAAM;IAAC,GAAI,MAAM,KAAK,QAAQ,CAAC;IAAI,GAAG;IAAM,GAAI,KAAK,QAAQ,CAAC;GAAE;GAChE,QAAQ,CAAC,GAAI,MAAM,KAAK,UAAU,CAAC,GAAI,GAAI,KAAK,UAAU,CAAC,CAAE;EAC/D;CACF;CAEA,eACE,MACA,OACA,OACM;EACN,IAAI,CAAC,KAAK,MACR;EAGF,MAAM,SAAS,CAAC;EAEhB,MAAM,OACJ,OAAO,KAAK,SAAS,aACjB,KAAK,KAAK,OAAO,MAAM,IAAI,IAC3B,KAAK;EAGX,MAAM,EAAE,MAAM,SAAS,KAAK,YAAY,OAAO,IAAI;EACnD,MAAM,KAAK,OAAO,CAAC,GAAI,MAAM,KAAK,QAAQ,CAAC,GAAI,GAAG,IAAI;EACtD,MAAM,KAAK,OAAO,CAAC,GAAI,MAAM,KAAK,QAAQ,CAAC,GAAI,GAAG,IAAI;EAEtD,IAAI,KAAK,OAAO;GACd,MAAM,SAAS,CAAC;GAEhB,IAAI,MAAM,KAAK,gBACb,MAAM,KAAK,QAAQ,GAAG,KAAK,QAAQ,MAAM,KAAK,iBAAiB,MAAM,KAAK;QAE1E,MAAM,KAAK,QAAQ,KAAK;GAG1B,MAAM,KAAK,iBAAiB,KAAK;EACnC;EAIA,IAAI,KAAK,kBAAkB,CAAC,KAAK,2BAA2B;GAC1D,KAAK,4BAA4B;GACjC,KAAK,IAAI,KACP,kKAEF;EACF;EAEA,IAAI,KAAK,gBACP,MAAM,KAAK,iBAAiB;GAC1B,GAAG,MAAM,KAAK;GACd,GAAG,KAAK;EACV;EAGF,IAAI,KAAK,MACP,MAAM,KAAK,OAAO,CAAC,GAAI,MAAM,KAAK,QAAQ,CAAC,GAAI,GAAI,KAAK,QAAQ,CAAC,CAAE;EAGrE,IAAI,KAAK,MACP,MAAM,KAAK,OAAO,CAAC,GAAI,MAAM,KAAK,QAAQ,CAAC,GAAI,GAAI,KAAK,QAAQ,CAAC,CAAE;EAGrE,IAAI,KAAK,QACP,MAAM,KAAK,SAAS,CAClB,GAAI,MAAM,KAAK,UAAU,CAAC,GAC1B,GAAI,KAAK,UAAU,CAAC,CACtB;CAEJ;AACF;;;;;;AC5KA,MAAa,SAAS,YAAkC;CACtD,OAAO,gBAAgB,eAAe,OAAO;AAC/C;AAQA,IAAa,gBAAb,cAAmC,UAAgC;CACjE,WAA8B,QAAQ,YAAY;CAClD,SAAmB;EACjB,KAAK,SAAS,SAAS,CAAC,GAAI,KAAK,SAAS,UAAU,CAAC,GAAI,KAAK,OAAO;CACvE;AACF;AAEA,MAAM,QAAQ;;;;;;;;;;ACbd,IAAa,sBAAb,MAAiC;CAC/B,SAA4B,QAAQ,MAAM;CAC1C,eAAkC,QAAQ,YAAY;CAEtD,IAAc,WAAqB;EACjC,OAAO,OAAO;CAChB;;;;;;;CAQA,kBAAyB,OAAiD;EAExE,IAAI,CAAC,KAAK,OAAO,UAAU,GACzB;EAGF,KAAK,aAAa,SAAS,KAAY;EACvC,IAAI,MAAM,MACR,KAAK,WAAW,KAAK,UAAU,MAAM,IAAI;CAE7C;;;;;;;CAQA,oBAAiC;EAC/B,MAAM,OAAO,KAAK,aAAa,cAAc;EAC7C,KAAK,WAAW,KAAK,UAAU,IAAI;CACrC;CAEA,QAAe,UAA0B;EACvC,OAAO;GACL,IAAI,QAAQ;IACV,OAAO,SAAS;GAClB;GACA,IAAI,iBAAiB;IACnB,MAAM,QAAgC,CAAC;IACvC,KAAK,MAAM,QAAQ,SAAS,gBAAgB,YAC1C,MAAM,KAAK,QAAQ,KAAK;IAE1B,OAAO;GACT;GACA,IAAI,iBAAiB;IACnB,MAAM,QAAgC,CAAC;IACvC,KAAK,MAAM,QAAQ,SAAS,KAAK,YAC/B,MAAM,KAAK,QAAQ,KAAK;IAE1B,OAAO;GACT;GACA,IAAI,OAAO;IACT,MAAM,QAAoB,CAAC;IAE3B,KAAK,MAAM,QAAQ,SAAS,KAAK,iBAAiB,YAAY,GAAG;KAC/D,MAAM,OAAO,KAAK,aAAa,MAAM;KACrC,MAAM,UAAU,KAAK,aAAa,SAAS;KAC3C,IAAI,QAAQ,SACV,MAAM,KAAK;MAAE;MAAM;KAAQ,CAAC;IAEhC;IAEA,KAAK,MAAM,QAAQ,SAAS,KAAK,iBAAiB,gBAAgB,GAAG;KACnE,MAAM,WAAW,KAAK,aAAa,UAAU;KAC7C,MAAM,UAAU,KAAK,aAAa,SAAS;KAC3C,IAAI,YAAY,SACd,MAAM,KAAK;MAAE;MAAU;KAAQ,CAAC;IAEpC;IACA,OAAO;GACT;EACF;CACF;CAEA,WAAkB,UAAoB,MAAkB;EACtD,IAAI,KAAK,OACP,SAAS,QAAQ,KAAK;EAGxB,IAAI,KAAK,gBACP,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,cAAc,GAC3D,IAAI,OACF,SAAS,KAAK,aAAa,KAAK,KAAK;OAErC,SAAS,KAAK,gBAAgB,GAAG;EAKvC,IAAI,KAAK,gBACP,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,cAAc,GAC3D,IAAI,OACF,SAAS,gBAAgB,aAAa,KAAK,KAAK;OAEhD,SAAS,gBAAgB,gBAAgB,GAAG;EAKlD,IAAI,KAAK,MACP,KAAK,MAAM,MAAM,KAAK,MACpB,KAAK,cAAc,UAAU,EAAE;EAInC,IAAI,KAAK,MACP,KAAK,MAAM,MAAM,KAAK,MAAM;GAC1B,MAAM,EAAE,KAAK,SAAS;GACtB,IAAI,OAAO,SAAS,cAAc,aAAa,IAAI,WAAW,KAAK,GAAG;GACtE,IAAI,CAAC,MAAM;IACT,OAAO,SAAS,cAAc,MAAM;IACpC,KAAK,aAAa,OAAO,GAAG;IAC5B,KAAK,aAAa,QAAQ,IAAI;IAC9B,IAAI,GAAG,MACL,KAAK,aAAa,QAAQ,GAAG,IAAI;IAEnC,IAAI,GAAG,IACL,KAAK,aAAa,MAAM,GAAG,EAAE;IAE/B,IAAI,GAAG,eAAe,MACpB,KAAK,aAAa,eAAe,EAAE;IAErC,IAAI,GAAG,OACL,KAAK,aAAa,SAAS,GAAG,KAAK;IAErC,IAAI,GAAG,OACL,KAAK,aAAa,SAAS,GAAG,KAAK;IAErC,IAAI,GAAG,UACL,KAAK,aAAa,YAAY,GAAG,QAAQ;IAE3C,SAAS,KAAK,YAAY,IAAI;GAChC;EACF;EAGF,IAAI,KAAK,QACP,KAAK,MAAM,MAAM,KAAK,QACpB,KAAK,gBAAgB,UAAU,EAAE;CAGvC;CAEA,gBACE,UACA,QAGM;EAIN,IAAI,OAAO,WAAW,UAAU;GAC9B,IAAI,KAAK,0BAA0B,UAAU,MAAM,GAAG;GACtD,MAAM,KAAK,SAAS,cAAc,QAAQ;GAC1C,GAAG,cAAc;GACjB,SAAS,KAAK,YAAY,EAAE;GAC5B;EACF;EAEA,MAAM,EAAE,SAAS,GAAG,UAAU;EAG9B,IAAI,MAAM;OACJ,SAAS,cAAc,eAAe,MAAM,IAAI,GAAG,GAAG;EAAA,OACrD,IAAI,OAAO,MAAM,OAAO;OAEzB,SAAS,cAAc,UAAU,IAAI,OAAO,MAAM,EAAE,GAAG,GAAG;EAAA,OACzD,IAAI;OAEL,KAAK,0BAA0B,UAAU,OAAO,GAAG;EAAA;EAGzD,MAAM,KAAK,SAAS,cAAc,QAAQ;EAC1C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,IAAI,UAAU,MACZ,GAAG,aAAa,KAAK,EAAE;OAClB,IAAI,UAAU,KAAA,KAAa,UAAU,OAC1C,GAAG,aAAa,KAAK,OAAO,KAAK,CAAC;EAGtC,IAAI,SACF,GAAG,cAAc;EAEnB,SAAS,KAAK,YAAY,EAAE;CAC9B;;;;;;CAOA,0BACE,UACA,SACgB;EAChB,KAAK,MAAM,YAAY,SAAS,KAAK,iBACnC,mBACF,GACE,IAAI,SAAS,gBAAgB,SAAS,OAAO;EAE/C,OAAO;CACT;CAEA,cAAwB,UAAoB,MAAsB;EAChE,MAAM,EAAE,YAAY;EAGpB,IAAI,KAAK,UAAU;GACjB,MAAM,WAAW,SAAS,cACxB,kBAAkB,KAAK,SAAS,GAClC;GACA,IAAI,UACF,SAAS,aAAa,WAAW,OAAO;QACnC;IACL,MAAM,UAAU,SAAS,cAAc,MAAM;IAC7C,QAAQ,aAAa,YAAY,KAAK,QAAQ;IAC9C,QAAQ,aAAa,WAAW,OAAO;IACvC,SAAS,KAAK,YAAY,OAAO;GACnC;GACA;EACF;EAGA,IAAI,KAAK,MAAM;GACb,MAAM,WAAW,SAAS,cAAc,cAAc,KAAK,KAAK,GAAG;GACnE,IAAI,UACF,SAAS,aAAa,WAAW,OAAO;QACnC;IACL,MAAM,UAAU,SAAS,cAAc,MAAM;IAC7C,QAAQ,aAAa,QAAQ,KAAK,IAAI;IACtC,QAAQ,aAAa,WAAW,OAAO;IACvC,SAAS,KAAK,YAAY,OAAO;GACnC;EACF;CACF;AACF;;;;;;;;;;;;;;;;;;;;ACrOA,MAAa,WAAW,YAA4C;CAClE,MAAM,SAAS,UAAU,MAAM;CAE/B,MAAM,UAAU,cAAc;EAC5B,IAAI,CAAC,OAAO,UAAU,GACpB,OAAO,CAAC;EAGV,OAAO,OAAO,OAAO,mBAAmB,EAAE,QAAQ,OAAO,QAAQ;CACnE,GAAG,CAAC,CAAC;CAEL,MAAM,UAAU,aAAa,SAA8C;EACzE,IAAI,CAAC,OAAO,UAAU,GACpB;EAGF,MAAM,eAAe,OAAO,OAAO,mBAAmB;EACtD,MAAM,WACJ,OAAO,SAAS,aACZ,KAAK,aAAa,QAAQ,OAAO,QAAQ,CAAC,IAC1C,QAAQ,CAAC;EACf,aAAa,WAAW,OAAO,UAAU,QAAQ;CACnD,GAAG,CAAC,CAAC;CAEL,gBAAgB;EACd,IAAI,SACF,QAAQ,OAAO;CAEnB,GAAG,CAAC,CAAC;CAEL,OAAO,CAAC,SAAS,OAAO;AAC1B;;;;;;;;;ACjCA,MAAa,kBAAkB,QAAQ;CACrC,MAAM;CACN,YAAY,CAAC,KAAK;CAClB,UAAU,CAAC,aAAa,mBAAmB;AAC7C,CAAC"}

package/dist/react/head/index.d.ts

@@ -1,6 +1,4 @@
-import * as _$alepha from "alepha";
 import { Alepha, KIND, Primitive } from "alepha";
-import * as _$alepha_logger0 from "alepha/logger";
 
 //#region ../../src/react/head/interfaces/Head.d.ts
 /**
@@ -237,7 +235,7 @@ type UseHeadReturn = [Head, (head?: Head | ((previous?: Head) => Head)) => void]
  * @see {@link BrowserHeadProvider}
  */
 declare class HeadProvider {
-  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly log: import("alepha/logger").Logger;
   protected readonly seoExpander: SeoExpander;
   global?: Array<Head | (() => Head)>;
   /**
@@ -381,7 +379,7 @@ declare class ServerHeadProvider {
  *
  * @module alepha.react.head
  */
-declare const AlephaReactHead: _$alepha.Service<_$alepha.Module>;
+declare const AlephaReactHead: import("alepha").Service<import("alepha").Module>;
 //#endregion
 export { $head, AlephaReactHead, BrowserHeadProvider, Head, HeadMeta, HeadPrimitive, HeadPrimitiveOptions, Seo, SeoExpander, ServerHeadProvider, SimpleHead, UseHeadOptions, UseHeadReturn, useHead };
 //# sourceMappingURL=index.d.ts.map

package/dist/react/head/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/react/head/interfaces/Head.ts","../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/providers/ServerHeadProvider.ts","../../../src/react/head/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/react/head/interfaces/Head.ts","../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/providers/ServerHeadProvider.ts","../../../src/react/head/index.ts"],"mappings":"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"}

package/dist/react/head/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/providers/ServerHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {\n      htmlAttributes: { lang: \"en\" },\n    };\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  /**\n   * Fully resolve all global $head entries (functions re-evaluated, objects kept as-is).\n   *\n   * Unlike resolveGlobalHead() which only extracts htmlAttributes for streaming,\n   * this resolves all head properties (meta, link, script, htmlAttributes, etc.).\n   *\n   * Used by BrowserHeadProvider.refreshGlobalHead() to re-apply global head to the DOM.\n   */\n  public resolveGlobal(): Head {\n    let head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      const { meta, link } = this.seoExpander.expand(resolved);\n      head = {\n        ...head,\n        ...resolved,\n        meta: [...(head.meta ?? []), ...meta, ...(resolved.meta ?? [])],\n        link: [...(head.link ?? []), ...link, ...(resolved.link ?? [])],\n        script: [...(head.script ?? []), ...(resolved.script ?? [])],\n      };\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n\n    // Defaults if none were set by global $head or page head\n    state.head.title ??= \"App\";\n    state.head.htmlAttributes = {\n      lang: \"en\",\n      ...state.head.htmlAttributes,\n    };\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  /**\n   * Re-evaluate all global $head entries and apply the result to the DOM.\n   *\n   * Call this when something that affects global $head output changes at runtime\n   * (e.g., theme switch). Page-level head (title, meta from routes) is not touched.\n   */\n  public refreshGlobalHead(): void {\n    const head = this.headProvider.resolveGlobal();\n    this.renderHead(this.document, head);\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          if (it.media) {\n            link.setAttribute(\"media\", it.media);\n          }\n          if (it.sizes) {\n            link.setAttribute(\"sizes\", it.sizes);\n          }\n          if (it.hreflang) {\n            link.setAttribute(\"hreflang\", it.hreflang);\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    // Plain string → inline script. Dedupe by exact content match against\n    // any existing inline script (handles SSR-emitted globals that would\n    // otherwise be re-appended on hydration).\n    if (typeof script === \"string\") {\n      if (this.findInlineScriptByContent(document, script)) return;\n      const el = document.createElement(\"script\");\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // src-based scripts: dedupe by src attribute (existing behaviour).\n    if (attrs.src) {\n      if (document.querySelector(`script[src=\"${attrs.src}\"]`)) return;\n    } else if (typeof attrs.id === \"string\") {\n      // id-based dedupe — single source of truth per id.\n      if (document.querySelector(`script#${CSS.escape(attrs.id)}`)) return;\n    } else if (content) {\n      // Inline scripts with `content` and no src/id: fall back to content match.\n      if (this.findInlineScriptByContent(document, content)) return;\n    }\n\n    const el = document.createElement(\"script\");\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n    if (content) {\n      el.textContent = content;\n    }\n    document.head.appendChild(el);\n  }\n\n  /**\n   * Find an existing inline `<script>` tag (no `src`) with matching textContent.\n   * Used to make `renderScriptTag` idempotent across hydration + navigation,\n   * so SSR-emitted global scripts aren't re-appended client-side.\n   */\n  protected findInlineScriptByContent(\n    document: Document,\n    content: string,\n  ): Element | null {\n    for (const existing of document.head.querySelectorAll(\n      \"script:not([src])\",\n    )) {\n      if (existing.textContent === content) return existing;\n    }\n    return null;\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport type { Head, SimpleHead } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Server-side head provider that fills head content from route configurations.\n *\n * Used by ReactServerProvider to collect title, meta tags, and other head\n * elements which are then rendered by ReactServerTemplateProvider.\n */\nexport class ServerHeadProvider {\n  protected readonly headProvider = $inject(HeadProvider);\n\n  /**\n   * Resolve global head configuration (htmlAttributes only).\n   *\n   * Used for early streaming optimization - htmlAttributes can be sent\n   * before page loaders run since they come from global $head only.\n   */\n  public resolveGlobalHead(): Head {\n    return this.headProvider.resolveGlobalHead();\n  }\n\n  /**\n   * Fill head state from route configurations.\n   * Delegates to HeadProvider to merge head data from all route layers.\n   */\n  public fillHead(state: { head: SimpleHead; layers: Array<any> }): void {\n    this.headProvider.fillHead(state as any);\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    const headProvider = alepha.inject(BrowserHeadProvider);\n    const resolved =\n      typeof head === \"function\"\n        ? head(headProvider.getHead(window.document))\n        : head || {};\n    headProvider.renderHead(window.document, resolved);\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { SeoExpander } from \"./helpers/SeoExpander.ts\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\nimport { HeadProvider } from \"./providers/HeadProvider.ts\";\nimport { ServerHeadProvider } from \"./providers/ServerHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\nexport * from \"./providers/ServerHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * HTML head element management.\n *\n * **Features:**\n * - Title, meta tags, and links\n * - SEO optimization\n * - Social media tags\n *\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [\n    AlephaReact,\n    BrowserHeadProvider,\n    HeadProvider,\n    SeoExpander,\n    ServerHeadProvider,\n  ],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/providers/ServerHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {\n      htmlAttributes: { lang: \"en\" },\n    };\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  /**\n   * Fully resolve all global $head entries (functions re-evaluated, objects kept as-is).\n   *\n   * Unlike resolveGlobalHead() which only extracts htmlAttributes for streaming,\n   * this resolves all head properties (meta, link, script, htmlAttributes, etc.).\n   *\n   * Used by BrowserHeadProvider.refreshGlobalHead() to re-apply global head to the DOM.\n   */\n  public resolveGlobal(): Head {\n    let head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      const { meta, link } = this.seoExpander.expand(resolved);\n      head = {\n        ...head,\n        ...resolved,\n        meta: [...(head.meta ?? []), ...meta, ...(resolved.meta ?? [])],\n        link: [...(head.link ?? []), ...link, ...(resolved.link ?? [])],\n        script: [...(head.script ?? []), ...(resolved.script ?? [])],\n      };\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n\n    // Defaults if none were set by global $head or page head\n    state.head.title ??= \"App\";\n    state.head.htmlAttributes = {\n      lang: \"en\",\n      ...state.head.htmlAttributes,\n    };\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  /**\n   * Re-evaluate all global $head entries and apply the result to the DOM.\n   *\n   * Call this when something that affects global $head output changes at runtime\n   * (e.g., theme switch). Page-level head (title, meta from routes) is not touched.\n   */\n  public refreshGlobalHead(): void {\n    const head = this.headProvider.resolveGlobal();\n    this.renderHead(this.document, head);\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          if (it.media) {\n            link.setAttribute(\"media\", it.media);\n          }\n          if (it.sizes) {\n            link.setAttribute(\"sizes\", it.sizes);\n          }\n          if (it.hreflang) {\n            link.setAttribute(\"hreflang\", it.hreflang);\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    // Plain string → inline script. Dedupe by exact content match against\n    // any existing inline script (handles SSR-emitted globals that would\n    // otherwise be re-appended on hydration).\n    if (typeof script === \"string\") {\n      if (this.findInlineScriptByContent(document, script)) return;\n      const el = document.createElement(\"script\");\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // src-based scripts: dedupe by src attribute (existing behaviour).\n    if (attrs.src) {\n      if (document.querySelector(`script[src=\"${attrs.src}\"]`)) return;\n    } else if (typeof attrs.id === \"string\") {\n      // id-based dedupe — single source of truth per id.\n      if (document.querySelector(`script#${CSS.escape(attrs.id)}`)) return;\n    } else if (content) {\n      // Inline scripts with `content` and no src/id: fall back to content match.\n      if (this.findInlineScriptByContent(document, content)) return;\n    }\n\n    const el = document.createElement(\"script\");\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n    if (content) {\n      el.textContent = content;\n    }\n    document.head.appendChild(el);\n  }\n\n  /**\n   * Find an existing inline `<script>` tag (no `src`) with matching textContent.\n   * Used to make `renderScriptTag` idempotent across hydration + navigation,\n   * so SSR-emitted global scripts aren't re-appended client-side.\n   */\n  protected findInlineScriptByContent(\n    document: Document,\n    content: string,\n  ): Element | null {\n    for (const existing of document.head.querySelectorAll(\n      \"script:not([src])\",\n    )) {\n      if (existing.textContent === content) return existing;\n    }\n    return null;\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport type { Head, SimpleHead } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Server-side head provider that fills head content from route configurations.\n *\n * Used by ReactServerProvider to collect title, meta tags, and other head\n * elements which are then rendered by ReactServerTemplateProvider.\n */\nexport class ServerHeadProvider {\n  protected readonly headProvider = $inject(HeadProvider);\n\n  /**\n   * Resolve global head configuration (htmlAttributes only).\n   *\n   * Used for early streaming optimization - htmlAttributes can be sent\n   * before page loaders run since they come from global $head only.\n   */\n  public resolveGlobalHead(): Head {\n    return this.headProvider.resolveGlobalHead();\n  }\n\n  /**\n   * Fill head state from route configurations.\n   * Delegates to HeadProvider to merge head data from all route layers.\n   */\n  public fillHead(state: { head: SimpleHead; layers: Array<any> }): void {\n    this.headProvider.fillHead(state as any);\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    const headProvider = alepha.inject(BrowserHeadProvider);\n    const resolved =\n      typeof head === \"function\"\n        ? head(headProvider.getHead(window.document))\n        : head || {};\n    headProvider.renderHead(window.document, resolved);\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { SeoExpander } from \"./helpers/SeoExpander.ts\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\nimport { HeadProvider } from \"./providers/HeadProvider.ts\";\nimport { ServerHeadProvider } from \"./providers/ServerHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\nexport * from \"./providers/ServerHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * HTML head element management.\n *\n * **Features:**\n * - Title, meta tags, and links\n * - SEO optimization\n * - Social media tags\n *\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [\n    AlephaReact,\n    BrowserHeadProvider,\n    HeadProvider,\n    SeoExpander,\n    ServerHeadProvider,\n  ],\n});\n"],"mappings":"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"}

package/dist/react/i18n/index.d.ts

@@ -1,9 +1,5 @@
-import * as _$alepha from "alepha";
 import { Alepha, Async, KIND, Primitive, TypeBoxError } from "alepha";
 import { DateTime, DateTimeProvider } from "alepha/datetime";
-import * as _$alepha_logger0 from "alepha/logger";
-import * as _$alepha_server_cookies0 from "alepha/server/cookies";
-import * as _$typebox from "typebox";
 
 //#region ../../src/react/i18n/components/Localize.d.ts
 interface LocalizeProps {
@@ -32,12 +28,52 @@ interface LocalizeProps {
 }
 declare const Localize: (props: LocalizeProps) => string | number;
 //#endregion
+//#region ../../src/react/i18n/components/Translate.d.ts
+interface TranslateProps {
+  /**
+   * Dictionary key to look up — the same key you would pass to `tr(...)`.
+   */
+  k: string;
+  /**
+   * Positional substitutions for `$1`, `$2`, … placeholders in the entry.
+   */
+  args?: string[];
+  /**
+   * Shown when the key is missing from every registered dictionary (otherwise
+   * the raw key is rendered, matching `tr`'s behaviour).
+   */
+  fallback?: string;
+}
+/**
+ * Renders a translated dictionary entry as a reactive text node.
+ *
+ * `tr(...)` is a hook, so it can only be called inside a component body. Use
+ * `<Translate>` wherever a *node* is expected instead — a prop, a `children`
+ * slot, or route metadata such as a nav-shell `label`. Because it subscribes to
+ * {@link useI18n} it re-renders on a language switch, unlike a string resolved
+ * once at module/initialisation time.
+ *
+ * Sibling of {@link Localize}: `Localize` formats a value (number, date,
+ * error); `Translate` looks up a key.
+ *
+ * @example
+ * ```tsx
+ * nav: { label: <Translate k="admin.nav.users" /> }
+ * <Translate k="cart.items" args={[String(count)]} fallback="Items" />
+ * ```
+ */
+declare const Translate: (props: TranslateProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Terse alias for {@link Translate} — handy in dense JSX such as nav labels.
+ */
+declare const Tr: (props: TranslateProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
 //#region ../../src/react/i18n/providers/I18nProvider.d.ts
 declare class I18nProvider<S extends object, K extends keyof ServiceDictionary<S>> {
-  protected log: _$alepha_logger0.Logger;
+  protected log: import("alepha/logger").Logger;
   protected alepha: Alepha;
   protected dateTimeProvider: DateTimeProvider;
-  protected cookie: _$alepha_server_cookies0.AbstractCookiePrimitive<_$typebox.TString>;
+  protected cookie: import("alepha/server/cookies").AbstractCookiePrimitive<import("typebox").TString>;
   readonly registry: Array<{
     target: string;
     name: string;
@@ -56,11 +92,11 @@ declare class I18nProvider<S extends object, K extends keyof ServiceDictionary<S
   };
   get languages(): string[];
   constructor();
-  protected readonly onRender: _$alepha.HookPrimitive<"server:onRequest">;
-  protected readonly onStart: _$alepha.HookPrimitive<"start">;
+  protected readonly onRender: import("alepha").HookPrimitive<"server:onRequest">;
+  protected readonly onStart: import("alepha").HookPrimitive<"start">;
   protected refreshLocale(): void;
   setLang: (lang: string) => Promise<void>;
-  protected readonly mutate: _$alepha.HookPrimitive<"state:mutate">;
+  protected readonly mutate: import("alepha").HookPrimitive<"state:mutate">;
   get fallbackLang(): string;
   get lang(): string;
   translate: (key: string, args?: string[]) => string;
@@ -173,7 +209,7 @@ declare module "alepha" {
  *
  * @module alepha.react.i18n
  */
-declare const AlephaReactI18n: _$alepha.Service<_$alepha.Module>;
+declare const AlephaReactI18n: import("alepha").Service<import("alepha").Module>;
 //#endregion
-export { $dictionary, AlephaReactI18n, DictionaryPrimitive, DictionaryPrimitiveOptions, I18nLocalizeOptions, I18nLocalizeType, I18nProvider, Localize, type LocalizeProps, ServiceDictionary, useI18n };
+export { $dictionary, AlephaReactI18n, DictionaryPrimitive, DictionaryPrimitiveOptions, I18nLocalizeOptions, I18nLocalizeType, I18nProvider, Localize, type LocalizeProps, ServiceDictionary, Tr, Translate, type TranslateProps, useI18n };
 //# sourceMappingURL=index.d.ts.map

package/dist/react/i18n/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/react/i18n/components/Localize.tsx","../../../src/react/i18n/providers/I18nProvider.ts","../../../src/react/i18n/primitives/$dictionary.ts","../../../src/react/i18n/hooks/useI18n.ts","../../../src/react/i18n/index.ts"],"mappings":";;;;;;;;UAIiB,aAAA;EACf,KAAA,oBAAyB,IAAA,GAAO,QAAA,GAAW,YAAA;;;;;EAK3C,MAAA,GAAS,IAAA,CAAK,mBAAA;EANc;;;;;;;;;EAgB5B,IAAA,wBAA4B,IAAA,CAAK,qBAAA;EAfR;;;;;EAqBzB,QAAA;AAAA;AAAA,cAGI,QAAA,GAAY,KAAA,EAAO,aAAA;;;cCvBZ,YAAA,mCAEK,iBAAA,CAAkB,CAAA;EAAA,UAExB,GAAA,EAFuB,gBAAA,CAEpB,MAAA;EAAA,UACH,MAAA,EAAM,MAAA;EAAA,UACN,gBAAA,EAAgB,gBAAA;EAAA,UAEhB,MAAA,EAAM,wBAAA,CAAA,uBAAA,CAFU,SAAA,CAEV,OAAA;EAAA,SAMA,QAAA,EAAU,KAAA;IACxB,MAAA;IACA,IAAA;IACA,IAAA;IACA,MAAA,QAAc,OAAA,CAAQ,MAAA;IACtB,YAAA,EAAc,MAAA;EAAA;EAGhB,OAAA;;;EAIO,UAAA;IAAc,MAAA,GAAS,KAAA,EAAO,IAAA;EAAA;EAG9B,YAAA;IAAgB,MAAA,GAAS,KAAA;EAAA;EAAA,IAGrB,SAAA,CAAA;;qBAcQ,QAAA,EApBsB,QAAA,CAoBd,aAAA;EAAA,mBAQR,OAAA,EARQ,QAAA,CAQD,aAAA;EAAA,UA6BhB,aAAA,CAAA;EAOH,OAAA,GAAiB,IAAA,aAAY,OAAA;EAAA,mBAiBjB,MAAA,EAjBiB,QAAA,CAiBX,aAAA;EAAA,IAwBd,YAAA,CAAA;EAAA,IASA,IAAA,CAAA;EAIJ,SAAA,GAAa,GAAA,UAAa,IAAA;EAAA,SAoBjB,CAAA,GACd,KAAA,EAAO,gBAAA,EACP,OAAA,GAAS,mBAAA;ED/IyB;;;;ACvBtC;;EDuBsC,SCiNpB,EAAA,GACd,GAAA,QAAW,iBAAA,CAAkB,CAAA,EAAG,CAAA,mBAChC,OAAA;IACE,IAAA;IACA,OAAA;EAAA;EAAA,UAUM,MAAA,CAAO,IAAA,UAAc,IAAA;AAAA;AAAA,KASrB,gBAAA,qBAAqC,IAAA,GAAO,QAAA,GAAW,YAAA;AAAA,UAElD,mBAAA;EA/OS;;;;EAoPxB,MAAA,GAAS,IAAA,CAAK,mBAAA;EA5O2B;;;;;;;;;EAsPzC,IAAA,wBAA4B,IAAA,CAAK,qBAAA;EAvCE;;;;;EA6CnC,QAAA;AAAA;;;;;;;;;ADxRF;;;;;;;;;;;;;;;;;;;;;;;AAuBC;;cEOY,WAAA;EAAA,WAAyB,MAAA,kBAAsB,OAAA,EACjD,0BAAA,CAA2B,CAAA,IACnC,mBAAA,CAAoB,CAAA;EAAA;;UAMN,0BAAA,WAAqC,MAAA;EACpD,IAAA;EACA,IAAA;EACA,IAAA,QAAY,KAAA;IAAQ,OAAA,EAAS,CAAA;EAAA;AAAA;AAAA,cAKlB,mBAAA,WACD,MAAA,0BACF,SAAA,CAAU,0BAAA,CAA2B,CAAA;EAAA,UACnC,QAAA,EAAQ,YAAA;EAAA,UACR,MAAA,CAAA;AAAA;;;;;;cC/CC,OAAA,qCAEK,iBAAA,CAAkB,CAAA,QAC/B,YAAA,CAAa,CAAA,EAAG,CAAA;AAAA,KAKT,iBAAA,mCACE,CAAA,GAAI,CAAA,CAAE,CAAA,UAAW,mBAAA,YAA+B,CAAA;;;;YCD3C,KAAA;IACf,wBAAA;EAAA;AAAA;;;;;;;;;;;cAgBS,eAAA,EAAe,QAAA,CAAA,OAAA,CAI1B,QAAA,CAJ0B,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/react/i18n/components/Localize.tsx","../../../src/react/i18n/components/Translate.tsx","../../../src/react/i18n/providers/I18nProvider.ts","../../../src/react/i18n/primitives/$dictionary.ts","../../../src/react/i18n/hooks/useI18n.ts","../../../src/react/i18n/index.ts"],"mappings":";;;;UAIiB,aAAA;EACf,KAAA,oBAAyB,IAAA,GAAO,QAAA,GAAW,YAAA;EAD5B;;;;EAMf,MAAA,GAAS,IAAA,CAAK,mBAAA;EAL6B;;;;;;;;;EAe3C,IAAA,wBAA4B,IAAA,CAAK,qBAAA;EAVxB;;;;;EAgBT,QAAA;AAAA;AAAA,cAGI,QAAA,GAAY,KAAoB,EAAb,aAAa;;;UC3BrB,cAAA;;;;EAIf,CAAA;EDF4B;;;ECM5B,IAAA;EDL2C;;;;ECU3C,QAAA;AAAA;;;;;;;;;;;;ADWQ;AACT;;;;AAEqC;;cCOzB,SAAA,GAAa,KAAA,EAAO,cAAc,iCAAA,GAAA,CAAA,OAAA;;AAlC/C;;cA0Ca,EAAA,GAAE,KAAA,EARkB,cAAc,iCAAA,GAAA,CAAA,OAAA;;;cC9BlC,YAAA,mCAEK,iBAAA,CAAkB,CAAA;EAAA,UAExB,GAAA,0BAAG,MAAA;EAAA,UACH,MAAA,EAAM,MAAA;EAAA,UACN,gBAAA,EAAgB,gBAAA;EAAA,UAEhB,MAAA,kCAAM,uBAAA,mBAAA,OAAA;EAAA,SAMA,QAAA,EAAU,KAAA;IACxB,MAAA;IACA,IAAA;IACA,IAAA;IACA,MAAA,QAAc,OAAA,CAAQ,MAAA;IACtB,YAAA,EAAc,MAAA;EAAA;EAGhB,OAAA;;;EAIO,UAAA;IAAc,MAAA,GAAS,KAAA,EAAO,IAAA;EAAA;EAG9B,YAAA;IAAgB,MAAA,GAAS,KAAA;EAAA;EAAA,IAGrB,SAAA;;qBAcQ,QAAA,mBAAQ,aAAA;EAAA,mBAQR,OAAA,mBAAO,aAAA;EAAA,UA6BhB,aAAA;EAOH,OAAA,GAAiB,IAAA,aAAY,OAAA;EAAA,mBAiBjB,MAAA,mBAAM,aAAA;EAAA,IAwBd,YAAA;EAAA,IASA,IAAA;EAIJ,SAAA,GAAa,GAAA,UAAa,IAAA;EAAA,SAoBjB,CAAA,GACd,KAAA,EAAO,gBAAA,EACP,OAAA,GAAS,mBAAA;ED1KI;;;;;;EAAA,SC4OC,EAAA,GACd,GAAA,QAAW,iBAAA,CAAkB,CAAA,EAAG,CAAA,mBAChC,OAAA;IACE,IAAA;IACA,OAAA;EAAA;EAAA,UAUM,MAAA,CAAO,IAAA,UAAc,IAAA;AAAA;AAAA,KASrB,gBAAA,qBAAqC,IAAA,GAAO,QAAA,GAAW,YAAA;AAAA,UAElD,mBAAA;EDnOS;;;;ECwOxB,MAAA,GAAS,IAAA,CAAK,mBAAA;EDhOH;;;;;;;;;EC0OX,IAAA,wBAA4B,IAAA,CAAK,qBAAqB;;;;AAhRxD;;EAsRE,QAAA;AAAA;;;;;AFxRF;;;;;;;;;;;;;;;;;;;;;;AAsBU;AACT;;;;AAEqC;;cGKzB,WAAA;EAAA,WAAyB,MAAA,kBAAsB,OAAA,EACjD,0BAAA,CAA2B,CAAA,IACnC,mBAAA,CAAoB,CAAA;EAAA;;UAMN,0BAAA,WAAqC,MAAA;EACpD,IAAA;EACA,IAAA;EACA,IAAA,QAAY,KAAA;IAAQ,OAAA,EAAS,CAAA;EAAA;AAAA;AAAA,cAKlB,mBAAA,WACD,MAAA,0BACF,SAAA,CAAU,0BAAA,CAA2B,CAAA;EAAA,UACnC,QAAA,EAAQ,YAAA;EAAA,UACR,MAAA;AAAA;;;;;AHlDZ;cIGa,OAAA,qCAEK,iBAAA,CAAkB,CAAA,QAC/B,YAAA,CAAa,CAAA,EAAG,CAAA;AAAA,KAKT,iBAAA,mCACE,CAAA,GAAI,CAAA,CAAE,CAAA,UAAW,mBAAA,YAA+B,CAAA;;;;YCC3C,KAAA;IACf,wBAAwB;EAAA;AAAA;;;;;;;;;;;cAgBf,eAAA,mBAAe,OAAA,kBAAA,MAAA"}

package/dist/react/i18n/index.js

@@ -3,6 +3,7 @@ import { DateTimeProvider } from "alepha/datetime";
 import { $logger } from "alepha/logger";
 import { $cookie } from "alepha/server/cookies";
 import { useInject, useStore } from "alepha/react";
+import { Fragment, jsx } from "react/jsx-runtime";
 //#region ../../src/react/i18n/providers/I18nProvider.ts
 var I18nProvider = class {
 	log = $logger();
@@ -202,6 +203,37 @@ const Localize = (props) => {
 	return useI18n().l(props.value, props);
 };
 //#endregion
+//#region ../../src/react/i18n/components/Translate.tsx
+/**
+* Renders a translated dictionary entry as a reactive text node.
+*
+* `tr(...)` is a hook, so it can only be called inside a component body. Use
+* `<Translate>` wherever a *node* is expected instead — a prop, a `children`
+* slot, or route metadata such as a nav-shell `label`. Because it subscribes to
+* {@link useI18n} it re-renders on a language switch, unlike a string resolved
+* once at module/initialisation time.
+*
+* Sibling of {@link Localize}: `Localize` formats a value (number, date,
+* error); `Translate` looks up a key.
+*
+* @example
+* ```tsx
+* nav: { label: <Translate k="admin.nav.users" /> }
+* <Translate k="cart.items" args={[String(count)]} fallback="Items" />
+* ```
+*/
+const Translate = (props) => {
+	const { tr } = useI18n();
+	return /* @__PURE__ */ jsx(Fragment, { children: tr(props.k, {
+		args: props.args,
+		default: props.fallback
+	}) });
+};
+/**
+* Terse alias for {@link Translate} — handy in dense JSX such as nav labels.
+*/
+const Tr = Translate;
+//#endregion
 //#region ../../src/react/i18n/index.ts
 /**
 * Multi-language support.
@@ -219,6 +251,6 @@ const AlephaReactI18n = $module({
 	services: [I18nProvider]
 });
 //#endregion
-export { $dictionary, AlephaReactI18n, DictionaryPrimitive, I18nProvider, Localize, useI18n };
+export { $dictionary, AlephaReactI18n, DictionaryPrimitive, I18nProvider, Localize, Tr, Translate, useI18n };
 
 //# sourceMappingURL=index.js.map