Enable cover heights in gbo

.changeset/afraid-cougars-happen.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Hide sections if only one is present

.changeset/afraid-mirrors-sleep.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Unify section display condition

.changeset/blue-countries-beg.md

@@ -0,0 +1,5 @@
+---
+"@gitbook/expr": patch
+---
+
+Add dev script for @gitbook/expr

.changeset/calm-ties-burn.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix missing geo data in site insights because of incorrect proxying of events.

.changeset/clever-ducks-double.md

@@ -0,0 +1,6 @@
+---
+'@gitbook/react-openapi': patch
+'gitbook': patch
+---
+
+Enhance OpenAPI security scopes handling

.changeset/cool-falcons-report.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Add stable scroll gutter to search container

.changeset/cuddly-eels-live.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix robots.txt preventing favicon from being indexed.

.changeset/curly-fishes-accept.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Redo search scope UI

.changeset/dirty-mice-sleep.md

@@ -0,0 +1,6 @@
+---
+"@gitbook/react-openapi": patch
+"gitbook": patch
+---
+
+Highlight discriminator properties in oneOf, allOf, anyOf objects

.changeset/dry-melons-joke.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Make search accessible

.changeset/dry-pens-behave.md

@@ -0,0 +1,6 @@
+---
+"@gitbook/react-openapi": patch
+"gitbook": patch
+---
+
+Adapt OpenAPI code samples to prefill API key using visitor data

.changeset/eight-eels-sort.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix markdownPageURL for PageActions

.changeset/fair-bulldogs-double.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Improve default site icon

.changeset/few-elephants-carry.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Use sitespace title instead of space title in search

.changeset/fluffy-clouds-tap.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Support nested site section groups

.changeset/good-mammals-check.md

@@ -1,5 +0,0 @@
----
-"gitbook": patch
----
-
-Improve Assistant form controls

.changeset/jolly-apples-search.md

@@ -1,5 +0,0 @@
----
-"gitbook": minor
----
-
-Redirect sitemap.md and .well-known/sitemap.md to llms.txt.

.changeset/late-mangos-draw.md

@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Show a toolbar for authenticated users with access to the current site.

.changeset/little-months-exercise.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Add support for inline expressions rendering with visitor data on GBO side

.changeset/mean-hornets-sip.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Update to column width sizing

.changeset/mean-starfishes-promise.md

@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Move inline expression evaluation from API to GBO

.changeset/mighty-bears-type.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix rounded outline items

.changeset/olive-mugs-invite.md

@@ -1,5 +0,0 @@
----
-"gitbook": minor
----
-
-Improve AI agent detection and readability by outputting 200 for page not found.

.changeset/quick-donuts-double.md

@@ -0,0 +1,5 @@
+---
+"@gitbook/react-openapi": patch
+---
+
+Ensure operation security requirements inherits from spec-level when not defined

.changeset/quiet-zoos-explain.md

@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Add Italian translation

.changeset/selfish-ravens-drop.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Expose "Best match" when site has translations

.changeset/shaggy-clocks-rule.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Improve screen reader accessibility for hints

.changeset/shaggy-shoes-eat.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Add alt text to inline image

.changeset/sharp-buses-wash.md

@@ -0,0 +1,5 @@
+---
+"@gitbook/react-openapi": minor
+---
+
+Fix OpenAPISecurities and code sample not using operation security requirements

.changeset/shiny-onions-guess.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix crash for card cover defined without objectFit

.changeset/silly-ducks-kiss.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Improve wide page width layout

.changeset/slimy-points-talk.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Add scrollcontainer component

.changeset/spicy-boats-change.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Refactor section tabs

.changeset/spicy-trainers-dance.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix button content truncate

.changeset/tame-months-knock.md

@@ -0,0 +1,5 @@
+---
+'@gitbook/react-openapi': patch
+---
+
+Fix merge logic for allOf alternatives

.changeset/twelve-bears-clean.md

@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix OpenAPI response dropdown & vertical overflow

.changeset/two-coats-trade.md

@@ -0,0 +1,5 @@
+---
+"@gitbook/react-openapi": patch
+---
+
+Fix OpenAPI response showing as JSON instead of YAML when it should

.changeset/unlucky-pumpkins-yawn.md

@@ -0,0 +1,6 @@
+---
+"@gitbook/react-openapi": patch
+"gitbook": patch
+---
+
+Fix OpenAPI alternatives not showing

.changeset/wicked-hornets-crash.md

@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Scope search across sections and variants

.github/CONTRIBUTING.md

@@ -54,9 +54,10 @@ After forking this repository, you'll want to [create a branch](https://docs.git
 #### 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`)
+- Node.js (Version: >=20.6)
+  - Use `nvm` for easy Node management
+- [Bun](https://bun.sh/) (Version: >=1.2.15)
+  - We use a text-based lockfile which isn't supported below 1.2.15
 
 ##### Setup steps:
 

.github/actions/gradual-deploy-cloudflare/action.yaml

@@ -30,7 +30,7 @@ runs:
             apiToken: ${{ inputs.apiToken }}
             accountId: ${{ inputs.accountId }}
             workingDirectory: ./
-            wranglerVersion: '4.43.0'
+            wranglerVersion: '4.10.0'
             environment: ${{ inputs.environment }}
             command: deployments status --config ./packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc
 
@@ -49,7 +49,7 @@ runs:
             apiToken: ${{ inputs.apiToken }}
             accountId: ${{ inputs.accountId }}
             workingDirectory: ./
-            wranglerVersion: '4.43.0'
+            wranglerVersion: '4.10.0'
             environment: ${{ inputs.environment }}
             command: versions deploy ${{ steps.extract_current_version.outputs.version_id }}@100% ${{ inputs.serverVersionId }}@0% -y --config ./packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc
 
@@ -61,7 +61,7 @@ runs:
             apiToken: ${{ inputs.apiToken }}
             accountId: ${{ inputs.accountId }}
             workingDirectory: ./
-            wranglerVersion: '4.43.0'
+            wranglerVersion: '4.10.0'
             environment: ${{ inputs.environment }}
             command: versions deploy ${{ inputs.middlewareVersionId }}@100% -y --config ./packages/gitbook/openNext/customWorkers/middlewareWrangler.jsonc
 
@@ -71,7 +71,7 @@ runs:
             apiToken: ${{ inputs.apiToken }}
             accountId: ${{ inputs.accountId }}
             workingDirectory: ./
-            wranglerVersion: '4.43.0'
+            wranglerVersion: '4.10.0'
             environment: ${{ inputs.environment }}
             command: versions deploy ${{ inputs.serverVersionId }}@100% -y --config ./packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc
 

.github/composite/deploy-cloudflare/action.yaml

@@ -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,8 +52,6 @@ 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_PREVIEW_BASE_URL: ${{ inputs.opItem }}/GITBOOK_PREVIEW_BASE_URL
             GITBOOK_INTEGRATIONS_HOST: ${{ inputs.opItem }}/GITBOOK_INTEGRATIONS_HOST
             GITBOOK_IMAGE_RESIZE_SIGNING_KEY: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_SIGNING_KEY
             GITBOOK_IMAGE_RESIZE_URL: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_URL
@@ -72,7 +70,7 @@ runs:
               apiToken: ${{ inputs.apiToken }}
               accountId: ${{ inputs.accountId }}
               workingDirectory: ./
-              wranglerVersion: '4.43.0'
+              wranglerVersion: '4.10.0'
               environment: ${{ inputs.environment }}
               command: deploy --config ./packages/gitbook/openNext/customWorkers/doWrangler.jsonc
 
@@ -83,7 +81,7 @@ runs:
               apiToken: ${{ inputs.apiToken }}
               accountId: ${{ inputs.accountId }}
               workingDirectory: ./
-              wranglerVersion: '4.43.0'
+              wranglerVersion: '4.10.0'
               environment: ${{ inputs.environment }}
               command: ${{ format('versions upload --tag {0} --message "{1}"', inputs.commitTag, inputs.commitMessage) }} --config ./packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc
 
@@ -106,10 +104,10 @@ runs:
               apiToken: ${{ inputs.apiToken }}
               accountId: ${{ inputs.accountId }}
               workingDirectory: ./
-              wranglerVersion: '4.43.0'
+              wranglerVersion: '4.10.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

.github/composite/deploy-vercel/action.yaml

@@ -20,7 +20,7 @@ inputs:
     description: 'Environment to deploy to'
     required: true
 outputs:
-    deployment-url:
+    deployment-url: 
       description: "Deployment URL"
       value: ${{ steps.deploy.outputs.deployment-url }}
 runs:
@@ -51,8 +51,6 @@ 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_PREVIEW_BASE_URL: ${{ inputs.opItem }}/GITBOOK_PREVIEW_BASE_URL
             GITBOOK_INTEGRATIONS_HOST: ${{ inputs.opItem }}/GITBOOK_INTEGRATIONS_HOST
             GITBOOK_IMAGE_RESIZE_SIGNING_KEY: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_SIGNING_KEY
             GITBOOK_IMAGE_RESIZE_URL: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_URL

.github/workflows/ci.yaml

@@ -4,7 +4,8 @@ on:
     push:
         branches:
             - main
-            - changeset-release/main
+env:
+    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
     format:
         runs-on: ubuntu-latest
@@ -34,10 +35,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:
+            NPM_TOKEN_READONLY: ''
         steps:
             - name: Checkout
               uses: actions/checkout@v4

.github/workflows/deploy-preview.yaml

@@ -1,25 +1,15 @@
 name: Preview
 on:
-    pull_request_target:
+    pull_request:
     push:
-        branches:
-            - main
+      branches:
+        - main
+env:
+    NPM_TOKEN_READONLY: ${{ 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
@@ -43,8 +31,6 @@ jobs:
     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 }}
@@ -53,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
@@ -81,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
@@ -118,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
@@ -137,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
@@ -161,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: 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
@@ -185,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: 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
@@ -209,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
@@ -248,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/

.github/workflows/deploy-production.yaml

@@ -3,6 +3,8 @@ on:
     push:
         branches:
             - main
+env:
+    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
     deploy-v2-vercel:
         name: Deploy v2 to Vercel (production)

.github/workflows/deploy-staging.yaml

@@ -3,6 +3,8 @@ on:
     push:
         branches:
             - main
+env:
+    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
     deploy-v2-vercel:
         name: Deploy v2 to Vercel (staging)

.github/workflows/publish.yaml

@@ -4,6 +4,9 @@ on:
     push:
         branches:
             - main
+
+env:
+    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
     
 concurrency: ${{ github.workflow }}-${{ github.ref }}
 
@@ -11,38 +14,29 @@ jobs:
     publish:
         name: Publish
         runs-on: ubuntu-latest
-        permissions:
-            id-token: write
-            pull-requests: write
-            contents: write
         steps:
             - name: Checkout Repo
               uses: actions/checkout@v3
               with:
                   # This makes Actions fetch all Git history so that Changesets can generate changelogs with the correct commits
                   fetch-depth: 0
-            - name: Setup Node
-              uses: actions/setup-node@v4
-              with:
-                  node-version: 22
-                  registry-url: 'https://registry.npmjs.org'
-            # Ensure npm 11.5.1 or later is installed
-            - name: Update npm
-              run: npm install -g npm@latest
             - name: Setup Bun
               uses: ./.github/composite/setup-bun
             - name: Install dependencies
               run: bun install --frozen-lockfile
               env:
                   PUPPETEER_SKIP_DOWNLOAD: 1
-            - name: Create Release Pull Request
+            - name: Create Release Pull Request or Publish to npm
               id: changesets
               uses: changesets/action@v1
               with:
-                  publish: bun run publish-all-packages
-                  version: bun run changeset-version
+                  publish: npm run release
+                  version: npm run changeset-version
               env:
                   # 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 }}
+                  NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+                  CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+                  CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
 

.gitignore

@@ -25,7 +25,3 @@ yarn-error.log*
 
 # TypeScript
 *.tsbuildinfo
-.npmrc
-
-# Bun pack artifacts
-packages/*/*.tgz

.nvmrc

@@ -1 +1 @@
-v22.3
+v20.6

AGENTS.md

@@ -1,77 +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.

CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

README.md

@@ -35,7 +35,7 @@ To run a local version of this project, please follow these simple steps.
 
 ### Prerequisites
 
-- Node.js (Version: >= 22.3)
+- Node.js (Version: >=20.6)
     - Use nvm for easy Node management
 - [Bun](https://bun.sh/) (Version: >=1.2.15)
   - We use a text-based lockfile which isn't supported below 1.2.15
@@ -77,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
+
+NPM_TOKEN_READONLY=xxx
+```
+
+and then reinstall dependencies.
 
 ## Contributing
 

bunfig.toml

@@ -0,0 +1,2 @@
+[install.scopes]
+"gitbook" = { token = "$NPM_TOKEN_READONLY", url = "https://registry.npmjs.org" }

package.json

@@ -1,24 +1,18 @@
 {
     "name": "gitbook",
     "version": "0.1.0",
-    "engines": {
-        "node": "^22.3.0"
-    },
     "devDependencies": {
         "@biomejs/biome": "^1.9.4",
-        "@changesets/cli": "^2.30.0",
-        "turbo": "^2.9.2",
-        "vercel": "50.37.3"
+        "@changesets/cli": "^2.27.12",
+        "turbo": "^2.5.0",
+        "vercel": "^39.3.0"
     },
-    "packageManager": "bun@1.3.7",
+    "packageManager": "bun@1.2.15",
     "overrides": {
         "@codemirror/state": "6.4.1",
-        "@types/react": "catalog:",
-        "@types/react-dom": "catalog:",
-        "react": "catalog:",
-        "react-dom": "catalog:",
-        "esbuild": "0.24.2",
-        "axios": "1.8.4"
+        "react": "^19.0.0",
+        "react-dom": "^19.0.0",
+        "esbuild": "0.24.2"
     },
     "private": true,
     "scripts": {
@@ -32,29 +26,16 @@
         "e2e": "turbo run e2e",
         "e2e-customers": "turbo run e2e-customers",
         "changeset": "changeset",
-        "changeset-version": "changeset version && bun run format && bun update",
-        "publish-all-packages": "turbo run publish-to-npm --continue=dependencies-successful",
+        "changeset-version": "changeset version && bun run format",
+        "release": "turbo run release && changeset publish",
         "download:env": "op read op://gitbook-x-dev/gitbook-open/.env.local >> .env.local",
         "clean": "turbo run clean"
     },
     "workspaces": {
         "packages": ["packages/*"],
         "catalog": {
-            "@tsconfig/strictest": "^2.0.6",
-            "@tsconfig/node20": "^20.1.6",
-            "@gitbook/api": "0.175.0",
-            "@scalar/api-client-react": "^1.3.46",
-            "@types/react": "^19.0.0",
-            "@types/react-dom": "^19.0.0",
-            "assert-never": "^1.4.0",
-            "bidc": "^0.0.2",
-            "bun-types": "^1.1.20",
-            "classnames": "^2.5.1",
-            "react": "^19.0.1",
-            "react-dom": "^19.0.1",
-            "tsdown": "^0.15.6",
-            "typescript": "^5.5.3",
-            "usehooks-ts": "^3.1.1"
+            "@gitbook/api": "0.143.2",
+            "bidc": "^0.0.2"
         }
     },
     "patchedDependencies": {

packages/browser-types/CHANGELOG.md

@@ -1,44 +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
-
-- 10995e0: Use NPM Trusted publishing for publishing the package.
-- Updated dependencies [10995e0]
-  - @gitbook/icons@0.3.4
-
-## 0.1.2
-
-### Patch Changes
-
-- 6142d6b: Mark as sideEffects, fix all package bundles
-- Updated dependencies [6142d6b]
-  - @gitbook/icons@0.3.3
-
-## 0.1.1
-
-### Patch Changes
-
-- 295f03d: Republish packages
-- Updated dependencies [295f03d]
-  - @gitbook/icons@0.3.2
-
 ## 0.1.0
 
 ### Minor Changes

packages/browser-types/package.json

@@ -8,29 +8,17 @@
             "default": "./dist/index.js"
         }
     },
-    "sideEffects": false,
-    "version": "0.1.5",
+    "version": "0.1.0",
     "dependencies": {
         "@gitbook/api": "catalog:",
         "@gitbook/icons": "workspace:"
     },
     "devDependencies": {
-        "bun-types": "catalog:",
-        "tsdown": "catalog:",
-        "typescript": "catalog:"
+        "typescript": "^5.5.3"
     },
     "scripts": {
-        "build": "tsdown",
-        "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "build": "tsc",
+        "typecheck": "tsc --noEmit"
     },
-    "files": ["dist", "README.md", "CHANGELOG.md"],
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
-    }
+    "files": ["dist", "README.md", "CHANGELOG.md"]
 }

packages/browser-types/src/index.ts

@@ -46,11 +46,6 @@ export type GitBookAssistant = {
     ui?: boolean;
 };
 
-export type GitBookCookieBannerHandler = (options: {
-    onApprove: () => void;
-    onReject: () => void;
-}) => void;
-
 export type GitBookGlobal = {
     /**
      * Register an event listener.
@@ -77,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 {

packages/cache-tags/CHANGELOG.md

@@ -1,23 +1,5 @@
 # @gitbook/cache-tags
 
-## 0.3.4
-
-### Patch Changes
-
-- 10995e0: Use NPM Trusted publishing for publishing the package.
-
-## 0.3.3
-
-### Patch Changes
-
-- 6142d6b: Mark as sideEffects, fix all package bundles
-
-## 0.3.2
-
-### Patch Changes
-
-- 295f03d: Republish packages
-
 ## 0.3.1
 
 ### Patch Changes

packages/cache-tags/package.json

@@ -4,32 +4,22 @@
     "exports": {
         ".": {
             "types": "./dist/index.d.ts",
+            "development": "./src/index.ts",
             "default": "./dist/index.js"
         }
     },
-    "sideEffects": false,
-    "version": "0.3.4",
+    "version": "0.3.1",
     "dependencies": {
         "@gitbook/api": "catalog:",
-        "assert-never": "catalog:"
+        "assert-never": "^1.2.1"
     },
     "devDependencies": {
-        "bun-types": "catalog:",
-        "tsdown": "catalog:",
-        "typescript": "catalog:"
+        "typescript": "^5.5.3"
     },
     "scripts": {
-        "build": "tsdown",
+        "build": "tsc",
         "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "dev": "tsc -w"
     },
-    "files": ["dist", "README.md", "CHANGELOG.md"],
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
-    }
+    "files": ["dist", "src", "README.md", "CHANGELOG.md"]
 }

packages/colors/CHANGELOG.md

@@ -1,23 +1,5 @@
 # @gitbook/colors
 
-## 0.4.3
-
-### Patch Changes
-
-- 10995e0: Use NPM Trusted publishing for publishing the package.
-
-## 0.4.2
-
-### Patch Changes
-
-- 6142d6b: Mark as sideEffects, fix all package bundles
-
-## 0.4.1
-
-### Patch Changes
-
-- 295f03d: Republish packages
-
 ## 0.4.0
 
 ### Minor Changes

packages/colors/package.json

@@ -4,28 +4,18 @@
     "exports": {
         ".": {
             "types": "./dist/index.d.ts",
+            "development": "./src/index.ts",
             "default": "./dist/index.js"
         }
     },
-    "sideEffects": false,
-    "version": "0.4.3",
+    "version": "0.4.0",
     "devDependencies": {
-        "bun-types": "catalog:",
-        "tsdown": "catalog:",
-        "typescript": "catalog:"
+        "typescript": "^5.5.3"
     },
     "scripts": {
-        "build": "tsdown",
+        "build": "tsc",
         "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "dev": "tsc -w"
     },
-    "files": ["dist", "README.md", "CHANGELOG.md"],
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
-    }
+    "files": ["dist", "src", "README.md", "CHANGELOG.md"]
 }

packages/embed/CHANGELOG.md

@@ -1,73 +1,5 @@
 # @gitbook/embed
 
-## 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
-
-- 1430cee: Improve Docs Embed with separate Assistant and Docs tabs
-
-### Patch Changes
-
-- Updated dependencies [62438f4]
-  - @gitbook/icons@0.4.0
-
-## 0.1.5
-
-### Patch Changes
-
-- 10995e0: Use NPM Trusted publishing for publishing the package.
-- Updated dependencies [10995e0]
-  - @gitbook/icons@0.3.4
-
-## 0.1.4
-
-### Patch Changes
-
-- 6142d6b: Mark as sideEffects, fix all package bundles
-- Updated dependencies [6142d6b]
-  - @gitbook/icons@0.3.3
-
-## 0.1.3
-
-### Patch Changes
-
-- 295f03d: Republish packages
-- Updated dependencies [295f03d]
-  - @gitbook/icons@0.3.2
-
-## 0.1.2
-
-### Patch Changes
-
-- 7508674: Fix bundling of packages
-
 ## 0.1.1
 
 ### Patch Changes

packages/embed/README.md

@@ -1,63 +1,24 @@
-# GitBook Docs Embed (`@gitbook/embed`)
+# `@gitbook/embed`
 
-Embed your GitBook docs in your product or website.
-
-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
-- **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.
+Embed the GitBook Docs Assistant in your product or website.
 
 # Usage
 
-## As a standalone script from your docs site
+## As a script from your docs site
 
-All GitBook docs sites include a script to easily add the Docs Embed as a widget on your website.
+All GitBook docs site includes a script to easily embed the docs assistant as a widget on your website.
 
 The script is served at `https://docs.company.com/~gitbook/embed/script.js`.
 
-You can find the embed script from your docs site settings, or you can copy the following and replace `docs.company.com` with your docs site hostname.
+You can find the embed script from your docs site settings, or you can copy the following and replace the `docs.company.com` by your docs site hostname.
 
 ```html
 <script src="https://docs.company.com/~gitbook/embed/script.js"></script>
 <script>
-// Initialize with Authenticated Access (optional)
-window.GitBook('init', 
-    { siteURL: 'https://docs.company.com' },
-    { visitor: { token: 'your-jwt-token' } }
-);
 window.GitBook('show');
 </script>
 ```
 
-The standalone script provides a global `GitBook` function. See the [API Reference](#api-reference) section for all available methods.
-
-### Example: Configuring the widget
-
-```javascript
-GitBook('configure', {
-    button: {
-        label: 'Ask',
-        icon: 'assistant' // 'assistant' | 'sparkle' | 'help' | 'book'
-    },
-    tabs: ['assistant', 'docs'],
-    actions: [
-        {
-            icon: 'circle-question',
-            label: 'Contact Support',
-            onClick: () => window.open('https://support.example.com', '_blank')
-        }
-    ],
-    greeting: { title: 'Welcome!', subtitle: 'How can I help?' },
-    assistantName: 'Support Assistant',
-    suggestions: ['What is GitBook?', 'How do I get started?'],
-    tools: [/* ... */],
-    closeButton: true,
-});
-```
-
-See the [Configuration](#configuration) section for all available options.
-
 ## As a package from NPM
 
 Install the package: `npm install @gitbook/embed` and import it in your web application:
@@ -69,48 +30,10 @@ const gitbook = createGitBook({
     siteURL: 'https://docs.company.com'
 });
 
-// Create an iframe and get its URL
 const iframe = document.createElement('iframe');
-iframe.src = gitbook.getFrameURL({
-    visitor: {
-        token: 'your-jwt-token', // Optional: for Adaptive Content or Authenticated Access
-        unsignedClaims: { // Optional: custom claims for dynamic expressions
-            userId: '123',
-            plan: 'premium'
-        }
-    }
-});
+iframe.src = gitbook.getFrameURL();
 
-// Create a frame client to communicate with the iframe
 const frame = gitbook.createFrame(iframe);
-
-// Use the frame client methods
-frame.navigateToPage('/getting-started'); // Navigate to a page in the docs tab
-frame.navigateToAssistant(); // Switch to the assistant tab
-frame.postUserMessage('How do I get started?');
-frame.clearChat();
-
-// Configure the embed (see Configuration section for all options)
-frame.configure({
-    tabs: ['assistant', 'docs'],
-    actions: [
-        {
-            icon: 'circle-question',
-            label: 'Contact Support',
-            onClick: () => window.open('https://support.example.com', '_blank')
-        }
-    ],
-    greeting: { title: 'Welcome!', subtitle: 'How can I help?' },
-    assistantName: 'Support Assistant',
-    suggestions: ['What is GitBook?', 'How do I get started?'],
-    tools: [/* ... */],
-    closeButton: true
-});
-
-// Listen to events
-frame.on('close', () => {
-    console.log('Frame closed');
-});
 ```
 
 ## As React components
@@ -118,397 +41,9 @@ frame.on('close', () => {
 After installing the NPM package, you can import prebuilt React components:
 
 ```tsx
-import { GitBookProvider, GitBookFrame } from '@gitbook/embed/react';
+import { GitBookProvider, GitBookAssistantFrame } from '@gitbook/embed/react';
 
 <GitBookProvider siteURL="https://docs.company.com">
-    <GitBookFrame
-        visitor={{
-            token: 'your-jwt-token', // Optional: for Adaptive Content or Authenticated Access
-            unsignedClaims: { userId: '123' } // Optional: custom claims for dynamic expressions
-        }}
-        tabs={['assistant', 'docs']}
-        greeting={{ title: 'Welcome!', subtitle: 'How can I help?' }}
-        assistantName="Support Assistant"
-        suggestions={['What is GitBook?', 'How do I get started?']}
-        actions={[
-            {
-                icon: 'circle-question',
-                label: 'Contact Support',
-                onClick: () => window.open('https://support.example.com', '_blank')
-            }
-        ]}
-        tools={[/* ... */]}
-        closeButton
-    />
+    <GitBookAssistantFrame />
 </GitBookProvider>
 ```
-
-You can also use the `useGitBook` hook to access the client:
-
-```tsx
-import { useGitBook } from '@gitbook/embed/react';
-
-function MyComponent() {
-    const gitbook = useGitBook();
-    const frameURL = gitbook.getFrameURL({ visitor: { token: '...' } });
-    // ...
-}
-```
-
-# API Reference
-
-## Method Comparison
-
-| Method | Standalone Script | NPM Package | React Components |
-|--------|------------------|-------------|------------------|
-| **Initialize** | `GitBook('init', options, frameOptions)` | `createGitBook(options)` | `<GitBookProvider siteURL="...">` |
-| **Get frame URL** | ❌ (handled internally) | `client.getFrameURL(options)` | `useGitBook().getFrameURL(options)` |
-| **Create frame client** | ❌ (handled internally) | `client.createFrame(iframe)` | `useGitBook().createFrame(iframe)` |
-| **Show/Hide widget** | `GitBook('show')` / `GitBook('hide')` | ❌ | ❌ |
-| **Open/Close window** | `GitBook('open')` / `GitBook('close')` / `GitBook('toggle')` | ❌ | ❌ |
-| **Navigate to page** | `GitBook('navigateToPage', path)` | `frame.navigateToPage(path)` | Via frame client |
-| **Navigate to assistant** | `GitBook('navigateToAssistant')` | `frame.navigateToAssistant()` | Via frame client |
-| **Post message** | `GitBook('postUserMessage', message)` | `frame.postUserMessage(message)` | Via frame client |
-| **Clear chat** | `GitBook('clearChat')` | `frame.clearChat()` | Via frame client |
-| **Configure** | `GitBook('configure', settings)` | `frame.configure(settings)` | Props on `<GitBookFrame>` |
-| **Event listeners** | ❌ | `frame.on(event, listener)` | Via frame client |
-| **Unload** | `GitBook('unload')` | ❌ | ❌ |
-
-## Method Signatures
-
-### Standalone Script
-
-- `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
-- `GitBook('navigateToAssistant')` - Navigate to assistant tab
-- `GitBook('postUserMessage', message: string)` - Post message to chat
-- `GitBook('clearChat')` - Clear chat history
-- `GitBook('configure', settings: {...})` - Configure widget
-- `GitBook('unload')` - Unload widget
-
-### NPM Package
-
-**Client Factory:**
-- `createGitBook(options: { siteURL: string })` → `GitBookClient`
-- `client.getFrameURL(options?: { visitor?: {...} })` → `string`
-- `client.createFrame(iframe: HTMLIFrameElement)` → `GitBookFrameClient`
-
-**Frame Client:**
-- `frame.navigateToPage(path: string)` → `void`
-- `frame.navigateToAssistant()` → `void`
-- `frame.postUserMessage(message: string)` → `void`
-- `frame.clearChat()` → `void`
-- `frame.configure(settings: Partial<GitBookEmbeddableConfiguration>)` → `void`
-- `frame.on(event: string, listener: Function)` → `() => void` (unsubscribe)
-
-### React Components
-
-**Components:**
-- `<GitBookProvider siteURL: string>` - Provider component
-- `<GitBookFrame {...props}>` - Frame component (accepts all config options as props)
-
-**Hooks:**
-- `useGitBook()` → `GitBookClient` (must be used within `<GitBookProvider>`)
-
-# Configuration
-
-Configuration options are available across usage methods as follows:
-- **Standalone script**: via `GitBook('configure', {...})`
-- **NPM package**: via `frame.configure({...})`
-- **React components**: via props on `<GitBookFrame>`
-
-### `tabs`
-
-Available in: Standalone script, NPM package, React components
-
-Override which tabs are displayed. Defaults to your site's configuration.
-
-- **Type**: `('assistant' | 'docs')[]`
-
-```javascript
-tabs: ['assistant', '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
-```
-
-### Theming and `color-scheme` (CSS-first)
-
-The embed supports both site-controlled theming and CSS-driven theming.
-
-Precedence (highest → lowest):
-
-- **Site mode / forced theme**: if the GitBook site does not support multiple themes, the embed is forced to the site’s default theme.
-- **Visitor preference**: if the site supports multiple themes and the visitor has previously selected a theme on the site, that preference is remembered.
-- **Browser/OS default**: otherwise the embed follows the browser/OS preference (`prefers-color-scheme`).
-
-You can also drive the embed theme from CSS by setting `color-scheme` on the iframe element (or a parent it inherits from). When the iframe resolves to an explicit `color-scheme: light` or `color-scheme: dark`, that value is propagated into the embedded content so it renders consistently.
-
-Standalone widget example:
-
-```css
-/* Force the GitBook widget iframe to render in dark mode */
-#gitbook-widget-iframe {
-  color-scheme: dark;
-}
-```
-
-### `colorScheme`
-
-Available in: Standalone script, NPM package, React components
-
-Force the embed to render in a specific color scheme.
-
-- **Type**: `'light' | 'dark'`
-- **Default**: `undefined` (follow site/visitor preference/system)
-
-```javascript
-GitBook('configure', {
-    colorScheme: 'dark'
-});
-```
-
-To clear an override, omit `colorScheme` (or set it to `undefined` in JS) in a subsequent `configure` call.
-
-### `actions`
-
-Available in: Standalone script, NPM package, React components
-
-Custom action buttons rendered in the sidebar alongside tabs. Each action button triggers a callback when clicked.
-
-**Note**: This prop was previously named `buttons`. Use `actions` instead, it has the same functionality.
-
-- **Type**: `GitBookEmbeddableActionDefinition[]`
-- **Properties**:
-  - `icon`: `string` - Icon name. Any [FontAwesome icon](https://fontawesome.com/search) is supported. (e.g., `'rocket'`, `'comments'`, `'user-circle'`, ...)
-  - `label`: `string` - Button label text
-  - `onClick`: `() => void | Promise<void>` - Callback function when clicked
-
-```javascript
-actions: [
-    {
-        icon: 'comments',
-        label: 'Contact Support',
-        onClick: () => window.open('https://support.example.com', '_blank')
-    },
-    {
-        icon: 'rocket',
-        label: 'Get started',
-        onClick: () => {
-            GitBook('navigateToPage', '/getting-started');
-        }
-    }
-]
-```
-
-### `greeting`
-
-Available in: Standalone script, NPM package, React components
-
-Welcome message displayed in the [Assistant](https://gitbook.com/docs/publishing-documentation/gitbook-ai-assistant) tab.
-
-- **Type**: `{ title: string, subtitle: string }`
-
-```javascript
-greeting: {
-    title: 'Welcome!',
-    subtitle: 'How can I help you today?'
-}
-```
-
-### `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
-
-Suggested questions displayed in the [Assistant](https://gitbook.com/docs/publishing-documentation/gitbook-ai-assistant) welcome screen.
-
-- **Type**: `string[]`
-
-```javascript
-suggestions: [
-    'What is GitBook?',
-    'How do I get started?',
-    'What can you do?'
-]
-```
-
-### `tools`
-
-Available in: Standalone script, NPM package, React components
-
-Custom AI tools to extend the [Assistant](https://gitbook.com/docs/publishing-documentation/gitbook-ai-assistant). Tools allow the assistant to execute functions and integrate with your own systems.
-
-**Note**: In addition to custom tools, the Assistant will always have access to any [MCP servers you define](https://gitbook.com/docs/publishing-documentation/gitbook-ai-assistant#extend-gitbook-assistant-with-mcp-servers) in your site's AI settings.
-
-- **Type**: `GitBookToolDefinition[]`
-- **Properties**:
-  - `name`: `string` - Unique tool identifier
-  - `description`: `string` - Description of what the tool does (used by the AI to decide when and how to use it).
-  - `inputSchema`: `object` - JSON schema defining the tool's input parameters
-  - `execute`: `(input: object) => Promise<{ output: any, summary: string }>` - Async function that executes the tool.
-    - `output`: The result of the tool execution, provided to the AI to continue working with. Not shown to the user.
-    - `summary`: The visual summary of the tool execution, shown in the user's chat window.
-  - `confirmation`: `{ icon?: string, label: string }` (optional) - Confirmation button shown before execution, useful for actions that require the user's express approval.
-
-```javascript
-tools: [
-    {
-        name: 'get_user_info',
-        description: 'Get information about the current user',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                userId: { 
-                    type: 'string', 
-                    description: 'The user ID to look up' 
-                }
-            },
-            required: ['userId']
-        },
-        execute: async (input) => {
-            const user = await fetch(`/api/users/${input.userId}`).then(r => r.json());
-            return {
-                output: { name: user.name, plan: user.plan },
-                summary: `Retrieved info for user ${user.name}`
-            };
-        }
-    },
-    {
-        name: 'create_ticket',
-        description: 'Create a support ticket',
-        confirmation: {
-            icon: 'circle-question',
-            label: 'Create support ticket?'
-        },
-        inputSchema: {
-            type: 'object',
-            properties: {
-                subject: { type: 'string' },
-                description: { type: 'string' }
-            },
-            required: ['subject', 'description']
-        },
-        execute: async (input) => {
-            const ticket = await fetch('/api/tickets', {
-                method: 'POST',
-                body: JSON.stringify(input)
-            }).then(r => r.json());
-            return {
-                output: { ticketId: ticket.id },
-                summary: `Created ticket #${ticket.id}`
-            };
-        }
-    }
-]
-```
-
-### `visitor` (Authenticated Access)
-
-Available in: Standalone script (via `init`), NPM package (via `getFrameURL()`), React components (as prop)
-
-[Authenticated Access](https://gitbook.com/docs/publishing-documentation/authenticated-access) options passed when creating the frame URL. Used for [Adaptive Content](https://gitbook.com/docs/publishing-documentation/adaptive-content) and [Authenticated Access](https://gitbook.com/docs/publishing-documentation/authenticated-access).
-
-**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({ visitor: {...} })`
-**React components**: Pass as the `visitor` prop on `<GitBookFrame>`
-
-- **Type**: `{ token?: string, unsignedClaims?: Record<string, unknown> }`
-- **Properties**:
-  - `token`: `string` (optional) - Signed JWT token for [Adaptive Content](https://gitbook.com/docs/publishing-documentation/adaptive-content) or [Authenticated Access](https://gitbook.com/docs/publishing-documentation/authenticated-access)
-  - `unsignedClaims`: `Record<string, unknown>` (optional) - Unsigned claims that can be used in dynamic expressions via `visitor.claims.unsigned.<claim-name>`
-
-```javascript
-visitor: {
-    token: 'your-jwt-token',
-    unsignedClaims: {
-        userId: '123',
-        plan: 'premium',
-        role: 'admin'
-    }
-}
-```
-
-### `button`
-
-Available in: Standalone script only
-
-Configure the widget button for the standalone script. This option is not available when using the NPM package or React components, since they can be customized completely.
-
-- **Type**: `{ label: string, icon: 'assistant' | 'sparkle' | 'help' | 'book' }`
-- **Properties**:
-  - `label`: `string` - Button label text
-  - `icon`: `'assistant' | 'sparkle' | 'help' | 'book'` - Icon displayed on the button. Choose from one of 4 presets.
-
-```javascript
-button: {
-    label: 'Ask',
-    icon: 'assistant'
-}
-```

packages/embed/package.json

@@ -5,46 +5,27 @@
     "exports": {
         ".": {
             "types": "./dist/index.d.ts",
-            "default": "./dist/index.js"
-        },
-        "./react": {
-            "types": "./dist/react/index.d.ts",
-            "default": "./dist/react/index.js"
+            "default": "./dist/index.js",
+            "standalone": "./dist/standalone/index.js",
+            "react": "./dist/react/index.js"
         }
     },
-    "sideEffects": false,
-    "version": "0.4.0",
+    "version": "0.1.1",
     "dependencies": {
         "@gitbook/api": "catalog:",
         "@gitbook/icons": "workspace:",
         "bidc": "catalog:"
     },
     "peerDependencies": {
-        "react": "*"
+        "react": "^18.0.0"
     },
     "devDependencies": {
-        "bun-types": "catalog:",
-        "@types/react": "catalog:",
-        "tsdown": "catalog:",
-        "typescript": "catalog:",
-        "react": "catalog:"
+        "typescript": "^5.5.3",
+        "react": "^19.0.0"
     },
     "scripts": {
-        "build": "bun run build-lib && bun run build-standalone",
-        "build-lib": "tsdown",
-        "build-standalone": "bun run ./scripts/build-standalone.ts",
-        "clean": "rm -rf ./dist",
-        "unit": "bun test",
-        "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "build": "tsc && bun build src/standalone/index.ts --bundle --minify --outdir=standalone",
+        "typecheck": "tsc --noEmit"
     },
-    "files": ["dist", "README.md", "CHANGELOG.md"],
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
-    }
+    "files": ["dist", "README.md", "CHANGELOG.md", "standalone"]
 }

packages/embed/scripts/build-standalone.ts

@@ -1,36 +0,0 @@
-import { spawn } from 'node:child_process';
-import { readFile, writeFile } from 'node:fs/promises';
-import { Features, transform } from 'lightningcss';
-
-/**
- * Build the standalone embed script.
- * Bun's default CSS transpiler (which is a port of LightningCSS) strips out the native light-dark() function in favour of a polyfill.
- * Light-dark() is widely supported now, and the polyfill requires you to set a data attribute on the element instead of relying on plain CSS.
- * This script's purpose is to pass a feature flag to the CSS transpiler to keep the native light-dark() behavior.
- */
-await new Promise<void>((resolve, reject) => {
-    const child = spawn(
-        'bun',
-        ['build', 'src/standalone/index.ts', '--bundle', '--minify', '--outdir=standalone'],
-        { stdio: 'inherit' }
-    );
-    child.on('error', reject);
-    child.on('exit', (code) => {
-        if (code === 0) {
-            resolve();
-            return;
-        }
-        reject(new Error(`bun build failed with exit code ${code ?? 'unknown'}`));
-    });
-});
-
-const sourceCSS = await readFile('src/standalone/style.css');
-const transformedCSS = transform({
-    filename: 'src/standalone/style.css',
-    code: sourceCSS,
-    minify: true,
-    // Keep native light-dark() behavior scoped to element color-scheme.
-    exclude: Features.LightDark,
-});
-
-await writeFile('standalone/index.css', transformedCSS.code);

packages/embed/src/client/createGitBook.test.ts

@@ -1,38 +0,0 @@
-import { describe, expect, it } from 'bun:test';
-
-import { createGitBook } from './createGitBook';
-
-describe('createGitBook.getFrameURL', () => {
-    it('builds the embed URL when the site URL has no trailing slash', () => {
-        const client = createGitBook({ siteURL: 'https://example.com/docs' });
-
-        const url = new URL(client.getFrameURL({}));
-
-        expect(url.origin).toBe('https://example.com');
-        expect(url.pathname).toBe('/docs/~gitbook/embed');
-        expect(url.searchParams.toString()).toBe('');
-    });
-
-    it('handles a trailing slash and adds visitor parameters', () => {
-        const client = createGitBook({ siteURL: 'https://example.com/docs/' });
-
-        const url = new URL(
-            client.getFrameURL({
-                visitor: {
-                    token: 'signed-token',
-                    unsignedClaims: {
-                        role: 'editor',
-                        count: 3,
-                        enabled: false,
-                    },
-                },
-            })
-        );
-
-        expect(url.pathname).toBe('/docs/~gitbook/embed');
-        expect(url.searchParams.get('jwt_token')).toBe('signed-token');
-        expect(url.searchParams.get('visitor.role')).toBe('editor');
-        expect(url.searchParams.get('visitor.count')).toBe('3');
-        expect(url.searchParams.get('visitor.enabled')).toBe('false');
-    });
-});

packages/embed/src/client/createGitBook.ts

@@ -40,10 +40,10 @@ export function createGitBook(options: CreateGitBookOptions) {
     const client: GitBookClient = {
         getFrameURL: (frameOptions) => {
             const url = new URL(options.siteURL);
-            url.pathname = `${url.pathname.endsWith('/') ? url.pathname : `${url.pathname}/`}~gitbook/embed`;
+            url.pathname = `${url.pathname.endsWith('/') ? url.pathname : `${url.pathname}/`}~gitbook/embed/assistant`;
 
             if (frameOptions.visitor?.token) {
-                url.searchParams.set('jwt_token', frameOptions.visitor.token);
+                url.searchParams.set('token', frameOptions.visitor.token);
             }
 
             if (frameOptions.visitor?.unsignedClaims) {

packages/embed/src/client/createGitBookFrame.ts

@@ -64,12 +64,10 @@ export function createGitBookFrame(iframe: HTMLIFrameElement): GitBookFrameClien
     const events = new Map<string, Array<(...args: any[]) => void>>();
 
     const configuration: GitBookEmbeddableConfiguration = {
-        tabs: ['assistant', 'docs'],
-        actions: [],
-        greeting: { title: '', subtitle: '' },
+        buttons: [],
+        welcomeMessage: '',
         suggestions: [],
         tools: [],
-        trademark: true,
     };
 
     return {

packages/embed/src/client/protocol.ts

@@ -23,7 +23,7 @@ export type GitBookToolDefinition = AIToolDefinition & {
 /**
  * Custom button definition to be passed to the embeddable GitBook.
  */
-export type GitBookEmbeddableActionDefinition = {
+export type GitBookEmbeddableButtonDefinition = {
     /**
      * Icon to be displayed in the button.
      */
@@ -41,53 +41,22 @@ export type GitBookEmbeddableActionDefinition = {
 };
 
 /**
- * Overall configuration for the layout of the GitBook embed.
+ * Overall configuration for the layout of the embeddable GitBook.
  */
 export type GitBookEmbeddableConfiguration = {
-    /** Tabs to display in the embed (if enabled on the site). */
-    tabs: ('assistant' | 'docs')[];
-
-    /** Additional buttons to be displayed in the header of the GitBook embed. */
-    actions: GitBookEmbeddableActionDefinition[];
-
     /**
-     * Additional buttons to be displayed in the header of the GitBook embed.
-     * @deprecated Use `actions` instead.
+     * Buttons to be displayed in the header of the embeddable GitBook.
      */
-    buttons?: GitBookEmbeddableActionDefinition[];
+    buttons: GitBookEmbeddableButtonDefinition[];
 
     /** Message to be displayed in the welcome page. */
-    greeting: {
-        title: string;
-        subtitle: string;
-    };
-
-    /**
-     * Override the assistant name displayed in the UI.
-     * Limited to 32 characters.
-     */
-    assistantName?: string;
+    welcomeMessage: 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;
-
-    /**
-     * Force the embed to render in a specific color-scheme.
-     */
-    colorScheme?: 'light' | 'dark';
 };
 
 /**

packages/embed/src/index.ts

@@ -1,2 +1 @@
 export * from './client';
-export * from './standalone';

packages/embed/src/react/GitBookFrame.tsx

@@ -1,6 +1,4 @@
-'use client';
-
-import { useEffect, useMemo, useRef, useState } from 'react';
+import React from 'react';
 import type {
     GetFrameURLOptions,
     GitBookEmbeddableConfiguration,
@@ -11,59 +9,34 @@ 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,
-        visitor,
-        actions = [],
-        greeting,
-        suggestions = [],
-        tools = [],
-        tabs = ['assistant', 'docs'],
-        trademark = true,
-        closeButton = false,
-        assistantName,
-    } = props;
+    const { className, visitor, buttons, welcomeMessage, suggestions, tools } = props;
 
-    const frameRef = useRef<HTMLIFrameElement>(null);
+    const frameRef = React.useRef<HTMLIFrameElement>(null);
     const gitbook = useGitBook();
-    const [gitbookFrame, setGitbookFrame] = useState<GitBookFrameClient | null>(null);
+    const [gitbookFrame, setGitbookFrame] = React.useState<GitBookFrameClient | null>(null);
 
-    const frameURL = useMemo(() => gitbook.getFrameURL({ visitor }), [gitbook, visitor]);
+    const frameURL = React.useMemo(() => gitbook.getFrameURL({ visitor }), [gitbook, visitor]);
 
-    useEffect(() => {
+    React.useEffect(() => {
         if (frameRef.current) {
             setGitbookFrame(gitbook.createFrame(frameRef.current));
         }
     }, [gitbook]);
 
-    useEffect(() => {
+    React.useEffect(() => {
         gitbookFrame?.configure({
-            tabs,
-            actions,
-            greeting,
+            buttons,
+            welcomeMessage,
             suggestions,
             tools,
-            closeButton,
-            trademark,
-            assistantName,
         });
-    }, [
-        gitbookFrame,
-        actions,
-        greeting,
-        suggestions,
-        tools,
-        tabs,
-        closeButton,
-        trademark,
-        assistantName,
-    ]);
+    }, [gitbookFrame, buttons, welcomeMessage, suggestions, tools]);
 
     return (
         <iframe

packages/embed/src/standalone/index.ts

@@ -31,52 +31,24 @@ type StandaloneCalls =
     // Clear the chat
     | ['clearChat']
     // Configure the embed
-    | ['configure', Partial<GitBookEmbeddableConfiguration & StandaloneConfiguration>]
+    | ['configure', Partial<GitBookEmbeddableConfiguration>]
     // Navigate to a page
     | ['navigateToPage', string]
     // Navigate to the assistant
     | ['navigateToAssistant'];
 
-type StandaloneConfiguration = {
-    /** Configure the button to open the embed */
-    button: {
-        /** Label to be displayed in the button. */
-        label: string;
-        /** Icon to be displayed in the button. */
-        icon: 'assistant' | 'sparkle' | 'help' | 'book';
-    };
-};
-
 export type GitBookStandalone = ((...args: StandaloneCalls) => void) & {
     q?: StandaloneCalls[];
 };
 
-let widgetIframe: HTMLIFrameElement | undefined;
-let _client: GitBookClient | undefined;
-let _frame: GitBookFrameClient | undefined;
-let frameOptions: GetFrameURLOptions | undefined;
-let lastPushedColorScheme: 'light' | 'dark' | undefined;
-let frameConfiguration: GitBookEmbeddableConfiguration & StandaloneConfiguration = {
-    button: {
-        label: 'Ask',
-        icon: 'assistant',
-    },
-    actions: [],
-    greeting: { title: '', subtitle: '' },
-    suggestions: [],
-    tools: [],
-    tabs: ['assistant', 'docs'],
-    trademark: true,
-};
-
 const widgetButton = document.createElement('button');
 widgetButton.id = 'gitbook-widget-button';
 widgetButton.addEventListener('click', () => {
     GitBook('toggle');
 });
 widgetButton.innerHTML = `
-    <span id="gitbook-widget-button-icon" data-icon="${frameConfiguration.button.icon}"></span>
-    <span id="gitbook-widget-button-label">${frameConfiguration.button.label}</span>
+    <span id="gitbook-widget-button-icon"></span>
+    <span id="gitbook-widget-button-label">Ask</span>
 `;
 
 const widgetWindow = document.createElement('div');
@@ -86,42 +58,16 @@ widgetWindow.classList.add('hidden');
 document.body.appendChild(widgetButton);
 document.body.appendChild(widgetWindow);
 
-/** Resolved `color-scheme` from the iframe element (incl. inheritance from `#gitbook-widget-window`). */
-function colorSchemeFromIframe(): 'light' | 'dark' | undefined {
-    if (!widgetIframe) return undefined;
-    const v = getComputedStyle(widgetIframe).colorScheme.trim().toLowerCase();
-    return v === 'dark' || v === 'light' ? v : undefined;
-}
-
-function pushColorSchemeToFrame() {
-    if (!_frame) return;
-
-    const desired = frameConfiguration.colorScheme ?? colorSchemeFromIframe();
-    if (desired === lastPushedColorScheme) return;
-    lastPushedColorScheme = desired;
-
-    _frame.configure({
-        ...frameConfiguration,
-        colorScheme: desired,
-    });
-}
-
-/** Re-push when the host page or widget chrome changes theme (class/style) or OS preference changes. */
-function installHostThemeBridge() {
-    const onChange = () => pushColorSchemeToFrame();
-    window.matchMedia?.('(prefers-color-scheme: dark)')?.addEventListener?.('change', onChange);
-
-    if (typeof MutationObserver === 'undefined') return;
-    const observer = new MutationObserver(onChange);
-    const opts: MutationObserverInit = {
-        attributes: true,
-        attributeFilter: ['class', 'style'],
-    };
-    observer.observe(document.documentElement, opts);
-    // Safari: `color-scheme` on `#gitbook-widget-window` does not always surface on `<html>`.
-    observer.observe(widgetWindow, opts);
-}
-installHostThemeBridge();
+let widgetIframe: HTMLIFrameElement | undefined;
+let _client: GitBookClient | undefined;
+let _frame: GitBookFrameClient | undefined;
+let frameOptions: GetFrameURLOptions | undefined;
+let frameConfiguration: GitBookEmbeddableConfiguration = {
+    buttons: [],
+    welcomeMessage: '',
+    suggestions: [],
+    tools: [],
+};
 
 function getClient() {
     if (!_client) {
@@ -137,7 +83,6 @@ function getIframe() {
         const client = getClient();
 
         widgetIframe?.remove();
-        lastPushedColorScheme = undefined;
         widgetIframe = document.createElement('iframe');
         widgetIframe.id = 'gitbook-widget-iframe';
         widgetIframe.src = client.getFrameURL({
@@ -146,12 +91,6 @@ function getIframe() {
         widgetWindow.appendChild(widgetIframe);
 
         _frame = client.createFrame(widgetIframe);
-        _frame.on('close', () => {
-            widgetWindow.classList.add('hidden');
-            widgetButton.classList.remove('open');
-        });
-
-        pushColorSchemeToFrame();
     }
     return { iframe: widgetIframe, frame: _frame };
 }
@@ -196,47 +135,27 @@ const GitBook = (...args: StandaloneCalls) => {
         case 'postUserMessage':
             getIframe().frame.postUserMessage(args[1]);
             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',
-                };
-            }
-
+        case 'configure':
             frameConfiguration = {
                 ...frameConfiguration,
-                ...settings,
+                ...args[1],
             };
-            // Update the button label and icon
-            if (settings.button?.label) {
-                const label = widgetButton.querySelector('#gitbook-widget-button-label');
-                if (label) {
-                    label.textContent = settings.button.label;
-                }
-            }
-            if (settings.button?.icon) {
-                const icon = widgetButton.querySelector('#gitbook-widget-button-icon');
-                if (icon) {
-                    icon.setAttribute('data-icon', settings.button.icon);
-                }
-            }
-
-            const { frame } = getIframe();
-            // Always propagate configuration updates, even when color-scheme doesn't change.
-            frame.configure({
+            getIframe().frame.configure({
                 ...frameConfiguration,
+                buttons: [
+                    ...frameConfiguration.buttons,
+
+                    // Always include a close button
+                    {
+                        icon: 'close',
+                        label: 'Close',
+                        onClick: () => {
+                            GitBook('close');
+                        },
+                    },
+                ],
             });
-            pushColorSchemeToFrame();
             break;
-        }
         case 'clearChat':
             getIframe().frame.clearChat();
             break;
@@ -255,3 +174,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', {});

packages/embed/src/standalone/style.css

@@ -8,6 +8,14 @@
 
     --gitbook-widget-radius: .5rem;
     --gitbook-widget-text-size: 1rem;
+    --gitbook-widget-text-color: #656973;
+    --gitbook-widget-border-color: #e5e5e5;
+
+    --gitbook-widget-background-translucent: rgba(255, 255, 255, 0.9);
+    --gitbook-widget-background-translucent-hover: rgba(250, 250, 250, 0.9);
+    --gitbook-widget-background-solid: #FFFFFF;
+    --gitbook-widget-background-solid-hover: #FBFBFB;
+
     --gitbook-widget-icon-size: 1.25rem;
 
     --gitbook-widget-window-width: 28rem; /* 448px */
@@ -21,23 +29,6 @@
     --gitbook-widget-easing-bounce: cubic-bezier(0.34, 1.56, 0.64, 1);
 }
 
-#gitbook-widget-button,
-#gitbook-widget-window {
-    --gitbook-widget-text-color: light-dark(#656973, #FFFFFF);
-    --gitbook-widget-border-color: light-dark(#e5e5e5, #202020);
-    --gitbook-widget-background-translucent: light-dark(rgba(255, 255, 255, 0.9), rgba(15, 15, 15, 0.9));
-    --gitbook-widget-background-translucent-hover: light-dark(rgba(250, 250, 250, 0.9), rgba(20, 20, 20, 0.9));
-    --gitbook-widget-background-solid: light-dark(#FFFFFF, #f0f0f0);
-    --gitbook-widget-background-solid-hover: light-dark(#FBFBFB, #f0f0f0);
-
-    &[data-color-scheme=light] {
-        color-scheme: light;
-    }
-    &[data-color-scheme=dark] {
-        color-scheme: dark;
-    }
-}
-
 * {
     box-sizing: border-box;
 }
@@ -112,18 +103,6 @@
     background-color: currentColor;
 }
 
-#gitbook-widget-button-icon[data-icon="sparkle"] {
-    mask-image: url("https://ka-p.fontawesome.com/releases/v6.6.0/svgs/regular/sparkle.svg?v=2&token=a463935e93");
-}
-
-#gitbook-widget-button-icon[data-icon="help"] {
-    mask-image: url("https://ka-p.fontawesome.com/releases/v6.6.0/svgs/regular/circle-question.svg?v=2&token=a463935e93");
-}
-
-#gitbook-widget-button-icon[data-icon="book"] {
-    mask-image: url("https://ka-p.fontawesome.com/releases/v6.6.0/svgs/regular/book-open.svg?v=2&token=a463935e93");
-}
-
 #gitbook-widget-button.open #gitbook-widget-button-icon {
     mask-image: url('https://ka-p.fontawesome.com/releases/v6.6.0/svgs/regular/close.svg?v=2&token=a463935e93');
 }
@@ -141,8 +120,7 @@
     z-index: 9998;
     width: calc(min(var(--gitbook-widget-window-width), calc(100vw - var(--gitbook-widget-right) - var(--gitbook-widget-left))));
     height: calc(min(var(--gitbook-widget-window-height), calc(100vh - var(--gitbook-widget-window-bottom) - var(--gitbook-widget-top))));
-    background-color: var(--gitbook-widget-background-translucent);
-    backdrop-filter: blur(48px);
+    background-color: var(--gitbook-widget-background-solid);
     border: 1px solid var(--gitbook-widget-border-color);
     border-radius: var(--gitbook-widget-radius);
     box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);

packages/embed/tsconfig.json

@@ -15,9 +15,7 @@
         "isolatedModules": true,
         "jsx": "react-jsx",
         "incremental": true,
-        "types": [
-            "bun-types" // add Bun global
-        ]
+        "types": []
     },
     "include": ["src/**/*.ts", "src/**/*.tsx"],
     "exclude": ["node_modules"]

packages/embed/tsdown.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from 'tsdown';
-
-export default defineConfig([
-    {
-        entry: 'src/index.ts',
-        outDir: 'dist',
-    },
-    {
-        entry: 'src/react/index.ts',
-        outDir: 'dist/react',
-        unbundle: true,
-    },
-]);

packages/emoji-codepoints/CHANGELOG.md

@@ -1,25 +1,13 @@
 # @gitbook/emoji-codepoints
 
-## 0.2.2
-
-### Patch Changes
-
-- 6142d6b: Mark as sideEffects, fix all package bundles
-
-## 0.2.1
-
-### Patch Changes
-
-- 295f03d: Republish packages
-
 ## 0.2.0
 
 ### Minor Changes
 
-- 57adb3e: Second release to fix publishing with changeset
+-   57adb3e: Second release to fix publishing with changeset
 
 ## 0.1.0
 
 ### Minor Changes
 
-- 5f8a8fe: Initial release
+-   5f8a8fe: Initial release

packages/emoji-codepoints/package.json

@@ -1,12 +1,12 @@
 {
     "name": "@gitbook/emoji-codepoints",
     "description": "Optimized mapping of codepoints to the fully qualified emoji codepoints",
-    "version": "0.2.2",
+    "version": "0.2.0",
     "private": true,
     "exports": "./dist/index.ts",
-    "sideEffects": false,
+    "dependencies": {},
     "devDependencies": {
-        "emoji-assets": "^9.0.0"
+        "emoji-assets": "^8.0.0"
     },
     "scripts": {
         "generate": "bun ./build.ts",

packages/expr/CHANGELOG.md

@@ -1,30 +1,5 @@
 # @gitbook/expr
 
-## 1.2.4
-
-### Patch Changes
-
-- 10995e0: Use NPM Trusted publishing for publishing the package.
-- 10995e0: Use NPM dependency for eval-estree-expression
-
-## 1.2.3
-
-### Patch Changes
-
-- 6142d6b: Mark as sideEffects, fix all package bundles
-
-## 1.2.2
-
-### Patch Changes
-
-- 295f03d: Republish packages
-
-## 1.2.1
-
-### Patch Changes
-
-- a629900: Add dev script for @gitbook/expr
-
 ## 1.2.0
 
 ### Minor Changes

packages/expr/package.json

@@ -1,47 +1,38 @@
 {
     "name": "@gitbook/expr",
     "description": "Safely evaluate & parse user-defined GitBook expressions.",
-    "version": "1.2.4",
+    "version": "1.2.0",
     "type": "module",
     "exports": {
         ".": {
             "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
             "default": "./dist/index.js"
         }
     },
     "sideEffects": false,
     "dependencies": {
-        "acorn": "^8.15.0",
-        "acorn-loose": "^8.5.2",
+        "eval-estree-expression": "github:jonschlinkert/eval-estree-expression#9cf28d2",
+        "acorn": "^8.14.0",
+        "acorn-loose": "8.4.0",
         "acorn-walk": "^8.3.4",
-        "assert-never": "catalog:",
         "escodegen": "^2.1.0",
-        "eval-estree-expression": "github:jonschlinkert/eval-estree-expression#fb0246a"
+        "assert-never": "^1.2.1"
     },
     "devDependencies": {
-        "@tsconfig/strictest": "catalog:",
-        "@tsconfig/node20": "catalog:",
-        "@types/escodegen": "^0.0.10",
+        "bun-types": "^1.1.20",
+        "tsdown": "^0.15.0",
         "@types/estree": "^1.0.6",
+        "@babel/types": "^7.26.0",
         "@types/json-schema": "^7.0.15",
-        "bun-types": "catalog:",
-        "tsdown": "catalog:",
-        "typescript": "catalog:"
+        "@types/escodegen": "^0.0.10"
     },
     "scripts": {
-        "build": "tsdown",
+        "build": "tsdown --project tsconfig.build.json",
         "typecheck": "tsc --noEmit",
         "unit": "bun test",
         "clean": "rm -rf ./dist",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "dev": "bun run build -- --watch"
     },
-    "files": ["dist", "README.md", "CHANGELOG.md"],
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
-    }
+    "files": ["dist", "README.md", "CHANGELOG.md"]
 }

packages/expr/tsconfig.build.json

@@ -0,0 +1,10 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "extends": ["./tsconfig.json"],
+    "exclude": ["**/*.test.ts"],
+    "compilerOptions": {
+        "declaration": true,
+        "noEmit": false,
+        "outDir": "dist"
+    }
+}

packages/expr/tsdown.config.ts

@@ -2,7 +2,8 @@ import { defineConfig } from 'tsdown';
 
 export default defineConfig([
     {
-        entry: 'src/index.ts',
-        unbundle: true,
+        entry: ['src/index.ts'],
+        dts: true,
+        format: ['esm'],
     },
 ]);

packages/fonts/CHANGELOG.md

@@ -1,23 +1,5 @@
 # @gitbook/fonts
 
-## 0.1.3
-
-### Patch Changes
-
-- 10995e0: Use NPM Trusted publishing for publishing the package.
-
-## 0.1.2
-
-### Patch Changes
-
-- 6142d6b: Mark as sideEffects, fix all package bundles
-
-## 0.1.1
-
-### Patch Changes
-
-- 295f03d: Republish packages
-
 ## 0.1.0
 
 ### Minor Changes

packages/fonts/package.json

@@ -4,38 +4,28 @@
     "exports": {
         ".": {
             "types": "./dist/index.d.ts",
+            "development": "./src/index.ts",
             "default": "./dist/index.js"
         }
     },
-    "sideEffects": false,
-    "version": "0.1.3",
+    "version": "0.1.0",
     "dependencies": {
         "@gitbook/api": "catalog:"
     },
     "devDependencies": {
-        "bun-types": "catalog:",
-        "google-font-metadata": "^6.0.7",
-        "tsdown": "catalog:",
-        "typescript": "catalog:"
+        "google-font-metadata": "^6.0.3",
+        "typescript": "^5.5.3"
     },
     "scripts": {
         "generate": "bun ./bin/generate.js",
-        "build": "tsdown",
+        "build": "tsc --project tsconfig.build.json",
         "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
+        "dev": "tsc -w",
         "clean": "rm -rf ./dist && rm -rf ./src/data",
-        "unit": "bun test",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "unit": "bun test"
     },
-    "files": ["dist", "bin", "README.md", "CHANGELOG.md"],
+    "files": ["dist", "src", "bin", "README.md", "CHANGELOG.md"],
     "engines": {
         "node": ">=20.0.0"
-    },
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
     }
 }

packages/fonts/src/__snapshots__/getDefaultFont.test.ts.snap

@@ -1,57 +1,57 @@
-// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
+// Bun Snapshot v1, https://goo.gl/fbAQLP
 
 exports[`getDefaultFont should return correct object for Latin text 1`] = `
 {
   "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
 }
 `;
 
 exports[`getDefaultFont should return correct object for Cyrillic text 1`] = `
 {
   "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZthjp-Ek-_0ewmM.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZthjp-Ek-_0ewmM.woff",
 }
 `;
 
 exports[`getDefaultFont should return correct object for Greek text 1`] = `
 {
   "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZxhjp-Ek-_0ewmM.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZxhjp-Ek-_0ewmM.woff",
 }
 `;
 
 exports[`getDefaultFont should handle mixed script text 1`] = `
 {
   "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZthjp-Ek-_0ewmM.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZthjp-Ek-_0ewmM.woff",
 }
 `;
 
 exports[`getDefaultFont should handle different font weights: regular 1`] = `
 {
   "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
 }
 `;
 
 exports[`getDefaultFont should handle different font weights: bold 1`] = `
 {
   "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuFuYAZ9hjp-Ek-_0ew.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuFuYAZ9hjp-Ek-_0ew.woff",
 }
 `;
 
 exports[`getDefaultFont should handle different fonts: inter 1`] = `
 {
   "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
 }
 `;
 
 exports[`getDefaultFont should handle different fonts: roboto 1`] = `
 {
   "font": "Roboto",
-  "url": "https://fonts.gstatic.com/s/roboto/v49/KFOMCnqEu92Fr1ME7kSn66aGLdTylUAMQXC89YmC2DPNWubEbVmUiAz0klQm_20.woff",
+  "url": "https://fonts.gstatic.com/s/roboto/v32/KFOmCnqEu92Fr1Mu4mxMKTU1Kg.woff",
 }
 `;

packages/fonts/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+    "extends": "./tsconfig.json",
+    "exclude": ["node_modules", "src/**/*.test.ts"]
+}

packages/gitbook/CHANGELOG.md

@@ -1,370 +1,5 @@
 # gitbook
 
-## 0.23.2
-
-### Patch Changes
-
-- Updated dependencies [ab17ff4]
-  - @gitbook/icons@0.4.6
-  - @gitbook/react-contentkit@0.7.15
-
-## 0.23.1
-
-### Patch Changes
-
-- Updated dependencies [3c141f0]
-  - @gitbook/icons@0.4.5
-  - @gitbook/react-contentkit@0.7.14
-
-## 0.23.0
-
-### Minor Changes
-
-- 8e5a2aa: Pan and zoom controls for mermaid diagrams
-
-### Patch Changes
-
-- b77c4fc: Add getPage MCP tool
-- 31e77d4: Track new events for site analytics.
-- f884477: Associate questions asked in the embeddable assistant to the proper channel.
-- deabce9: Sort results by score to mix records and pages.
-- 4909044: Add Claude Code and Codex connect actions
-- da648ca: Fix regressions in Assistant UX
-- 3ce7e52: Fix Variant dropdown not showing in GitBook embed
-- 7f4e644: Small OpenAPI Improvements
-- 4787b7e: Use localized titles/descriptions for site entities
-- 7ab6351: Import site redirect patterns from @gitbook/api
-- b40465e: Fix normalization of URL causing invalid redirections.
-- b5d6f2e: Fix translation quality across 11 locales
-- 3151864: Track events from the proper server URL.
-- 16bfafe: Add option to sticky header row in tables
-- 7c2823c: Fix full width header alignment
-- c4a2604: Fix PDF export crash when page contains an OpenAPI block
-- c56b569: Support expand-all options for OpenAPI
-- Updated dependencies [7f4e644]
-- Updated dependencies [b5d6f2e]
-- Updated dependencies [9dd2db6]
-- Updated dependencies [c56b569]
-- Updated dependencies [ccd21e4]
-  - @gitbook/react-openapi@1.5.11
-  - @gitbook/openapi-parser@3.0.11
-  - @gitbook/icons@0.4.4
-  - @gitbook/react-contentkit@0.7.13
-
-## 0.22.3
-
-### Patch Changes
-
-- f182680: Add backward compatibility for OpenAPI spec content URL
-- bdc6cd9: Use OpenAPI publicURL as Scalar specUrl
-- b3875a1: Refactor embeddable context to merge local & site properties in one unified way
-- eceec6f: Move ~scalar/proxy route to site route group
-- 887c3f8: Add token verification on OpenAPI proxy
-- d666212: Add support for localized site section titles
-- Updated dependencies [b3875a1]
-- Updated dependencies [bdc6cd9]
-- Updated dependencies [8ab419a]
-- Updated dependencies [eceec6f]
-- Updated dependencies [887c3f8]
-  - @gitbook/embed@0.4.0
-  - @gitbook/react-openapi@1.5.10
-  - @gitbook/openapi-parser@3.0.10
-
-## 0.22.2
-
-### Patch Changes
-
-- e074283: Add server-side proxy for Scalar API client to bypass CORS
-- afa868e: Show "Ask Assistant" search result immediately
-- 0803db0: Track opening of search results for records and in the assistant.
-- cb71511: Wrap tracking call with waitUntil
-- 4a6f91a: Show social accounts in header
-- 370b731: Docs Embed: Make trademark optional
-- afa476c: Add server-side insight event tracking for MCP route
-- Updated dependencies [e074283]
-- Updated dependencies [370b731]
-  - @gitbook/openapi-parser@3.0.9
-  - @gitbook/react-openapi@1.5.9
-  - @gitbook/embed@0.3.0
-
-## 0.22.1
-
-### Patch Changes
-
-- 9d5e397: Remove code syntax highlighting patch for Safari
-- 3d8e89c: Show favicon for record search results in the assistant.
-- 5f66860: Use isCookiesTrackingDisabled for cookie consent integrations
-- 426aabe: Fix TOC header logo on bold themes
-- ae30a57: Integrate Ask AI with upcoming insights by passing visitor session IDs.
-- f7c251e: Update Reddit social account rendering
-- e31a8f4: Hide cookie banner for AI user agents
-- 2e495cb: Add Global Privacy Control (GPC) support
-- Updated dependencies [1a7ef78]
-- Updated dependencies [93eea0b]
-- Updated dependencies [b4b471f]
-- Updated dependencies [5f66860]
-- Updated dependencies [2ebb18d]
-- Updated dependencies [11d9b80]
-- Updated dependencies [2e495cb]
-- Updated dependencies [f517035]
-  - @gitbook/react-openapi@1.5.8
-  - @gitbook/embed@0.2.2
-  - @gitbook/browser-types@0.1.5
-
-## 0.22.0
-
-### Minor Changes
-
-- e00d1c5: Support code themes customization
-- f294818: Serve a markdown version of the page when the "Accept" header contains "text/markdown".
-
-### Patch Changes
-
-- 9d6457f: OpenAPI styling tweaks
-- d738e11: Prevent form submission during IME composition
-- 1e53376: Add sidesheet component, use it for TOC and AIChat
-- f7f6f9d: Set <html lang> based on translated language
-- 89de966: Support social links
-- b53cb1d: Align styling of PageLinkItem and PageDocumentItem
-- 27a34b7: Support `defaultExpanded` in Expandable block
-- a5ef44a: Better conditional display of page actions
-- 07c02eb: Header & TOC tweaks
-- 29e2b22: Fix ordered list item index calculation
-- f6cf62a: Standardise toggle chevrons across the app
-- b57561d: Fix rendering of images in reusable content from an external space with the new dereferencing in the API.
-- e172b25: Grow InlineActionButton to take available width on line
-- 7a11861: Add support for custom cookie banner registration
-- 8f32f4f: Better handle huge section groups
-- 0aa34cc: Fix Embed options in React
-- Updated dependencies [e00d1c5]
-- Updated dependencies [96e24a1]
-- Updated dependencies [4e2d863]
-- Updated dependencies [d3f6c38]
-- Updated dependencies [3ba9e46]
-- Updated dependencies [717ad0b]
-- Updated dependencies [6f1db32]
-- Updated dependencies [7a11861]
-- Updated dependencies [0aa34cc]
-- Updated dependencies [48ca21e]
-  - @gitbook/react-openapi@1.5.7
-  - @gitbook/embed@0.2.1
-  - @gitbook/openapi-parser@3.0.8
-  - @gitbook/icons@0.4.3
-  - @gitbook/browser-types@0.1.4
-  - @gitbook/react-contentkit@0.7.12
-
-## 0.21.3
-
-### Patch Changes
-
-- Updated dependencies [bf63045]
-  - @gitbook/react-openapi@1.5.6
-
-## 0.21.2
-
-### Patch Changes
-
-- ca68236: Fix 404 when accessing rss.xml for the root page.
-- 21851d3: Round page cover corners on extrawide screens
-- 695e99f: Update button sizing
-- 7517e98: Clean up button and input across the app
-- 99d788e: Update page cover styling
-- ebf3b2b: Fix an issue where content refs to spaces outside of site was resolving with share links
-- 35efc9d: Fix TOCPageIcons backgrounds on gradient and bold themes
-- a7f58ab: Fix embed tab button size regression
-- 360b525: Switch icon masking method to fix visual cutoffs in FA7
-- Updated dependencies [985c1b4]
-- Updated dependencies [360b525]
-  - @gitbook/openapi-parser@3.0.7
-  - @gitbook/icons@0.4.2
-  - @gitbook/react-openapi@1.5.5
-  - @gitbook/react-contentkit@0.7.11
-
-## 0.21.1
-
-### Patch Changes
-
-- Updated dependencies [e7fb771]
-  - @gitbook/icons@0.4.1
-  - @gitbook/react-contentkit@0.7.10
-
-## 0.21.0
-
-### Minor Changes
-
-- 3553db0: Add a RSS feed to all pages with update blocks.
-
-### Patch Changes
-
-- f478ddc: Add Input component
-- 3817289: Fix overflowing section groups
-- 86e7aa6: Fix search results cursor
-- 1430cee: Improve Docs Embed with separate Assistant and Docs tabs
-- ed9e8fe: Add support for button actions
-- 9c69cc4: Add customizable suggested questions
-- c51076e: Fix links to other spaces and root page in embeddable view.
-- 6278a18: Support `greeting` and fix suggested questions if there are no custom ones defined
-- 04a4175: Remove hidden site spaces from navigation
-- 74f8931: Fix hidden section not found
-- 344842f: Improve OpenAPI circular references
-- Updated dependencies [4766092]
-- Updated dependencies [8761cee]
-- Updated dependencies [461e15f]
-- Updated dependencies [1430cee]
-- Updated dependencies [62438f4]
-- Updated dependencies [3e40b4d]
-- Updated dependencies [87d68ea]
-- Updated dependencies [344842f]
-  - @gitbook/react-openapi@1.5.4
-  - @gitbook/openapi-parser@3.0.6
-  - @gitbook/embed@0.2.0
-  - @gitbook/icons@0.4.0
-  - @gitbook/react-contentkit@0.7.9
-
-## 0.20.0
-
-### Minor Changes
-
-- 1d92dc1: Update site layout and blocks with container queries and better transitions
-
-### Patch Changes
-
-- 8fdc5c8: Fix webframe height issue
-- 9022d87: Add breadcrumbs to search results
-- 0c01832: SearchInput fixes — Translate Clear button, Bold theme color, "Esc" keyboard shortcut
-- 1d1f0a7: Fix search container shadow
-- 2aa4f2e: Update dropdown menu styling
-- a49781e: Printable collapsed code block
-- 7d6a316: Revert contentref anchor title
-- e27986b: Reword "Everywhere" search scope to "All docs"
-- 758b34d: Move the "Ask <query>" to the bottom of search results if query is not a question
-- 0ae7cfd: Improve AI Search branding
-- f9f8011: Add alt text support to card covers
-- ebbb476: Improve ancestor label in references
-- 1b0613e: Tweak language dropdown styling
-- 3355960: Fix ToggeableLinkItem display
-- c31e564: Fix icon resolution for page group
-- 55c0b03: Support translations and generic variants together
-- 3876f70: Edgeless Assistant window on `depth: flat` sites
-- 683bb8f: Add confirmation to "Copy MCP URL" page action
-- 4534ea8: Implement unique title tags for sections & variants
-- 6d56df7: Treat pages without visible TOC items as `no-toc`
-- 8606f22: Add padding to TOC page group items
-- 3676d64: Update search scope UI
-- c32d449: Fix OpenAPI path display
-- 8ce7322: Add OpenAPI servers selection
-- 2c3066e: Improve OAuth2 scopes handling in OpenAPI
-- 6b1c9fe: Fix opacity of ScrollContainer buttons on bold themes
-- Updated dependencies [b4a021a]
-- Updated dependencies [a512c90]
-- Updated dependencies [df1966d]
-- Updated dependencies [b45feaf]
-- Updated dependencies [10995e0]
-- Updated dependencies [f9f8011]
-- Updated dependencies [10995e0]
-- Updated dependencies [8ce7322]
-- Updated dependencies [2c3066e]
-  - @gitbook/react-openapi@1.5.3
-  - @gitbook/openapi-parser@3.0.5
-  - @gitbook/react-contentkit@0.7.8
-  - @gitbook/browser-types@0.1.3
-  - @gitbook/cache-tags@0.3.4
-  - @gitbook/react-math@0.6.4
-  - @gitbook/colors@0.4.3
-  - @gitbook/embed@0.1.5
-  - @gitbook/fonts@0.1.3
-  - @gitbook/icons@0.3.4
-  - @gitbook/expr@1.2.4
-
-## 0.19.2
-
-### Patch Changes
-
-- 6142d6b: Mark as sideEffects, fix all package bundles
-- 75543b1: Update minimum Node version in .npmrc
-- 511f1cf: Add scroll margin to Expandable
-- Updated dependencies [6142d6b]
-  - @gitbook/emoji-codepoints@0.2.2
-  - @gitbook/react-contentkit@0.7.7
-  - @gitbook/openapi-parser@3.0.4
-  - @gitbook/browser-types@0.1.2
-  - @gitbook/react-openapi@1.5.2
-  - @gitbook/cache-tags@0.3.3
-  - @gitbook/react-math@0.6.3
-  - @gitbook/colors@0.4.2
-  - @gitbook/fonts@0.1.2
-  - @gitbook/icons@0.3.3
-  - @gitbook/expr@1.2.3
-
-## 0.19.1
-
-### Patch Changes
-
-- 295f03d: Republish packages
-- Updated dependencies [bdde392]
-- Updated dependencies [295f03d]
-  - @gitbook/react-contentkit@0.7.6
-  - @gitbook/browser-types@0.1.1
-  - @gitbook/cache-tags@0.3.2
-  - @gitbook/colors@0.4.1
-  - @gitbook/emoji-codepoints@0.2.1
-  - @gitbook/expr@1.2.2
-  - @gitbook/fonts@0.1.1
-  - @gitbook/icons@0.3.2
-  - @gitbook/openapi-parser@3.0.3
-  - @gitbook/react-math@0.6.2
-  - @gitbook/react-openapi@1.5.1
-
-## 0.19.0
-
-### Minor Changes
-
-- ed7d47d: Show a toolbar for authenticated users with access to the current site.
-- 50c1be3: Move inline expression evaluation from API to GBO
-- 56e46ce: Add Italian translation
-- b932e4e: Scope search across sections and variants
-
-### Patch Changes
-
-- 162cfe4: Hide sections if only one is present
-- 1456251: Unify section display condition
-- 9344431: Fix missing geo data in site insights because of incorrect proxying of events.
-- eea8f1e: Enhance OpenAPI security scopes handling
-- 2b8a2d2: Add stable scroll gutter to search container
-- b498521: Fix robots.txt preventing favicon from being indexed.
-- ceb32b1: Redo search scope UI
-- 8e99871: Highlight discriminator properties in oneOf, allOf, anyOf objects
-- 2fc2127: Make search accessible
-- f3e4041: Adapt OpenAPI code samples to prefill API key using visitor data
-- 6815dd1: Fix markdownPageURL for PageActions
-- c06b3dd: Improve default site icon
-- cba583a: Use sitespace title instead of space title in search
-- e434442: Support nested site section groups
-- 469b332: Add support for inline expressions rendering with visitor data on GBO side
-- 0ef5dc8: Update to column width sizing
-- 1e4e54e: Fix rounded outline items
-- 379d486: Expose "Best match" when site has translations
-- c21693f: Improve screen reader accessibility for hints
-- badf3a9: Add alt text to inline image
-- c23d4ef: Fix crash for card cover defined without objectFit
-- d74f8a7: Improve wide page width layout
-- b8388e5: Add scrollcontainer component
-- b85eccd: Refactor section tabs
-- 1e53f46: Fix button content truncate
-- 7a504b7: Fix OpenAPI response dropdown & vertical overflow
-- a4c3399: Fix OpenAPI alternatives not showing
-- Updated dependencies [a629900]
-- Updated dependencies [eea8f1e]
-- Updated dependencies [8e99871]
-- Updated dependencies [f3e4041]
-- Updated dependencies [319a1e5]
-- Updated dependencies [529f940]
-- Updated dependencies [754cc11]
-- Updated dependencies [d7948e3]
-- Updated dependencies [a4c3399]
-  - @gitbook/expr@1.2.1
-  - @gitbook/react-openapi@1.5.0
-
 ## 0.18.0
 
 ### Minor Changes

packages/gitbook/e2e/cookie-banner.spec.ts

@@ -1,76 +0,0 @@
-import { expect } from '@playwright/test';
-
-import { type TestsCase, getCustomizationURL, runTestCases } from './util';
-
-const testCases: TestsCase[] = [
-    {
-        name: 'Cookie Banner',
-        contentBaseURL: 'https://gitbook.com/docs/',
-        tests: [
-            {
-                name: 'should show built-in banner when no custom banner is registered',
-                url: getCustomizationURL({
-                    privacyPolicy: {
-                        url: 'https://policies.gitbook.com/privacy/cookies',
-                    },
-                }),
-                screenshot: false,
-                run: async (page) => {
-                    // Check that built-in banner is visible
-                    const dialog = page.getByTestId('cookies-dialog');
-                    await expect(dialog).toBeVisible({ timeout: 5000 });
-                },
-            },
-            {
-                name: 'should not show built-in banner when UserAgent is AI',
-                url: getCustomizationURL({
-                    privacyPolicy: {
-                        url: 'https://policies.gitbook.com/privacy/cookies',
-                    },
-                }),
-                screenshot: false,
-                run: async (page) => {
-                    // Override navigator.userAgent to simulate AI crawler (affects isAIUserAgent())
-                    await page.addInitScript(() => {
-                        Object.defineProperty(navigator, 'userAgent', {
-                            get: () =>
-                                'Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; ChatGPT-User/1.0; +https://openai.com/bot',
-                            configurable: true,
-                        });
-                    });
-                    await page.reload();
-
-                    // Check that built-in banner is not visible for AI UserAgent
-                    const dialog = page.getByTestId('cookies-dialog');
-                    await expect(dialog).not.toBeVisible({ timeout: 5000 });
-                },
-            },
-            {
-                name: 'should not show built-in banner when custom banner is registered',
-                url: getCustomizationURL({
-                    privacyPolicy: {
-                        url: 'https://policies.gitbook.com/privacy/cookies',
-                    },
-                }),
-                screenshot: false,
-                run: async (page) => {
-                    // Register a custom cookie banner handler
-                    await page.waitForFunction(() => {
-                        return typeof window !== 'undefined' && window.GitBook !== undefined;
-                    });
-                    await page.evaluate(() => {
-                        window.GitBook?.registerCookieBanner(() => {
-                            // Custom cookie banner handler - no-op for testing to avoid reload
-                        });
-                    });
-
-                    // Check that built-in banner is not visible
-                    const dialog = page.getByTestId('cookies-dialog');
-                    await expect(dialog).not.toBeVisible({ timeout: 5000 });
-                },
-            },
-        ],
-    },
-];
-
-runTestCases(testCases);

packages/gitbook/e2e/customers.spec.ts

@@ -1,18 +1,5 @@
 import { type TestsCase, runTestCases, waitForCookiesDialog } from './util';
 
-const ONE_HOUR_IN_MS = 60 * 60 * 1000;
-
-const CLOSED_ONETRUST_COOKIE_BANNER = [
-    {
-        name: '__gitbook_cookie_granted',
-        value: 'no',
-    },
-    {
-        name: 'OptanonAlertBoxClosed',
-        value: new Date(Date.now() - ONE_HOUR_IN_MS).toISOString(),
-    },
-];
-
 /** A list of test cases to run on the customers' docs sites. */
 const testCases: TestsCase[] = [
     {
@@ -23,18 +10,18 @@ const testCases: TestsCase[] = [
             { name: 'OpenAPI', url: '/snyk-api/reference/apps', run: waitForCookiesDialog },
         ],
     },
-    {
-        name: 'Nexthink',
-        contentBaseURL: 'https://docs.nexthink.com',
-        tests: [
-            {
-                name: 'Home',
-                url: '/',
-                screenshot: { waitForTOCScrolling: false },
-                run: waitForCookiesDialog,
-            },
-        ],
-    },
+    // {
+    //     name: 'Nexthink',
+    //     contentBaseURL: 'https://docs.nexthink.com',
+    //     tests: [
+    //         {
+    //             name: 'Home',
+    //             url: '/',
+    //             screenshot: { waitForTOCScrolling: false },
+    //             run: waitForCookiesDialog,
+    //         },
+    //     ],
+    // },
     {
         name: 'asiksupport-stg.dto.kemkes.go.id',
         contentBaseURL: 'https://asiksupport-stg.dto.kemkes.go.id',
@@ -50,6 +37,11 @@ const testCases: TestsCase[] = [
         contentBaseURL: 'https://faq.deltaemulator.com',
         tests: [{ name: 'Home', url: '/' }],
     },
+    {
+        name: 'docs.dify.ai',
+        contentBaseURL: 'https://docs.dify.ai',
+        tests: [{ name: 'Home', url: '/', run: waitForCookiesDialog }],
+    },
     {
         name: 'seeddao.gitbook.io',
         contentBaseURL: 'https://seeddao.gitbook.io',
@@ -120,11 +112,11 @@ const testCases: TestsCase[] = [
         contentBaseURL: 'https://adiblar.gitbook.io',
         tests: [{ name: 'Home', url: '/' }],
     },
-    // {
-    //     name: 'docs.gradient.network',
-    //     contentBaseURL: 'https://docs.gradient.network',
-    //     tests: [{ name: 'Home', url: '/' }],
-    // },
+    {
+        name: 'docs.gradient.network',
+        contentBaseURL: 'https://docs.gradient.network',
+        tests: [{ name: 'Home', url: '/' }],
+    },
     // {
     //     name: 'mygate-network.gitbook.io',
     //     contentBaseURL: 'https://mygate-network.gitbook.io',
@@ -180,6 +172,11 @@ const testCases: TestsCase[] = [
         contentBaseURL: 'https://docs.realapp.link',
         tests: [{ name: 'Home', url: '/' }],
     },
+    {
+        name: 'docs.plaza.finance',
+        contentBaseURL: 'https://docs.plaza.finance',
+        tests: [{ name: 'Home', url: '/' }],
+    },
     {
         name: 'docs.publicai.io',
         contentBaseURL: 'https://docs.publicai.io',
@@ -245,12 +242,9 @@ const testCases: TestsCase[] = [
     {
         name: 'run-ai-docs.nvidia.com',
         contentBaseURL: 'https://run-ai-docs.nvidia.com',
+        skip: process.env.ARGOS_BUILD_NAME !== 'customers-v2',
         tests: [
-            {
-                name: 'Home',
-                url: '/',
-                cookies: CLOSED_ONETRUST_COOKIE_BANNER,
-            },
+            { name: 'Home', url: '/' },
             { name: 'OG Image', url: '/~gitbook/ogimage/h17zQIFwy3MaafVNmItO', mode: 'image' },
         ],
     },

packages/gitbook/e2e/pdf.spec.ts

@@ -29,7 +29,7 @@ test.describe('PDF export', () => {
         const printBtn = page.getByTestId('print-button');
         await expect(printBtn).toBeVisible();
 
-        await argosScreenshot(page, 'pdf - e2e - all pages', {
+        await argosScreenshot(page, 'pdf - all pages', {
             viewports: ['macbook-13'],
             argosCSS: `
                             /* Hide Intercom */
@@ -67,7 +67,7 @@ test.describe('PDF export', () => {
         const printBtn = page.getByTestId('print-button');
         await expect(printBtn).toBeVisible();
 
-        await argosScreenshot(page, 'pdf - gb-docs - all pages', {
+        await argosScreenshot(page, 'pdf - all pages', {
             viewports: ['macbook-13'],
             argosCSS: `
                             /* Hide Intercom */
@@ -109,7 +109,7 @@ test.describe('PDF export', () => {
         const printBtn = page.getByTestId('print-button');
         await expect(printBtn).toBeVisible();
 
-        await argosScreenshot(page, 'pdf - e2e - single-page', {
+        await argosScreenshot(page, 'pdf - all pages', {
             viewports: ['macbook-13'],
             argosCSS: `
                             /* Hide Intercom */
@@ -151,7 +151,7 @@ test.describe('PDF export', () => {
         const printBtn = page.getByTestId('print-button');
         await expect(printBtn).toBeVisible();
 
-        await argosScreenshot(page, 'pdf - gb-docs - single-page', {
+        await argosScreenshot(page, 'pdf - all pages', {
             viewports: ['macbook-13'],
             argosCSS: `
                             /* Hide Intercom */

packages/gitbook/e2e/util.ts

@@ -2,11 +2,9 @@ import { argosScreenshot } from '@argos-ci/playwright';
 import {
     CustomizationAIMode,
     CustomizationBackground,
-    CustomizationCodeTheme,
     CustomizationCorners,
     CustomizationDefaultFont,
     CustomizationDefaultMonospaceFont,
-    CustomizationDefaultThemeMode,
     CustomizationDepth,
     type CustomizationHeaderItem,
     CustomizationHeaderPreset,
@@ -17,6 +15,7 @@ import {
     CustomizationSidebarBackgroundStyle,
     CustomizationSidebarListStyle,
     CustomizationTheme,
+    CustomizationThemeMode,
     type CustomizationThemedColor,
     type SiteCustomizationSettings,
     SiteExternalLinksTarget,
@@ -84,9 +83,9 @@ export const allLocales: CustomizationLocale[] = [
     CustomizationLocale.Zh,
 ];
 
-export const allThemeModes: CustomizationDefaultThemeMode[] = [
-    CustomizationDefaultThemeMode.Light,
-    CustomizationDefaultThemeMode.Dark,
+export const allThemeModes: CustomizationThemeMode[] = [
+    CustomizationThemeMode.Light,
+    CustomizationThemeMode.Dark,
 ];
 
 export const allTintColors: Array<{
@@ -144,10 +143,7 @@ export const headerLinks: CustomizationHeaderItem[] = [
 
 export async function waitForCookiesDialog(page: Page) {
     const dialog = page.getByTestId('cookies-dialog');
-    await expect(dialog).toBeVisible({
-        // Cookies dialog may take some times to appear
-        timeout: 10_000,
-    });
+    await expect(dialog).toBeVisible();
 }
 
 export async function waitForNotFound(_page: Page, response: Response | null) {
@@ -155,23 +151,6 @@ export async function waitForNotFound(_page: Page, response: Response | null) {
     expect(response?.status()).toBe(404);
 }
 
-export async function setTimeToMorning(page: Page) {
-    const now = new Date();
-    now.setHours(8, 0, 0, 0); // 8:00:00.000 AM (local time)
-
-    await page.clock.install({ time: now });
-}
-
-export async function waitForCoverImages(page: Page, options?: { darkMode?: boolean }) {
-    const selector = options?.darkMode
-        ? 'img[alt="Page cover"].dark\\:inline'
-        : 'img[alt="Page cover"]:not(.dark\\:inline)';
-    // Wait for cover images to exist (not the shimmer placeholder)
-    await expect(page.locator(selector)).toBeVisible({
-        timeout: 10_000,
-    });
-}
-
 /**
  * Transform test cases into Playwright tests and run it.
  */
@@ -309,16 +288,6 @@ export function getCustomizationURL(partial: DeepPartial<SiteCustomizationSettin
             background: CustomizationBackground.Plain,
             icons: CustomizationIconsStyle.Regular,
             links: CustomizationLinksStyle.Default,
-            codeTheme: {
-                default: {
-                    light: CustomizationCodeTheme.DefaultLight,
-                    dark: CustomizationCodeTheme.DefaultDark,
-                },
-                openapi: {
-                    light: CustomizationCodeTheme.DefaultLight,
-                    dark: CustomizationCodeTheme.DefaultDark,
-                },
-            },
             sidebar: {
                 background: CustomizationSidebarBackgroundStyle.Default,
                 list: CustomizationSidebarListStyle.Default,
@@ -340,7 +309,7 @@ export function getCustomizationURL(partial: DeepPartial<SiteCustomizationSettin
             groups: [],
         },
         themes: {
-            default: CustomizationDefaultThemeMode.System,
+            default: CustomizationThemeMode.Light,
             toggeable: true,
         },
         pdf: {
@@ -376,7 +345,6 @@ export function getCustomizationURL(partial: DeepPartial<SiteCustomizationSettin
             url: 'https://www.gitbook.com/privacy',
         },
         socialPreview: {},
-        socialAccounts: [],
     };
 
     const encoded = rison.encode_object(deepMerge(DEFAULT_CUSTOMIZATION, partial));
@@ -439,15 +407,14 @@ export async function waitForIcons(page: Page) {
                 return true;
             }
 
-            const maskImage = icon.querySelector('[data-testid="mask-image"]');
-            if (!maskImage) {
-                throw new Error('No mask-image element');
-            }
+            // url("https://ka-p.fontawesome.com/releases/v6.6.0/svgs/light/moon.svg?v=2&token=a463935e93")
+            const maskImage = window.getComputedStyle(icon).getPropertyValue('mask-image');
+            const urlMatch = maskImage.match(/url\("([^"]+)"\)/);
+            const url = urlMatch?.[1];
 
-            const url = maskImage.getAttribute('href');
             // If URL is invalid we throw an error.
             if (!url) {
-                throw new Error('No mask-image url');
+                throw new Error('No mask-image');
             }
 
             // If the URL is already queued for loading, we return the state.
@@ -477,8 +444,7 @@ export async function waitForIcons(page: Page) {
  */
 async function waitForTOCScrolling(page: Page) {
     const viewport = await page.viewportSize();
-    if (viewport && viewport.width >= 1024 && !page.url().includes('~gitbook/embed/demo')) {
-        // The embed demo is an iframe, which means the viewport is only a fraction of the main document. So there is no open TOC to scroll to.
+    if (viewport && viewport.width >= 1024) {
         const toc = page.getByTestId('table-of-contents');
         await expect(toc).toBeVisible();
         await page.evaluate(() => {

packages/gitbook/next.config.mjs

@@ -4,7 +4,6 @@
  * @type {import('next').NextConfig}
  */
 const nextConfig = {
-    deploymentId: process.env.GITHUB_SHA || Date.now().toString(), // Needed because we use a custom deployment method i.e. https://vercel.com/docs/skew-protection#custom-deployment-id
     experimental: {
         // This is needed to throw "forbidden" when the api token expired during revalidation
         authInterrupts: true,
@@ -26,8 +25,6 @@ const nextConfig = {
         // GitBook envs
         GITBOOK_API_URL: process.env.GITBOOK_API_URL,
         GITBOOK_APP_URL: process.env.GITBOOK_APP_URL,
-        GITBOOK_OAUTH_SERVER_URL: process.env.GITBOOK_OAUTH_SERVER_URL,
-        GITBOOK_PREVIEW_BASE_URL: process.env.GITBOOK_PREVIEW_BASE_URL,
         GITBOOK_INTEGRATIONS_HOST: process.env.GITBOOK_INTEGRATIONS_HOST,
         GITBOOK_IMAGE_RESIZE_URL: process.env.GITBOOK_IMAGE_RESIZE_URL,
         GITBOOK_ICONS_URL: process.env.GITBOOK_ICONS_URL,

packages/gitbook/open-next.config.ts

@@ -7,8 +7,7 @@ export default {
             converter: 'edge',
             proxyExternalRequest: 'fetch',
             queue: () => import('./openNext/queue/middleware').then((m) => m.default),
-            incrementalCache: () =>
-                import('./openNext/incrementalCache/server').then((m) => m.default),
+            incrementalCache: () => import('./openNext/incrementalCache').then((m) => m.default),
             tagCache: () => import('./openNext/tagCache/middleware').then((m) => m.default),
         },
     },
@@ -19,8 +18,7 @@ export default {
             converter: 'edge',
             proxyExternalRequest: 'fetch',
             queue: () => import('./openNext/queue/middleware').then((m) => m.default),
-            incrementalCache: () =>
-                import('./openNext/incrementalCache/middleware').then((m) => m.default),
+            incrementalCache: () => import('./openNext/incrementalCache').then((m) => m.default),
             tagCache: () => import('./openNext/tagCache/middleware').then((m) => m.default),
         },
     },

packages/gitbook/openNext/customWorkers/defaultWrangler.jsonc

@@ -1,7 +1,6 @@
 {
     "main": "default.js",
     "name": "gitbook-open-v2-server",
-    "keep_names": false,
     "compatibility_date": "2025-04-14",
     "compatibility_flags": [
         "nodejs_compat",
@@ -9,7 +8,7 @@
         "global_fetch_strictly_public"
     ],
     "observability": {
-        "enabled": false
+        "enabled": true
     },
     "vars": {
         "NEXT_CACHE_DO_QUEUE_DISABLE_SQLITE": "true"

packages/gitbook/openNext/customWorkers/doWrangler.jsonc

@@ -2,14 +2,13 @@
     "main": "do.js",
     "name": "gitbook-open-v2-do",
     "compatibility_date": "2025-04-14",
-    "keep_names": false,
     "compatibility_flags": [
         "nodejs_compat",
         "allow_importable_env",
         "global_fetch_strictly_public"
     ],
     "observability": {
-        "enabled": false
+        "enabled": true
     },
     "env": {
         "preview": {

packages/gitbook/openNext/customWorkers/middlewareWrangler.jsonc

@@ -2,19 +2,18 @@
     "main": "middleware.js",
     "name": "gitbook-open-v2",
     "compatibility_date": "2025-04-14",
-    "keep_names": false,
     "compatibility_flags": [
         "nodejs_compat",
         "allow_importable_env",
         "global_fetch_strictly_public"
     ],
-    "observability": {
-        "enabled": false
-    },
     "assets": {
         "directory": "../../.open-next/assets",
         "binding": "ASSETS"
     },
+    "observability": {
+        "enabled": true
+    },
     "vars": {
         "NEXT_CACHE_DO_QUEUE_DISABLE_SQLITE": "true"
     },

packages/gitbook/openNext/incrementalCache.ts

@@ -7,6 +7,8 @@ import type {
 } from '@opennextjs/aws/types/overrides.js';
 import { getCloudflareContext } from '@opennextjs/cloudflare';
 
+import { withRegionalCache } from '@opennextjs/cloudflare/overrides/incremental-cache/regional-cache';
+
 import type { DurableObjectNamespace, Rpc } from '@cloudflare/workers-types';
 
 export const BINDING_NAME = 'NEXT_INC_CACHE_R2_BUCKET';
@@ -21,7 +23,7 @@ export type KeyOptions = {
  * It is very similar to the `R2IncrementalCache` in the `@opennextjs/cloudflare` package, but it has an additional
  * R2WriteBuffer Durable Object to handle writes to R2. Given how we set up cache, we often end up writing to the same key too fast.
  */
-export class GitbookIncrementalCache implements IncrementalCache {
+class GitbookIncrementalCache implements IncrementalCache {
     name = 'GitbookIncrementalCache';
 
     async get<CacheType extends CacheEntryType = 'cache'>(
@@ -135,3 +137,12 @@ export class GitbookIncrementalCache implements IncrementalCache {
         );
     }
 }
+
+export default withRegionalCache(new GitbookIncrementalCache(), {
+    mode: 'long-lived',
+    // We can do it because we use our own logic to invalidate the cache
+    bypassTagCacheOnCacheHit: true,
+    defaultLongLivedTtlSec: 60 * 60 * 24 /* 24 hours */,
+    // We don't want to update the cache entry on every cache hit
+    shouldLazilyUpdateOnCacheHit: false,
+});