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

package/dist/components/onboarding-guides/index.cjs

@@ -4,7 +4,7 @@
 
 
 
-var _chunk4MXBBBHBcjs = require('../../chunk-4MXBBBHB.cjs');
+var _chunkKQQDN2WKcjs = require('../../chunk-KQQDN2WK.cjs');
 
 
 var _chunkT7AJBKZPcjs = require('../../chunk-T7AJBKZP.cjs');
@@ -140,7 +140,7 @@ function OnboardingGuidesCatalogView({
     });
   };
   const source = _nullishCoalesce(_optionalChain([runtime, 'optionalAccess', _4 => _4.source]), () => ( "openframe"));
-  const docSearch = _chunk4MXBBBHBcjs.useDocSearch.call(void 0, {
+  const docSearch = _chunkKQQDN2WKcjs.useDocSearch.call(void 0, {
     source,
     baseRoute: basePath,
     onNavigate: (path) => router.push(path),
@@ -166,7 +166,7 @@ function OnboardingGuidesCatalogView({
   const renderCardFn = _nullishCoalesce(renderCard, () => ( defaultRenderCard));
   const preControls = /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-4", children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunk4MXBBBHBcjs.DocSearchBar,
+      _chunkKQQDN2WKcjs.DocSearchBar,
       {
         placeholder: "Search onboarding guides, releases, case studies\u2026",
         query: docSearch.query,
@@ -238,7 +238,7 @@ function OnboardingGuideDetailView({
     return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEB76VWM4cjs.LoadError, { message: "Guide not found.", onRetry: reload });
   }
   if (!guide) {
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk4MXBBBHBcjs.DetailPageSkeleton, { showImageGallery: false });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkKQQDN2WKcjs.DetailPageSkeleton, { showImageGallery: false });
   }
   const captionsUrl = _chunkEB76VWM4cjs.getCaptionsUrl.call(void 0, "onboarding_guide", guide.id, guide.srt_content);
   const videoPoster = guide.main_video_thumbnail || guide.featured_image || guide.og_image_url || _optionalChain([runtime, 'optionalAccess', _9 => _9.resolvePlaceholderUrl, 'optionalCall', _10 => _10(guide.title, { aspect: "wide" })]) || void 0;
@@ -307,7 +307,7 @@ function OnboardingGuideDetailView({
       }
     ),
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunk4MXBBBHBcjs.ArticleAuthorByline,
+      _chunkKQQDN2WKcjs.ArticleAuthorByline,
       {
         author: _nullishCoalesce(_optionalChain([guide, 'access', _12 => _12.author, 'optionalAccess', _13 => _13.full_name]), () => ( null)),
         avatar: _optionalChain([guide, 'access', _14 => _14.author, 'optionalAccess', _15 => _15.avatar_url]),

package/dist/components/onboarding-guides/index.js

@@ -4,7 +4,7 @@ import {
   DetailPageSkeleton,
   DocSearchBar,
   useDocSearch
-} from "../../chunk-IJHORDN5.js";
+} from "../../chunk-ACJPRIZC.js";
 import {
   useSelfFetch
 } from "../../chunk-L4LAAA5Q.js";

package/dist/components/shared/article-author-byline.d.ts

@@ -2,10 +2,9 @@
  * Shared "author byline" card used by article-shaped detail pages
  * (blog post, product release, onboarding guide, investor update).
  *
- * MOVED from the hub (`components/shared/article-author-byline.tsx`) so any
- * consuming app can embed it; the hub keeps a thin wrapper that pre-binds its
- * host-specific injections (the platform-aware `fallbackBio` default derived
- * from `getAppConfig()`).
+ * MOVED from the hub so any consuming app can embed it; hub call sites
+ * import it directly and pass their platform-aware copy explicitly
+ * (`fallbackBio={defaultAuthorFallbackBio()}` from the hub's app-config).
  *
  * Embed-readiness contract:
  *   - `Link` / `Image` render through the embed-shims (plain `<a>` / `<img>`

package/dist/components/shared/article-author-byline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"article-author-byline.d.ts","sourceRoot":"","sources":["../../../src/components/shared/article-author-byline.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAClC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAiBD,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,GAAG,EACH,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,WAAW,EACX,IAAW,EACX,aAAa,EACb,SAAS,GACV,EAAE,wBAAwB,4BA4F1B"}
+{"version":3,"file":"article-author-byline.d.ts","sourceRoot":"","sources":["../../../src/components/shared/article-author-byline.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAClC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAiBD,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,GAAG,EACH,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,WAAW,EACX,IAAW,EACX,aAAa,EACb,SAAS,GACV,EAAE,wBAAwB,4BA4F1B"}

package/dist/types/entity-author.d.ts

@@ -18,4 +18,29 @@ export interface EntityAuthor {
     /** Present only on server/admin payloads — public DALs strip it. */
     email?: string | null;
 }
+/** One curated social link on an author profile (host junction:
+ *  `profile_social_links` ordered by display_order in the hub). */
+export interface AuthorSocialLink {
+    /** Platform key fed to `SocialIconRow` (e.g. 'linkedin', 'x'). */
+    platform: string;
+    url: string;
+    username?: string | null;
+}
+/**
+ * Public author-page view model — what `<AuthorDetailView>` renders. The
+ * hub's `PublicAuthor` (authors DAL) extends this with server-side extras
+ * (`updatedAt`); embedders construct it from whatever directory they have.
+ */
+export interface AuthorProfile {
+    id: string;
+    slug: string;
+    fullName: string;
+    avatarUrl: string | null;
+    about: string | null;
+    jobTitle: string | null;
+    company: string | null;
+    knowsAbout: string[];
+    /** Ordered by display_order. */
+    socialLinks: AuthorSocialLink[];
+}
 //# sourceMappingURL=entity-author.d.ts.map

package/dist/types/entity-author.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-author.d.ts","sourceRoot":"","sources":["../../src/types/entity-author.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;2EACuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;8EAC0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB"}
+{"version":3,"file":"entity-author.d.ts","sourceRoot":"","sources":["../../src/types/entity-author.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;2EACuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;8EAC0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;mEACmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gCAAgC;IAChC,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAChC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.257",
+  "version": "0.0.259",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",

package/src/components/authors/author-detail-view.tsx

@@ -0,0 +1,130 @@
+'use client'
+
+/**
+ * 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 Image from '../../embed-shims/next-image'
+import { cn } from '../../utils/cn'
+import { formatBioText } from '../../utils/format'
+import { getProxiedImageUrl } from '../../utils/image-proxy'
+import { useChatRuntime } from '../../contexts/chat-runtime-context'
+import { SocialIconRow } from '../social-icon-row'
+import { StatusBadge } from '../ui/status-badge'
+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 function AuthorDetailView({
+  author,
+  proxyImageUrl,
+  children,
+  className,
+}: AuthorDetailViewProps) {
+  // Optional runtime — null-safe outside a provider (bare embeds render the
+  // raw avatar URL; the hub's app-wide HubRuntimeProvider supplies the proxy).
+  const runtime = useChatRuntime()
+
+  const proxiedAvatar = author.avatarUrl
+    ? proxyImageUrl
+      ? proxyImageUrl(author.avatarUrl)
+      : (getProxiedImageUrl(author.avatarUrl, {
+          proxyPrefix: runtime?.endpoints.imageProxyUrlPrefix,
+          skipDomains: runtime?.endpoints.imageProxySkipDomains,
+          directHttps: true,
+        }) ?? author.avatarUrl)
+    : null
+
+  const subtitle = [author.jobTitle, author.company].filter(Boolean).join(' @ ')
+  const bioText = formatBioText(author.about)
+
+  return (
+    <div className={cn('flex flex-col gap-5 md:gap-6', className)}>
+      {/* Identity header: avatar left; name → subtitle → socials stacked right. */}
+      <div className="flex gap-6 w-full items-start">
+        <div className="relative shrink-0 h-24 w-24">
+          <div className="rounded-full overflow-hidden bg-ods-bg-secondary border border-ods-border w-full h-full relative">
+            {proxiedAvatar ? (
+              <Image
+                src={proxiedAvatar}
+                alt={author.fullName}
+                fill
+                className="object-cover"
+                unoptimized
+              />
+            ) : (
+              <div className="flex items-center justify-center h-full w-full text-3xl text-ods-text-secondary font-['Azeret_Mono']">
+                {author.fullName.charAt(0).toUpperCase()}
+              </div>
+            )}
+          </div>
+        </div>
+
+        <div className="min-w-0 flex flex-col justify-center gap-2">
+          <p className="text-h2 text-ods-text-primary leading-none truncate">
+            {author.fullName}
+          </p>
+          {subtitle && (
+            <p className="font-body text-lg text-ods-text-secondary leading-none truncate">
+              {subtitle}
+            </p>
+          )}
+          {author.socialLinks.length > 0 && (
+            // Ghost compact row (transparent 32px) — metadata, not CTAs.
+            <SocialIconRow
+              compact
+              links={author.socialLinks.map((link) => ({
+                platform: link.platform,
+                href: link.url,
+                label: `${author.fullName}'s ${link.platform}`,
+              }))}
+            />
+          )}
+        </div>
+      </div>
+
+      {bioText && (
+        <p className="font-body text-base leading-relaxed text-ods-text-secondary">
+          {bioText}
+        </p>
+      )}
+
+      {author.knowsAbout.length > 0 && (
+        <div className="flex flex-wrap gap-2">
+          {author.knowsAbout.map((topic) => (
+            <StatusBadge key={topic} text={topic} variant="button" colorScheme="cyan" singleLine />
+          ))}
+        </div>
+      )}
+
+      {children}
+    </div>
+  )
+}

package/src/components/faq/faq-section.tsx

@@ -19,11 +19,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
@@ -106,6 +122,7 @@ export function FaqSection({
   entityType,
   entityId,
   heading,
+  variant,
   emitJsonLd = false,
   jsonLd,
   className,
@@ -122,23 +139,30 @@ export function FaqSection({
   const { data, isLoading, error } = useSelfFetch<FaqsResponse>(url, { initialData })
 
   const faqs = data?.faqs ?? []
-  const showHeading = heading !== null
+  const isEmbedded = variant ? variant === 'embedded' : heading === null
   const headingNode =
-    heading === undefined
-      ? <h1 className="text-h1 tracking-[-0.04em] text-ods-text-primary">{DEFAULT_HEADING_TEXT}</h1>
-      : heading
-
-  const groups = groupBySection(faqs)
+    heading === undefined ? (
+      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).
+        <h2 className="text-h2 tracking-[-0.04em] text-ods-text-primary">{DEFAULT_HEADING_TEXT}</h2>
+      ) : (
+        <h1 className="text-h1 tracking-[-0.04em] text-ods-text-primary">{DEFAULT_HEADING_TEXT}</h1>
+      )
+    ) : (
+      heading
+    )
 
-  // Embedded mode (no heading): degrade silently on error.
-  if (error && !showHeading) {
+  // Embedded mode: degrade silently on error.
+  if (error && isEmbedded) {
     return null
   }
 
   // Embedded mode, zero FAQs after load: render nothing — an embedded host
   // page (blog/case-study detail) must not show an empty section shell.
-  // The standalone /faqs page (heading set) keeps its existing behavior.
-  if (!isLoading && !error && faqs.length === 0 && !showHeading) {
+  // The standalone /faqs page keeps its existing behavior.
+  if (!isLoading && !error && faqs.length === 0 && isEmbedded) {
     return null
   }
 
@@ -146,7 +170,7 @@ export function FaqSection({
     // Embedded mode renders skeletons WITHOUT the standalone page shell —
     // a host detail page already provides <main> + gutters; nesting them
     // here would emit invalid markup and double padding.
-    if (!showHeading) {
+    if (isEmbedded) {
       return (
         <div className={className}>
           <FaqSkeleton />
@@ -172,28 +196,40 @@ export function FaqSection({
 
   const schema = emitJsonLd ? buildFaqJsonLdFromFaqs(faqs, jsonLd) : null
 
-  const groupNodes = groups.map(({ section, items }) => (
-    <div key={section || 'default'} className="space-y-4">
-      {section && (
-        <h2 className="text-h2 tracking-[-0.04em] text-ods-text-primary mb-3 md:mb-4">
-          {section}
-        </h2>
-      )}
-      <FaqAccordion items={items} />
-    </div>
-  ))
-
-  // Embedded mode (heading === null): no <main> page shell, no page gutters —
-  // the host page owns layout. Standalone mode keeps the historical markup.
-  const body = showHeading ? (
+  // Embedded: ONE flat accordion — `faq.section` becomes a per-row chip, NOT
+  // a heading, so the host page's outline stays h2("Frequently Asked
+  // Questions") + h3(questions). Order is the server's (post-specific first,
+  // then reused) — grouping by section here would destroy it.
+  const body = isEmbedded ? (
+    <section className={className ?? 'space-y-6'}>
+      {headingNode}
+      <FaqAccordion
+        items={faqs.map((faq) => ({
+          id: faq.id,
+          question: faq.question,
+          answer: faq.answer,
+          badge: faq.section || undefined,
+        }))}
+      />
+    </section>
+  ) : (
+    // Page variant (standalone /faqs): historical markup — <main> shell,
+    // page gutters, FAQs grouped by section with one <h2> per section.
     <main className={className ?? 'bg-ods-bg'}>
       <div className="max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto space-y-10">
         {headingNode}
-        {groupNodes}
+        {groupBySection(faqs).map(({ section, items }) => (
+          <div key={section || 'default'} className="space-y-4">
+            {section && (
+              <h2 className="text-h2 tracking-[-0.04em] text-ods-text-primary mb-3 md:mb-4">
+                {section}
+              </h2>
+            )}
+            <FaqAccordion items={items} />
+          </div>
+        ))}
       </div>
     </main>
-  ) : (
-    <section className={className ?? 'space-y-10'}>{groupNodes}</section>
   )
 
   return (

package/src/components/faq-accordion.tsx

@@ -8,6 +8,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 {
@@ -76,9 +80,16 @@ export function FaqAccordion({ items, defaultOpenIds = [] }: FaqAccordionProps)
               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"
             >
-              <h3>
-                {item.question}
-              </h3>
+              <div className="flex min-w-0 flex-col gap-2 pr-4">
+                <h3>
+                  {item.question}
+                </h3>
+                {item.badge && (
+                  <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">
+                    {item.badge}
+                  </span>
+                )}
+              </div>
               <div className="flex-shrink-0">
                 <ChevronButton
                   aria-label={isOpen ? 'Collapse question' : 'Expand question'}

package/src/components/index.ts

@@ -91,9 +91,14 @@ export * from './shared/legal-document'
 export { DetailPageSkeleton, type DetailPageSkeletonProps } from './shared/detail-page-skeleton'
 
 // Author byline card (end-of-article author description) — embeddable via
-// embed-shims + optional-runtime avatar proxying; the hub wraps it to inject
-// its platform-aware fallbackBio default.
+// embed-shims + optional-runtime avatar proxying; hosts pass their own
+// fallbackBio copy (the hub uses defaultAuthorFallbackBio()).
 export { ArticleAuthorByline, type ArticleAuthorBylineProps } from './shared/article-author-byline'
 
+// Author detail-page body (identity + socials + bio + expertise, rail as
+// children) — the one implementation behind /authors/[slug] and embedded
+// author pages.
+export { AuthorDetailView, type AuthorDetailViewProps } from './authors/author-detail-view'
+
 // Priority UI components that exist in main components directory
 // Note: These are re-exported from ./ui already, no need to duplicate

package/src/components/shared/article-author-byline.tsx

@@ -4,10 +4,9 @@
  * Shared "author byline" card used by article-shaped detail pages
  * (blog post, product release, onboarding guide, investor update).
  *
- * MOVED from the hub (`components/shared/article-author-byline.tsx`) so any
- * consuming app can embed it; the hub keeps a thin wrapper that pre-binds its
- * host-specific injections (the platform-aware `fallbackBio` default derived
- * from `getAppConfig()`).
+ * MOVED from the hub so any consuming app can embed it; hub call sites
+ * import it directly and pass their platform-aware copy explicitly
+ * (`fallbackBio={defaultAuthorFallbackBio()}` from the hub's app-config).
  *
  * Embed-readiness contract:
  *   - `Link` / `Image` render through the embed-shims (plain `<a>` / `<img>`

package/src/types/entity-author.ts

@@ -18,3 +18,30 @@ export interface EntityAuthor {
   /** Present only on server/admin payloads — public DALs strip it. */
   email?: string | null
 }
+
+/** One curated social link on an author profile (host junction:
+ *  `profile_social_links` ordered by display_order in the hub). */
+export interface AuthorSocialLink {
+  /** Platform key fed to `SocialIconRow` (e.g. 'linkedin', 'x'). */
+  platform: string
+  url: string
+  username?: string | null
+}
+
+/**
+ * Public author-page view model — what `<AuthorDetailView>` renders. The
+ * hub's `PublicAuthor` (authors DAL) extends this with server-side extras
+ * (`updatedAt`); embedders construct it from whatever directory they have.
+ */
+export interface AuthorProfile {
+  id: string
+  slug: string
+  fullName: string
+  avatarUrl: string | null
+  about: string | null
+  jobTitle: string | null
+  company: string | null
+  knowsAbout: string[]
+  /** Ordered by display_order. */
+  socialLinks: AuthorSocialLink[]
+}

package/dist/chunk-J3QMPOS6.js.map

@@ -1 +0,0 @@
-{"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   * Page heading. Pass null to render in embedded mode (no <h1>, error branch\n   * suppresses any banner). React node so platforms can drill their local\n   * <PageHeading> component without the lib referencing platform state.\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\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  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 showHeading = heading !== null\n  const headingNode =\n    heading === undefined\n      ? <h1 className=\"text-h1 tracking-[-0.04em] text-ods-text-primary\">{DEFAULT_HEADING_TEXT}</h1>\n      : heading\n\n  const groups = groupBySection(faqs)\n\n  // Embedded mode (no heading): degrade silently on error.\n  if (error && !showHeading) {\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 (heading set) keeps its existing behavior.\n  if (!isLoading && !error && faqs.length === 0 && !showHeading) {\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 (!showHeading) {\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  const groupNodes = groups.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\n  // Embedded mode (heading === null): no <main> page shell, no page gutters —\n  // the host page owns layout. Standalone mode keeps the historical markup.\n  const body = showHeading ? (\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        {groupNodes}\n      </div>\n    </main>\n  ) : (\n    <section className={className ?? 'space-y-10'}>{groupNodes}</section>\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}\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              <h3>\n                {item.question}\n              </h3>\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/chunk-ZJP2BB3E.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-ZJP2BB3E.cjs","../src/components/faq/faq-section.tsx","../src/components/faq-accordion.tsx","../src/components/faq/json-ld.ts"],"names":["jsx"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-ZJP2BB3E.cjs","sourcesContent":[null,"\"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   * Page heading. Pass null to render in embedded mode (no <h1>, error branch\n   * suppresses any banner). React node so platforms can drill their local\n   * <PageHeading> component without the lib referencing platform state.\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\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  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 showHeading = heading !== null\n  const headingNode =\n    heading === undefined\n      ? <h1 className=\"text-h1 tracking-[-0.04em] text-ods-text-primary\">{DEFAULT_HEADING_TEXT}</h1>\n      : heading\n\n  const groups = groupBySection(faqs)\n\n  // Embedded mode (no heading): degrade silently on error.\n  if (error && !showHeading) {\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 (heading set) keeps its existing behavior.\n  if (!isLoading && !error && faqs.length === 0 && !showHeading) {\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 (!showHeading) {\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  const groupNodes = groups.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\n  // Embedded mode (heading === null): no <main> page shell, no page gutters —\n  // the host page owns layout. Standalone mode keeps the historical markup.\n  const body = showHeading ? (\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        {groupNodes}\n      </div>\n    </main>\n  ) : (\n    <section className={className ?? 'space-y-10'}>{groupNodes}</section>\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}\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              <h3>\n                {item.question}\n              </h3>\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"]}