changeset

Resolve a page link by its recorded path when its page is gone
A page or anchor ref whose page ID no longer exists now looks for a page at the path recorded on the ref, so a link keeps working after its target is deleted and re-created at the same path. The ID still wins while it exists, so moves and renames resolve as before. The API records the path on refs it writes; until @gitbook/api ships the field, it is read untyped. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Rt9YwdSUu7gHehYbEkvEJ8
2026-10-20 12:19:01 +00:00 · 2026-09-28 22:19:28 +01:00 · 2026-09-28 22:19:18 +01:00
189 changed files with 1182 additions and 3401 deletions
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix admin toolbar magnification, tooltip placement, title truncation and logo colour.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Stop the `?ask` query briefly appearing in the search field before an integration assistant opens.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Track which Ask AI entry point opened the chat in ask view analytics.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Recolor text over a background page cover in the first frame after hydration.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Update API
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix table of contents scrolling back to the current page when expanding another group.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Keep links working when their target page is deleted and re-created at the same path, by falling back to the path recorded on the link.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Automatically resolve GitHub and GitLab page links to matching pages in the same published site, including cross-space links imported before their target page was available.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Keep the docs embed open when switching section, variant or language.
@@ -1,6 +0,0 @@
---
-"@gitbook/embed": minor
-"gitbook": patch
---
-
-Add `defaultTab` and `defaultPage` options to the Docs Embed to choose where it opens. `defaultTab` opens the embed on the assistant, search or docs tab. `defaultPage` sets the page the docs tab opens on in place of the site's home page, and the embed opens on that page unless `defaultTab` says otherwise. Both work with the standalone script's `configure`, `frame.configure` and `<GitBookFrame>` props.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix page cover image jumping on load
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Use the DocumentTextColor type defined in API schema.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix low-contrast button labels inside success, warning and danger hints.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Agents can now send a goal with any question they ask on the Markdown version of a page.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix inline Ask AI inputs and buttons doing nothing before search is opened.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Track server-side Insights events (markdown, llms.txt, RSS, ask) with the site's public URL instead of the proxy URL.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Send the previous page's URL with site insights events so broken links can be traced to the page linking to them.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix Loom videos staying blank on pages with many Loom embeds by lazy-loading them.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Update Mermaid to 11.16.1 to match the editor, adding support for doughnut charts.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix Mermaid block diagrams falling back to a code block on published sites.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix long Mermaid labels being clipped instead of wrapping at some browser zoom levels.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Improve dark theme contrast for Mermaid edge labels.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Improve the prompt for agents to ask questions.
@@ -1,6 +0,0 @@
---
-"@gitbook/react-openapi": patch
-"gitbook": patch
---
-
-Fix OpenAPI schemas that reference themselves through a nullable union rendering forever when expanded, which crashed PDF exports.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Use the page's tag title, when set, for the HTML `<title>` of published pages.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix previewed customization and theme overrides being lost when navigating between pages inside the site preview. The preview cookie was scoped to the site's canonical base path instead of the preview route it is actually served under, so the browser dropped it on the next in-preview navigation.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Clarify the not-found page on sites with login-protected content: prompt anonymous visitors to log in, and tell logged-in visitors they may not have access.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Stop page group breadcrumbs from linking to a URL that redirects to the group's first page.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Scroll the table of contents to the active page after client-side navigation.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Site redirects whose source path has accented or non-Latin characters now redirect visitors instead of returning 404.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Show site UI in French or Spanish for spaces set to Canadian French, Mexican Spanish or Latin American Spanish.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Restore the Next.js dev-mode OOM patch that was silently dropped by the 16.3.8 upgrade.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Let search buttons open search limited to the current space.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Send the visitor country to resolvePublishedContentByUrl on dev, preview, staging and selected sites, using the forwarded `x-gitbook-country` header on revalidation requests.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Render a single Ask AI paragraph button that moves to the hovered paragraph, instead of one hidden button per paragraph.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the first item of a sidebar page group sometimes appearing cut off after navigating.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Skip rendering the Ask AI paragraph button inside table cells, where it is hidden, to keep pages with large tables within memory limits.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix 404 on Markdown pages (View as Markdown) in site previews and when a theme is forced with `?theme=`.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the admin toolbar insights button to link to the site's analytics page.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Point the "Powered by GitBook" trademark link to gitbook.com/powered-by.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Upgrade object-identity to preserve value types when caching object arguments.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Read the production hostnames that receive the visitor country from the `GITBOOK_VISITOR_COUNTRY_HOSTNAMES` build-time env variable.
@@ -1,6 +0,0 @@
---
-"@gitbook/react-contentkit": patch
-"gitbook": patch
---
-
-Reserve the webframe's size in the server-rendered layout so anchor links to content below integration blocks no longer land too high.
@@ -1,89 +1,113 @@
-# Contributing to GitBook
+# Welcome to GitBook's contributing guide!

-> _For help, support and product questions, head to our [GitHub Community](https://github.com/orgs/GitbookIO/discussions)._
+> _For help, support, feature requests, and product questions - head to our [GitHub Community](https://github.com/orgs/GitbookIO/discussions) 🤖_

-Thanks for helping make GitBook better. This repository holds the open source renderer behind every published GitBook site, and the team reads everything that comes in here.
+Thank you for investing your time in contributing to GitBook. Any contribution you make will be reviewed by our team. In this guide, you'll learn the different ways you can contribute.

-## Ways to contribute
+## Types of Contributions

-   **Open an issue.** Report a bug, suggest a feature, or tell us when something feels off. This is the most useful thing you can do.
-   **Join the conversation.** Share ideas and help others in [GitHub Community](https://github.com/orgs/GitbookIO/discussions).
-   **Build with GitBook.** Publish your docs, try new features early, and tell us what works and what doesn't.
+This repository contains code related to the rendering engine of GitBook's published content. Depending on what you'd like to contribute to, head to the section below to find the necessary steps.

-## Issues instead of pull requests
+### Add a feature

-Pull requests are limited to the GitBook team. If you've found a bug or want something to change, please [open an issue](https://github.com/GitbookIO/gitbook/issues/new/choose) instead.
+Because this portion of GitBook is open source and available for you to use - if you think you can provide extra value through a new feature - you're welcome to add it! If you plan to distribute the code, keep the source code public to comply with GNU GPLv3. To clone in a private repository, you must first acquire a [commercial license](https://www.gitbook.com/pricing).

-This isn't because we don't want your help. Every change here ships to every published GitBook site, so we need to own each one from start to finish. A clear issue often helps us more than a pull request: it tells us what's wrong and why, and lets us fix it in a way that fits the rest of the codebase.
+### Create a new issue

-A good issue includes:
+If you spot a problem within a repository, [search if an issue already exists](https://docs.github.com/en/github/searching-for-information-on-github/searching-on-github/searching-issues-and-pull-requests#search-by-the-title-body-or-comments). If a related issue doesn't exist, you can open a new issue here!Please make sure any added issues are

-   What you expected to happen, and what happened instead
-   A link to a published GitBook site that shows the problem, if you have one
-   Steps to reproduce it, plus screenshots or a recording for anything visual
-   Your browser and OS, if it looks like it might matter
+-   Descriptive
+-   Thoughtful
+-   Organized

-Before opening one, [search existing issues](https://github.com/GitbookIO/gitbook/issues). If someone has already reported it, add a 👍 or any extra details you have.
+We recommend adding as many relevant links, minimal reproductions of the issue, and other materials that will help our team solve the issue fast.

-Already fixed it in your fork? Link the branch or commit in your issue. We may open a pull request from it, and your commits keep your name.
+### Solve an issue

-If you open a pull request anyway, we'll close it and point you here. Nothing personal, and we'd still love the issue.
+If you're interested in solving an issue in our repository, start by scanning through it's exisiting issues to find one that you're interested in working on. If you find an issue to work on, you are welcome to open a PR with a fix. See the following sections below for more information on contributing for specific sections.

-## Reach out
+### Documentation

-Not sure if it's a bug? Have a half-formed idea? Open an issue or start a [discussion](https://github.com/orgs/GitbookIO/discussions) anyway. We'd much rather hear from you than not, and no report is too small.
+The official documentation on GitBook open can be found directly in this Readme. Any updates or changes you would like to make, you can make directly to the README of this repository.

-Spotted a wrong or missing translation? Open an issue with the string and the wording you'd suggest.
+## Contributing

-## Using AI
+### Make changes locally

-You're welcome to use AI to help you write an issue. Please read and check what it produces before you post: reports that are long, vague or unverified take time away from fixing real problems, and we may close them without a reply.
+Any contribution you make can be made to the code located in this repository. In order to contribute, you'll need to start off of a local version of this repository.

-## Running locally
+#### 1. Fork the repository

-You don't need a local setup to open an issue, but it can help you reproduce a problem or self-host the renderer.
+##### Using GitHub Desktop:

-### Prerequisites
+-   [Getting started with GitHub Desktop](https://docs.github.com/en/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop) will guide you through setting up Desktop.
+-   Once Desktop is set up, you can use it to [fork the repo](https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/cloning-and-forking-repositories-from-github-desktop)!

-   [Node.js](https://nodejs.org/en) (see "engines" in `package.json`)
-   [Bun](https://bun.sh/) (see "packageManager" in `package.json`)
+##### Using the command line:

-### Setup
+-   [Fork the repo](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo#fork-an-example-repository) so that you can make your changes without affecting the original project until you're ready to merge them.

-1. Use the project's version of Node:
+#### 2. Create a working branch and start with your changes

+After forking this repository, you'll want to [create a branch](https://docs.github.com/en/issues/tracking-your-work-with-issues/creating-a-branch-for-an-issue) to work off of.
+
+#### 3. Install dependencies and run the project locally
+
+##### Prerequisites:
+
+- [Node.js](https://nodejs.org/en) (see "engines" in `package.json`)
+- [Bun](https://bun.sh/) (see "packageManager" in `package.json`)
+
+##### Setup steps:
+
+1. Ensure you are using the project's version of Node:
 ```bash
 nvm use
 ```

-2. Install dependencies:
-
+2. Install dependencies using Bun:
 ```bash
 bun install
 ```

 3. Start the development server:
-
 ```bash
 bun dev
 ```

-Other commands:
+Additional development commands:
+- `bun lint`: Lint the code using Oxlint
+- `bun lint:fix`: Automatically fix lint issues using Oxlint
+- `bun format`: Format the code using Oxfmt
+- `bun format:check`: Check formatting without changing files
+- `bun typecheck`: Run TypeScript type checking
+- `bun unit`: Run unit tests
+- `bun e2e`: Run end-to-end tests

-   `bun lint`: Lint the code using Oxlint
-   `bun lint:fix`: Automatically fix lint issues using Oxlint
-   `bun format`: Format the code using Oxfmt
-   `bun format:check`: Check formatting without changing files
-   `bun typecheck`: Run TypeScript type checking
-   `bun unit`: Run unit tests
-   `bun e2e`: Run end-to-end tests
+#### 4. Preview your changes

-### Preview a site
+When running the development server, published GitBook sites can be rendered through your local version at `http://localhost:3000/url`.

-With the development server running, any published GitBook site can be rendered through your local version at `http://localhost:3000/url/<published-url>`. For example, visit `http://localhost:3000/url/gitbook.com/docs` to see our own docs.
+For example, our published docs can be viewed using the local version by visiting `http://localhost:3000/url/gitbook.com/docs` after running the development server.

-The site must be [published publicly](https://gitbook.com/docs/published-documentation/publish-your-content-as-a-docs-site) to render locally.
+You can visit any published GitBook site behind your development server. Please make sure your site is [published publicly](https://gitbook.com/docs/published-documentation/publish-your-content-as-a-docs-site) to ensure you can view the site correctly in your development version.

-## License
+### Commit your update

-The renderer is distributed under the [GNU GPLv3 License](https://github.com/GitbookIO/gitbook/blob/main/LICENSE). If you distribute the code, you must keep the source code public. To use it in a private repository, you need a [commercial license](https://www.gitbook.com/pricing).
+[Commit your changes](https://github.com/git-guides/git-commit) once you are happy with them. See [Atom's contributing guide](https://github.com/atom/atom/blob/master/CONTRIBUTING.md#git-commit-messages) to know how to use emoji for commit messages!
+
+Once your changes are ready, don't forget to self-review your code to double check that your chagnes are ready to be added.
+
+### Pull Request
+
+When you're finished with the changes, [create a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request), also known as a PR.
+
+-   Don't forget to [link PR to issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) if you are solving one.
+-   Enable the checkbox to [allow maintainer edits](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork) so the branch can be updated for a merge. Once you submit your PR, a GitBook team member will review your proposal. We may ask questions or request for additional information.
+-   We may ask for changes to be made before a PR can be merged, either using [suggested changes](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request) or pull request comments. You can apply suggested changes directly through the UI. You can make any other changes in your fork, then commit them to your branch.
+-   As you update your PR and apply changes, mark each conversation as [resolved](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#resolving-conversations).
+-   If you run into any merge issues, checkout this [git tutorial](https://lab.github.com/githubtraining/managing-merge-conflicts) to help you resolve merge conflicts and other issues.
+
+### Your PR is merged
+
+Congratulations 🎉 Thank you for your contribution! Once your PR is merged, your contributions will be publicly visible on the relevant repository.
@@ -78,11 +78,6 @@ runs:
              echo "GITBOOK_DISABLE_INSIGHTS=true" >> .vercel/.env.${{ inputs.environment }}.local
              echo "--- .vercel/.env.${{ inputs.environment }}.local after inject ---"
              cat .vercel/.env.${{ inputs.environment }}.local
-        - name: Inject visitor country hostnames
-          if: ${{ env.GITBOOK_VISITOR_COUNTRY_HOSTNAMES != '' }}
-          shell: bash
-          run: |
-              echo "GITBOOK_VISITOR_COUNTRY_HOSTNAMES=$GITBOOK_VISITOR_COUNTRY_HOSTNAMES" >> .vercel/.env.${{ inputs.environment }}.local
        - name: Inject staging build env vars
          if: ${{ inputs.environment == 'staging' }}
          shell: bash
@@ -1,15 +0,0 @@
-# Slack PR status
-
-[GitbookIO/slack-pr-status](https://github.com/GitbookIO/slack-pr-status) adds review-status reactions to PR links posted in [#engineering](https://gitbook.slack.com/archives/C01NXGWJELS). It runs from `.github/workflows/slack-pr-status.yml` in `GitbookIO/gitbook`, `GitbookIO/gitbook-x` and `GitbookIO/integrations`. Emojis and statuses are configured in that workflow; see the action's README for the options.
-
-Owner: Peter White.
-
-| Configuration | Value |
-| --- | --- |
-| Slack app | **PR Status** (`A0C2AGLAD0T`), created from `.github/slack-pr-status-app-manifest.json` |
-| Bot token | Repository Actions secret `SLAPR_SLACK_BOT_TOKEN` |
-| GitHub token | The workflow's `GITHUB_TOKEN`, read-only |
-
-Posts that link PRs from more than one repository are skipped, because each workflow's token can only read its own repository. PRs from forks get no reactions, because their workflows don't receive secrets.
-
-To disable it in one repository, run `gh workflow disable slack-pr-status.yml --repo GitbookIO/<repository>`. To stop it everywhere, revoke the PR Status app's token.
@@ -0,0 +1,88 @@
+# Slack PR reactions
+
+[DataDog/slapr](https://github.com/DataDog/slapr) updates reactions on existing PR-link messages in [#engineering](https://gitbook.slack.com/archives/C01NXGWJELS). It runs in GitHub Actions. It does not post messages, approve or merge PRs, or change branch protection.
+
+## Rollout and ownership
+
+Owner: Peter White.
+
+The rollout targets `GitbookIO/gitbook` (GBO), `GitbookIO/gitbook-x` (GBX), and `GitbookIO/integrations`. Each repository contains `.github/workflows/slapr.yml` and this runbook.
+
+| Configuration | Value |
+| --- | --- |
+| Channel | `#engineering`, `C01NXGWJELS` |
+| App manifest | `.github/slapr-app-manifest.json` |
+| Slack app ID | `A0C2AGLAD0T` |
+| Bot user ID | `U0C2AGP16R1`, repository variable `SLAPR_BOT_USER_ID` |
+| Bot token | Repository Actions secret `SLAPR_SLACK_BOT_TOKEN` |
+| Action | `DataDog/slapr@1c074e1dfd433f91a679d5113f7f8b956b65d973` |
+| Approval threshold | Stock default, one approval |
+| Events | `pull_request_review: submitted`, `pull_request: closed` |
+
+## Install and configure
+
+1. In [Slack app management](https://api.slack.com/apps), create the **PR Status** app from `.github/slapr-app-manifest.json` in the GitBook workspace. Obtain workspace approval if required, then install it. The bot requests Slapr's documented `channels:history`, `reactions:read`, and `reactions:write` scopes. `#engineering` is public, so `groups:history` is unnecessary. No review map is configured, so `channels:read` is unnecessary.
+2. Invite **PR Status** only to `#engineering`. Keep it dedicated to Slapr: stock Slapr removes obsolete reactions belonging to this bot on a matched message. It leaves other users' reactions alone.
+3. Record the app ID and bot user ID above. The bot profile's member ID or Slack `auth.test` response's `user_id` is the required bot user ID, not the app ID or bot ID.
+4. Store the bot OAuth token as `SLAPR_SLACK_BOT_TOKEN` in each of the three repositories' Actions secrets. Use the GitHub secret UI or `gh secret set SLAPR_SLACK_BOT_TOKEN --repo GitbookIO/<repository>` and its hidden prompt. Never paste the token into a command argument, chat, workflow, or committed file. Alternatively, an organization secret must use selected-repository visibility limited to these three repositories.
+5. Set Actions variable `SLAPR_BOT_USER_ID` in each repository to that bot's user ID. The token and user ID must belong to the same installation. Use `gh variable set SLAPR_BOT_USER_ID --repo GitbookIO/<repository> --body '<user-id>'` or the GitHub UI.
+6. Merge the workflows through normal review, then run the live checks below. Repository maintainers handle reviews and merges; Slapr has only read access to GitHub contents and pull requests.
+
+GBX runs this workflow on `blacksmith-2vcpu-ubuntu-2404`. GBO and integrations use `ubuntu-latest`, matching their existing workflows.
+
+The workflow hardcodes the engineering channel and does not check out PR code. It uses the stock event triggers and leaves the approval threshold unset. There are no listeners, schedules, review maps, custom discovery, or additional services.
+
+## Reactions
+
+Slapr's status selection stays unchanged. Missing custom emoji names are mapped through the action's supported inputs to existing equivalents. Workspace lookup on 2026-09-17 confirmed `pr-approved` and `merged`; the other mappings are standard Slack emojis.
+
+| Stock status | Reaction |
+| --- | --- |
+| Review started | `:eyes:` |
+| Partially approved | `:next_track_button:` |
+| Approved | `:pr-approved:` |
+| Changes requested | `:construction:` |
+| Merged | `:merged:` |
+| Closed without merging | `:no_entry_sign:` |
+| Comment-only review | `:speech_balloon:` |
+
+The partially-approved reaction is configured but cannot occur with the default threshold of one approval. It becomes relevant only if that threshold is raised.
+
+On approval, expect review-started and approved reactions. On merge, stock Slapr removes review-started and adds merged; it can retain approved alongside merged. Approval and merging have distinct reactions. Other stock review-state behavior is accepted.
+
+## Live acceptance test
+
+For each repository after credentials are configured and the workflow is on the default branch:
+
+1. Open a fresh same-repository test PR through normal review. Post its full `https://github.com/GitbookIO/<repository>/pull/<number>` link as a new top-level message in `#engineering` before the review event.
+2. Have another contributor approve it. Open the **Slack PR reactions** Actions run and verify that the matched message has the bot's `pr-approved` reaction.
+3. Have an authorized maintainer merge it. Verify the closed-event run succeeds and the same message has the bot's `merged` reaction. No new Slack status message should appear.
+4. Record the PR URL, Slack message permalink, approval/merge workflow run URLs, date, and result below. A green workflow alone does not prove the message was found or reacted to.
+
+| Repository | PR and Slack message | Approval run/result | Merge run/result |
+| --- | --- | --- | --- |
+| GitbookIO/gitbook | Pending | Not tested | Not tested |
+| GitbookIO/gitbook-x | Pending | Not tested | Not tested |
+| GitbookIO/integrations | Pending | Not tested | Not tested |
+
+Only the first matching message in Slapr's recent-history response is updated. Older messages, thread replies, duplicate posts, fork PRs, and links posted after the event are outside this rollout's acceptance criteria. Slapr does not paginate history or reconcile missed events.
+
+## Troubleshoot and disable
+
+- No workflow run: confirm the workflow is merged, Actions permits the pinned action, and the event was a submitted review or PR closure. These are the only configured triggers.
+- `No message found requesting review`: confirm the full PR link was posted as a recent top-level message in `#engineering` before the event. This is a successful no-op in stock Slapr.
+- `not_in_channel` or `channel_not_found`: check the app installation, channel ID, and bot membership in `#engineering`.
+- `missing_scope`: compare the installed bot scopes with the manifest and reinstall after changes.
+- `invalid_auth` or `account_inactive`: replace the repository secrets with the current bot token. If the bot identity changed, update `SLAPR_BOT_USER_ID` too.
+- `invalid_name`: check the emoji mappings still exist. If a custom emoji was removed, map that input to another existing emoji, keeping approval and merged distinct.
+- Old reactions remain or removal fails: confirm `SLAPR_BOT_USER_ID` is the member ID for the token's bot.
+- GitHub permission errors: keep `contents: read` and `pull-requests: read`; do not introduce a PAT, write permissions, or `pull_request_target` to cover forks. Fork and Dependabot secret restrictions are accepted limitations.
+- Rate limits or transient API failures: inspect the Actions log and retry the failed run after the limit resets. There is no scheduled reconciliation.
+
+Disable one repository with `gh workflow disable slapr.yml --repo GitbookIO/<repository>`, or disable **Slack PR reactions** in its Actions UI. Repeat for all three to stop the integration. Revoke the Slack app token to stop its access immediately, remove its repository secrets, and remove the bot from `#engineering` when retiring it. Existing reactions remain.
+
+## Pin review
+
+On 2026-09-17, the pinned action definition, Dockerfile, entry point, dependency declarations, GitHub reads, Slack history lookup and reaction writes were inspected. Without `review-map`, the action targets only the supplied channel. It reads PR/review state and adds/removes reactions; it does not post Slack messages or write to GitHub.
+
+The action SHA pins Slapr's source. Its upstream Dockerfile still uses the mutable `python:3.14` image and installs dependencies, including `pyyaml>=5.0`, at build time. This rollout keeps stock Slapr unchanged. Review upstream source and dependency changes before updating the SHA in all three repositories.
@@ -10,8 +10,6 @@ jobs:
        environment:
            name: 2v-production
            url: ${{ steps.deploy.outputs.deployment-url }}
-        env:
-            GITBOOK_VISITOR_COUNTRY_HOSTNAMES: ${{ vars.GITBOOK_VISITOR_COUNTRY_HOSTNAMES }}
        outputs:
            deployment-url: ${{ steps.deploy.outputs.deployment-url }}
        steps:
@@ -33,8 +31,6 @@ jobs:
        environment:
            name: 2c-production
            url: ${{ steps.deploy.outputs.deployment-url }}
-        env:
-            GITBOOK_VISITOR_COUNTRY_HOSTNAMES: ${{ vars.GITBOOK_VISITOR_COUNTRY_HOSTNAMES }}
        outputs:
            deployment-url: ${{ steps.deploy.outputs.deployment-url }}
        steps:
@@ -1,33 +0,0 @@
-name: Slack PR status
-
-on:
-    pull_request_review:
-        types: [submitted, dismissed]
-    pull_request:
-        types: [closed, reopened]
-
-permissions:
-    contents: read
-    pull-requests: read
-
-jobs:
-    slack-pr-status:
-        # Secrets aren't available to workflows triggered from forks.
-        if: github.event.pull_request.head.repo.full_name == github.repository
-        runs-on: ubuntu-latest
-        steps:
-            - uses: GitbookIO/slack-pr-status@main
-              with:
-                  slack-token: ${{ secrets.SLAPR_SLACK_BOT_TOKEN }}
-                  config: |
-                      channels: [C01NXGWJELS]
-                      approvalsRequired: 1
-                      multiPr: aggregate
-                      emojis:
-                          commented: false
-                          partiallyApproved: next_track_button
-                          approved: pr-approved
-                          changesRequested: construction
-                          merged: merged
-                          closed: no_entry_sign
-                          partiallyReviewed: hourglass_flowing_sand
@@ -0,0 +1,30 @@
+name: Slack PR reactions
+
+on:
+    pull_request_review:
+        types: [submitted]
+    pull_request:
+        types: [closed]
+
+permissions:
+    contents: read
+    pull-requests: read
+
+jobs:
+    run_slapr:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Update PR reactions in engineering
+              uses: DataDog/slapr@1c074e1dfd433f91a679d5113f7f8b956b65d973
+              with:
+                  github-token: ${{ secrets.GITHUB_TOKEN }}
+                  slack-api-token: ${{ secrets.SLAPR_SLACK_BOT_TOKEN }}
+                  slack-channel-id: C01NXGWJELS
+                  bot-user-id: ${{ vars.SLAPR_BOT_USER_ID }}
+                  emoji-review-started: eyes
+                  emoji-partially-approved: next_track_button
+                  emoji-approved: pr-approved
+                  emoji-changes-requested: construction
+                  emoji-merged: merged
+                  emoji-closed: no_entry_sign
+                  emoji-commented: speech_balloon
@@ -85,7 +85,7 @@ GitBook Open uses fontawesome. For self-hosting and local development, for licen

 ## Contributing

-GitBook's rendering engine is fully open source and built on top of [Next.js](https://nextjs.org/). Head to our [contributing guide](https://github.com/GitbookIO/gitbook/blob/main/.github/CONTRIBUTING.md) to learn how to report bugs and suggest changes.
+GitBook's rendering engine is fully open source and built on top of [Next.js](https://nextjs.org/). Head to our [contributing guide](https://github.com/GitbookIO/gitbook/blob/main/.github/CONTRIBUTING.md) to learn more about the workflow on adding your first Pull Request.

 ### Types of contributions

@@ -93,22 +93,22 @@ We encourage you to contribute to GitBook to help us build the best tool for doc

 #### Translations

-The GitBook UI is rendered using a set of translation files found in [`packages/gitbook/src/intl/translations`](/packages/gitbook/src/intl/translations/). Spotted a wrong or missing translation? Open an issue and let us know.
+The GitBook UI is rendered using a set of translation files found in [`packages/gitbook/src/intl/translations`](/packages/gitbook/src/intl/translations/). We welcome all additional translations for the UI.

 #### Bugs

-Encounter a bug? [Open an issue](https://github.com/GitbookIO/gitbook/issues/new/choose) with as much detail as you can. Clear reports help us fix things faster for everyone.
+Encounter a bug or find an issue you'd like to fix? Helping us fix issues related to GitBook greatly improves the experience for everyone. Head to the issues section of this repository to learn more about the types of bugs you can already help out with.

 ## Deployment

 > [!WARNING]  
 > While it is possible to self-host this project, we do not recommend this unless you are certain this option fits your need.
 >
-> _Looking for a specific feature in GitBook? Head to our [contributing guide](https://github.com/GitbookIO/gitbook/blob/main/.github/CONTRIBUTING.md) to suggest it._
+> _Looking to add a specific feature in GitBook? Head to our [contributing guide](https://github.com/GitbookIO/gitbook/blob/main/.github/CONTRIBUTING.md) to get started._
 >
 > Self-hosting this project puts the responsibility of maintaining and merging future updates on **you**. We cannot guarantee support, maintenance, or updates to forked and self-hosted instances of this project.
 >
-> We want to make it as easy as possible for our community to collaborate and push the future of GitBook, which is why we encourage you to share your ideas with us instead of creating your own version.
+> We want to make it as easy as possible for our community to collaborate and push the future of GitBook, which is why we encourage you to contribute to our product directly instead of creating your own version.

 This project allows you to self-host the rendering portion of your GitBook published content. Self-hosting has pros and cons.

@@ -129,8 +129,8 @@
        "@gitbook/react-openapi": "workspace:*",
        "@mermaid-js/mermaid-zenuml": "^0.2.2",
        "@modelcontextprotocol/sdk": "1.17.5",
-        "@opennextjs/aws": "4.1.7",
-        "@opennextjs/cloudflare": "1.20.8",
+        "@opennextjs/aws": "4.1.3",
+        "@opennextjs/cloudflare": "1.20.5",
        "@panzoom/panzoom": "^4.6.1",
        "@sindresorhus/fnv1a": "^3.1.0",
        "@tailwindcss/container-queries": "^0.1.1",
@@ -155,16 +155,16 @@
        "mdast-util-gfm": "^3.1.0",
        "mdast-util-to-markdown": "^2.1.2",
        "memoizee": "^0.4.17",
-        "mermaid": "11.16.1",
+        "mermaid": "^11.14.0",
        "micromark-extension-frontmatter": "^2.0.0",
        "micromark-extension-gfm": "^3.0.0",
        "motion": "^12.23.24",
        "negotiator": "^1.0.0",
-        "next": "^16.3.8",
+        "next": "^16.3.6",
        "next-themes": "^0.4.6",
        "nuqs": "^2.2.3",
        "object-hash": "^3.0.0",
-        "object-identity": "^0.2.1",
+        "object-identity": "^0.1.2",
        "openapi-types": "^12.1.3",
        "p-map": "^7.0.3",
        "p-retry": "^8.0.0",
@@ -342,11 +342,11 @@
  },
  "patchedDependencies": {
    "decode-named-character-reference@1.0.2": "patches/decode-named-character-reference@1.0.2.patch",
-    "next@16.3.8": "patches/next@16.3.8.patch",
-    "mermaid@11.16.1": "patches/mermaid@11.16.1.patch",
+    "next@16.3.6": "patches/next@16.3.6.patch",
  },
  "overrides": {
    "@codemirror/state": "6.4.1",
+    "@opennextjs/aws": "4.1.5",
    "@types/react": "catalog:",
    "@types/react-dom": "catalog:",
    "axios": "1.8.4",
@@ -356,7 +356,7 @@
  },
  "catalog": {
    "@base-ui/react": "^1.7.0",
-    "@gitbook/api": "0.206.0",
+    "@gitbook/api": "0.202.0",
    "@scalar/api-client-react": "^1.3.46",
    "@tsconfig/node20": "^20.1.6",
    "@tsconfig/strictest": "^2.0.6",
@@ -572,7 +572,15 @@

    "@changesets/write": ["@changesets/write@0.4.0", "", { "dependencies": { "@changesets/types": "^6.1.0", "fs-extra": "^7.0.1", "human-id": "^4.1.1", "prettier": "^2.7.1" } }, "sha512-CdTLvIOPiCNuH71pyDu3rA+Q0n65cmAbXnwWH84rKGiFumFzkmHNT8KHTMEchcxN+Kl8I54xGUhJ7l3E7X396Q=="],

-    "@chevrotain/types": ["@chevrotain/types@11.1.2", "", {}, "sha512-U+HFai5+zmJCkK86QsaJtoITlboZHBqrVketcO2ROv865xfCMSFpELQoz1GkX5GzME8pTa+3kbKrZHQtI0gdbw=="],
+    "@chevrotain/cst-dts-gen": ["@chevrotain/cst-dts-gen@11.1.1", "", { "dependencies": { "@chevrotain/gast": "11.1.1", "@chevrotain/types": "11.1.1", "lodash-es": "4.17.23" } }, "sha512-fRHyv6/f542qQqiRGalrfJl/evD39mAvbJLCekPazhiextEatq1Jx1K/i9gSd5NNO0ds03ek0Cbo/4uVKmOBcw=="],
+
+    "@chevrotain/gast": ["@chevrotain/gast@11.1.1", "", { "dependencies": { "@chevrotain/types": "11.1.1", "lodash-es": "4.17.23" } }, "sha512-Ko/5vPEYy1vn5CbCjjvnSO4U7GgxyGm+dfUZZJIWTlQFkXkyym0jFYrWEU10hyCjrA7rQtiHtBr0EaZqvHFZvg=="],
+
+    "@chevrotain/regexp-to-ast": ["@chevrotain/regexp-to-ast@11.1.1", "", {}, "sha512-ctRw1OKSXkOrR8VTvOxrQ5USEc4sNrfwXHa1NuTcR7wre4YbjPcKw+82C2uylg/TEwFRgwLmbhlln4qkmDyteg=="],
+
+    "@chevrotain/types": ["@chevrotain/types@11.1.1", "", {}, "sha512-wb2ToxG8LkgPYnKe9FH8oGn3TMCBdnwiuNC5l5y+CtlaVRbCytU0kbVsk6CGrqTL4ZN4ksJa0TXOYbxpbthtqw=="],
+
+    "@chevrotain/utils": ["@chevrotain/utils@11.1.1", "", {}, "sha512-71eTYMzYXYSFPrbg/ZwftSaSDld7UYlS8OQa3lNnn9jzNtpFbaReRRyghzqS7rI3CDaorqpPJJcXGHK+FE1TVQ=="],

    "@cloudflare/kv-asset-handler": ["@cloudflare/kv-asset-handler@0.4.2", "", {}, "sha512-SIOD2DxrRRwQ+jgzlXCqoEFiKOFqaPjhnNTGKXSRLvp1HiOvapLaFG2kEr9dYQTYe8rKrd9uvDUzmAITeNyaHQ=="],

@@ -720,7 +728,7 @@

    "@fortawesome/fontawesome-svg-core": ["@fortawesome/fontawesome-svg-core@7.2.0", "", { "dependencies": { "@fortawesome/fontawesome-common-types": "7.2.0" } }, "sha512-6639htZMjEkwskf3J+e6/iar+4cTNM9qhoWuRfj9F3eJD6r7iCzV1SWnQr2Mdv0QT0suuqU8BoJCZUyCtP9R4Q=="],

-    "@gitbook/api": ["@gitbook/api@0.206.0", "", { "dependencies": { "event-iterator": "^2.0.0", "eventsource-parser": "^3.0.0" } }, "sha512-ctgnDSQ26ZeZvdU/Zb1xxU97yMquKnhGiA0QblAIzKUmfi/3aYmWYHAwXwvEg0wtBrEtrjzme9pXgX/ACWnANA=="],
+    "@gitbook/api": ["@gitbook/api@0.202.0", "", { "dependencies": { "event-iterator": "^2.0.0", "eventsource-parser": "^3.0.0" } }, "sha512-qhrjEQbNNmCljR0AgP79+BsVh9yelh9TIBg9X3TyYx5a3lJwDiT3sw1ND9DFQSxGHp8hH5w+20KJHn/IDpTbaw=="],

    "@gitbook/browser-types": ["@gitbook/browser-types@workspace:packages/browser-types"],

@@ -878,29 +886,29 @@

    "@mermaid-js/mermaid-zenuml": ["@mermaid-js/mermaid-zenuml@0.2.2", "", { "dependencies": { "@zenuml/core": "^3.35.2" }, "peerDependencies": { "mermaid": "^10 || ^11" } }, "sha512-sUjwk4NWUpy9uaHypYSIGJDks10ZaZo5CHH9lx9xcmyqv9w7yvd4vecUmlUQxmlHStYO+aqSkYKX5/gFjDfypw=="],

-    "@mermaid-js/parser": ["@mermaid-js/parser@1.2.1", "", { "dependencies": { "@chevrotain/types": "~11.1.2" } }, "sha512-n12NohV3mrUyUL2o93IgG/ifeW9FTyeJn3zDxkhwa8MJ9Fxg3HQMlA3RiGmD/3UnJvheztkjjQAjA2T4LmUcpw=="],
+    "@mermaid-js/parser": ["@mermaid-js/parser@1.1.0", "", { "dependencies": { "langium": "^4.0.0" } }, "sha512-gxK9ZX2+Fex5zu8LhRQoMeMPEHbc73UKZ0FQ54YrQtUxE1VVhMwzeNtKRPAu5aXks4FasbMe4xB4bWrmq6Jlxw=="],

    "@modelcontextprotocol/sdk": ["@modelcontextprotocol/sdk@1.17.5", "", { "dependencies": { "ajv": "^6.12.6", "content-type": "^1.0.5", "cors": "^2.8.5", "cross-spawn": "^7.0.5", "eventsource": "^3.0.2", "eventsource-parser": "^3.0.0", "express": "^5.0.1", "express-rate-limit": "^7.5.0", "pkce-challenge": "^5.0.0", "raw-body": "^3.0.0", "zod": "^3.23.8", "zod-to-json-schema": "^3.24.1" } }, "sha512-QakrKIGniGuRVfWBdMsDea/dx1PNE739QJ7gCM41s9q+qaCYTHCdsIBXQVVXry3mfWAiaM9kT22Hyz53Uw8mfg=="],

    "@napi-rs/wasm-runtime": ["@napi-rs/wasm-runtime@1.0.6", "", { "dependencies": { "@emnapi/core": "^1.5.0", "@emnapi/runtime": "^1.5.0", "@tybys/wasm-util": "^0.10.1" } }, "sha512-DXj75ewm11LIWUk198QSKUTxjyRjsBwk09MuMk5DGK+GDUtyPhhEHOGP/Xwwj3DjQXXkivoBirmOnKrLfc0+9g=="],

-    "@next/env": ["@next/env@16.3.8", "", {}, "sha512-Al9zqHVV7TJv0eFuOU4U7Lvv74PTih4Ch63sk2xCIpSTkE3udFnaOcnzP2lQVymiL7yS9Cj2iClUXlR3EQ5sEw=="],
+    "@next/env": ["@next/env@16.3.6", "", {}, "sha512-x9Vblze1EbtltQYnNH38xCPWU3TVfBd1eXqA3+w9+BTpedkkdNpAaltXlGQ/nsc1+E0mVTNrtcbX3GoO09zeLQ=="],

-    "@next/swc-darwin-arm64": ["@next/swc-darwin-arm64@16.3.8", "", { "os": "darwin", "cpu": "arm64" }, "sha512-2JPRMh2nmQG5CiL7cXGL9AGwnPWJQ//cTtAUCT+w511QHk79SYz3LGv/pc5X643B/WEO0rvu3Yww0hqwt3kgeA=="],
+    "@next/swc-darwin-arm64": ["@next/swc-darwin-arm64@16.3.6", "", { "os": "darwin", "cpu": "arm64" }, "sha512-E/7GEqaUkt8mk/T8v9lAnrhzR06kdq1ZBkC12F8tAMkdIadwNp3H1KqHynDHrpcTlGCUdq/qu6vUL2aYVyYBdw=="],

-    "@next/swc-darwin-x64": ["@next/swc-darwin-x64@16.3.8", "", { "os": "darwin", "cpu": "x64" }, "sha512-GZtCCOBKJ4leVIT/Th0llWKhD1ca92lzbQiS5R5ON9QkoiFnilFsebDae1JU2a3HWoKMEmEZWGs1AGLavVM72Q=="],
+    "@next/swc-darwin-x64": ["@next/swc-darwin-x64@16.3.6", "", { "os": "darwin", "cpu": "x64" }, "sha512-yBE893/nDWTlaiBD1p+qgt7NUen4U5R6FXyH0s67Npq1S3E0cVSef1WIXC2xBRgQvwAvJq6DnS6Y6PrY0cy4Ew=="],

-    "@next/swc-linux-arm64-gnu": ["@next/swc-linux-arm64-gnu@16.3.8", "", { "os": "linux", "cpu": "arm64" }, "sha512-O659ygeQYqneJ1fBKMpFxIFqYkYswu8IAS1OCKK/4f3ZgJJm1dRz4fVJZRi/kLLWjnBKnebOePA4WNv+sV1pVA=="],
+    "@next/swc-linux-arm64-gnu": ["@next/swc-linux-arm64-gnu@16.3.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-KJDpjBqBPYlvkivmyrp+Qys6k/7ksbqGQvRVc6ZEGfR+cjQxx+nUkJaWmNZJsmoOrqYNbaXByF8wa0lBwDhB3Q=="],

-    "@next/swc-linux-arm64-musl": ["@next/swc-linux-arm64-musl@16.3.8", "", { "os": "linux", "cpu": "arm64" }, "sha512-dSjKSyWpzxoO1d3DIZZcP4XJcNaKeLmxQMFOiYl5vuBRMmweIqnAhty8tAmRsvTss779cK1FtYnDMj40e4TQlg=="],
+    "@next/swc-linux-arm64-musl": ["@next/swc-linux-arm64-musl@16.3.6", "", { "os": "linux", "cpu": "arm64" }, "sha512-mqNg2K+hvWskSRb/QM+Ix412DvBsuSF0XV+frTSw5vmoucNnIlynFwKYew8D01bfATErMOM7Bujrf0BA5DRKFA=="],

-    "@next/swc-linux-x64-gnu": ["@next/swc-linux-x64-gnu@16.3.8", "", { "os": "linux", "cpu": "x64" }, "sha512-lbqOuz3RPRcv+o9msNsJw5x4+Y1ZwPTs6vmL6DCf7i0fZfvng/F59wyeDwqHIvV0mK//RBy/jJkZ+nCKsSMXjQ=="],
+    "@next/swc-linux-x64-gnu": ["@next/swc-linux-x64-gnu@16.3.6", "", { "os": "linux", "cpu": "x64" }, "sha512-nFncBNGAYouRHjRVaITs9beZRfhX4ssVwpnvPIAbkZVH6LtGoAVlH4bJ8Cnf9SOo9bsXgPFer/GdHtEE3JNOkw=="],

-    "@next/swc-linux-x64-musl": ["@next/swc-linux-x64-musl@16.3.8", "", { "os": "linux", "cpu": "x64" }, "sha512-+316WswI8ScVgZeUd+1KGaXkHhaYQzCjvH/05TZSpJ8zBizb1a4G7DtO7F12jcBIqMOtsz9ji1t48fmKtzqsGA=="],
+    "@next/swc-linux-x64-musl": ["@next/swc-linux-x64-musl@16.3.6", "", { "os": "linux", "cpu": "x64" }, "sha512-5Mf3cHDGR/Iz0ng2Bj3zUR3p5QS9YK3Hn2QiAfavFmyF48zwThAjpFoiTKNIcOHLYS4zEk+gzyJ/9deQ2ZB8yQ=="],

-    "@next/swc-win32-arm64-msvc": ["@next/swc-win32-arm64-msvc@16.3.8", "", { "os": "win32", "cpu": "arm64" }, "sha512-ji0gd4kMYUxO+1fJBIbiBVRCjzG/lloiyCccnlebvb1ZJ5qXCPZqYg4Jl1DrrixnWNMKylzgpmMWx0yNDYXlzw=="],
+    "@next/swc-win32-arm64-msvc": ["@next/swc-win32-arm64-msvc@16.3.6", "", { "os": "win32", "cpu": "arm64" }, "sha512-0jkJy0C2kbrJWTk4YLa3xk80pVBpx8FCHJym7CnUfDAXe/FWv5qT7SQJbR0KuemyxaEDlEx5WT4VQJoTW+/9Qw=="],

-    "@next/swc-win32-x64-msvc": ["@next/swc-win32-x64-msvc@16.3.8", "", { "os": "win32", "cpu": "x64" }, "sha512-WcTlaKt/TWkh5kUjdJcUmB1XgZ+1c6fz4Y9fDHL73YNSdGaUWjceeWrrlwF0nv19iABYWC4iAq1oX1w4Bn0vfg=="],
+    "@next/swc-win32-x64-msvc": ["@next/swc-win32-x64-msvc@16.3.6", "", { "os": "win32", "cpu": "x64" }, "sha512-/YXjI1e5OXcZ7YpxRwgP/1jAV/SBKTzeVKqN2mk7mLpcICsyn3Gl5+dIfDTJp70M0ccMhyMMRso4v6mPDCGepg=="],

    "@noble/ciphers": ["@noble/ciphers@1.2.1", "", {}, "sha512-rONPWMC7PeExE077uLE4oqWrZ1IvAfz3oH9LibVAcVCopJiA9R62uavnbEzdkVmJYI6M6Zgkbeb07+tWjlq2XA=="],

@@ -936,9 +944,9 @@

    "@octokit/types": ["@octokit/types@14.1.0", "", { "dependencies": { "@octokit/openapi-types": "^25.1.0" } }, "sha512-1y6DgTy8Jomcpu33N+p5w58l6xyt55Ar2I91RPiIA0xCJBXyUAhXCcmZaDWSANiha7R9a6qJJ2CRomGPZ6f46g=="],

-    "@opennextjs/aws": ["@opennextjs/aws@4.1.7", "", { "dependencies": { "@ast-grep/napi": "^0.40.5", "@aws-sdk/client-cloudfront": "3.984.0", "@aws-sdk/client-dynamodb": "3.984.0", "@aws-sdk/client-lambda": "3.984.0", "@aws-sdk/client-s3": "3.984.0", "@aws-sdk/client-sqs": "3.984.0", "@node-minify/core": "^8.0.6", "@node-minify/terser": "^8.0.6", "@tsconfig/node18": "^1.0.3", "aws4fetch": "^1.0.20", "chalk": "^5.6.2", "cookie": "^1.0.2", "esbuild": "0.25.4", "express": "^5.1.0", "path-to-regexp": "^6.3.0", "urlpattern-polyfill": "^10.1.0", "yaml": "^2.8.1" }, "peerDependencies": { "next": ">=15.5.27 <16 || >=16.3.8" }, "bin": { "open-next": "dist/index.js" } }, "sha512-ELezSARrTfxp/76cz41eQjki1AV0CuBUKOznU3w/tOk7i87x867RkkYho+gDkog9gpnGzefHdJu463o9VaabNQ=="],
+    "@opennextjs/aws": ["@opennextjs/aws@4.1.5", "", { "dependencies": { "@ast-grep/napi": "^0.40.5", "@aws-sdk/client-cloudfront": "3.984.0", "@aws-sdk/client-dynamodb": "3.984.0", "@aws-sdk/client-lambda": "3.984.0", "@aws-sdk/client-s3": "3.984.0", "@aws-sdk/client-sqs": "3.984.0", "@node-minify/core": "^8.0.6", "@node-minify/terser": "^8.0.6", "@tsconfig/node18": "^1.0.3", "aws4fetch": "^1.0.20", "chalk": "^5.6.2", "cookie": "^1.0.2", "esbuild": "0.25.4", "express": "^5.1.0", "path-to-regexp": "^6.3.0", "urlpattern-polyfill": "^10.1.0", "yaml": "^2.8.1" }, "peerDependencies": { "next": ">=15.5.24 <16 || >=16.3.3" }, "bin": { "open-next": "dist/index.js" } }, "sha512-41LNGtS5R5SCfn9zFxHx9QKJIRnmf1uZH+jonHkUMlRKER0bSmUSGjK6GJF7e50XdLXFpTHzaqgRvGmzvr9Btw=="],

-    "@opennextjs/cloudflare": ["@opennextjs/cloudflare@1.20.8", "", { "dependencies": { "@ast-grep/napi": "^0.40.5", "@dotenvx/dotenvx": "1.31.0", "@opennextjs/aws": "4.1.7", "ci-info": "^4.2.0", "cloudflare": "^4.4.1", "comment-json": "^4.5.1", "enquirer": "^2.4.1", "glob": "^12.0.0", "ts-tqdm": "^0.8.6", "yargs": "^18.0.0" }, "peerDependencies": { "next": ">=15.5.27 <16 || >=16.3.8", "rclone.js": "^0.6.6", "wrangler": "^4.125.0" }, "optionalPeers": ["rclone.js"], "bin": { "opennextjs-cloudflare": "dist/cli/index.js" } }, "sha512-7rrsBqd234GBBnHITobS0gagT4/fSfHJwm+ogYTyUb7ubg3PGC06biJgL9l4DZabFeu/ucqvml80sBr5torBgg=="],
+    "@opennextjs/cloudflare": ["@opennextjs/cloudflare@1.20.5", "", { "dependencies": { "@ast-grep/napi": "^0.40.5", "@dotenvx/dotenvx": "1.31.0", "@opennextjs/aws": "4.1.3", "ci-info": "^4.2.0", "cloudflare": "^4.4.1", "comment-json": "^4.5.1", "enquirer": "^2.4.1", "glob": "^12.0.0", "ts-tqdm": "^0.8.6", "yargs": "^18.0.0" }, "peerDependencies": { "next": ">=15.5.24 <16 || >=16.3.3", "rclone.js": "^0.6.6", "wrangler": "^4.125.0" }, "optionalPeers": ["rclone.js"], "bin": { "opennextjs-cloudflare": "dist/cli/index.js" } }, "sha512-Y4qCnHTYMa8waEHvf7iqDJuiresuREp0zithSZ8hT33Wn9WyvOUMBM0SWNH961Wv7ynHRdxAJ0ggmnQ3aSdzdg=="],

    "@opentelemetry/api": ["@opentelemetry/api@1.9.0", "", {}, "sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg=="],

@@ -1744,6 +1752,10 @@

    "chardet": ["chardet@2.1.0", "", {}, "sha512-bNFETTG/pM5ryzQ9Ad0lJOTa6HWD/YsScAR3EnCPZRPlQh77JocYktSHOUHelyhm8IARL+o4c4F1bP5KVOjiRA=="],

+    "chevrotain": ["chevrotain@11.1.1", "", { "dependencies": { "@chevrotain/cst-dts-gen": "11.1.1", "@chevrotain/gast": "11.1.1", "@chevrotain/regexp-to-ast": "11.1.1", "@chevrotain/types": "11.1.1", "@chevrotain/utils": "11.1.1", "lodash-es": "4.17.23" } }, "sha512-f0yv5CPKaFxfsPTBzX7vGuim4oIC1/gcS7LUGdBSwl2dU6+FON6LVUksdOo1qJjoUvXNn45urgh8C+0a24pACQ=="],
+
+    "chevrotain-allstar": ["chevrotain-allstar@0.3.1", "", { "dependencies": { "lodash-es": "^4.17.21" }, "peerDependencies": { "chevrotain": "^11.0.0" } }, "sha512-b7g+y9A0v4mxCW1qUhf3BSVPg+/NvGErk/dOkrDaHA0nQIQGAtrOjlX//9OQtRlSCy+x9rfB5N8yC71lH1nvMw=="],
+
    "chokidar": ["chokidar@4.0.0", "", { "dependencies": { "readdirp": "^4.0.1" } }, "sha512-mxIojEAQcuEvT/lyXq+jf/3cO/KoA6z4CeNDGGevTybECPOMFCnQy3OPahluUkbqgPNGw5Bi78UC7Po6Lhy+NA=="],

    "chownr": ["chownr@3.0.0", "", {}, "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g=="],
@@ -1836,7 +1848,7 @@

    "cva": ["cva@1.0.0-beta.2", "", { "dependencies": { "clsx": "^2.1.1" }, "peerDependencies": { "typescript": ">= 4.5.5 < 6" }, "optionalPeers": ["typescript"] }, "sha512-dqcOFe247I5pKxfuzqfq3seLL5iMYsTgo40Uw7+pKZAntPgFtR7Tmy59P5IVIq/XgB0NQWoIvYDt9TwHkuK8Cg=="],

-    "cytoscape": ["cytoscape@3.34.4", "", {}, "sha512-msY99tMY8iWTg+sIPGfSqDcPNOt4xcj+v/K/7qUFaCUxxlqnMkUYLBjRUzn9W5CU/R2hrmtJa5+UtovrEM2ctg=="],
+    "cytoscape": ["cytoscape@3.33.1", "", {}, "sha512-iJc4TwyANnOGR1OmWhsS9ayRS3s+XQ185FmuHObThD+5AeJCakAAbWv8KimMTt08xCCLNgneQwFp+JRJOr9qGQ=="],

    "cytoscape-cose-bilkent": ["cytoscape-cose-bilkent@4.1.0", "", { "dependencies": { "cose-base": "^1.0.0" }, "peerDependencies": { "cytoscape": "^3.2.0" } }, "sha512-wgQlVIUJF13Quxiv5e1gstZ08rnZj2XaLHGoFMYXz7SkNfCDOOteKBE6SYRfA9WxxI/iBc3ajfDoc6hb/MRAHQ=="],

@@ -1912,7 +1924,7 @@

    "data-uri-to-buffer": ["data-uri-to-buffer@6.0.2", "", {}, "sha512-7hvf7/GW8e86rW0ptuwS3OcBGDjIi6SZva7hCyWC0yYry2cOPmLIjXAUHI6DK2HsnwJd9ifmt57i8eV2n4YNpw=="],

-    "dayjs": ["dayjs@1.11.23", "", {}, "sha512-QDTCU0M0MxR3hQfnlDJfwekQiaanm1ubOD231u73WBckQ/fsamwRLiE2GBz6D3a/xF1NgfiDLJjXBa1hYOYTtQ=="],
+    "dayjs": ["dayjs@1.11.19", "", {}, "sha512-t5EcLVS6QPBNqM2z8fakk/NKel+Xzshgt8FFKAn+qwlD1pzZWxh0nVCrvFK7ZDb6XucZeF9z8C7CBWTRIVApAw=="],

    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],

@@ -1962,7 +1974,7 @@

    "domhandler": ["domhandler@5.0.3", "", { "dependencies": { "domelementtype": "^2.3.0" } }, "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w=="],

-    "dompurify": ["dompurify@3.4.17", "", { "optionalDependencies": { "@types/trusted-types": "^2.0.7" } }, "sha512-B/pSlYVHQ58kqISD/yDjuJ1yfzI34m1gF4lAod2bwSRhiN4K5Cl3H8Af7hqB2PmTL911tdEudnnXn5FnhRoz0w=="],
+    "dompurify": ["dompurify@3.3.1", "", { "optionalDependencies": { "@types/trusted-types": "^2.0.7" } }, "sha512-qkdCKzLNtrgPFP1Vo+98FRzJnBRGe4ffyCea9IwHB1fyxPOeNTHpLKYGd4Uk9xvNoH0ZoOjwZxNptyMwqrId1Q=="],

    "domutils": ["domutils@3.2.2", "", { "dependencies": { "dom-serializer": "^2.0.0", "domelementtype": "^2.3.0", "domhandler": "^5.0.3" } }, "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw=="],

@@ -2020,8 +2032,6 @@

    "es-object-atoms": ["es-object-atoms@1.1.1", "", { "dependencies": { "es-errors": "^1.3.0" } }, "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA=="],

-    "es-toolkit": ["es-toolkit@1.52.0", "", {}, "sha512-XTNEJQh1tY1ZJVcf6ayP/2n4ZPyaHlW2FWs7xvw5ddPuhUVjLD3olQVQS7kf58JbAB48iL0uL/jerTrjtV3lDA=="],
-
    "es5-ext": ["es5-ext@0.10.64", "", { "dependencies": { "es6-iterator": "^2.0.3", "es6-symbol": "^3.1.3", "esniff": "^2.0.1", "next-tick": "^1.1.0" } }, "sha512-p2snDhiLaXe6dahss1LddxqEm+SkuDvV8dnIQG0MWjyHpcMNfXKPE+/Cc0y+PhxJX3A4xGNeFCj5oc0BUh6deg=="],

    "es6-iterator": ["es6-iterator@2.0.3", "", { "dependencies": { "d": "1", "es5-ext": "^0.10.35", "es6-symbol": "^3.1.1" } }, "sha512-zw4SRzoUkd+cl+ZoE15A9o1oQd920Bb0iOJMQkQhl3jNc03YqVjAhG7scf9C5KWRU/R13Orf588uCC6525o02g=="],
@@ -2392,7 +2402,7 @@

    "jwt-decode": ["jwt-decode@4.0.0", "", {}, "sha512-+KJGIyHgkGuIq3IEBNftfhW/LfWhXUIY6OmyVWjliu5KH1y0fw7VQ8YndE2O4qZdMSd9SqbnC8GOcZEy0Om7sA=="],

-    "katex": ["katex@0.16.47", "", { "dependencies": { "commander": "^8.3.0" }, "bin": { "katex": "cli.js" } }, "sha512-Eeo8Ys1doU1z+x8AZsPpQu+p/QcZBI5PeOo7QGQdy2x2m0MU/hYagBbGOmXwr5KVbEfVuWv9LpnQWeehogurjg=="],
+    "katex": ["katex@0.16.25", "", { "dependencies": { "commander": "^8.3.0" }, "bin": { "katex": "cli.js" } }, "sha512-woHRUZ/iF23GBP1dkDQMh1QBad9dmr8/PAwNA54VrSOVYgI12MAcE14TqnDdQOdzyEonGzMepYnqBMYdsoAr8Q=="],

    "keyv": ["keyv@5.3.2", "", { "dependencies": { "@keyv/serialize": "^1.0.3" } }, "sha512-Lji2XRxqqa5Wg+CHLVfFKBImfJZ4pCSccu9eVWK6w4c2SDFLd8JAn1zqTuSFnsxb7ope6rMsnIHfp+eBbRBRZQ=="],

@@ -2404,6 +2414,8 @@

    "known-css-properties": ["known-css-properties@0.35.0", "", {}, "sha512-a/RAk2BfKk+WFGhhOCAYqSiFLc34k8Mt/6NWRI4joER0EYUzXIcFivjjnoD3+XU1DggLn/tZc3DOAgke7l8a4A=="],

+    "langium": ["langium@4.2.1", "", { "dependencies": { "chevrotain": "~11.1.1", "chevrotain-allstar": "~0.3.1", "vscode-languageserver": "~9.0.1", "vscode-languageserver-textdocument": "~1.0.11", "vscode-uri": "~3.1.0" } }, "sha512-zu9QWmjpzJcomzdJQAHgDVhLGq5bLosVak1KVa40NzQHXfqr4eAHupvnPOVXEoLkg6Ocefvf/93d//SB7du4YQ=="],
+
    "layout-base": ["layout-base@1.0.2", "", {}, "sha512-8h2oVEZNktL4BH2JCOI90iD1yXwL6iNW7KcCKT2QZgQJR2vbqDsldCTPRU9NifTCqHZci57XvQQ15YTu+sTYPg=="],

    "leven": ["leven@4.1.0", "", {}, "sha512-KZ9W9nWDT7rF7Dazg8xyLHGLrmpgq2nVNFUckhqdW3szVP6YhCpp/RAnpmVExA9JvrMynjwSLVrEj3AepHR6ew=="],
@@ -2528,7 +2540,7 @@

    "merge2": ["merge2@1.4.1", "", {}, "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg=="],

-    "mermaid": ["mermaid@11.16.1", "", { "dependencies": { "@braintree/sanitize-url": "^7.1.2", "@iconify/utils": "^3.0.2", "@mermaid-js/parser": "^1.2.0", "@types/d3": "^7.4.3", "@upsetjs/venn.js": "^2.0.0", "cytoscape": "^3.33.3", "cytoscape-cose-bilkent": "^4.1.0", "cytoscape-fcose": "^2.2.0", "d3": "^7.9.0", "d3-sankey": "^0.12.3", "dagre-d3-es": "7.0.14", "dayjs": "^1.11.20", "dompurify": "^3.3.3", "es-toolkit": "^1.45.1", "katex": "^0.16.45", "khroma": "^2.1.0", "marked": "^16.3.0", "roughjs": "^4.6.6", "stylis": "^4.3.6", "ts-dedent": "^2.2.0", "uuid": "^11.1.0 || ^12 || ^13 || ^14.0.0" } }, "sha512-TQsq6u22fAn3rek5VOubrhKPo1g5hwC3FXUN9hiyupTckcYiGuuKGkNQrKYwGJkXUxZdojwRG46gsSCFZMDp4g=="],
+    "mermaid": ["mermaid@11.14.0", "", { "dependencies": { "@braintree/sanitize-url": "^7.1.1", "@iconify/utils": "^3.0.2", "@mermaid-js/parser": "^1.1.0", "@types/d3": "^7.4.3", "@upsetjs/venn.js": "^2.0.0", "cytoscape": "^3.33.1", "cytoscape-cose-bilkent": "^4.1.0", "cytoscape-fcose": "^2.2.0", "d3": "^7.9.0", "d3-sankey": "^0.12.3", "dagre-d3-es": "7.0.14", "dayjs": "^1.11.19", "dompurify": "^3.3.1", "katex": "^0.16.25", "khroma": "^2.1.0", "lodash-es": "^4.17.23", "marked": "^16.3.0", "roughjs": "^4.6.6", "stylis": "^4.3.6", "ts-dedent": "^2.2.0", "uuid": "^11.1.0" } }, "sha512-GSGloRsBs+JINmmhl0JDwjpuezCsHB4WGI4NASHxL3fHo3o/BRXTxhDLKnln8/Q0lRFRyDdEjmk1/d5Sn1Xz8g=="],

    "methods": ["methods@1.1.2", "", {}, "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w=="],

@@ -2638,7 +2650,7 @@

    "netmask": ["netmask@2.0.2", "", {}, "sha512-dBpDMdxv9Irdq66304OLfEmQ9tbNRFnFTuZiLo+bD+r332bBmMJ8GBLXklIXXgxd3+v9+KUnZaUR5PJMa75Gsg=="],

-    "next": ["next@16.3.8", "", { "dependencies": { "@next/env": "16.3.8", "@swc/helpers": "0.5.23", "baseline-browser-mapping": "^2.9.19", "caniuse-lite": "^1.0.30001579", "postcss": "8.5.23", "styled-jsx": "5.1.6" }, "optionalDependencies": { "@next/swc-darwin-arm64": "16.3.8", "@next/swc-darwin-x64": "16.3.8", "@next/swc-linux-arm64-gnu": "16.3.8", "@next/swc-linux-arm64-musl": "16.3.8", "@next/swc-linux-x64-gnu": "16.3.8", "@next/swc-linux-x64-musl": "16.3.8", "@next/swc-win32-arm64-msvc": "16.3.8", "@next/swc-win32-x64-msvc": "16.3.8", "sharp": "^0.35.4" }, "peerDependencies": { "@opentelemetry/api": "^1.1.0", "@playwright/test": "^1.51.1", "babel-plugin-react-compiler": "*", "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "sass": "^1.3.0" }, "optionalPeers": ["@opentelemetry/api", "@playwright/test", "babel-plugin-react-compiler", "sass"], "bin": { "next": "dist/bin/next" } }, "sha512-U7QEZaTini6wKrb8A8hqLLqYQyCetegKjCpJOyxk642vWoMoU1x5PyZCJFvgYgiptA8xc5j/9xYlZFO7w9Sjmw=="],
+    "next": ["next@16.3.6", "", { "dependencies": { "@next/env": "16.3.6", "@swc/helpers": "0.5.23", "baseline-browser-mapping": "^2.9.19", "caniuse-lite": "^1.0.30001579", "postcss": "8.5.23", "styled-jsx": "5.1.6" }, "optionalDependencies": { "@next/swc-darwin-arm64": "16.3.6", "@next/swc-darwin-x64": "16.3.6", "@next/swc-linux-arm64-gnu": "16.3.6", "@next/swc-linux-arm64-musl": "16.3.6", "@next/swc-linux-x64-gnu": "16.3.6", "@next/swc-linux-x64-musl": "16.3.6", "@next/swc-win32-arm64-msvc": "16.3.6", "@next/swc-win32-x64-msvc": "16.3.6", "sharp": "^0.35.4" }, "peerDependencies": { "@opentelemetry/api": "^1.1.0", "@playwright/test": "^1.51.1", "babel-plugin-react-compiler": "*", "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "sass": "^1.3.0" }, "optionalPeers": ["@opentelemetry/api", "@playwright/test", "babel-plugin-react-compiler", "sass"], "bin": { "next": "dist/bin/next" } }, "sha512-L+otWM/aQbYTx98aZhgEoMb4bZAXx1YVW4UMA/vuCyCoWG5HJyZUili8QAkqzrcC+5///tsz3s0M+SlyB5bLMw=="],

    "next-themes": ["next-themes@0.4.6", "", { "peerDependencies": { "react": "^16.8 || ^17 || ^18 || ^19 || ^19.0.0-rc", "react-dom": "^16.8 || ^17 || ^18 || ^19 || ^19.0.0-rc" } }, "sha512-pZvgD5L0IEvX5/9GWyHMf3m8BKiVQwsCMHfoFosXtXBMnaS0ZnIJ9ST4b4NqLVKDEm8QBxoNNGNaBv2JNF6XNA=="],

@@ -2666,7 +2678,7 @@

    "object-hash": ["object-hash@3.0.0", "", {}, "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw=="],

-    "object-identity": ["object-identity@0.2.1", "", {}, "sha512-itX2N4m0IvaLhFZMi9YkW4nFML6FshKCCpnn6iKJZVIkCNM/ZRaG4t1bzD2ncaW4r6cHJa59XY+7oZAH7tg8tA=="],
+    "object-identity": ["object-identity@0.1.2", "", {}, "sha512-Px5puVllX5L2aBjbcfXpiG5xXeq6OE8RckryTeP2Zq+0PgYrCGJXmC6LblWgknKSJs11Je2W4U2NOWFj3t/QXQ=="],

    "object-inspect": ["object-inspect@1.13.2", "", {}, "sha512-IRZSRuzJiynemAXPYtPe5BoI/RESNYR7TYm50MC5Mqbd3Jmw5y790sErYw3V6SryFJD64b74qQQs9wn5Bg/k3g=="],

@@ -2922,6 +2934,8 @@

    "rolldown-plugin-dts": ["rolldown-plugin-dts@0.16.11", "", { "dependencies": { "@babel/generator": "^7.28.3", "@babel/parser": "^7.28.4", "@babel/types": "^7.28.4", "ast-kit": "^2.1.2", "birpc": "^2.6.1", "debug": "^4.4.3", "dts-resolver": "^2.1.2", "get-tsconfig": "^4.10.1", "magic-string": "^0.30.19" }, "peerDependencies": { "@ts-macro/tsc": "^0.3.6", "@typescript/native-preview": ">=7.0.0-dev.20250601.1", "rolldown": "^1.0.0-beta.9", "typescript": "^5.0.0", "vue-tsc": "~3.1.0" }, "optionalPeers": ["@ts-macro/tsc", "@typescript/native-preview", "typescript", "vue-tsc"] }, "sha512-9IQDaPvPqTx3RjG2eQCK5GYZITo203BxKunGI80AGYicu1ySFTUyugicAaTZWRzFWh9DSnzkgNeMNbDWBbSs0w=="],

+    "rollup": ["rollup@3.29.5", "", { "optionalDependencies": { "fsevents": "~2.3.2" }, "bin": { "rollup": "dist/bin/rollup" } }, "sha512-GVsDdsbJzzy4S/v3dqWPJ7EfvZJfCHiDqe80IyrF59LYuP+e6U1LJoUqeuqRbwAWoMNoXivMNeNAOf5E22VA1w=="],
+
    "roughjs": ["roughjs@4.6.6", "", { "dependencies": { "hachure-fill": "^0.5.2", "path-data-parser": "^0.1.0", "points-on-curve": "^0.2.0", "points-on-path": "^0.2.1" } }, "sha512-ZUz/69+SYpFN/g/lUlo2FXcIjRkSu3nDarreVdGGndHEBJ6cXPdKguS8JGxwj5HA5xIbVKSmLgr5b3AWxtRfvQ=="],

    "router": ["router@2.0.0", "", { "dependencies": { "array-flatten": "3.0.0", "is-promise": "4.0.0", "methods": "~1.1.2", "parseurl": "~1.3.3", "path-to-regexp": "^8.0.0", "setprototypeof": "1.2.0", "utils-merge": "1.0.1" } }, "sha512-dIM5zVoG8xhC6rnSN8uoAgFARwTE7BQs8YwHEvK0VCmfxQXMaOuA1uiR1IPwsW7JyK5iTt7Od/TC9StasS2NPQ=="],
@@ -3208,6 +3222,18 @@

    "vfile-message": ["vfile-message@4.0.2", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-stringify-position": "^4.0.0" } }, "sha512-jRDZ1IMLttGj41KcZvlrYAaI3CfqpLpfpf+Mfig13viT6NKvRzWZ+lXz0Y5D60w6uJIBAOGq9mSHf0gktF0duw=="],

+    "vscode-jsonrpc": ["vscode-jsonrpc@8.2.0", "", {}, "sha512-C+r0eKJUIfiDIfwJhria30+TYWPtuHJXHtI7J0YlOmKAo7ogxP20T0zxB7HZQIFhIyvoBPwWskjxrvAtfjyZfA=="],
+
+    "vscode-languageserver": ["vscode-languageserver@9.0.1", "", { "dependencies": { "vscode-languageserver-protocol": "3.17.5" }, "bin": { "installServerIntoExtension": "bin/installServerIntoExtension" } }, "sha512-woByF3PDpkHFUreUa7Hos7+pUWdeWMXRd26+ZX2A8cFx6v/JPTtd4/uN0/jB6XQHYaOlHbio03NTHCqrgG5n7g=="],
+
+    "vscode-languageserver-protocol": ["vscode-languageserver-protocol@3.17.5", "", { "dependencies": { "vscode-jsonrpc": "8.2.0", "vscode-languageserver-types": "3.17.5" } }, "sha512-mb1bvRJN8SVznADSGWM9u/b07H7Ecg0I3OgXDuLdn307rl/J3A9YD6/eYOssqhecL27hK1IPZAsaqh00i/Jljg=="],
+
+    "vscode-languageserver-textdocument": ["vscode-languageserver-textdocument@1.0.12", "", {}, "sha512-cxWNPesCnQCcMPeenjKKsOCKQZ/L6Tv19DTRIGuLWe32lyzWhihGVJ/rcckZXJxfdKCFvRLS3fpBIsV/ZGX4zA=="],
+
+    "vscode-languageserver-types": ["vscode-languageserver-types@3.17.5", "", {}, "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg=="],
+
+    "vscode-uri": ["vscode-uri@3.1.0", "", {}, "sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ=="],
+
    "vue": ["vue@3.5.21", "", { "dependencies": { "@vue/compiler-dom": "3.5.21", "@vue/compiler-sfc": "3.5.21", "@vue/runtime-dom": "3.5.21", "@vue/server-renderer": "3.5.21", "@vue/shared": "3.5.21" }, "peerDependencies": { "typescript": "*" }, "optionalPeers": ["typescript"] }, "sha512-xxf9rum9KtOdwdRkiApWL+9hZEMWE90FHh8yS1+KJAiWYh+iGWV1FquPjoO9VUHQ+VIhsCXNNyZ5Sf4++RVZBA=="],

    "vue-component-type-helpers": ["vue-component-type-helpers@3.1.1", "", {}, "sha512-B0kHv7qX6E7+kdc5nsaqjdGZ1KwNKSUQDWGy7XkTYT7wFsOpkEyaJ1Vq79TjwrrtuLRgizrTV7PPuC4rRQo+vw=="],
@@ -3670,8 +3696,6 @@

    "@vue/compiler-sfc/postcss": ["postcss@8.5.6", "", { "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg=="],

-    "@zenuml/core/dompurify": ["dompurify@3.3.1", "", { "optionalDependencies": { "@types/trusted-types": "^2.0.7" } }, "sha512-qkdCKzLNtrgPFP1Vo+98FRzJnBRGe4ffyCea9IwHB1fyxPOeNTHpLKYGd4Uk9xvNoH0ZoOjwZxNptyMwqrId1Q=="],
-
    "@zenuml/core/marked": ["marked@4.3.0", "", { "bin": { "marked": "bin/marked.js" } }, "sha512-PRsaiG84bK+AMvxziE/lCFss8juXjNaWzVbN5tXAm4XjeaS9NAHhop+PjQxz2A9h8Q4M/xGmzP8vqNwy6JeK0A=="],

    "@zenuml/core/tailwind-merge": ["tailwind-merge@3.4.1", "", {}, "sha512-2OA0rFqWOkITEAOFWSBSApYkDeH9t2B3XSJuI4YztKBzK3mX0737A2qtxDZ7xkw9Zfh0bWl+r34sF3HXV+Ig7Q=="],
@@ -19,7 +19,8 @@
        "react": "catalog:",
        "react-dom": "catalog:",
        "esbuild": "0.27.3",
-        "axios": "1.8.4"
+        "axios": "1.8.4",
+        "@opennextjs/aws": "4.1.5"
    },
    "private": true,
    "scripts": {
@@ -48,7 +49,7 @@
            "@tsconfig/strictest": "^2.0.6",
            "@tsconfig/node20": "^20.1.6",
            "@base-ui/react": "^1.7.0",
-            "@gitbook/api": "0.206.0",
+            "@gitbook/api": "0.202.0",
            "@scalar/api-client-react": "^1.3.46",
            "@types/react": "^19.0.0",
            "@types/react-dom": "^19.0.0",
@@ -67,7 +68,6 @@
    "patchedDependencies": {
        "decode-named-character-reference@1.0.2": "patches/decode-named-character-reference@1.0.2.patch",
        "@vercel/next@4.4.2": "patches/@vercel%2Fnext@4.4.2.patch",
-        "next@16.3.8": "patches/next@16.3.8.patch",
-        "mermaid@11.16.1": "patches/mermaid@11.16.1.patch"
+        "next@16.3.6": "patches/next@16.3.6.patch"
    }
 }
@@ -54,7 +54,6 @@ GitBook('configure', {
        icon: 'assistant' // 'assistant' | 'sparkle' | 'help' | 'book'
    },
    tabs: ['assistant', 'search', 'docs'],
-    defaultPage: '/getting-started',
    actions: [
        {
            icon: 'circle-question',
@@ -108,7 +107,6 @@ frame.clearChat();
 // Configure the embed (see Configuration section for all options)
 frame.configure({
    tabs: ['assistant', 'search', 'docs'],
-    defaultPage: '/getting-started',
    actions: [
        {
            icon: 'circle-question',
@@ -144,7 +142,6 @@ import { GitBookProvider, GitBookFrame } from '@gitbook/embed/react';
            unsignedClaims: { userId: '123' } // Optional: custom claims for dynamic expressions
        }}
        tabs={['assistant', 'search', 'docs']}
-        defaultPage="/getting-started"
        greeting={{ title: 'Welcome!', subtitle: 'How can I help?' }}
        assistantName="Support Assistant"
        suggestions={['What is GitBook?', 'How do I get started?']}
@@ -252,33 +249,6 @@ Override which tabs are displayed. Defaults to your site's configuration.
 tabs: ['assistant', 'search', 'docs']
 ```

-### `defaultTab`
-
-Available in: Standalone script, NPM package, React components
-
-The tab the embed opens on. Without it, the embed opens on `defaultPage` if set, otherwise on the assistant (or the docs when the assistant isn't available). The tab must be one of the enabled `tabs`.
-
- **Type**: `'assistant' | 'search' | 'docs'`
-
-```javascript
-tabs: ['assistant', 'search', 'docs'],
-defaultTab: 'search'
-```
-
-`defaultTab` and `defaultPage` apply when the embed first loads: the standalone widget keeps its place when it is closed and reopened. To move it later, use `navigateToPage` or `navigateToAssistant`.
-
-### `defaultPage`
-
-Available in: Standalone script, NPM package, React components
-
-The page the docs tab opens on, in place of your site's home page. Accepts the same references as `navigateToPage`: the page's path within the site, an absolute path, or its full published URL. Unless `defaultTab` says otherwise, the embed opens on this page.
-
- **Type**: `string`
-
-```javascript
-defaultPage: '/getting-started/quickstart'
-```
-
 ### `closeButton`

 Available in: Standalone script, NPM package, React components
@@ -62,12 +62,6 @@ export type GitBookEmbeddableConfiguration = {
    /** Tabs to display in the embed (if enabled on the site). */
    tabs: ('assistant' | 'docs' | 'search')[];

-    /** Tab to open the embed on. */
-    defaultTab?: 'assistant' | 'docs' | 'search';
-
-    /** Page to open the docs tab on, instead of the site's home page. */
-    defaultPage?: string;
-
    /** Additional buttons to be displayed in the header of the GitBook embed. */
    actions: GitBookEmbeddableActionDefinition[];

@@ -27,8 +27,6 @@ export function GitBookFrame(props: GitBookFrameProps) {
        suggestions = [],
        tools = [],
        tabs = ['assistant', 'search', 'docs'],
-        defaultTab,
-        defaultPage,
        trademark = true,
        closeButton = false,
        assistantName,
@@ -52,8 +50,6 @@ export function GitBookFrame(props: GitBookFrameProps) {
    useEffect(() => {
        gitbookFrame?.configure({
            tabs,
-            defaultTab,
-            defaultPage,
            actions,
            greeting,
            suggestions,
@@ -69,8 +65,6 @@ export function GitBookFrame(props: GitBookFrameProps) {
        suggestions,
        tools,
        tabs,
-        defaultTab,
-        defaultPage,
        closeButton,
        trademark,
        assistantName,
@@ -1125,30 +1125,6 @@ const testCases: TestsCase[] = [
                    ).toBeVisible();
                },
            },
-            {
-                name: 'Markdown page with theme cookie',
-                url: async () => {
-                    const data = await getSiteAPIToken(
-                        'https://gitbook.gitbook.io/test-gitbook-open/'
-                    );
-
-                    const searchParams = new URLSearchParams();
-                    searchParams.set('token', data.apiToken);
-                    searchParams.set('theme', 'dark');
-
-                    return `url/${getGitBookPreviewURL(`${data.site}/blocks?${searchParams.toString()}`)}`;
-                },
-                screenshot: false,
-                run: async (page) => {
-                    // The app opens previews with `?theme=`, which the middleware persists in a cookie.
-                    const markdownURL = new URL(page.url());
-                    markdownURL.pathname = `${markdownURL.pathname.replace(/\/$/, '')}.md`;
-                    markdownURL.search = '';
-                    const response = await page.request.get(markdownURL.toString());
-                    expect(response.status()).toBe(200);
-                    expect(response.headers()['content-type']).toContain('text/markdown');
-                },
-            },
            {
                name: 'Redirect to app for authentication when missing token',
                url: async () => {
@@ -95,8 +95,6 @@ const nextConfig = {
        GITBOOK_BLOCK_SEARCH_INDEXATION: process.env.GITBOOK_BLOCK_SEARCH_INDEXATION,
        GITBOOK_ALLOW_CUSTOMIZATION_OVERRIDE: process.env.GITBOOK_ALLOW_CUSTOMIZATION_OVERRIDE,
        GITBOOK_DISABLE_INSIGHTS: process.env.GITBOOK_DISABLE_INSIGHTS,
-        GITBOOK_VISITOR_COUNTRY_HOSTNAMES: process.env.GITBOOK_VISITOR_COUNTRY_HOSTNAMES,
-        VERCEL_TARGET_ENV: process.env.VERCEL_TARGET_ENV,

        // Next.js envs
        NEXT_SERVER_ACTIONS_ENCRYPTION_KEY: process.env.NEXT_SERVER_ACTIONS_ENCRYPTION_KEY,
@@ -20,8 +20,8 @@
        "@gitbook/react-openapi": "workspace:*",
        "@mermaid-js/mermaid-zenuml": "^0.2.2",
        "@modelcontextprotocol/sdk": "1.17.5",
-        "@opennextjs/aws": "4.1.7",
-        "@opennextjs/cloudflare": "1.20.8",
+        "@opennextjs/aws": "4.1.3",
+        "@opennextjs/cloudflare": "1.20.5",
        "@panzoom/panzoom": "^4.6.1",
        "@sindresorhus/fnv1a": "^3.1.0",
        "@tailwindcss/container-queries": "^0.1.1",
@@ -46,16 +46,16 @@
        "mdast-util-gfm": "^3.1.0",
        "mdast-util-to-markdown": "^2.1.2",
        "memoizee": "^0.4.17",
-        "mermaid": "11.16.1",
+        "mermaid": "^11.14.0",
        "micromark-extension-frontmatter": "^2.0.0",
        "micromark-extension-gfm": "^3.0.0",
        "motion": "^12.23.24",
        "negotiator": "^1.0.0",
-        "next": "^16.3.8",
+        "next": "^16.3.6",
        "next-themes": "^0.4.6",
        "nuqs": "^2.2.3",
        "object-hash": "^3.0.0",
-        "object-identity": "^0.2.1",
+        "object-identity": "^0.1.2",
        "openapi-types": "^12.1.3",
        "p-map": "^7.0.3",
        "p-retry": "^8.0.0",
@@ -1,6 +1,5 @@
 import { build } from 'bun';
-import { createHash } from 'node:crypto';
-import { mkdir, readFile, rename, rm } from 'node:fs/promises';
+import { mkdir, rename, rm } from 'node:fs/promises';
 import { createRequire } from 'node:module';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -13,20 +12,14 @@ const temporaryDir = join(outputDir, '.build');
 const require = createRequire(import.meta.url);
 const mermaidPackage = require('mermaid/package.json') as { version: string };
 const zenumlPackage = require('@mermaid-js/mermaid-zenuml/package.json') as { version: string };
-const mermaidPatch = await readFile(
-    join(scriptDir, `../../../patches/mermaid@${mermaidPackage.version}.patch`)
-).catch(() => null);
-const mermaidPatchSuffix = mermaidPatch
-    ? `-patch.${createHash('sha256').update(mermaidPatch).digest('hex').slice(0, 8)}`
-    : '';

-// The runtime URL is served as immutable, it has to change whenever the bundled versions or patch change.
+// The runtime URL is served as immutable, it has to change whenever the bundled versions change.
 if (
    MERMAID_RUNTIME_PATH !==
-    `mermaid/mermaid@${mermaidPackage.version}${mermaidPatchSuffix}-zenuml@${zenumlPackage.version}.mjs`
+    `mermaid/mermaid@${mermaidPackage.version}-zenuml@${zenumlPackage.version}.mjs`
 ) {
    throw new Error(
-        'Update MERMAID_RUNTIME_PATH for the installed mermaid and @mermaid-js/mermaid-zenuml versions and the mermaid patch'
+        'Update MERMAID_RUNTIME_PATH for the installed mermaid and @mermaid-js/mermaid-zenuml versions'
    );
 }

@@ -7,7 +7,7 @@ import type { CustomizationAIMode } from '@gitbook/api';
 import type { GitBookAssistant } from '@gitbook/browser-types';
 import { Icon, type IconName } from '@gitbook/icons';

-import { type AskAITrigger, useAIChatController, useAIChatState } from '.';
+import { useAIChatController, useAIChatState } from '.';
 import { AIChatIcon, AISearchIcon, getAIChatName } from '../AIChat';
 import { useIntegrationAssistants } from '../Integrations';
 import { useSetSearchState } from '../Search/useSearch';
@@ -26,8 +26,7 @@ export type AIConfig = {
    };
 };

-export type Assistant = Omit<GitBookAssistant, 'icon' | 'open'> & {
-    open: (query?: string, trigger?: AskAITrigger) => void;
+export type Assistant = Omit<GitBookAssistant, 'icon'> & {
    /**
     * Unique identifier for the assistant. Generated automatically using Crypto.randomUUID().
     * @example '123e4567-e89b-12d3-a456-426614174000'
@@ -103,8 +102,8 @@ export function useAI(): AIContext {
                    className="size-text-lg"
                />
            ),
-            open: (query?: string, trigger?: AskAITrigger) => {
-                chatController.open(trigger);
+            open: (query?: string) => {
+                chatController.open();
                if (query) {
                    chatController.postMessage({ message: query });
                }
@@ -120,13 +119,9 @@ export function useAI(): AIContext {
            icon: <AISearchIcon />,
            open: (query?: string) => {
                if (query) {
-                    setSearchState((prev) => ({
-                        ...prev,
-                        query: null,
-                        ask: query,
-                        scope: prev?.scope ?? 'default',
-                        open: true,
-                    }));
+                    setSearchState((prev) =>
+                        prev ? { ...prev, query: null, ask: query, open: true } : null
+                    );
                }
            },
            pageAction: false,
@@ -11,7 +11,6 @@ import {
    type AIStreamResponseToolCallPending,
    type AIToolCallResult,
    SiteInsightsDisplayContext,
-    type SiteInsightsEventAskView,
 } from '@gitbook/api';

 import { getInsightsSession, useTrackEvent } from '../Insights';
@@ -61,8 +60,6 @@ export type AIChatStatus =
    | 'error'
    | 'confirm';

-export type AskAITrigger = NonNullable<SiteInsightsEventAskView['trigger']>;
-
 export type AIChatState = {
    /**
     * If true, the chat is open.
@@ -163,7 +160,7 @@ type AIChatEventListener = (input?: Omit<AIChatEvent, 'type'>) => void;

 export type AIChatController = {
    /** Open the dialog */
-    open: (trigger?: AskAITrigger) => void;
+    open: () => void;
    /** Close the dialog */
    close: () => void;
    /** Post a message to the session */
@@ -305,28 +302,22 @@ export function AIChatProvider(props: {
    const eventsRef = React.useRef<Map<AIChatEvent['type'], AIChatEventListener[]>>(new Map());

    // Open AI chat and sync with search state
-    const onOpen = React.useCallback(
-        (trigger?: AskAITrigger) => {
-            setIntercomLauncherHidden(true);
-            if (!renderMessageOptions?.asEmbeddable) {
-                trackEvent({ type: 'ask_view', trigger });
-            }
+    const onOpen = React.useCallback(() => {
+        setIntercomLauncherHidden(true);

-            const { initialQuery } = globalState.getState();
-            globalState.setState((state) => ({ ...state, opened: true }));
+        const { initialQuery } = globalState.getState();
+        globalState.setState((state) => ({ ...state, opened: true }));

-            // Update search state to show ask mode with first message or current ask value
-            setSearchState((prev) => ({
-                ask: prev?.ask ?? initialQuery ?? '',
-                query: prev?.query ?? null,
-                scope: prev?.scope ?? 'default',
-                open: false, // Close search popover when opening chat
-            }));
+        // Update search state to show ask mode with first message or current ask value
+        setSearchState((prev) => ({
+            ask: prev?.ask ?? initialQuery ?? '',
+            query: prev?.query ?? null,
+            scope: prev?.scope ?? 'default',
+            open: false, // Close search popover when opening chat
+        }));

-            notify(eventsRef.current.get('open'), {});
-        },
-        [setSearchState, trackEvent, renderMessageOptions?.asEmbeddable]
-    );
+        notify(eventsRef.current.get('open'), {});
+    }, [setSearchState]);

    // Close AI chat and clear ask parameter
    const onClose = React.useCallback(() => {
@@ -24,6 +24,7 @@ import {
    EmbeddableFrameTitle,
 } from '../Embeddable/EmbeddableFrame';
 import { useIsMounted, useNow } from '../hooks';
+import { useTrackEvent } from '../Insights';
 import { Button } from '../primitives';
 import { ScrollContainer } from '../primitives/ScrollContainer';
 import { SideSheet } from '../primitives/SideSheet';
@@ -67,6 +68,16 @@ export function AIChat() {
        }
    );

+    // Track the view of the AI chat
+    const trackEvent = useTrackEvent();
+    React.useEffect(() => {
+        if (chat.opened) {
+            trackEvent({
+                type: 'ask_view',
+            });
+        }
+    }, [chat.opened, trackEvent]);
+
    return (
        <SideSheet
            side="right"
@@ -39,7 +39,7 @@ export function AIChatButton(props: {
                </div>
            }
            aria-label={tString(language, 'ai_chat_ask', assistant.label)}
-            onClick={() => assistant.open(undefined, 'site')}
+            onClick={() => assistant.open()}
        >
            {showLabel ? t(language, 'ask') : null}
        </Button>
@@ -1,58 +1,29 @@
 'use client';

 import fnv1a from '@sindresorhus/fnv1a';
-import * as React from 'react';
-import { createPortal } from 'react-dom';

 import { AIChatIcon } from '../AIChatIcon';
 import { useAIChatController, useAIConfig } from '@/components/AI';
 import { Button } from '@/components/primitives';
-import { isAIChatEnabled } from '@/components/utils/isAIChatEnabled';
 import { t, tString, useLanguage } from '@/intl/client';
-import { tcls } from '@/lib/tailwind';
+import { type ClassValue, tcls } from '@/lib/tailwind';

 /**
- * A small icon button revealed in the left margin of a paragraph when it is hovered (on devices
- * with a fine pointer). Clicking it stages the paragraph's text as a reference and opens the AI
- * chat — a more discoverable variant of the text-selection "Ask" affordance.
+ * A small icon button revealed in the left margin of a top-level paragraph when it is hovered (on
+ * devices with a fine pointer). Clicking it stages the paragraph's text as a reference and opens
+ * the AI chat — a more discoverable variant of the text-selection "Ask" affordance.
 *
- * A single instance is portaled into the last hovered paragraph wrapper, rather than rendering one
- * per paragraph, so pages with many paragraphs don't pay for markup that is hidden until hovered.
- * Its visibility is still driven purely by the `group/ask-ai` hover state of that wrapper.
+ * The button is absolutely positioned so it never affects the document flow, and its visibility is
+ * driven purely by the `group/ask-ai` hover state of its paragraph wrapper.
 */
-export function AskAIParagraphButton() {
+export function AskAIParagraphButton(props: { content: string; className?: ClassValue }) {
+    const { content, className } = props;
    const config = useAIConfig();
    const language = useLanguage();
    const chatController = useAIChatController();
-    const [target, setTarget] = React.useState<HTMLElement | null>(null);
-
-    const enabled = isAIChatEnabled(config.aiMode);
-
-    React.useEffect(() => {
-        if (!enabled) {
-            return;
-        }
-
-        const onPointerOver = (event: PointerEvent) => {
-            if (!(event.target instanceof Element)) {
-                return;
-            }
-            const wrapper = event.target.closest<HTMLElement>('[data-ask-ai-paragraph]');
-            if (wrapper) {
-                setTarget(wrapper);
-            }
-        };
-
-        document.addEventListener('pointerover', onPointerOver);
-        return () => document.removeEventListener('pointerover', onPointerOver);
-    }, [enabled]);
-
-    if (!enabled || !target) {
-        return null;
-    }

    const onClick = () => {
-        const text = getParagraphText(target).trim();
+        const text = content.trim();
        if (!text) {
            return;
        }
@@ -62,12 +33,12 @@ export function AskAIParagraphButton() {
            id: `text-${fnv1a(text, { size: 32 })}`,
            content: text,
        });
-        chatController.open('hover');
+        chatController.open();
        chatController.setDraft(tString(language, 'ai_chat_paragraph_draft'));
        chatController.focus();
    };

-    return createPortal(
+    return (
        <div
            className={tcls(
                // Sit in the left margin, flush against the paragraph so there is no hover gap.
@@ -81,7 +52,13 @@ export function AskAIParagraphButton() {
                'invisible opacity-0 transition-opacity duration-150',
                'hover:visible hover:opacity-100 group-hover/ask-ai:visible group-hover/ask-ai:opacity-100',
                // Never shown on touch / hover-less contexts.
-                'not-pointer-fine:hidden'
+                'not-pointer-fine:hidden',
+                // Hidden where an overflow-clipped ancestor would cut it off (ARIA and native
+                // tables, record cards).
+                'in-[[role=table]]:hidden',
+                'in-[table]:hidden',
+                'in-[[data-card]]:hidden',
+                className
            )}
        >
            <Button
@@ -98,37 +75,6 @@ export function AskAIParagraphButton() {
                    'in-[.hint.bg-danger]:bg-danger in-[.hint.bg-info]:bg-info in-[.hint.bg-success]:bg-success in-[.hint.bg-warning]:bg-warning'
                )}
            />
-        </div>,
-        target
+        </div>
    );
 }
-
-/**
- * Read the paragraph's text, skipping rendered math like `getNodeText` does.
- */
-function getParagraphText(wrapper: HTMLElement): string {
-    const paragraph = wrapper.querySelector(':scope > p');
-    if (!paragraph) {
-        return '';
-    }
-
-    const walker = document.createTreeWalker(
-        paragraph,
-        NodeFilter.SHOW_ELEMENT | NodeFilter.SHOW_TEXT,
-        {
-            acceptNode: (node) =>
-                node instanceof Element &&
-                node.matches('.katex, mjx-container, [aria-hidden="true"]')
-                    ? NodeFilter.FILTER_REJECT
-                    : NodeFilter.FILTER_ACCEPT,
-        }
-    );
-
-    let text = '';
-    while (walker.nextNode()) {
-        if (walker.currentNode.nodeType === Node.TEXT_NODE) {
-            text += walker.currentNode.textContent ?? '';
-        }
-    }
-    return text;
-}
@@ -84,7 +84,7 @@ export function AskAITextSelection() {
            id: `text-${fnv1a(content, { size: 32 })}`,
            content,
        });
-        chatController.open('selection');
+        chatController.open();
        chatController.focus();
        clear();
    };
@@ -15,6 +15,7 @@ import {
    ToolbarBody,
    ToolbarButton,
    ToolbarButtonGroup,
+    type ToolbarButtonProps,
    ToolbarSubtitle,
    ToolbarTitle,
 } from './Toolbar';
@@ -136,21 +137,14 @@ function ChangeRequestToolbar(props: ToolbarViewProps) {
        <Toolbar minified={minified} onMinifiedChange={onMinifiedChange}>
            <ToolbarBody>
                <ToolbarTitle
-                    prefix={`#${changeRequest.number}`}
-                    prefixLabel={`Change request #${changeRequest.number}`}
-                    suffix={changeRequest.subject || 'Untitled'}
+                    prefix={`Change #${changeRequest.number}:`}
+                    suffix={`${changeRequest.subject || 'Untitled'}`}
                />
                <ToolbarSubtitle
                    subtitle={
                        <>
                            <ToolbarDate value={changeRequest.updatedAt} />{' '}
-                            <motion.span
-                                layout="position"
-                                title={author}
-                                className="min-w-0 truncate"
-                            >
-                                by {author}
-                            </motion.span>
+                            <motion.span layout="position">by {author}</motion.span>
                        </>
                    }
                />
@@ -323,7 +317,7 @@ function AuthenticatedUserToolbar(props: ToolbarViewProps) {
                <ToolbarButton
                    title="Open insights"
                    href={getToolbarHref({
-                        href: `${site.urls.app}/analytics`,
+                        href: `${site.urls.app}/insights`,
                        siteId: site.id,
                        buttonId: 'insights',
                    })}
@@ -345,8 +339,12 @@ function ToolbarActions(props: { children: React.ReactNode }) {
    );
 }

-function EditPageButton(props: { href: string; siteId: string }) {
-    const { href, siteId } = props;
+function EditPageButton(props: {
+    href: string;
+    siteId: string;
+    motionValues?: ToolbarButtonProps['motionValues'];
+}) {
+    const { href, motionValues, siteId } = props;
    const pagePath = useCurrentPagePath();

    return (
@@ -358,6 +356,7 @@ function EditPageButton(props: { href: string; siteId: string }) {
                buttonId: 'edit',
            })}
            icon="pen-to-square"
+            motionValues={motionValues}
        />
    );
 }
@@ -1,6 +1,5 @@
 .svgLogo {
-  /* The toolbar is always dark, so the logo is always light. */
-  --logo-fill: rgb(255 255 255 / 0.92);
+  --logo-fill: var(--color-neutral-100);
  --seg-A-color: #2782c4;
  --seg-B-color: #43b7f2;
  --seg-C-color: #8be2ff;
@@ -11,14 +11,8 @@ export const AnimatedLogo: React.FC<AnimatedLogoProps> = (props) => {
    const { shouldAnimate = true } = props;

    return (
-        // Light even without the CSS module, which loads with the lazy toolbar chunk and can be
-        // missing (e.g. after a hot reload): an SVG path without a fill renders black.
        <svg
-            className={tcls(
-                'text-white/90',
-                styles.svgLogo,
-                shouldAnimate ? undefined : styles.static
-            )}
+            className={tcls(styles.svgLogo, shouldAnimate ? undefined : styles.static)}
            width="28"
            height="28"
            viewBox="0 0 28 28"
@@ -28,7 +22,6 @@ export const AnimatedLogo: React.FC<AnimatedLogoProps> = (props) => {
            <path
                d={dPath}
                transform="translate(14,14) scale(0.4)"
-                fill="currentColor"
                strokeWidth={3}
                pathLength={1}
                strokeLinecap="round"
@@ -6,9 +6,8 @@ import type { SVGProps } from 'react';
 import { Icon, type IconName, IconStyle } from '@gitbook/icons';

 import { DropdownMenu, DropdownMenuItem, DropdownMenuSeparator } from '../primitives';
-import { useToolbarSlot } from './Toolbar';
+import type { ToolbarButtonProps } from './Toolbar';
 import type { MinimalChangedPage, MinimalChangedPages } from './types';
-import { TOOLTIP_OFFSET } from './useMagnificationEffect';
 import { tcls } from '@/lib/tailwind';

 const STATUS_ICON_STYLES: Record<
@@ -43,10 +42,12 @@ const STATUS_ICON_CHIP_CLASS = 'flex size-5 shrink-0 items-center justify-center
 /**
 * A button that opens a popover with quick links to the _changed_ pages.
 */
-export function ChangedPagesButton(props: { changedPages: MinimalChangedPages | null }) {
-    const { changedPages } = props;
+export function ChangedPagesButton(props: {
+    changedPages: MinimalChangedPages | null;
+    motionValues?: ToolbarButtonProps['motionValues'];
+}) {
+    const { changedPages, motionValues } = props;
    const reduceMotion = useReducedMotion();
-    const slot = useToolbarSlot();

    if (!changedPages?.pages.length) {
        return null;
@@ -58,19 +59,30 @@ export function ChangedPagesButton(props: { changedPages: MinimalChangedPages |
    }`;

    const trigger = (
-        <motion.button
+        <button
            type="button"
            aria-label="View changed pages"
-            style={
-                reduceMotion || !slot
-                    ? undefined
-                    : { scale: slot.scale, x: slot.x, transformOrigin: 'bottom center' }
-            }
            className="relative size-8 cursor-pointer border-0 bg-transparent p-0"
        >
-            <span
+            <motion.span
                aria-hidden="true"
+                style={
+                    reduceMotion
+                        ? undefined
+                        : {
+                              scale: motionValues?.scale,
+                              x: motionValues?.x,
+                              transformOrigin: 'bottom center',
+                              zIndex: motionValues?.scale ? 10 : 'auto',
+                          }
+                }
+                transition={{
+                    type: 'spring',
+                    stiffness: 400,
+                    damping: 30,
+                }}
                className={tcls(
+                    'toolbar-button',
                    'relative flex size-8 items-center justify-center gap-1 truncate rounded-full text-sm transition-colors',
                    'text-tint-7 hover:text-tint-1',
                    'dark:text-tint-12',
@@ -79,18 +91,14 @@ export function ChangedPagesButton(props: { changedPages: MinimalChangedPages |
                )}
            >
                <DiffIcon className="size-4 shrink-0" />
-            </span>
-        </motion.button>
+            </motion.span>
+        </button>
    );

    return (
        <DropdownMenu
            button={trigger}
            buttonTooltip="View changed pages"
-            // Like the other toolbar buttons: against the unscaled slot, with room to magnify.
-            buttonTooltipProps={
-                slot ? { anchor: slot.anchorRef, sideOffset: TOOLTIP_OFFSET } : undefined
-            }
            side="top"
            align="end"
            sideOffset={12}
@@ -5,7 +5,7 @@ import { useOnClickOutside } from 'usehooks-ts';

 import { Icon, type IconName, IconStyle } from '@gitbook/icons';

-import { ToolbarButton, useToolbarSlot } from './Toolbar';
+import { ToolbarButton, type ToolbarButtonProps } from './Toolbar';
 import styles from './Toolbar.module.css';
 import { useToolbarControls } from './ToolbarControlsContext';
 import { tcls } from '@/lib/tailwind';
@@ -26,11 +26,15 @@ const ARC_PARAMS = {
    offsetAnchorY: 40,
 } as const;

+interface HideToolbarButtonProps {
+    motionValues?: ToolbarButtonProps['motionValues'];
+}
+
 /**
 * Hide menu trigger. Expands a macOS Dock-like submenu with 3 labeled actions.
 */
-export function HideToolbarButton() {
-    const slot = useToolbarSlot();
+export function HideToolbarButton(props: HideToolbarButtonProps) {
+    const { motionValues } = props;
    const [open, setOpen] = React.useState(false);
    const [closing, setClosing] = React.useState(false);
    const controls = useToolbarControls();
@@ -110,8 +114,11 @@ export function HideToolbarButton() {
            : null,
    ].filter(Boolean) as ArcMenuItem[];

-    // The arc follows the button's push, but not its scale.
-    const sharedMotionStyle = slot ? { x: slot.x } : undefined;
+    const sharedMotionStyle = motionValues
+        ? {
+              x: motionValues.x,
+          }
+        : undefined;

    return (
        <ToolbarButton
@@ -129,6 +136,7 @@ export function HideToolbarButton() {
                    setOpen(true);
                }
            }}
+            motionValues={motionValues}
            icon="gear"
        >
            {/* Expanding arc menu */}
@@ -1,13 +1,16 @@
 'use client';
 import React from 'react';

-import { ToolbarButton } from './Toolbar';
+import { ToolbarButton, type ToolbarButtonProps } from './Toolbar';

 /**
 * Button to refresh the page if the content has been updated.
 */
-export function RefreshContentButton(props: { refreshForUpdates: () => Promise<void> }) {
-    const { refreshForUpdates } = props;
+export function RefreshContentButton(props: {
+    refreshForUpdates: () => Promise<void>;
+    motionValues?: ToolbarButtonProps['motionValues'];
+}) {
+    const { refreshForUpdates, motionValues } = props;

    const [loading, setLoading] = React.useState(false);

@@ -31,6 +34,7 @@ export function RefreshContentButton(props: { refreshForUpdates: () => Promise<v
                refresh();
            }}
            disabled={loading}
+            motionValues={motionValues}
            icon="rotate"
            iconClassName={loading ? 'animate-spin' : undefined}
        />
@@ -1,6 +1,12 @@
 'use client';
-import { type MotionValue, motion, useReducedMotion, useSpring } from 'motion/react';
-import React from 'react';
+import {
+    AnimatePresence,
+    type MotionValue,
+    motion,
+    useReducedMotion,
+    useSpring,
+} from 'motion/react';
+import React, { isValidElement } from 'react';

 import { Icon, type IconName, IconStyle } from '@gitbook/icons';

@@ -9,7 +15,7 @@ import { AnimatedLogo } from './AnimatedLogo';
 import { useToolbarControls } from './ToolbarControlsContext';
 import { ToolbarVisibilityHint } from './ToolbarVisibilityHint';
 import { getCopyVariants, toolbarEasings } from './transitions';
-import { TOOLTIP_OFFSET, useMagnificationEffect } from './useMagnificationEffect';
+import { useMagnificationEffect } from './useMagnificationEffect';
 import { tcls } from '@/lib/tailwind';

 const DURATION_LOGO_APPEARANCE = 2000;
@@ -102,93 +108,63 @@ export function Toolbar(props: ToolbarProps) {
    return (
        <motion.div
            data-testid="admin-toolbar"
-            // Centered with `inset-x-0 mx-auto`: at `left-1/2` it could only grow to half the viewport,
-            // which pushed the logo out of the pill.
-            className="fixed inset-x-0 bottom-5 z-40 mx-auto w-fit max-w-xl px-4"
+            className="fixed bottom-5 left-1/2 z-40 w-auto max-w-xl -translate-x-1/2 transform px-4"
        >
            <ToolbarVisibilityHint show={showHint} />

-            <motion.div
-                onClick={() => {
-                    if (minified) {
-                        setShouldAnimateLogo(false);
-                        onMinifiedChange(false);
-                    }
-                }}
-                // Only minifying and expanding animate: content width changes (e.g. the date
-                // format) would otherwise run a bouncy scale animation that stretches the content.
-                layout
-                layoutDependency={minified}
-                onLayoutAnimationComplete={() => {
-                    if (!minified) {
-                        setShowHint(true);
-                    }
-                }}
-                transition={toolbarEasings.spring}
-                className={tcls(
-                    minified ? 'cursor-pointer' : 'pr-2 pl-3.5',
-                    'relative',
-                    'flex',
-                    'items-center',
-                    'justify-center',
-                    'min-h-11',
-                    'min-w-12',
-                    'h-12',
-                    'py-2',
-                    'origin-center',
-                    'border-[0.5px] border-neutral-5 border-solid dark:border-neutral-8',
-                    'bg-[var(--toolbar-bg)]'
-                )}
-                style={PILL_STYLE}
-            >
-                {/* Logo — double-click to minimize */}
+            <AnimatePresence mode="wait">
                <motion.div
-                    layout
-                    layoutDependency={minified}
-                    onDoubleClick={(e) => {
-                        if (minified) return;
-                        e.stopPropagation();
-                        window.getSelection()?.removeAllRanges();
-                        onMinifiedChange(true);
+                    onClick={() => {
+                        if (minified) {
+                            setShouldAnimateLogo(false);
+                            onMinifiedChange(false);
+                        }
                    }}
+                    layout
+                    onLayoutAnimationComplete={() => {
+                        if (!minified) {
+                            setShowHint(true);
+                        }
+                    }}
+                    transition={toolbarEasings.spring}
+                    className={tcls(
+                        minified ? 'cursor-pointer' : 'pr-2 pl-3.5',
+                        'relative',
+                        'flex',
+                        'items-center',
+                        'justify-center',
+                        'min-h-11',
+                        'min-w-12',
+                        'h-12',
+                        'py-2',
+                        'origin-center',
+                        'border-[0.5px] border-neutral-5 border-solid dark:border-neutral-8',
+                        'bg-[var(--toolbar-bg)]'
+                    )}
+                    style={PILL_STYLE}
                >
-                    <AnimatedLogo shouldAnimate={shouldAnimateLogo} />
-                </motion.div>
-
-                {/* A layout child, so it's counter-scaled while the pill expands. */}
-                {!minified ? (
+                    {/* Logo — double-click to minimize */}
                    <motion.div
                        layout
-                        layoutDependency={minified}
-                        className="flex min-w-0 items-center"
+                        onDoubleClick={(e) => {
+                            if (minified) return;
+                            e.stopPropagation();
+                            window.getSelection()?.removeAllRanges();
+                            onMinifiedChange(true);
+                        }}
                    >
-                        {children}
+                        <AnimatedLogo shouldAnimate={shouldAnimateLogo} />
                    </motion.div>
-                ) : null}
-            </motion.div>
+
+                    {!minified ? children : null}
+                </motion.div>
+            </AnimatePresence>
        </motion.div>
    );
 }

 export function ToolbarBody(props: { children: React.ReactNode }) {
-    // Shrinks so a long title truncates, but keeps room for the longest date format.
-    return <div className="flex min-w-40 flex-col items-start px-3">{props.children}</div>;
-}
-
-const MAGNIFICATION_SPRING = { stiffness: 400, damping: 30 };
-
-/** A button's magnification, and the unscaled box to place its tooltip against. */
-type ToolbarSlot = {
-    scale: MotionValue<number>;
-    x: MotionValue<number>;
-    anchorRef: React.RefObject<HTMLDivElement | null>;
-};
-
-const ToolbarSlotContext = React.createContext<ToolbarSlot | null>(null);
-
-/** The magnification of the toolbar button group slot this is rendered in, if any. */
-export function useToolbarSlot() {
-    return React.useContext(ToolbarSlotContext);
+    return <div className="flex flex-col items-start px-3">{props.children}</div>;
 }

 export function ToolbarButtonGroup(props: { children: React.ReactNode }) {
@@ -196,8 +172,8 @@ export function ToolbarButtonGroup(props: { children: React.ReactNode }) {
    const containerRef = React.useRef<HTMLDivElement>(null);

    const buttonChildren = React.Children.toArray(children).filter((child) => !!child);
-    const { motionValues } = useMagnificationEffect({
-        slotCount: buttonChildren.length,
+    const { buttonMotionValues } = useMagnificationEffect({
+        childrenCount: buttonChildren.length,
        containerRef,
    });

@@ -207,51 +183,28 @@ export function ToolbarButtonGroup(props: { children: React.ReactNode }) {
            variants={toolbarEasings.parent}
            initial="hidden"
            animate="show"
-            // `relative`: the magnification measures slots by their `offsetLeft` in here.
-            className="relative flex items-center gap-1 overflow-visible pl-4 pr-2"
+            className="flex items-center gap-1 overflow-visible pl-4 pr-2"
        >
            {buttonChildren.map((child, index) => {
-                const values = motionValues[index];
-                return values ? (
-                    <ToolbarSlot
-                        key={React.isValidElement(child) && child.key ? child.key : index}
-                        scale={values.scale}
-                        x={values.x}
-                    >
-                        {child}
-                    </ToolbarSlot>
-                ) : null;
+                const childEl = child as React.ReactElement;
+                const childKey = childEl.key ?? `toolbar-button-${index}`;
+                return (
+                    <ToolbarButtonWrapper
+                        key={childKey}
+                        child={childEl}
+                        rawMotionValues={buttonMotionValues[index]}
+                    />
+                );
            })}
        </motion.div>
    );
 }

-/**
- * One button of a group: staggers in, and smooths its magnification for the button inside.
- * Collapses when the button renders nothing, so it leaves no gap.
- */
-function ToolbarSlot(props: {
-    scale: MotionValue<number>;
-    x: MotionValue<number>;
-    children: React.ReactNode;
-}) {
-    const anchorRef = React.useRef<HTMLDivElement>(null);
-    const scale = useSpring(props.scale, MAGNIFICATION_SPRING);
-    const x = useSpring(props.x, MAGNIFICATION_SPRING);
-    const slot = React.useMemo(() => ({ scale, x, anchorRef }), [scale, x]);
-
-    return (
-        <motion.div
-            ref={anchorRef}
-            variants={toolbarEasings.staggeringChild}
-            className="relative empty:hidden"
-        >
-            <ToolbarSlotContext.Provider value={slot}>{props.children}</ToolbarSlotContext.Provider>
-        </motion.div>
-    );
-}
-
 export interface ToolbarButtonProps extends Omit<React.HTMLProps<HTMLAnchorElement>, 'title'> {
+    motionValues?: {
+        scale: MotionValue<number>;
+        x: MotionValue<number>;
+    };
    icon: IconName;
    iconClassName?: string;
    title?: React.ReactNode;
@@ -259,10 +212,19 @@ export interface ToolbarButtonProps extends Omit<React.HTMLProps<HTMLAnchorEleme
 }

 export const ToolbarButton = React.forwardRef<HTMLDivElement, ToolbarButtonProps>((props, ref) => {
-    const { title, disabled, className, style, href, onClick, icon, iconClassName, children } =
-        props;
+    const {
+        title,
+        disabled,
+        motionValues,
+        className,
+        style,
+        href,
+        onClick,
+        icon,
+        iconClassName,
+        children,
+    } = props;
    const reduceMotion = useReducedMotion();
-    const slot = useToolbarSlot();

    const anchor = (
        <motion.a
@@ -271,11 +233,23 @@ export const ToolbarButton = React.forwardRef<HTMLDivElement, ToolbarButtonProps
            target="_blank"
            rel="noopener noreferrer"
            style={
-                reduceMotion || !slot
-                    ? style
-                    : { scale: slot.scale, x: slot.x, transformOrigin: 'bottom center', ...style }
+                reduceMotion
+                    ? undefined
+                    : {
+                          scale: motionValues?.scale,
+                          x: motionValues?.x,
+                          transformOrigin: 'bottom center',
+                          zIndex: motionValues?.scale ? 10 : 'auto',
+                          ...style,
+                      }
            }
+            transition={{
+                type: 'spring',
+                stiffness: 400,
+                damping: 30,
+            }}
            className={tcls(
+                'toolbar-button',
                className,
                'relative flex size-8 cursor-pointer items-center justify-center gap-1 truncate rounded-full text-sm transition-colors',
                'text-tint-7 hover:text-tint-1',
@@ -288,68 +262,75 @@ export const ToolbarButton = React.forwardRef<HTMLDivElement, ToolbarButtonProps
            <Icon
                icon={icon}
                iconStyle={IconStyle.Solid}
-                className={tcls('size-3.5 shrink-0', iconClassName)}
+                className={tcls('size-3.5 shrink-0 group-hover:scale-110', iconClassName)}
            />
        </motion.a>
    );

    return (
-        <div className="relative" ref={ref}>
+        <motion.div variants={toolbarEasings.staggeringChild} className="relative" ref={ref}>
            {children ? children : null}
-            {/* Anchored to the unscaled slot with room for full magnification, so the gap doesn't
-            depend on how far the spring has grown when the tooltip opens. */}
-            {title ? (
-                <Tooltip
-                    label={title}
-                    anchor={slot?.anchorRef}
-                    sideOffset={slot ? TOOLTIP_OFFSET : 4}
-                >
-                    {anchor}
-                </Tooltip>
-            ) : (
-                anchor
-            )}
-        </div>
+            {title ? <Tooltip label={title}>{anchor}</Tooltip> : anchor}
+        </motion.div>
    );
 });

 ToolbarButton.displayName = 'ToolbarButton';

-export function ToolbarTitle(props: {
-    prefix?: string;
-    /** What a short prefix stands for, e.g. "Change request #54" for "#54". */
-    prefixLabel?: string;
-    suffix: string;
+function ToolbarButtonWrapper(props: {
+    child: React.ReactElement;
+    rawMotionValues?: { scale: MotionValue<number>; x: MotionValue<number> };
 }) {
-    const { prefix, prefixLabel, suffix } = props;
-    // One tooltip for the whole title: the short prefix spelled out, and the full, often
-    // truncated, subject.
-    const label = prefixLabel ? (
-        <span className="flex flex-col">
-            <span className="opacity-70 text-xxs">{prefixLabel}</span>
-            <span className="font-medium">{suffix}</span>
-        </span>
-    ) : prefix ? (
-        `${prefix}${suffix}`
-    ) : (
-        suffix
-    );
+    const { child, rawMotionValues } = props;
+
+    // Convert the raw motion values to smooth spring easings
+    const springScale = useSpring(rawMotionValues?.scale.get() ?? 1, {
+        stiffness: 400,
+        damping: 30,
+    });
+    const springX = useSpring(rawMotionValues?.x.get() ?? 0, { stiffness: 400, damping: 30 });
+
+    // Sync springs with raw motion values
+    React.useEffect(() => {
+        if (!rawMotionValues) return;
+
+        const unsubScale = rawMotionValues.scale.on('change', (v) => springScale.set(v));
+        const unsubX = rawMotionValues.x.on('change', (v) => springX.set(v));
+
+        return () => {
+            unsubScale();
+            unsubX();
+        };
+    }, [rawMotionValues, springScale, springX]);
+
+    const motionValues = {
+        scale: springScale,
+        x: springX,
+    };
+
+    if (!isValidElement<{ motionValues: typeof motionValues }>(child)) {
+        return null;
+    }
+
+    return React.cloneElement(child, {
+        motionValues,
+    });
+}
+
+export function ToolbarTitle(props: { prefix?: string; suffix: string }) {
    return (
-        <Tooltip label={label}>
-            <div className="flex min-w-0 max-w-full items-center gap-1 text-xs">
-                {prefix ? <ToolbarTitlePrefix title={prefix} /> : null}
-                <ToolbarTitleSuffix title={suffix} />
-            </div>
-        </Tooltip>
+        <div className="flex items-center gap-1 text-xs">
+            {props.prefix ? <ToolbarTitlePrefix title={props.prefix} /> : null}
+            <ToolbarTitleSuffix title={props.suffix} />
+        </div>
    );
 }

 function ToolbarTitlePrefix(props: { title: string }) {
-    // Kept whole: prefixes are short, and the suffix is the one to truncate.
    return (
        <motion.span
            {...getCopyVariants(0)}
-            className="shrink-0 whitespace-nowrap font-medium text-neutral-1 dark:text-neutral-12"
+            className="truncate font-medium text-neutral-1 dark:text-neutral-12"
        >
            {props.title}
        </motion.span>
@@ -360,7 +341,7 @@ function ToolbarTitleSuffix(props: { title: string }) {
    return (
        <motion.span
            {...getCopyVariants(1)}
-            className="min-w-0 max-w-[28ch] truncate font-bold text-neutral-1 dark:text-neutral-12"
+            className="max-w-[20ch] truncate font-bold text-neutral-1 dark:text-neutral-12"
        >
            {props.title}
        </motion.span>
@@ -371,7 +352,7 @@ export function ToolbarSubtitle(props: { subtitle: React.ReactNode }) {
    return (
        <motion.span
            {...getCopyVariants(1)}
-            className="text-neutral-1/80 dark:text-neutral-12/80 flex min-w-0 max-w-full items-center gap-1 whitespace-nowrap text-xxs"
+            className="text-neutral-1/80 dark:text-neutral-12/80 inline-flex items-center gap-1 text-xxs"
        >
            {props.subtitle}
        </motion.span>
@@ -35,8 +35,7 @@ export function ToolbarDate(props: { value: string }) {

    return (
        <motion.div
-            // Never wraps: the longer formats push the author's name to truncate instead.
-            className="inline-flex shrink-0 items-center gap-1 whitespace-nowrap"
+            className="inline-flex items-center gap-1"
            onMouseEnter={() => setHovered(true)}
            onMouseLeave={() => setHovered(false)}
        >
@@ -76,7 +75,7 @@ export function ToolbarDate(props: { value: string }) {
                    setFormatIndex((i) => (i + 1) % DATE_FORMATS.length);
                }}
                transition={{ type: 'spring', stiffness: 300, damping: 25 }}
-                className="relative inline-flex cursor-pointer select-none overflow-hidden whitespace-nowrap font-semibold transition-colors hover:text-white" // `text-white` is used insead of dark-mode adapting values because the date is always in a dark-tinted toolbar
+                className="relative inline-flex cursor-pointer select-none overflow-hidden font-semibold transition-colors hover:text-white" // `text-white` is used insead of dark-mode adapting values because the date is always in a dark-tinted toolbar
            >
                <AnimatePresence mode="popLayout" initial={false}>
                    <motion.span
@@ -1,4 +1,4 @@
-import { type MotionValue, motionValue, useReducedMotion } from 'motion/react';
+import { type MotionValue, motionValue } from 'motion/react';
 import React from 'react';

 interface MagnificationConfig {
@@ -16,29 +16,40 @@ interface MagnificationConfig {
    padding?: number;
 }

-export const BUTTON_SIZE = 32;
-export const MAX_SCALE = 1.25;
-/** Tooltip gap above a slot, with room for the button fully magnified (it grows from the bottom). */
-export const TOOLTIP_OFFSET = 4 + BUTTON_SIZE * (MAX_SCALE - 1);
-
 const defaultConfig: Required<MagnificationConfig> = {
-    buttonSize: BUTTON_SIZE, // Standard button size for 32px (size-8) buttons
-    maxScale: MAX_SCALE, // 25% scale increase - noticeable but not overwhelming
+    buttonSize: 32, // Standard button size for 32px (size-8) buttons
+    maxScale: 1.25, // 25% scale increase - noticeable but not overwhelming
    influenceRadius: 80, // ~2.5 button widths of influence
    spacingMultiplier: 1.3, // Creates proportional spacing to scale increase
    scaleExponent: 2.5, // Exponential curve for dramatic close-range scaling
    padding: 10, // Small buffer zone around container edges
 };

-type SlotMotionValues = { scale: MotionValue<number>; x: MotionValue<number> };
-
-const resetMotionValues = (motionValues: SlotMotionValues[]) => {
+const resetMotionValues = (
+    motionValues: { scale: MotionValue<number>; x: MotionValue<number> }[]
+) => {
    motionValues.forEach(({ scale, x }) => {
        scale.set(1);
        x.set(0);
    });
 };

+const captureButtonPositions = (buttons: HTMLElement[]) => {
+    // Reset transforms to get original positions
+    buttons.forEach((button) => {
+        button.style.transform = '';
+    });
+    return buttons.map((button) => {
+        const rect = button.getBoundingClientRect();
+        return {
+            left: rect.left,
+            width: rect.width,
+            top: rect.top,
+            height: rect.height,
+        };
+    });
+};
+
 const calculateScale = (
    mouseX: number,
    buttonCenterX: number,
@@ -51,7 +62,8 @@ const calculateScale = (
    if (distance > config.influenceRadius) return 1;

    // Calculate distance from container edge (X-axis only)
-    const distanceFromEdge = Math.min(mouseX - containerRect.left, containerRect.right - mouseX);
+    const distanceFromEdgeX = Math.min(mouseX - containerRect.left, containerRect.right - mouseX);
+    const distanceFromEdge = distanceFromEdgeX;

    // Define the "heart" zone - 8px from center (16x16px total area)
    const heartZoneRadius = 8;
@@ -82,20 +94,24 @@ const calculateScale = (

 const calculateSpacing = (
    buttonIndex: number,
-    scales: number[],
-    centers: (number | null)[],
+    buttonEffects: { scale: number; translateX: number }[],
+    positions: { left: number; width: number; top: number; height: number }[],
    config: Required<MagnificationConfig>
 ) => {
-    const buttonCenterX = centers[buttonIndex];
-    if (buttonCenterX == null) return 0;
+    const currentPos = positions[buttonIndex];
+    if (!currentPos) return 0;

+    const buttonCenterX = currentPos.left + currentPos.width / 2;
    let leftPush = 0;
    let rightPush = 0;

-    scales.forEach((otherScale, otherIndex) => {
-        const otherCenterX = centers[otherIndex];
-        if (otherIndex === buttonIndex || otherCenterX == null) return;
+    buttonEffects.forEach((otherEffect, otherIndex) => {
+        if (otherIndex === buttonIndex) return;

+        const otherPos = positions[otherIndex];
+        if (!otherPos) return;
+
+        const otherCenterX = otherPos.left + otherPos.width / 2;
        const distanceBetween = Math.abs(buttonCenterX - otherCenterX);

        // Only apply influence if close enough
@@ -104,7 +120,7 @@ const calculateSpacing = (
                0,
                1 - distanceBetween / (config.influenceRadius * 1.5)
            );
-            const extraSpace = (otherScale - 1) * config.buttonSize;
+            const extraSpace = (otherEffect.scale - 1) * config.buttonSize;
            const pushAmount = (extraSpace / 2) * config.spacingMultiplier * influenceStrength;

            if (otherCenterX < buttonCenterX) {
@@ -118,88 +134,104 @@ const calculateSpacing = (
    return rightPush - leftPush;
 };

-/**
- * Dock-like magnification of the slots (direct children) of `containerRef`. Returns raw motion
- * values per slot index, meant to be smoothed with springs by the slots.
- */
 export function useMagnificationEffect(props: {
-    slotCount: number;
+    childrenCount: number;
    containerRef: React.RefObject<HTMLElement | null>;
    config?: MagnificationConfig;
 }) {
-    const { slotCount, containerRef, config } = props;
-    const reduceMotion = useReducedMotion();
+    const { childrenCount, containerRef, config } = props;
+    const originalPositionsRef = React.useRef<
+        { left: number; width: number; top: number; height: number }[]
+    >([]);
+
    const finalConfig = React.useMemo(() => ({ ...defaultConfig, ...config }), [config]);

-    // Stable across renders, grown as slots are added, so existing springs keep their source.
-    const motionValuesRef = React.useRef<SlotMotionValues[]>([]);
-    while (motionValuesRef.current.length < slotCount) {
-        motionValuesRef.current.push({ scale: motionValue(1), x: motionValue(0) });
-    }
-    const motionValues = motionValuesRef.current;
+    // Create basic motion values that will be consumed by springs in the components
+    const buttonMotionValues = React.useMemo(() => {
+        return Array.from({ length: childrenCount }, () => ({
+            scale: motionValue(1),
+            x: motionValue(0),
+        }));
+    }, [childrenCount]);

    React.useEffect(() => {
        const container = containerRef.current;
-        if (!container || reduceMotion) {
-            resetMotionValues(motionValues);
+        if (!container) return;
+
+        const buttons = Array.from(container.querySelectorAll('.toolbar-button')) as HTMLElement[];
+
+        if (buttons.length !== childrenCount) {
+            console.error(
+                `Button count (${buttons.length}) does not match children count (${childrenCount})`
+            );
            return;
        }

-        let frame = 0;
-        let pointer = { x: 0, y: 0 };
+        const handleMouseMove = (event: MouseEvent) => {
+            const buttons = Array.from(
+                container.querySelectorAll('.toolbar-button')
+            ) as HTMLElement[];

-        // Measured every frame from layout positions (`offsetLeft`), which the slots' transforms
-        // don't affect, so nothing goes stale when the toolbar resizes, re-centers or animates in.
-        const update = () => {
-            frame = 0;
-            const rect = container.getBoundingClientRect();
-            const inRange =
-                pointer.x >= rect.left - finalConfig.padding &&
-                pointer.x <= rect.right + finalConfig.padding &&
-                pointer.y >= rect.top - finalConfig.padding &&
-                pointer.y <= rect.bottom + finalConfig.padding;
-            if (!inRange) {
-                resetMotionValues(motionValues);
+            // Capture positions if needed
+            if (originalPositionsRef.current.length !== buttons.length) {
+                originalPositionsRef.current = captureButtonPositions(buttons);
+            }
+
+            const containerRect = container.getBoundingClientRect();
+            const { clientX: mouseX, clientY: mouseY } = event;
+
+            // Check if mouse is in range
+            const isInRange =
+                mouseX >= containerRect.left - finalConfig.padding &&
+                mouseX <= containerRect.right + finalConfig.padding &&
+                mouseY >= containerRect.top - finalConfig.padding &&
+                mouseY <= containerRect.bottom + finalConfig.padding;
+
+            if (!isInRange) {
+                resetMotionValues(buttonMotionValues);
                return;
            }

-            const slots = Array.from(container.children) as HTMLElement[];
-            // Empty or hidden slots take no space and don't magnify.
-            const centers = slots.map((slot) =>
-                slot.offsetWidth > 0 ? rect.left + slot.offsetLeft + slot.offsetWidth / 2 : null
-            );
-            const scales = centers.map((center) =>
-                center == null ? 1 : calculateScale(pointer.x, center, rect, finalConfig)
-            );
-            motionValues.forEach((values, index) => {
-                values.scale.set(scales[index] ?? 1);
-                values.x.set(calculateSpacing(index, scales, centers, finalConfig));
+            // Calculate scales for all buttons
+            const buttonEffects = buttons.map((_, index) => {
+                const pos = originalPositionsRef.current[index];
+                if (!pos) return { scale: 1, translateX: 0 };
+
+                const buttonCenterX = pos.left + pos.width / 2;
+                const scale = calculateScale(mouseX, buttonCenterX, containerRect, finalConfig);
+                return { scale, translateX: 0 };
+            });
+
+            // Calculate spacing for all buttons
+            buttonEffects.forEach((effect, index) => {
+                effect.translateX = calculateSpacing(
+                    index,
+                    buttonEffects,
+                    originalPositionsRef.current,
+                    finalConfig
+                );
+            });
+
+            // Update motion values
+            buttonEffects.forEach((effect, index) => {
+                const motionValue = buttonMotionValues[index];
+                if (motionValue) {
+                    motionValue.scale.set(effect.scale);
+                    motionValue.x.set(effect.translateX);
+                }
            });
        };

-        const onPointerMove = (event: PointerEvent) => {
-            if (event.pointerType !== 'mouse') {
-                return;
-            }
-            pointer = { x: event.clientX, y: event.clientY };
-            if (!frame) {
-                frame = requestAnimationFrame(update);
-            }
-        };
-        const onPointerLeave = () => {
-            cancelAnimationFrame(frame);
-            frame = 0;
-            resetMotionValues(motionValues);
-        };
+        const handleMouseLeave = () => resetMotionValues(buttonMotionValues);
+
+        container.addEventListener('mousemove', handleMouseMove);
+        container.addEventListener('mouseleave', handleMouseLeave);

-        container.addEventListener('pointermove', onPointerMove);
-        container.addEventListener('pointerleave', onPointerLeave);
        return () => {
-            cancelAnimationFrame(frame);
-            container.removeEventListener('pointermove', onPointerMove);
-            container.removeEventListener('pointerleave', onPointerLeave);
+            container.removeEventListener('mousemove', handleMouseMove);
+            container.removeEventListener('mouseleave', handleMouseLeave);
        };
-    }, [containerRef, finalConfig, motionValues, reduceMotion]);
+    }, [finalConfig, containerRef, buttonMotionValues, childrenCount]);

-    return { motionValues };
+    return { buttonMotionValues };
 }
@@ -247,15 +247,11 @@ async function renderMermaidDiagram(args: {
    const { source, id, darkMode, mermaidRuntimeURL } = args;
    const { mermaid } = await loadMermaid(mermaidRuntimeURL);

-    // Mermaid's default dark edge label pill only reaches 4.43:1 contrast, below WCAG AA.
-    const themeVariables = darkMode ? { edgeLabelBackground: '#3a3a3a' } : undefined;
-
    mermaid.initialize({
        startOnLoad: false,
        securityLevel: 'strict',
        darkMode,
        theme: darkMode ? 'dark' : undefined,
-        themeVariables,
    });

    const renderContainer = createMermaidRenderContainer();
@@ -1 +1 @@
-export const MERMAID_RUNTIME_PATH = 'mermaid/mermaid@11.16.1-patch.78ecb855-zenuml@0.2.2.mjs';
+export const MERMAID_RUNTIME_PATH = 'mermaid/mermaid@11.14.0-zenuml@0.2.2.mjs';
@@ -37,10 +37,7 @@ export async function Embed(props: BlockProps<gitbookAPI.DocumentBlockEmbed>) {
                <>
                    <div
                        dangerouslySetInnerHTML={{
-                            __html:
-                                context.mode !== 'print' && shouldLazyLoad(block.data.url)
-                                    ? lazyLoadIframes(embed.html)
-                                    : embed.html,
+                            __html: embed.html,
                        }}
                        data-visual-test="blackout"
                    />
@@ -76,23 +73,6 @@ export async function Embed(props: BlockProps<gitbookAPI.DocumentBlockEmbed>) {
    );
 }

-/**
- * Pages with many Loom embeds exhaust the browser's request budget
- * (ERR_INSUFFICIENT_RESOURCES) when every player loads at once, leaving some blank.
- */
-function lazyLoadIframes(html: string): string {
-    return html.replace(/<iframe\b(?![^>]*\bloading=)/gi, '<iframe loading="lazy"');
-}
-
-function shouldLazyLoad(url: string): boolean {
-    try {
-        const { hostname } = new URL(url);
-        return hostname === 'loom.com' || hostname.endsWith('.loom.com');
-    } catch {
-        return false;
-    }
-}
-
 /**
 * Create an integration block with an unfurl action from the GitBook Embed response.
 */
@@ -135,10 +135,10 @@ const HINT_STYLES: {
        header: 'bg-warning-active',
        body: [
            'text-neutral-strong',
-            'links-default:[&_a:not(.button)]:text-warning',
-            'links-default:[&_a:not(.button):hover]:text-warning-strong',
-            'links-default:[&_a:not(.button)]:decoration-warning/6',
-            'links-accent:[&_a:not(.button)]:decoration-warning',
+            'links-default:[&_a]:text-warning',
+            'links-default:[&_a:hover]:text-warning-strong',
+            'links-default:[&_a]:decoration-warning/6',
+            'links-accent:[&_a]:decoration-warning',
            'decoration-warning/6',
            '[&_.can-override-bg]:bg-warning-active',
            '[&_.can-override-text]:text-warning-strong',
@@ -152,10 +152,10 @@ const HINT_STYLES: {
        header: 'bg-danger-active',
        body: [
            'text-neutral-strong',
-            'links-default:[&_a:not(.button)]:text-danger',
-            'links-default:[&_a:not(.button):hover]:text-danger-strong',
-            'links-default:[&_a:not(.button)]:decoration-danger/6',
-            'links-accent:[&_a:not(.button)]:decoration-danger',
+            'links-default:[&_a]:text-danger',
+            'links-default:[&_a:hover]:text-danger-strong',
+            'links-default:[&_a]:decoration-danger/6',
+            'links-accent:[&_a]:decoration-danger',
            'decoration-danger/6',
            '[&_.can-override-bg]:bg-danger-active',
            '[&_.can-override-text]:text-danger-strong',
@@ -169,10 +169,10 @@ const HINT_STYLES: {
        header: 'bg-success-active',
        body: [
            'text-neutral-strong',
-            'links-default:[&_a:not(.button)]:text-success',
-            'links-default:[&_a:not(.button):hover]:text-success-strong',
-            'links-default:[&_a:not(.button)]:decoration-success/6',
-            'links-accent:[&_a:not(.button)]:decoration-success',
+            'links-default:[&_a]:text-success',
+            'links-default:[&_a:hover]:text-success-strong',
+            'links-default:[&_a]:decoration-success/6',
+            'links-accent:[&_a]:decoration-success',
            'decoration-success/6',
            '[&_.can-override-bg]:bg-success-active',
            '[&_.can-override-text]:text-success-strong',
@@ -13,14 +13,9 @@ const INPUT_SIZE_MAP: Record<NonNullable<ButtonProps['size']>, 'small' | 'medium
 };

 export function InlineActionButton(
-    props: {
-        action: 'ask' | 'search';
-        query?: string;
-        /** Where a search runs: the whole site, or only the space the visitor is reading. */
-        scope?: 'site' | 'space';
-    } & { buttonProps: ButtonProps } // TODO: Type this properly: Pick<api.DocumentInlineButton, 'action' | 'query'> & { buttonProps: ButtonProps }
+    props: { action: 'ask' | 'search'; query?: string } & { buttonProps: ButtonProps } // TODO: Type this properly: Pick<api.DocumentInlineButton, 'action' | 'query'> & { buttonProps: ButtonProps }
 ) {
-    const { action, query, scope, buttonProps } = props;
+    const { action, query, buttonProps } = props;

    const { assistants } = useAI();
    const chatState = useAIChatState();
@@ -34,7 +29,7 @@ export function InlineActionButton(
            setSearchState((prev) => ({
                ...prev,
                ask: null,
-                scope: scope === 'space' ? 'current' : 'default',
+                scope: 'default',
                query: value ?? query,
                open: true,
            }));
@@ -47,11 +47,6 @@ export function InlineButton(props: InlineProps<api.DocumentInlineButton>) {
                <InlineActionButton
                    action={inline.data.action.action}
                    query={inline.data.action.query ?? ''}
-                    scope={
-                        inline.data.action.action === 'search'
-                            ? inline.data.action.scope
-                            : undefined
-                    }
                    buttonProps={buttonProps}
                />
            );
@@ -52,8 +52,8 @@ export async function InlineLink(props: InlineProps<DocumentInlineLink>) {
    const anchorElement = (
        <InlineLinkAnchor
            href={resolved.href}
-            contentRef={resolved.resolvedRef ?? inline.data.ref}
-            isExternal={(resolved.resolvedRef ?? inline.data.ref).kind === 'url'}
+            contentRef={inline.data.ref}
+            isExternal={inline.data.ref.kind === 'url'}
        >
            {inlinesElement}
        </InlineLinkAnchor>
@@ -121,7 +121,7 @@ function InlineLinkTooltipWrapper(props: {

    let breadcrumbs = resolved.ancestors ?? [];
    const isMailto = resolved.href.startsWith('mailto:');
-    const isExternal = (resolved.resolvedRef ?? inline.data.ref).kind === 'url';
+    const isExternal = inline.data.ref.kind === 'url';
    const isSamePage = inline.data.ref.kind === 'anchor' && inline.data.ref.page === undefined;

    if (isMailto) {
@@ -52,14 +52,6 @@
    @apply relative;
 }

-.contentkit-webframe-container {
-    @apply relative;
-}
-
-.contentkit-webframe-loading {
-    @apply absolute inset-0 m-auto size-5 animate-spin;
-}
-
 /** Card */
 .contentkit-card {
    @apply flex flex-col border rounded border-tint-subtle;
@@ -4,11 +4,12 @@ import { CustomizationAIMode } from '@gitbook/api';
 import type { BlockProps } from './Block';
 import { Inlines } from './Inlines';
 import { getTextAlignment } from './utils';
+import { AskAIParagraphButton } from '@/components/AIChat/AskAIParagraphButton';
 import { getNodeText } from '@/lib/document';
 import { tcls } from '@/lib/tailwind';

 export function Paragraph(props: BlockProps<DocumentBlockParagraph>) {
-    const { block, style, ancestorBlocks, ...contextProps } = props;
+    const { block, style, ...contextProps } = props;
    const { context } = contextProps;

    const paragraph = (
@@ -27,8 +28,6 @@ export function Paragraph(props: BlockProps<DocumentBlockParagraph>) {
    const contentContext = context.contentContext;
    const aiAssistantEnabled =
        context.mode !== 'print' &&
-        // Table cells would clip the margin button, and big tables hold thousands of paragraphs.
-        !ancestorBlocks.some((ancestor) => ancestor.type === 'table') &&
        contentContext != null &&
        'customization' in contentContext &&
        contentContext.customization.ai.mode === CustomizationAIMode.Assistant;
@@ -39,8 +38,6 @@ export function Paragraph(props: BlockProps<DocumentBlockParagraph>) {
        // `self-center`/`self-end`) — otherwise centered paragraphs pin left on wide/no-TOC pages.
        return (
            <div
-                // The shared `AskAIParagraphButton` portals itself into the hovered wrapper.
-                data-ask-ai-paragraph=""
                className={tcls(
                    'group/ask-ai relative',
                    style,
@@ -48,6 +45,7 @@ export function Paragraph(props: BlockProps<DocumentBlockParagraph>) {
                )}
            >
                {paragraph}
+                <AskAIParagraphButton content={text} />
            </div>
        );
    }
@@ -50,7 +50,6 @@ export async function RecordColumnValue<Tag extends React.ElementType = 'div'>(
        tag: Tag = 'div',
        ariaLabelledBy,
        block,
-        ancestorBlocks,
        document,
        record,
        column,
@@ -152,7 +151,7 @@ export async function RecordColumnValue<Tag extends React.ElementType = 'div'>(
                <Blocks
                    tag={Tag}
                    document={document}
-                    ancestorBlocks={[...ancestorBlocks, block]}
+                    ancestorBlocks={[]}
                    nodes={fragment.nodes}
                    style={[
                        'blocks',
@@ -117,8 +117,8 @@ function Color(props: MarkedLeafProps<DocumentMarkColor>) {
    return (
        <span
            className={tcls([
-                textColorToStyle[mark.data.text ?? 'default'],
-                backgroundColorToStyle[mark.data.background ?? 'default'],
+                textColorToStyle[mark.data.text],
+                backgroundColorToStyle[mark.data.background],
            ])}
        >
            {children}
@@ -1,6 +1,6 @@
 import { expect, it } from 'bun:test';

-import type { DocumentBlockParagraph, DocumentBlockTable, JSONDocument } from '@gitbook/api';
+import type { DocumentBlockParagraph, JSONDocument } from '@gitbook/api';

 import { isBlockOffscreen } from './isBlockOffscreen';

@@ -42,31 +42,3 @@ it('should return true if block is offscreen', () => {
        )
    ).toBe(true);
 });
-
-it('should treat content in table cells as offscreen', () => {
-    const cell: DocumentBlockParagraph = {
-        object: 'block',
-        type: 'paragraph',
-        nodes: [],
-    };
-
-    const table: DocumentBlockTable = {
-        object: 'block',
-        type: 'table',
-        isVoid: true,
-        data: {
-            view: { type: 'cards', cardSize: 'medium', columns: ['column'] },
-            records: {},
-            definition: {},
-        },
-        fragments: [{ object: 'fragment', fragment: 'cell', nodes: [cell] }],
-    };
-
-    const document: JSONDocument = {
-        object: 'document',
-        nodes: [table],
-        data: {},
-    };
-
-    expect(isBlockOffscreen({ document, block: cell, ancestorBlocks: [table] })).toBe(true);
-});
@@ -18,11 +18,6 @@ export function isBlockOffscreen(
    },
    screenHeight = 500
 ): boolean {
-    // Cell content lives in fragments, not table nodes, so its row position can't be estimated.
-    if (ancestorBlocks.some((ancestor) => ancestor.type === 'table')) {
-        return true;
-    }
-
    let current = block;

    const allAncestors = [document, ...ancestorBlocks];
@@ -61,7 +61,9 @@ export function EmbeddableAIChat(props: EmbeddableAIChatProps) {
        }

        trackEvent(
-            { type: 'ask_view', trigger: 'embed' },
+            {
+                type: 'ask_view',
+            },
            {
                pageId: null,
                displayContext: api.SiteInsightsDisplayContext.Embed,
@@ -97,7 +97,6 @@ export async function EmbeddableDocsPage(
                                        ) ?? context.siteSpace
                                    }
                                    siteSpaces={variants.translations}
-                                    asEmbeddable
                                    className="my-1.5 ml-2 self-start"
                                />
                            ) : null}
@@ -126,7 +125,6 @@ export async function EmbeddableDocsPage(
                                            ) ?? context.siteSpace
                                        }
                                        siteSpaces={variants.translations}
-                                        asEmbeddable
                                        className="max-md:[&_.button-content]:block"
                                    />
                                ) : null
@@ -139,7 +137,6 @@ export async function EmbeddableDocsPage(
                                                context={context}
                                                siteSpace={context.siteSpace}
                                                siteSpaces={variants.generic}
-                                                asEmbeddable
                                                className="w-full px-3"
                                            />
                                        ) : null}
@@ -9,7 +9,6 @@ import type { GitBookEmbeddableConfiguration, ParentToFrameMessage } from '@gitb
 import { integrationsAssistantTools } from '../Integrations';
 import { Button, LinkContext, type LinkContextType } from '../primitives';
 import { getChannel } from './channel';
-import { DEFAULT_EMBEDDABLE_TABS, getEmbeddableLandingTab } from './getEmbeddableLandingTab';
 import { resolveEmbedPageLink } from './server-actions';
 import { useAI, useAIChatController } from '@/components/AI';
 import { isAIChatEnabled } from '@/components/utils/isAIChatEnabled';
@@ -24,17 +23,6 @@ const embeddableConfiguration = createStore<GitBookEmbeddableConfiguration>(() =
    trademark: true,
 }));

-const docsHome = createStore<{ reference?: string; href?: string }>(() => ({}));
-
-// Module-level so it survives the layout remounting on a cross-space navigation.
-let landed = false;
-
-function resolvePageHref(pagePath: string, baseURL: string): Promise<string> {
-    return resolveEmbedPageLink(pagePath)
-        .then((resolved) => ('href' in resolved ? resolved.href : `${baseURL}/page/${pagePath}`))
-        .catch(() => `${baseURL}/page/${pagePath}`);
-}
-
 // oxlint-disable-next-line typescript/no-explicit-any
 function log(...data: any[]) {
    // oxlint-disable-next-line no-console
@@ -78,15 +66,6 @@ export function EmbeddableIframeAPI(props: { baseURL: string }) {
            const { baseURL, router, chatController } = refs.current;
            const message = payload as ParentToFrameMessage;

-            const navigate = (href: Promise<string>) => {
-                const token = ++navToken.current;
-                href.then((href) => {
-                    if (navToken.current === token) {
-                        refs.current.router.push(href);
-                    }
-                });
-            };
-
            log('[gitbook] received message', message);

            switch (message.type) {
@@ -104,43 +83,29 @@ export function EmbeddableIframeAPI(props: { baseURL: string }) {
                    break;
                }
                case 'configure': {
-                    const { settings } = message;
-                    embeddableConfiguration.setState(settings);
+                    embeddableConfiguration.setState(message.settings);
                    integrationsAssistantTools.setState({
-                        tools: settings.tools,
+                        tools: message.settings.tools,
                    });
-
-                    const defaultPage =
-                        typeof settings.defaultPage === 'string' && settings.defaultPage
-                            ? settings.defaultPage
-                            : undefined;
-                    let docsHomeHref: Promise<string> | undefined;
-                    if (defaultPage !== docsHome.getState().reference) {
-                        docsHome.setState({ reference: defaultPage, href: undefined });
-                        if (defaultPage) {
-                            docsHomeHref = resolvePageHref(defaultPage, baseURL);
-                            docsHomeHref.then((href) => {
-                                if (docsHome.getState().reference === defaultPage) {
-                                    docsHome.setState({ href });
-                                }
-                            });
-                        }
-                    }
-
-                    if (!landed) {
-                        landed = true;
-                        const tab = getEmbeddableLandingTab(settings);
-                        if (tab === 'docs') {
-                            navigate(docsHomeHref ?? Promise.resolve(`${baseURL}/page/`));
-                        } else if (tab) {
-                            navToken.current++;
-                            router.push(`${baseURL}/${tab}`);
-                        }
-                    }
                    break;
                }
                case 'navigateToPage': {
-                    navigate(resolvePageHref(message.pagePath, baseURL));
+                    // Resolve the target server-side: on a multi-space site the page may
+                    // live in another space/section, whose base must go before
+                    // `~gitbook/embed/page`. Fall back to a same-space push on failure.
+                    const { pagePath } = message;
+                    const token = ++navToken.current;
+                    // Ignore the result if a later navigation has since superseded this one.
+                    const push = (href: string) => {
+                        if (navToken.current === token) {
+                            router.push(href);
+                        }
+                    };
+                    resolveEmbedPageLink(pagePath)
+                        .then((resolved) =>
+                            push('href' in resolved ? resolved.href : `${baseURL}/page/${pagePath}`)
+                        )
+                        .catch(() => push(`${baseURL}/page/${pagePath}`));
                    break;
                }
                case 'navigateToAssistant': {
@@ -167,7 +132,7 @@ export function useEmbeddableConfiguration<T = GitBookEmbeddableConfiguration>(

 export function useEmbeddableTabs() {
    const configuredTabs = useEmbeddableConfiguration((state) => state.tabs);
-    return configuredTabs.length > 0 ? configuredTabs : DEFAULT_EMBEDDABLE_TABS;
+    return configuredTabs.length > 0 ? configuredTabs : ['assistant', 'search', 'docs'];
 }

 export function useEmbeddableLinkContext() {
@@ -235,7 +200,6 @@ export function EmbeddableIframeTabs(props: {
    const { ref, active = 'assistant', baseURL, siteTitle, onNavigate } = props;
    const actions = useEmbeddableConfiguration((state) => state.actions);
    const tabs = useEmbeddableTabs();
-    const docsHomeHref = useStore(docsHome, (state) => state.href);

    const { assistants, config } = useAI();
    const language = useLanguage();
@@ -264,7 +228,7 @@ export function EmbeddableIframeTabs(props: {
                  key: 'docs',
                  label: siteTitle,
                  icon: 'book-open',
-                  href: docsHomeHref ?? `${baseURL}/page/`,
+                  href: `${baseURL}/page/`,
              }
            : null,
    ].filter((tab) => tab !== null);
@@ -1,8 +1,6 @@
 import type { CustomizationDefaultThemeMode } from '@gitbook/api';
 import { SiteInsightsTrademarkPlacement } from '@gitbook/api';

-import { AskAIParagraphButton } from '../AIChat';
-import { LoadIntegrations } from '../Integrations';
 import { NavigationLoader } from '../primitives/NavigationLoader';
 import { SpaceLayoutServerContext } from '../SpaceLayout';
 import { Trademark } from '../TableOfContents/Trademark';
@@ -78,7 +76,6 @@ export async function EmbeddableRootLayout({
                        }}
                    >
                        <NavigationLoader />
-                        <AskAIParagraphButton />
                        <VisibilityProvider className="fixed inset-0 flex flex-col">
                            {children}
                            {context.customization.trademark.enabled ? (
@@ -96,8 +93,6 @@ export async function EmbeddableRootLayout({
                        />
                    </SpaceLayoutServerContext>
                </EmbeddableAIContextProvider>
-                {/* Embeds load no integrations; this marks them loaded so search stops waiting. */}
-                <LoadIntegrations />
            </SiteLayoutClientContexts>
        </CustomizationRootLayout>
    );
@@ -1,39 +0,0 @@
-import { describe, expect, it } from 'bun:test';
-
-import { getEmbeddableLandingTab } from './getEmbeddableLandingTab';
-
-describe('getEmbeddableLandingTab', () => {
-    it('keeps the embed default when nothing is configured', () => {
-        expect(getEmbeddableLandingTab({})).toBeNull();
-        expect(getEmbeddableLandingTab({ tabs: ['docs', 'search'] })).toBeNull();
-    });
-
-    it('opens on the configured tab', () => {
-        expect(getEmbeddableLandingTab({ defaultTab: 'search' })).toBe('search');
-        expect(
-            getEmbeddableLandingTab({ tabs: ['assistant', 'search', 'docs'], defaultTab: 'search' })
-        ).toBe('search');
-    });
-
-    it('opens on the docs when only a default page is set', () => {
-        expect(getEmbeddableLandingTab({ defaultPage: 'getting-started' })).toBe('docs');
-    });
-
-    it('prefers the configured tab over the default page', () => {
-        expect(
-            getEmbeddableLandingTab({ defaultTab: 'assistant', defaultPage: 'getting-started' })
-        ).toBe('assistant');
-    });
-
-    it('ignores a tab that is not enabled', () => {
-        expect(getEmbeddableLandingTab({ tabs: ['assistant'], defaultTab: 'search' })).toBeNull();
-        expect(
-            getEmbeddableLandingTab({ tabs: ['assistant', 'search'], defaultPage: 'quickstart' })
-        ).toBeNull();
-    });
-
-    it('ignores an unknown tab', () => {
-        // @ts-expect-error - the parent window is plain JS and can send anything.
-        expect(getEmbeddableLandingTab({ defaultTab: 'settings' })).toBeNull();
-    });
-});
@@ -1,17 +0,0 @@
-import type { GitBookEmbeddableConfiguration } from '@gitbook/embed';
-
-export type EmbeddableTab = GitBookEmbeddableConfiguration['tabs'][number];
-
-export const DEFAULT_EMBEDDABLE_TABS: EmbeddableTab[] = ['assistant', 'search', 'docs'];
-
-export function getEmbeddableLandingTab(
-    settings: Partial<Pick<GitBookEmbeddableConfiguration, 'tabs' | 'defaultTab' | 'defaultPage'>>
-): EmbeddableTab | null {
-    const tab = settings.defaultTab ?? (settings.defaultPage ? 'docs' : undefined);
-    if (!tab || !DEFAULT_EMBEDDABLE_TABS.includes(tab)) {
-        return null;
-    }
-
-    const tabs = settings.tabs?.length ? settings.tabs : DEFAULT_EMBEDDABLE_TABS;
-    return tabs.includes(tab) ? tab : null;
-}
@@ -2,10 +2,9 @@ import type { SiteSpace } from '@gitbook/api';
 import type { IconName } from '@gitbook/icons';

 import type { ButtonProps } from '../primitives';
-import { getTargetURLForSiteSpace } from '../SiteSections/encodeClientSiteSections';
 import { SpacesDropdownClient } from './SpacesDropdownClient';
 import type { GitBookSiteContext } from '@/lib/context';
-import { getLocalizedTitle } from '@/lib/sites';
+import { getLocalizedTitle, getSiteSpaceURL } from '@/lib/sites';
 import { tcls } from '@/lib/tailwind';

 // Memoized regex for checking if a string starts with an emoji
@@ -21,18 +20,9 @@ export function SpacesDropdown(
        siteSpace: SiteSpace;
        siteSpaces: SiteSpace[];
        className?: string;
-        /** Keep the links inside the embed rather than sending readers to the full site. */
-        asEmbeddable?: boolean;
    } & ButtonProps
 ) {
-    const {
-        context,
-        siteSpace,
-        siteSpaces,
-        className,
-        asEmbeddable = false,
-        ...buttonProps
-    } = props;
+    const { context, siteSpace, siteSpaces, className, ...buttonProps } = props;
    const currentLanguage = context.locale;

    const dropdownClassName = tcls(
@@ -43,7 +33,7 @@ export function SpacesDropdown(
    const slimSpaces = siteSpaces.map((siteSp) => ({
        id: siteSp.id,
        title: getLocalizedTitle(siteSp, currentLanguage),
-        url: getTargetURLForSiteSpace(context, siteSp, asEmbeddable),
+        url: getSiteSpaceURL(context, siteSp),
        isActive: siteSp.id === siteSpace.id,
        spaceId: siteSp.space.id,
    }));
@@ -67,10 +57,9 @@ export function TranslationsDropdown(
        siteSpace: SiteSpace;
        siteSpaces: SiteSpace[];
        className?: string;
-        asEmbeddable?: boolean;
    } & ButtonProps
 ) {
-    const { context, siteSpace, siteSpaces, className, asEmbeddable, ...buttonProps } = props;
+    const { context, siteSpace, siteSpaces, className, ...buttonProps } = props;

    const title = getLocalizedTitle(siteSpace, context.locale);
    const hasEmojiPrefix = startsWithEmoji(title);
@@ -81,7 +70,6 @@ export function TranslationsDropdown(
            context={context}
            siteSpace={siteSpace}
            siteSpaces={siteSpaces}
-            asEmbeddable={asEmbeddable}
            variant="blank"
            className={tcls(
                'bg-transparent lg:max-w-64 max-md:[&_.button-content]:hidden',
@@ -4,7 +4,6 @@ import * as React from 'react';
 import { useDebounceCallback, useEventCallback } from 'usehooks-ts';

 import type * as api from '@gitbook/api';
-import { SiteInsightsDisplayContext } from '@gitbook/api';
 import { OpenAPIOperationContextProvider } from '@gitbook/react-openapi';

 import { type CurrentContentContext, useCurrentContent } from '../hooks';
@@ -76,15 +75,12 @@ export function InsightsProvider(props: InsightsProviderProps) {
        [pathname: string]:
            | {
                  url: string;
-                  previousUrl: string | null;
                  events: TrackEventInput<InsightsEventName>[];
                  context: CurrentContentContext;
                  pageContext?: InsightsEventPageContext;
              }
            | undefined;
    }>({});
-    // Href of the last page an event was tracked on; `undefined` until the first event.
-    const lastUrlRef = React.useRef<string | null | undefined>(undefined);

    /**
     * Synchronously flush all the pending events.
@@ -109,7 +105,6 @@ export function InsightsProvider(props: InsightsProviderProps) {
            allEvents.push(
                ...transformEvents({
                    url: eventsForPathname.url,
-                    previousUrl: eventsForPathname.previousUrl,
                    events: eventsForPathname.events,
                    context: currentContent,
                    pageContext: eventsForPathname.pageContext,
@@ -159,9 +154,6 @@ export function InsightsProvider(props: InsightsProviderProps) {
        ) => {
            const pathname = window.location.pathname;
            const previous = eventsRef.current[pathname];
-            const lastUrl =
-                lastUrlRef.current === undefined ? getSameOriginReferrer() : lastUrlRef.current;
-            lastUrlRef.current = window.location.href;
            eventsRef.current[pathname] = {
                // An explicitly-provided context wins so page-scoped events (e.g. feedback) can
                // attribute to their page even when the pathname's ambient context has none — such
@@ -169,7 +161,6 @@ export function InsightsProvider(props: InsightsProviderProps) {
                // context keep the stored one.
                pageContext: ctx ?? previous?.pageContext,
                url: previous?.url ?? window.location.href,
-                previousUrl: previous ? previous.previousUrl : lastUrl,
                events: [
                    ...(previous?.events ?? []),
                    {
@@ -223,18 +214,6 @@ export function useTrackEvent(): TrackEventCallback {
    return React.useContext(InsightsContext);
 }

-/**
- * The referrer when it's another page of this origin, so a full page load (e.g. an absolute link
- * to a missing page) still records the page it came from.
- */
-function getSameOriginReferrer(): string | null {
-    if (document.referrer === window.location.href || !URL.canParse(document.referrer)) {
-        return null;
-    }
-    const referrer = new URL(document.referrer);
-    return referrer.origin === window.location.origin ? referrer.href : null;
-}
-
 /**
 * Post the events to the server.
 */
@@ -261,7 +240,6 @@ function sendEvents(args: { eventUrl: string; events: api.SiteInsightsEvent[] })
 */
 function transformEvents(input: {
    url: string;
-    previousUrl: string | null;
    events: TrackEventInput<InsightsEventName>[];
    context: CurrentContentContext;
    pageContext: InsightsEventPageContext;
@@ -280,11 +258,6 @@ function transformEvents(input: {

    const location: api.SiteInsightsEventLocation = {
        url: input.url,
-        // The embed's navigation is between its own tabs, not pages of the site.
-        previousUrl:
-            input.pageContext.displayContext === SiteInsightsDisplayContext.Embed
-                ? null
-                : input.previousUrl,
        siteSection: input.context.siteSectionId ?? null,
        siteSpace: input.context.siteSpaceId ?? null,
        space: input.context.spaceId,
@@ -147,10 +147,6 @@ export function useCustomCookieBanner(): CustomCookieBannerStore {
 export function LoadIntegrations() {
    React.useEffect(() => {
        return whenIntegrationsReady(() => {
-            // Integrations must only receive `load` once, even if this is mounted twice.
-            if (integrationsStore.getState().loaded) {
-                return;
-            }
            dispatchGitBookIntegrationEvent('load');
            integrationsStore.setState({ loaded: true });
        });
@@ -67,7 +67,7 @@ export function ActionOpenAssistant(props: {
                        href: page.href,
                    });
                }
-                assistant.open(undefined, 'page');
+                assistant.open();
            }}
        />
    );
@@ -1,8 +1,4 @@
-import {
-    type JSONDocument,
-    type RevisionPageDocument,
-    SiteInsightsDisplayContext,
-} from '@gitbook/api';
+import type { JSONDocument, RevisionPageDocument, SiteInsightsDisplayContext } from '@gitbook/api';

 import { DocumentView, DocumentViewSkeleton } from '../DocumentView';
 import { CurrentPageProvider } from '../hooks/useCurrentPage';
@@ -131,7 +127,6 @@ export async function PageBody(props: {
                        ancestors={ancestors}
                        withRSSFeed={contentHasUpdates}
                        hasAPIBlocks={hasAPIBlocks}
-                        asEmbeddable={insightsDisplayContext === SiteInsightsDisplayContext.Embed}
                    />
                    {document && !isNodeEmpty(document) ? (
                        <OptionalSuspense
--- a/Show More
+++ b/Show More