@flamingo-stack/openframe-frontend-core 0.0.257 → 0.0.259

package/dist/{chunk-J3QMPOS6.js → chunk-OVXKTNEP.js}

@@ -70,7 +70,10 @@ function FaqAccordion({ items, defaultOpenIds = [] }) {
               "aria-expanded": isOpen,
               className: "flex w-full items-center justify-between px-6 md:px-8 py-6 text-left focus:outline-none transition-colors cursor-pointer",
               children: [
-                /* @__PURE__ */ jsx("h3", { children: item.question }),
+                /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-col gap-2 pr-4", children: [
+                  /* @__PURE__ */ jsx("h3", { children: item.question }),
+                  item.badge && /* @__PURE__ */ jsx("span", { className: "w-fit shrink-0 px-2 py-1 rounded text-xs font-medium font-['DM_Sans'] bg-ods-border text-ods-text-secondary", children: item.badge })
+                ] }),
                 /* @__PURE__ */ jsx("div", { className: "flex-shrink-0", children: /* @__PURE__ */ jsx(
                   ChevronButton,
                   {
@@ -161,6 +164,7 @@ function FaqSection({
   entityType,
   entityId,
   heading,
+  variant,
   emitJsonLd = false,
   jsonLd,
   className,
@@ -174,17 +178,21 @@ function FaqSection({
   );
   const { data, isLoading, error } = useSelfFetch(url, { initialData });
   const faqs = data?.faqs ?? [];
-  const showHeading = heading !== null;
-  const headingNode = heading === void 0 ? /* @__PURE__ */ jsx2("h1", { className: "text-h1 tracking-[-0.04em] text-ods-text-primary", children: DEFAULT_HEADING_TEXT }) : heading;
-  const groups = groupBySection(faqs);
-  if (error && !showHeading) {
+  const isEmbedded = variant ? variant === "embedded" : heading === null;
+  const headingNode = heading === void 0 ? isEmbedded ? (
+    // Embedded default is an <h2> — a host page already owns the <h1>,
+    // and the schema/heading pair must read "Frequently Asked Questions"
+    // (one FAQ heading per page, never tag/section names).
+    /* @__PURE__ */ jsx2("h2", { className: "text-h2 tracking-[-0.04em] text-ods-text-primary", children: DEFAULT_HEADING_TEXT })
+  ) : /* @__PURE__ */ jsx2("h1", { className: "text-h1 tracking-[-0.04em] text-ods-text-primary", children: DEFAULT_HEADING_TEXT }) : heading;
+  if (error && isEmbedded) {
     return null;
   }
-  if (!isLoading && !error && faqs.length === 0 && !showHeading) {
+  if (!isLoading && !error && faqs.length === 0 && isEmbedded) {
     return null;
   }
   if (isLoading && faqs.length === 0) {
-    if (!showHeading) {
+    if (isEmbedded) {
       return /* @__PURE__ */ jsx2("div", { className, children: /* @__PURE__ */ jsx2(FaqSkeleton, {}) });
     }
     return /* @__PURE__ */ jsx2("main", { className: className ?? "bg-ods-bg", children: /* @__PURE__ */ jsx2("div", { className: "max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto", children: /* @__PURE__ */ jsx2(FaqSkeleton, {}) }) });
@@ -193,14 +201,30 @@ function FaqSection({
     return /* @__PURE__ */ jsx2("main", { className: className ?? "bg-ods-bg flex items-center justify-center py-20", children: /* @__PURE__ */ jsx2("p", { className: "text-ods-text-primary font-medium", children: "Failed to load FAQs. Please try again later." }) });
   }
   const schema = emitJsonLd ? buildFaqJsonLdFromFaqs(faqs, jsonLd) : null;
-  const groupNodes = groups.map(({ section, items }) => /* @__PURE__ */ jsxs2("div", { className: "space-y-4", children: [
-    section && /* @__PURE__ */ jsx2("h2", { className: "text-h2 tracking-[-0.04em] text-ods-text-primary mb-3 md:mb-4", children: section }),
-    /* @__PURE__ */ jsx2(FaqAccordion, { items })
-  ] }, section || "default"));
-  const body = showHeading ? /* @__PURE__ */ jsx2("main", { className: className ?? "bg-ods-bg", children: /* @__PURE__ */ jsxs2("div", { className: "max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto space-y-10", children: [
+  const body = isEmbedded ? /* @__PURE__ */ jsxs2("section", { className: className ?? "space-y-6", children: [
     headingNode,
-    groupNodes
-  ] }) }) : /* @__PURE__ */ jsx2("section", { className: className ?? "space-y-10", children: groupNodes });
+    /* @__PURE__ */ jsx2(
+      FaqAccordion,
+      {
+        items: faqs.map((faq) => ({
+          id: faq.id,
+          question: faq.question,
+          answer: faq.answer,
+          badge: faq.section || void 0
+        }))
+      }
+    )
+  ] }) : (
+    // Page variant (standalone /faqs): historical markup — <main> shell,
+    // page gutters, FAQs grouped by section with one <h2> per section.
+    /* @__PURE__ */ jsx2("main", { className: className ?? "bg-ods-bg", children: /* @__PURE__ */ jsxs2("div", { className: "max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto space-y-10", children: [
+      headingNode,
+      groupBySection(faqs).map(({ section, items }) => /* @__PURE__ */ jsxs2("div", { className: "space-y-4", children: [
+        section && /* @__PURE__ */ jsx2("h2", { className: "text-h2 tracking-[-0.04em] text-ods-text-primary mb-3 md:mb-4", children: section }),
+        /* @__PURE__ */ jsx2(FaqAccordion, { items })
+      ] }, section || "default"))
+    ] }) })
+  );
   return /* @__PURE__ */ jsxs2(Fragment, { children: [
     body,
     schema && /* @__PURE__ */ jsx2(
@@ -217,4 +241,4 @@ export {
   FaqAccordion,
   FaqSection
 };
-//# sourceMappingURL=chunk-J3QMPOS6.js.map
+//# sourceMappingURL=chunk-OVXKTNEP.js.map

package/dist/chunk-OVXKTNEP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/faq/faq-section.tsx","../src/components/faq-accordion.tsx","../src/components/faq/json-ld.ts"],"sourcesContent":["\"use client\"\n\nimport React, { useMemo } 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 { buildFaqJsonLdFromFaqs, type FaqSchemaOptions } from './json-ld'\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. `undefined` → variant default (page: <h1>, embedded: <h2>\n   * \"Frequently Asked Questions\"); `null` → no heading. React node so\n   * platforms can drill their local <PageHeading> component without the lib\n   * referencing platform state.\n   */\n  heading?: React.ReactNode | null\n  /**\n   * Layout variant.\n   *   - 'page' — the standalone /faqs surface: <main> shell + page gutters,\n   *     FAQs GROUPED by `faq.section` with one <h2> per section.\n   *   - 'embedded' — a section inside a host page (entity detail rails, the\n   *     global nested-page block): no shell, ONE flat accordion with each\n   *     row's `faq.section` rendered as a neutral chip (never a heading) and\n   *     a single default <h2> above. Exactly one FAQ block per page — the\n   *     per-tag heading loop is page-variant-only.\n   * Back-compat default: `heading === null` → 'embedded', else 'page' (the\n   * pre-variant discriminator, kept so older embedders don't shift layout\n   * until they opt in — they DO pick up the flat chip list, which is the\n   * point of the consolidation).\n   */\n  variant?: 'page' | 'embedded'\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\nfunction groupBySection(faqs: Faq[]): Array<{ section: string | null; items: FaqItem[] }> {\n  const map = new Map<string, FaqItem[]>()\n  for (const faq of faqs) {\n    const key = faq.section || ''\n    let arr = map.get(key)\n    if (!arr) {\n      arr = []\n      map.set(key, arr)\n    }\n    arr.push({ id: faq.id, question: faq.question, answer: faq.answer })\n  }\n  return Array.from(map.entries()).map(([section, items]) => ({\n    section: section || null,\n    items,\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 * Generic, embeddable FAQ display surface.\n *\n * - Standalone /faqs page: pass `initialFaqs` from the server + `heading` +\n *   `emitJsonLd` with `jsonLd` overrides for SEO.\n * - Per-entity embed: pass `entityType` + `entityId` (no `initialFaqs`); the\n *   hook self-fetches and the public /api/faqs endpoint picks override-vs-fallback.\n *\n * CONTRACT: the consuming app MUST implement `GET /api/faqs`. Without it,\n * useSelfFetch reports `error:true` (logged once); in embedded mode (heading\n * === null) this component renders nothing so the host page isn't disfigured.\n */\nexport function FaqSection({\n  initialFaqs,\n  entityType,\n  entityId,\n  heading,\n  variant,\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  const isEmbedded = variant ? variant === 'embedded' : heading === null\n  const headingNode =\n    heading === undefined ? (\n      isEmbedded ? (\n        // Embedded default is an <h2> — a host page already owns the <h1>,\n        // and the schema/heading pair must read \"Frequently Asked Questions\"\n        // (one FAQ heading per page, never tag/section names).\n        <h2 className=\"text-h2 tracking-[-0.04em] text-ods-text-primary\">{DEFAULT_HEADING_TEXT}</h2>\n      ) : (\n        <h1 className=\"text-h1 tracking-[-0.04em] text-ods-text-primary\">{DEFAULT_HEADING_TEXT}</h1>\n      )\n    ) : (\n      heading\n    )\n\n  // Embedded mode: degrade silently on error.\n  if (error && isEmbedded) {\n    return null\n  }\n\n  // Embedded mode, zero FAQs after load: render nothing — an embedded host\n  // page (blog/case-study detail) must not show an empty section shell.\n  // The standalone /faqs page keeps its existing behavior.\n  if (!isLoading && !error && faqs.length === 0 && isEmbedded) {\n    return null\n  }\n\n  if (isLoading && faqs.length === 0) {\n    // Embedded mode renders skeletons WITHOUT the standalone page shell —\n    // a host detail page already provides <main> + gutters; nesting them\n    // here would emit invalid markup and double padding.\n    if (isEmbedded) {\n      return (\n        <div className={className}>\n          <FaqSkeleton />\n        </div>\n      )\n    }\n    return (\n      <main className={className ?? 'bg-ods-bg'}>\n        <div className=\"max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto\">\n          <FaqSkeleton />\n        </div>\n      </main>\n    )\n  }\n\n  if (error && faqs.length === 0) {\n    return (\n      <main className={className ?? 'bg-ods-bg flex items-center justify-center py-20'}>\n        <p className=\"text-ods-text-primary font-medium\">Failed to load FAQs. Please try again later.</p>\n      </main>\n    )\n  }\n\n  const schema = emitJsonLd ? buildFaqJsonLdFromFaqs(faqs, jsonLd) : null\n\n  // Embedded: ONE flat accordion — `faq.section` becomes a per-row chip, NOT\n  // a heading, so the host page's outline stays h2(\"Frequently Asked\n  // Questions\") + h3(questions). Order is the server's (post-specific first,\n  // then reused) — grouping by section here would destroy it.\n  const body = isEmbedded ? (\n    <section className={className ?? 'space-y-6'}>\n      {headingNode}\n      <FaqAccordion\n        items={faqs.map((faq) => ({\n          id: faq.id,\n          question: faq.question,\n          answer: faq.answer,\n          badge: faq.section || undefined,\n        }))}\n      />\n    </section>\n  ) : (\n    // Page variant (standalone /faqs): historical markup — <main> shell,\n    // page gutters, FAQs grouped by section with one <h2> per section.\n    <main className={className ?? 'bg-ods-bg'}>\n      <div className=\"max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto space-y-10\">\n        {headingNode}\n        {groupBySection(faqs).map(({ section, items }) => (\n          <div key={section || 'default'} className=\"space-y-4\">\n            {section && (\n              <h2 className=\"text-h2 tracking-[-0.04em] text-ods-text-primary mb-3 md:mb-4\">\n                {section}\n              </h2>\n            )}\n            <FaqAccordion items={items} />\n          </div>\n        ))}\n      </div>\n    </main>\n  )\n\n  return (\n    <>\n      {body}\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\"\n\nexport interface FaqItem {\n  id: number | string\n  question: string\n  answer: string\n  /** Optional category label rendered as a neutral chip under the question\n   *  (NOT a heading — keeps the document outline to h2/h3 only). Mirrors the\n   *  hub's FaqSectionBadge recipe so admin + public chips stay identical. */\n  badge?: 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            className={cn('group 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=\"flex min-w-0 flex-col gap-2 pr-4\">\n                <h3>\n                  {item.question}\n                </h3>\n                {item.badge && (\n                  <span className=\"w-fit shrink-0 px-2 py-1 rounded text-xs font-medium font-['DM_Sans'] bg-ods-border text-ods-text-secondary\">\n                    {item.badge}\n                  </span>\n                )}\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"],"mappings":"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","names":["jsx","jsxs"]}

package/dist/components/authors/author-detail-view.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Author detail-page body — identity header (avatar → name → job title →
+ * socials), bio, expertise badges, and a `children` slot for the authored-
+ * content rail. THE one implementation behind the hub's `/authors/[slug]`
+ * page AND embedded author pages (react-embedding-example) — hosts fetch
+ * the `AuthorProfile` however they like and drill it in.
+ *
+ * Embed-readiness contract (same rules as ArticleAuthorByline):
+ *   - `Image` renders through the embed shim (plain `<img>` in non-Next
+ *     hosts; the real `next/image` once registered at app init).
+ *   - Avatar proxying rides the OPTIONAL ambient `ChatRuntime`
+ *     (`endpoints.imageProxyUrlPrefix`) — no provider ⇒ raw URL, never
+ *     throws. `proxyImageUrl` prop wins over the runtime.
+ *   - The authored-content rail is a SLOT (`children`), not a baked-in
+ *     fetch: the hub passes its pre-bound `RelatedContentSection` with SSR
+ *     `initialItems`; embedders pass the lib section with `apiBaseUrl`.
+ *     The view stays data-in, markup-out.
+ *
+ * Heading semantics are the HOST's: the view renders the name as a styled
+ * `<p>` (like the hub profile header) so a hosting page can own its `<h1>`
+ * (the hub uses an sr-only h1 for crawlers).
+ */
+import React from 'react';
+import type { AuthorProfile } from '../../types/entity-author';
+export interface AuthorDetailViewProps {
+    author: AuthorProfile;
+    /** Host-injected avatar-URL mapper — wins over the ambient runtime. */
+    proxyImageUrl?: (url: string) => string;
+    /** Authored-content rail (or anything else) rendered below the profile. */
+    children?: React.ReactNode;
+    className?: string;
+}
+export declare function AuthorDetailView({ author, proxyImageUrl, children, className, }: AuthorDetailViewProps): React.JSX.Element;
+//# sourceMappingURL=author-detail-view.d.ts.map

package/dist/components/authors/author-detail-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"author-detail-view.d.ts","sourceRoot":"","sources":["../../../src/components/authors/author-detail-view.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAQzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,aAAa,EACb,QAAQ,EACR,SAAS,GACV,EAAE,qBAAqB,qBAgFvB"}

package/dist/components/faq/faq-section.d.ts

@@ -12,11 +12,27 @@ export interface FaqSectionProps {
     entityType?: string;
     entityId?: number | string;
     /**
-     * Page heading. Pass null to render in embedded mode (no <h1>, error branch
-     * suppresses any banner). React node so platforms can drill their local
-     * <PageHeading> component without the lib referencing platform state.
+     * Heading node. `undefined` → variant default (page: <h1>, embedded: <h2>
+     * "Frequently Asked Questions"); `null` → no heading. React node so
+     * platforms can drill their local <PageHeading> component without the lib
+     * referencing platform state.
      */
     heading?: React.ReactNode | null;
+    /**
+     * Layout variant.
+     *   - 'page' — the standalone /faqs surface: <main> shell + page gutters,
+     *     FAQs GROUPED by `faq.section` with one <h2> per section.
+     *   - 'embedded' — a section inside a host page (entity detail rails, the
+     *     global nested-page block): no shell, ONE flat accordion with each
+     *     row's `faq.section` rendered as a neutral chip (never a heading) and
+     *     a single default <h2> above. Exactly one FAQ block per page — the
+     *     per-tag heading loop is page-variant-only.
+     * Back-compat default: `heading === null` → 'embedded', else 'page' (the
+     * pre-variant discriminator, kept so older embedders don't shift layout
+     * until they opt in — they DO pick up the flat chip list, which is the
+     * point of the consolidation).
+     */
+    variant?: 'page' | 'embedded';
     /** Inject FAQPage schema.org JSON-LD as a <script>. Off by default so embeds
      *  don't emit duplicate schema. */
     emitJsonLd?: boolean;
@@ -42,5 +58,5 @@ export interface FaqSectionProps {
  * useSelfFetch reports `error:true` (logged once); in embedded mode (heading
  * === null) this component renders nothing so the host page isn't disfigured.
  */
-export declare function FaqSection({ initialFaqs, entityType, entityId, heading, emitJsonLd, jsonLd, className, minResults, apiBaseUrl, }: FaqSectionProps): React.JSX.Element | null;
+export declare function FaqSection({ initialFaqs, entityType, entityId, heading, variant, emitJsonLd, jsonLd, className, minResults, apiBaseUrl, }: FaqSectionProps): React.JSX.Element | null;
 //# sourceMappingURL=faq-section.d.ts.map

package/dist/components/faq/faq-section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"faq-section.d.ts","sourceRoot":"","sources":["../../../src/components/faq/faq-section.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAK1C,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEzE,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,GAAG,EAAE,CAAA;IACnB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;IAChC;uCACmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;6CACyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;uCACmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAqDD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EACzB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,OAAO,EACP,UAAkB,EAClB,MAAM,EACN,SAAS,EACT,UAAU,EACV,UAAe,GAChB,EAAE,eAAe,4BAmGjB"}
+{"version":3,"file":"faq-section.d.ts","sourceRoot":"","sources":["../../../src/components/faq/faq-section.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAK1C,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEzE,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,GAAG,EAAE,CAAA;IACnB,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;IAChC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC7B;uCACmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;6CACyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;uCACmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAqDD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EACzB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,OAAO,EACP,OAAO,EACP,UAAkB,EAClB,MAAM,EACN,SAAS,EACT,UAAU,EACV,UAAe,GAChB,EAAE,eAAe,4BAsHjB"}

package/dist/components/faq/index.cjs

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _chunkZJP2BB3Ecjs = require('../../chunk-ZJP2BB3E.cjs');
+var _chunk3UAV25YBcjs = require('../../chunk-3UAV25YB.cjs');
 require('../../chunk-T7AJBKZP.cjs');
 require('../../chunk-7VMEOFEA.cjs');
 require('../../chunk-FIG2RKZF.cjs');
 require('../../chunk-VRHGVLSL.cjs');
 
 
-exports.FaqSection = _chunkZJP2BB3Ecjs.FaqSection;
+exports.FaqSection = _chunk3UAV25YBcjs.FaqSection;
 //# sourceMappingURL=index.cjs.map

package/dist/components/faq/index.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   FaqSection
-} from "../../chunk-J3QMPOS6.js";
+} from "../../chunk-OVXKTNEP.js";
 import "../../chunk-L4LAAA5Q.js";
 import "../../chunk-NR535XIY.js";
 import "../../chunk-XTCBRQN2.js";

package/dist/components/faq-accordion.d.ts

@@ -3,6 +3,10 @@ export interface FaqItem {
     id: number | string;
     question: string;
     answer: string;
+    /** Optional category label rendered as a neutral chip under the question
+     *  (NOT a heading — keeps the document outline to h2/h3 only). Mirrors the
+     *  hub's FaqSectionBadge recipe so admin + public chips stay identical. */
+    badge?: string;
 }
 interface FaqAccordionProps {
     items: FaqItem[];

package/dist/components/faq-accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"faq-accordion.d.ts","sourceRoot":"","sources":["../../src/components/faq-accordion.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAA;AAIvE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;CACrC;AA0BD,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,cAAmB,EAAE,EAAE,iBAAiB,qBAgE7E"}
+{"version":3,"file":"faq-accordion.d.ts","sourceRoot":"","sources":["../../src/components/faq-accordion.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAA;AAIvE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd;;+EAE2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;CACrC;AA0BD,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,cAAmB,EAAE,EAAE,iBAAiB,qBAuE7E"}