@burdenoff/website-sdk 2026.1031.3 → 2026.1101.1

package/dist/seo/index.js

@@ -45,24 +45,24 @@ function PageHead({
   return /* @__PURE__ */ jsxRuntime.jsxs(reactHelmetAsync.Helmet, { children: [
     /* @__PURE__ */ jsxRuntime.jsx("title", { children: fullTitle }),
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "title", content: fullTitle }),
-    description && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "description", content: description }),
-    keywords && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "keywords", content: keywords }),
-    author && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "author", content: author }),
+    description ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "description", content: description }) : null,
+    keywords ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "keywords", content: keywords }) : null,
+    author ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "author", content: author }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "robots", content: robots }),
-    resolvedUrl && /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "canonical", href: resolvedUrl }),
-    favicon && /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "icon", href: favicon }),
+    resolvedUrl ? /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "canonical", href: resolvedUrl }) : null,
+    favicon ? /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "icon", href: favicon }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:type", content: "website" }),
     /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:title", content: fullTitle }),
-    description && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:description", content: description }),
-    fullImageUrl && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:image", content: fullImageUrl }),
-    resolvedUrl && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:url", content: resolvedUrl }),
+    description ? /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:description", content: description }) : null,
+    fullImageUrl ? /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:image", content: fullImageUrl }) : null,
+    resolvedUrl ? /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:url", content: resolvedUrl }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:locale", content: locale }),
-    productName && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:site_name", content: productName }),
+    productName ? /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:site_name", content: productName }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:card", content: "summary_large_image" }),
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:title", content: fullTitle }),
-    description && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:description", content: description }),
-    fullImageUrl && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:image", content: fullImageUrl }),
-    twitterHandle && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:creator", content: twitterHandle }),
+    description ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:description", content: description }) : null,
+    fullImageUrl ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:image", content: fullImageUrl }) : null,
+    twitterHandle ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:creator", content: twitterHandle }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "theme-color", content: themeColor }),
     structuredDataItems.map((data, index) => /* @__PURE__ */ jsxRuntime.jsx("script", { type: "application/ld+json", children: serializeJsonLd(data) }, `ld-${index}`)),
     additionalMeta?.map((meta, index) => /* @__PURE__ */ jsxRuntime.jsx(

package/dist/seo/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/seo/page-head.tsx"],"names":["Helmet","jsx"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * PageHead Component\n * Manages dynamic meta tags for SEO optimization on a per-page basis.\n * Supports JSON-LD structured data, Open Graph, Twitter Cards, favicons, and robots directives.\n *\n * @example\n * ```tsx\n * <PageHead\n *   title=\"About Us\"\n *   description=\"Learn about our mission and team\"\n *   productName=\"MyProduct\"\n *   keywords=\"about, team, mission\"\n *   image=\"/og-about.png\"\n *   url=\"https://myproduct.com/about\"\n *   favicon=\"/favicon.ico\"\n *   robots=\"index, follow\"\n *   locale=\"en_US\"\n *   twitterHandle=\"@burdenoff\"\n *   themeColor=\"#1a1a2e\"\n *   structuredData={{\n *     \"@context\": \"https://schema.org\",\n *     \"@type\": \"WebPage\",\n *     name: \"About Us\",\n *   }}\n * />\n * ```\n */\n\nimport { Helmet } from \"react-helmet-async\";\n\nexport interface PageHeadProps {\n  /** Page title */\n  title: string;\n  /** Meta description */\n  description?: string;\n  /** Product/brand name (appended to title) */\n  productName?: string;\n  /** SEO keywords */\n  keywords?: string;\n  /** Open Graph image URL */\n  image?: string;\n  /** Page canonical URL */\n  url?: string;\n  /** Favicon URL */\n  favicon?: string;\n  /** Robots directive (e.g., \"index, follow\") */\n  robots?: string;\n  /** Open Graph locale (e.g., \"en_US\") */\n  locale?: string;\n  /** Twitter handle (e.g., \"@burdenoff\") */\n  twitterHandle?: string;\n  /** Theme color for mobile browsers */\n  themeColor?: string;\n  /**\n   * Value for `<meta name=\"author\">`. Omitted by default.\n   *\n   * Each product site already declares its author in `index.html` as the\n   * legal entity that publicly holds that product (BUR-SOP-029, \"Holder is\n   * what you publish\"), and that entity differs between products. A default\n   * here would add a second, conflicting author tag to every route, so the\n   * tag is only rendered when a site passes the value explicitly.\n   */\n  author?: string;\n  /** JSON-LD structured data objects */\n  structuredData?: Record<string, unknown> | Array<Record<string, unknown>>;\n  /** Additional meta tags */\n  additionalMeta?: Array<{\n    name?: string;\n    property?: string;\n    content: string;\n  }>;\n}\n\n/**\n * Build a self-referencing canonical URL from the current location.\n *\n * Query strings and hashes are dropped (they never identify a distinct\n * canonical document here) and the trailing slash is normalised away for\n * everything but the site root. Returns `undefined` outside a DOM so the\n * component degrades to its previous behaviour under plain string rendering.\n */\nfunction canonicalFromLocation(): string | undefined {\n  if (typeof window === \"undefined\" || !window.location) return undefined;\n  const { origin, pathname } = window.location;\n  if (!origin || origin === \"null\") return undefined;\n  const path = pathname === \"/\" ? \"/\" : pathname.replace(/\\/+$/, \"\");\n  return `${origin}${path}`;\n}\n\n/**\n * Absolutise an Open Graph image URL.\n *\n * Already-absolute URLs pass through. A root-relative path resolves against\n * the origin, and any other relative path against the page URL. Without a\n * resolvable base the original value is returned unchanged.\n */\nfunction resolveImageUrl(\n  image: string | undefined,\n  base: string | undefined,\n): string | undefined {\n  if (!image || /^https?:\\/\\//i.test(image)) return image;\n  if (!base) return image;\n  try {\n    return new URL(image, base).toString();\n  } catch {\n    return image;\n  }\n}\n\n/**\n * JSON-LD as the body of a `<script>` element.\n *\n * `JSON.stringify` leaves `<` alone, and a script body ends at the first `</script` whatever\n * the quoting around it. The prerender serialises the live DOM with script text verbatim,\n * so a `</script><script>…` inside any string field (a caption, a title) would close the\n * JSON-LD block in the static HTML and run what follows. `\\u003c` is the same character to\n * every JSON parser; U+2028 / U+2029 are escaped for engines that still read them as line\n * breaks.\n */\nfunction serializeJsonLd(data: Record<string, unknown>): string {\n  return JSON.stringify(data)\n    .replace(/</g, \"\\\\u003c\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n}\n\nexport function PageHead({\n  title,\n  description,\n  productName,\n  keywords,\n  image,\n  url,\n  favicon,\n  robots = \"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\",\n  locale = \"en_US\",\n  twitterHandle,\n  themeColor = \"#000000\",\n  author,\n  structuredData,\n  additionalMeta,\n}: PageHeadProps) {\n  const fullTitle =\n    productName && !title.includes(productName)\n      ? `${title} | ${productName}`\n      : title;\n\n  // Self-referencing canonical by default.\n  //\n  // Without this, a route that renders PageHead but omits `url` emits no\n  // canonical at all, so the static `<link rel=\"canonical\">` in index.html\n  // survives and every such page declares itself a duplicate of the home\n  // page — Google then drops /pricing, /privacy, /terms and friends from the\n  // index. Deriving it from the current location keeps each page pointing at\n  // itself; callers that genuinely need a cross-canonical still pass `url`.\n  //\n  // During prerender the DOM location already reflects the route being\n  // rendered, so this resolves correctly ahead of hydration.\n  const resolvedUrl = url ?? canonicalFromLocation();\n\n  // Root-relative images (\"/og.png\") belong to the ORIGIN, not to the current\n  // path — concatenating them onto the page URL yields /features/og.png and a\n  // broken share card. Anything else is resolved relative to the page itself.\n  const fullImageUrl = resolveImageUrl(image, resolvedUrl);\n\n  // Normalize structured data to an array\n  const structuredDataItems: Array<Record<string, unknown>> = structuredData\n    ? Array.isArray(structuredData)\n      ? structuredData\n      : [structuredData]\n    : [];\n\n  return (\n    <Helmet>\n      {/* Primary Meta Tags */}\n      <title>{fullTitle}</title>\n      <meta name=\"title\" content={fullTitle} />\n      {description && <meta name=\"description\" content={description} />}\n      {keywords && <meta name=\"keywords\" content={keywords} />}\n      {author && <meta name=\"author\" content={author} />}\n      <meta name=\"robots\" content={robots} />\n\n      {/* Canonical URL */}\n      {resolvedUrl && <link rel=\"canonical\" href={resolvedUrl} />}\n\n      {/* Favicon */}\n      {favicon && <link rel=\"icon\" href={favicon} />}\n\n      {/* Open Graph / Facebook */}\n      <meta property=\"og:type\" content=\"website\" />\n      <meta property=\"og:title\" content={fullTitle} />\n      {description && <meta property=\"og:description\" content={description} />}\n      {fullImageUrl && <meta property=\"og:image\" content={fullImageUrl} />}\n      {resolvedUrl && <meta property=\"og:url\" content={resolvedUrl} />}\n      <meta property=\"og:locale\" content={locale} />\n      {productName && <meta property=\"og:site_name\" content={productName} />}\n\n      {/* Twitter Card */}\n      <meta name=\"twitter:card\" content=\"summary_large_image\" />\n      <meta name=\"twitter:title\" content={fullTitle} />\n      {description && <meta name=\"twitter:description\" content={description} />}\n      {fullImageUrl && <meta name=\"twitter:image\" content={fullImageUrl} />}\n      {twitterHandle && <meta name=\"twitter:creator\" content={twitterHandle} />}\n\n      {/* Theme Color */}\n      <meta name=\"theme-color\" content={themeColor} />\n\n      {/* JSON-LD Structured Data */}\n      {structuredDataItems.map((data, index) => (\n        <script key={`ld-${index}`} type=\"application/ld+json\">\n          {serializeJsonLd(data)}\n        </script>\n      ))}\n\n      {/* Additional Meta Tags */}\n      {additionalMeta?.map((meta, index) => (\n        <meta\n          key={`meta-${index}`}\n          {...(meta.name ? { name: meta.name } : {})}\n          {...(meta.property ? { property: meta.property } : {})}\n          content={meta.content}\n        />\n      ))}\n    </Helmet>\n  );\n}\n"]}
+{"version":3,"sources":["../../src/seo/page-head.tsx"],"names":["Helmet","jsx"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * PageHead Component\n * Manages dynamic meta tags for SEO optimization on a per-page basis.\n * Supports JSON-LD structured data, Open Graph, Twitter Cards, favicons, and robots directives.\n *\n * @example\n * ```tsx\n * <PageHead\n *   title=\"About Us\"\n *   description=\"Learn about our mission and team\"\n *   productName=\"MyProduct\"\n *   keywords=\"about, team, mission\"\n *   image=\"/og-about.png\"\n *   url=\"https://myproduct.com/about\"\n *   favicon=\"/favicon.ico\"\n *   robots=\"index, follow\"\n *   locale=\"en_US\"\n *   twitterHandle=\"@burdenoff\"\n *   themeColor=\"#1a1a2e\"\n *   structuredData={{\n *     \"@context\": \"https://schema.org\",\n *     \"@type\": \"WebPage\",\n *     name: \"About Us\",\n *   }}\n * />\n * ```\n */\n\nimport { Helmet } from \"react-helmet-async\";\n\nexport interface PageHeadProps {\n  /** Page title */\n  title: string;\n  /** Meta description */\n  description?: string;\n  /** Product/brand name (appended to title) */\n  productName?: string;\n  /** SEO keywords */\n  keywords?: string;\n  /** Open Graph image URL */\n  image?: string;\n  /** Page canonical URL */\n  url?: string;\n  /** Favicon URL */\n  favicon?: string;\n  /** Robots directive (e.g., \"index, follow\") */\n  robots?: string;\n  /** Open Graph locale (e.g., \"en_US\") */\n  locale?: string;\n  /** Twitter handle (e.g., \"@burdenoff\") */\n  twitterHandle?: string;\n  /** Theme color for mobile browsers */\n  themeColor?: string;\n  /**\n   * Value for `<meta name=\"author\">`. Omitted by default.\n   *\n   * Each product site already declares its author in `index.html` as the\n   * legal entity that publicly holds that product (BUR-SOP-029, \"Holder is\n   * what you publish\"), and that entity differs between products. A default\n   * here would add a second, conflicting author tag to every route, so the\n   * tag is only rendered when a site passes the value explicitly.\n   */\n  author?: string;\n  /** JSON-LD structured data objects */\n  structuredData?: Record<string, unknown> | Array<Record<string, unknown>>;\n  /** Additional meta tags */\n  additionalMeta?: Array<{\n    name?: string;\n    property?: string;\n    content: string;\n  }>;\n}\n\n/**\n * Build a self-referencing canonical URL from the current location.\n *\n * Query strings and hashes are dropped (they never identify a distinct\n * canonical document here) and the trailing slash is normalised away for\n * everything but the site root. Returns `undefined` outside a DOM so the\n * component degrades to its previous behaviour under plain string rendering.\n */\nfunction canonicalFromLocation(): string | undefined {\n  if (typeof window === \"undefined\" || !window.location) return undefined;\n  const { origin, pathname } = window.location;\n  if (!origin || origin === \"null\") return undefined;\n  const path = pathname === \"/\" ? \"/\" : pathname.replace(/\\/+$/, \"\");\n  return `${origin}${path}`;\n}\n\n/**\n * Absolutise an Open Graph image URL.\n *\n * Already-absolute URLs pass through. A root-relative path resolves against\n * the origin, and any other relative path against the page URL. Without a\n * resolvable base the original value is returned unchanged.\n */\nfunction resolveImageUrl(\n  image: string | undefined,\n  base: string | undefined,\n): string | undefined {\n  if (!image || /^https?:\\/\\//i.test(image)) return image;\n  if (!base) return image;\n  try {\n    return new URL(image, base).toString();\n  } catch {\n    return image;\n  }\n}\n\n/**\n * JSON-LD as the body of a `<script>` element.\n *\n * `JSON.stringify` leaves `<` alone, and a script body ends at the first `</script` whatever\n * the quoting around it. The prerender serialises the live DOM with script text verbatim,\n * so a `</script><script>…` inside any string field (a caption, a title) would close the\n * JSON-LD block in the static HTML and run what follows. `\\u003c` is the same character to\n * every JSON parser; U+2028 / U+2029 are escaped for engines that still read them as line\n * breaks.\n */\nfunction serializeJsonLd(data: Record<string, unknown>): string {\n  return JSON.stringify(data)\n    .replace(/</g, \"\\\\u003c\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n}\n\nexport function PageHead({\n  title,\n  description,\n  productName,\n  keywords,\n  image,\n  url,\n  favicon,\n  robots = \"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\",\n  locale = \"en_US\",\n  twitterHandle,\n  themeColor = \"#000000\",\n  author,\n  structuredData,\n  additionalMeta,\n}: PageHeadProps) {\n  const fullTitle =\n    productName && !title.includes(productName)\n      ? `${title} | ${productName}`\n      : title;\n\n  // Self-referencing canonical by default.\n  //\n  // Without this, a route that renders PageHead but omits `url` emits no\n  // canonical at all, so the static `<link rel=\"canonical\">` in index.html\n  // survives and every such page declares itself a duplicate of the home\n  // page — Google then drops /pricing, /privacy, /terms and friends from the\n  // index. Deriving it from the current location keeps each page pointing at\n  // itself; callers that genuinely need a cross-canonical still pass `url`.\n  //\n  // During prerender the DOM location already reflects the route being\n  // rendered, so this resolves correctly ahead of hydration.\n  const resolvedUrl = url ?? canonicalFromLocation();\n\n  // Root-relative images (\"/og.png\") belong to the ORIGIN, not to the current\n  // path — concatenating them onto the page URL yields /features/og.png and a\n  // broken share card. Anything else is resolved relative to the page itself.\n  const fullImageUrl = resolveImageUrl(image, resolvedUrl);\n\n  // Normalize structured data to an array\n  const structuredDataItems: Array<Record<string, unknown>> = structuredData\n    ? Array.isArray(structuredData)\n      ? structuredData\n      : [structuredData]\n    : [];\n\n  // Every conditional below is a `? … : null` ternary, never `x && <el />`.\n  // `&&` forwards the left operand when it is falsy, so an empty-string prop\n  // (keywords is legitimately \"\" on generated answer pages) would reach Helmet\n  // as a string child. react-helmet-async skips any falsy child, but its\n  // maintained fork @dr.pogodin/react-helmet skips only null/undefined and\n  // throws `\"string\" is not a valid <Helmet> descendant` — which crashes the\n  // whole page at render time. `null` is skipped by both.\n  return (\n    <Helmet>\n      {/* Primary Meta Tags */}\n      <title>{fullTitle}</title>\n      <meta name=\"title\" content={fullTitle} />\n      {description ? <meta name=\"description\" content={description} /> : null}\n      {keywords ? <meta name=\"keywords\" content={keywords} /> : null}\n      {author ? <meta name=\"author\" content={author} /> : null}\n      <meta name=\"robots\" content={robots} />\n\n      {/* Canonical URL */}\n      {resolvedUrl ? <link rel=\"canonical\" href={resolvedUrl} /> : null}\n\n      {/* Favicon */}\n      {favicon ? <link rel=\"icon\" href={favicon} /> : null}\n\n      {/* Open Graph / Facebook */}\n      <meta property=\"og:type\" content=\"website\" />\n      <meta property=\"og:title\" content={fullTitle} />\n      {description ? (\n        <meta property=\"og:description\" content={description} />\n      ) : null}\n      {fullImageUrl ? (\n        <meta property=\"og:image\" content={fullImageUrl} />\n      ) : null}\n      {resolvedUrl ? <meta property=\"og:url\" content={resolvedUrl} /> : null}\n      <meta property=\"og:locale\" content={locale} />\n      {productName ? (\n        <meta property=\"og:site_name\" content={productName} />\n      ) : null}\n\n      {/* Twitter Card */}\n      <meta name=\"twitter:card\" content=\"summary_large_image\" />\n      <meta name=\"twitter:title\" content={fullTitle} />\n      {description ? (\n        <meta name=\"twitter:description\" content={description} />\n      ) : null}\n      {fullImageUrl ? (\n        <meta name=\"twitter:image\" content={fullImageUrl} />\n      ) : null}\n      {twitterHandle ? (\n        <meta name=\"twitter:creator\" content={twitterHandle} />\n      ) : null}\n\n      {/* Theme Color */}\n      <meta name=\"theme-color\" content={themeColor} />\n\n      {/* JSON-LD Structured Data */}\n      {structuredDataItems.map((data, index) => (\n        <script key={`ld-${index}`} type=\"application/ld+json\">\n          {serializeJsonLd(data)}\n        </script>\n      ))}\n\n      {/* Additional Meta Tags */}\n      {additionalMeta?.map((meta, index) => (\n        <meta\n          key={`meta-${index}`}\n          {...(meta.name ? { name: meta.name } : {})}\n          {...(meta.property ? { property: meta.property } : {})}\n          content={meta.content}\n        />\n      ))}\n    </Helmet>\n  );\n}\n"]}

package/dist/seo/index.mjs

@@ -43,24 +43,24 @@ function PageHead({
   return /* @__PURE__ */ jsxs(Helmet, { children: [
     /* @__PURE__ */ jsx("title", { children: fullTitle }),
     /* @__PURE__ */ jsx("meta", { name: "title", content: fullTitle }),
-    description && /* @__PURE__ */ jsx("meta", { name: "description", content: description }),
-    keywords && /* @__PURE__ */ jsx("meta", { name: "keywords", content: keywords }),
-    author && /* @__PURE__ */ jsx("meta", { name: "author", content: author }),
+    description ? /* @__PURE__ */ jsx("meta", { name: "description", content: description }) : null,
+    keywords ? /* @__PURE__ */ jsx("meta", { name: "keywords", content: keywords }) : null,
+    author ? /* @__PURE__ */ jsx("meta", { name: "author", content: author }) : null,
     /* @__PURE__ */ jsx("meta", { name: "robots", content: robots }),
-    resolvedUrl && /* @__PURE__ */ jsx("link", { rel: "canonical", href: resolvedUrl }),
-    favicon && /* @__PURE__ */ jsx("link", { rel: "icon", href: favicon }),
+    resolvedUrl ? /* @__PURE__ */ jsx("link", { rel: "canonical", href: resolvedUrl }) : null,
+    favicon ? /* @__PURE__ */ jsx("link", { rel: "icon", href: favicon }) : null,
     /* @__PURE__ */ jsx("meta", { property: "og:type", content: "website" }),
     /* @__PURE__ */ jsx("meta", { property: "og:title", content: fullTitle }),
-    description && /* @__PURE__ */ jsx("meta", { property: "og:description", content: description }),
-    fullImageUrl && /* @__PURE__ */ jsx("meta", { property: "og:image", content: fullImageUrl }),
-    resolvedUrl && /* @__PURE__ */ jsx("meta", { property: "og:url", content: resolvedUrl }),
+    description ? /* @__PURE__ */ jsx("meta", { property: "og:description", content: description }) : null,
+    fullImageUrl ? /* @__PURE__ */ jsx("meta", { property: "og:image", content: fullImageUrl }) : null,
+    resolvedUrl ? /* @__PURE__ */ jsx("meta", { property: "og:url", content: resolvedUrl }) : null,
     /* @__PURE__ */ jsx("meta", { property: "og:locale", content: locale }),
-    productName && /* @__PURE__ */ jsx("meta", { property: "og:site_name", content: productName }),
+    productName ? /* @__PURE__ */ jsx("meta", { property: "og:site_name", content: productName }) : null,
     /* @__PURE__ */ jsx("meta", { name: "twitter:card", content: "summary_large_image" }),
     /* @__PURE__ */ jsx("meta", { name: "twitter:title", content: fullTitle }),
-    description && /* @__PURE__ */ jsx("meta", { name: "twitter:description", content: description }),
-    fullImageUrl && /* @__PURE__ */ jsx("meta", { name: "twitter:image", content: fullImageUrl }),
-    twitterHandle && /* @__PURE__ */ jsx("meta", { name: "twitter:creator", content: twitterHandle }),
+    description ? /* @__PURE__ */ jsx("meta", { name: "twitter:description", content: description }) : null,
+    fullImageUrl ? /* @__PURE__ */ jsx("meta", { name: "twitter:image", content: fullImageUrl }) : null,
+    twitterHandle ? /* @__PURE__ */ jsx("meta", { name: "twitter:creator", content: twitterHandle }) : null,
     /* @__PURE__ */ jsx("meta", { name: "theme-color", content: themeColor }),
     structuredDataItems.map((data, index) => /* @__PURE__ */ jsx("script", { type: "application/ld+json", children: serializeJsonLd(data) }, `ld-${index}`)),
     additionalMeta?.map((meta, index) => /* @__PURE__ */ jsx(

package/dist/seo/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/seo/page-head.tsx"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * PageHead Component\n * Manages dynamic meta tags for SEO optimization on a per-page basis.\n * Supports JSON-LD structured data, Open Graph, Twitter Cards, favicons, and robots directives.\n *\n * @example\n * ```tsx\n * <PageHead\n *   title=\"About Us\"\n *   description=\"Learn about our mission and team\"\n *   productName=\"MyProduct\"\n *   keywords=\"about, team, mission\"\n *   image=\"/og-about.png\"\n *   url=\"https://myproduct.com/about\"\n *   favicon=\"/favicon.ico\"\n *   robots=\"index, follow\"\n *   locale=\"en_US\"\n *   twitterHandle=\"@burdenoff\"\n *   themeColor=\"#1a1a2e\"\n *   structuredData={{\n *     \"@context\": \"https://schema.org\",\n *     \"@type\": \"WebPage\",\n *     name: \"About Us\",\n *   }}\n * />\n * ```\n */\n\nimport { Helmet } from \"react-helmet-async\";\n\nexport interface PageHeadProps {\n  /** Page title */\n  title: string;\n  /** Meta description */\n  description?: string;\n  /** Product/brand name (appended to title) */\n  productName?: string;\n  /** SEO keywords */\n  keywords?: string;\n  /** Open Graph image URL */\n  image?: string;\n  /** Page canonical URL */\n  url?: string;\n  /** Favicon URL */\n  favicon?: string;\n  /** Robots directive (e.g., \"index, follow\") */\n  robots?: string;\n  /** Open Graph locale (e.g., \"en_US\") */\n  locale?: string;\n  /** Twitter handle (e.g., \"@burdenoff\") */\n  twitterHandle?: string;\n  /** Theme color for mobile browsers */\n  themeColor?: string;\n  /**\n   * Value for `<meta name=\"author\">`. Omitted by default.\n   *\n   * Each product site already declares its author in `index.html` as the\n   * legal entity that publicly holds that product (BUR-SOP-029, \"Holder is\n   * what you publish\"), and that entity differs between products. A default\n   * here would add a second, conflicting author tag to every route, so the\n   * tag is only rendered when a site passes the value explicitly.\n   */\n  author?: string;\n  /** JSON-LD structured data objects */\n  structuredData?: Record<string, unknown> | Array<Record<string, unknown>>;\n  /** Additional meta tags */\n  additionalMeta?: Array<{\n    name?: string;\n    property?: string;\n    content: string;\n  }>;\n}\n\n/**\n * Build a self-referencing canonical URL from the current location.\n *\n * Query strings and hashes are dropped (they never identify a distinct\n * canonical document here) and the trailing slash is normalised away for\n * everything but the site root. Returns `undefined` outside a DOM so the\n * component degrades to its previous behaviour under plain string rendering.\n */\nfunction canonicalFromLocation(): string | undefined {\n  if (typeof window === \"undefined\" || !window.location) return undefined;\n  const { origin, pathname } = window.location;\n  if (!origin || origin === \"null\") return undefined;\n  const path = pathname === \"/\" ? \"/\" : pathname.replace(/\\/+$/, \"\");\n  return `${origin}${path}`;\n}\n\n/**\n * Absolutise an Open Graph image URL.\n *\n * Already-absolute URLs pass through. A root-relative path resolves against\n * the origin, and any other relative path against the page URL. Without a\n * resolvable base the original value is returned unchanged.\n */\nfunction resolveImageUrl(\n  image: string | undefined,\n  base: string | undefined,\n): string | undefined {\n  if (!image || /^https?:\\/\\//i.test(image)) return image;\n  if (!base) return image;\n  try {\n    return new URL(image, base).toString();\n  } catch {\n    return image;\n  }\n}\n\n/**\n * JSON-LD as the body of a `<script>` element.\n *\n * `JSON.stringify` leaves `<` alone, and a script body ends at the first `</script` whatever\n * the quoting around it. The prerender serialises the live DOM with script text verbatim,\n * so a `</script><script>…` inside any string field (a caption, a title) would close the\n * JSON-LD block in the static HTML and run what follows. `\\u003c` is the same character to\n * every JSON parser; U+2028 / U+2029 are escaped for engines that still read them as line\n * breaks.\n */\nfunction serializeJsonLd(data: Record<string, unknown>): string {\n  return JSON.stringify(data)\n    .replace(/</g, \"\\\\u003c\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n}\n\nexport function PageHead({\n  title,\n  description,\n  productName,\n  keywords,\n  image,\n  url,\n  favicon,\n  robots = \"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\",\n  locale = \"en_US\",\n  twitterHandle,\n  themeColor = \"#000000\",\n  author,\n  structuredData,\n  additionalMeta,\n}: PageHeadProps) {\n  const fullTitle =\n    productName && !title.includes(productName)\n      ? `${title} | ${productName}`\n      : title;\n\n  // Self-referencing canonical by default.\n  //\n  // Without this, a route that renders PageHead but omits `url` emits no\n  // canonical at all, so the static `<link rel=\"canonical\">` in index.html\n  // survives and every such page declares itself a duplicate of the home\n  // page — Google then drops /pricing, /privacy, /terms and friends from the\n  // index. Deriving it from the current location keeps each page pointing at\n  // itself; callers that genuinely need a cross-canonical still pass `url`.\n  //\n  // During prerender the DOM location already reflects the route being\n  // rendered, so this resolves correctly ahead of hydration.\n  const resolvedUrl = url ?? canonicalFromLocation();\n\n  // Root-relative images (\"/og.png\") belong to the ORIGIN, not to the current\n  // path — concatenating them onto the page URL yields /features/og.png and a\n  // broken share card. Anything else is resolved relative to the page itself.\n  const fullImageUrl = resolveImageUrl(image, resolvedUrl);\n\n  // Normalize structured data to an array\n  const structuredDataItems: Array<Record<string, unknown>> = structuredData\n    ? Array.isArray(structuredData)\n      ? structuredData\n      : [structuredData]\n    : [];\n\n  return (\n    <Helmet>\n      {/* Primary Meta Tags */}\n      <title>{fullTitle}</title>\n      <meta name=\"title\" content={fullTitle} />\n      {description && <meta name=\"description\" content={description} />}\n      {keywords && <meta name=\"keywords\" content={keywords} />}\n      {author && <meta name=\"author\" content={author} />}\n      <meta name=\"robots\" content={robots} />\n\n      {/* Canonical URL */}\n      {resolvedUrl && <link rel=\"canonical\" href={resolvedUrl} />}\n\n      {/* Favicon */}\n      {favicon && <link rel=\"icon\" href={favicon} />}\n\n      {/* Open Graph / Facebook */}\n      <meta property=\"og:type\" content=\"website\" />\n      <meta property=\"og:title\" content={fullTitle} />\n      {description && <meta property=\"og:description\" content={description} />}\n      {fullImageUrl && <meta property=\"og:image\" content={fullImageUrl} />}\n      {resolvedUrl && <meta property=\"og:url\" content={resolvedUrl} />}\n      <meta property=\"og:locale\" content={locale} />\n      {productName && <meta property=\"og:site_name\" content={productName} />}\n\n      {/* Twitter Card */}\n      <meta name=\"twitter:card\" content=\"summary_large_image\" />\n      <meta name=\"twitter:title\" content={fullTitle} />\n      {description && <meta name=\"twitter:description\" content={description} />}\n      {fullImageUrl && <meta name=\"twitter:image\" content={fullImageUrl} />}\n      {twitterHandle && <meta name=\"twitter:creator\" content={twitterHandle} />}\n\n      {/* Theme Color */}\n      <meta name=\"theme-color\" content={themeColor} />\n\n      {/* JSON-LD Structured Data */}\n      {structuredDataItems.map((data, index) => (\n        <script key={`ld-${index}`} type=\"application/ld+json\">\n          {serializeJsonLd(data)}\n        </script>\n      ))}\n\n      {/* Additional Meta Tags */}\n      {additionalMeta?.map((meta, index) => (\n        <meta\n          key={`meta-${index}`}\n          {...(meta.name ? { name: meta.name } : {})}\n          {...(meta.property ? { property: meta.property } : {})}\n          content={meta.content}\n        />\n      ))}\n    </Helmet>\n  );\n}\n"]}
+{"version":3,"sources":["../../src/seo/page-head.tsx"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * PageHead Component\n * Manages dynamic meta tags for SEO optimization on a per-page basis.\n * Supports JSON-LD structured data, Open Graph, Twitter Cards, favicons, and robots directives.\n *\n * @example\n * ```tsx\n * <PageHead\n *   title=\"About Us\"\n *   description=\"Learn about our mission and team\"\n *   productName=\"MyProduct\"\n *   keywords=\"about, team, mission\"\n *   image=\"/og-about.png\"\n *   url=\"https://myproduct.com/about\"\n *   favicon=\"/favicon.ico\"\n *   robots=\"index, follow\"\n *   locale=\"en_US\"\n *   twitterHandle=\"@burdenoff\"\n *   themeColor=\"#1a1a2e\"\n *   structuredData={{\n *     \"@context\": \"https://schema.org\",\n *     \"@type\": \"WebPage\",\n *     name: \"About Us\",\n *   }}\n * />\n * ```\n */\n\nimport { Helmet } from \"react-helmet-async\";\n\nexport interface PageHeadProps {\n  /** Page title */\n  title: string;\n  /** Meta description */\n  description?: string;\n  /** Product/brand name (appended to title) */\n  productName?: string;\n  /** SEO keywords */\n  keywords?: string;\n  /** Open Graph image URL */\n  image?: string;\n  /** Page canonical URL */\n  url?: string;\n  /** Favicon URL */\n  favicon?: string;\n  /** Robots directive (e.g., \"index, follow\") */\n  robots?: string;\n  /** Open Graph locale (e.g., \"en_US\") */\n  locale?: string;\n  /** Twitter handle (e.g., \"@burdenoff\") */\n  twitterHandle?: string;\n  /** Theme color for mobile browsers */\n  themeColor?: string;\n  /**\n   * Value for `<meta name=\"author\">`. Omitted by default.\n   *\n   * Each product site already declares its author in `index.html` as the\n   * legal entity that publicly holds that product (BUR-SOP-029, \"Holder is\n   * what you publish\"), and that entity differs between products. A default\n   * here would add a second, conflicting author tag to every route, so the\n   * tag is only rendered when a site passes the value explicitly.\n   */\n  author?: string;\n  /** JSON-LD structured data objects */\n  structuredData?: Record<string, unknown> | Array<Record<string, unknown>>;\n  /** Additional meta tags */\n  additionalMeta?: Array<{\n    name?: string;\n    property?: string;\n    content: string;\n  }>;\n}\n\n/**\n * Build a self-referencing canonical URL from the current location.\n *\n * Query strings and hashes are dropped (they never identify a distinct\n * canonical document here) and the trailing slash is normalised away for\n * everything but the site root. Returns `undefined` outside a DOM so the\n * component degrades to its previous behaviour under plain string rendering.\n */\nfunction canonicalFromLocation(): string | undefined {\n  if (typeof window === \"undefined\" || !window.location) return undefined;\n  const { origin, pathname } = window.location;\n  if (!origin || origin === \"null\") return undefined;\n  const path = pathname === \"/\" ? \"/\" : pathname.replace(/\\/+$/, \"\");\n  return `${origin}${path}`;\n}\n\n/**\n * Absolutise an Open Graph image URL.\n *\n * Already-absolute URLs pass through. A root-relative path resolves against\n * the origin, and any other relative path against the page URL. Without a\n * resolvable base the original value is returned unchanged.\n */\nfunction resolveImageUrl(\n  image: string | undefined,\n  base: string | undefined,\n): string | undefined {\n  if (!image || /^https?:\\/\\//i.test(image)) return image;\n  if (!base) return image;\n  try {\n    return new URL(image, base).toString();\n  } catch {\n    return image;\n  }\n}\n\n/**\n * JSON-LD as the body of a `<script>` element.\n *\n * `JSON.stringify` leaves `<` alone, and a script body ends at the first `</script` whatever\n * the quoting around it. The prerender serialises the live DOM with script text verbatim,\n * so a `</script><script>…` inside any string field (a caption, a title) would close the\n * JSON-LD block in the static HTML and run what follows. `\\u003c` is the same character to\n * every JSON parser; U+2028 / U+2029 are escaped for engines that still read them as line\n * breaks.\n */\nfunction serializeJsonLd(data: Record<string, unknown>): string {\n  return JSON.stringify(data)\n    .replace(/</g, \"\\\\u003c\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n}\n\nexport function PageHead({\n  title,\n  description,\n  productName,\n  keywords,\n  image,\n  url,\n  favicon,\n  robots = \"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\",\n  locale = \"en_US\",\n  twitterHandle,\n  themeColor = \"#000000\",\n  author,\n  structuredData,\n  additionalMeta,\n}: PageHeadProps) {\n  const fullTitle =\n    productName && !title.includes(productName)\n      ? `${title} | ${productName}`\n      : title;\n\n  // Self-referencing canonical by default.\n  //\n  // Without this, a route that renders PageHead but omits `url` emits no\n  // canonical at all, so the static `<link rel=\"canonical\">` in index.html\n  // survives and every such page declares itself a duplicate of the home\n  // page — Google then drops /pricing, /privacy, /terms and friends from the\n  // index. Deriving it from the current location keeps each page pointing at\n  // itself; callers that genuinely need a cross-canonical still pass `url`.\n  //\n  // During prerender the DOM location already reflects the route being\n  // rendered, so this resolves correctly ahead of hydration.\n  const resolvedUrl = url ?? canonicalFromLocation();\n\n  // Root-relative images (\"/og.png\") belong to the ORIGIN, not to the current\n  // path — concatenating them onto the page URL yields /features/og.png and a\n  // broken share card. Anything else is resolved relative to the page itself.\n  const fullImageUrl = resolveImageUrl(image, resolvedUrl);\n\n  // Normalize structured data to an array\n  const structuredDataItems: Array<Record<string, unknown>> = structuredData\n    ? Array.isArray(structuredData)\n      ? structuredData\n      : [structuredData]\n    : [];\n\n  // Every conditional below is a `? … : null` ternary, never `x && <el />`.\n  // `&&` forwards the left operand when it is falsy, so an empty-string prop\n  // (keywords is legitimately \"\" on generated answer pages) would reach Helmet\n  // as a string child. react-helmet-async skips any falsy child, but its\n  // maintained fork @dr.pogodin/react-helmet skips only null/undefined and\n  // throws `\"string\" is not a valid <Helmet> descendant` — which crashes the\n  // whole page at render time. `null` is skipped by both.\n  return (\n    <Helmet>\n      {/* Primary Meta Tags */}\n      <title>{fullTitle}</title>\n      <meta name=\"title\" content={fullTitle} />\n      {description ? <meta name=\"description\" content={description} /> : null}\n      {keywords ? <meta name=\"keywords\" content={keywords} /> : null}\n      {author ? <meta name=\"author\" content={author} /> : null}\n      <meta name=\"robots\" content={robots} />\n\n      {/* Canonical URL */}\n      {resolvedUrl ? <link rel=\"canonical\" href={resolvedUrl} /> : null}\n\n      {/* Favicon */}\n      {favicon ? <link rel=\"icon\" href={favicon} /> : null}\n\n      {/* Open Graph / Facebook */}\n      <meta property=\"og:type\" content=\"website\" />\n      <meta property=\"og:title\" content={fullTitle} />\n      {description ? (\n        <meta property=\"og:description\" content={description} />\n      ) : null}\n      {fullImageUrl ? (\n        <meta property=\"og:image\" content={fullImageUrl} />\n      ) : null}\n      {resolvedUrl ? <meta property=\"og:url\" content={resolvedUrl} /> : null}\n      <meta property=\"og:locale\" content={locale} />\n      {productName ? (\n        <meta property=\"og:site_name\" content={productName} />\n      ) : null}\n\n      {/* Twitter Card */}\n      <meta name=\"twitter:card\" content=\"summary_large_image\" />\n      <meta name=\"twitter:title\" content={fullTitle} />\n      {description ? (\n        <meta name=\"twitter:description\" content={description} />\n      ) : null}\n      {fullImageUrl ? (\n        <meta name=\"twitter:image\" content={fullImageUrl} />\n      ) : null}\n      {twitterHandle ? (\n        <meta name=\"twitter:creator\" content={twitterHandle} />\n      ) : null}\n\n      {/* Theme Color */}\n      <meta name=\"theme-color\" content={themeColor} />\n\n      {/* JSON-LD Structured Data */}\n      {structuredDataItems.map((data, index) => (\n        <script key={`ld-${index}`} type=\"application/ld+json\">\n          {serializeJsonLd(data)}\n        </script>\n      ))}\n\n      {/* Additional Meta Tags */}\n      {additionalMeta?.map((meta, index) => (\n        <meta\n          key={`meta-${index}`}\n          {...(meta.name ? { name: meta.name } : {})}\n          {...(meta.property ? { property: meta.property } : {})}\n          content={meta.content}\n        />\n      ))}\n    </Helmet>\n  );\n}\n"]}

package/dist/store/index.js

@@ -493,24 +493,24 @@ function PageHead({
   return /* @__PURE__ */ jsxRuntime.jsxs(reactHelmetAsync.Helmet, { children: [
     /* @__PURE__ */ jsxRuntime.jsx("title", { children: fullTitle }),
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "title", content: fullTitle }),
-    description && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "description", content: description }),
-    keywords && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "keywords", content: keywords }),
-    author && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "author", content: author }),
+    description ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "description", content: description }) : null,
+    keywords ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "keywords", content: keywords }) : null,
+    author ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "author", content: author }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "robots", content: robots }),
-    resolvedUrl && /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "canonical", href: resolvedUrl }),
-    favicon && /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "icon", href: favicon }),
+    resolvedUrl ? /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "canonical", href: resolvedUrl }) : null,
+    favicon ? /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "icon", href: favicon }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:type", content: "website" }),
     /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:title", content: fullTitle }),
-    description && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:description", content: description }),
-    fullImageUrl && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:image", content: fullImageUrl }),
-    resolvedUrl && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:url", content: resolvedUrl }),
+    description ? /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:description", content: description }) : null,
+    fullImageUrl ? /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:image", content: fullImageUrl }) : null,
+    resolvedUrl ? /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:url", content: resolvedUrl }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:locale", content: locale }),
-    productName && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:site_name", content: productName }),
+    productName ? /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:site_name", content: productName }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:card", content: "summary_large_image" }),
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:title", content: fullTitle }),
-    description && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:description", content: description }),
-    fullImageUrl && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:image", content: fullImageUrl }),
-    twitterHandle && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:creator", content: twitterHandle }),
+    description ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:description", content: description }) : null,
+    fullImageUrl ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:image", content: fullImageUrl }) : null,
+    twitterHandle ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:creator", content: twitterHandle }) : null,
     /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "theme-color", content: themeColor }),
     structuredDataItems.map((data, index) => /* @__PURE__ */ jsxRuntime.jsx("script", { type: "application/ld+json", children: serializeJsonLd(data) }, `ld-${index}`)),
     additionalMeta?.map((meta, index) => /* @__PURE__ */ jsxRuntime.jsx(