@flamingo-stack/openframe-frontend-core 0.0.719 → 0.0.721

package/dist/{chunk-EAHOB64X.js → chunk-57UTI7ZH.js}

@@ -1,25 +1,33 @@
 "use client";
-import {
-  useSelfFetch
-} from "./chunk-RR6PY34K.js";
 import {
   PageShell
-} from "./chunk-2JLP2X2M.js";
+} from "./chunk-2P2M27EW.js";
 import {
   PageLayout
-} from "./chunk-Y4MB25KW.js";
+} from "./chunk-GYAXV3MZ.js";
 import {
   useScrollToHash
-} from "./chunk-IWCPXJEE.js";
+} from "./chunk-2TXGR7IK.js";
 import {
+  ASK_PROMPTS_DEFAULT_COUNT,
+  AskCard,
+  assistantAvailable,
   faqItemAnchor,
   faqSectionSlug,
-  parseFaqHash
-} from "./chunk-JH2SIWPQ.js";
+  parseFaqHash,
+  useAskPrompts,
+  useAssistantOpen,
+  useShownAskPromptIds
+} from "./chunk-HXB7SEYG.js";
+import {
+  AssistantRuntimeContext,
+  useAssistantRuntime
+} from "./chunk-AFTRPEXO.js";
 import {
   STICKY_HEADER_OFFSET_PX,
-  navigateSamePageHash
-} from "./chunk-CMZ3QTFQ.js";
+  navigateSamePageHash,
+  useInView
+} from "./chunk-4I3K6LEH.js";
 import {
   serializeJsonLd
 } from "./chunk-34I6XI3N.js";
@@ -28,8 +36,9 @@ import {
 } from "./chunk-GY4IZG22.js";
 import {
   SECTION_HEADING_CLASS,
-  buildSuggestionUrl
-} from "./chunk-TTVOLEUS.js";
+  buildSuggestionUrl,
+  useSelfFetch
+} from "./chunk-NPSJE7J3.js";
 import {
   Chevron02DownIcon
 } from "./chunk-NCPTID44.js";
@@ -41,7 +50,7 @@ import {
 } from "./chunk-7RXWKTAP.js";
 
 // src/components/faq/faq-section.tsx
-import { useCallback, useEffect, useMemo, useRef, useState as useState2 } from "react";
+import { useCallback, useEffect, useMemo as useMemo2, useRef, useState as useState3 } from "react";
 
 // src/components/faq-accordion.tsx
 import { useState } from "react";
@@ -109,6 +118,54 @@ function FaqAccordion({ items, defaultOpenIds = [] }) {
   }) });
 }
 
+// src/components/faq/faq-ask-card.tsx
+import { useMemo, useState as useState2 } from "react";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var DEFAULT_ASK_CARD = {
+  title: "Still deciding?",
+  description: "{assistant} answers from our docs and customer stories."
+};
+var PICK_ROOT_MARGIN = "600px";
+var fillAssistant = (text, name) => text.split("{assistant}").join(name);
+function faqAskCardShown(assistant) {
+  return assistantAvailable(assistant) && !!assistant.name;
+}
+function FaqAskCard({ topic, exclude, count, title, description, onOpen }) {
+  const assistant = useAssistantRuntime();
+  const { ref, inView } = useInView({ rootMargin: PICK_ROOT_MARGIN });
+  const [reached, setReached] = useState2(false);
+  if (inView && !reached) setReached(true);
+  const shownElsewhere = useShownAskPromptIds();
+  const excluded = exclude === void 0 ? shownElsewhere : exclude;
+  const slots = count ?? assistant?.askCard?.count ?? ASK_PROMPTS_DEFAULT_COUNT;
+  const { prompts, isLoading, supported } = useAskPrompts({
+    topic,
+    count: slots,
+    exclude: excluded ?? void 0,
+    enabled: reached && excluded !== null
+  });
+  const open = useAssistantOpen(topic, onOpen);
+  const scoped = useMemo(() => assistant ? { ...assistant, open } : null, [assistant, open]);
+  if (!faqAskCardShown(assistant) || !assistant.name) return null;
+  const name = assistant.name;
+  const cardDescription = description ?? assistant.askCard?.description ?? DEFAULT_ASK_CARD.description;
+  return /* @__PURE__ */ jsx2(AssistantRuntimeContext.Provider, { value: scoped, children: /* @__PURE__ */ jsx2("div", { ref, children: /* @__PURE__ */ jsx2(
+    AskCard,
+    {
+      title: fillAssistant(title ?? assistant.askCard?.title ?? DEFAULT_ASK_CARD.title, name),
+      description: cardDescription ? fillAssistant(cardDescription, name) : void 0,
+      prompts,
+      count: supported ? slots : 0,
+      loading: isLoading,
+      source: assistant.source,
+      label: name,
+      icon: assistant.icon,
+      onOpen: open,
+      onAsk: (prompt) => assistant.onAsk?.({ promptId: prompt.id, topic })
+    }
+  ) }) });
+}
+
 // src/components/faq/json-ld.ts
 var DEFAULT_NAME = "Frequently Asked Questions";
 var DEFAULT_DESCRIPTION = "Answers to common questions.";
@@ -136,7 +193,7 @@ function buildFaqJsonLdFromFaqs(faqs, opts = {}) {
 }
 
 // src/components/faq/faq-section.tsx
-import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 var DEFAULT_HEADING_TEXT = "Frequently Asked Questions";
 function buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl = "") {
   return buildSuggestionUrl("/api/faqs", { apiBaseUrl, entityType, entityId, count: minResults });
@@ -172,8 +229,8 @@ function GroupedFaqList({
   aside
 }) {
   const CategoryHeading = categoryHeadingAs;
-  const navGroups = useMemo(() => groups.filter((g) => g.slug), [groups]);
-  const [activeSlug, setActiveSlug] = useState2(navGroups[0]?.slug ?? null);
+  const navGroups = useMemo2(() => groups.filter((g) => g.slug), [groups]);
+  const [activeSlug, setActiveSlug] = useState3(navGroups[0]?.slug ?? null);
   const slugKey = navGroups.map((g) => g.slug).join("|");
   const navGroupsRef = useRef(navGroups);
   useEffect(() => {
@@ -207,14 +264,14 @@ function GroupedFaqList({
     }
     return () => observer.disconnect();
   }, [slugKey]);
-  const [hashTarget, setHashTarget] = useState2(null);
+  const [hashTarget, setHashTarget] = useState3(null);
   useEffect(() => {
     const refresh = () => setHashTarget(parseFaqHash(window.location.hash));
     refresh();
     window.addEventListener("hashchange", refresh);
     return () => window.removeEventListener("hashchange", refresh);
   }, []);
-  const defaultOpenByGroupKey = useMemo(() => {
+  const defaultOpenByGroupKey = useMemo2(() => {
     if (hashTarget?.kind !== "item") return null;
     const targetId = hashTarget.rawId;
     const result = /* @__PURE__ */ new Map();
@@ -227,7 +284,7 @@ function GroupedFaqList({
   const accordionKeySuffix = hashTarget?.kind === "item" ? `item:${hashTarget.rawId}` : "default";
   const scrollDep = `${groups.length}|` + (hashTarget?.kind === "item" ? `item:${hashTarget.rawId}` : hashTarget?.kind === "section" ? `section:${hashTarget.slug}` : "none");
   useScrollToHash(scrollDep, { headerOffset: STICKY_HEADER_OFFSET_PX });
-  const [pillSyncedHash, setPillSyncedHash] = useState2(hashTarget);
+  const [pillSyncedHash, setPillSyncedHash] = useState3(hashTarget);
   if (pillSyncedHash !== hashTarget) {
     setPillSyncedHash(hashTarget);
     if (hashTarget?.kind === "section") setActiveSlug(hashTarget.slug);
@@ -239,9 +296,9 @@ function GroupedFaqList({
       history: "replace"
     });
   }, []);
-  const categoryNav = navGroups.length > 1 && /* @__PURE__ */ jsx2("nav", { "aria-label": "FAQ categories", className: "flex flex-wrap gap-2", children: navGroups.map((group) => {
+  const categoryNav = navGroups.length > 1 && /* @__PURE__ */ jsx3("nav", { "aria-label": "FAQ categories", className: "flex flex-wrap gap-2", children: navGroups.map((group) => {
     const isActive = group.slug === activeSlug;
-    return /* @__PURE__ */ jsx2(
+    return /* @__PURE__ */ jsx3(
       next_link_default,
       {
         href: `#${group.slug}`,
@@ -256,11 +313,11 @@ function GroupedFaqList({
       group.slug
     );
   }) });
-  const questions = /* @__PURE__ */ jsx2("div", { className: "space-y-10", children: groups.map((group) => {
+  const questions = /* @__PURE__ */ jsx3("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(
+      group.section && /* @__PURE__ */ jsx3(CategoryHeading, { className: SECTION_HEADING_CLASS, children: group.section }),
+      /* @__PURE__ */ jsx3(
         FaqAccordion,
         {
           items: group.items,
@@ -281,16 +338,16 @@ function GroupedFaqList({
       heading,
       categoryNav
     ] }),
-    /* @__PURE__ */ jsx2("div", { className: "content-lg:col-start-2 content-lg:row-span-2 content-lg:row-start-1", children: questions }),
-    /* @__PURE__ */ jsx2("div", { className: "content-lg:col-start-1 content-lg:row-start-2", children: aside })
+    /* @__PURE__ */ jsx3("div", { className: "content-lg:col-start-2 content-lg:row-span-2 content-lg:row-start-1", children: questions }),
+    /* @__PURE__ */ jsx3("div", { className: "content-lg:col-start-1 content-lg:row-start-2", children: aside })
   ] });
 }
 function FaqSkeleton() {
   return /* @__PURE__ */ jsxs2("div", { className: "animate-pulse space-y-8", children: [
-    /* @__PURE__ */ jsx2("div", { className: "h-12 w-2/3 rounded bg-ods-border content-md:h-14" }),
-    /* @__PURE__ */ jsx2("div", { className: "w-full divide-y divide-ods-border overflow-hidden rounded-md border border-ods-border bg-transparent", children: Array.from({ length: 8 }).map((_, idx) => /* @__PURE__ */ jsxs2("div", { className: "flex items-center justify-between gap-6 px-6 py-4 content-md:gap-10", children: [
-      /* @__PURE__ */ jsx2("div", { className: "h-6 w-5/6 rounded bg-ods-border" }),
-      /* @__PURE__ */ jsx2("div", { className: "size-6 rounded bg-ods-border" })
+    /* @__PURE__ */ jsx3("div", { className: "h-12 w-2/3 rounded bg-ods-border content-md:h-14" }),
+    /* @__PURE__ */ jsx3("div", { className: "w-full divide-y divide-ods-border overflow-hidden rounded-md border border-ods-border bg-transparent", children: Array.from({ length: 8 }).map((_, idx) => /* @__PURE__ */ jsxs2("div", { className: "flex items-center justify-between gap-6 px-6 py-4 content-md:gap-10", children: [
+      /* @__PURE__ */ jsx3("div", { className: "h-6 w-5/6 rounded bg-ods-border" }),
+      /* @__PURE__ */ jsx3("div", { className: "size-6 rounded bg-ods-border" })
     ] }, idx)) })
   ] });
 }
@@ -304,27 +361,31 @@ function FaqSection({
   className,
   minResults,
   apiBaseUrl = "",
-  aside
+  aside: asideProp,
+  ask
 }) {
+  const assistant = useAssistantRuntime();
+  const askTopic = ask === false ? void 0 : ask?.topic || entityType;
+  const aside = asideProp ?? (ask !== false && askTopic && faqAskCardShown(assistant) ? /* @__PURE__ */ jsx3(FaqAskCard, { ...ask, topic: askTopic }) : void 0);
   const url = buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl);
-  const initialData = useMemo(
+  const initialData = useMemo2(
     () => initialFaqs ? { faqs: initialFaqs } : void 0,
     [initialFaqs]
   );
   const { data, isLoading, error } = useSelfFetch(url, { initialData });
-  const faqs = useMemo(() => data?.faqs ?? [], [data?.faqs]);
-  const groups = useMemo(() => faqs.length > 0 ? groupFaqsBySection(faqs) : [], [faqs]);
-  const headingNode = heading === void 0 ? /* @__PURE__ */ jsx2("h2", { className: SECTION_HEADING_CLASS, children: DEFAULT_HEADING_TEXT }) : heading;
+  const faqs = useMemo2(() => data?.faqs ?? [], [data?.faqs]);
+  const groups = useMemo2(() => faqs.length > 0 ? groupFaqsBySection(faqs) : [], [faqs]);
+  const headingNode = heading === void 0 ? /* @__PURE__ */ jsx3("h2", { className: SECTION_HEADING_CLASS, children: DEFAULT_HEADING_TEXT }) : heading;
   if (error) return null;
   if (!isLoading && faqs.length === 0) return null;
   if (isLoading && faqs.length === 0) {
-    return /* @__PURE__ */ jsx2("div", { className, children: /* @__PURE__ */ jsx2(FaqSkeleton, {}) });
+    return /* @__PURE__ */ jsx3("div", { className, children: /* @__PURE__ */ jsx3(FaqSkeleton, {}) });
   }
   const schema = emitJsonLd ? buildFaqJsonLdFromFaqs(faqs, jsonLd) : null;
   return /* @__PURE__ */ jsxs2(Fragment, { children: [
     /* @__PURE__ */ jsxs2("section", { className: className ?? "space-y-10", children: [
       !aside && headingNode,
-      /* @__PURE__ */ jsx2(
+      /* @__PURE__ */ jsx3(
         GroupedFaqList,
         {
           groups,
@@ -334,7 +395,7 @@ function FaqSection({
         }
       )
     ] }),
-    schema && /* @__PURE__ */ jsx2(
+    schema && /* @__PURE__ */ jsx3(
       "script",
       {
         type: "application/ld+json",
@@ -345,7 +406,7 @@ function FaqSection({
 }
 
 // src/components/faq/faq-document-page.tsx
-import { jsx as jsx3 } from "react/jsx-runtime";
+import { jsx as jsx4 } from "react/jsx-runtime";
 function FaqDocumentPage({
   title = "Frequently Asked Questions",
   subtitle,
@@ -357,6 +418,7 @@ function FaqDocumentPage({
   entityType,
   entityId,
   minResults,
+  ask,
   shell = true
 }) {
   const router = useRouter();
@@ -364,7 +426,7 @@ function FaqDocumentPage({
     label: backButton?.label ?? "Back to home",
     onClick: () => router.push(backButton?.href ?? "/")
   };
-  const inner = /* @__PURE__ */ jsx3(PageLayout, { title, subtitle, backButton: backCfg, titleSize: "h1", titleWrap: true, children: /* @__PURE__ */ jsx3(
+  const inner = /* @__PURE__ */ jsx4(PageLayout, { title, subtitle, backButton: backCfg, titleSize: "h1", titleWrap: true, children: /* @__PURE__ */ jsx4(
     FaqSection,
     {
       initialFaqs,
@@ -374,14 +436,16 @@ function FaqDocumentPage({
       apiBaseUrl,
       entityType,
       entityId,
-      minResults
+      minResults,
+      ask
     }
   ) });
-  return shell ? /* @__PURE__ */ jsx3(PageShell, { children: inner }) : /* @__PURE__ */ jsx3("div", { className: "page-shell-content", children: inner });
+  return shell ? /* @__PURE__ */ jsx4(PageShell, { children: inner }) : /* @__PURE__ */ jsx4("div", { className: "page-shell-content", children: inner });
 }
 
 export {
   FaqAccordion,
+  FaqAskCard,
   FaqSection,
   FaqDocumentPage
 };

package/dist/{chunk-XGHGGBM3.js → chunk-5QXE5HMV.js}

@@ -1,18 +1,18 @@
 "use client";
 import {
   useOnboardingState
-} from "./chunk-IWCPXJEE.js";
+} from "./chunk-2TXGR7IK.js";
 import {
   ShellTypeValues,
   getOSLabel,
   getShellLabel
-} from "./chunk-JH2SIWPQ.js";
+} from "./chunk-HXB7SEYG.js";
 import {
   InteractiveCard,
   SECTION_HEADING_CLASS,
   StatusBadge,
   accentSentenceMarks
-} from "./chunk-TTVOLEUS.js";
+} from "./chunk-NPSJE7J3.js";
 import {
   nameInitials
 } from "./chunk-IYVFSLWJ.js";
@@ -43,7 +43,7 @@ import {
 } from "./chunk-CMGFZHCN.js";
 import {
   Button
-} from "./chunk-YDPKUAP4.js";
+} from "./chunk-DJ4IFQNQ.js";
 import {
   cn
 } from "./chunk-7RXWKTAP.js";