@burdenoff/website-sdk 2026.1024.1 → 2026.1026.1

package/dist/{explore-POqE7J8r.d.mts → explore-BRfKFfvI.d.mts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { E as ExploreProduct, a as ExploreReference } from './explore-types-BB8HNFzX.mjs';
+import { E as ExploreProduct, a as ExploreReference } from './explore-types-_9UJu6EA.mjs';
 import { Components } from 'react-markdown';
 
 /** The words the player needs. `AnswerRendererStrings`, and so `ExploreStrings`, carry them. */
@@ -237,6 +237,21 @@ interface ExplorePageProps {
      * falls back to English.
      */
     locale?: string;
+    /**
+     * BOFF-9697. `page` (default) is the dedicated `/explore` route, exactly as before: it owns the document head
+     * (PageHead), the `<h1>`, the baked catalog and, in `viewport` mode, the page's scrolling. `panel` is the same
+     * conversation inside the site-wide assistant panel (`ExplorePanel`): it is a guest on whatever page is showing,
+     * so it writes nothing to the head, uses an `<h2>`, bakes nothing, fills its container and leaves the page's
+     * scrolling alone. Share links point at `/explore` (`explorePath`), not at the page the panel is on.
+     */
+    presentation?: "page" | "panel";
+    /**
+     * BOFF-9697. Whether the view is showing (default `true`). The panel passes `false` while it is closed or on its
+     * Avatar tab: dictation and read-aloud stop then, and the conversation itself is untouched.
+     */
+    active?: boolean;
+    /** BOFF-9697. The site's Explore route, for share links made from the panel. Default `/explore`. */
+    explorePath?: string;
 }
 /**
  * The product's own logo, derived from the reference's origin.
@@ -304,6 +319,10 @@ declare const EXPLORE_PREFILL_MAX_LENGTH = 500;
  * `base` is the explore page's path or absolute URL.
  */
 declare function exploreQuestionHref(question: string, base?: string): string;
-declare function ExplorePage({ seo, productSlug, examplePrompts, className, heightMode, viewportOffset, onNavigate, onSend, welcomeTitle, welcomeBody, locale, }: ExplorePageProps): react.JSX.Element;
+/**
+ * The Explore page. Under an `ExploreChatProvider` it shows the provider's conversation (one for the whole site, shared
+ * with `ExplorePanel`); otherwise it sets up its own, exactly as it always has (BOFF-9697).
+ */
+declare function ExplorePage(props: ExplorePageProps): react.JSX.Element;
 
 export { type AnswerRendererStrings as A, EXPLORE_PREFILL_MAX_LENGTH as E, ExploreAnswerBody as a, type ExploreAnswerBodyProps as b, ExploreAnswerStyles as c, ExplorePage as d, type ExplorePageProps as e, answerPlainText as f, answerSpeechText as g, exploreQuestionHref as h, inlineImageOrigins as i, isInlineImageAllowed as j, isInlineVideoAllowed as k, type ExploreProvenance as l, type ExploreReferenceKind as m, logoUrlOf as n, productNamesByOrigin as o, productSlugsByOrigin as p, referenceKindOf as r, summariseReferences as s };

package/dist/{explore-D6kon7uz.d.ts → explore-DkfcKgp6.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { E as ExploreProduct, a as ExploreReference } from './explore-types-BB8HNFzX.js';
+import { E as ExploreProduct, a as ExploreReference } from './explore-types-_9UJu6EA.js';
 import { Components } from 'react-markdown';
 
 /** The words the player needs. `AnswerRendererStrings`, and so `ExploreStrings`, carry them. */
@@ -237,6 +237,21 @@ interface ExplorePageProps {
      * falls back to English.
      */
     locale?: string;
+    /**
+     * BOFF-9697. `page` (default) is the dedicated `/explore` route, exactly as before: it owns the document head
+     * (PageHead), the `<h1>`, the baked catalog and, in `viewport` mode, the page's scrolling. `panel` is the same
+     * conversation inside the site-wide assistant panel (`ExplorePanel`): it is a guest on whatever page is showing,
+     * so it writes nothing to the head, uses an `<h2>`, bakes nothing, fills its container and leaves the page's
+     * scrolling alone. Share links point at `/explore` (`explorePath`), not at the page the panel is on.
+     */
+    presentation?: "page" | "panel";
+    /**
+     * BOFF-9697. Whether the view is showing (default `true`). The panel passes `false` while it is closed or on its
+     * Avatar tab: dictation and read-aloud stop then, and the conversation itself is untouched.
+     */
+    active?: boolean;
+    /** BOFF-9697. The site's Explore route, for share links made from the panel. Default `/explore`. */
+    explorePath?: string;
 }
 /**
  * The product's own logo, derived from the reference's origin.
@@ -304,6 +319,10 @@ declare const EXPLORE_PREFILL_MAX_LENGTH = 500;
  * `base` is the explore page's path or absolute URL.
  */
 declare function exploreQuestionHref(question: string, base?: string): string;
-declare function ExplorePage({ seo, productSlug, examplePrompts, className, heightMode, viewportOffset, onNavigate, onSend, welcomeTitle, welcomeBody, locale, }: ExplorePageProps): react.JSX.Element;
+/**
+ * The Explore page. Under an `ExploreChatProvider` it shows the provider's conversation (one for the whole site, shared
+ * with `ExplorePanel`); otherwise it sets up its own, exactly as it always has (BOFF-9697).
+ */
+declare function ExplorePage(props: ExplorePageProps): react.JSX.Element;
 
 export { type AnswerRendererStrings as A, EXPLORE_PREFILL_MAX_LENGTH as E, ExploreAnswerBody as a, type ExploreAnswerBodyProps as b, ExploreAnswerStyles as c, ExplorePage as d, type ExplorePageProps as e, answerPlainText as f, answerSpeechText as g, exploreQuestionHref as h, inlineImageOrigins as i, isInlineImageAllowed as j, isInlineVideoAllowed as k, type ExploreProvenance as l, type ExploreReferenceKind as m, logoUrlOf as n, productNamesByOrigin as o, productSlugsByOrigin as p, referenceKindOf as r, summariseReferences as s };

package/dist/{explore-types-BB8HNFzX.d.mts → explore-types-_9UJu6EA.d.mts}

@@ -350,4 +350,4 @@ declare const EXPLORE_ESCALATION_NOTE_SOFT_MAX = 2000;
  */
 declare function looksLikeDeliverableEmail(value: string): boolean;
 
-export { looksLikeDeliverableEmail as A, type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreReference as a, type ExploreLimits as b, type ExploreCatalog as c, type ExploreMessage as d, type ExploreFeedbackRating as e, type ExploreFeedbackReason as f, ESCALATE_EXPLORE_CONVERSATION_MUTATION as g, EXPLORE_CATALOG_QUERY as h, EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS as i, EXPLORE_ESCALATION_NOTE_SOFT_MAX as j, EXPLORE_MESSAGE_QUERY as k, type EscalateExploreConversationInput as l, type EscalateExploreConversationResult as m, type ExploreCatalogQueryData as n, type ExploreConceptHighlight as o, type ExploreConversation as p, type ExploreCtaKind as q, type ExploreCtaLink as r, type ExploreErrorCode as s, type ExploreEscalation as t, type ExploreMessageQueryData as u, type ExploreMessageRole as v, type ExploreMessageStatus as w, type SendExploreMessageInput as x, type SendExploreMessageMutationData as y, type SendExploreMessageResult as z };
+export { looksLikeDeliverableEmail as A, type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreReference as a, type ExploreCatalog as b, type ExploreMessage as c, type ExploreFeedbackRating as d, type ExploreFeedbackReason as e, type ExploreLimits as f, ESCALATE_EXPLORE_CONVERSATION_MUTATION as g, EXPLORE_CATALOG_QUERY as h, EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS as i, EXPLORE_ESCALATION_NOTE_SOFT_MAX as j, EXPLORE_MESSAGE_QUERY as k, type EscalateExploreConversationInput as l, type EscalateExploreConversationResult as m, type ExploreCatalogQueryData as n, type ExploreConceptHighlight as o, type ExploreConversation as p, type ExploreCtaKind as q, type ExploreCtaLink as r, type ExploreErrorCode as s, type ExploreEscalation as t, type ExploreMessageQueryData as u, type ExploreMessageRole as v, type ExploreMessageStatus as w, type SendExploreMessageInput as x, type SendExploreMessageMutationData as y, type SendExploreMessageResult as z };

package/dist/{explore-types-BB8HNFzX.d.ts → explore-types-_9UJu6EA.d.ts}

@@ -350,4 +350,4 @@ declare const EXPLORE_ESCALATION_NOTE_SOFT_MAX = 2000;
  */
 declare function looksLikeDeliverableEmail(value: string): boolean;
 
-export { looksLikeDeliverableEmail as A, type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreReference as a, type ExploreLimits as b, type ExploreCatalog as c, type ExploreMessage as d, type ExploreFeedbackRating as e, type ExploreFeedbackReason as f, ESCALATE_EXPLORE_CONVERSATION_MUTATION as g, EXPLORE_CATALOG_QUERY as h, EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS as i, EXPLORE_ESCALATION_NOTE_SOFT_MAX as j, EXPLORE_MESSAGE_QUERY as k, type EscalateExploreConversationInput as l, type EscalateExploreConversationResult as m, type ExploreCatalogQueryData as n, type ExploreConceptHighlight as o, type ExploreConversation as p, type ExploreCtaKind as q, type ExploreCtaLink as r, type ExploreErrorCode as s, type ExploreEscalation as t, type ExploreMessageQueryData as u, type ExploreMessageRole as v, type ExploreMessageStatus as w, type SendExploreMessageInput as x, type SendExploreMessageMutationData as y, type SendExploreMessageResult as z };
+export { looksLikeDeliverableEmail as A, type ExploreProduct as E, SEND_EXPLORE_MESSAGE_MUTATION as S, type ExploreReference as a, type ExploreCatalog as b, type ExploreMessage as c, type ExploreFeedbackRating as d, type ExploreFeedbackReason as e, type ExploreLimits as f, ESCALATE_EXPLORE_CONVERSATION_MUTATION as g, EXPLORE_CATALOG_QUERY as h, EXPLORE_CATALOG_QUERY_WITHOUT_HIGHLIGHTS as i, EXPLORE_ESCALATION_NOTE_SOFT_MAX as j, EXPLORE_MESSAGE_QUERY as k, type EscalateExploreConversationInput as l, type EscalateExploreConversationResult as m, type ExploreCatalogQueryData as n, type ExploreConceptHighlight as o, type ExploreConversation as p, type ExploreCtaKind as q, type ExploreCtaLink as r, type ExploreErrorCode as s, type ExploreEscalation as t, type ExploreMessageQueryData as u, type ExploreMessageRole as v, type ExploreMessageStatus as w, type SendExploreMessageInput as x, type SendExploreMessageMutationData as y, type SendExploreMessageResult as z };

package/dist/hooks/index.d.mts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, c as ExploreEscalateOutcome, d as ExploreEscalateResult, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, e as UseExploreChatResult, f as UseSpeechOutputOptions, g as UseSpeechOutputResult, h as classifyExploreError, s as stopSpeaking, u as useExploreChat, i as useProgressiveReveal, j as useSpeechOutput } from '../use-progressive-reveal-Kr6DwGXG.mjs';
-import '../explore-types-BB8HNFzX.mjs';
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, c as ExploreEscalateOutcome, d as ExploreEscalateResult, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, e as UseExploreChatResult, f as UseSpeechOutputOptions, g as UseSpeechOutputResult, h as classifyExploreError, s as stopSpeaking, u as useExploreChat, i as useProgressiveReveal, j as useSpeechOutput } from '../use-progressive-reveal-BFPWbEXy.mjs';
+import '../explore-types-_9UJu6EA.mjs';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.d.ts

@@ -1,5 +1,5 @@
-export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, c as ExploreEscalateOutcome, d as ExploreEscalateResult, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, e as UseExploreChatResult, f as UseSpeechOutputOptions, g as UseSpeechOutputResult, h as classifyExploreError, s as stopSpeaking, u as useExploreChat, i as useProgressiveReveal, j as useSpeechOutput } from '../use-progressive-reveal-BVJn9NIr.js';
-import '../explore-types-BB8HNFzX.js';
+export { D as DEFAULT_EXPLORE_EXAMPLE_PROMPTS, E as ExploreChatError, a as ExploreChatErrorKind, b as ExploreChatPhase, c as ExploreEscalateOutcome, d as ExploreEscalateResult, F as FALLBACK_EXPLORE_LIMITS, U as UseExploreChatOptions, e as UseExploreChatResult, f as UseSpeechOutputOptions, g as UseSpeechOutputResult, h as classifyExploreError, s as stopSpeaking, u as useExploreChat, i as useProgressiveReveal, j as useSpeechOutput } from '../use-progressive-reveal-C0hkdu_i.js';
+import '../explore-types-_9UJu6EA.js';
 
 interface UseSpeechInputOptions {
     /** Receives settled text as it is recognised. Append it to the draft. */

package/dist/hooks/index.js

@@ -1019,7 +1019,9 @@ function useExploreChat(options = {}) {
     pollTimeoutMs = DEFAULT_POLL_TIMEOUT_MS,
     storageKey = DEFAULT_STORAGE_KEY,
     persist = true,
-    onSend
+    onSend,
+    enabled = true,
+    shareToken: shareTokenOption
   } = options;
   const client = useWebSDK();
   const { productId } = useWebSDKConfig();
@@ -1057,7 +1059,7 @@ function useExploreChat(options = {}) {
   const [hasConversation, setHasConversation] = react.useState(false);
   const shareTokenRef = react.useRef(void 0);
   if (shareTokenRef.current === void 0) {
-    shareTokenRef.current = readShareToken();
+    shareTokenRef.current = shareTokenOption === void 0 ? readShareToken() : shareTokenOption;
   }
   const isSharedView = shareTokenRef.current !== null;
   const catalogRef = react.useRef(catalog);
@@ -1095,6 +1097,7 @@ function useExploreChat(options = {}) {
     };
   }, []);
   react.useEffect(() => {
+    if (!enabled) return;
     const shareToken = shareTokenRef.current;
     if (!shareToken) return;
     let cancelled = false;
@@ -1129,8 +1132,9 @@ function useExploreChat(options = {}) {
     return () => {
       cancelled = true;
     };
-  }, [client]);
+  }, [client, enabled]);
   react.useEffect(() => {
+    if (!enabled) return;
     if (shareTokenRef.current !== null) return;
     if (!persist) {
       setHydrated(true);
@@ -1155,9 +1159,10 @@ function useExploreChat(options = {}) {
       setTurnCount(turns);
     }
     setHydrated(true);
-  }, [persist, rememberConversationToken, storageKey]);
+  }, [persist, rememberConversationToken, storageKey, enabled]);
   react.useEffect(() => {
-    if (!persist || !hydrated || typeof window === "undefined") return;
+    if (!persist || !hydrated || isSharedView || typeof window === "undefined")
+      return;
     try {
       const payload = {
         conversationToken: conversationTokenRef.current,
@@ -1171,10 +1176,10 @@ function useExploreChat(options = {}) {
       window.localStorage.setItem(storageKey, JSON.stringify(payload));
     } catch {
     }
-  }, [persist, hydrated, storageKey, messages, focusProduct]);
+  }, [persist, hydrated, isSharedView, storageKey, messages, focusProduct]);
   react.useEffect(() => {
     messagesRef.current = messages;
-    if (!persist || !hydrated) return;
+    if (!persist || !hydrated || isSharedView) return;
     const settled = messages.some(
       (m) => m.role === "ASSISTANT" && (m.status === "COMPLETED" || m.status === "FAILED")
     );
@@ -1186,8 +1191,9 @@ function useExploreChat(options = {}) {
         focusProduct: focusProductRef.current
       })
     );
-  }, [messages, persist, hydrated, storageKey]);
+  }, [messages, persist, hydrated, isSharedView, storageKey]);
   react.useEffect(() => {
+    if (!enabled) return;
     let cancelled = false;
     const load = async () => {
       const variables = { productSlug: productSlug ?? null };
@@ -1228,7 +1234,7 @@ function useExploreChat(options = {}) {
     return () => {
       cancelled = true;
     };
-  }, [client, productSlug, fallbackCatalog, bakedRaw]);
+  }, [client, productSlug, fallbackCatalog, bakedRaw, enabled]);
   const startPolling = react.useCallback(
     (conversationToken, messageId) => {
       pollGenerationRef.current += 1;