@flamingo-stack/openframe-frontend-core 0.0.285 → 0.0.286-snapshot.20260618154650

package/dist/{chunk-RJUGNL2A.cjs → chunk-RG6FNZUA.cjs}

@@ -1,18 +1,25 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
 
 
-var _chunkGVSTRN36cjs = require('./chunk-GVSTRN36.cjs');
+var _chunkD3LEFMOAcjs = require('./chunk-D3LEFMOA.cjs');
 
 
+var _chunkOXC72UIPcjs = require('./chunk-OXC72UIP.cjs');
 
 
 
-var _chunkDPKUSBQHcjs = require('./chunk-DPKUSBQH.cjs');
 
 
 
 
-var _chunkPVXCVPJDcjs = require('./chunk-PVXCVPJD.cjs');
+var _chunkD6RK5YXXcjs = require('./chunk-D6RK5YXX.cjs');
+
+
+
+var _chunkEI4WALN2cjs = require('./chunk-EI4WALN2.cjs');
+
+
+var _chunkY4JNA4W6cjs = require('./chunk-Y4JNA4W6.cjs');
 
 
 
@@ -63,7 +70,8 @@ function FaqAccordion({ items, defaultOpenIds = [] }) {
     return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
       "div",
       {
-        className: _chunkFIG2RKZFcjs.cn.call(void 0, "group transition-colors hover:bg-[#1E1E1E]", isOpen ? "bg-ods-bg" : "bg-transparent"),
+        id: _chunkD6RK5YXXcjs.faqItemAnchor.call(void 0, item.id),
+        className: _chunkFIG2RKZFcjs.cn.call(void 0, "group scroll-mt-24 transition-colors hover:bg-[#1E1E1E]", isOpen ? "bg-ods-bg" : "bg-transparent"),
         children: [
           /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
             "div",
@@ -82,7 +90,7 @@ function FaqAccordion({ items, defaultOpenIds = [] }) {
               children: [
                 /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "min-w-0 pr-4", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h3", { children: item.question }) }),
                 /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "flex-shrink-0", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                  _chunkDPKUSBQHcjs.ChevronButton,
+                  _chunkOXC72UIPcjs.ChevronButton,
                   {
                     "aria-label": isOpen ? "Collapse question" : "Expand question",
                     size: "md",
@@ -142,10 +150,7 @@ function buildFaqJsonLdFromFaqs(faqs, opts = {}) {
 
 var DEFAULT_HEADING_TEXT = "Frequently Asked Questions";
 function buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl = "") {
-  return _chunkDPKUSBQHcjs.buildSuggestionUrl.call(void 0, "/api/faqs", { apiBaseUrl, entityType, entityId, count: minResults });
-}
-function sectionSlug(section) {
-  return "faq-" + section.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return _chunkD6RK5YXXcjs.buildSuggestionUrl.call(void 0, "/api/faqs", { apiBaseUrl, entityType, entityId, count: minResults });
 }
 function groupFaqsBySection(faqs) {
   const order = [];
@@ -161,7 +166,7 @@ function groupFaqsBySection(faqs) {
     }
     let group = byName.get(name);
     if (!group) {
-      group = { section: name, slug: sectionSlug(name), items: [] };
+      group = { section: name, slug: _chunkD6RK5YXXcjs.faqSectionSlug.call(void 0, name), items: [] };
       byName.set(name, group);
       order.push(name);
     }
@@ -172,6 +177,8 @@ function groupFaqsBySection(faqs) {
   return groups;
 }
 var FAQ_NAV_HEADER_OFFSET = 96;
+var UNCATEGORIZED_KEY = "__uncategorized__";
+var groupKey = (g) => _nullishCoalesce(g.slug, () => ( UNCATEGORIZED_KEY));
 function GroupedFaqList({
   groups,
   categoryHeadingAs
@@ -208,11 +215,36 @@ function GroupedFaqList({
     }
     return () => observer.disconnect();
   }, [slugKey]);
+  const [hashTarget, setHashTarget] = _react.useState.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    const refresh = () => setHashTarget(_chunkD6RK5YXXcjs.parseFaqHash.call(void 0, window.location.hash));
+    refresh();
+    window.addEventListener("hashchange", refresh);
+    return () => window.removeEventListener("hashchange", refresh);
+  }, []);
+  const defaultOpenByGroupKey = _react.useMemo.call(void 0, () => {
+    if (_optionalChain([hashTarget, 'optionalAccess', _7 => _7.kind]) !== "item") return null;
+    const targetId = hashTarget.rawId;
+    const result = /* @__PURE__ */ new Map();
+    for (const group of groups) {
+      const hit = group.items.find((i) => String(i.id) === targetId);
+      if (hit) result.set(groupKey(group), [hit.id]);
+    }
+    return result.size > 0 ? result : null;
+  }, [groups, hashTarget]);
+  const accordionKeySuffix = _optionalChain([hashTarget, 'optionalAccess', _8 => _8.kind]) === "item" ? `item:${hashTarget.rawId}` : "default";
+  _react.useEffect.call(void 0, () => {
+    if (!hashTarget) return;
+    const elId = hashTarget.kind === "item" ? _chunkD6RK5YXXcjs.faqItemAnchor.call(void 0, hashTarget.rawId) : hashTarget.slug;
+    const el = document.getElementById(elId);
+    if (el) _chunkD6RK5YXXcjs.scrollElementIntoView.call(void 0, el, { headerOffset: FAQ_NAV_HEADER_OFFSET });
+    if (hashTarget.kind === "section") setActiveSlug(hashTarget.slug);
+  }, [hashTarget]);
   const handleJump = _react.useCallback.call(void 0, 
     (e, slug) => {
       e.preventDefault();
       setActiveSlug(slug);
-      _chunkDPKUSBQHcjs.scrollElementIntoView.call(void 0, document.getElementById(slug), {
+      _chunkD6RK5YXXcjs.scrollElementIntoView.call(void 0, document.getElementById(slug), {
         headerOffset: FAQ_NAV_HEADER_OFFSET
       });
       if (typeof history !== "undefined") history.replaceState(null, "", `#${slug}`);
@@ -237,18 +269,28 @@ function GroupedFaqList({
         group.slug
       );
     }) }),
-    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "space-y-10", children: groups.map((group) => /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
-      "section",
-      {
-        id: _nullishCoalesce(group.slug, () => ( void 0)),
-        className: "scroll-mt-24 space-y-4",
-        children: [
-          group.section && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, CategoryHeading, { className: _chunkPVXCVPJDcjs.SECTION_HEADING_CLASS, children: group.section }),
-          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, FaqAccordion, { items: group.items })
-        ]
-      },
-      _nullishCoalesce(group.slug, () => ( "faq-uncategorized"))
-    )) })
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "space-y-10", children: groups.map((group) => {
+      const key = groupKey(group);
+      return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+        "section",
+        {
+          id: _nullishCoalesce(group.slug, () => ( void 0)),
+          className: "scroll-mt-24 space-y-4",
+          children: [
+            group.section && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, CategoryHeading, { className: _chunkY4JNA4W6cjs.SECTION_HEADING_CLASS, children: group.section }),
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+              FaqAccordion,
+              {
+                items: group.items,
+                defaultOpenIds: _optionalChain([defaultOpenByGroupKey, 'optionalAccess', _9 => _9.get, 'call', _10 => _10(key)])
+              },
+              `${key}:${accordionKeySuffix}`
+            )
+          ]
+        },
+        key
+      );
+    }) })
   ] });
 }
 function FaqSkeleton() {
@@ -276,10 +318,10 @@ function FaqSection({
     () => initialFaqs ? { faqs: initialFaqs } : void 0,
     [initialFaqs]
   );
-  const { data, isLoading, error } = _chunkGVSTRN36cjs.useSelfFetch.call(void 0, url, { initialData });
-  const faqs = _nullishCoalesce(_optionalChain([data, 'optionalAccess', _7 => _7.faqs]), () => ( []));
+  const { data, isLoading, error } = _chunkD3LEFMOAcjs.useSelfFetch.call(void 0, url, { initialData });
+  const faqs = _nullishCoalesce(_optionalChain([data, 'optionalAccess', _11 => _11.faqs]), () => ( []));
   const groups = _react.useMemo.call(void 0, () => faqs.length > 0 ? groupFaqsBySection(faqs) : [], [faqs]);
-  const headingNode = heading === void 0 ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: _chunkPVXCVPJDcjs.SECTION_HEADING_CLASS, children: DEFAULT_HEADING_TEXT }) : heading;
+  const headingNode = heading === void 0 ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: _chunkY4JNA4W6cjs.SECTION_HEADING_CLASS, children: DEFAULT_HEADING_TEXT }) : heading;
   if (error) return null;
   if (!isLoading && faqs.length === 0) return null;
   if (isLoading && faqs.length === 0) {
@@ -295,7 +337,7 @@ function FaqSection({
       "script",
       {
         type: "application/ld+json",
-        dangerouslySetInnerHTML: { __html: _chunkDPKUSBQHcjs.serializeJsonLd.call(void 0, schema) }
+        dangerouslySetInnerHTML: { __html: _chunkD6RK5YXXcjs.serializeJsonLd.call(void 0, schema) }
       }
     )
   ] });
@@ -315,10 +357,10 @@ function FaqDocumentPage({
 }) {
   const router = _chunkG7UE6RKVcjs.useRouter.call(void 0, );
   const backCfg = backButton === false ? void 0 : {
-    label: _nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _8 => _8.label]), () => ( "Back to home")),
-    onClick: () => router.push(_nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _9 => _9.href]), () => ( "/")))
+    label: _nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _12 => _12.label]), () => ( "Back to home")),
+    onClick: () => router.push(_nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _13 => _13.href]), () => ( "/")))
   };
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPVXCVPJDcjs.PageShell, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPVXCVPJDcjs.PageLayout, { title, subtitle, backButton: backCfg, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEI4WALN2cjs.PageShell, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEI4WALN2cjs.PageLayout, { title, subtitle, backButton: backCfg, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
     FaqSection,
     {
       heading: null,
@@ -335,4 +377,4 @@ function FaqDocumentPage({
 
 
 exports.FaqAccordion = FaqAccordion; exports.FaqSection = FaqSection; exports.FaqDocumentPage = FaqDocumentPage;
-//# sourceMappingURL=chunk-RJUGNL2A.cjs.map
+//# sourceMappingURL=chunk-RG6FNZUA.cjs.map

package/dist/chunk-RG6FNZUA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-RG6FNZUA.cjs","../src/components/faq/faq-section.tsx","../src/components/faq-accordion.tsx","../src/components/faq/json-ld.ts","../src/components/faq/faq-document-page.tsx"],"names":["jsx","jsxs"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-RG6FNZUA.cjs","sourcesContent":[null,"\"use client\"\n\nimport React, { useCallback, useEffect, useMemo, useState } from 'react'\nimport type { Faq } from '../../types/faq'\nimport { FaqAccordion, type FaqItem } from '../faq-accordion'\nimport { useSelfFetch } from '../../hooks/use-self-fetch'\nimport { buildSuggestionUrl } from '../../utils/suggestion-url'\nimport { serializeJsonLd } from '../../utils/common'\nimport { scrollElementIntoView } from '../../utils/scroll-into-view'\nimport { faqSectionSlug, faqItemAnchor, parseFaqHash, type FaqHashTarget } from '../../utils/faq-anchor'\nimport { cn } from '../../utils/cn'\nimport { buildFaqJsonLdFromFaqs, type FaqSchemaOptions } from './json-ld'\nimport { SECTION_HEADING_CLASS } from '../layout/page-heading'\n\nexport interface FaqSectionProps {\n  /**\n   * SSR hydrate. When provided, the hook skips the first client fetch (per\n   * useSelfFetch contract). The consuming server page resolves FAQs then drills\n   * them into this prop — the lib never re-fetches what the host already gated on.\n   */\n  initialFaqs?: Faq[]\n  /** Both required together for entity-attached FAQs; partial → bare /api/faqs. */\n  entityType?: string\n  entityId?: number | string\n  /**\n   * Heading node above the grouped list. `undefined` → default\n   * `<h2>`\"Frequently Asked Questions\". `null` → no heading (the host page\n   * owns the `<h1>`, as the standalone /faqs surface does). A React node lets a\n   * platform drill its own <PageHeading> without the lib referencing platform\n   * state. Also drives category nesting so the document outline stays correct:\n   * `null` → categories render `<h2>` (directly under the page `<h1>`);\n   * otherwise categories render `<h3>` beneath this heading.\n   */\n  heading?: React.ReactNode | null\n  /** Inject FAQPage schema.org JSON-LD as a <script>. Off by default so embeds\n   *  don't emit duplicate schema. */\n  emitJsonLd?: boolean\n  /** Overrides for the JSON-LD's name/description/url. */\n  jsonLd?: FaqSchemaOptions\n  className?: string\n  /** Maps to /api/faqs `?count=` (the 5-tier fill target). Absent → param\n   *  not sent (server default applies). */\n  minResults?: number\n  /** Fetch-URL prefix for third-party embeds / reverse proxies\n   *  ('' = same-origin relative). */\n  apiBaseUrl?: string\n}\n\nconst DEFAULT_HEADING_TEXT = 'Frequently Asked Questions'\n\n/** URL composition shared with RelatedContentSection (`buildSuggestionUrl`)\n *  — byte-identical to the historical `buildFaqsUrl` output when\n *  `minResults`/`apiBaseUrl` are absent. */\nfunction buildFaqsUrl(\n  entityType?: string,\n  entityId?: number | string,\n  minResults?: number,\n  apiBaseUrl = '',\n): string {\n  return buildSuggestionUrl('/api/faqs', { apiBaseUrl, entityType, entityId, count: minResults })\n}\n\ninterface FaqGroup {\n  /** null → the uncategorized bucket: no heading, no jump pill, rendered last. */\n  section: string | null\n  slug: string | null\n  items: FaqItem[]\n}\n\n/** Group FAQs by `faq.section`, preserving the server's first-seen\n *  (display_order) order for BOTH the section order and the rows within each\n *  section. The uncategorized bucket (blank/missing section) sinks to the end\n *  since it renders without a heading. Items carry NO badge here — the `<h2>`\n *  IS the category, so a per-row chip would be redundant. */\nfunction groupFaqsBySection(faqs: Faq[]): FaqGroup[] {\n  const order: string[] = []\n  const byName = new Map<string, FaqGroup>()\n  let uncategorized: FaqGroup | null = null\n  for (const faq of faqs) {\n    const item: FaqItem = { id: faq.id, question: faq.question, answer: faq.answer }\n    const name = faq.section?.trim()\n    if (!name) {\n      if (!uncategorized) uncategorized = { section: null, slug: null, items: [] }\n      uncategorized.items.push(item)\n      continue\n    }\n    let group = byName.get(name)\n    if (!group) {\n      group = { section: name, slug: faqSectionSlug(name), items: [] }\n      byName.set(name, group)\n      order.push(name)\n    }\n    group.items.push(item)\n  }\n  const groups = order.map((name) => byName.get(name)!)\n  if (uncategorized) groups.push(uncategorized)\n  return groups\n}\n\n/** The standard hub sticky-header height — same offset `useNavLink`'s hash\n *  scroll uses, so a category jump lands below the header, not under it. */\nconst FAQ_NAV_HEADER_OFFSET = 96\n\n/** Map key for the uncategorized bucket — `group.slug` is null for it, so\n *  every per-group map (default-open ids, accordion keys) uses this sentinel\n *  to keep the lookup typed. */\nconst UNCATEGORIZED_KEY = '__uncategorized__'\nconst groupKey = (g: FaqGroup): string => g.slug ?? UNCATEGORIZED_KEY\n\n/**\n * Grouped FAQ layout: a category jump-nav above stacked `<h2>` category\n * sections (each its own accordion). Isolated into its own component so the\n * scroll-spy hooks only mount in grouped mode — `FaqSection`'s own hooks stay\n * unconditional.\n *\n * The pills are real `<a href=\"#slug\">` anchors (crawlable in-page links,\n * deep-linkable, work without JS); the click handler upgrades the jump to the\n * cancellation-proof `scrollElementIntoView` tween and syncs the URL hash.\n */\nfunction GroupedFaqList({\n  groups,\n  categoryHeadingAs,\n}: {\n  groups: FaqGroup[]\n  /** Heading tag for each category, so the document outline nests correctly\n   *  under whatever owns the heading above this block: `h2` on the standalone\n   *  page (the page owns the `<h1>`), `h3` beneath an embed's `<h2>` title.\n   *  The VISUAL is `SECTION_HEADING_CLASS` either way, so categories look\n   *  identical on every surface. */\n  categoryHeadingAs: 'h2' | 'h3'\n}) {\n  const CategoryHeading = categoryHeadingAs\n  const navGroups = useMemo(() => groups.filter((g) => g.slug), [groups])\n  const [activeSlug, setActiveSlug] = useState<string | null>(navGroups[0]?.slug ?? null)\n  // Identity-stable key for the section set so the observer re-binds only when\n  // the categories actually change (not on every parent re-render).\n  const slugKey = navGroups.map((g) => g.slug).join('|')\n\n  // Scroll-spy: mark the pill for the category currently at the top of the\n  // viewport. rootMargin drops the trigger line just below the sticky header\n  // and ignores the bottom ~55% so \"active\" is the section being read, not the\n  // next one peeking in.\n  useEffect(() => {\n    if (navGroups.length < 2) return\n    const tops = new Map<string, number>()\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          const id = (entry.target as HTMLElement).id\n          if (entry.isIntersecting) tops.set(id, entry.boundingClientRect.top)\n          else tops.delete(id)\n        }\n        let bestId: string | null = null\n        let bestTop = Number.POSITIVE_INFINITY\n        for (const [id, top] of tops) {\n          if (top < bestTop) {\n            bestTop = top\n            bestId = id\n          }\n        }\n        if (bestId) setActiveSlug(bestId)\n      },\n      { rootMargin: `-${FAQ_NAV_HEADER_OFFSET}px 0px -55% 0px`, threshold: 0 },\n    )\n    for (const group of navGroups) {\n      const el = group.slug ? document.getElementById(group.slug) : null\n      if (el) observer.observe(el)\n    }\n    return () => observer.disconnect()\n    // slugKey encodes the section set; re-observe only when it changes.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [slugKey])\n\n  // ─── Hash dispatch — `/faqs#faq-item-<id>` or `/faqs#faq-<section-slug>` ──\n  // Tracks the current hash so:\n  //   1. an item-kind hash seeds `defaultOpenIds` on the matching accordion\n  //      (auto-expands the cited question);\n  //   2. either kind triggers the cancellation-proof tween scroll with the\n  //      sticky-header offset (native browser hash scroll runs once, ignores\n  //      our offset — re-running the tween puts the target in the right spot).\n  // Listens to `hashchange` so back/forward replays the same behavior. SSR-\n  // safe: initial null state matches the server render; the first effect\n  // tick on the client updates it.\n  const [hashTarget, setHashTarget] = useState<FaqHashTarget | null>(null)\n  useEffect(() => {\n    const refresh = () => setHashTarget(parseFaqHash(window.location.hash))\n    refresh()\n    window.addEventListener('hashchange', refresh)\n    return () => window.removeEventListener('hashchange', refresh)\n  }, [])\n\n  // Per-group default-open set when the hash points at an item. The map key\n  // matches `groupKey(group)` so the render-time lookup is O(1) per group.\n  const defaultOpenByGroupKey = useMemo(() => {\n    if (hashTarget?.kind !== 'item') return null\n    const targetId = hashTarget.rawId\n    const result = new Map<string, (string | number)[]>()\n    for (const group of groups) {\n      const hit = group.items.find((i) => String(i.id) === targetId)\n      if (hit) result.set(groupKey(group), [hit.id])\n    }\n    return result.size > 0 ? result : null\n  }, [groups, hashTarget])\n\n  // Accordion is uncontrolled — `defaultOpenIds` is only consumed at mount,\n  // so a new item hash needs a remount to honor it. Keying off the item-id\n  // suffix triggers exactly the remount we need (and stays stable when the\n  // hash points at a section, so category navigation never disturbs the\n  // accordion's open state).\n  const accordionKeySuffix =\n    hashTarget?.kind === 'item' ? `item:${hashTarget.rawId}` : 'default'\n\n  useEffect(() => {\n    if (!hashTarget) return\n    const elId =\n      hashTarget.kind === 'item' ? faqItemAnchor(hashTarget.rawId) : hashTarget.slug\n    const el = document.getElementById(elId)\n    if (el) scrollElementIntoView(el, { headerOffset: FAQ_NAV_HEADER_OFFSET })\n    if (hashTarget.kind === 'section') setActiveSlug(hashTarget.slug)\n  }, [hashTarget])\n\n  const handleJump = useCallback(\n    (e: React.MouseEvent<HTMLAnchorElement>, slug: string) => {\n      e.preventDefault()\n      setActiveSlug(slug)\n      scrollElementIntoView(document.getElementById(slug), {\n        headerOffset: FAQ_NAV_HEADER_OFFSET,\n      })\n      if (typeof history !== 'undefined') history.replaceState(null, '', `#${slug}`)\n    },\n    [],\n  )\n\n  return (\n    <div className=\"space-y-8\">\n      {navGroups.length > 1 && (\n        <nav aria-label=\"FAQ categories\" className=\"flex flex-wrap gap-2\">\n          {navGroups.map((group) => {\n            const isActive = group.slug === activeSlug\n            return (\n              <a\n                key={group.slug}\n                href={`#${group.slug}`}\n                aria-current={isActive ? 'true' : undefined}\n                onClick={(e) => handleJump(e, group.slug as string)}\n                className={cn(\n                  \"rounded-full border px-4 py-2 text-sm font-medium font-['DM_Sans'] transition-colors\",\n                  isActive\n                    ? 'border-ods-text-primary bg-ods-card text-ods-text-primary'\n                    : 'border-ods-border bg-ods-card text-ods-text-secondary hover:border-ods-text-secondary hover:text-ods-text-primary',\n                )}\n              >\n                {group.section}\n              </a>\n            )\n          })}\n        </nav>\n      )}\n      <div className=\"space-y-10\">\n        {groups.map((group) => {\n          const key = groupKey(group)\n          return (\n            <section\n              key={key}\n              id={group.slug ?? undefined}\n              className=\"scroll-mt-24 space-y-4\"\n            >\n              {group.section && (\n                <CategoryHeading className={SECTION_HEADING_CLASS}>{group.section}</CategoryHeading>\n              )}\n              <FaqAccordion\n                // Re-key on item-hash changes so the remount picks up the new\n                // `defaultOpenIds` (the accordion is uncontrolled). Stable for\n                // section hashes — category navigation doesn't disturb state.\n                key={`${key}:${accordionKeySuffix}`}\n                items={group.items}\n                defaultOpenIds={defaultOpenByGroupKey?.get(key)}\n              />\n            </section>\n          )\n        })}\n      </div>\n    </div>\n  )\n}\n\nfunction FaqSkeleton() {\n  return (\n    <div className=\"space-y-8 animate-pulse\">\n      <div className=\"h-12 md:h-14 w-2/3 rounded bg-ods-border\" />\n      <div className=\"rounded-3xl border border-ods-border overflow-hidden bg-ods-card divide-y divide-ods-border w-full\">\n        {Array.from({ length: 8 }).map((_, idx) => (\n          <div key={idx} className=\"flex items-center justify-between px-6 md:px-8 py-6\">\n            <div className=\"h-6 w-5/6 rounded bg-ods-border\" />\n            <div className=\"h-10 w-10 rounded-md bg-ods-border\" />\n          </div>\n        ))}\n      </div>\n    </div>\n  )\n}\n\ninterface FaqsResponse {\n  faqs: Faq[]\n}\n\n/**\n * The FAQ display surface — ONE rendering on every host: the list grouped by\n * `faq.section` (each category a heading + its own accordion, with a category\n * jump-nav once there are 2+ categories). There is no flat/ungrouped mode and\n * no page-vs-embedded shell fork; the standalone /faqs page and every embed\n * render through this single path, so they cannot drift.\n *\n * - Standalone /faqs page: pass `initialFaqs` (SSR) + `heading={null}` (the\n *   page owns the <h1>) + `emitJsonLd` with `jsonLd` overrides for SEO.\n * - Per-entity embed: pass `entityType` + `entityId` (no `initialFaqs`); the\n *   hook self-fetches `GET /api/faqs`, and `heading` is this block's own <h2>.\n *\n * CONTRACT: the consuming app MUST implement `GET /api/faqs`. On a fetch error\n * (or zero FAQs) the component renders nothing so the host page isn't\n * disfigured. The host always supplies the page shell — this renders a bare\n * <section>.\n */\nexport function FaqSection({\n  initialFaqs,\n  entityType,\n  entityId,\n  heading,\n  emitJsonLd = false,\n  jsonLd,\n  className,\n  minResults,\n  apiBaseUrl = '',\n}: FaqSectionProps) {\n  const url = buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl)\n  // Memoized — useSelfFetch re-syncs on [initialData]; a fresh per-render\n  // wrapper object would setState-loop under re-rendering parents.\n  const initialData = useMemo<FaqsResponse | undefined>(\n    () => (initialFaqs ? { faqs: initialFaqs } : undefined),\n    [initialFaqs],\n  )\n  const { data, isLoading, error } = useSelfFetch<FaqsResponse>(url, { initialData })\n\n  const faqs = data?.faqs ?? []\n  // Grouped before the early returns so the hook order stays stable.\n  const groups = useMemo(() => (faqs.length > 0 ? groupFaqsBySection(faqs) : []), [faqs])\n\n  // `undefined` → default <h2> title; `null` → the host page owns the <h1>, so\n  // no title renders here. `heading === null` also makes the category headings\n  // <h2> (directly under the page <h1>); otherwise they nest as <h3>.\n  const headingNode =\n    heading === undefined ? <h2 className={SECTION_HEADING_CLASS}>{DEFAULT_HEADING_TEXT}</h2> : heading\n\n  // Degrade silently — never show an error banner or an empty section shell\n  // where FAQs would be (host pages and the standalone surface both rely on it).\n  if (error) return null\n  if (!isLoading && faqs.length === 0) return null\n  if (isLoading && faqs.length === 0) {\n    return (\n      <div className={className}>\n        <FaqSkeleton />\n      </div>\n    )\n  }\n\n  const schema = emitJsonLd ? buildFaqJsonLdFromFaqs(faqs, jsonLd) : null\n\n  return (\n    <>\n      <section className={className ?? 'space-y-10'}>\n        {headingNode}\n        <GroupedFaqList groups={groups} categoryHeadingAs={heading === null ? 'h2' : 'h3'} />\n      </section>\n      {schema && (\n        <script\n          type=\"application/ld+json\"\n          // eslint-disable-next-line react/no-danger\n          // serializeJsonLd, NOT raw JSON.stringify — FAQ answers are\n          // admin-entered; an embedded \"</script>\" must not break the tag.\n          dangerouslySetInnerHTML={{ __html: serializeJsonLd(schema) }}\n        />\n      )}\n    </>\n  )\n}\n","\"use client\"\n\nimport React, { useRef, useState, useEffect, useCallback } from 'react'\nimport { ChevronButton } from './ui/chevron-button'\nimport { cn } from \"../utils/cn\"\nimport { faqItemAnchor } from \"../utils/faq-anchor\"\n\nexport interface FaqItem {\n  id: number | string\n  question: string\n  answer: string\n}\n\ninterface FaqAccordionProps {\n  items: FaqItem[]\n  defaultOpenIds?: (number | string)[]\n}\n\n// Utility to measure scrollHeight outside render cycle\nconst useMeasuredHeight = (isOpen: boolean) => {\n  const ref = useRef<HTMLDivElement | null>(null)\n  const [maxHeight, setMaxHeight] = useState<string>('0px')\n\n  const measure = useCallback(() => {\n    if (ref.current) {\n      const height = ref.current.scrollHeight\n      setMaxHeight(`${height}px`)\n    }\n  }, [])\n\n  // Update height only when section is open\n  useEffect(() => {\n    if (isOpen) {\n      measure()\n    } else {\n      setMaxHeight('0px')\n    }\n  }, [isOpen, measure])\n\n  return { ref, maxHeight }\n}\n\nexport function FaqAccordion({ items, defaultOpenIds = [] }: FaqAccordionProps) {\n  const [openSet, setOpenSet] = useState<Set<string | number>>(new Set(defaultOpenIds))\n\n  const toggle = (id: string | number) => {\n    setOpenSet(prev => {\n      const next = new Set(prev)\n      if (next.has(id)) next.delete(id)\n      else next.add(id)\n      return next\n    })\n  }\n\n  return (\n    <div className=\"rounded-3xl border border-ods-border divide-y divide-ods-border bg-ods-card overflow-hidden\">\n      {items.map(item => {\n        const isOpen = openSet.has(item.id)\n        const { ref, maxHeight } = useMeasuredHeight(isOpen)\n\n        return (\n          <div\n            key={item.id}\n            // Per-row anchor — chat citation chips (`/faqs#faq-item-<id>`) land\n            // here via native browser hash scroll AND via `FaqSection`'s tween\n            // dispatch. `scroll-mt-24` keeps the row header below the 96px\n            // sticky nav offset (matches `<section>`'s scroll-margin for\n            // category anchors).\n            id={faqItemAnchor(item.id)}\n            className={cn('group scroll-mt-24 transition-colors hover:bg-[#1E1E1E]', isOpen ? 'bg-ods-bg' : 'bg-transparent')}\n          >\n            {/* Header */}\n            <div\n              role=\"button\"\n              tabIndex={0}\n              onClick={() => toggle(item.id)}\n              onKeyDown={(e) => {\n                if (e.key === 'Enter' || e.key === ' ') {\n                  e.preventDefault();\n                  toggle(item.id);\n                }\n              }}\n              aria-expanded={isOpen}\n              className=\"flex w-full items-center justify-between px-6 md:px-8 py-6 text-left focus:outline-none transition-colors cursor-pointer\"\n            >\n              <div className=\"min-w-0 pr-4\">\n                <h3>\n                  {item.question}\n                </h3>\n              </div>\n              <div className=\"flex-shrink-0\">\n                <ChevronButton\n                  aria-label={isOpen ? 'Collapse question' : 'Expand question'}\n                  size=\"md\"\n                  isExpanded={isOpen}\n                  backgroundColor=\"transparent\"\n                  borderColor=\"#3A3A3A\"\n                />\n              </div>\n            </div>\n            {/* Content wrapper with max-height animation */}\n            <div\n              style={{ maxHeight, transition: 'max-height 0.35s ease-in-out, opacity 0.35s ease-in-out', opacity: isOpen ? 1 : 0 }}\n              className=\"overflow-hidden group-hover:bg-[#1E1E1E]/30\"\n            >\n              <div ref={ref} className=\"px-6 md:px-8 pb-6 text-ods-text-primary text-h4\">\n                {item.answer}\n              </div>\n            </div>\n          </div>\n        )\n      })}\n    </div>\n  )\n} ","/**\n * Pure FAQ JSON-LD builder. No React, no client-only deps — safe to import from\n * Server Components via the `./components/faq` subpath export. (Do NOT import\n * through the root `./components` barrel — that barrel is `\"use client\"` and\n * dragging it into a Server Component would force the client graph into the\n * server.)\n *\n * The hub used to harcode `name`/`description` here for OpenMSP; in the lib we\n * accept overrides so every embedder can supply its own platform branding.\n */\nimport type { Faq } from '../../types/faq'\n\nexport interface FaqSchemaOptions {\n  name?: string\n  description?: string\n  url?: string\n}\n\nconst DEFAULT_NAME = 'Frequently Asked Questions'\nconst DEFAULT_DESCRIPTION =\n  'Answers to common questions.'\n\nexport function baseFaqSchema(opts: FaqSchemaOptions = {}) {\n  return {\n    '@context': 'https://schema.org',\n    '@type': 'FAQPage',\n    name: opts.name ?? DEFAULT_NAME,\n    description: opts.description ?? DEFAULT_DESCRIPTION,\n    ...(opts.url ? { url: opts.url } : {}),\n  } as const\n}\n\nexport function buildFaqJsonLdFromFaqs(faqs: Faq[], opts: FaqSchemaOptions = {}) {\n  return {\n    ...baseFaqSchema(opts),\n    mainEntity: faqs.map((faq) => ({\n      '@type': 'Question',\n      name: faq.question,\n      acceptedAnswer: {\n        '@type': 'Answer',\n        text: faq.answer,\n      },\n    })),\n  } as const\n}\n","'use client';\n\n/**\n * FaqDocumentPage — the full `/faqs` page with chrome, so embedders drop in\n * ONE component instead of hand-assembling `PageShell` + `PageLayout` around the\n * bare `<FaqSection>`. Mirrors `LegalDocumentPage` / `DevSectionPage`: the\n * page-level layout lives in the lib, the host passes only config + a back button.\n *\n * `<FaqSection heading={null}>` lets `PageLayout`'s `TitleBlock` own the heading +\n * back button; it self-fetches `${apiBaseUrl}/api/faqs` via the authed\n * `useSelfFetch`, and renders nothing on a fetch error or zero FAQs.\n */\n\nimport { PageShell, PageLayout } from '../ui';\nimport { useRouter } from '../../embed-shims/next-navigation';\nimport { FaqSection } from './faq-section';\n\nexport interface FaqDocumentPageProps {\n  /** Page title (PageLayout TitleBlock). Default \"FAQs\". */\n  title?: string;\n  /** Subtitle under the title. */\n  subtitle?: string;\n  /** Back-button config — same pattern as `DevSectionPage` / `LegalDocumentPage`.\n   *  Pass `false` to hide. Default `{ label: 'Back to home', href: '/' }`. */\n  backButton?: { label?: string; href?: string } | false;\n  /** Base URL `FaqSection` appends `/api/faqs` to (reverse-proxy embedders). */\n  apiBaseUrl?: string;\n  /** Optional entity scoping forwarded to `FaqSection`. */\n  entityType?: string;\n  entityId?: number | string;\n  /** Minimum FAQ count before the section renders (forwarded to `FaqSection`). */\n  minResults?: number;\n}\n\nexport function FaqDocumentPage({\n  title = 'FAQs',\n  subtitle,\n  backButton,\n  apiBaseUrl,\n  entityType,\n  entityId,\n  minResults,\n}: FaqDocumentPageProps) {\n  const router = useRouter();\n\n  // Back-button config — mirrors LegalDocumentPage/DevSectionPage. Hide entirely\n  // when the caller passes `false` (embed-mode where the host owns nav chrome).\n  const backCfg =\n    backButton === false\n      ? undefined\n      : {\n          label: backButton?.label ?? 'Back to home',\n          onClick: () => router.push(backButton?.href ?? '/'),\n        };\n\n  return (\n    <PageShell>\n      <PageLayout title={title} subtitle={subtitle} backButton={backCfg}>\n        <FaqSection\n          heading={null}\n          apiBaseUrl={apiBaseUrl}\n          entityType={entityType}\n          entityId={entityId}\n          minResults={minResults}\n        />\n      </PageLayout>\n    </PageShell>\n  );\n}\n"]}

package/dist/{chunk-23UOJUDF.js → chunk-RWCA2ZQK.js}

@@ -11,17 +11,17 @@ import {
   SelectValue,
   Textarea,
   useChatAttachments
-} from "./chunk-VQW7CEGS.js";
+} from "./chunk-EFYXPR43.js";
 import {
   useContactSubmission,
   useHumanitySignals
-} from "./chunk-USPATRSC.js";
+} from "./chunk-N6ZM5PYZ.js";
 import {
   Input
 } from "./chunk-M2OCXTNT.js";
 import {
   SECTION_HEADING_CLASS
-} from "./chunk-Z3V2SGQZ.js";
+} from "./chunk-VRSXJ5QJ.js";
 import {
   Button
 } from "./chunk-5IJ46KAV.js";
@@ -376,4 +376,4 @@ function ContactForm({
 export {
   ContactForm
 };
-//# sourceMappingURL=chunk-23UOJUDF.js.map
+//# sourceMappingURL=chunk-RWCA2ZQK.js.map

package/dist/chunk-TFSYSWPS.cjs

@@ -0,0 +1,89 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
+
+
+
+var _chunkYETA25JWcjs = require('./chunk-YETA25JW.cjs');
+
+// src/hooks/use-near-viewport.ts
+var _react = require('react');
+var observers = /* @__PURE__ */ new Map();
+var subscribers = /* @__PURE__ */ new WeakMap();
+function getObserverFor(rootMargin) {
+  const existing = observers.get(rootMargin);
+  if (existing) return existing;
+  const io = new IntersectionObserver(
+    (entries) => {
+      entries.forEach((entry) => {
+        if (!entry.isIntersecting) return;
+        const cb = subscribers.get(entry.target);
+        if (cb) {
+          cb();
+          io.unobserve(entry.target);
+          subscribers.delete(entry.target);
+        }
+      });
+    },
+    { rootMargin }
+  );
+  observers.set(rootMargin, io);
+  return io;
+}
+function useNearViewport(rootMargin = "500px") {
+  const [isNear, setIsNear] = _react.useState.call(void 0, false);
+  const elRef = _react.useRef.call(void 0, null);
+  const ref = _react.useCallback.call(void 0, 
+    (node) => {
+      const prev = elRef.current;
+      if (prev) {
+        const stillOurs = subscribers.get(prev);
+        if (stillOurs) {
+          subscribers.delete(prev);
+          _optionalChain([observers, 'access', _ => _.get, 'call', _2 => _2(rootMargin), 'optionalAccess', _3 => _3.unobserve, 'call', _4 => _4(prev)]);
+        }
+      }
+      elRef.current = node;
+      if (!node) return;
+      const cb = () => setIsNear(true);
+      subscribers.set(node, cb);
+      getObserverFor(rootMargin).observe(node);
+    },
+    [rootMargin]
+  );
+  _react.useEffect.call(void 0, () => {
+    return () => {
+      const el = elRef.current;
+      if (!el) return;
+      if (subscribers.get(el)) {
+        subscribers.delete(el);
+        _optionalChain([observers, 'access', _5 => _5.get, 'call', _6 => _6(rootMargin), 'optionalAccess', _7 => _7.unobserve, 'call', _8 => _8(el)]);
+      }
+    };
+  }, [rootMargin]);
+  return { ref, isNear };
+}
+
+// src/hooks/use-og-placeholder.ts
+
+function useOgPlaceholder(buildUrl, title, siteName = "", enabled = true, aspect = "wide") {
+  return _react.useMemo.call(void 0, () => {
+    if (!enabled || !title) return null;
+    const options = {};
+    if (siteName) options.site = siteName;
+    if (aspect === "square") options.aspect = "square";
+    return buildUrl(title, options);
+  }, [buildUrl, title, siteName, enabled, aspect]);
+}
+
+// src/utils/embed-content-fetch.ts
+var contentFetch = (input, init) => {
+  if (!_chunkYETA25JWcjs.hasEmbedAuthAdapter.call(void 0, )) return fetch(input, init);
+  const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+  return _chunkYETA25JWcjs.embedAuthedFetch.call(void 0, url, init);
+};
+
+
+
+
+
+exports.contentFetch = contentFetch; exports.useNearViewport = useNearViewport; exports.useOgPlaceholder = useOgPlaceholder;
+//# sourceMappingURL=chunk-TFSYSWPS.cjs.map

package/dist/chunk-TFSYSWPS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-TFSYSWPS.cjs","../src/hooks/use-near-viewport.ts","../src/hooks/use-og-placeholder.ts","../src/utils/embed-content-fetch.ts"],"names":[],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-TFSYSWPS.cjs","sourcesContent":[null,"/**\n * useNearViewport — module-level shared IntersectionObserver in hook form.\n *\n * Single IO instance per `rootMargin` value, shared across every component\n * that mounts the hook. Reduces overhead vs. one IO per component on\n * grid/list pages where many subscribers observe the viewport with the same\n * margin. Promoted from the inline singleton at\n * `multi-platform-hub/components/shared/video-bites-display.tsx:21-43`,\n * which is the only IO pattern in either repo today.\n *\n * Usage:\n * ```tsx\n * function MyCard() {\n *   const { ref, isNear } = useNearViewport('500px');\n *   return <div ref={ref}>{isNear ? <HeavyChild /> : <Placeholder />}</div>;\n * }\n * ```\n *\n * StrictMode safety: cleanup uses an identity check on the registered\n * callback so React's dev double-mount (mount → cleanup → re-mount) does\n * not drop the second mount's freshly-set subscription. The IO callback\n * also checks `subscribers.get(target)` before invoking so a fire that\n * races with unmount cannot crash on a torn-down component.\n *\n * The hook fires once — on first intersection it sets `isNear=true` and\n * unobserves the element. Callers that need re-observation should\n * unmount and remount (or fork the hook for two-way behavior).\n */\n\nimport { useEffect, useRef, useState, useCallback } from 'react';\n\n// Per-rootMargin IO map. Multiple call sites with different margins each\n// get their own singleton observer.\nconst observers = new Map<string, IntersectionObserver>();\nconst subscribers = new WeakMap<Element, () => void>();\n\nfunction getObserverFor(rootMargin: string): IntersectionObserver {\n  const existing = observers.get(rootMargin);\n  if (existing) return existing;\n\n  const io = new IntersectionObserver(\n    (entries) => {\n      entries.forEach((entry) => {\n        if (!entry.isIntersecting) return;\n        // Race-safe: re-read the callback at fire time. A late IO firing\n        // after cleanup must not invoke a stale callback.\n        const cb = subscribers.get(entry.target);\n        if (cb) {\n          cb();\n          io.unobserve(entry.target);\n          subscribers.delete(entry.target);\n        }\n      });\n    },\n    { rootMargin }\n  );\n  observers.set(rootMargin, io);\n  return io;\n}\n\nexport interface UseNearViewportResult<T extends Element = HTMLElement> {\n  /** Ref to attach to the element you want to gate on visibility. */\n  ref: (node: T | null) => void;\n  /** Flips to `true` once the element enters within `rootMargin` of the viewport. Never flips back. */\n  isNear: boolean;\n}\n\n/**\n * @param rootMargin Margin around the viewport (CSS-style string).\n *                   '500px' = element starts mounting 500px before scroll-in.\n *                   '1000px' = a full viewport's worth of lookahead.\n *                   '0px' = strict on-screen detection.\n */\nexport function useNearViewport<T extends Element = HTMLElement>(\n  rootMargin: string = '500px'\n): UseNearViewportResult<T> {\n  const [isNear, setIsNear] = useState(false);\n  const elRef = useRef<T | null>(null);\n\n  // Subscribe/unsubscribe on element change.\n  const ref = useCallback(\n    (node: T | null) => {\n      const prev = elRef.current;\n\n      // Unsubscribe previous, if any. Identity-check the callback so a\n      // StrictMode re-mount that has already re-registered keeps its sub.\n      if (prev) {\n        const stillOurs = subscribers.get(prev);\n        if (stillOurs) {\n          subscribers.delete(prev);\n          observers.get(rootMargin)?.unobserve(prev);\n        }\n      }\n\n      elRef.current = node;\n      if (!node) return;\n\n      const cb = () => setIsNear(true);\n      subscribers.set(node, cb);\n      getObserverFor(rootMargin).observe(node);\n    },\n    [rootMargin]\n  );\n\n  // Unsubscribe on unmount. Identity check guards the StrictMode race.\n  useEffect(() => {\n    return () => {\n      const el = elRef.current;\n      if (!el) return;\n      if (subscribers.get(el)) {\n        subscribers.delete(el);\n        observers.get(rootMargin)?.unobserve(el);\n      }\n    };\n  }, [rootMargin]);\n\n  return { ref, isNear };\n}\n","'use client'\n\nimport { useMemo } from 'react'\n\n/**\n * Hook that generates a branded placeholder image URL using the\n * host's `/api/og-placeholder` server-side image generator (or any\n * builder the caller supplies).\n *\n * THIS HOOK IS A THIN CLIENT-SIDE WRAPPER. The hub-side wrapper\n * (`hooks/use-og-placeholder.ts` in multi-platform-hub) injects its\n * canonical `buildOgPlaceholderUrl` from `lib/utils/entity-image.ts`.\n * The lib version takes the builder as an argument so the lib has no\n * hub dependency.\n *\n * @param buildUrl - Function that builds the placeholder URL from a\n *                   title + options object (`{ site?, aspect? }`).\n *                   Hub passes `buildOgPlaceholderUrl` from\n *                   `lib/utils/entity-image.ts`. Embedded apps can\n *                   wire any equivalent that hits their own placeholder\n *                   route.\n * @param title    - Text to display on the placeholder\n * @param siteName - Site name shown below the title (optional —\n *                   defaults to empty)\n * @param enabled  - Whether to generate the URL (default: true)\n * @param aspect   - `'wide'` (1200×630 social-card; default) or `'square'`\n *                   (1024×1024 — used by compact chat-inline card slots\n *                   so `object-cover` doesn't crop the title off).\n * @returns Placeholder image URL or null if disabled / no title\n */\nexport function useOgPlaceholder(\n  buildUrl: (title: string, options: { site?: string; aspect?: 'wide' | 'square' }) => string,\n  title: string | undefined | null,\n  siteName: string = '',\n  enabled: boolean = true,\n  aspect: 'wide' | 'square' = 'wide',\n): string | null {\n  return useMemo(() => {\n    if (!enabled || !title) return null\n    const options: { site?: string; aspect?: 'wide' | 'square' } = {}\n    if (siteName) options.site = siteName\n    if (aspect === 'square') options.aspect = 'square'\n    return buildUrl(title, options)\n  }, [buildUrl, title, siteName, enabled, aspect])\n}\n","'use client'\n\n/**\n * `contentFetch` — the fetch the lib's SELF-FETCHING content surfaces use:\n * roadmap (list + vote + per-task refresh), delivery, product releases,\n * onboarding guides (catalog + detail), legal docs, and the release-detail\n * injected roadmap/delivery sections.\n *\n * It deliberately reuses the SINGLE embed-auth knob — the registered\n * `EmbedAuthAdapter` — instead of introducing a second registration:\n *   - adapter registered (host opted into embedded auth, e.g. openframe-frontend\n *     for its embedded chat) → route through `embedAuthedFetch`, so content GETs/\n *     POSTs carry the SAME bearer/cookie + 401-refresh as the chat.\n *   - no adapter (the public hub, or the embedding example whose proxy injects\n *     auth server-side) → a plain, byte-for-byte unchanged `fetch`.\n *\n * So a host wires auth ONCE (the chat adapter) and content inherits it; there is\n * no content-specific fetcher to configure.\n */\n\nimport { embedAuthedFetch, hasEmbedAuthAdapter } from './embed-authed-fetch'\n\nexport const contentFetch: typeof fetch = (input, init) => {\n  if (!hasEmbedAuthAdapter()) return fetch(input, init)\n  // embedAuthedFetch takes a string url; coerce the broader `fetch` input shape\n  // (content surfaces always pass strings, but handle URL/Request defensively).\n  const url =\n    typeof input === 'string' ? input : input instanceof URL ? input.href : (input as Request).url\n  return embedAuthedFetch(url, init)\n}\n"]}

package/dist/{chunk-KNCDUWY2.js → chunk-TY2EB7VK.js}

@@ -1,18 +1,25 @@
 "use client";
 import {
   useSelfFetch
-} from "./chunk-IMNGGLKL.js";
+} from "./chunk-3ZXUQQL4.js";
+import {
+  ChevronButton
+} from "./chunk-EFYXPR43.js";
 import {
-  ChevronButton,
   buildSuggestionUrl,
+  faqItemAnchor,
+  faqSectionSlug,
+  parseFaqHash,
   scrollElementIntoView,
   serializeJsonLd
-} from "./chunk-VQW7CEGS.js";
+} from "./chunk-ODR6A6FC.js";
 import {
   PageLayout,
-  PageShell,
+  PageShell
+} from "./chunk-R2KT5GDD.js";
+import {
   SECTION_HEADING_CLASS
-} from "./chunk-Z3V2SGQZ.js";
+} from "./chunk-VRSXJ5QJ.js";
 import {
   init_next_navigation,
   useRouter
@@ -63,7 +70,8 @@ function FaqAccordion({ items, defaultOpenIds = [] }) {
     return /* @__PURE__ */ jsxs(
       "div",
       {
-        className: cn("group transition-colors hover:bg-[#1E1E1E]", isOpen ? "bg-ods-bg" : "bg-transparent"),
+        id: faqItemAnchor(item.id),
+        className: cn("group scroll-mt-24 transition-colors hover:bg-[#1E1E1E]", isOpen ? "bg-ods-bg" : "bg-transparent"),
         children: [
           /* @__PURE__ */ jsxs(
             "div",
@@ -144,9 +152,6 @@ var DEFAULT_HEADING_TEXT = "Frequently Asked Questions";
 function buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl = "") {
   return buildSuggestionUrl("/api/faqs", { apiBaseUrl, entityType, entityId, count: minResults });
 }
-function sectionSlug(section) {
-  return "faq-" + section.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-}
 function groupFaqsBySection(faqs) {
   const order = [];
   const byName = /* @__PURE__ */ new Map();
@@ -161,7 +166,7 @@ function groupFaqsBySection(faqs) {
     }
     let group = byName.get(name);
     if (!group) {
-      group = { section: name, slug: sectionSlug(name), items: [] };
+      group = { section: name, slug: faqSectionSlug(name), items: [] };
       byName.set(name, group);
       order.push(name);
     }
@@ -172,6 +177,8 @@ function groupFaqsBySection(faqs) {
   return groups;
 }
 var FAQ_NAV_HEADER_OFFSET = 96;
+var UNCATEGORIZED_KEY = "__uncategorized__";
+var groupKey = (g) => g.slug ?? UNCATEGORIZED_KEY;
 function GroupedFaqList({
   groups,
   categoryHeadingAs
@@ -208,6 +215,31 @@ function GroupedFaqList({
     }
     return () => observer.disconnect();
   }, [slugKey]);
+  const [hashTarget, setHashTarget] = useState2(null);
+  useEffect2(() => {
+    const refresh = () => setHashTarget(parseFaqHash(window.location.hash));
+    refresh();
+    window.addEventListener("hashchange", refresh);
+    return () => window.removeEventListener("hashchange", refresh);
+  }, []);
+  const defaultOpenByGroupKey = useMemo(() => {
+    if (hashTarget?.kind !== "item") return null;
+    const targetId = hashTarget.rawId;
+    const result = /* @__PURE__ */ new Map();
+    for (const group of groups) {
+      const hit = group.items.find((i) => String(i.id) === targetId);
+      if (hit) result.set(groupKey(group), [hit.id]);
+    }
+    return result.size > 0 ? result : null;
+  }, [groups, hashTarget]);
+  const accordionKeySuffix = hashTarget?.kind === "item" ? `item:${hashTarget.rawId}` : "default";
+  useEffect2(() => {
+    if (!hashTarget) return;
+    const elId = hashTarget.kind === "item" ? faqItemAnchor(hashTarget.rawId) : hashTarget.slug;
+    const el = document.getElementById(elId);
+    if (el) scrollElementIntoView(el, { headerOffset: FAQ_NAV_HEADER_OFFSET });
+    if (hashTarget.kind === "section") setActiveSlug(hashTarget.slug);
+  }, [hashTarget]);
   const handleJump = useCallback2(
     (e, slug) => {
       e.preventDefault();
@@ -237,18 +269,28 @@ function GroupedFaqList({
         group.slug
       );
     }) }),
-    /* @__PURE__ */ jsx2("div", { className: "space-y-10", children: groups.map((group) => /* @__PURE__ */ jsxs2(
-      "section",
-      {
-        id: group.slug ?? void 0,
-        className: "scroll-mt-24 space-y-4",
-        children: [
-          group.section && /* @__PURE__ */ jsx2(CategoryHeading, { className: SECTION_HEADING_CLASS, children: group.section }),
-          /* @__PURE__ */ jsx2(FaqAccordion, { items: group.items })
-        ]
-      },
-      group.slug ?? "faq-uncategorized"
-    )) })
+    /* @__PURE__ */ jsx2("div", { className: "space-y-10", children: groups.map((group) => {
+      const key = groupKey(group);
+      return /* @__PURE__ */ jsxs2(
+        "section",
+        {
+          id: group.slug ?? void 0,
+          className: "scroll-mt-24 space-y-4",
+          children: [
+            group.section && /* @__PURE__ */ jsx2(CategoryHeading, { className: SECTION_HEADING_CLASS, children: group.section }),
+            /* @__PURE__ */ jsx2(
+              FaqAccordion,
+              {
+                items: group.items,
+                defaultOpenIds: defaultOpenByGroupKey?.get(key)
+              },
+              `${key}:${accordionKeySuffix}`
+            )
+          ]
+        },
+        key
+      );
+    }) })
   ] });
 }
 function FaqSkeleton() {
@@ -335,4 +377,4 @@ export {
   FaqSection,
   FaqDocumentPage
 };
-//# sourceMappingURL=chunk-KNCDUWY2.js.map
+//# sourceMappingURL=chunk-TY2EB7VK.js.map