wip

Fix logo sizing bug during navigation
2026-09-16 07:35:16 +00:00 · 2026-02-12 09:40:27 +01:00 · 2026-01-21 20:25:17 +01:00
699 changed files with 10060 additions and 45857 deletions
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Scroll to an in-page heading even when the URL hash is unchanged (e.g. clicking the same anchor again).
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Force software rendering (SwiftShader) in Playwright Chromium to eliminate image downscaling drift between GPU-equipped local runs and headless CI runs in Argos screenshots.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add an assistant tool to rate its own previous response when the user reacts to it.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add an assistant tool to submit feedback about the current page on behalf of the user.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Assistant: you can now send follow-up questions while an answer is still being written. Each one appears as your own message with a "Queued" badge (hover for when it will send, × to cancel), and they're sent automatically one at a time as each answer completes.
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Add a carousel layout option to cards blocks, rendering them as a horizontally-scrolling, scroll-snapping row instead of a wrapping grid.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Assistant: the "Explored briefly" activity heading no longer appears when there's nothing to show. It now renders only when the answer is preceded by a real preamble or one or more tool calls, so a simple answer with an empty reasoning step no longer surfaces an empty collapsible.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Add sidesheet component, use it for TOC and AIChat
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the docs embed `navigateToPage` API on multi-space sites. Deep-linking to a page in a different space/section (e.g. `navigateToPage('/help-center/integrations')`) previously 404'd because the section base was not placed before `~gitbook/embed/page`. The target is now resolved to its space server-side, so pages in any space resolve correctly. The input accepts the page path, an absolute path, or the full published URL.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add configurable default visibility to Prompt block
@@ -1,6 +0,0 @@
---
-"@gitbook/colors": patch
-"gitbook": patch
---
-
-A near-white tint color (e.g. a warm `#F5F3EF`) is now taken as the exact page background, mirroring the existing behavior for near-black tints. The tint's exact lightness, hue and chroma are preserved, and the color is anchored to whichever scale step the active theme renders as the background — so it matches exactly on `muted` (which uses the second step) as well as `clean`. This applies only to near-neutral tints that are light enough to read as a background; saturated or merely light-ish colors keep their normal accent scale. The `bold` theme is unaffected: it already uses the tint for the header and stays intentionally two-tone.
@@ -1,7 +0,0 @@
---
-"gitbook": patch
---
-
-Introduce client-side content selection (`select`): a site-wide, recency-ordered list of selected slugs, persisted in localStorage and shareable via `?select=`, applied to `<html>` before first paint so the right variant renders with no flash. All variants stay server-rendered, so pages are byte-identical for every visitor (no cache impact).
-
-Tabs now use it: switching a tab activates its slug, and every tab group offering that slug follows, across pages. Tabs no longer write to the URL fragment (`#` returns to anchors only); deep-links into a tab still activate and scroll to it.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Set <html lang> based on translated language
@@ -1,7 +0,0 @@
---
-"@gitbook/openapi-parser": patch
-"@gitbook/react-openapi": patch
-"gitbook": patch
---
-
-Add missing link reference to OpenAPI models
@@ -0,0 +1,5 @@
+---
+"@gitbook/embed": patch
+---
+
+Fix signed JWT token usage
@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Serve a markdown version of the page when the "Accept" header contains "text/markdown".
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Align styling of PageLinkItem and PageDocumentItem
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Update the URL hash when a tab is selected, so a copied link scrolls back to that tab
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Better conditional display of page actions
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add cover image background mode and masks
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Button blocks now respect the `size` option, so you can render small, medium, or large buttons.
@@ -1,7 +0,0 @@
---
-"@gitbook/browser-types": patch
-"@gitbook/embed": patch
-"gitbook": patch
---
-
-Add an optional `context` property (string, up to 512 characters) to the `confirmation` of custom AI tools, shown above the confirmation dialog to help the user understand what they are approving or rejecting. The `confirmation` can now also be a function that receives the AI-provided input and returns the confirmation, so the context can be derived dynamically from the arguments the tool is about to run with. Available both to integrations (`GitBookIntegrationTool`) and to embed consumers (`GitBookToolDefinition`).
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Lazy-load the Mermaid code block so pages that have code blocks but no diagram no longer ship its rendering dependencies.
@@ -1,8 +0,0 @@
---
-"@gitbook/react-openapi": major
-"gitbook": patch
---
-
-Lazy load the Scalar API client modal and stop preloading the Scalar runtime. The modal is now code-split into its own chunk, fetched in parallel with the runtime only when a reader clicks "Test it", and a spinner is shown on the button until the client opens.
-
-Breaking: the package no longer ships the modal in its main entry — consumers must serve the emitted `ScalarApiModal` chunk and use a bundler that supports dynamic `import()`, and the Scalar runtime is no longer preloaded on page load. The internal `preloadScalarRuntime` helper is removed.
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Add an `askQuestion` tool to the site MCP server. Alongside `searchDocumentation` and `getPage`, MCP clients can now ask a natural-language question and get a synthesized answer with links to the source pages, powered by the same AI search backend as the site's "ask a question" experience. The tool accepts an optional `goal` param so calling agents can attach the intent they're trying to accomplish, which tailors the answer and is tracked in analytics. The tool is only exposed on sites that have AI enabled.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Submit `sendFeedback` MCP tool findings through the dedicated `submitSiteAgentFeedback` API endpoint. The `pageUrl` is now required and an optional `goal` can be provided.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Persist content selection (tabs and other `select` blocks) in localStorage only, dropping the `?select=` query parameter from the URL. A tab click still writes the tab's hash, so a copied URL lands on that tab and reactivates it on load.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Serve `X-Robots-Tag: noindex` on internal search/assistant URLs (`?q=` / `?ask=`) and stop disallowing them in robots.txt, so Google can crawl the directive and drop them from the index instead of reporting "Indexed, though blocked by robots.txt".
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the variant switcher linking to the wrong URL for non-default variants of the default section
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add an "On this page" table of contents on OpenAPI models pages. Each model in a grouped/multi-model "Models" section is now listed as its own section, matching operations and webhooks.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Improve cookie handling in the OpenAPI "Test it" request proxy.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Serve the OpenAPI "Test it" request proxy from GitBook's own domain.
@@ -1,6 +0,0 @@
---
-"gitbook": patch
-"@gitbook/react-openapi": minor
---
-
-Keep the OpenAPI renderer out of the initial bundle of pages that have no OpenAPI block, by building its context on the client behind a dynamic boundary.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix text disappearing in Firefox and iOS Safari on pages with a background cover
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Standardise toggle chevrons across the app
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Remove GBO's redundant re-selection of the best-scoring search section. The search API now returns a single highest-scoring section per page (and orders sections highest-score-first), so GBO no longer needs its own `getBestScoredResult` helper to pick the best section for the search and MCP previews. No user-visible change.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Sync the API reference responses selector with the "Responses" collapsibles, and keep the selected response in sync across every operation on the page (like the code sample language selector). Selecting a status code now expands the matching response section and applies to all operations at once.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix a light/dark flash on published sites configured to respect the system default (no theme toggle). Such sites forced the `system` theme, but `next-themes`' pre-paint script applies a forced value verbatim without resolving `prefers-color-scheme`, so the page painted light and only switched to dark after hydration. We now leave the theme unforced when the default is `system` (only concrete light/dark themes are forced), letting `next-themes`' existing pre-paint script resolve the system preference before first paint.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add a `sendFeedback` MCP tool so AI agents can report documentation findings (outdated / incoherent / gap / other) as `agent_feedback` insights events. The tool only accepts finding categories, so it never records positive feedback.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Separate the prompt block actions into a primary "Open in" dropdown and a secondary "Copy prompt" button, instead of a single combined button group, and align the block's design with the expandable block (bordered frame, left disclosure chevron, and subtle elevation when expanded).
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix the docs embed widget shipping a stale script: declare the embed package's `standalone/` bundle as a Turbo build output. Because it wasn't declared, changes confined to the standalone widget (which compiles to `standalone/` but not `dist/`) didn't invalidate the downstream `generate` cache that copies it into the app, so the deployed widget could lag the source — e.g. the `clipboard-write` permission on the widget iframe never reached production, breaking the copy button in the Assistant embed.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix ScrollContainer scroll buttons not reflecting content overflow immediately or after dynamic content changes (e.g. search results).
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Keep the last search query visible after closing search, and restore it when reopening, without breaking navigation when clicking a search result.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Keep Shiki out of the initial page bundle by splitting the highlighter from the plain-text token helpers, so client code no longer pulls the engine and language bundles in through a shared import.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Refine the per-paragraph AI ask button: shorten its tooltip to "Ask" (from "Ask <assistant> about this"), and hide it inside cards where it would otherwise be clipped by the card's overflow.
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Grow InlineActionButton to take available width on line
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Split the default-scope site search into two parallel API requests — one restricted to the current site space and one for the other site spaces — rendering each result set as soon as its response arrives. All results are ranked together by score, with the current site space scores boosted.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Keep the "On this page" and "Ask" buttons pinned below the header while scrolling on desktop API reference pages, so the page outline stays reachable throughout long operations.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Hide unfocusable unlabelled button from screen readers
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Only show the "Back to [space]" shortcut for cross-space links in the table of contents, not for in-content text links or other ways of reaching another space.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Show image thumbnails, including SVG previews, for file attachments on published sites.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Make the table search "no results" empty state more prominent with vertical spacing so it no longer blends into the content below.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix heading anchor links being unreachable on touch devices by adding a tap-to-reveal state. The anchor icon now appears after the heading text without wrapping onto an orphan line while retaining its existing desktop placement. Use `pointerup` for the dismiss listener to fix unreliable dismissal on iOS Safari, and enlarge the anchor's touch tap target to a square 24px area (meeting the WCAG 2.5.8 minimum) so the icon stays centered instead of overflowing shorter headings' line height.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix search results from a previous scope staying stuck on top of the new results when switching the search filter.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-a11y screen reader fixes
@@ -1,6 +0,0 @@
---
-"@gitbook/react-contentkit": patch
-"gitbook": patch
---
-
-Let integration block webframes navigate the reader to another page in the site by posting a `@webframe.navigate` action with a `path` (and optional `anchor`). Resolved client-side against the site base path, so navigation stays in-site and drives the standard navigation progress bar.
@@ -1,6 +0,0 @@
---
-"@gitbook/react-contentkit": patch
-"gitbook": patch
---
-
-Expose the current page (`id`, `path`, `title`) to integration block webframes through the client-only webframe `state.page`, alongside adaptive visitor claims.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix an issue where certain keywords could cause an exception when rendering emojis
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add the `select` action to InlineButton. Clicking the button activates its slug, so any block containing that slug switches to it.
@@ -1,12 +0,0 @@
-{
-    "version": "0.0.1",
-    "configurations": [
-        {
-            "name": "🚀 Dev server",
-            "runtimeExecutable": "sh",
-            "runtimeArgs": ["-c", "bun install && bun dev"],
-            "port": 3000,
-            "autoPort": false
-        }
-    ]
-}
@@ -26,7 +26,7 @@ inputs:
    description: 'Commit message to associate with the deployment'
    required: true
 outputs:
-    deployment-url:
+    deployment-url: 
      description: "Deployment URL"
      value: ${{ steps.upload_middleware.outputs.deployment-url }}
 runs:
@@ -52,14 +52,9 @@ runs:
            GITBOOK_API_URL: ${{ inputs.opItem }}/GITBOOK_API_URL
            GITBOOK_API_PUBLIC_URL: ${{ inputs.opItem }}/GITBOOK_API_PUBLIC_URL
            GITBOOK_API_TOKEN: ${{ inputs.opItem }}/GITBOOK_API_TOKEN
-            GITBOOK_OAUTH_SERVER_URL: ${{ inputs.opItem }}/GITBOOK_OAUTH_SERVER_URL
-            GITBOOK_SITE_OAUTH_SIGNING_SECRET: ${{ inputs.opItem }}/GITBOOK_SITE_OAUTH_SIGNING_SECRET
-            GITBOOK_PREVIEW_BASE_URL: ${{ inputs.opItem }}/GITBOOK_PREVIEW_BASE_URL
            GITBOOK_INTEGRATIONS_HOST: ${{ inputs.opItem }}/GITBOOK_INTEGRATIONS_HOST
-            GITBOOK_INTEGRATIONS_CONTENT_HOST: ${{ inputs.opItem }}/GITBOOK_INTEGRATIONS_CONTENT_HOST
            GITBOOK_IMAGE_RESIZE_SIGNING_KEY: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_SIGNING_KEY
-            GITBOOK_IMAGE_RESIZE_URL: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_URL_2
-            GITBOOK_IMAGE_RESIZE_SALT: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_SALT
+            GITBOOK_IMAGE_RESIZE_URL: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_URL
            GITBOOK_IMAGE_RESIZE_MODE: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_MODE
            GITBOOK_ASSETS_PREFIX: ${{ inputs.opItem }}/GITBOOK_ASSETS_PREFIX
            GITBOOK_FONTS_URL: ${{ inputs.opItem }}/GITBOOK_FONTS_URL
@@ -67,8 +62,6 @@ runs:
          run: bun run turbo build:cloudflare
          env:
            GITBOOK_RUNTIME: cloudflare
-            GITBOOK_BLOCK_SEARCH_INDEXATION: ${{ inputs.environment == 'preview' && 'true' || '' }}
-            GITBOOK_ALLOW_CUSTOMIZATION_OVERRIDE: ${{ inputs.environment == 'preview' && 'true' || '' }}
          shell: bash

        - name: Upload the DO worker
@@ -114,7 +107,7 @@ runs:
              wranglerVersion: '4.43.0'
              environment: ${{ inputs.environment }}
              command: ${{ format('versions upload --tag {0} --message "{1}"', inputs.commitTag, inputs.commitMessage) }} --config ./packages/gitbook/openNext/customWorkers/middlewareWrangler.jsonc
-
+        
        - name: Extract middleware version worker ID
          shell: bash
          id: extract_middleware_version_id
@@ -19,11 +19,8 @@ inputs:
  environment:
    description: 'Environment to deploy to'
    required: true
-  headSha:
-    description: 'Git ref to deploy, used for the deploymentId'
-    required: false
 outputs:
-    deployment-url:
+    deployment-url: 
      description: "Deployment URL"
      value: ${{ steps.deploy.outputs.deployment-url }}
 runs:
@@ -54,29 +51,12 @@ runs:
            GITBOOK_API_URL: ${{ inputs.opItem }}/GITBOOK_API_URL
            GITBOOK_API_PUBLIC_URL: ${{ inputs.opItem }}/GITBOOK_API_PUBLIC_URL
            GITBOOK_API_TOKEN: ${{ inputs.opItem }}/GITBOOK_API_TOKEN
-            GITBOOK_OAUTH_SERVER_URL: ${{ inputs.opItem }}/GITBOOK_OAUTH_SERVER_URL
-            GITBOOK_SITE_OAUTH_SIGNING_SECRET: ${{ inputs.opItem }}/GITBOOK_SITE_OAUTH_SIGNING_SECRET
-            GITBOOK_PREVIEW_BASE_URL: ${{ inputs.opItem }}/GITBOOK_PREVIEW_BASE_URL
            GITBOOK_INTEGRATIONS_HOST: ${{ inputs.opItem }}/GITBOOK_INTEGRATIONS_HOST
-            GITBOOK_INTEGRATIONS_CONTENT_HOST: ${{ inputs.opItem }}/GITBOOK_INTEGRATIONS_CONTENT_HOST
            GITBOOK_IMAGE_RESIZE_SIGNING_KEY: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_SIGNING_KEY
-            GITBOOK_IMAGE_RESIZE_URL: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_URL_2
-            GITBOOK_IMAGE_RESIZE_SALT: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_SALT
+            GITBOOK_IMAGE_RESIZE_URL: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_URL
            GITBOOK_IMAGE_RESIZE_MODE: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_MODE
            GITBOOK_ASSETS_PREFIX: ${{ inputs.opItem }}/GITBOOK_ASSETS_PREFIX
            GITBOOK_FONTS_URL: ${{ inputs.opItem }}/GITBOOK_FONTS_URL
-        - name: Inject build env vars
-          if: ${{ inputs.environment == 'preview' }}
-          shell: bash
-          run: |
-            HEAD_SHA=$(git rev-parse HEAD)
-            echo "resolved HEAD_SHA: $HEAD_SHA"
-            echo "GITBOOK_HEAD_SHA=$HEAD_SHA" >> .vercel/.env.${{ inputs.environment }}.local
-            echo "GITBOOK_RUNTIME=vercel" >> .vercel/.env.${{ inputs.environment }}.local
-            echo "GITBOOK_BLOCK_SEARCH_INDEXATION=true" >> .vercel/.env.${{ inputs.environment }}.local
-            echo "GITBOOK_ALLOW_CUSTOMIZATION_OVERRIDE=true" >> .vercel/.env.${{ inputs.environment }}.local
-            echo "--- .vercel/.env.${{ inputs.environment }}.local after inject ---"
-            cat .vercel/.env.${{ inputs.environment }}.local
        - name: Build Project Artifacts
          run: bun run vercel build --target=${{ inputs.environment }} --token=${{ inputs.vercelToken }}
          shell: bash
@@ -84,7 +64,6 @@ runs:
            VERCEL_ORG_ID: ${{ inputs.vercelOrg }}
            VERCEL_PROJECT_ID: ${{ inputs.vercelProject }}
            GITBOOK_RUNTIME: vercel
-            GITBOOK_HEAD_SHA: ${{ inputs.headSha }}
        - name: Deploy Project Artifacts to Vercel
          id: deploy
          shell: bash
@@ -5,6 +5,8 @@ on:
        branches:
            - main
            - changeset-release/main
+env:
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    format:
        runs-on: ubuntu-latest
@@ -34,10 +36,13 @@ jobs:
              env:
                  PUPPETEER_SKIP_DOWNLOAD: 1
            - run: bun unit
-    build:
+    build-oss:
+        # CI to check that the repository builds correctly on a machine without the credentials
        runs-on: ubuntu-latest
-        name: Build
+        name: Build (Open Source)
        timeout-minutes: 6
+        env:
+            BUN_NPM_TOKEN: ''
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -1,35 +0,0 @@
-name: CSS browser compatibility
-
-on:
-    pull_request_target:
-        types: [opened, reopened, synchronize]
-
-permissions:
-    contents: read
-    issues: write
-    pull-requests: read
-
-concurrency:
-    group: css-browser-compatibility-${{ github.event.pull_request.number }}
-    cancel-in-progress: true
-
-jobs:
-    check:
-        name: Check newly added CSS declarations
-        runs-on: ubuntu-latest
-        timeout-minutes: 6
-        steps:
-            # pull_request_target checks out the trusted base branch by default. Never use the PR ref here.
-            - name: Checkout trusted checker
-              uses: actions/checkout@v4
-            - name: Setup Bun
-              uses: ./.github/composite/setup-bun
-            - name: Install dependencies
-              run: bun install --frozen-lockfile
-              env:
-                  PUPPETEER_SKIP_DOWNLOAD: 1
-            - name: Check CSS browser compatibility
-              working-directory: packages/gitbook
-              run: bun run check:css-browser-compatibility
-              env:
-                  GITHUB_TOKEN: ${{ github.token }}
@@ -1,25 +1,15 @@
 name: Preview
 on:
-    pull_request_target:
+    pull_request:
    push:
-        branches:
-            - main
+      branches:
+        - main
+env:
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
-    approval:
-        # Ensure that external contributors' PRs are manually approved before deployment
-        name: Approve Preview Deployment
-        runs-on: ubuntu-latest
-        if: ${{ github.event_name == 'pull_request_target' && github.event.pull_request.head.repo.fork }}
-        environment:
-          name: preview-approval
-        steps:
-            - name: Approval gate
-              run: echo "Preview deployment approved."
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (preview)
        runs-on: ubuntu-latest
-        needs: approval
-        if: ${{ always() && (needs.approval.result == 'success' || needs.approval.result == 'skipped') }}
        environment:
          name: 2v-preview
          url: ${{ steps.deploy.outputs.deployment-url }}
@@ -28,8 +18,6 @@ jobs:
        steps:
            - name: Checkout
              uses: actions/checkout@v4
-              with:
-                  ref: ${{ github.event.pull_request.head.sha || github.sha }}
            - name: Deploy to Vercel
              id: deploy
              uses: ./.github/composite/deploy-vercel
@@ -40,12 +28,9 @@ jobs:
                  vercelToken: ${{ secrets.VERCEL_TOKEN }}
                  opItem: op://gitbook-open/2v-preview
                  opServiceAccount: ${{ secrets.OP_SERVICE_ACCOUNT_TOKEN }}
-                  headSha: ${{ github.event.pull_request.head.sha || github.sha }}
    deploy-v2-cloudflare:
        name: Deploy v2 to Cloudflare Worker (preview)
        runs-on: ubuntu-latest
-        needs: approval
-        if: ${{ always() && (needs.approval.result == 'success' || needs.approval.result == 'skipped') }}
        environment:
          name: 2c-preview
          url: ${{ steps.deploy.outputs.deployment-url }}
@@ -54,8 +39,6 @@ jobs:
        steps:
            - name: Checkout
              uses: actions/checkout@v4
-              with:
-                  ref: ${{ github.event.pull_request.head.sha || github.sha }}
            - name: Deploy to Cloudflare
              id: deploy
              uses: ./.github/composite/deploy-cloudflare
@@ -82,7 +65,7 @@ jobs:
    comment-deployments:
        runs-on: ubuntu-latest
        name: Comment Deployments (preview)
-        if: always() && github.event_name != 'push'
+        if: always() && !startsWith(github.ref, 'refs/heads/main')
        needs:
            - deploy-v2-vercel
            - deploy-v2-cloudflare
@@ -119,13 +102,10 @@ jobs:
        runs-on: ubuntu-latest
        name: Visual Testing v2
        needs: deploy-v2-vercel
-        if: ${{ always() && needs.deploy-v2-vercel.result == 'success' }}
        timeout-minutes: 15
        steps:
            - name: Checkout
              uses: actions/checkout@v4
-              with:
-                  ref: ${{ github.event.pull_request.head.sha || github.sha }}
            - name: Setup Bun
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
@@ -138,18 +118,15 @@ jobs:
                  BASE_URL: ${{ needs.deploy-v2-vercel.outputs.deployment-url }}
                  SITE_BASE_URL: ${{ needs.deploy-v2-vercel.outputs.deployment-url }}/url/
                  ARGOS_TOKEN: ${{ secrets.ARGOS_TOKEN }}
-                  ARGOS_BUILD_NAME: v2-vercel
+                  ARGOS_BUILD_NAME: 'v2-vercel'
    visual-testing-v2-cloudflare:
        runs-on: ubuntu-latest
        name: Visual Testing v2 (Cloudflare)
        needs: deploy-v2-cloudflare
-        if: ${{ always() && needs.deploy-v2-cloudflare.result == 'success' }}
        timeout-minutes: 15
        steps:
            - name: Checkout
              uses: actions/checkout@v4
-              with:
-                  ref: ${{ github.event.pull_request.head.sha || github.sha }}
            - name: Setup Bun
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
@@ -162,18 +139,15 @@ jobs:
                  BASE_URL: ${{ needs.deploy-v2-cloudflare.outputs.deployment-url }}
                  SITE_BASE_URL: ${{ needs.deploy-v2-cloudflare.outputs.deployment-url }}/url/
                  ARGOS_TOKEN: ${{ secrets.ARGOS_TOKEN }}
-                  ARGOS_BUILD_NAME: v2-cloudflare
+                  ARGOS_BUILD_NAME: 'v2-cloudflare'
    visual-testing-customers-v2:
        runs-on: ubuntu-latest
        name: Visual Testing Customers v2
        needs: deploy-v2-vercel
-        if: ${{ always() && needs.deploy-v2-vercel.result == 'success' }}
-        timeout-minutes: 30
+        timeout-minutes: 15
        steps:
            - name: Checkout
              uses: actions/checkout@v4
-              with:
-                  ref: ${{ github.event.pull_request.head.sha || github.sha }}
            - name: Setup Bun
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
@@ -186,18 +160,15 @@ jobs:
                  BASE_URL: ${{ needs.deploy-v2-vercel.outputs.deployment-url }}
                  SITE_BASE_URL: ${{ needs.deploy-v2-vercel.outputs.deployment-url }}/url/
                  ARGOS_TOKEN: ${{ secrets.ARGOS_TOKEN }}
-                  ARGOS_BUILD_NAME: customers-v2-vercel
+                  ARGOS_BUILD_NAME: 'customers-v2'
    visual-testing-customers-v2-cloudflare:
        runs-on: ubuntu-latest
        name: Visual Testing Customers v2 (Cloudflare)
        needs: deploy-v2-cloudflare
-        if: ${{ always() && needs.deploy-v2-cloudflare.result == 'success' }}
-        timeout-minutes: 30
+        timeout-minutes: 15
        steps:
            - name: Checkout
              uses: actions/checkout@v4
-              with:
-                  ref: ${{ github.event.pull_request.head.sha || github.sha }}
            - name: Setup Bun
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
@@ -210,17 +181,14 @@ jobs:
                  BASE_URL: ${{ needs.deploy-v2-cloudflare.outputs.deployment-url }}
                  SITE_BASE_URL: ${{ needs.deploy-v2-cloudflare.outputs.deployment-url }}/url/
                  ARGOS_TOKEN: ${{ secrets.ARGOS_TOKEN }}
-                  ARGOS_BUILD_NAME: customers-v2-cloudflare
+                  ARGOS_BUILD_NAME: 'customers-v2'
    browserless-testing-v2-vercel:
        runs-on: ubuntu-latest
        name: Browserless Testing v2 (Vercel)
        needs: deploy-v2-vercel
-        if: ${{ always() && needs.deploy-v2-vercel.result == 'success' }}
        steps:
            - name: Checkout
              uses: actions/checkout@v4
-              with:
-                  ref: ${{ github.event.pull_request.head.sha || github.sha }}
            - name: Setup Bun
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
@@ -249,4 +217,4 @@ jobs:
    #           run: cd ./packages/gitbook && bun e2e-browserless
    #           env:
    #               BASE_URL: ${{needs.deploy-v2-cloudflare.outputs.deployment-url}}
-    #               SITE_BASE_URL: ${{ needs.deploy-v2-cloudflare.outputs.deployment-url }}/url/
+    #               SITE_BASE_URL: ${{ needs.deploy-v2-cloudflare.outputs.deployment-url }}/url/
@@ -3,6 +3,8 @@ on:
    push:
        branches:
            - main
+env:
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (production)
@@ -3,6 +3,8 @@ on:
    push:
        branches:
            - main
+env:
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (staging)
@@ -4,6 +4,9 @@ on:
    push:
        branches:
            - main
+
+env:
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
    
 concurrency: ${{ github.workflow }}-${{ github.ref }}

@@ -15,10 +18,6 @@ jobs:
            id-token: write
            pull-requests: write
            contents: write
-        env:
-            # The repo is managed by Bun, but publishing uses npm for provenance.
-            # Keep Corepack from rejecting packageManager: bun@... when npm runs.
-            COREPACK_ENABLE_PROJECT_SPEC: 0
        steps:
            - name: Checkout Repo
              uses: actions/checkout@v3
@@ -30,10 +29,9 @@ jobs:
              with:
                  node-version: 22
                  registry-url: 'https://registry.npmjs.org'
+            # Ensure npm 11.5.1 or later is installed
            - name: Update npm
-              run: |
-                  corepack enable npm
-                  corepack install -g npm@latest
+              run: npm install -g npm@latest
            - name: Setup Bun
              uses: ./.github/composite/setup-bun
            - name: Install dependencies
@@ -50,3 +48,4 @@ jobs:
                  # Using a PAT instead of GITHUB_TOKEN because we need to run workflows when releases are created
                  # https://github.com/orgs/community/discussions/26875#discussioncomment-3253761
                  GITHUB_TOKEN: ${{ secrets.GH_PERSONAL_TOKEN }}
+
@@ -1,81 +0,0 @@
-# AGENTS Instructions
-
-## Commands
-
-```bash
-bun install          # Install dependencies
-bun dev              # Start dev server (all packages)
-bun run build        # Build all packages
-bun run format       # Format with Biome (run after every change)
-bun run typecheck    # Type-check all packages
-bun run unit         # Run unit tests
-```
-
-## Development
-
-The dev server proxies published GitBook sites locally. After `bun dev`, access any published site at:
-
-```
-http://localhost:3000/url/<published-gitbook-url>
-```
-
-Examples:
- `http://localhost:3000/url/gitbook.com/docs`
- `http://localhost:3000/url/open-source.gitbook.io/midjourney`
-
-## Architecture
-
-```
-packages/
-  gitbook/          # Main Next.js app
-    src/
-      app/          # Next.js App Router (sites/)
-      components/   # React components
-      lib/          # Server utilities, data fetching
-      intl/         # Internationalization (translations/)
-  openapi-parser/   # OpenAPI 3.0/3.1/Swagger parser
-  react-openapi/    # OpenAPI rendering components
-  react-contentkit/ # ContentKit component rendering
-  embed/            # Embeddable GitBook components
-  shared/           # Shared utilities
-  icons/            # Icon assets
-  fonts/            # Font assets
-  colors/           # Color tokens
-  expr/             # GitBook expression evaluator
-  cache-do/         # Cloudflare DO cache
-  cache-tags/       # Cache tag utilities
-```
-
-## Testing
-
-```bash
-bun run unit         # Unit tests via bun test (not vitest)
-bun run e2e          # Playwright e2e tests (requires built app)
-```
-
-Run a specific test file:
-```bash
-cd packages/gitbook && bun test src/lib/cache.test.ts
-```
-
-## Changesets
-
-After committing code changes, create a changeset for the affected package:
-
-```md
---
-"gitbook": patch
---
-
-Provide a short description of the change.
-```
-
-Save as `.changeset/<name>.md`, then commit it separately with message: `changeset`
-
-## Formatting
-
-Uses Biome (not ESLint/Prettier). Always run `bun run format` before committing.
-
-## Comments
-
-Comment to explain *why*, not *what* — the code already shows what it does. Keep comments short, ideally a single line. Avoid multi-line block comments that narrate mechanics a reader can follow from the code; they add noise and go stale. Reserve longer comments for genuinely non-obvious rationale: a subtle invariant, or a workaround and the reason it exists.
@@ -1 +0,0 @@
-@AGENTS.md
@@ -1,7 +1,3 @@
-<p align="center">
-  <img src="./assets/gitbook_icon_dark.svg" alt="GitBook" width="48" />
-</p>
-
 <h1 align="center">GitBook</h1>

 <p align="center">
@@ -81,7 +77,23 @@ All pull-requests will be tested against both visual and performances testing to

 ## Fonts and Icons

-GitBook Open uses fontawesome. For self-hosting and local development, for licensing reasons, only the icons from the free version should be used.
+GitBook Open uses fontawesome. During development, your local environment will use the free version. However, only the pro version will be accepted by CI. If you see the following error:
+
+```
+The GitBook icon is missing. It indicates that the dependencies were installed without the correct font-awesome package. These changes have probably been persisted in the Bun lockfile. Read the README for more information.
+```
+
+It means that you've changed the GBO dependencies and bundled in the free version. Only GitBook staff can help with this - if you're not on the GitBook team, please ping us in the PR and we'll help get things moving.
+
+If you are GitBook staff, you'll need our NPM token in your local environment.
+
+```
+.env.local
+
+BUN_NPM_TOKEN=xxx
+```
+
+and then reinstall dependencies.

 ## Contributing

@@ -1,3 +0,0 @@
-<svg width="65" height="65" viewBox="0 0 65 65" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M27.3963 34.2195C30.5255 36.0255 32.09 36.9285 33.8082 36.93C35.5265 36.9315 37.0926 36.0313 40.2249 34.2308L60.1913 22.7534C61.0927 22.2353 61.6484 21.2749 61.6484 20.2352C61.6484 19.1955 61.0927 18.2351 60.1913 17.717L40.2177 6.23554C37.0888 4.43695 35.5243 3.53766 33.8078 3.53833C32.0912 3.539 30.5275 4.43951 27.4 6.24053L10.2292 16.1286C10.102 16.2019 10.0383 16.2385 9.97905 16.2732C4.11368 19.7068 0.489862 25.9754 0.441408 32.7717C0.440918 32.8404 0.440918 32.9138 0.440918 33.0607C0.440918 33.2074 0.440918 33.2807 0.441407 33.3494C0.489754 40.138 4.10549 46.4008 9.96041 49.837C10.0196 49.8718 10.0831 49.9085 10.2101 49.9818L20.9658 56.1918C27.2331 59.8104 30.3668 61.6197 33.808 61.6208C37.2493 61.622 40.3842 59.8148 46.6539 56.2005L58.008 49.6551C61.1474 47.8454 62.7171 46.9405 63.579 45.4487C64.4409 43.957 64.4409 42.1451 64.4409 38.5215V31.5212C64.4409 30.5159 63.8965 29.5895 63.0182 29.1004C62.1683 28.627 61.1325 28.6341 60.2891 29.1189L37.0074 42.5019C35.4453 43.3998 34.6643 43.8487 33.8072 43.849C32.9501 43.8493 32.1688 43.4008 30.6062 42.5038L14.8487 33.4586C14.0593 33.0055 13.6647 32.7789 13.3477 32.738C12.625 32.6448 11.9301 33.0497 11.6548 33.7244C11.534 34.0203 11.5365 34.4753 11.5414 35.3855C11.545 36.0555 11.5468 36.3905 11.6094 36.6987C11.7496 37.3887 12.1127 38.0136 12.6428 38.4771C12.8795 38.6842 13.1696 38.8516 13.7499 39.1866L30.5974 48.9103C32.164 49.8145 32.9473 50.2666 33.8075 50.2668C34.6677 50.267 35.4512 49.8154 37.0184 48.912L57.6684 37.0085C58.2037 36.7 58.4713 36.5457 58.672 36.6616C58.8727 36.7776 58.8727 37.0865 58.8727 37.7044V40.8796C58.8727 41.7855 58.8727 42.2385 58.6572 42.6114C58.4417 42.9844 58.0493 43.2106 57.2644 43.663L40.2322 53.4811C37.0966 55.2885 35.5288 56.1923 33.8078 56.1915C32.0869 56.1907 30.5199 55.2855 27.386 53.4752L11.4509 44.2701C11.4003 44.2409 11.375 44.2262 11.3514 44.2125C8.0102 42.26 5.94856 38.6882 5.92922 34.8185C5.92909 34.7911 5.92909 34.7619 5.92909 34.7035V31.7889C5.92909 29.6526 7.06686 27.678 8.9151 26.6067C10.5483 25.66 12.5628 25.6582 14.1977 26.6018L27.3963 34.2195Z" fill="#181C1F"/>
-</svg>
@@ -23,7 +23,6 @@
            "packages/emoji-codepoints/index.ts",
            "packages/icons/src/data/*.json",
            "packages/gitbook/worker-configuration.d.ts",
-            "gitbook/tsconfig.json",
            "**/*.css"
        ]
    },
@@ -0,0 +1,2 @@
+[install.scopes]
+"gitbook" = { token = "$BUN_NPM_TOKEN", url = "https://registry.npmjs.org" }
@@ -6,20 +6,18 @@
    },
    "devDependencies": {
        "@biomejs/biome": "^1.9.4",
-        "@changesets/cli": "^2.31.0",
-        "turbo": "^2.10.3",
-        "vercel": "50.37.3"
+        "@changesets/cli": "^2.29.8",
+        "turbo": "^2.7.4",
+        "vercel": "^39.4.2"
    },
-    "packageManager": "bun@1.3.7",
+    "packageManager": "bun@1.3.2",
    "overrides": {
        "@codemirror/state": "6.4.1",
        "@types/react": "catalog:",
        "@types/react-dom": "catalog:",
        "react": "catalog:",
        "react-dom": "catalog:",
-        "esbuild": "0.27.3",
-        "axios": "1.8.4",
-        "@radix-ui/react-slot": "1.2.4"
+        "esbuild": "0.24.2"
    },
    "private": true,
    "scripts": {
@@ -43,7 +41,7 @@
        "catalog": {
            "@tsconfig/strictest": "^2.0.6",
            "@tsconfig/node20": "^20.1.6",
-            "@gitbook/api": "0.192.0",
+            "@gitbook/api": "0.158.0",
            "@scalar/api-client-react": "^1.3.46",
            "@types/react": "^19.0.0",
            "@types/react-dom": "^19.0.0",
@@ -55,13 +53,11 @@
            "react-dom": "^19.0.1",
            "tsdown": "^0.15.6",
            "typescript": "^5.5.3",
-            "usehooks-ts": "^3.1.1",
-            "vercel": "^50.26.1"
+            "usehooks-ts": "^3.1.1"
        }
    },
    "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.2.11": "patches/next@16.2.11.patch"
+        "@vercel/next@4.4.2": "patches/@vercel%2Fnext@4.4.2.patch"
    }
 }
@@ -1,20 +1,5 @@
 # @gitbook/browser-types

-## 0.1.5
-
-### Patch Changes
-
- 5f66860: Use isCookiesTrackingDisabled for cookie consent integrations
- 2e495cb: Add Global Privacy Control (GPC) support
-
-## 0.1.4
-
-### Patch Changes
-
- 7a11861: Add support for custom cookie banner registration
- Updated dependencies [6f1db32]
-  - @gitbook/icons@0.4.3
-
 ## 0.1.3

 ### Patch Changes
@@ -9,7 +9,7 @@
        }
    },
    "sideEffects": false,
-    "version": "0.1.5",
+    "version": "0.1.3",
    "dependencies": {
        "@gitbook/api": "catalog:",
        "@gitbook/icons": "workspace:"
@@ -5,28 +5,14 @@ export type GitBookIntegrationEvent = 'load' | 'unload';

 export type GitBookIntegrationEventCallback = (...args: any[]) => void;

-export type GitBookIntegrationToolConfirmation = {
-    icon?: IconName;
-    label: string;
-
-    /**
-     * Supporting context displayed to the user above the confirmation dialog,
-     * to help them understand what they are approving or rejecting.
-     * Limited to 512 characters.
-     */
-    context?: string;
-};
-
 export type GitBookIntegrationTool = AIToolDefinition & {
    /**
     * Confirmation action to be displayed to the user before executing the tool.
-     * Provide a static object, or a function that receives the input provided by
-     * the AI assistant and returns the confirmation — useful to display dynamic
-     * context based on the arguments the tool is about to be executed with.
     */
-    confirmation?:
-        | GitBookIntegrationToolConfirmation
-        | ((input: object) => GitBookIntegrationToolConfirmation);
+    confirmation?: {
+        icon?: IconName;
+        label: string;
+    };

    /**
     * Callback when the tool is executed.
@@ -60,11 +46,6 @@ export type GitBookAssistant = {
    ui?: boolean;
 };

-export type GitBookCookieBannerHandler = (options: {
-    onApprove: () => void;
-    onReject: () => void;
-}) => void;
-
 export type GitBookGlobal = {
    /**
     * Register an event listener.
@@ -91,25 +72,6 @@ export type GitBookGlobal = {
     * Register a custom assistant to be available on the site.
     */
    registerAssistant: (assistant: GitBookAssistant) => () => void;
-
-    /**
-     * Register a custom cookie banner handler.
-     * When registered, the built-in cookie banner will not be displayed.
-     */
-    registerCookieBanner: (handler: GitBookCookieBannerHandler) => void;
-
-    /**
-     * Indicates whether cookies tracking is disabled for the current user.
-     * Returns `true` when tracking is disabled, `false` when tracking is enabled,
-     * and `undefined` when the tracking preference is unknown or not yet determined.
-     */
-    isCookiesTrackingDisabled: () => boolean | undefined;
-
-    /**
-     * Indicates whether global privacy control is enabled for the current user.
-     * Returns `true` when global privacy control is enabled, `false` when it is disabled.
-     */
-    isGlobalPrivacyControlEnabled: () => boolean;
 };

 declare global {
@@ -17,7 +17,6 @@
    "scripts": {
        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "unit": "bun test",
        "dev": "bun run build -- --watch ./src",
        "publish-to-npm": "../../scripts/publish-if-new.sh"
    },
@@ -1,69 +0,0 @@
-import { describe, expect, it } from 'bun:test';
-
-import { colorScale } from './transformations';
-
-describe('colorScale exact base', () => {
-    it('takes a very light tint as the exact background on step 1 (clean/bold)', () => {
-        const scale = colorScale('#F5F3EF', { baseStep: 1 });
-        expect(scale[0]).toBe('#F5F3EF');
-    });
-
-    it('anchors a very light tint to step 2 when the theme uses the subtle step (muted)', () => {
-        const scale = colorScale('#F5F3EF', { baseStep: 2 });
-        expect(scale[1]).toBe('#F5F3EF');
-        // Step 1 sits just above the exact base, toward white.
-        expect(scale[0]).not.toBe('#F5F3EF');
-        expect(scale[0]).not.toBe('#ffffff');
-    });
-
-    it('takes a darker-than-dark tint as the exact background, preserving hue and chroma', () => {
-        const scale = colorScale('#0B0F19', { darkMode: true, baseStep: 1 });
-        expect(scale[0]).toBe('#0B0F19');
-    });
-
-    it('does not trigger for a normal mid-lightness tint', () => {
-        const scale = colorScale('#787878', { baseStep: 2 });
-        // The default white background is kept; the tint only colors the scale.
-        expect(scale[0]).toBe('#ffffff');
-        expect(scale[1]).not.toBe('#787878');
-    });
-
-    it('does not trigger for a saturated light color, keeping the normal accent ramp', () => {
-        // Light enough (L≈0.93) to pass the lightness bound, but too chromatic to read as a
-        // background — emitting it verbatim would leave a vivid step 1 above a near-gray scale.
-        const scale = colorScale('#FFEB3B', { baseStep: 1 });
-        expect(scale[0]).toBe('#ffffff');
-        expect(scale[0]).not.toBe('#FFEB3B');
-    });
-
-    it('respects a custom light background instead of overriding it with the tint', () => {
-        // The color is darker than the requested background, so it is not the extreme end and the
-        // supplied base must be preserved rather than overwritten.
-        const scale = colorScale('#eeeeee', { baseStep: 1, background: '#f8f8f8' });
-        expect(scale[0]).not.toBe('#eeeeee');
-    });
-
-    it('anchors an exact base even when a neutral mix is supplied (tint === primary)', () => {
-        // getTintMixColor blends neutral into the tint when it equals the primary color; that must
-        // not darken a near-white tint out of the exact-base path.
-        const scale = colorScale('#F5F3EF', {
-            baseStep: 1,
-            mix: { color: '#787878', ratio: 0.4 },
-        });
-        expect(scale[0]).toBe('#F5F3EF');
-    });
-
-    it('does not trigger for a light accent color below the near-white threshold', () => {
-        // #D8DEEC (light blue-gray, L≈0.90) is a UI accent, not a background, so it must not anchor.
-        const scale = colorScale('#D8DEEC', { baseStep: 1 });
-        expect(scale[0]).toBe('#ffffff');
-        expect(scale[0]).not.toBe('#D8DEEC');
-    });
-
-    it('never anchors when no baseStep is given (accent scales and the bold theme)', () => {
-        // A scale that does not define the page background opts out of the exact base entirely.
-        const scale = colorScale('#F5F3EF', {});
-        expect(scale[0]).toBe('#ffffff');
-        expect(scale[0]).not.toBe('#F5F3EF');
-    });
-});
@@ -82,22 +82,6 @@ export const colorMixMapping = {
    dark: [0, 0.03, 0.08, 0.1, 0.13, 0.15, 0.2, 0.25, 0.5, 0.55, 0.75, 1],
 };

-/**
- * Light mode has no equivalent to the dark base bound (nothing is lighter than white), so a tint
- * at or above this lightness is treated as an explicit, near-white background (e.g. a warm `#F5F3EF`
- * at L≈0.96). Kept high so light UI accent colors (around L≈0.90) aren't mistaken for backgrounds.
- */
-const EXACT_BASE_LIGHT_THRESHOLD = 0.95;
-
-/**
- * Only a near-neutral tint reads as a background. A saturated color would keep the exact hue at the
- * anchored step while the rest of the low scale stays ~gray, so those keep the normal accent ramp.
- */
-const EXACT_BASE_NEUTRAL_CHROMA = 0.05;
-
-/** Lightness of the default white light background (≈0.99999, not exactly 1). */
-const LIGHT_BASE_L = rgbToOklch(hexToRgbArray(LIGHT_BASE)).L;
-
 /**
 * Convert a hex color to an RGB color.
 */
@@ -175,14 +159,6 @@ export type ColorScaleOptions = {
    /** Define a custom foreground color to use. If left undefined, the global `light`/`dark` values (in `colors.ts`) will be used. */
    foreground?: string;

-    /**
-     * The 1-indexed scale step this scale renders as the page background (1 = `tint-base` for
-     * `clean`, 2 = `tint-subtle` for `muted`). When set, an extreme near-neutral tint is taken as
-     * the exact background, anchored to this step so it matches exactly. Omit for scales that don't
-     * define the page background (accents, or the two-tone `bold` theme) — they never anchor.
-     */
-    baseStep?: number;
-
    mix?: {
        /** If set to a hex code, this color will be additionally mixed into the generated scale according to `mix.ratio`. */
        color: string;
@@ -203,7 +179,6 @@ export function colorScale(
        darkMode = false,
        background = darkMode ? DARK_BASE : LIGHT_BASE,
        foreground = darkMode ? LIGHT_BASE : DARK_BASE,
-        baseStep,
        mix,
    }: ColorScaleOptions = {}
 ) {
@@ -213,51 +188,31 @@ export function colorScale(
    const backgroundColor = rgbToOklch(hexToRgbArray(background));
    let mapping = darkMode ? colorMixMapping.dark : colorMixMapping.light;

-    // A near-neutral tint at the extreme end of the scale is taken as the exact page background
-    // rather than tinting pure black/white with it — letting brands set an exact background such as
-    // a warm `#F5F3EF`. Only scales that define the page background opt in (via `baseStep`). In light
-    // mode the base is pure white by default, so a near-white tint also qualifies (nothing is lighter
-    // than white); a custom, lower background is respected instead. Decided on the raw color so a
-    // neutral mix (below) can't darken a tint out of the exact base.
-    const isExtremeBase = darkMode
-        ? baseColor.L < backgroundColor.L
-        : backgroundColor.L >= LIGHT_BASE_L
-          ? baseColor.L > EXACT_BASE_LIGHT_THRESHOLD
-          : baseColor.L > backgroundColor.L;
-    const isExactBase =
-        baseStep !== undefined && isExtremeBase && baseColor.C < EXACT_BASE_NEUTRAL_CHROMA;
-    const exactBaseIndex = (baseStep ?? 1) - 1;
-
-    if (mixColor && mix?.ratio && mix.ratio > 0 && !isExactBase) {
-        // Mix a little of the mix color into the base — but not when the tint is the exact base,
-        // where it must stay true to the supplied color (and match `--header-background`).
+    if (mixColor && mix?.ratio && mix.ratio > 0) {
+        // If defined, we mix in a (tiny) bit of the mix color with the base color.
        baseColor.L = mixColor.L * mix.ratio + baseColor.L * (1 - mix.ratio);
        baseColor.C = mixColor.C * mix.ratio + baseColor.C * (1 - mix.ratio);
        baseColor.H = mix.color === DEFAULT_TINT_COLOR ? baseColor.H : mixColor.H;
    }

-    if (isExactBase) {
+    if (
+        (darkMode && baseColor.L < backgroundColor.L) ||
+        (!darkMode && baseColor.L > backgroundColor.L)
+    ) {
+        // If the supplied color is outside of our lightness bounds, use the supplied color's lightness.
+        // This is mostly used to allow darker-than-dark backgrounds for brands that specifically want that look.
        const difference = (backgroundColor.L - baseColor.L) / backgroundColor.L;
+        backgroundColor.L = baseColor.L;
        // At the edges of the scale, the subtle lightness changes stop being perceptible. We need to amp up our mapping to still stand out.
        const amplifier = 1;
        mapping = mapping.map((step, index) =>
            index < 9 ? step + step * amplifier * difference : step
        );
-
-        // Anchor the supplied color to the step the theme renders as the background, solving the
-        // background lightness so neighbouring steps stay continuous with it.
-        const baseMix = mapping[exactBaseIndex]!;
-        backgroundColor.L = (baseColor.L - foregroundColor.L * baseMix) / (1 - baseMix);
    }

    const result = [];

    for (let index = 0; index < mapping.length; index++) {
-        if (isExactBase && index === exactBaseIndex) {
-            result.push(hex);
-            continue;
-        }
-
        const step = mapping[index]!;
        const targetL = foregroundColor.L * step + backgroundColor.L * (1 - step);

@@ -283,10 +238,7 @@ export function colorScale(
                case 11:
                    return 0.1;
                default:
-                    // When the tint is the exact base, hold the steps from the base toward the
-                    // accents at its chroma so the background stays tinted; steps lighter than the
-                    // base (e.g. cards in `muted`) keep desaturating toward white.
-                    return isExactBase && index >= exactBaseIndex ? 1 : index * 0.05;
+                    return index * 0.05;
            }
        })();

@@ -1,50 +1,5 @@
 # @gitbook/embed

-## 0.5.1
-
-### Patch Changes
-
- 37a9453: Allow copying in embed
- Updated dependencies [47c8ccb]
-  - @gitbook/icons@0.5.0
-
-## 0.5.0
-
-### Minor Changes
-
- 88c38fa: Add Search tab to Docs Embed, refactor search
-
-### Patch Changes
-
- 8d2a95b: Docs Embed: Better support light/dark mode overrides
-
-## 0.4.0
-
-### Minor Changes
-
- b3875a1: Support `assistantName` property to override Assistant name
-
-## 0.3.0
-
-### Minor Changes
-
- 370b731: Docs Embed: Make trademark optional
-
-## 0.2.2
-
-### Patch Changes
-
- b4b471f: Fix unexpected error thrown when using the embed in standalone mode
-
-## 0.2.1
-
-### Patch Changes
-
- 96e24a1: Fix signed JWT token usage
- 0aa34cc: Fix Embed options in React
- Updated dependencies [6f1db32]
-  - @gitbook/icons@0.4.3
-
 ## 0.2.0

 ### Minor Changes
@@ -2,9 +2,8 @@

 Embed your GitBook docs in your product or website.

-The Docs Embed can contain three tabs:
+The Docs Embed can contain two tabs:
 - **Assistant**: The [GitBook Assistant](https://gitbook.com/docs/publishing-documentation/gitbook-ai-assistant) - an AI-powered chat interface to help users find answers
- **Search**: A search-focused surface for quickly finding pages and asking scoped questions
 - **Docs**: A browser for navigating your documentation site

 The embed is set up automatically based on your site's configuration. You can optionally customize and override the configuration with custom actions, tools, suggested questions, [Authenticated Access](https://gitbook.com/docs/publishing-documentation/authenticated-access), and more. See the [Configuration](#configuration) section for all available options.
@@ -41,7 +40,7 @@ GitBook('configure', {
        label: 'Ask',
        icon: 'assistant' // 'assistant' | 'sparkle' | 'help' | 'book'
    },
-    tabs: ['assistant', 'search', 'docs'],
+    tabs: ['assistant', 'docs'],
    actions: [
        {
            icon: 'circle-question',
@@ -50,10 +49,8 @@ GitBook('configure', {
        }
    ],
    greeting: { title: 'Welcome!', subtitle: 'How can I help?' },
-    assistantName: 'Support Assistant',
    suggestions: ['What is GitBook?', 'How do I get started?'],
-    tools: [/* ... */],
-    closeButton: true,
+    tools: [/* ... */]
 });
 ```

@@ -73,7 +70,6 @@ const gitbook = createGitBook({
 // Create an iframe and get its URL
 const iframe = document.createElement('iframe');
 iframe.src = gitbook.getFrameURL({
-    colorScheme: 'dark', // Optional: force the embed to render in dark mode
    visitor: {
        token: 'your-jwt-token', // Optional: for Adaptive Content or Authenticated Access
        unsignedClaims: { // Optional: custom claims for dynamic expressions
@@ -94,7 +90,7 @@ frame.clearChat();

 // Configure the embed (see Configuration section for all options)
 frame.configure({
-    tabs: ['assistant', 'search', 'docs'],
+    tabs: ['assistant', 'docs'],
    actions: [
        {
            icon: 'circle-question',
@@ -103,10 +99,8 @@ frame.configure({
        }
    ],
    greeting: { title: 'Welcome!', subtitle: 'How can I help?' },
-    assistantName: 'Support Assistant',
    suggestions: ['What is GitBook?', 'How do I get started?'],
-    tools: [/* ... */],
-    closeButton: true
+    tools: [/* ... */]
 });

 // Listen to events
@@ -124,14 +118,12 @@ import { GitBookProvider, GitBookFrame } from '@gitbook/embed/react';

 <GitBookProvider siteURL="https://docs.company.com">
    <GitBookFrame
-        colorScheme="dark"
        visitor={{
            token: 'your-jwt-token', // Optional: for Adaptive Content or Authenticated Access
            unsignedClaims: { userId: '123' } // Optional: custom claims for dynamic expressions
        }}
-        tabs={['assistant', 'search', 'docs']}
+        tabs={['assistant', 'docs']}
        greeting={{ title: 'Welcome!', subtitle: 'How can I help?' }}
-        assistantName="Support Assistant"
        suggestions={['What is GitBook?', 'How do I get started?']}
        actions={[
            {
@@ -141,7 +133,6 @@ import { GitBookProvider, GitBookFrame } from '@gitbook/embed/react';
            }
        ]}
        tools={[/* ... */]}
-        closeButton
    />
 </GitBookProvider>
 ```
@@ -153,7 +144,7 @@ import { useGitBook } from '@gitbook/embed/react';

 function MyComponent() {
    const gitbook = useGitBook();
-    const frameURL = gitbook.getFrameURL({ colorScheme: 'dark', visitor: { token: '...' } });
+    const frameURL = gitbook.getFrameURL({ visitor: { token: '...' } });
    // ...
 }
 ```
@@ -181,13 +172,13 @@ function MyComponent() {

 ### Standalone Script

- `GitBook('init', options: { siteURL: string }, frameOptions?: { colorScheme?: 'light' | 'dark', visitor?: {...} })` - Initialize widget
+- `GitBook('init', options: { siteURL: string }, frameOptions?: { visitor?: {...} })` - Initialize widget
 - `GitBook('show')` - Show widget button
 - `GitBook('hide')` - Hide widget button
 - `GitBook('open')` - Open widget window
 - `GitBook('close')` - Close widget window
 - `GitBook('toggle')` - Toggle widget window
- `GitBook('navigateToPage', path: string)` - Navigate to page (accepts the page path within the site, an absolute path, or the full published URL; resolves pages in any space/section)
+- `GitBook('navigateToPage', path: string)` - Navigate to page
 - `GitBook('navigateToAssistant')` - Navigate to assistant tab
 - `GitBook('postUserMessage', message: string)` - Post message to chat
 - `GitBook('clearChat')` - Clear chat history
@@ -198,11 +189,11 @@ function MyComponent() {

 **Client Factory:**
 - `createGitBook(options: { siteURL: string })` → `GitBookClient`
- `client.getFrameURL(options?: { colorScheme?: 'light' | 'dark', visitor?: {...} })` → `string`
+- `client.getFrameURL(options?: { visitor?: {...} })` → `string`
 - `client.createFrame(iframe: HTMLIFrameElement)` → `GitBookFrameClient`

 **Frame Client:**
- `frame.navigateToPage(path: string)` → `void` (accepts the page path within the site, an absolute path, or the full published URL; resolves pages in any space/section)
+- `frame.navigateToPage(path: string)` → `void`
 - `frame.navigateToAssistant()` → `void`
 - `frame.postUserMessage(message: string)` → `void`
 - `frame.clearChat()` → `void`
@@ -231,61 +222,14 @@ Available in: Standalone script, NPM package, React components

 Override which tabs are displayed. Defaults to your site's configuration.

- **Type**: `('assistant' | 'search' | 'docs')[]`
+- **Type**: `('assistant' | 'docs')[]`
+- **Options**:
+  - `['assistant', 'docs']` - Show both tabs
+  - `['assistant']` - Show only the assistant tab
+  - `['docs']` - Show only the docs tab

 ```javascript
-tabs: ['assistant', 'search', 'docs']
-```
-
-### `closeButton`
-
-Available in: Standalone script, NPM package, React components
-
-Display a close (`x`) button in the embed sidebar.
-
- **Type**: `boolean`
- **Default**: `false`
-
-```javascript
-closeButton: true
-```
-
-Behavior:
- When clicked, the embed sends a `close` event to the parent page.
- In the standalone script, this event is handled automatically and the widget closes.
- In custom iframe integrations (NPM package), you must listen for the `close` event and decide how to hide/collapse your UI.
- In React, this works automatically when using the standard widget flow. If you build custom frame wiring, handle `close` the same way as the NPM package.
-
-NPM package example:
-
-```typescript
-const frame = gitbook.createFrame(iframe);
-
-frame.configure({
-    closeButton: true
-});
-
-const unsubscribe = frame.on('close', () => {
-    // Hide your modal/drawer/container
-    container.classList.add('hidden');
-});
-```
-
-Notes:
- The close button is rendered in the same sidebar area as tabs/actions.
- If your UI hides that sidebar or doesn't render it, the button will not be visible.
-
-### `trademark`
-
-Available in: Standalone script, NPM package, React components
-
-Display GitBook branding in the embed. Defaults to true.
-
- **Type**: `boolean`
- **Default**: `true`
-
-```javascript
-trademark: true
+tabs: ['assistant', 'docs']
 ```

 ### `actions`
@@ -334,18 +278,6 @@ greeting: {
 }
 ```

-### `assistantName`
-
-Available in: Standalone script, NPM package, React components
-
-Override the assistant name displayed in the chat header and assistant entry points (for example, sidebar tabs and action labels). This name will be limited to 32 characters to prevent text overflow.
-
- **Type**: `string`
-
-```javascript
-assistantName: 'Support Assistant'
-```
-
 ### `suggestions`

 Available in: Standalone script, NPM package, React components
@@ -460,24 +392,6 @@ visitor: {
 }
 ```

-### `colorScheme`
-
-Available in: Standalone script (via `init`), NPM package (via `getFrameURL()`), React components (as prop)
-
-Override the embed's color scheme. When omitted, the embed follows the iframe's CSS `color-scheme`, which lets it inherit the parent page or browser preference.
-
-**Note**: This is not a configuration option but rather a parameter when initializing the frame or creating the frame URL.
-
-**Standalone script**: Pass as the second argument to `GitBook('init', options, frameOptions)`
-**NPM package**: Pass to `getFrameURL({ colorScheme: 'dark' })`
-**React components**: Pass as the `colorScheme` prop on `<GitBookFrame>`
-
- **Type**: `'light' | 'dark'`
-
-```javascript
-colorScheme: 'dark'
-```
-
 ### `button`

 Available in: Standalone script only
@@ -13,7 +13,7 @@
        }
    },
    "sideEffects": false,
-    "version": "0.5.1",
+    "version": "0.2.0",
    "dependencies": {
        "@gitbook/api": "catalog:",
        "@gitbook/icons": "workspace:",
@@ -35,17 +35,4 @@ describe('createGitBook.getFrameURL', () => {
        expect(url.searchParams.get('visitor.count')).toBe('3');
        expect(url.searchParams.get('visitor.enabled')).toBe('false');
    });
-
-    it('adds an explicit color scheme override when requested', () => {
-        const client = createGitBook({ siteURL: 'https://example.com/docs/' });
-
-        const url = new URL(
-            client.getFrameURL({
-                colorScheme: 'dark',
-            })
-        );
-
-        expect(url.pathname).toBe('/docs/~gitbook/embed');
-        expect(url.searchParams.get('theme')).toBe('dark');
-    });
 });
@@ -8,12 +8,6 @@ export type CreateGitBookOptions = {
 };

 export type GetFrameURLOptions = {
-    /**
-     * Override the color scheme used by the embedded docs.
-     * When omitted, the embed follows the iframe's CSS `color-scheme`.
-     */
-    colorScheme?: 'light' | 'dark';
-
    /**
     * Authentication to use for the frame.
     */
@@ -48,10 +42,6 @@ export function createGitBook(options: CreateGitBookOptions) {
            const url = new URL(options.siteURL);
            url.pathname = `${url.pathname.endsWith('/') ? url.pathname : `${url.pathname}/`}~gitbook/embed`;

-            if (frameOptions.colorScheme) {
-                url.searchParams.set('theme', frameOptions.colorScheme);
-            }
-
            if (frameOptions.visitor?.token) {
                url.searchParams.set('jwt_token', frameOptions.visitor.token);
            }
@@ -7,12 +7,7 @@ import type {

 export type GitBookFrameClient = {
    /**
-     * Navigate to a page in the docs tab.
-     *
-     * Accepts the page's path within the site (e.g. `getting-started/quickstart`),
-     * an absolute path (e.g. `/help-center/integrations`), or its full published URL.
-     * The target page may live in any space/section of the site — including one other
-     * than the embed is currently showing — and is resolved to the right space.
+     * Navigate to a page by its path.
     */
    navigateToPage: (path: string) => void;

@@ -49,16 +44,6 @@ export function createGitBookFrame(iframe: HTMLIFrameElement): GitBookFrameClien
    if (!iframe.contentWindow) {
        throw new Error('Iframe must have a content window');
    }
-
-    const allowTokens = iframe.allow
-        .split(';')
-        .map((token) => token.trim())
-        .filter(Boolean);
-
-    if (!allowTokens.includes('clipboard-write')) {
-        iframe.allow = [...allowTokens, 'clipboard-write'].join('; ');
-    }
-
    const channel = createChannel(iframe.contentWindow);

    channel.receive((message: FrameToParentMessage) => {
@@ -79,12 +64,11 @@ export function createGitBookFrame(iframe: HTMLIFrameElement): GitBookFrameClien
    const events = new Map<string, Array<(...args: any[]) => void>>();

    const configuration: GitBookEmbeddableConfiguration = {
-        tabs: ['assistant', 'search', 'docs'],
+        tabs: ['assistant', 'docs'],
        actions: [],
        greeting: { title: '', subtitle: '' },
        suggestions: [],
        tools: [],
-        trademark: true,
    };

    return {
@@ -1,32 +1,17 @@
 import type { AIToolCallResult, AIToolDefinition } from '@gitbook/api';
 import type { IconName } from '@gitbook/icons';

-/**
- * Confirmation action to be displayed to the user before executing a tool.
- */
-export type GitBookToolConfirmation = {
-    icon?: IconName;
-    label: string;
-
-    /**
-     * Supporting context displayed to the user above the confirmation dialog,
-     * to help them understand what they are approving or rejecting.
-     * Limited to 512 characters.
-     */
-    context?: string;
-};
-
 /**
 * Custom tool definition to be passed to the AI assistant.
 */
 export type GitBookToolDefinition = AIToolDefinition & {
    /**
     * Confirmation action to be displayed to the user before executing the tool.
-     * Provide a static object, or a function that receives the input provided by
-     * the AI assistant and returns the confirmation — useful to display dynamic
-     * context based on the arguments the tool is about to be executed with.
     */
-    confirmation?: GitBookToolConfirmation | ((input: object) => GitBookToolConfirmation);
+    confirmation?: {
+        icon?: IconName;
+        label: string;
+    };

    /**
     * Callback when the tool is executed.
@@ -60,7 +45,7 @@ export type GitBookEmbeddableActionDefinition = {
 */
 export type GitBookEmbeddableConfiguration = {
    /** Tabs to display in the embed (if enabled on the site). */
-    tabs: ('assistant' | 'docs' | 'search')[];
+    tabs: ('assistant' | 'docs')[];

    /** Additional buttons to be displayed in the header of the GitBook embed. */
    actions: GitBookEmbeddableActionDefinition[];
@@ -77,27 +62,11 @@ export type GitBookEmbeddableConfiguration = {
        subtitle: string;
    };

-    /**
-     * Override the assistant name displayed in the UI.
-     * Limited to 32 characters.
-     */
-    assistantName?: string;
-
    /** Suggestions of questions to be displayed in the welcome page. */
    suggestions: string[];

    /** Tools to be provided to the assistant. */
    tools: GitBookToolDefinition[];
-
-    /**
-     * Display GitBook branding in the embed.
-     */
-    trademark?: boolean;
-
-    /**
-     * Display a close button inside the assistant.
-     */
-    closeButton?: boolean;
 };

 /**
@@ -11,34 +11,19 @@ import { useGitBook } from './GitBookProvider';
 export type GitBookFrameProps = {
    className?: string;
 } & GetFrameURLOptions &
-    Partial<GitBookEmbeddableConfiguration>;
+    GitBookEmbeddableConfiguration;

 /**
 * Render a frame with the GitBook Assistant in it.
 */
 export function GitBookFrame(props: GitBookFrameProps) {
-    const {
-        className,
-        colorScheme,
-        visitor,
-        actions = [],
-        greeting,
-        suggestions = [],
-        tools = [],
-        tabs = ['assistant', 'search', 'docs'],
-        trademark = true,
-        closeButton = false,
-        assistantName,
-    } = props;
+    const { className, visitor, actions, greeting, suggestions, tools } = props;

    const frameRef = useRef<HTMLIFrameElement>(null);
    const gitbook = useGitBook();
    const [gitbookFrame, setGitbookFrame] = useState<GitBookFrameClient | null>(null);

-    const frameURL = useMemo(
-        () => gitbook.getFrameURL({ visitor, colorScheme }),
-        [gitbook, visitor, colorScheme]
-    );
+    const frameURL = useMemo(() => gitbook.getFrameURL({ visitor }), [gitbook, visitor]);

    useEffect(() => {
        if (frameRef.current) {
@@ -48,26 +33,13 @@ export function GitBookFrame(props: GitBookFrameProps) {

    useEffect(() => {
        gitbookFrame?.configure({
-            tabs,
+            tabs: ['assistant', 'docs'],
            actions,
            greeting,
            suggestions,
            tools,
-            closeButton,
-            trademark,
-            assistantName,
        });
-    }, [
-        gitbookFrame,
-        actions,
-        greeting,
-        suggestions,
-        tools,
-        tabs,
-        closeButton,
-        trademark,
-        assistantName,
-    ]);
+    }, [gitbookFrame, actions, greeting, suggestions, tools]);

    return (
        <iframe
@@ -76,9 +48,7 @@ export function GitBookFrame(props: GitBookFrameProps) {
            src={frameURL}
            width="100%"
            height="100%"
-            allow="clipboard-write"
            className={className}
-            style={colorScheme ? { colorScheme } : undefined}
        />
    );
 }
@@ -64,8 +64,7 @@ let frameConfiguration: GitBookEmbeddableConfiguration & StandaloneConfiguration
    greeting: { title: '', subtitle: '' },
    suggestions: [],
    tools: [],
-    tabs: ['assistant', 'search', 'docs'],
-    trademark: true,
+    tabs: ['assistant', 'docs'],
 };

 const widgetButton = document.createElement('button');
@@ -101,20 +100,12 @@ function getIframe() {
        widgetIframe?.remove();
        widgetIframe = document.createElement('iframe');
        widgetIframe.id = 'gitbook-widget-iframe';
-        widgetIframe.allow = 'clipboard-write';
-        if (frameOptions?.colorScheme) {
-            widgetIframe.style.colorScheme = frameOptions.colorScheme;
-        }
        widgetIframe.src = client.getFrameURL({
            ...frameOptions,
        });
        widgetWindow.appendChild(widgetIframe);

        _frame = client.createFrame(widgetIframe);
-        _frame.on('close', () => {
-            widgetWindow.classList.add('hidden');
-            widgetButton.classList.remove('open');
-        });
    }
    return { iframe: widgetIframe, frame: _frame };
 }
@@ -161,19 +152,6 @@ const GitBook = (...args: StandaloneCalls) => {
            break;
        case 'configure': {
            const settings = args[1];
-
-            // If trademark is disabled, change the (branded) icon to the sparkle icon
-            if (
-                settings.trademark === false &&
-                !settings.button?.icon &&
-                frameConfiguration.button.icon === 'assistant'
-            ) {
-                settings.button = {
-                    label: frameConfiguration.button.label,
-                    icon: 'sparkle',
-                };
-            }
-
            frameConfiguration = {
                ...frameConfiguration,
                ...settings,
@@ -215,3 +193,5 @@ const precalls = (window.GitBook as GitBookStandalone | undefined)?.q ?? [];
 // @ts-expect-error - GitBook is not defined in the global scope
 window.GitBook = GitBook;
 precalls.forEach((call) => GitBook(...call));
+
+GitBook('configure', {});
@@ -1,8 +0,0 @@
-{
-    "extends": ["//"],
-    "tasks": {
-        "build": {
-            "outputs": ["dist/**", "standalone/**"]
-        }
-    }
-}
@@ -1,23 +1,5 @@
 # @gitbook/expr

-## 1.3.1
-
-### Patch Changes
-
- 3fedaaa: Depend on `eval-estree-expression` from the npm registry (`^3.0.1`) instead of a pinned GitHub commit. The published `3.0.1` release is built from the exact commit the package was pinned to, so the code is unchanged — this only removes the fragile git/tarball dependency so consumers install it from npm like any other package.
-
-## 1.3.0
-
-### Minor Changes
-
- 6eabaec: Implement a getVariables function for ExpressionRuntime
-
-## 1.2.5
-
-### Patch Changes
-
- 8242f18: Extend gitbook/expr std lib with some additional methods
-
 ## 1.2.4

 ### Patch Changes
@@ -1,7 +1,7 @@
 {
    "name": "@gitbook/expr",
    "description": "Safely evaluate & parse user-defined GitBook expressions.",
-    "version": "1.3.1",
+    "version": "1.2.4",
    "type": "module",
    "exports": {
        ".": {
@@ -11,12 +11,12 @@
    },
    "sideEffects": false,
    "dependencies": {
-        "acorn": "^8.15.0",
-        "acorn-loose": "^8.5.2",
+        "acorn": "^8.14.0",
+        "acorn-loose": "8.4.0",
        "acorn-walk": "^8.3.4",
        "assert-never": "catalog:",
        "escodegen": "^2.1.0",
-        "eval-estree-expression": "^3.0.1"
+        "eval-estree-expression": "github:jonschlinkert/eval-estree-expression#fb0246a"
    },
    "devDependencies": {
        "@tsconfig/strictest": "catalog:",
@@ -25,7 +25,6 @@ describe('autocomplete', () => {
        description: 'An array of string',
        items: SymbolString(),
    });
-    const visitorClaimsKeyPropStringSymbol = SymbolString({ name: 'key' });
    const symbols = {
        visitor: SymbolObject({
            name: 'visitor',
@@ -34,7 +33,7 @@ describe('autocomplete', () => {
                    name: 'claims',
                    description: 'The claims contained in the visitor JWT token',
                    properties: {
-                        key: visitorClaimsKeyPropStringSymbol,
+                        key: SymbolString({ name: 'key' }),
                        flags: SymbolObject({
                            name: 'flags',
                            properties: {
@@ -169,12 +168,8 @@ describe('autocomplete', () => {
                        childrenRefs: [
                            'visitor.claims.key.length',
                            'visitor.claims.key.at',
-                            'visitor.claims.key.startsWith',
                            'visitor.claims.key.endsWith',
                            'visitor.claims.key.includes',
-                            'visitor.claims.key.toLowerCase',
-                            'visitor.claims.key.toUpperCase',
-                            'visitor.claims.key.trim',
                        ],
                    },
                },
@@ -232,12 +227,8 @@ describe('autocomplete', () => {
                        childrenRefs: [
                            'visitor.claims.role.length',
                            'visitor.claims.role.at',
-                            'visitor.claims.role.startsWith',
                            'visitor.claims.role.endsWith',
                            'visitor.claims.role.includes',
-                            'visitor.claims.role.toLowerCase',
-                            'visitor.claims.role.toUpperCase',
-                            'visitor.claims.role.trim',
                        ],
                    },
                },
@@ -255,47 +246,13 @@ describe('autocomplete', () => {
                        childrenRefs: [
                            'visitor.claims.key.length',
                            'visitor.claims.key.at',
-                            'visitor.claims.key.startsWith',
                            'visitor.claims.key.endsWith',
                            'visitor.claims.key.includes',
-                            'visitor.claims.key.toLowerCase',
-                            'visitor.claims.key.toUpperCase',
-                            'visitor.claims.key.trim',
                        ],
                    },
                },
            ],
        },
-        {
-            expressionWithCursor: 'visitor.claims.key.<cur>',
-            expectedSuggestions: [
-                {
-                    type: 'symbol',
-                    symbol: {
-                        definition: SymbolNumber({
-                            name: 'length',
-                            description:
-                                'The length data property of a String value contains the length of the string in UTF-16 code units.',
-                            link: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/length',
-                        }),
-                        ref: 'visitor.claims.key.length',
-                        parentRef: 'visitor.claims.key',
-                        childrenRefs: [],
-                    },
-                },
-                ...visitorClaimsKeyPropStringSymbol.methods.map<AutocompleteSymbolSuggestion>(
-                    (method) => ({
-                        type: 'symbol',
-                        symbol: {
-                            definition: method,
-                            ref: `visitor.claims.key.${method.name}`,
-                            parentRef: 'visitor.claims.key',
-                            childrenRefs: [],
-                        },
-                    })
-                ),
-            ],
-        },
        {
            expressionWithCursor: 'visitor.claims.h<cur>',
            expectedSuggestions: [
@@ -54,54 +54,12 @@ describe('ExpressionRuntime', () => {
                inputs: { reviews: [{ status: 'approved' }, { status: 'approved' }] },
                expectedResult: true,
            },
-            {
-                scenario: 'array includes',
-                condition: 'reviews.includes("approved")',
-                inputs: { reviews: ['pending', 'approved'] },
-                expectedResult: true,
-            },
            {
                scenario: 'array map',
                condition: '[1, 2, 3].map(n => n * x)',
                inputs: { x: 2 },
                expectedResult: [2, 4, 6],
            },
-            {
-                scenario: 'string startsWith',
-                condition: 'user.role.startsWith("ad")',
-                inputs: { user: { role: 'admin' } },
-                expectedResult: true,
-            },
-            {
-                scenario: 'string endsWith',
-                condition: 'user.role.endsWith("min")',
-                inputs: { user: { role: 'admin' } },
-                expectedResult: true,
-            },
-            {
-                scenario: 'string includes',
-                condition: 'user.role.includes("dm")',
-                inputs: { user: { role: 'admin' } },
-                expectedResult: true,
-            },
-            {
-                scenario: 'string toLowerCase',
-                condition: 'user.role.toLowerCase() === "admin"',
-                inputs: { user: { role: 'ADMIN' } },
-                expectedResult: true,
-            },
-            {
-                scenario: 'string toUpperCase',
-                condition: 'user.role.toUpperCase() === "ADMIN"',
-                inputs: { user: { role: 'admin' } },
-                expectedResult: true,
-            },
-            {
-                scenario: 'string trim',
-                condition: 'user.role.trim() === "admin"',
-                inputs: { user: { role: '  admin  ' } },
-                expectedResult: true,
-            },
        ])(
            'should properly evaluate/safeEvaluate a valid conditional expression: $scenario',
            ({ condition, inputs, expectedResult }) => {
@@ -195,49 +153,6 @@ describe('ExpressionRuntime', () => {
        );
    });

-    describe('getVariables', () => {
-        it.each([
-            {
-                scenario: 'single variable',
-                condition: 'isBetaUser === true',
-                expectedVariables: ['isBetaUser'],
-            },
-            {
-                scenario: 'multiple variables',
-                condition: 'useProductA && !isBetaUser',
-                expectedVariables: ['useProductA', 'isBetaUser'],
-            },
-            {
-                scenario: 'member expression',
-                condition: 'user.role === "admin"',
-                expectedVariables: ['user.role'],
-            },
-            {
-                scenario: 'nested member expression with method call',
-                condition: 'products.includes("productA") && userSegments.alpha',
-                expectedVariables: ['products.includes', 'userSegments.alpha'],
-            },
-        ])(
-            'should return variables used in expression: $scenario',
-            ({ condition, expectedVariables }) => {
-                expect(runtime.getVariables(condition)).toEqual(expectedVariables);
-            }
-        );
-
-        it.each([
-            {
-                scenario: 'invalid syntax',
-                condition: 't}=d',
-            },
-            {
-                scenario: 'non conditional expression',
-                condition: 'const a = 1;',
-            },
-        ])('should return an empty array for invalid expressions: $scenario', ({ condition }) => {
-            expect(runtime.getVariables(condition)).toEqual([]);
-        });
-    });
-
    describe.skip('generate', () => {
        it.each([
            {
@@ -11,7 +11,7 @@ import {
 import { parse as parseLoose } from 'acorn-loose';
 import escodegen from 'escodegen';
 import evalESTreeExpr from 'eval-estree-expression';
-const { evaluate, variables } = evalESTreeExpr;
+const { evaluate } = evalESTreeExpr;

 import { AutoComplete } from './autocomplete';
 import { ExpressionError } from './errors';
@@ -162,28 +162,6 @@ export class ExpressionRuntime {
            .join('');
    }

-    /**
-     * Given an expression, returns a list of variables used in the expression.
-     */
-    public getVariables(expr: string): string[] {
-        try {
-            const parsed = this.parse(expr);
-
-            if (parsed.invalidNodes.length > 0) {
-                throw new ExpressionError('Invalid nodes found when parsing');
-            }
-
-            return variables(parsed.result, {
-                functions: true,
-                withMembers: true,
-                generate: escodegen.generate,
-            });
-        } catch (error) {
-            this.#logger.error(`Error while parsing expression ${expr} to get variables`, error);
-            return [];
-        }
-    }
-
    /**
     * Parses a binary expression and returns an @ExpressionParserResult.
     */
@@ -255,12 +255,8 @@ describe('ExpressionRuntime', () => {
                childrenRefs: [
                    'visitor.claims.key.length',
                    'visitor.claims.key.at',
-                    'visitor.claims.key.startsWith',
                    'visitor.claims.key.endsWith',
                    'visitor.claims.key.includes',
-                    'visitor.claims.key.toLowerCase',
-                    'visitor.claims.key.toUpperCase',
-                    'visitor.claims.key.trim',
                ],
            });

@@ -305,12 +301,8 @@ describe('ExpressionRuntime', () => {
                childrenRefs: [
                    'visitor.claims.flags.FLAG1.length',
                    'visitor.claims.flags.FLAG1.at',
-                    'visitor.claims.flags.FLAG1.startsWith',
                    'visitor.claims.flags.FLAG1.endsWith',
                    'visitor.claims.flags.FLAG1.includes',
-                    'visitor.claims.flags.FLAG1.toLowerCase',
-                    'visitor.claims.flags.FLAG1.toUpperCase',
-                    'visitor.claims.flags.FLAG1.trim',
                ],
            });

@@ -326,12 +318,8 @@ describe('ExpressionRuntime', () => {
                childrenRefs: [
                    'visitor.claims.flags.FLAG2.length',
                    'visitor.claims.flags.FLAG2.at',
-                    'visitor.claims.flags.FLAG2.startsWith',
                    'visitor.claims.flags.FLAG2.endsWith',
                    'visitor.claims.flags.FLAG2.includes',
-                    'visitor.claims.flags.FLAG2.toLowerCase',
-                    'visitor.claims.flags.FLAG2.toUpperCase',
-                    'visitor.claims.flags.FLAG2.trim',
                ],
            });

@@ -156,31 +156,6 @@ const StandardLibrary: Partial<
                    members: [SymbolString(), SymbolUndefined()],
                }),
            }),
-            SymbolFunction({
-                name: 'startsWith',
-                description: `Returns true if the given characters are found at the beginning of the string, including when searchString 
-            is an empty string. Otherwise returns false.`,
-                link: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/startsWith',
-                args: [
-                    SymbolString({
-                        name: 'searchString',
-                        description: `The characters to be searched for at the start of this string. Cannot be a regex.
-                    All values that are not regexes are coerced to strings, so omitting it or passing undefined causes startsWith() to search for 
-                    the string "undefined", which is rarely what you want.`,
-                    }),
-                    OptionalFunctionArg(
-                        SymbolNumber({
-                            name: 'position',
-                            description: `The start position at which searchString is expected to be found 
-                    (the index of searchString's first character). Defaults to 0.`,
-                        })
-                    ),
-                ],
-                returns: SymbolBoolean({
-                    description: `true if the given characters are found at the beginning of the string, including when searchString is an empty string; 
-                otherwise, false.`,
-                }),
-            }),
            SymbolFunction({
                name: 'endsWith',
                description: `Returns true if the sequence of elements of searchString converted to a String is the same as the corresponding 
@@ -230,39 +205,6 @@ const StandardLibrary: Partial<
                otherwise, false.`,
                }),
            }),
-            SymbolFunction({
-                name: 'toLowerCase',
-                description:
-                    'Returns the value of the string converted to lower case. toLowerCase() does not affect the value of the string str itself.',
-                link: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLowerCase',
-                args: [],
-                returns: SymbolString({
-                    description:
-                        'A new string representing the calling string converted to lower case.',
-                }),
-            }),
-            SymbolFunction({
-                name: 'toUpperCase',
-                description:
-                    'Returns the value of the string converted to uppercase. toUpperCase() does not affect the value of the string str itself.',
-                link: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase',
-                args: [],
-                returns: SymbolString({
-                    description:
-                        'A new string representing the calling string converted to upper case.',
-                }),
-            }),
-            SymbolFunction({
-                name: 'trim',
-                description:
-                    'Returns new string representing str stripped of whitespace from both its beginning and end.',
-                link: 'https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/trim',
-                args: [],
-                returns: SymbolString({
-                    description:
-                        'A new string representing str stripped of whitespace from both its beginning and end.',
-                }),
-            }),
        ],
    },
    [SymbolType.Array]: (arraySymbolDef: ArraySymbolDef) => ({
@@ -41,16 +41,6 @@ declare module 'eval-estree-expression' {
        options?: EvalESTreeExpressionOptions
    ): Promise<any>;

-    /**
-     * Given an ESTree-compliant AST node, returns a list of variables used in the expression.
-     * @param ast An object representing an ESTree-compliant AST node.
-     * @param options Options for evaluation and compilation.
-     */
-    export function variables<ASTNode>(
-        ast: ASTNode,
-        options?: EvalESTreeExpressionOptions
-    ): string[];
-
    /**
     * Evaluates an ESTree expression synchronously against a given context.
     * @param expression - An object representing an ESTree-compliant AST node.
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Viktor Renkema	c5d1bbfafe	wip	2026-02-12 09:40:27 +01:00
Viktor Renkema	dac5e9d444	Fix logo sizing bug during navigation	2026-01-21 20:25:17 +01:00