@burdenoff/website-sdk 2026.921.1 → 2026.922.2

package/README.md

@@ -161,8 +161,8 @@ function Header() {
 | `productSlug` | – | The site this page is on. A soft hint to the assistant, not a hard filter. |
 | `examplePrompts` | – | Prompt chips used only when the backend catalog supplies none. |
 | `className` | – | Extra classes on the page root. |
-| `heightMode` | `'viewport'` | `viewport` pins the chat to the screen with an internally scrolling transcript; `auto` lets the page grow (for embedding). |
-| `viewportOffset` | `0` | Chrome to subtract in `viewport` mode. A number is pixels; a string is any CSS length (`'4rem'`). |
+| `heightMode` | `'viewport'` | `viewport` pins the chat to the screen with an internally scrolling transcript, and is the only mode in which the component manages the host page's scroll position; `auto` lets the page grow and never touches its host's scrolling (for embedding). |
+| `viewportOffset` | `0` | Chrome to subtract in `viewport` mode, **before the first measurement only**. A number is pixels; a string is any CSS length (`'4rem'`). Once mounted the pane measures its own top and this value stops being used — so an approximate header height is fine, and the on-screen keyboard is handled for you. |
 | `onNavigate` | – | SPA navigation for internal CTA paths. Without it, CTAs render as plain links. |
 | `onSend` | – | Fired with the message text each time a send is accepted (analytics). |
 | `welcomeTitle` / `welcomeBody` | catalog values | Override the welcome copy. `welcomeTitle` **is** the page `<h1>`. |

package/dist/components/explore.d.mts

@@ -23,11 +23,19 @@ interface ExplorePageProps {
      * `viewport` (default) pins the chat to the viewport with an internally
      * scrolling transcript — the right feel for a dedicated `/explore` route.
      * `auto` lets the page grow, for embedding inside a longer page.
+     *
+     * `viewport` also means "this component IS the page": only in that mode does it take over
+     * `history.scrollRestoration` and correct a restored scroll offset that has parked the
+     * page in the site footer. An `auto` embed never touches its host page's scrolling.
      */
     heightMode?: "viewport" | "auto";
     /**
-     * Chrome to subtract in `viewport` mode — the site header (and footer)
-     * height. A number is treated as pixels. Default `0`.
+     * Chrome to subtract in `viewport` mode — the site header height. A number is treated as
+     * pixels. Default `0`.
+     *
+     * Pre-measurement fallback ONLY. Once mounted the pane measures its own top, so an
+     * approximate value is fine and the keyboard case is handled; see `measurePane` in
+     * `ExplorePage`.
      */
     viewportOffset?: string | number;
     /** SPA navigation for internal CTA paths. Falls back to a plain link. */

package/dist/components/explore.d.ts

@@ -23,11 +23,19 @@ interface ExplorePageProps {
      * `viewport` (default) pins the chat to the viewport with an internally
      * scrolling transcript — the right feel for a dedicated `/explore` route.
      * `auto` lets the page grow, for embedding inside a longer page.
+     *
+     * `viewport` also means "this component IS the page": only in that mode does it take over
+     * `history.scrollRestoration` and correct a restored scroll offset that has parked the
+     * page in the site footer. An `auto` embed never touches its host page's scrolling.
      */
     heightMode?: "viewport" | "auto";
     /**
-     * Chrome to subtract in `viewport` mode — the site header (and footer)
-     * height. A number is treated as pixels. Default `0`.
+     * Chrome to subtract in `viewport` mode — the site header height. A number is treated as
+     * pixels. Default `0`.
+     *
+     * Pre-measurement fallback ONLY. Once mounted the pane measures its own top, so an
+     * approximate value is fine and the keyboard case is handled; see `measurePane` in
+     * `ExplorePage`.
      */
     viewportOffset?: string | number;
     /** SPA navigation for internal CTA paths. Falls back to a plain link. */