Version Packages (#3724 )

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Fix bun token (#3727 )
2026-09-12 14:00:28 +00:00 · 2025-10-15 13:30:24 +02:00 · 2025-10-15 10:43:44 +02:00 · 2025-10-14 14:39:19 +02:00 · 2025-10-14 11:13:26 +01:00 · 2025-10-13 15:54:32 +02:00
300 changed files with 3925 additions and 8620 deletions
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Update button sizing
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix embed tab button size regression
@@ -1,6 +0,0 @@
---
-"gitbook": patch
-"@gitbook/icons": patch
---
-
-Switch icon masking method to fix visual cutoffs in FA7
@@ -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: >= 22.3)
+  - 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:

@@ -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

@@ -70,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

@@ -81,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

@@ -104,7 +104,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/middlewareWrangler.jsonc
        
@@ -4,7 +4,6 @@ on:
    push:
        branches:
            - main
-            - changeset-release/main
 env:
    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
@@ -6,7 +6,7 @@ on:
            - main

 env:
-    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
    
 concurrency: ${{ github.workflow }}-${{ github.ref }}

@@ -14,38 +14,28 @@ 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 }}
+                  CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+                  CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

@@ -25,7 +25,4 @@ yarn-error.log*

 # TypeScript
 *.tsbuildinfo
-.npmrc
-
-# Bun pack artifacts
-packages/*/*.tgz
+.npmrc
@@ -1,20 +1,15 @@
 {
    "name": "gitbook",
    "version": "0.1.0",
-    "engines": {
-        "node": "^22.3.0"
-    },
    "devDependencies": {
        "@biomejs/biome": "^1.9.4",
-        "@changesets/cli": "^2.29.8",
-        "turbo": "^2.6.3",
+        "@changesets/cli": "^2.29.7",
+        "turbo": "^2.5.8",
        "vercel": "^39.4.2"
    },
-    "packageManager": "bun@1.3.2",
+    "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"
@@ -32,28 +27,24 @@
        "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",
+        "release": "turbo run release && bun run publish-all-packages",
+        "publish-all-packages": "for dir in packages/*; do (cd \"$dir\" && bun publish || true); done && changeset tag",
        "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.155.0",
-            "@scalar/api-client-react": "^1.3.46",
-            "@types/react": "^19.0.0",
-            "@types/react-dom": "^19.0.0",
+            "@gitbook/api": "0.143.2",
            "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",
+            "react": "^19.0.0",
+            "react-dom": "^19.0.0",
            "tsdown": "^0.15.6",
            "typescript": "^5.5.3",
-            "usehooks-ts": "^3.1.1"
+            "usehooks-ts": "^3.1.0"
        }
    },
    "patchedDependencies": {
@@ -1,13 +1,5 @@
 # @gitbook/browser-types

-## 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
@@ -9,28 +9,23 @@
        }
    },
    "sideEffects": false,
-    "version": "0.1.3",
+    "version": "0.1.2",
    "dependencies": {
        "@gitbook/api": "catalog:",
        "@gitbook/icons": "workspace:"
    },
    "devDependencies": {
-        "bun-types": "catalog:",
        "tsdown": "catalog:",
        "typescript": "catalog:"
    },
    "scripts": {
        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "dev": "bun run build -- --watch ./src"
    },
    "files": ["dist", "README.md", "CHANGELOG.md"],
    "publishConfig": {
        "access": "public",
        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
    }
 }
@@ -1,11 +1,5 @@
 # @gitbook/cache-tags

-## 0.3.4
-
-### Patch Changes
-
- 10995e0: Use NPM Trusted publishing for publishing the package.
-
 ## 0.3.3

 ### Patch Changes
@@ -8,28 +8,23 @@
        }
    },
    "sideEffects": false,
-    "version": "0.3.4",
+    "version": "0.3.3",
    "dependencies": {
        "@gitbook/api": "catalog:",
        "assert-never": "catalog:"
    },
    "devDependencies": {
-        "bun-types": "catalog:",
        "tsdown": "catalog:",
        "typescript": "catalog:"
    },
    "scripts": {
        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "dev": "bun run build -- --watch ./src"
    },
    "files": ["dist", "README.md", "CHANGELOG.md"],
    "publishConfig": {
        "access": "public",
        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
    }
 }
@@ -1,11 +1,5 @@
 # @gitbook/colors

-## 0.4.3
-
-### Patch Changes
-
- 10995e0: Use NPM Trusted publishing for publishing the package.
-
 ## 0.4.2

 ### Patch Changes
@@ -8,24 +8,19 @@
        }
    },
    "sideEffects": false,
-    "version": "0.4.3",
+    "version": "0.4.2",
    "devDependencies": {
-        "bun-types": "catalog:",
        "tsdown": "catalog:",
        "typescript": "catalog:"
    },
    "scripts": {
        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "dev": "bun run build -- --watch ./src"
    },
    "files": ["dist", "README.md", "CHANGELOG.md"],
    "publishConfig": {
        "access": "public",
        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
    }
 }
@@ -1,24 +1,5 @@
 # @gitbook/embed

-## 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
@@ -1,61 +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?' },
-    suggestions: ['What is GitBook?', 'How do I get started?'],
-    tools: [/* ... */]
-});
-```
-
-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:
@@ -67,46 +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?' },
-    suggestions: ['What is GitBook?', 'How do I get started?'],
-    tools: [/* ... */]
-});
-
-// Listen to events
-frame.on('close', () => {
-    console.log('Frame closed');
-});
 ```

 ## As React components
@@ -114,298 +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?' }}
-        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={[/* ... */]}
-    />
+    <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')[]`
- **Options**:
-  - `['assistant', 'docs']` - Show both tabs
-  - `['assistant']` - Show only the assistant tab
-  - `['docs']` - Show only the docs tab
-
-```javascript
-tabs: ['assistant', 'docs']
-```
-
-### `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?'
-}
-```
-
-### `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'
-}
-```
@@ -13,7 +13,7 @@
        }
    },
    "sideEffects": false,
-    "version": "0.2.0",
+    "version": "0.1.4",
    "dependencies": {
        "@gitbook/api": "catalog:",
        "@gitbook/icons": "workspace:",
@@ -23,7 +23,6 @@
        "react": "*"
    },
    "devDependencies": {
-        "@types/react": "catalog:",
        "tsdown": "catalog:",
        "typescript": "catalog:",
        "react": "catalog:"
@@ -34,15 +33,11 @@
        "build-standalone": "bun build src/standalone/index.ts --bundle --minify --outdir=standalone",
        "clean": "rm -rf ./dist",
        "typecheck": "tsc --noEmit",
-        "dev": "bun run build -- --watch ./src",
-        "publish-to-npm": "../../scripts/publish-if-new.sh"
+        "dev": "bun run build -- --watch ./src"
    },
    "files": ["dist", "README.md", "CHANGELOG.md"],
    "publishConfig": {
        "access": "public",
        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
    }
 }
@@ -40,7 +40,7 @@ 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('token', frameOptions.visitor.token);
@@ -64,9 +64,8 @@ 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: [],
    };
@@ -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,26 +41,16 @@ 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;
-    };
+    welcomeMessage: string;

    /** Suggestions of questions to be displayed in the welcome page. */
    suggestions: string[];
@@ -17,7 +17,7 @@ export type GitBookFrameProps = {
 * Render a frame with the GitBook Assistant in it.
 */
 export function GitBookFrame(props: GitBookFrameProps) {
-    const { className, visitor, actions, greeting, suggestions, tools } = props;
+    const { className, visitor, buttons, welcomeMessage, suggestions, tools } = props;

    const frameRef = useRef<HTMLIFrameElement>(null);
    const gitbook = useGitBook();
@@ -33,13 +33,12 @@ export function GitBookFrame(props: GitBookFrameProps) {

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

    return (
        <iframe
@@ -31,50 +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 frameConfiguration: GitBookEmbeddableConfiguration & StandaloneConfiguration = {
-    button: {
-        label: 'Ask',
-        icon: 'assistant',
-    },
-    actions: [],
-    greeting: { title: '', subtitle: '' },
-    suggestions: [],
-    tools: [],
-    tabs: ['assistant', 'docs'],
-};
-
 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');
@@ -84,6 +58,17 @@ widgetWindow.classList.add('hidden');
 document.body.appendChild(widgetButton);
 document.body.appendChild(widgetWindow);

+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) {
        throw new Error(
@@ -150,31 +135,27 @@ const GitBook = (...args: StandaloneCalls) => {
        case 'postUserMessage':
            getIframe().frame.postUserMessage(args[1]);
            break;
-        case 'configure': {
-            const settings = args[1];
+        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);
-                }
-            }
-
            getIframe().frame.configure({
                ...frameConfiguration,
+                buttons: [
+                    ...frameConfiguration.buttons,
+
+                    // Always include a close button
+                    {
+                        icon: 'close',
+                        label: 'Close',
+                        onClick: () => {
+                            GitBook('close');
+                        },
+                    },
+                ],
            });
            break;
-        }
        case 'clearChat':
            getIframe().frame.clearChat();
            break;
@@ -29,16 +29,6 @@
    --gitbook-widget-easing-bounce: cubic-bezier(0.34, 1.56, 0.64, 1);
 }

-@media (prefers-color-scheme: dark) {
-    :root {
-        --gitbook-widget-text-color: #FFFFFF;
-        --gitbook-widget-border-color: #202020;
-        --gitbook-widget-background-translucent: rgba(15, 15, 15, 0.9);
-        --gitbook-widget-background-translucent-hover: rgba(20, 20, 20, 0.9);
-        --gitbook-widget-background-solid: #f0f0f0;
-    }
-}
-
 * {
    box-sizing: border-box;
 }
@@ -113,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');
 }
@@ -142,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);
@@ -1,12 +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
@@ -1,7 +1,7 @@
 {
    "name": "@gitbook/expr",
    "description": "Safely evaluate & parse user-defined GitBook expressions.",
-    "version": "1.2.4",
+    "version": "1.2.3",
    "type": "module",
    "exports": {
        ".": {
@@ -16,32 +16,25 @@
        "acorn-walk": "^8.3.4",
        "assert-never": "catalog:",
        "escodegen": "^2.1.0",
-        "eval-estree-expression": "github:jonschlinkert/eval-estree-expression#fb0246a"
+        "eval-estree-expression": "github:jonschlinkert/eval-estree-expression#9cf28d2"
    },
    "devDependencies": {
-        "@tsconfig/strictest": "catalog:",
-        "@tsconfig/node20": "catalog:",
        "@types/escodegen": "^0.0.10",
        "@types/estree": "^1.0.6",
        "@types/json-schema": "^7.0.15",
        "bun-types": "catalog:",
-        "tsdown": "catalog:",
-        "typescript": "catalog:"
+        "tsdown": "catalog:"
    },
    "scripts": {
        "build": "tsdown",
        "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 ./src"
    },
    "files": ["dist", "README.md", "CHANGELOG.md"],
    "publishConfig": {
        "access": "public",
        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
    }
 }
@@ -1,11 +1,5 @@
 # @gitbook/fonts

-## 0.1.3
-
-### Patch Changes
-
- 10995e0: Use NPM Trusted publishing for publishing the package.
-
 ## 0.1.2

 ### Patch Changes
@@ -8,12 +8,11 @@
        }
    },
    "sideEffects": false,
-    "version": "0.1.3",
+    "version": "0.1.2",
    "dependencies": {
        "@gitbook/api": "catalog:"
    },
    "devDependencies": {
-        "bun-types": "catalog:",
        "google-font-metadata": "^6.0.7",
        "tsdown": "catalog:",
        "typescript": "catalog:"
@@ -24,8 +23,7 @@
        "typecheck": "tsc --noEmit",
        "dev": "bun run build -- --watch ./src",
        "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"],
    "engines": {
@@ -34,8 +32,5 @@
    "publishConfig": {
        "access": "public",
        "registry": "https://registry.npmjs.org/"
-    },
-    "repository": {
-        "url": "https://github.com/GitbookIO/gitbook"
    }
 }
@@ -1,101 +1,5 @@
 # gitbook

-## 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
@@ -112,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',
@@ -172,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',
@@ -33,35 +33,9 @@ import {
    headerLinks,
    runTestCases,
    waitForCookiesDialog,
-    waitForCoverImages,
    waitForNotFound,
 } from './util';

-const AI_PROMPT = `You're being invoked by the GitBook CI/CD pipeline. To make screenshot testing of the GitBook Assistant visually consistent, look up the title of the first page you find and respond with only EXACTLY its title. To find the page title, invoke the search tool with the query "GitBook". Before invoking the search tool, respond with the exact text: "I'm going to look up 'GitBook' and then respond with only the page title.". Do not execute any other tools or output any other text.`;
-
-const overrideAIInitialState = () => {
-    const greeting = document.querySelector('[data-testid="ai-chat-time-greeting"]');
-    if (greeting) {
-        greeting.textContent = 'Good morning';
-    }
-};
-const overrideAIResponse = () => {
-    const userMessage = document.querySelector('[data-testid="ai-chat-message-user"]');
-    if (userMessage) {
-        userMessage.textContent = '[Replaced message] Chat message sent by the user';
-    }
-    const assistantMessage = document.querySelectorAll(
-        '[data-testid="ai-chat-message-assistant"] .ai-response-document'
-    );
-    assistantMessage.forEach((message) => {
-        message.innerHTML = '[Replaced message] AI chat response';
-    });
-    const suggestions = document.querySelectorAll('[data-testid="ai-chat-followup-suggestion"]');
-    suggestions.forEach((suggestion) => {
-        suggestion.textContent = 'Follow-up suggestion';
-    });
-};
-
 const searchTestCases: Test[] = [
    {
        name: 'Search - AI Mode: None - Complete flow',
@@ -78,9 +52,7 @@ const searchTestCases: Test[] = [

            // Fill search input, expecting search results
            await searchInput.fill('gitbook');
-            await expect(page.getByTestId('search-results')).toBeVisible({
-                timeout: 10_000,
-            });
+            await expect(page.getByTestId('search-results')).toBeVisible();
            const pageResults = await page.getByTestId('search-page-result').all();
            await expect(pageResults.length).toBeGreaterThanOrEqual(1);
            const pageSectionResults = await page.getByTestId('search-page-section-result').all();
@@ -125,6 +97,9 @@ const searchTestCases: Test[] = [
            await expect(page.getByTestId('search-results')).toBeVisible();
        },
    },
+    // TODO: Re-enable the following tests when we have fixed the AI Search timing out:
+    // - Search - AI Mode: Search - Complete flow
+    // - Search - AI Mode: Search - URL query (Initial)
    {
        name: 'Search - AI Mode: Search - URL query (Results)',
        url: `${getCustomizationURL({
@@ -132,12 +107,16 @@ const searchTestCases: Test[] = [
                mode: CustomizationAIMode.Search,
            },
        })}&q=gitbook`,
+        screenshot: false,
        run: async (page) => {
            await expect(page.getByTestId('search-input')).toBeFocused();
            await expect(page.getByTestId('search-input')).toHaveValue('gitbook');
            await expect(page.getByTestId('search-results')).toBeVisible();
        },
    },
+    // TODO: Re-enable the following tests when we have fixed the AI Search timing out:
+    // - Ask - AI Mode: Search - URL query (Ask initial)
+    // - Ask - AI Mode: Search - URL query (Ask results)
    {
        name: 'Ask - AI Mode: Assistant - Complete flow',
        url: getCustomizationURL({
@@ -145,32 +124,25 @@ const searchTestCases: Test[] = [
                mode: CustomizationAIMode.Assistant,
            },
        }),
+        screenshot: false,
        run: async (page) => {
            const searchInput = page.locator('css=[data-testid="search-input"]');

            // Focus search input, expecting recommended questions
            await searchInput.focus();
-            await expect(page.getByTestId('search-results')).toBeVisible({
-                timeout: 30_000,
-            });
-            const recommendedQuestions = await page
-                .getByTestId('search-recommended-question')
-                .all();
-            await expect(recommendedQuestions.length).toBeGreaterThan(2); // Expect at least 3 questions
+            // TODO: Re-enable this part of the test when we have fixed the AI Search timing out
+            // await expect(page.getByTestId('search-results')).toBeVisible();
+            // const recommendedQuestions = await page
+            //     .getByTestId('search-recommended-question')
+            //     .all();
+            // await expect(recommendedQuestions.length).toBeGreaterThan(2); // Expect at least 3 questions

            // Fill search input, expecting AI search option
-            await searchInput.fill(AI_PROMPT);
+            await searchInput.fill('What is gitbook?');
            const aiSearchResult = page.getByTestId('search-ask-question');
            await expect(aiSearchResult).toBeVisible();
            await aiSearchResult.click();
            await expect(page.getByTestId('ai-chat')).toBeVisible();
-            await expect(page.getByTestId('ai-chat-message-user').first()).toHaveText(AI_PROMPT);
-            await expect(page.getByTestId('ai-chat-message-assistant').first()).toBeVisible();
-            await expect(page.getByTestId('ai-chat-followup-suggestion')).toHaveCount(3, {
-                timeout: 60_000,
-            });
-            // Override text content for visual consistency in screenshots
-            await page.evaluate(overrideAIResponse);
        },
    },
    {
@@ -180,12 +152,11 @@ const searchTestCases: Test[] = [
                mode: CustomizationAIMode.Assistant,
            },
        }),
+        screenshot: false,
        run: async (page) => {
            await page.keyboard.press('ControlOrMeta+I');
            await expect(page.getByTestId('ai-chat')).toBeVisible();
            await expect(page.getByTestId('ai-chat-input')).toBeFocused();
-            // Override text content for visual consistency in screenshots
-            await page.evaluate(overrideAIInitialState);
        },
    },
    {
@@ -200,8 +171,6 @@ const searchTestCases: Test[] = [
            await page.getByTestId('ai-chat-button').click();
            await expect(page.getByTestId('ai-chat')).toBeVisible();
            await expect(page.getByTestId('ai-chat-input')).toBeFocused();
-            // Override text content for visual consistency in screenshots
-            await page.evaluate(overrideAIInitialState);
        },
    },
    {
@@ -211,13 +180,12 @@ const searchTestCases: Test[] = [
                mode: CustomizationAIMode.Assistant,
            },
        })}&ask=`,
+        screenshot: false,
        run: async (page) => {
            await expect(page.getByTestId('search-input')).not.toBeFocused();
-            await expect(page.getByTestId('search-input')).toBeEmpty();
+            await expect(page.getByTestId('search-input')).not.toHaveValue('What is GitBook?');
            await expect(page.getByTestId('ai-chat')).toBeVisible();
            await expect(page.getByTestId('ai-chat-input')).toBeFocused();
-            // Override text content for visual consistency in screenshots
-            await page.evaluate(overrideAIInitialState);
        },
    },
    {
@@ -226,18 +194,17 @@ const searchTestCases: Test[] = [
            ai: {
                mode: CustomizationAIMode.Assistant,
            },
-        })}&ask=${encodeURIComponent(AI_PROMPT)}`,
+        })}&ask=What+is+GitBook%3F`,
+        screenshot: false,
        run: async (page) => {
            await expect(page.getByTestId('search-input')).not.toBeFocused();
            await expect(page.getByTestId('search-input')).not.toHaveValue('What is GitBook?');
-            await expect(page.getByTestId('ai-chat')).toBeVisible();
-            await expect(page.getByTestId('ai-chat-message-user').first()).toHaveText(AI_PROMPT);
-            await expect(page.getByTestId('ai-chat-message-assistant').first()).toBeVisible();
-            await expect(page.getByTestId('ai-chat-followup-suggestion')).toHaveCount(3, {
-                timeout: 60_000,
+            await expect(page.getByTestId('ai-chat')).toBeVisible({
+                timeout: 15_000,
            });
-            // Override text content for visual consistency in screenshots
-            await page.evaluate(overrideAIResponse);
+            await expect(page.getByTestId('ai-chat-message').first()).toHaveText(
+                'What is GitBook?'
+            );
        },
    },
 ];
@@ -261,58 +228,6 @@ const testCases: TestsCase[] = [
                    );
                },
            },
-            {
-                name: 'Expandable TOC navigation',
-                url: '',
-                run: async (page) => {
-                    await waitForCookiesDialog(page);
-
-                    // Verify "Navigation" link is not visible initially
-                    const navigationLink = page.getByRole('link', { name: 'Navigation' });
-                    await expect(navigationLink).not.toBeVisible();
-
-                    // Find and click the chevron element that is next to "Editor" in the TOC
-                    // It is a span inside the link
-                    const editorChevron = page
-                        .getByRole('link', { name: 'Editor' })
-                        .locator('span');
-                    await editorChevron.click();
-
-                    // Verify "Navigation" link becomes visible after expansion
-                    await expect(navigationLink).toBeVisible();
-                },
-            },
-            {
-                name: 'Expandable nested TOC navigation',
-                url: '',
-                screenshot: false,
-                run: async (page) => {
-                    await waitForCookiesDialog(page);
-
-                    // Verify "Spaces" link is not visible initially
-                    const navigationLink = page.getByRole('link', { name: 'Spaces' });
-                    await expect(navigationLink).not.toBeVisible();
-
-                    // Find and click the chevron element that is next to "Editor" in the TOC
-                    // It is a span inside the link
-                    const editorChevron = page
-                        .getByRole('link', { name: 'Editor' })
-                        .locator('span');
-                    await editorChevron.click();
-
-                    // At this stage the link should still not be visible
-                    await expect(navigationLink).not.toBeVisible();
-
-                    // Then we click 'Content Structure' chevron to expand further
-                    const contentStructureChevron = page
-                        .getByRole('link', { name: 'Content Structure' })
-                        .locator('span');
-                    await contentStructureChevron.click();
-
-                    // Verify "Spaces" link becomes visible after expansion
-                    await expect(navigationLink).toBeVisible();
-                },
-            },
            ...searchTestCases,
            {
                name: 'Not found',
@@ -370,37 +285,6 @@ const testCases: TestsCase[] = [
                    ).toBeVisible();
                },
            },
-            {
-                name: 'Switch variant with alternate link in metadata',
-                url: 'rfcs',
-                run: async (page) => {
-                    const spaceDropdown = page
-                        .locator('[data-testid="space-dropdown-button"]')
-                        .locator('visible=true');
-                    await spaceDropdown.click();
-
-                    const variantSelectionDropdown = page.locator(
-                        'css=[data-testid="dropdown-menu"]'
-                    );
-
-                    // Click the variant space called 'Multi-Variants' for which
-                    // there is an alternate link in the current (RFC variant) page metadata
-                    await variantSelectionDropdown
-                        .getByRole('menuitem', {
-                            name: 'Multi-Variants',
-                        })
-                        .click();
-
-                    // It should navigate to the alternate link defined in the metadata (a completely different page)
-                    await page.waitForURL((url) =>
-                        url.pathname.includes('multi-variants/reference/api-reference/pets')
-                    );
-                    // Verify we are on the correct page by checking the h1
-                    await expect(
-                        page.getByRole('heading', { level: 1, name: 'Pets' })
-                    ).toBeVisible();
-                },
-            },
        ],
    },
    {
@@ -843,10 +727,7 @@ const testCases: TestsCase[] = [
                url: 'blocks/integrations',
                run: async (page) => {
                    await waitForCookiesDialog(page);
-                    const mermaidIframe = page
-                        .locator('iframe[title*="mermaid"]')
-                        .first()
-                        .contentFrame();
+                    const mermaidIframe = page.locator('iframe[title*="mermaid"]').contentFrame();
                    await expect(mermaidIframe.getByText('Mermaid', { exact: true })).toBeVisible();
                    await expect(mermaidIframe.getByText('Diagram', { exact: true })).toBeVisible();
                },
@@ -912,11 +793,6 @@ const testCases: TestsCase[] = [
                url: 'blocks/cards',
                fullPage: true,
            },
-            {
-                name: 'Updates',
-                url: 'blocks/updates',
-                fullPage: true,
-            },
            {
                name: 'Math',
                url: 'blocks/math',
@@ -975,10 +851,7 @@ const testCases: TestsCase[] = [
            {
                name: 'With cover',
                url: 'page-options/page-with-cover',
-                run: async (page) => {
-                    await waitForCookiesDialog(page);
-                    await waitForCoverImages(page);
-                },
+                run: waitForCookiesDialog,
            },
            {
                name: 'With cover for dark mode',
@@ -993,18 +866,12 @@ const testCases: TestsCase[] = [
            {
                name: 'With hero cover',
                url: 'page-options/page-with-hero-cover',
-                run: async (page) => {
-                    await waitForCookiesDialog(page);
-                    await waitForCoverImages(page);
-                },
+                run: waitForCookiesDialog,
            },
            {
                name: 'With cover and no TOC',
                url: 'page-options/page-with-cover-and-no-toc',
-                run: async (page) => {
-                    await waitForCookiesDialog(page);
-                    await waitForCoverImages(page);
-                },
+                run: waitForCookiesDialog,
                screenshot: {
                    waitForTOCScrolling: false,
                },
@@ -1291,7 +1158,7 @@ const testCases: TestsCase[] = [
                name: 'Redirect to Quickstart page',
                url: 'sections-2/redirect-test',
                run: async (page) => {
-                    await expect(page.locator('h1')).toContainText('Quickstart');
+                    await expect(page.locator('h1')).toHaveText('Quickstart');
                },
                screenshot: false,
            },
@@ -1587,7 +1454,10 @@ const testCases: TestsCase[] = [
                    locale,
                },
            }),
-            run: waitForCookiesDialog,
+            run: async (page) => {
+                const dialog = page.getByTestId('cookies-dialog');
+                await expect(dialog).toBeVisible();
+            },
        })),
    },
    {
@@ -143,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) {
@@ -154,13 +151,6 @@ export async function waitForNotFound(_page: Page, response: Response | null) {
    expect(response?.status()).toBe(404);
 }

-export async function waitForCoverImages(page: Page) {
-    // Wait for cover images to exist (not the shimmer placeholder)
-    await expect(page.locator('img[alt="Page cover"]').first()).toBeVisible({
-        timeout: 10_000,
-    });
-}
-
 /**
 * Transform test cases into Playwright tests and run it.
 */
@@ -417,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.
@@ -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),
        },
    },
@@ -1,13 +1,15 @@
 {
    "main": "default.js",
    "name": "gitbook-open-v2-server",
-    "keep_names": false,
    "compatibility_date": "2025-04-14",
    "compatibility_flags": [
        "nodejs_compat",
        "allow_importable_env",
        "global_fetch_strictly_public"
    ],
+    "observability": {
+        "enabled": true
+    },
    "vars": {
        "NEXT_CACHE_DO_QUEUE_DISABLE_SQLITE": "true"
    },
@@ -2,12 +2,14 @@
    "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": true
+    },
    "env": {
        "preview": {
            "vars": {
@@ -2,7 +2,6 @@
    "main": "middleware.js",
    "name": "gitbook-open-v2",
    "compatibility_date": "2025-04-14",
-    "keep_names": false,
    "compatibility_flags": [
        "nodejs_compat",
        "allow_importable_env",
@@ -12,6 +11,9 @@
        "directory": "../../.open-next/assets",
        "binding": "ASSETS"
    },
+    "observability": {
+        "enabled": true
+    },
    "vars": {
        "NEXT_CACHE_DO_QUEUE_DISABLE_SQLITE": "true"
    },
@@ -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,
+});
@@ -1,11 +0,0 @@
-import { withRegionalCache } from '@opennextjs/cloudflare/overrides/incremental-cache/regional-cache';
-import { GitbookIncrementalCache } from './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,
-});
@@ -1,12 +0,0 @@
-import { withRegionalCache } from '@opennextjs/cloudflare/overrides/incremental-cache/regional-cache';
-import { GitbookIncrementalCache } from './incrementalCache';
-
-export default withRegionalCache(new GitbookIncrementalCache(), {
-    mode: 'long-lived',
-    // Because of a race condition, the middleware may have populated the cache entry before `cache.match` had time to run on the server.
-    // TODO: We should bypass the incremental cache entirely when the interceptor has caught the request. Should be done in OpenNext.
-    bypassTagCacheOnCacheHit: false,
-    defaultLongLivedTtlSec: 60 * 60 * 24 /* 24 hours */,
-    // We don't want to update the cache entry on every cache hit
-    shouldLazilyUpdateOnCacheHit: false,
-});
@@ -1,14 +1,12 @@
 {
    "name": "gitbook",
-    "version": "0.21.1",
+    "version": "0.19.2",
    "private": true,
    "dependencies": {
-        "@cloudflare/workers-types": "^4.20251011.0",
        "@gitbook/api": "catalog:",
        "@gitbook/browser-types": "workspace:*",
        "@gitbook/cache-tags": "workspace:*",
        "@gitbook/colors": "workspace:*",
-        "@gitbook/embed": "workspace:*",
        "@gitbook/emoji-codepoints": "workspace:*",
        "@gitbook/expr": "workspace:*",
        "@gitbook/fonts": "workspace:*",
@@ -17,9 +15,8 @@
        "@gitbook/react-contentkit": "workspace:*",
        "@gitbook/react-math": "workspace:*",
        "@gitbook/react-openapi": "workspace:*",
-        "@modelcontextprotocol/sdk": "1.17.5",
-        "@opennextjs/aws": "^3.8.5",
-        "@opennextjs/cloudflare": "^1.14.4",
+        "@modelcontextprotocol/sdk": "^1.17.5",
+        "@opennextjs/cloudflare": "^1.9.2",
        "@radix-ui/react-checkbox": "^1.0.4",
        "@radix-ui/react-dropdown-menu": "^2.1.12",
        "@radix-ui/react-hover-card": "^1.1.15",
@@ -36,11 +33,12 @@
        "classnames": "catalog:",
        "direction": "^2.0.1",
        "event-iterator": "^2.0.0",
-        "feed": "^5.1.0",
+        "framer-motion": "^10.16.14",
        "image-size": "^2.0.2",
        "js-cookie": "^3.0.5",
        "jsontoxml": "^1.0.1",
        "jwt-decode": "^4.0.0",
+        "mathjax": "^3.2.2",
        "mcp-handler": "^1.0.2",
        "mdast-util-from-markdown": "^2.0.2",
        "mdast-util-frontmatter": "^2.0.1",
@@ -49,8 +47,8 @@
        "memoizee": "^0.4.17",
        "micromark-extension-frontmatter": "^2.0.0",
        "micromark-extension-gfm": "^3.0.0",
-        "motion": "^12.23.24",
-        "next": "15.4.10",
+        "motion": "^12.23.12",
+        "next": "15.4.0",
        "next-themes": "^0.4.6",
        "nuqs": "^2.2.3",
        "object-hash": "^3.0.0",
@@ -58,8 +56,6 @@
        "openapi-types": "^12.1.3",
        "p-map": "^7.0.3",
        "quick-lru": "^7.0.1",
-        "react": "catalog:",
-        "react-dom": "catalog:",
        "react-hotkeys-hook": "^4.4.1",
        "rehype-sanitize": "^6.0.0",
        "rehype-stringify": "^10.0.1",
@@ -83,7 +79,6 @@
    "devDependencies": {
        "@argos-ci/playwright": "^5.0.9",
        "@playwright/test": "^1.54.2",
-        "@scalar/api-client-react": "catalog:",
        "@tailwindcss/postcss": "^4.1.11",
        "@types/js-cookie": "^3.0.6",
        "@types/jsontoxml": "^1.0.5",
@@ -92,8 +87,8 @@
        "@types/node": "^20",
        "@types/object-hash": "^3.0.6",
        "@types/parse-cache-control": "^1.0.4",
-        "@types/react": "catalog:",
-        "@types/react-dom": "catalog:",
+        "@types/react": "18.3.13",
+        "@types/react-dom": "18.3.1",
        "@types/rison": "^0.0.9",
        "bun-types": "catalog:",
        "deepmerge": "^4.3.1",
@@ -104,9 +99,7 @@
        "tailwindcss": "^4.1.11",
        "ts-essentials": "^10.0.1",
        "typescript": "catalog:",
-        "vercel": "^39.3.0",
-        "wrangler": "^4.43.0",
-        "rss-parser": "^3.13.0"
+        "vercel": "^39.3.0"
    },
    "scripts": {
        "generate": "./scripts/generate.sh",
@@ -16,7 +16,7 @@ export default async function Page(props: PageProps) {
    const { context } = await getDynamicSiteContext(params);
    const pathname = getPagePathFromParams(params);

-    return <SitePage context={context} pageParams={{ pathname }} staticRoute={false} />;
+    return <SitePage context={context} pageParams={{ pathname }} />;
 }

 export async function generateViewport(props: PageProps): Promise<Viewport> {
@@ -22,11 +22,7 @@ export default async function SiteDynamicLayout({
    const withTracking = shouldTrackEvents(await headers());

    return (
-        <CustomizationRootLayout
-            className="site-background"
-            forcedTheme={forcedTheme}
-            context={context}
-        >
+        <CustomizationRootLayout forcedTheme={forcedTheme} context={context}>
            <SiteLayout
                context={context}
                forcedTheme={forcedTheme}
@@ -1,28 +1,16 @@
 import type { RouteLayoutParams } from '@/app/utils';
 import { EmbeddableAssistantPage } from '@/components/Embeddable';
 import { getEmbeddableDynamicContext } from '@/lib/embeddable';
-import { CustomizationAIMode } from '@gitbook/api';
-import { redirect } from 'next/navigation';
+
+export const dynamic = 'force-static';

 type PageProps = {
    params: Promise<RouteLayoutParams>;
 };

-export const dynamic = 'force-static';
-
 export default async function Page(props: PageProps) {
    const params = await props.params;
    const { context } = await getEmbeddableDynamicContext(params);

-    // If the assistant is not enabled, redirect to the docs
-    if (context.customization.ai.mode !== CustomizationAIMode.Assistant) {
-        redirect(`${context.linker.toPathInSite('~gitbook/embed/page/')}`);
-    }
-
-    return (
-        <EmbeddableAssistantPage
-            baseURL={context.linker.toPathInSite('~gitbook/embed/')}
-            siteTitle={context.site.title}
-        />
-    );
+    return <EmbeddableAssistantPage context={context} />;
 }
@@ -1,21 +0,0 @@
-import type { RouteLayoutParams } from '@/app/utils';
-import { getEmbeddableDynamicContext } from '@/lib/embeddable';
-import { CustomizationAIMode } from '@gitbook/api';
-import { redirect } from 'next/navigation';
-
-type PageProps = {
-    params: Promise<RouteLayoutParams>;
-};
-
-export default async function Page(props: PageProps) {
-    const params = await props.params;
-    const { context } = await getEmbeddableDynamicContext(params);
-    const baseURL = context.linker.toPathInSite('~gitbook/embed/');
-
-    // If assistant is enabled, redirect to assistant, otherwise to docs
-    if (context.customization.ai.mode === CustomizationAIMode.Assistant) {
-        redirect(`${baseURL}/assistant`);
-    } else {
-        redirect(`${baseURL}/page/`);
-    }
-}
@@ -12,7 +12,7 @@ export default async function Page(props: PageProps) {
    const { context } = await getEmbeddableDynamicContext(params);
    const pathname = getPagePathFromParams(params);

-    return <EmbeddableDocsPage context={context} pageParams={{ pathname }} staticRoute={false} />;
+    return <EmbeddableDocsPage context={context} pageParams={{ pathname }} />;
 }

 export async function generateMetadata(props: PageProps): Promise<Metadata> {
@@ -18,7 +18,7 @@ export default async function Page(props: PageProps) {
    const { context } = await getStaticSiteContext(params);
    const pathname = getPagePathFromParams(params);

-    return <SitePage context={context} pageParams={{ pathname }} staticRoute />;
+    return <SitePage context={context} pageParams={{ pathname }} />;
 }

 export async function generateViewport(props: PageProps): Promise<Viewport> {
@@ -19,7 +19,7 @@ export default async function SiteStaticLayout({
    const withTracking = shouldTrackEvents();

    return (
-        <CustomizationRootLayout className="site-background" context={context}>
+        <CustomizationRootLayout context={context}>
            <SiteLayout
                context={context}
                withTracking={withTracking}
@@ -1,28 +1,16 @@
-import type { RouteParams } from '@/app/utils';
+import type { RouteLayoutParams } from '@/app/utils';
 import { EmbeddableAssistantPage } from '@/components/Embeddable';
 import { getEmbeddableStaticContext } from '@/lib/embeddable';
-import { CustomizationAIMode } from '@gitbook/api';
-import { redirect } from 'next/navigation';

 export const dynamic = 'force-static';

 type PageProps = {
-    params: Promise<RouteParams>;
+    params: Promise<RouteLayoutParams>;
 };

 export default async function Page(props: PageProps) {
    const params = await props.params;
    const { context } = await getEmbeddableStaticContext(params);

-    // If the assistant is not enabled, redirect to the docs
-    if (context.customization.ai.mode !== CustomizationAIMode.Assistant) {
-        redirect(`${context.linker.toPathInSite('~gitbook/embed/page/')}`);
-    }
-
-    return (
-        <EmbeddableAssistantPage
-            baseURL={context.linker.toPathInSite('~gitbook/embed/')}
-            siteTitle={context.site.title}
-        />
-    );
+    return <EmbeddableAssistantPage context={context} />;
 }
@@ -1,23 +0,0 @@
-import type { RouteLayoutParams } from '@/app/utils';
-import { getEmbeddableStaticContext } from '@/lib/embeddable';
-import { CustomizationAIMode } from '@gitbook/api';
-import { redirect } from 'next/navigation';
-
-export const dynamic = 'force-static';
-
-type PageProps = {
-    params: Promise<RouteLayoutParams>;
-};
-
-export default async function Page(props: PageProps) {
-    const params = await props.params;
-    const { context } = await getEmbeddableStaticContext(params);
-    const baseURL = context.linker.toPathInSite('~gitbook/embed/');
-
-    // If assistant is enabled, redirect to assistant, otherwise to docs
-    if (context.customization.ai.mode === CustomizationAIMode.Assistant) {
-        redirect(`${baseURL}/assistant`);
-    } else {
-        redirect(`${baseURL}/page/`);
-    }
-}
@@ -14,7 +14,7 @@ export default async function Page(props: PageProps) {
    const { context } = await getEmbeddableStaticContext(params);
    const pathname = getPagePathFromParams(params);

-    return <EmbeddableDocsPage context={context} pageParams={{ pathname }} staticRoute />;
+    return <EmbeddableDocsPage context={context} pageParams={{ pathname }} />;
 }

 export async function generateMetadata(props: PageProps): Promise<Metadata> {
@@ -1,12 +0,0 @@
-import { type RouteParams, getPagePathFromParams, getStaticSiteContext } from '@/app/utils';
-import { servePageRSS } from '@/routes/rss';
-import type { NextRequest } from 'next/server';
-
-export const dynamic = 'force-static';
-
-export async function GET(_request: NextRequest, { params }: { params: Promise<RouteParams> }) {
-    const { context } = await getStaticSiteContext(await params);
-    const pathname = getPagePathFromParams(await params);
-
-    return servePageRSS(context, pathname);
-}
@@ -3,7 +3,7 @@ import { type SiteURLData, fetchSiteContextByURLLookup, getBaseContext } from '@
 import { getDynamicCustomizationSettings } from '@/lib/customization';
 import type { SiteAPIToken } from '@gitbook/api';
 import { jwtDecode } from 'jwt-decode';
-import { forbidden, notFound } from 'next/navigation';
+import { forbidden } from 'next/navigation';
 import rison from 'rison';

 export type RouteParamMode = 'url-host' | 'url';
@@ -80,27 +80,14 @@ export async function getDynamicSiteContext(params: RouteLayoutParams) {
 * Get the decoded page path from the params.
 */
 export function getPagePathFromParams(params: RouteParams) {
-    // If decoding the param fails, return a 404 instead of crashing
-    try {
-        const decoded = decodeURIComponent(params.pagePath);
-        return decoded;
-    } catch (error) {
-        console.error(
-            `Returning 404 after failing to decode page path ${params.pagePath}: ${error}`
-        );
-        notFound();
-    }
+    const decoded = decodeURIComponent(params.pagePath);
+    return decoded;
 }

 function getSiteURLFromParams(params: RouteLayoutParams) {
-    try {
-        const decoded = decodeURIComponent(params.siteURL);
-        const url = new URL(`https://${decoded}`);
-        return url;
-    } catch (error) {
-        console.error(`Returning 404 after failing to decode site URL ${params.siteURL}: ${error}`);
-        notFound();
-    }
+    const decoded = decodeURIComponent(params.siteURL);
+    const url = new URL(`https://${decoded}`);
+    return url;
 }

 function getModeFromParams(mode: string): RouteParamMode {
@@ -115,13 +102,6 @@ function getModeFromParams(mode: string): RouteParamMode {
 * Get the decoded site data from the params.
 */
 function getSiteURLDataFromParams(params: RouteLayoutParams): SiteURLData {
-    try {
-        const decoded = decodeURIComponent(params.siteData);
-        return rison.decode(decoded);
-    } catch (error) {
-        console.error(
-            `Returning 404 after failing to decode site data ${params.siteData}: ${error}`
-        );
-        notFound();
-    }
+    const decoded = decodeURIComponent(params.siteData);
+    return rison.decode(decoded);
 }
@@ -16,14 +16,14 @@ export function AIMessageView(
 ) {
    const { message, context, withToolCalls = true, withLinkPreviews = true } = props;

-    return message.steps.length > 0 ? (
+    return (
        <div className="flex flex-col gap-2">
            {message.steps.map((step, index) => {
                return (
                    <div
                        key={index}
                        className={tcls(
-                            'flex flex-col gap-2',
+                            'flex animate-fade-in-slow flex-col gap-2',
                            step.content.nodes.length > 0 ? 'has-content' : ''
                        )}
                    >
@@ -35,7 +35,7 @@ export function AIMessageView(
                                wrapBlocksInSuspense: false,
                                withLinkPreviews,
                            }}
-                            style="ai-response-document mt-2 space-y-4 *:origin-top-left *:animate-blur-in-slow"
+                            style="mt-2 space-y-4 empty:hidden"
                        />

                        {withToolCalls && step.toolCalls && step.toolCalls.length > 0 ? (
@@ -45,5 +45,5 @@ export function AIMessageView(
                );
            })}
        </div>
-    ) : null;
+    );
 }
@@ -39,7 +39,7 @@ function ToolCallSummary(props: { toolCall: AIToolCall; context: GitBookSiteCont
    const { toolCall, context } = props;

    return (
-        <div className="mt-2 flex origin-top-left animate-blur-in-slow items-start gap-2 text-sm text-tint-subtle">
+        <div className="flex origin-left animate-scale-in-slow items-start gap-2 text-sm text-tint-subtle">
            <Icon
                icon={getIconForToolCall(toolCall)}
                className="mt-1 size-3 shrink-0 text-tint-subtle/8"
@@ -160,7 +160,7 @@ async function DescriptionForSearchToolCall(props: {
    const hasResults = toolCall.results.length > 0;

    return (
-        <details className="-ml-5 group flex w-full flex-col">
+        <details className={tcls('-ml-5 group flex w-full flex-col', hasResults ? 'gap-2' : '')}>
            <summary
                className={tcls(
                    '-mx-2 flex list-none items-center gap-2 circular-corners:rounded-2xl rounded-corners:rounded-md pr-4 pl-7 transition-colors marker:hidden',
@@ -187,7 +187,7 @@ async function DescriptionForSearchToolCall(props: {
                ) : null}
            </summary>
            {hasResults ? (
-                <div className="hide-scrollbar mt-4 max-h-0 overflow-y-auto circular-corners:rounded-2xl rounded-corners:rounded-lg border border-tint-subtle p-2 opacity-0 transition-all transition-discrete duration-500 group-open:max-h-96 group-open:opacity-11">
+                <div className="hide-scrollbar mt-1 max-h-0 overflow-y-auto circular-corners:rounded-2xl rounded-corners:rounded-lg border border-tint-subtle p-2 opacity-0 transition-all transition-discrete duration-500 group-open:max-h-96 group-open:opacity-11">
                    <ol className="space-y-1">
                        {searchResultsWithHrefs.map((result, index) => (
                            <li
@@ -128,10 +128,10 @@ function parseResponse<T>(
    parse: (response: AIStreamResponse) => T | undefined | Promise<T | undefined>
 ): {
    stream: EventIterator<T>;
-    response: Promise<{ responseId: string | null }>;
+    response: Promise<{ responseId: string }>;
 } {
-    let resolveResponse: (value: { responseId: string | null }) => void;
-    const response = new Promise<{ responseId: string | null }>((resolve) => {
+    let resolveResponse: (value: { responseId: string }) => void;
+    const response = new Promise<{ responseId: string }>((resolve) => {
        resolveResponse = resolve;
    });

@@ -147,7 +147,7 @@ function parseResponse<T>(

                if (event.type === 'response_finish') {
                    foundResponse = true;
-                    resolveResponse({ responseId: event.response.id ?? null });
+                    resolveResponse({ responseId: event.responseId });
                }
            }

@@ -1,26 +1,21 @@
 'use client';

 import { CustomizationAIMode } from '@gitbook/api';
-import { Icon, type IconName } from '@gitbook/icons';
+import { Icon, type IconName, IconStyle } from '@gitbook/icons';
 import * as React from 'react';
 import type { ReactNode } from 'react';

 import { tString, useLanguage } from '@/intl/client';
 import type { GitBookAssistant } from '@gitbook/browser-types';
 import { useAIChatController, useAIChatState } from '.';
-import { AIChatIcon, AISearchIcon, getAIChatName } from '../AIChat';
+import { AIChatIcon, getAIChatName } from '../AIChat';
 import { useIntegrationAssistants } from '../Integrations';
 import { useSearch } from '../Search/useSearch';

 // Unify assistants configuration context with the assistants hook in one place
 export type AIConfig = {
    aiMode: CustomizationAIMode;
-    suggestions?: string[];
    trademark: boolean;
-    greeting?: {
-        title: string;
-        subtitle: string;
-    };
 };

 export type Assistant = Omit<GitBookAssistant, 'icon'> & {
@@ -54,11 +49,8 @@ export type Assistant = Omit<GitBookAssistant, 'icon'> & {
 const AIContext = React.createContext<AIConfig | null>(null);

 export function AIContextProvider(props: React.PropsWithChildren<AIConfig>): React.ReactElement {
-    const { aiMode, trademark, suggestions, greeting, children } = props;
-    const value = React.useMemo(
-        () => ({ aiMode, trademark, suggestions, greeting }),
-        [aiMode, trademark, suggestions, greeting]
-    );
+    const { aiMode, trademark, children } = props;
+    const value = React.useMemo(() => ({ aiMode, trademark }), [aiMode, trademark]);
    return <AIContext.Provider value={value}>{children}</AIContext.Provider>;
 }

@@ -96,7 +88,6 @@ export function useAI(): AIContext {
                <AIChatIcon
                    state={chat.loading ? 'thinking' : 'default'}
                    trademark={config.trademark}
-                    className="size-4"
                />
            ),
            open: (query?: string) => {
@@ -113,7 +104,16 @@ export function useAI(): AIContext {
        assistants.push({
            id: 'gitbook-ai-search',
            label: tString(language, 'ai_chat_context_badge'),
-            icon: <AISearchIcon />,
+            icon: (
+                <div className="relative">
+                    <Icon icon="search" className="size-4" />
+                    <Icon
+                        icon="sparkle"
+                        iconStyle={IconStyle.Solid}
+                        className="absolute top-[2.5px] left-[2.6px] size-2"
+                    />
+                </div>
+            ),
            open: (query?: string) => {
                if (query) {
                    setSearchState((prev) =>
@@ -87,19 +87,6 @@ export type AIChatState = {
    error: boolean;
 };

-export type AIChatEvent =
-    | { type: 'open' }
-    | { type: 'postMessage'; message: string }
-    | { type: 'clear' }
-    | { type: 'close' };
-
-type AIChatEventData<T extends AIChatEvent['type']> = Omit<
-    Extract<AIChatEvent, { type: T }>,
-    'type'
->;
-
-type AIChatEventListener = (input?: Omit<AIChatEvent, 'type'>) => void;
-
 export type AIChatController = {
    /** Open the dialog */
    open: () => void;
@@ -109,11 +96,6 @@ export type AIChatController = {
    postMessage: (input: { message: string }) => void;
    /** Clear the conversation */
    clear: () => void;
-    /** Register an event listener */
-    on: <T extends AIChatEvent['type']>(
-        event: T,
-        listener: (input?: AIChatEventData<T>) => void
-    ) => () => void;
 };

 const AIChatControllerContext = React.createContext<AIChatController | null>(null);
@@ -141,17 +123,6 @@ export function useAIChatState(): AIChatState {
    return state;
 }

-function notify(
-    listeners: AIChatEventListener[] | undefined,
-    input: Omit<AIChatEvent, 'type'>
-): void {
-    if (!listeners) return;
-    // Defer event listeners to next tick so React can process state updates first
-    setTimeout(() => {
-        listeners.forEach((listener) => listener(input));
-    }, 0);
-}
-
 /**
 * Provide the controller to interact with the AI chat.
 */
@@ -166,9 +137,6 @@ export function AIChatProvider(props: {
    const [, setSearchState] = useSearch();
    const language = useLanguage();

-    // Event listeners storage
-    const eventsRef = React.useRef<Map<AIChatEvent['type'], AIChatEventListener[]>>(new Map());
-
    // Open AI chat and sync with search state
    const onOpen = React.useCallback(() => {
        const { initialQuery } = globalState.getState();
@@ -181,8 +149,6 @@ export function AIChatProvider(props: {
            scope: prev?.scope ?? 'default',
            open: false, // Close search popover when opening chat
        }));
-
-        notify(eventsRef.current.get('open'), {});
    }, [setSearchState]);

    // Close AI chat and clear ask parameter
@@ -196,8 +162,6 @@ export function AIChatProvider(props: {
            scope: prev?.scope ?? 'default',
            open: false,
        }));
-
-        notify(eventsRef.current.get('close'), {});
    }, [setSearchState]);

    // Stream a message with the AI backend
@@ -296,7 +260,7 @@ export function AIChatProvider(props: {
                        case 'response_finish': {
                            globalState.setState((state) => ({
                                ...state,
-                                responseId: event.response.id ?? null,
+                                responseId: event.responseId,
                                // Mark as not loading when the response is finished
                                // Even if the stream might continue as we receive 'response_followup_suggestion'
                                loading: false,
@@ -415,14 +379,8 @@ export function AIChatProvider(props: {
                }));
            }

-            notify(eventsRef.current.get('postMessage'), { message: input.message });
-
            if (query === input.message) {
                // Return early if the message is the same as the previous message
-                globalState.setState((state) => ({
-                    ...state,
-                    opened: true,
-                }));
                return;
            }

@@ -482,34 +440,14 @@ export function AIChatProvider(props: {
        }));
    }, [setSearchState]);

-    const onEvent = React.useCallback(
-        <T extends AIChatEvent['type']>(
-            event: T,
-            listener: (input?: AIChatEventData<T>) => void
-        ) => {
-            const listeners = eventsRef.current.get(event) || [];
-            listeners.push(listener as AIChatEventListener);
-            eventsRef.current.set(event, listeners);
-            return () => {
-                const currentListeners = eventsRef.current.get(event) || [];
-                eventsRef.current.set(
-                    event,
-                    currentListeners.filter((l) => l !== listener)
-                );
-            };
-        },
-        []
-    );
-
    const controller = React.useMemo(() => {
        return {
            open: onOpen,
            close: onClose,
            clear: onClear,
            postMessage: onPostMessage,
-            on: onEvent,
        };
-    }, [onOpen, onClose, onClear, onPostMessage, onEvent]);
+    }, [onOpen, onClose, onClear, onPostMessage]);

    return (
        <AIChatControllerContext.Provider value={controller}>
@@ -2,14 +2,12 @@

 import { t, tString, useLanguage } from '@/intl/client';
 import type { TranslationLanguage } from '@/intl/translations';
-import { tcls } from '@/lib/tailwind';
 import { Icon } from '@gitbook/icons';
 import React from 'react';
 import { useHotkeys } from 'react-hotkeys-hook';
 import {
    type AIChatController,
    type AIChatState,
-    useAI,
    useAIChatController,
    useAIChatState,
 } from '../AI';
@@ -19,22 +17,21 @@ import {
    EmbeddableFrameButtons,
    EmbeddableFrameHeader,
    EmbeddableFrameHeaderMain,
-    EmbeddableFrameMain,
    EmbeddableFrameSubtitle,
    EmbeddableFrameTitle,
 } from '../Embeddable/EmbeddableFrame';
 import { useTrackEvent } from '../Insights';
 import { useNow } from '../hooks';
 import { Button } from '../primitives';
-import { ScrollContainer } from '../primitives/ScrollContainer';
 import { AIChatControlButton } from './AIChatControlButton';
 import { AIChatIcon } from './AIChatIcon';
 import { AIChatInput } from './AIChatInput';
 import { AIChatMessages } from './AIChatMessages';
 import AIChatSuggestedQuestions from './AIChatSuggestedQuestions';

-export function AIChat() {
-    const { config } = useAI();
+export function AIChat(props: { trademark: boolean }) {
+    const { trademark } = props;
+
    const language = useLanguage();
    const chat = useAIChatState();
    const chatController = useAIChatController();
@@ -68,45 +65,39 @@ export function AIChat() {
        }
    }, [chat.opened, trackEvent]);

+    if (!chat.opened) {
+        return null;
+    }
+
    return (
        <div
            data-testid="ai-chat"
-            className={tcls(
-                'ai-chat inset-y-0 right-0 z-40 mx-auto flex max-w-3xl scroll-mt-36 px-4 py-4 transition-[width,opacity,margin,display] transition-discrete duration-300 sm:px-6 lg:fixed lg:w-80 lg:p-0 xl:w-96',
-                chat.opened
-                    ? 'lg:starting:ml-0 lg:starting:w-0 lg:starting:opacity-0'
-                    : 'hidden lg:ml-0 lg:w-0! lg:opacity-0'
-            )}
+            className="ai-chat inset-y-0 right-0 z-40 mx-auto flex max-w-3xl animate-present scroll-mt-36 px-4 py-4 transition-all duration-300 sm:px-6 lg:fixed lg:w-80 lg:animate-enter-from-right lg:pr-4 lg:pl-0 xl:w-96"
        >
-            <EmbeddableFrame className="relative shrink-0 border-tint-subtle border-l to-tint-base transition-all duration-300 max-lg:circular-corners:rounded-3xl max-lg:rounded-corners:rounded-md max-lg:border lg:w-80 xl:w-96">
-                <EmbeddableFrameMain>
-                    <EmbeddableFrameHeader>
-                        <AIChatDynamicIcon trademark={config.trademark} />
-                        <EmbeddableFrameHeaderMain>
-                            <EmbeddableFrameTitle>
-                                {getAIChatName(language, config.trademark)}
-                            </EmbeddableFrameTitle>
-                            <AIChatSubtitle chat={chat} />
-                        </EmbeddableFrameHeaderMain>
-                        <EmbeddableFrameButtons>
-                            <AIChatControlButton />
-                            <Button
-                                onClick={() => chatController.close()}
-                                iconOnly
-                                icon="close"
-                                label={tString(language, 'close')}
-                                variant="blank"
-                            />
-                        </EmbeddableFrameButtons>
-                    </EmbeddableFrameHeader>
-                    <EmbeddableFrameBody>
-                        <AIChatBody
-                            chatController={chatController}
-                            chat={chat}
-                            suggestions={config.suggestions}
+            <EmbeddableFrame className="relative circular-corners:rounded-3xl rounded-corners:rounded-md depth-subtle:shadow-lg shadow-tint ring-1 ring-tint-subtle">
+                <EmbeddableFrameHeader>
+                    <AIChatDynamicIcon trademark={trademark} />
+                    <EmbeddableFrameHeaderMain>
+                        <EmbeddableFrameTitle>
+                            {getAIChatName(language, trademark)}
+                        </EmbeddableFrameTitle>
+                        <AIChatSubtitle chat={chat} />
+                    </EmbeddableFrameHeaderMain>
+                    <EmbeddableFrameButtons>
+                        <AIChatControlButton />
+                        <Button
+                            onClick={() => chatController.close()}
+                            iconOnly
+                            icon="close"
+                            label={tString(language, 'close')}
+                            variant="blank"
+                            size="default"
                        />
-                    </EmbeddableFrameBody>
-                </EmbeddableFrameMain>
+                    </EmbeddableFrameButtons>
+                </EmbeddableFrameHeader>
+                <EmbeddableFrameBody>
+                    <AIChatBody chatController={chatController} chat={chat} trademark={trademark} />
+                </EmbeddableFrameBody>
            </EmbeddableFrame>
        </div>
    );
@@ -117,14 +108,13 @@ export function AIChat() {
 */
 export function AIChatDynamicIcon(props: {
    trademark: boolean;
-    className?: string;
 }) {
-    const { trademark, className } = props;
+    const { trademark } = props;
    const chat = useAIChatState();

    return (
        <AIChatIcon
-            className={tcls('size-5 text-tint', className)}
+            className="size-5 text-tint"
            trademark={trademark}
            state={
                chat.error
@@ -153,33 +143,10 @@ export function AIChatSubtitle(props: {
    const language = useLanguage();

    return (
-        <EmbeddableFrameSubtitle
-            className={tcls('relative', chat.loading ? 'h-3 opacity-11' : 'h-0 opacity-0')}
-        >
-            <span
-                className={tcls(
-                    'absolute left-0',
-                    chat.loading
-                        ? chat.messages[chat.messages.length - 1]?.content
-                            ? 'animate-blur-in-slow'
-                            : 'hidden'
-                        : 'animate-blur-out-slow'
-                )}
-            >
-                {t(language, 'ai_chat_working')}
-            </span>
-            <span
-                className={tcls(
-                    'absolute left-0',
-                    chat.loading
-                        ? chat.messages[chat.messages.length - 1]?.content
-                            ? 'animate-blur-out-slow'
-                            : 'animate-blur-in-slow'
-                        : 'hidden'
-                )}
-            >
-                {t(language, 'ai_chat_thinking')}
-            </span>
+        <EmbeddableFrameSubtitle className={chat.loading ? 'h-3 opacity-11' : 'h-0 opacity-0'}>
+            {chat.messages[chat.messages.length - 1]?.content
+                ? tString(language, 'ai_chat_working')
+                : tString(language, 'ai_chat_thinking')}
        </EmbeddableFrameSubtitle>
    );
 }
@@ -190,16 +157,20 @@ export function AIChatSubtitle(props: {
 export function AIChatBody(props: {
    chatController: AIChatController;
    chat: AIChatState;
+    trademark: boolean;
    welcomeMessage?: string;
    suggestions?: string[];
-    greeting?: {
-        title: string;
-        subtitle: string;
-    };
 }) {
-    const { chatController, chat, suggestions, greeting } = props;
-    const { trademark } = useAI().config;
+    const { chatController, chat, trademark, suggestions } = props;

+    const [input, setInput] = React.useState('');
+
+    const scrollContainerRef = React.useRef<HTMLDivElement>(null);
+    // Ref for the last user message element
+    const lastUserMessageRef = React.useRef<HTMLDivElement>(null);
+    const inputRef = React.useRef<HTMLDivElement>(null);
+
+    const [inputHeight, setInputHeight] = React.useState(0);
    const language = useLanguage();
    const now = useNow(60 * 60 * 1000); // Refresh every hour for greeting

@@ -213,44 +184,67 @@ export function AIChatBody(props: {
        return tString(language, 'ai_chat_assistant_greeting_evening');
    }, [now, language]);

+    // Auto-scroll to the latest user message when messages change
+    React.useEffect(() => {
+        if (chat.messages.length > 0 && lastUserMessageRef.current) {
+            lastUserMessageRef.current.scrollIntoView({
+                behavior: 'smooth',
+                block: 'start',
+            });
+        }
+    }, [chat.messages.length]);
+
+    React.useEffect(() => {
+        const timeout = setTimeout(() => {
+            if (lastUserMessageRef.current) {
+                lastUserMessageRef.current.scrollIntoView({
+                    behavior: 'smooth',
+                    block: 'start',
+                });
+            }
+        }, 100);
+
+        // We want the chat messages to scroll underneath the input, but they should scroll past the input when scrolling all the way down.
+        // The best way to do this is to observe the input height and adjust the padding bottom of the scroll container accordingly.
+        const observer = new ResizeObserver((entries) => {
+            entries.forEach((entry) => {
+                setInputHeight(entry.contentRect.height + 32);
+            });
+        });
+        if (inputRef.current) {
+            observer.observe(inputRef.current);
+        }
+        return () => {
+            observer.disconnect();
+            clearTimeout(timeout);
+        };
+    }, []);
+
    return (
        <>
-            <ScrollContainer
-                className="shrink grow basis-80 animate-fade-in-slow [container-type:size]"
-                contentClassName="p-4 gutter-stable flex flex-col gap-4"
-                orientation="vertical"
-                fadeEdges={['leading']}
-                active={`message-group-${chat.messages.filter((message) => message.role === 'user').length - 1}`}
+            <div
+                ref={scrollContainerRef}
+                className="gutter-stable flex grow scroll-pt-4 flex-col gap-4 overflow-y-auto p-4"
+                style={{
+                    paddingBottom: `${inputHeight}px`,
+                }}
            >
                {isEmpty ? (
-                    <div className="flex grow flex-col">
-                        <div className="my-auto flex flex-row items-center gap-4 pb-6 [@container(min-height:400px)]:flex-col">
-                            <div
-                                className="flex size-16 shrink-0 animate-scale-in items-center justify-center rounded-full bg-primary-solid/1 [@container(min-height:400px)]:size-32"
-                                style={{ animationDelay: '.3s' }}
-                            >
-                                <AIChatIcon
-                                    state="intro"
-                                    trademark={trademark}
-                                    className="size-8 text-primary [@container(min-height:400px)]:size-16"
-                                />
-                            </div>
-                            <div className="flex flex-col items-start gap-1 [@container(min-height:400px)]:items-center">
-                                <h5
-                                    className="animate-blur-in-slow font-bold text-lg text-tint-strong leading-tight [@container(min-height:400px)]:text-center"
-                                    style={{ animationDelay: '.5s' }}
-                                    data-testid="ai-chat-time-greeting"
-                                >
-                                    {greeting?.title || timeGreeting}
-                                </h5>
-                                <p
-                                    className="animate-blur-in-slow text-tint leading-tight [@container(min-height:400px)]:text-center"
-                                    style={{ animationDelay: '.6s' }}
-                                >
-                                    {greeting?.subtitle ||
-                                        t(language, 'ai_chat_assistant_description')}
-                                </p>
-                            </div>
+                    <div className="flex min-h-full w-full shrink-0 flex-col items-center justify-center gap-6 py-4">
+                        <div className="flex size-32 animate-fade-in-slow items-center justify-center rounded-full bg-tint-subtle">
+                            <AIChatIcon
+                                state="intro"
+                                trademark={trademark}
+                                className="size-16 animate-[present_500ms_200ms_both]"
+                            />
+                        </div>
+                        <div className="animate-[fadeIn_500ms_400ms_both]">
+                            <h5 className=" text-center font-bold text-lg text-tint-strong">
+                                {timeGreeting}
+                            </h5>
+                            <p className="text-center text-tint">
+                                {t(language, 'ai_chat_assistant_description')}
+                            </p>
                        </div>
                        {!chat.error ? (
                            <AIChatSuggestedQuestions
@@ -260,19 +254,28 @@ export function AIChatBody(props: {
                        ) : null}
                    </div>
                ) : (
-                    <AIChatMessages chat={chat} chatController={chatController} />
+                    <AIChatMessages
+                        chat={chat}
+                        chatController={chatController}
+                        lastUserMessageRef={lastUserMessageRef}
+                    />
                )}
-            </ScrollContainer>
-
-            <div className="flex flex-col gap-2 px-4 pb-4">
+            </div>
+            <div
+                ref={inputRef}
+                className="absolute inset-x-0 bottom-0 mr-2 flex select-none flex-col gap-4 bg-linear-to-b from-transparent to-50% to-tint-base/9 p-4 pr-2"
+            >
                {/* Display an error banner when something went wrong. */}
                {chat.error ? <AIChatError chatController={chatController} /> : null}

                <AIChatInput
+                    value={input}
+                    onChange={setInput}
                    loading={chat.loading}
                    disabled={chat.loading || chat.error}
-                    onSubmit={(value) => {
-                        chatController.postMessage({ message: value });
+                    onSubmit={() => {
+                        chatController.postMessage({ message: input });
+                        setInput('');
                    }}
                />
            </div>
@@ -23,7 +23,7 @@ export function AIChatButton(props: {
            iconOnly={!showLabel}
            size="medium"
            variant="header"
-            className="@max-2xl:px-2.5 @max-2xl:[&_.button-content]:hidden [&_.button-leading-icon]:my-0.5"
+            className="h-9 px-2.5 max-md:[&_.button-content]:hidden"
            label={
                <div className="flex items-center gap-2">
                    {t(language, 'ai_chat_ask', assistant.label)}
@@ -1,9 +1,10 @@
 'use client';

 import { useLanguage } from '@/intl/client';
-import { t } from '@/intl/translate';
+import { t, tString } from '@/intl/translate';
+import { Icon } from '@gitbook/icons';
 import { useAIChatController, useAIChatState } from '../AI';
-import { Button } from '../primitives';
+import { Button, DropdownMenu, DropdownMenuItem } from '../primitives';

 /**
 * Button to control the chat (clear, etc.)
@@ -14,15 +15,26 @@ export function AIChatControlButton() {
    const chatController = useAIChatController();

    return chat.messages.length > 0 ? (
-        <Button
-            onClick={() => {
-                chatController.clear();
-            }}
-            iconOnly
-            icon="trash-can"
-            label={t(language, 'ai_chat_clear_conversation')}
-            variant="blank"
-            className="animate-blur-in-slow"
-        />
+        <DropdownMenu
+            button={
+                <Button
+                    onClick={() => {}}
+                    iconOnly
+                    icon="ellipsis"
+                    label={tString(language, 'actions')}
+                    variant="blank"
+                    size="default"
+                />
+            }
+        >
+            <DropdownMenuItem
+                onClick={() => {
+                    chatController.clear();
+                }}
+            >
+                <Icon icon="broom-wide" className="size-3 shrink-0 text-tint-subtle" />
+                {t(language, 'ai_chat_clear_conversation')}
+            </DropdownMenuItem>
+        </DropdownMenu>
    ) : null;
 }
@@ -1,4 +1,5 @@
-import { Icon, IconStyle } from '@gitbook/icons';
+import { tcls } from '@/lib/tailwind';
+import { Icon } from '@gitbook/icons';
 import type React from 'react';

 interface AIChatIconProps extends React.SVGProps<SVGSVGElement> {
@@ -8,30 +9,23 @@ interface AIChatIconProps extends React.SVGProps<SVGSVGElement> {
    trademark?: boolean;
 }

-export function AIChatIcon({
+export const AIChatIcon = ({
    className = 'size-4',
    size,
    trademark = true,
    state = 'default',
    ...props
-}: AIChatIconProps) {
+}: AIChatIconProps) => {
    if (!trademark) {
        return (
            <Icon
                icon="sparkle"
-                {...props}
-                className={className}
-                style={{
-                    animation: {
-                        intro: 'spin 2s forwards cubic-bezier(0.16,1,0.3,1)',
-                        thinking: 'spin 2s infinite forwards cubic-bezier(0.16,1,0.3,1)',
-                        working: 'spin 2s infinite forwards cubic-bezier(0.16,1,0.3,1)',
-                        done: '',
-                        confirm: '',
-                        default: '',
-                        error: '',
-                    }[state],
-                }}
+                className={tcls(
+                    className,
+                    (state === 'thinking' || state === 'working') &&
+                        'animate-[spin_2s_infinite_forwards_cubic-bezier(0.16,1,0.3,1)]',
+                    state === 'intro' && 'animate-[spin_2s_forwards_cubic-bezier(0.16,1,0.3,1)]'
+                )}
            />
        );
    }
@@ -55,36 +49,28 @@ export function AIChatIcon({
            <path
                d="M12.8916 1.06265C12.921 0.979101 13.0392 0.979127 13.0685 1.06267C13.239 1.5478 13.3439 1.84646 13.516 2.1032C13.6683 2.33042 13.8578 2.53033 14.0766 2.6945C14.3239 2.88 14.6165 3.00068 15.0919 3.19671C15.1761 3.23142 15.1761 3.3506 15.0919 3.38531C14.6165 3.58134 14.3239 3.70203 14.0766 3.88752C13.8578 4.05169 13.6683 4.2516 13.516 4.47882C13.3439 4.73556 13.239 5.03423 13.0685 5.51937C13.0392 5.60291 12.921 5.60292 12.8916 5.51938C12.7212 5.03423 12.6162 4.73557 12.4442 4.47882C12.2919 4.2516 12.1023 4.05169 11.8835 3.88752C11.6363 3.70202 11.3436 3.58134 10.8682 3.38531C10.7841 3.3506 10.7841 3.23141 10.8683 3.1967C11.3436 3.00067 11.6363 2.87999 11.8835 2.6945C12.1023 2.53033 12.2919 2.33042 12.4442 2.1032C12.6162 1.84646 12.7212 1.54779 12.8916 1.06265Z"
                stroke="currentColor"
-                strokeWidth={state === 'intro' ? '1.2' : '1'}
+                strokeWidth="1.2"
                strokeLinejoin="round"
-                shapeRendering="crispEdges"
-                className="transition-opacity duration-300"
-                style={{
-                    animation: {
-                        intro: 'fadeIn .5s .5s backwards, spin 2s .5s forwards cubic-bezier(0.43,1.54,0.64,1)',
-                        thinking: 'spin 2s 1s infinite forwards cubic-bezier(0.16,1,0.3,1)',
-                        working: 'spin 2s 1s infinite forwards cubic-bezier(0.16,1,0.3,1)',
-                        done: '',
-                        confirm: '',
-                        default: '',
-                        error: '',
-                    }[state],
-                    transitionDelay:
-                        state === 'default' || state === 'thinking' ? '.3s' : undefined,
-                    opacity: ['done', 'confirm', 'error'].includes(state) ? 0 : 1,
-                    transformOrigin: '13px 3.5px',
-                }}
+                className={tcls(
+                    state === 'intro' &&
+                        'animate-[fadeIn_.5s_.7s_both,spin_2s_1s_forwards_cubic-bezier(.43,1.54,.64,1)]',
+                    (state === 'working' || state === 'thinking') &&
+                        'animate-[fadeIn_.5s_.3s_both,spin_2s_1s_infinite_forwards_cubic-bezier(0.16,1,0.3,1)]',
+                    state === 'done' && 'animate-[fadeOut_.5s_both]',
+                    state === 'confirm' && 'animate-[fadeOut_.5s_both]',
+                    state === 'default' && 'animate-[fadeIn_0s_both]',
+                    state === 'error' && 'hidden'
+                )}
+                style={{ transformOrigin: '13px 3.5px' }}
            />

            {/* Error */}
            <g
                clipPath="url(#clip0_153_2034)"
-                className="transition-opacity duration-300"
-                style={{
-                    color: 'rgb(var(--danger-9))',
-                    opacity: state === 'error' ? 1 : 0,
-                    transitionDelay: state === 'error' ? '.3s' : undefined,
-                }}
+                className={tcls(
+                    'text-danger-subtle',
+                    state === 'error' ? 'animate-[fadeIn_.5s_.3s_both]' : 'hidden'
+                )}
            >
                <path
                    d="M13.0312 1.42059L13.0312 3.95184"
@@ -107,34 +93,29 @@ export function AIChatIcon({
                strokeWidth="1.2"
                strokeLinecap="round"
                strokeLinejoin="round"
-                className="transition-opacity duration-300"
-                style={{
-                    opacity: state === 'done' ? 1 : 0,
-                    transitionDelay: state === 'done' ? '.3s' : undefined,
-                }}
+                className={tcls(
+                    state === 'done'
+                        ? 'animate-[fadeIn_.5s_.3s_both]'
+                        : 'animate-[fadeOut_.5s_both]',
+                    state === 'intro' && 'hidden',
+                    state === 'confirm' && 'hidden'
+                )}
            />

            {/* Confirm */}
            <path
-                className="transition-opacity duration-300"
-                style={{
-                    fill: 'rgb(var(--primary-9))',
-                    opacity: state === 'confirm' ? 1 : 0,
-                    transitionDelay: state === 'confirm' ? '.3s' : undefined,
-                    animation: {
-                        intro: '',
-                        thinking: '',
-                        working: '',
-                        done: '',
-                        confirm: 'bounceSmall 1s infinite both',
-                        default: '',
-                        error: '',
-                    }[state],
-                }}
+                className={tcls(
+                    'fill-primary-9',
+                    state === 'confirm'
+                        ? 'animate-[fadeIn_.5s_.3s_both,bounceSmall_1s_infinite_both]'
+                        : state === 'thinking'
+                          ? 'animate-[fadeOut_.5s_both]'
+                          : 'hidden'
+                )}
                d="M12.9463 5.24512C13.3688 5.24422 13.713 5.58625 13.7139 6.00879C13.7146 6.43114 13.3725 6.77338 12.9502 6.77441C12.5279 6.77505 12.1845 6.43408 12.1836 6.01172C12.1828 5.58953 12.5242 5.24649 12.9463 5.24512ZM13.0391 0.0751953C14.0688 0.0730893 14.9049 0.90586 14.9072 1.93555C14.9084 2.5063 14.6484 3.04679 14.2012 3.40137L13.7773 3.7373C13.6151 3.86604 13.5201 4.06239 13.5205 4.26953V4.30371C13.5211 4.62139 13.2639 4.879 12.9463 4.87988C12.6288 4.88032 12.3701 4.62417 12.3691 4.30664V4.27246C12.3679 3.71272 12.6238 3.18263 13.0625 2.83496L13.4854 2.49902C13.6565 2.36341 13.7562 2.1568 13.7559 1.93848C13.755 1.54463 13.4358 1.22503 13.042 1.22559H12.9385C12.488 1.22679 12.1225 1.59352 12.123 2.04395L12.124 2.21875C12.1245 2.53649 11.8676 2.79522 11.5498 2.7959C11.2321 2.79653 10.9746 2.53928 10.9736 2.22168L10.9727 2.04688C10.9706 0.960578 11.8493 0.0778178 12.9355 0.0751953H13.0391Z"
            />

-            {/* Background  */}
+            {/* Background */}
            <path
                d="M3.5625 8.78512L7.26347 10.9219C7.88227 11.2791 8.64467 11.2791 9.26347 10.9219L14.25 8.0429C14.5833 7.85045 15 8.09101 15 8.47591V10.2777C15 10.4563 14.9047 10.6214 14.75 10.7107L9.26347 13.8784C8.64467 14.2356 7.88228 14.2356 7.26347 13.8784L3.5625 11.7416C2.70833 11.2978 1 9.93199 1 8.01949M1 8.01949C1 6.6448 1.84765 5.98698 2.62903 5.71701C3.15426 5.53555 3.71577 5.70568 4.19701 5.98353L7.26347 7.75395C7.88228 8.11122 8.64467 8.11122 9.26347 7.75395L10.9095 6.80362M1 8.01949C1 6.4945 2.03973 5.30731 2.5596 4.90434L7.37937 2.12165C7.79013 1.88449 8.26417 1.80476 8.71747 1.88245"
                stroke="currentColor"
@@ -142,17 +123,7 @@ export function AIChatIcon({
                strokeWidth="1.2"
                strokeLinecap="round"
                strokeLinejoin="round"
-                style={{
-                    animation: {
-                        intro: 'fadeIn 2s forwards',
-                        thinking: '',
-                        working: '',
-                        done: '',
-                        confirm: '',
-                        default: '',
-                        error: '',
-                    }[state],
-                }}
+                className={tcls(state === 'intro' && 'animate-[fadeIn_2s_forwards]')}
            />

            {/* Logo */}
@@ -182,66 +153,14 @@ export function AIChatIcon({
                    strokeWidth="1.2"
                    strokeLinecap="round"
                    strokeLinejoin="round"
-                    style={{
-                        animation: {
-                            intro: 'pathEnter 1.5s both ease-out',
-                            thinking: 'pathLoading 2s infinite both',
-                            working: 'pathLoading 2s infinite both',
-                            done: 'pathEnter 1s forwards ease',
-                            confirm: '',
-                            default: '',
-                            error: '',
-                        }[state],
-                    }}
+                    className={tcls(
+                        (state === 'thinking' || state === 'working') &&
+                            'animate-[pathLoading_2s_infinite_both]',
+                        state === 'intro' && 'animate-[pathEnter_2s_both]',
+                        state === 'done' && 'animate-[pathEnter_1s_forwards_ease]'
+                    )}
                />
            </g>
        </svg>
    );
-}
-
-interface AISearchIconProps extends React.SVGProps<SVGSVGElement> {
-    className?: string;
-    state?: 'default' | 'intro' | 'thinking' | 'working' | 'done' | 'error' | 'confirm';
-}
-
-export function AISearchIcon({ className = 'size-4', state = 'default' }: AISearchIconProps) {
-    return (
-        <div
-            style={{
-                position: 'relative',
-                animation: {
-                    intro: 'fadeIn 1s both, orbit 1s cubic-bezier(0.16,1,0.3,1)',
-                    thinking:
-                        'fadeIn 1s both, orbit 1s orbit 2s 1s infinite forwards linear ease-out,',
-                    working: '',
-                    done: '',
-                    confirm: '',
-                    default: '',
-                    error: '',
-                }[state],
-            }}
-        >
-            <Icon icon="search" className={className} />
-            <Icon
-                icon="sparkle"
-                iconStyle={IconStyle.Solid}
-                style={{
-                    position: 'absolute',
-                    top: '15.7%',
-                    left: '15.6%',
-                    width: '50%',
-                    height: '50%',
-                    animation: {
-                        intro: 'spin 2s .5s forwards cubic-bezier(0.16,1,0.3,1)',
-                        thinking: 'spin 2s infinite forwards cubic-bezier(0.16,1,0.3,1)',
-                        working: 'spin 2s infinite forwards cubic-bezier(0.16,1,0.3,1)',
-                        done: '',
-                        confirm: '',
-                        default: '',
-                        error: '',
-                    }[state],
-                }}
-            />
-        </div>
-    );
-}
+};
@@ -1,28 +1,38 @@
 import { t, tString, useLanguage } from '@/intl/client';
+import { tcls } from '@/lib/tailwind';
 import { Icon } from '@gitbook/icons';
 import { useEffect, useRef } from 'react';
 import { useHotkeys } from 'react-hotkeys-hook';
-import { useAIChatState } from '../AI/useAIChat';
-import { HoverCard, HoverCardRoot, HoverCardTrigger } from '../primitives';
-import { Input } from '../primitives/Input';
+import { Button, HoverCard, HoverCardRoot, HoverCardTrigger } from '../primitives';
+import { KeyboardShortcut } from '../primitives/KeyboardShortcut';

 export function AIChatInput(props: {
+    value: string;
    disabled?: boolean;
    /**
     * When true, the input is disabled
     */
    loading: boolean;
+    onChange: (value: string) => void;
    onSubmit: (value: string) => void;
 }) {
-    const { onSubmit, disabled, loading } = props;
+    const { value, onChange, onSubmit, disabled, loading } = props;

    const language = useLanguage();
-    const chat = useAIChatState();

    const inputRef = useRef<HTMLTextAreaElement>(null);

+    const handleInput = (event: React.ChangeEvent<HTMLTextAreaElement>) => {
+        const textarea = event.currentTarget;
+        onChange(textarea.value);
+
+        // Auto-resize
+        textarea.style.height = 'auto';
+        textarea.style.height = `${textarea.scrollHeight}px`;
+    };
+
    useEffect(() => {
-        if (chat.opened && !disabled && !loading) {
+        if (!disabled && !loading) {
            // Add a small delay to ensure the input is rendered before focusing
            // This fixes inconsistent focus behaviour across browsers
            const timeout = setTimeout(() => {
@@ -31,7 +41,7 @@ export function AIChatInput(props: {

            return () => clearTimeout(timeout);
        }
-    }, [disabled, loading, chat.opened]);
+    }, [disabled, loading]);

    useHotkeys(
        'mod+i',
@@ -45,34 +55,58 @@ export function AIChatInput(props: {
    );

    return (
-        <Input
-            data-testid="ai-chat-input"
-            name="ai-chat-input"
-            multiline
-            resize
-            sizing="large"
-            label="Assistant chat input"
-            placeholder={tString(language, 'ai_chat_input_placeholder')}
-            onSubmit={(val) => onSubmit(val as string)}
-            submitButton={{
-                label: tString(language, 'send'),
-            }}
-            className="animate-blur-in-slow bg-tint-base/9 backdrop-blur-lg contrast-more:bg-tint-base"
-            rows={1}
-            maxLength={2048}
-            keyboardShortcut={
-                !disabled && !loading
-                    ? {
-                          keys: ['mod', 'i'],
-                          className: 'bg-tint-base group-focus-within/input:hidden',
-                      }
-                    : undefined
-            }
-            disabled={disabled || loading}
-            aria-busy={loading}
-            ref={inputRef}
-            trailing={
-                <HoverCardRoot openDelay={500}>
+        <div className="depth-subtle:has-[textarea:focus]:-translate-y-px relative flex flex-col overflow-hidden circular-corners:rounded-2xl rounded-corners:rounded-md bg-tint-base/9 depth-subtle:shadow-sm shadow-tint/6 ring-1 ring-tint-subtle backdrop-blur-lg transition-all depth-subtle:has-[textarea:focus]:shadow-lg has-[textarea:focus]:shadow-primary-subtle has-[textarea:focus]:ring-2 has-[textarea:focus]:ring-primary-hover contrast-more:bg-tint-base dark:shadow-tint-1">
+            <textarea
+                ref={inputRef}
+                disabled={disabled || loading}
+                data-loading={loading}
+                data-testid="ai-chat-input"
+                className={tcls(
+                    'resize-none',
+                    'focus:outline-hidden',
+                    'focus:ring-0',
+                    'w-full',
+                    'px-3',
+                    'py-3',
+                    'pb-12',
+                    'h-auto',
+                    'bg-transparent',
+                    'peer',
+                    'max-h-64',
+                    'placeholder:text-tint/8',
+                    'transition-colors',
+                    'disabled:bg-tint-subtle',
+                    'delay-300',
+                    'disabled:delay-0',
+                    'disabled:cursor-not-allowed',
+                    'data-[loading=true]:cursor-progress',
+                    'data-[loading=true]:opacity-50'
+                )}
+                value={value}
+                rows={1}
+                placeholder={tString(language, 'ai_chat_input_placeholder')}
+                onChange={handleInput}
+                onKeyDown={(event) => {
+                    if (event.key === 'Escape') {
+                        event.preventDefault();
+                        event.currentTarget.blur();
+                        return;
+                    }
+
+                    if (event.key === 'Enter' && !event.shiftKey && value.trim()) {
+                        event.preventDefault();
+                        event.currentTarget.style.height = 'auto';
+                        onSubmit(value);
+                    }
+                }}
+            />
+            {!disabled ? (
+                <div className="absolute top-2.5 right-3 animate-[fadeIn_0.2s_0.5s_ease-in-out_both] peer-focus:hidden">
+                    <KeyboardShortcut keys={['mod', 'i']} className="bg-tint-base" />
+                </div>
+            ) : null}
+            <div className="absolute inset-x-0 bottom-0 flex items-center gap-2 px-2 py-2">
+                <HoverCardRoot>
                    <HoverCard
                        className="max-w-xs bg-tint p-2 text-sm text-tint"
                        arrow={{ className: 'fill-tint-3' }}
@@ -99,8 +133,7 @@ export function AIChatInput(props: {
                        </div>
                    </HoverCard>
                    <HoverCardTrigger>
-                        {/* Negative margin to compensate for Input's padding, so the badge appears flush with the cursor */}
-                        <div className="-ml-1 flex cursor-help items-center gap-1 circular-corners:rounded-2xl rounded-corners:rounded-md px-2.5 py-1.5 text-tint/7 text-xs transition-all hover:bg-tint">
+                        <div className="flex cursor-help items-center gap-1 circular-corners:rounded-2xl rounded-corners:rounded-md px-2.5 py-1.5 text-tint/7 text-xs transition-all hover:bg-tint">
                            <span className="-ml-1 circular-corners:rounded-2xl rounded-corners:rounded-sm bg-tint-11/7 px-1 py-0.5 font-mono font-semibold text-[0.65rem] text-contrast-tint-11 leading-none">
                                {t(language, 'ai_chat_context_badge')}
                            </span>{' '}
@@ -111,7 +144,14 @@ export function AIChatInput(props: {
                        </div>
                    </HoverCardTrigger>
                </HoverCardRoot>
-            }
-        />
+                <Button
+                    label={tString(language, 'send')}
+                    size="medium"
+                    className="ml-auto"
+                    disabled={disabled || !value.trim()}
+                    onClick={() => onSubmit(value)}
+                />
+            </div>
+        </div>
    );
 }
@@ -2,6 +2,7 @@ import { useLanguage } from '@/intl/client';
 import { tString } from '@/intl/translate';
 import { tcls } from '@/lib/tailwind';
 import { AIMessageRole } from '@gitbook/api';
+import type React from 'react';
 import type { AIChatController, AIChatState } from '../AI';
 import { AIChatToolConfirmations } from './AIChatToolConfirmations';
 import { AIResponseFeedback } from './AIResponseFeedback';
@@ -10,133 +11,87 @@ import { AIChatFollowupSuggestions } from './AiChatFollowupSuggestions';
 export function AIChatMessages(props: {
    chat: AIChatState;
    chatController: AIChatController;
+    lastUserMessageRef?: React.RefObject<HTMLDivElement>;
 }) {
-    const { chat, chatController } = props;
+    const { chat, chatController, lastUserMessageRef } = props;

-    // Group messages: user messages start a new group, all following messages until next user message belong to that group
-    type Message = (typeof chat.messages)[0];
-    type MessageGroup = { message: Message; originalIndex: number };
-    const messageGroups: Array<Array<MessageGroup>> = [];
-    let currentGroup: Array<MessageGroup> = [];
+    return (
+        <>
+            {chat.messages.map((message, index) => {
+                const isLastMessage = index === chat.messages.length - 1;
+                const isLastUserMessage =
+                    message.role === AIMessageRole.User &&
+                    index === chat.messages.map((m) => m.role).lastIndexOf(AIMessageRole.User);

-    chat.messages.forEach((message, index) => {
-        if (message.role === AIMessageRole.User) {
-            // Start a new group
-            if (currentGroup.length > 0) {
-                messageGroups.push(currentGroup);
-            }
-            currentGroup = [{ message, originalIndex: index }];
-        } else {
-            // Add to current group
-            currentGroup.push({ message, originalIndex: index });
-        }
-    });
+                return (
+                    <div
+                        ref={isLastUserMessage ? lastUserMessageRef : undefined}
+                        data-testid="ai-chat-message"
+                        className={tcls(
+                            message.content ? 'animate-fade-in-slow' : '',
+                            'shrink-0',
+                            'last:min-h-[calc(100%-5rem)]',
+                            'scroll-mt-36',
+                            'lg:scroll-mt-0',
+                            'flex flex-col gap-6',
+                            'break-words',
+                            'group/message',
+                            message.role === AIMessageRole.User
+                                ? 'max-w-[80%] self-end circular-corners:rounded-2xl rounded-corners:rounded-md bg-tint px-4 py-2'
+                                : 'text-tint-strong'
+                        )}
+                        style={{
+                            animationDelay: `${Math.min(index * 0.05, 0.5)}s`,
+                        }}
+                        key={index}
+                    >
+                        {message.content ? message.content : null}

-    // Add the last group if it exists
-    if (currentGroup.length > 0) {
-        messageGroups.push(currentGroup);
-    }
+                        {isLastMessage && chat.loading ? (
+                            <div className="flex w-full animate-fade-in-slow flex-col gap-2">
+                                {!message.content ? <HoldMessage /> : null}
+                                <LoadingSkeleton />
+                            </div>
+                        ) : null}

-    return messageGroups.map((group, groupIndex) => {
-        const isLastGroup = group === messageGroups[messageGroups.length - 1];
-        return (
-            <div
-                key={groupIndex}
-                id={`message-group-${groupIndex}`}
-                className={tcls(
-                    'flex flex-col gap-2 pt-2',
-                    isLastGroup ? 'shrink-0 basis-full' : '',
-
-                    'transition-discrete'
-                )}
-                style={{ animationDelay: '.2s' }}
-            >
-                {group.map(({ message, originalIndex }) => {
-                    const isLastMessage = originalIndex === chat.messages.length - 1;
-                    return (
-                        <div
-                            key={originalIndex}
-                            data-testid={
-                                message.role === AIMessageRole.User
-                                    ? 'ai-chat-message-user'
-                                    : 'ai-chat-message-assistant'
-                            }
-                            id={`message-${originalIndex}`}
-                            className={tcls(
-                                'flex flex-col gap-6',
-                                'break-words',
-                                'group/message',
-                                'animate-blur-in-slow',
-                                isLastMessage ? 'basis-full' : '',
-                                message.role === AIMessageRole.User
-                                    ? 'max-w-[80%] origin-top-right self-end circular-corners:rounded-2xl rounded-corners:rounded-md bg-tint px-4 py-2'
-                                    : 'origin-top-left text-tint-strong'
-                            )}
-                            style={{
-                                animationDelay: `${Math.min(originalIndex * 0.1, 0.6)}s`,
-                            }}
-                        >
-                            {message.content}
-
-                            {isLastMessage && message.role === AIMessageRole.Assistant ? (
-                                <div
-                                    className={tcls(
-                                        'flex w-full shrink-0 flex-col gap-2 starting:opacity-0 transition-all transition-discrete duration-500',
-                                        chat.loading ? '' : 'hidden opacity-0'
-                                    )}
-                                >
-                                    <HoldMessage className={message.content ? 'hidden' : ''} />
-                                    <LoadingSkeleton />
-                                </div>
-                            ) : null}
-
-                            {isLastMessage ? (
-                                <>
-                                    {!chat.loading &&
-                                    !chat.error &&
-                                    chat.query &&
-                                    chat.responseId &&
-                                    chat.pendingTools.length === 0 ? (
-                                        <AIResponseFeedback
-                                            responseId={chat.responseId}
-                                            query={chat.query}
-                                            className="-ml-1 -mt-4"
-                                        />
-                                    ) : null}
-                                    <AIChatToolConfirmations chat={chat} />
-                                    <AIChatFollowupSuggestions
-                                        chat={chat}
-                                        chatController={chatController}
+                        {isLastMessage ? (
+                            <>
+                                {!chat.loading &&
+                                !chat.error &&
+                                chat.query &&
+                                chat.responseId &&
+                                chat.pendingTools.length === 0 ? (
+                                    <AIResponseFeedback
+                                        responseId={chat.responseId}
+                                        query={chat.query}
+                                        className="-ml-1 -mt-4"
                                    />
-                                </>
-                            ) : null}
-                        </div>
-                    );
-                })}
-            </div>
-        );
-    });
+                                ) : null}
+                                <AIChatToolConfirmations chat={chat} />
+                                <AIChatFollowupSuggestions
+                                    chat={chat}
+                                    chatController={chatController}
+                                />
+                            </>
+                        ) : null}
+                    </div>
+                );
+            })}
+        </>
+    );
 }

-export function HoldMessage({
-    breakLines = false,
-    className,
-}: { breakLines?: boolean; className?: string }) {
+function HoldMessage() {
    const language = useLanguage();

    return (
-        <div
-            className={tcls(
-                'animate-[heightIn_.5s_5s_ease_both] overflow-hidden py-2 text-tint-subtle [&.hidden]:animate-[heightOut_1s_ease-in_both]',
-                className
-            )}
-        >
+        <div className="animate-[heightIn_500ms_4500ms_ease_both] py-2 text-tint-subtle">
            {tString(language, 'ai_chat_hold_message_1')
                .split(' ')
                .map((word, index) => (
                    <span
                        key={index}
-                        className="animate-blur-in-slow"
+                        className="animate-fade-in-slow"
                        style={{
                            animationDelay: `${5000 + index * 200}ms`,
                        }}
@@ -144,13 +99,12 @@ export function HoldMessage({
                        {word}{' '}
                    </span>
                ))}
-            {breakLines ? <br /> : null}
            {tString(language, 'ai_chat_hold_message_2')
                .split(' ')
                .map((word, index) => (
                    <span
                        key={index}
-                        className="animate-blur-in-slow"
+                        className="animate-fade-in-slow"
                        style={{
                            animationDelay: `${10000 + index * 200}ms`,
                        }}
@@ -168,9 +122,9 @@ function LoadingSkeleton() {
            {Array.from({ length: 7 }).map((_, index) => (
                <div
                    key={index}
-                    className="h-4 animate-[blurIn_500ms_ease-out_both,pulse_1.5s_infinite] circular-corners:rounded-2xl rounded-corners:rounded-md bg-tint-solid/2"
+                    className="h-4 animate-[fadeIn_500ms_ease_both,pulse_1.5s_infinite] circular-corners:rounded-2xl rounded-corners:rounded-md bg-tint-4"
                    style={{
-                        width: `calc(${(4 - (index % 4)) * 8 + 14}% - 4px)`,
+                        width: `calc(${(index % 4) * 20 + 10}% - 4px)`,
                        animationDelay: `${index * 0.1}s`,
                    }}
                />
@@ -7,27 +7,25 @@ export default function AIChatSuggestedQuestions(props: {
    suggestions?: string[];
 }) {
    const language = useLanguage();
-    const { chatController, suggestions: _suggestions } = props;
-
-    const suggestions =
-        _suggestions && _suggestions.length > 0
-            ? _suggestions
-            : [
-                  tString(language, 'ai_chat_suggested_questions_about_this_page'),
-                  tString(language, 'ai_chat_suggested_questions_read_next'),
-                  tString(language, 'ai_chat_suggested_questions_example'),
-              ];
+    const {
+        chatController,
+        suggestions = [
+            tString(language, 'ai_chat_suggested_questions_about_this_page'),
+            tString(language, 'ai_chat_suggested_questions_read_next'),
+            tString(language, 'ai_chat_suggested_questions_example'),
+        ],
+    } = props;

    return (
-        <div className="flex flex-col items-start gap-2 self-start">
+        <div className="flex flex-col items-center gap-2">
            {suggestions.map((question, index) => (
                <Button
                    key={question}
-                    variant="blank"
+                    variant="secondary"
                    size="medium"
-                    className="max-w-full animate-blur-in-slow border-none bg-primary-solid/1 px-3 py-1.5 hover:bg-primary-hover"
+                    className="max-w-full animate-[present_500ms_both] whitespace-normal"
                    style={{
-                        animationDelay: `${1000 + index * 100}ms`,
+                        animationDelay: `${800 + index * 100}ms`,
                    }}
                    onClick={() => chatController.postMessage({ message: question })}
                >
@@ -29,7 +29,7 @@ export function AIChatToolConfirmations(props: {
    );

    return (
-        <div className="flex w-full flex-wrap justify-end gap-2 empty:hidden">
+        <div className="flex w-full flex-wrap justify-end gap-2">
            {chat.pendingTools.map((tool, index) => (
                <div
                    className="flex w-full animate-present-slow flex-col gap-1"
@@ -43,7 +43,7 @@ export function AIChatToolConfirmations(props: {
                        tabIndex={index}
                        label={tool.label}
                        className="w-full justify-center"
-                        size={index === 0 ? 'large' : 'medium'}
+                        size={index === 0 ? 'default' : 'medium'}
                        variant={index === 0 ? 'primary' : 'secondary'}
                        icon={tool.icon}
                    />
@@ -24,9 +24,7 @@ export function AIResponseFeedback(props: {
    };

    return (
-        <div
-            className={tcls('flex h-fit animate-[heightIn_.5s_ease_both] items-center', className)}
-        >
+        <div className={tcls('flex h-fit items-center', className)}>
            <Button
                icon="thumbs-up"
                iconOnly
@@ -37,7 +35,7 @@ export function AIResponseFeedback(props: {
                    rating !== null && rating !== 1 && 'px-0 text-[0rem] opacity-0'
                )}
                size="medium"
-                style={{ animationDelay: '.5s', animationDuration: '.5s' }}
+                style={{ animationDuration: '.5s' }}
                onClick={() => handleRating(1)}
                disabled={rating !== null}
                active={rating === 1}
@@ -53,7 +51,7 @@ export function AIResponseFeedback(props: {
                    rating !== null && rating !== -1 && 'px-0 text-[0rem] opacity-0'
                )}
                size="medium"
-                style={{ animationDelay: '.7s', animationDuration: '.5s' }}
+                style={{ animationDelay: '.2s', animationDuration: '.5s' }}
                onClick={() => handleRating(-1)}
                disabled={rating !== null}
                active={rating === -1}
@@ -61,8 +59,8 @@ export function AIResponseFeedback(props: {
            />
            {rating !== null ? (
                <span
-                    className="ml-2 animate-blur-in-slow text-tint-subtle"
-                    style={{ animationDelay: '.5s' }}
+                    className="ml-2 animate-fade-in-slow text-tint-subtle"
+                    style={{ animationDelay: '.3s' }}
                >
                    {t(language, 'was_this_helpful_thank_you')}
                </span>
@@ -15,28 +15,22 @@ export function AIChatFollowupSuggestions(props: {
    }

    return (
-        <div className="flex grow flex-col">
-            <div
-                className="sticky bottom-0 mt-auto flex flex-col items-start gap-2"
-                data-testid="ai-chat-followup-suggestions"
-            >
-                {chat.followUpSuggestions.map((suggestion, index) => (
-                    <Button
-                        data-testid="ai-chat-followup-suggestion"
-                        key={index}
-                        onClick={() => {
-                            chatController.postMessage({ message: suggestion });
-                        }}
-                        label={suggestion}
-                        className="starting:h-0 max-w-full origin-left animate-blur-in-slow whitespace-normal border-none bg-primary-11/1 px-3 py-1.5 starting:py-0 text-left transition-all transition-discrete duration-500 *:whitespace-normal hover:bg-primary-hover"
-                        size="medium"
-                        variant="blank"
-                        style={{
-                            animationDelay: `${250 + Math.min(index * 50, 150)}ms`,
-                        }}
-                    />
-                ))}
-            </div>
+        <div className="mt-auto flex w-full flex-wrap justify-end gap-2">
+            {chat.followUpSuggestions.map((suggestion, index) => (
+                <Button
+                    key={index}
+                    onClick={() => {
+                        chatController.postMessage({ message: suggestion });
+                    }}
+                    label={suggestion}
+                    className="whitespace-normal! max-w-full animate-[present_500ms_both] text-left ring-1 ring-tint-subtle"
+                    size="medium"
+                    variant="blank"
+                    style={{
+                        animationDelay: `${250 + Math.min(index * 50, 150)}ms`,
+                    }}
+                />
+            ))}
        </div>
    );
 }
@@ -167,10 +167,10 @@ function ChangeRequestToolbar(props: ToolbarViewProps) {
                    icon="comment"
                />

-                {/* Open published/live site */}
+                {/* Open production site */}
                {site.urls.published ? (
                    <ToolbarButton
-                        title="Open live site"
+                        title="Open production site"
                        href={getToolbarHref({
                            href: site.urls.published,
                            siteId: site.id,
@@ -249,7 +249,7 @@ function RevisionToolbar(props: ToolbarViewProps) {
                />
                {site.urls.published ? (
                    <ToolbarButton
-                        title="Open live site"
+                        title="Open production site"
                        href={getToolbarHref({
                            href: site.urls.published,
                            siteId: site.id,
@@ -35,7 +35,6 @@ export function HideToolbarButton(props: HideToolbarButtonProps) {
        }
        setOpen(false);
    };
-    // @ts-expect-error wrong type for ref
    useOnClickOutside(ref, handleClickOutsideArcMenu);

    // Close arc menu on scroll
@@ -6,7 +6,7 @@ import {
    useReducedMotion,
    useSpring,
 } from 'motion/react';
-import React, { isValidElement } from 'react';
+import React from 'react';
 import { AnimatedLogo } from './AnimatedLogo';
 import { useToolbarControls } from './ToolbarControlsContext';

@@ -291,10 +291,6 @@ function ToolbarButtonWrapper(props: {
        x: springX,
    };

-    if (!isValidElement<{ motionValues: typeof motionValues }>(child)) {
-        return null;
-    }
-
    return React.cloneElement(child, {
        motionValues,
    });
@@ -136,7 +136,7 @@ const calculateSpacing = (

 export function useMagnificationEffect(props: {
    childrenCount: number;
-    containerRef: React.RefObject<HTMLElement | null>;
+    containerRef: React.RefObject<HTMLElement>;
    config?: MagnificationConfig;
 }) {
    const { childrenCount, containerRef, config } = props;
@@ -90,6 +90,7 @@ export function AnnouncementBanner(props: {
                            icon="close"
                            label={tString(language, 'close')}
                            variant="blank"
+                            size="default"
                            onClick={dismissAnnouncement}
                            className={`absolute top-0 right-4 mt-2 mr-2 circular-corners:rounded-lg rounded-sm straight-corners:rounded-none p-1.5 transition-all hover:ring-1 sm:right-6 md:right-8 ${style.close}`}
                        />
@@ -61,11 +61,10 @@ export function CookiesToast(props: { privacyPolicy?: string }) {
                'lg:chat-open:mr-80',
                'xl:chat-open:mr-100',
                'transition-all',
-                'duration-300',
-                'text-sm'
+                'duration-300'
            )}
        >
-            <p id={describedById}>
+            <p id={describedById} className={tcls('text-sm')}>
                {t(
                    language,
                    'cookies_prompt',
@@ -82,10 +81,10 @@ export function CookiesToast(props: { privacyPolicy?: string }) {
                onClick={() => setShow(false)}
                className={tcls('absolute', 'top-2', 'right-2', 'hover:bg-tint-hover')}
            />
-            <div className="mt-3 flex flex-row gap-2 text-xs">
+            <div className={tcls('mt-3', 'flex', 'flex-row', 'gap-2')}>
                <Button
                    variant="primary"
-                    size="medium"
+                    size="small"
                    aria-label={tString(language, 'cookies_accept')}
                    onClick={() => {
                        onUpdateState(true);
@@ -94,7 +93,7 @@ export function CookiesToast(props: { privacyPolicy?: string }) {
                />
                <Button
                    variant="secondary"
-                    size="medium"
+                    size="small"
                    aria-label={tString(language, 'cookies_reject')}
                    onClick={() => {
                        onUpdateState(false);
@@ -27,7 +27,7 @@ export function Annotation(props: InlineProps<DocumentInlineAnnotation>) {
                    ancestorBlocks={[]}
                    context={context}
                    nodes={fragment.nodes}
-                    style={['contents']}
+                    style={['space-y-4']}
                />
            }
        >
@@ -1,30 +1,84 @@
 'use client';

+import * as Popover from '@radix-ui/react-popover';
 import type React from 'react';

-import { Tooltip } from '@/components/primitives';
+import { tString, useLanguage } from '@/intl/client';
+import { tcls } from '@/lib/tailwind';

 export function AnnotationPopover(props: { children: React.ReactNode; body: React.ReactNode }) {
    const { children, body } = props;
+    const language = useLanguage();

    return (
-        <Tooltip
-            label={body}
-            contentProps={{
-                role: 'definition',
-            }}
-            className="bg-tint-base px-4 py-3 text-sm text-tint-strong shadow-lg shadow-tint-12/4 ring-1 ring-tint-subtle dark:shadow-tint-1"
-            arrow={true}
-            arrowProps={{ className: 'fill-tint-1' }}
-        >
-            <dfn
-                data-testid="annotation-button"
-                className="cursor-help underline decoration-1 decoration-dotted underline-offset-2"
-                // biome-ignore lint/a11y/noNoninteractiveTabindex: we want to be able to focus the definition to open the tooltip
-                tabIndex={0}
-            >
-                {children}
-            </dfn>
-        </Tooltip>
+        <Popover.Root>
+            <Popover.Trigger asChild>
+                <button
+                    data-testid="annotation-button"
+                    aria-label={tString(language, 'annotation_button_label')}
+                    className={tcls(
+                        'decoration-dotted',
+                        'decoration-1',
+                        'underline',
+                        'underline-offset-2'
+                    )}
+                >
+                    {children}
+                </button>
+            </Popover.Trigger>
+            <Popover.Portal>
+                <Popover.Content
+                    className={tcls(
+                        'text-sm',
+                        'max-w-[280px]',
+                        'bg-tint',
+                        'ring-1',
+                        'ring-tint',
+                        'rounded-sm',
+                        'shadow-1xs',
+                        'shadow-tint-12/1',
+                        'dark:shadow-tint-1/2',
+                        'p-3',
+                        '[&_p]:leading-snug',
+                        '-outline-offset-2',
+                        'outline-2',
+                        'outline-primary/8',
+                        'z-20'
+                    )}
+                    sideOffset={4}
+                >
+                    {body}
+                    <Popover.Arrow asChild>
+                        <svg
+                            viewBox="0 0 8 5"
+                            className={tcls(
+                                'relative',
+                                'z-2',
+                                'fill-tint-3', // Same as bg-tint
+                                'stroke-tint-7', // Same as ring-tint
+                                '[paint-order:stroke_fill]'
+                            )}
+                            fill="none"
+                            xmlns="http://www.w3.org/2000/svg"
+                        >
+                            <g clip-path="url(#clipAnnotation)">
+                                <path
+                                    d="M0 0L4 4L8 0"
+                                    strokeWidth="2"
+                                    strokeLinecap="round"
+                                    stroke="inherit"
+                                    fill="inherit"
+                                />
+                            </g>
+                            <defs>
+                                <clipPath id="clipAnnotation">
+                                    <rect width="8" height="5" fill="white" />
+                                </clipPath>
+                            </defs>
+                        </svg>
+                    </Popover.Arrow>
+                </Popover.Content>
+            </Popover.Portal>
+        </Popover.Root>
    );
 }
@@ -6,7 +6,6 @@ import {
    SkeletonImage,
    SkeletonParagraph,
    SkeletonSmall,
-    SkeletonUpdate,
 } from '@/components/primitives';
 import type { ClassValue } from '@/lib/tailwind';

@@ -35,8 +34,6 @@ import { Stepper } from './Stepper';
 import { StepperStep } from './StepperStep';
 import { Table } from './Table';
 import { Tabs } from './Tabs';
-import { Update } from './Update';
-import { Updates } from './Updates';

 export interface BlockProps<Block extends DocumentBlock> extends DocumentContextProps {
    block: Block;
@@ -108,10 +105,6 @@ export function Block<T extends DocumentBlock>(props: BlockProps<T>) {
                return <Stepper {...props} block={block} />;
            case 'stepper-step':
                return <StepperStep {...props} block={block} />;
-            case 'updates':
-                return <Updates {...props} block={block} />;
-            case 'update':
-                return <Update {...props} block={block} />;
            case 'if':
                // If block should be processed by the API.
                return null;
@@ -172,13 +165,10 @@ export function BlockSkeleton(props: { block: DocumentBlock; style: ClassValue }
        case 'images':
        case 'drawing':
            return <SkeletonImage id={id} style={style} />;
-        case 'updates':
-            return <SkeletonUpdate id={id} style={style} />;
        case 'image':
        case 'code-line':
        case 'tabs-item':
        case 'column':
-        case 'update':
            throw new Error(`Blocks (${block.type}) should be directly rendered by parent`);
        default:
            return nullIfNever(block);
@@ -1,18 +1,9 @@
-import {
-    type ContentRef,
-    type DocumentBlockContentRef,
-    SiteInsightsLinkPosition,
-} from '@gitbook/api';
+import { type DocumentBlockContentRef, SiteInsightsLinkPosition } from '@gitbook/api';

-import { Card, type CardProps } from '@/components/primitives';
-import {
-    type ResolvedContentRef,
-    resolveContentRef,
-    resolveContentRefFallback,
-} from '@/lib/references';
+import { Card } from '@/components/primitives';
+import { type ResolvedContentRef, resolveContentRef } from '@/lib/references';

 import type { BlockProps } from './Block';
-import { NotFoundRefHoverCard } from './NotFoundRefHoverCard';

 export async function BlockContentRef(props: BlockProps<DocumentBlockContentRef>) {
    const { block, context, style } = props;
@@ -25,45 +16,51 @@ export async function BlockContentRef(props: BlockProps<DocumentBlockContentRef>
        : null;

    if (!resolved) {
-        const fallback = resolveContentRefFallback(block.data.ref);
-        if (!fallback) {
-            return null;
-        }
-        return (
-            <NotFoundRefHoverCard context={context}>
-                <BlockContentRefCard
-                    contentRef={block.data.ref}
-                    resolved={fallback}
-                    style={style}
-                />
-            </NotFoundRefHoverCard>
-        );
+        return null;
    }

-    return <BlockContentRefCard contentRef={block.data.ref} resolved={resolved} style={style} />;
-}
+    const isContentInOtherSpace =
+        context.contentContext?.space &&
+        'space' in block.data.ref &&
+        context.contentContext.space.id !== block.data.ref.space;
+    const kind = block?.data?.ref?.kind;
+    if ((resolved.active && kind === 'space') || isContentInOtherSpace) {
+        return <SpaceRefCard {...props} resolved={resolved} />;
+    }

-function BlockContentRefCard(
-    props: {
-        resolved: ResolvedContentRef;
-        contentRef: ContentRef;
-    } & Omit<CardProps, 'href' | 'title'>
-) {
-    const { ref, resolved, contentRef, ...rest } = props;
    return (
        <Card
-            ref={ref}
            leadingIcon={resolved.icon ? resolved.icon : null}
            href={resolved.href}
            title={resolved.text}
+            style={style}
            insights={{
                type: 'link_click',
                link: {
-                    target: contentRef,
+                    target: block.data.ref,
                    position: SiteInsightsLinkPosition.Content,
                },
            }}
-            {...rest}
+        />
+    );
+}
+
+async function SpaceRefCard(
+    props: { resolved: ResolvedContentRef } & BlockProps<DocumentBlockContentRef>
+) {
+    const { context, style, resolved } = props;
+    const spaceId = context.contentContext?.space.id;
+
+    if (!spaceId) {
+        return null;
+    }
+
+    return (
+        <Card
+            href={resolved.href}
+            title={resolved.text}
+            postTitle={resolved.subText}
+            style={style}
        />
    );
 }
@@ -51,13 +51,11 @@ type UnwrappedBlocksProps<TBlock extends DocumentBlock> = DocumentContextProps &
 * Ideally we'd rely on the block type to determine if it can be full width, but
 * the block's `fullWidth` property does not differentiate between `undefined` and `false`.
 * So instead we hardcode a list of blocks that can be full width. */
-const FULL_WIDTH_BLOCKS: DocumentBlock['type'][] = [
+const FULL_WIDTH_BLOCKS = [
    'table',
    'tabs',
    'integration',
-    'openapi-operation',
-    'openapi-schemas',
-    'openapi-webhook',
+    'openapi',
    'images',
    'embed',
    'columns',
@@ -66,8 +64,6 @@ const FULL_WIDTH_BLOCKS: DocumentBlock['type'][] = [
    'hint',
 ];

-const LIST_BLOCKS: DocumentBlock['type'][] = ['list-ordered', 'list-tasks', 'list-unordered'];
-
 /**
 * Renders a list of blocks without a wrapper element.
 */
@@ -89,11 +85,10 @@ export function UnwrappedBlocks<TBlock extends DocumentBlock>(props: UnwrappedBl
                key={node.key || `${node.type}-${index}`}
                block={node}
                style={[
-                    'mx-auto page-width-wide:mx-0 w-full decoration-primary/6',
+                    'mx-auto page-width-wide:mx-0 w-full decoration-primary/6 print:break-inside-avoid',
                    node.data && 'fullWidth' in node.data && node.data.fullWidth
                        ? 'max-w-screen-xl'
                        : 'max-w-3xl',
-                    !LIST_BLOCKS.includes(node.type) && 'print:break-inside-avoid',
                    FULL_WIDTH_BLOCKS.includes(node.type) && 'page-width-wide:max-w-full',
                    blockStyle,
                ]}
@@ -1,14 +1,11 @@
 'use client';

 import type { DocumentBlockCode } from '@gitbook/api';
-import { useEffect, useId, useMemo, useRef, useState } from 'react';
+import { useEffect, useMemo, useRef, useState } from 'react';

 import { useAdaptiveVisitor } from '@/components/Adaptive';
 import { useInViewportListener } from '@/components/hooks/useInViewportListener';
 import { useScrollListener } from '@/components/hooks/useScrollListener';
-import { Button } from '@/components/primitives';
-import { t, useLanguage } from '@/intl/client';
-import { tcls } from '@/lib/tailwind';
 import { useDebounceCallback } from 'usehooks-ts';
 import type { BlockProps } from '../Block';
 import { type InlineExpressionVariables, useEvaluateInlineExpression } from '../InlineExpression';
@@ -19,17 +16,14 @@ import { plainHighlight } from './plain-highlight';
 type ClientBlockProps = Pick<BlockProps<DocumentBlockCode>, 'block' | 'style'> & {
    inlines: RenderedInline[];
    inlineExprVariables: InlineExpressionVariables;
-    mode: BlockProps<DocumentBlockCode>['context']['mode'];
 };

-export const CODE_BLOCK_DEFAULT_COLLAPSED_LINE_COUNT = 10;
-
 /**
 * Render a code-block client-side by loading the highlighter asynchronously.
 * It allows us to defer some load to avoid blocking the rendering of the whole page with block highlighting.
 */
 export function ClientCodeBlock(props: ClientBlockProps) {
-    const { block, mode, style, inlines, inlineExprVariables } = props;
+    const { block, style, inlines, inlineExprVariables } = props;
    const blockRef = useRef<HTMLDivElement>(null);
    const isInViewportRef = useRef(false);
    const [isInViewport, setIsInViewport] = useState(false);
@@ -119,84 +113,13 @@ export function ClientCodeBlock(props: ClientBlockProps) {
        setLines(null);
    }, [isInViewport, block, inlines, evaluateInlineExpression]);

-    const expandable = block.data.expandable;
-
-    const numberOfLinesOfCode = lines?.length ?? plainLines.length;
-    const collapsedLineCount =
-        block.data.collapsedLineCount || CODE_BLOCK_DEFAULT_COLLAPSED_LINE_COUNT;
-    const isExpandable = Boolean(
-        expandable && mode !== 'print' && numberOfLinesOfCode > collapsedLineCount
-    );
-
-    const codeBlockBodyId = useId();
-
-    const renderer = (
+    return (
        <CodeBlockRenderer
            ref={blockRef}
            aria-busy={highlighting}
            block={block}
            style={style}
            lines={lines ?? plainLines}
-            id={codeBlockBodyId}
        />
    );
-
-    return isExpandable ? (
-        <CodeBlockExpandable
-            lines={lines ?? plainLines}
-            controls={codeBlockBodyId}
-            collapsedLineCount={collapsedLineCount}
-        >
-            {renderer}
-        </CodeBlockExpandable>
-    ) : (
-        renderer
-    );
-}
-
-function CodeBlockExpandable(props: {
-    children: React.ReactNode;
-    lines: HighlightLine[];
-    collapsedLineCount: number;
-    controls?: string;
-}) {
-    const { children, controls, lines = [], collapsedLineCount } = props;
-    const [isExpanded, setIsExpanded] = useState(false);
-    const language = useLanguage();
-    return (
-        <div className="group/codeblock-expandable relative">
-            <div
-                className={tcls(
-                    isExpanded
-                        ? '[&_pre]:after:opacity-0'
-                        : '[&_pre]:h-[calc(2rem+var(--line-count)*var(--line-height))] [&_pre]:overflow-y-hidden [&_pre]:after:opacity-100',
-                    '[&_pre]:after:pointer-events-none [&_pre]:after:absolute [&_pre]:after:inset-0 [&_pre]:after:z-1 [&_pre]:after:bg-gradient-to-t [&_pre]:after:from-0% [&_pre]:after:from-tint-2 [&_pre]:after:to-70% [&_pre]:after:to-transparent [&_pre]:after:content-[""]'
-                )}
-                style={
-                    {
-                        '--line-count': collapsedLineCount,
-                        '--line-height': '1.25rem',
-                    } as React.CSSProperties
-                }
-            >
-                {children}
-            </div>
-            <div className="pointer-events-none absolute bottom-0 flex w-full justify-center">
-                <Button
-                    icon={isExpanded ? 'chevron-up' : 'chevron-down'}
-                    size="xsmall"
-                    variant="blank"
-                    type="button"
-                    onClick={() => setIsExpanded(!isExpanded)}
-                    className="pointer-events-auto z-1 my-2 text-primary text-sm opacity-0 focus:opacity-11 group-hover/codeblock-expandable:opacity-11"
-                    aria-expanded={isExpanded}
-                    aria-controls={controls}
-                >
-                    {isExpanded
-                        ? t(language, 'code_block_expanded')
-                        : t(language, 'code_block_collapsed', lines.length)}
-                </Button>
-            </div>
-        </div>
-    );
 }
@@ -50,7 +50,7 @@ export async function CodeBlock(props: BlockProps<DocumentBlockCode>) {
            return { inline, body };
        });

-    if (!isEstimatedOffscreen && !hasInlineExpression && !block.data.expandable) {
+    if (!isEstimatedOffscreen && !hasInlineExpression) {
        // In v2, we render the code block server-side
        const lines = await highlight(block, richInlines);
        return <CodeBlockRenderer block={block} style={style} lines={lines} />;
@@ -73,7 +73,6 @@ export async function CodeBlock(props: BlockProps<DocumentBlockCode>) {
                style={style}
                inlines={richInlines}
                inlineExprVariables={variables}
-                mode={context.mode}
            />
        </React.Suspense>
    );
@@ -12,7 +12,6 @@ import type { HighlightLine, HighlightToken } from './highlight';
 type CodeBlockRendererProps = Pick<BlockProps<DocumentBlockCode>, 'block' | 'style'> & {
    lines: HighlightLine[];
    'aria-busy'?: boolean;
-    id?: string;
 };

 /**
@@ -24,12 +23,11 @@ export const CodeBlockRenderer = forwardRef(function CodeBlockRenderer(
 ) {
    const { block, style, lines, 'aria-busy': ariaBusy } = props;

+    const id = useId();
    const withLineNumbers = Boolean(block.data.lineNumbers) && block.nodes.length > 1;
    const withWrap = block.data.overflow === 'wrap';
    const title = block.data.title;

-    const id = useId();
-    const codeId = props.id || id;
    return (
        <div
            ref={ref}
@@ -44,7 +42,7 @@ export const CodeBlockRenderer = forwardRef(function CodeBlockRenderer(
                ) : null}
            </div>
            <CopyCodeButton
-                codeId={codeId}
+                codeId={id}
                style="z-2 mt-2 mr-2 self-start justify-self-end leading-none opacity-0 backdrop-blur-md [grid-area:2/1] group-hover/codeblock:opacity-11"
            />
            <pre
@@ -55,7 +53,7 @@ export const CodeBlockRenderer = forwardRef(function CodeBlockRenderer(
                )}
            >
                <code
-                    id={codeId}
+                    id={id}
                    className={tcls(
                        'inline-grid min-w-full grid-cols-[auto_1fr] [count-reset:line] print:whitespace-pre-wrap',
                        withWrap && 'whitespace-pre-wrap'
@@ -80,7 +80,6 @@ export function Column(props: {
        <div
            className={tcls(
                'flex flex-col',
-                '@container/column',
                (verticalAlignment === VerticalAlignment.Top || !verticalAlignment) &&
                    'justify-start',
                verticalAlignment === VerticalAlignment.Middle && 'justify-center',
@@ -31,7 +31,6 @@ export async function Drawing(props: BlockProps<DocumentBlockDrawing>) {
                alt="Drawing"
                sizes={imageBlockSizes}
                zoom
-                loading="lazy"
            />
        </Caption>
    );
@@ -60,7 +60,6 @@ export async function Embed(props: BlockProps<gitbookAPI.DocumentBlockEmbed>) {
                                sources={{ light: { src: embed.icon } }}
                                sizes={[{ width: 20 }]}
                                resize={context.contentContext.imageResizer}
-                                loading="lazy"
                            />
                        ) : null
                    }
@@ -17,34 +17,29 @@ export function Details(props: {
 }) {
    const { children, id, className } = props;

-    const ref = React.useRef<HTMLDetailsElement>(null);
+    const detailsRef = React.useRef<HTMLDetailsElement>(null);

    const [openFromHash, setOpenFromHash] = React.useState(false);

    const hash = useHash();
-
    /**
     * Open the details element if the url hash refers to the id of the details element
     * or the id of some element contained within the details element.
     */
    React.useEffect(() => {
-        if (!hash || !ref.current) {
+        if (!hash || !detailsRef.current) {
            return;
        }
-
        if (hash === id) {
            setOpenFromHash(true);
-            return;
        }
-
        const activeElement = document.getElementById(hash);
-        const isOpen = Boolean(activeElement && ref.current.contains(activeElement));
-        setOpenFromHash(isOpen);
+        setOpenFromHash(Boolean(activeElement && detailsRef.current?.contains(activeElement)));
    }, [hash, id]);

    return (
        <details
-            ref={ref}
+            ref={detailsRef}
            id={id}
            open={props.open || openFromHash}
            className={tcls(
@@ -51,7 +51,7 @@ export function Expandable(props: BlockProps<DocumentBlockExpandable>) {
                    className={tcls(
                        'inline-block',
                        'size-3',
-                        'mr-3',
+                        'mr-2',
                        'mb-1',
                        'transition-transform',
                        'shrink-0',
@@ -96,7 +96,7 @@ export function Expandable(props: BlockProps<DocumentBlockExpandable>) {
                document={document}
                ancestorBlocks={[...ancestorBlocks, block]}
                context={context}
-                style="space-y-4 px-10 pb-5"
+                style={['px-10', 'pb-5', 'space-y-4']}
            />
        </Details>
    );
@@ -1,12 +1,10 @@
 import { type DocumentBlockFile, SiteInsightsLinkPosition } from '@gitbook/api';

-import { t } from '@/intl/translate';
 import { getSimplifiedContentType } from '@/lib/files';
 import { resolveContentRef } from '@/lib/references';
+import { tcls } from '@/lib/tailwind';

-import { getSpaceLanguage } from '@/intl/server';
-import { Button, Link } from '../primitives';
-import { DownloadButton } from '../primitives/DownloadButton';
+import { Link } from '../primitives';
 import type { BlockProps } from './Block';
 import { Caption } from './Caption';
 import { FileIcon } from './FileIcon';
@@ -14,70 +12,67 @@ import { FileIcon } from './FileIcon';
 export async function File(props: BlockProps<DocumentBlockFile>) {
    const { block, context } = props;

-    if (!context.contentContext) {
-        return null;
-    }
-
-    const contentRef = await resolveContentRef(block.data.ref, context.contentContext);
+    const contentRef = context.contentContext
+        ? await resolveContentRef(block.data.ref, context.contentContext)
+        : null;
    const file = contentRef?.file;

    if (!file) {
        return null;
    }

-    const language = getSpaceLanguage(context.contentContext);
    const contentType = getSimplifiedContentType(file.contentType);
-    const insights = {
-        type: 'link_click' as const,
-        link: {
-            target: block.data.ref,
-            position: SiteInsightsLinkPosition.Content,
-        },
-    };

    return (
        <Caption {...props} withBorder>
-            <div className="flex flex-wrap items-center gap-5 px-5 py-3">
-                <div className="flex min-w-14 flex-col items-center gap-1 border-tint-subtle border-r pr-5">
-                    <FileIcon contentType={contentType} className="size-5 text-primary" />
-                    <div className="text-hint text-xs">{getHumanFileSize(file.size)}</div>
-                </div>
-                <div className="min-w-24 flex-1">
-                    <div className="text-base">
-                        <Link
-                            href={file.downloadURL}
-                            target="_blank"
-                            insights={insights}
-                            className="hover:underline"
-                        >
-                            {file.name}
-                        </Link>
+            <Link
+                href={file.downloadURL}
+                download={file.name}
+                insights={{
+                    type: 'link_click',
+                    link: {
+                        target: block.data.ref,
+                        position: SiteInsightsLinkPosition.Content,
+                    },
+                }}
+                className={tcls('group/file', 'flex', 'flex-row', 'items-center', 'px-5', 'py-3')}
+            >
+                <div
+                    className={tcls(
+                        'min-w-14',
+                        'mr-5',
+                        'pr-5',
+                        'flex',
+                        'flex-col',
+                        'items-center',
+                        'gap-1',
+                        'border-r',
+                        'border-tint-subtle'
+                    )}
+                >
+                    <div>
+                        <FileIcon
+                            contentType={contentType}
+                            className={tcls('size-5', 'text-primary')}
+                        />
                    </div>
-                    <div className="text-sm opacity-9 dark:opacity-8">{contentType}</div>
-                </div>
-                <div className="flex shrink-0 flex-wrap gap-2">
-                    <DownloadButton
-                        icon="download"
-                        size="xsmall"
-                        variant="secondary"
-                        downloadUrl={file.downloadURL}
-                        filename={file.name}
-                        insights={insights}
+                    <div
+                        className={tcls(
+                            'text-xs',
+                            'text-tint',
+                            'group-hover/file:text-tint-strong'
+                        )}
                    >
-                        {t(language, 'download')}
-                    </DownloadButton>
-                    <Button
-                        icon="arrow-up-right-from-square"
-                        size="xsmall"
-                        variant="secondary"
-                        href={file.downloadURL}
-                        target="_blank"
-                        insights={insights}
-                    >
-                        {t(language, 'open')}
-                    </Button>
+                        {getHumanFileSize(file.size)}
+                    </div>
                </div>
-            </div>
+                <div>
+                    <div className={tcls('text-base')}>{file.name}</div>
+                    <div className={tcls('text-sm', 'opacity-9', 'dark:opacity-8')}>
+                        {contentType}
+                    </div>
+                </div>
+            </Link>
        </Caption>
    );
 }
@@ -9,7 +9,7 @@ export function FileIcon(props: { contentType: SimplifiedFileType | null; classN
    const { contentType, className } = props;

    switch (contentType) {
-        case 'PDF':
+        case 'pdf':
            return <Icon icon="file-pdf" className={className} />;
        case 'image':
            return <Icon icon="file-image" className={className} />;
@@ -1,7 +1,6 @@
 import { type ClassValue, tcls } from '@/lib/tailwind';
 import type { DocumentBlockHeading, DocumentBlockTabs } from '@gitbook/api';
 import { Icon } from '@gitbook/icons';
-import { Link } from '../primitives';
 import { getBlockTextStyle } from './spacing';

 /**
@@ -29,8 +28,6 @@ export function HashLinkButton(props: {
                'h-[1em]',
                'border-0',
                'opacity-0',
-                'site-background',
-                'rounded',
                'group-hover/hash:opacity-[0]',
                'group-focus/hash:opacity-[0]',
                'md:group-hover/hash:opacity-[1]',
@@ -38,10 +35,10 @@ export function HashLinkButton(props: {
                className
            )}
        >
-            <Link
+            <a
                href={`#${id}`}
                aria-label={label}
-                className={tcls('inline-flex h-full items-start', textStyle.lineHeight)}
+                className={tcls('inline-flex', 'h-full', 'items-start', textStyle.lineHeight)}
            >
                <Icon
                    icon="hashtag"
@@ -55,7 +52,7 @@ export function HashLinkButton(props: {
                        iconClassName
                    )}
                />
-            </Link>
+            </a>
        </div>
    );
 }
@@ -36,10 +36,7 @@ export function Heading(props: BlockProps<DocumentBlockHeading>) {
            <HashLinkButton
                id={id}
                block={block}
-                className={tcls(
-                    '-ml-6 pr-2',
-                    '[.flip-heading-hash_&]:order-last [.flip-heading-hash_&]:ml-1 [.flip-heading-hash_&]:pl-2'
-                )}
+                className={tcls('-ml-6', 'pr-2')}
                iconClassName={tcls('size-4')}
                label="Direct link to heading"
            />
@@ -5,7 +5,6 @@ import { type ClassValue, tcls } from '@/lib/tailwind';

 import { getSpaceLanguage, tString } from '@/intl/server';
 import { languages } from '@/intl/translations';
-import { isHeadingBlock } from '@/lib/document';
 import { Block, type BlockProps } from './Block';
 import { Blocks } from './Blocks';
 import { getBlockTextStyle } from './spacing';
@@ -19,7 +18,7 @@ export function Hint({
    const hintStyle = HINT_STYLES[block.data.style] ?? HINT_STYLES.info;
    const firstNode = block.nodes[0]!;
    const firstLine = getBlockTextStyle(firstNode);
-    const hasHeading = isHeadingBlock(firstNode);
+    const hasHeading = ['heading-1', 'heading-2', 'heading-3'].includes(firstNode.type);

    const language = contextProps.context.contentContext
        ? getSpaceLanguage(contextProps.context.contentContext)
@@ -32,9 +31,10 @@ export function Hint({
            className={tcls(
                'hint',
                'transition-colors',
-                'rounded-corners:rounded-md',
+                'rounded-md',
+                hasHeading ? 'rounded-l-sm' : null,
+                'straight-corners:rounded-none',
                'circular-corners:rounded-xl',
-                hasHeading ? 'circular-corners:rounded-l-none rounded-corners:rounded-l-none' : '',
                'overflow-hidden',
                hasHeading ? ['border-l-2', hintStyle.containerWithHeader] : hintStyle.container,

@@ -65,9 +65,9 @@ export function Hint({
            {hasHeading ? (
                <Block
                    style={tcls(
-                        'w-full items-start py-4! pl-3 text-[1em]! *:flex-none',
+                        'w-full items-start py-4! pl-3 text-[1em] *:flex-none',
                        // Heading hash styles
-                        'flip-heading-hash pr-8 [&_.hash]:bg-transparent',
+                        'flip-heading-hash pr-8',
                        hintStyle.header
                    )}
                    ancestorBlocks={[...ancestorBlocks, block]}
@@ -19,42 +19,34 @@ export function Images(props: BlockProps<DocumentBlockImages>) {
            className={tcls(
                style,
                'flex',
-                'w-full',
+                'flex-row',
+                'gap-3',
                align === 'center' && 'justify-center',
                align === 'right' && 'justify-end',
-                align === 'left' && 'justify-start'
+                align === 'left' && 'justify-start',
+                hasMultipleImages && ['grid', 'grid-flow-col'],
+                withFrame && [
+                    'rounded-2xl',
+                    'border',
+                    'border-[rgb(234,235,238)]',
+                    'dark:border-[rgb(45,50,58)]',
+                    'relative',
+                    'overflow-hidden',
+                ]
            )}
        >
-            <div
-                className={tcls(
-                    'flex',
-                    'flex-row',
-                    'gap-3',
-                    hasMultipleImages && ['grid', 'grid-flow-col'],
-                    withFrame && [
-                        'rounded-2xl',
-                        'border',
-                        'border-[rgb(234,235,238)]',
-                        'dark:border-[rgb(45,50,58)]',
-                        'relative',
-                        'overflow-hidden',
-                        'w-fit',
-                    ]
-                )}
-            >
-                {block.nodes.map((node: any, _i: number) => (
-                    <ImageBlock
-                        key={node.key}
-                        block={node}
-                        document={document}
-                        style={[]}
-                        siblings={block.nodes.length}
-                        context={context}
-                        isEstimatedOffscreen={isEstimatedOffscreen}
-                        withFrame={withFrame}
-                    />
-                ))}
-            </div>
+            {block.nodes.map((node: any, _i: number) => (
+                <ImageBlock
+                    key={node.key}
+                    block={node}
+                    document={document}
+                    style={[]}
+                    siblings={block.nodes.length}
+                    context={context}
+                    isEstimatedOffscreen={isEstimatedOffscreen}
+                    withFrame={withFrame}
+                />
+            ))}
        </div>
    );
 }
@@ -143,7 +135,8 @@ async function ImageBlock(props: {
                              }
                            : null,
                    }}
-                    loading={isEstimatedOffscreen ? 'lazy' : 'eager'}
+                    priority={isEstimatedOffscreen ? 'lazy' : 'high'}
+                    preload
                    zoom
                    inlineStyle={{
                        maxWidth: '100%',
@@ -1,75 +0,0 @@
-'use client';
-import { tString, useLanguage } from '@/intl/client';
-import { useAI, useAIChatController, useAIChatState } from '../AI';
-import { useSearch } from '../Search';
-import { Button, type ButtonProps, Input } from '../primitives';
-
-export function InlineActionButton(
-    props: { action: 'ask' | 'search'; query?: string } & { buttonProps: ButtonProps } // TODO: Type this properly: Pick<api.DocumentInlineButton, 'action' | 'query'> & { buttonProps: ButtonProps }
-) {
-    const { action, query, buttonProps } = props;
-
-    const { assistants } = useAI();
-    const chatController = useAIChatController();
-    const chatState = useAIChatState();
-    const [, setSearchState] = useSearch();
-    const language = useLanguage();
-
-    const handleSubmit = (value: string) => {
-        if (action === 'ask') {
-            chatController.open();
-            if (value ?? query) {
-                chatController.postMessage({ message: value ?? query });
-            }
-        } else if (action === 'search') {
-            setSearchState((prev) => ({
-                ...prev,
-                ask: null,
-                scope: 'default',
-                query: value ?? query,
-                open: true,
-            }));
-        }
-    };
-
-    const icon =
-        action === 'ask' && buttonProps.icon === 'gitbook-assistant' && assistants.length > 0
-            ? assistants[0]?.icon
-            : buttonProps.icon;
-
-    if (!query) {
-        return (
-            <Input
-                inline
-                label={buttonProps.label as string}
-                sizing="medium"
-                className="inline-flex max-w-full leading-normal [transition-property:translate,opacity,box-shadow,background,border]"
-                submitButton={{
-                    label: tString(language, action === 'ask' ? 'send' : 'search'),
-                }}
-                clearButton={{
-                    className: 'text-[1em]',
-                }}
-                maxLength={action === 'ask' ? 2048 : 512}
-                disabled={action === 'ask' && chatState.loading}
-                aria-busy={action === 'ask' && chatState.loading}
-                leading={icon}
-                keyboardShortcut={false}
-                onSubmit={(value) => handleSubmit(value as string)}
-                containerStyle={{
-                    width: `${buttonProps.label ? buttonProps.label.toString().length + 10 : 20}ch`,
-                }}
-            />
-        );
-    }
-
-    const label = action === 'ask' ? `Ask "${query}"` : `Search for "${query}"`;
-
-    const button = (
-        <Button {...buttonProps} onClick={() => handleSubmit(query)} label={label}>
-            {label !== buttonProps.label ? buttonProps.label : null}
-        </Button>
-    );
-
-    return button;
-}
@@ -1,84 +1,40 @@
-import { resolveContentRef, resolveContentRefFallback } from '@/lib/references';
+import { resolveContentRef } from '@/lib/references';
 import * as api from '@gitbook/api';
 import type { IconName } from '@gitbook/icons';
-import { Button, type ButtonProps } from '../primitives';
+import { Button } from '../primitives';
 import type { InlineProps } from './Inline';
-import { InlineActionButton } from './InlineActionButton';
-import { NotFoundRefHoverCard } from './NotFoundRefHoverCard';

-export function InlineButton(props: InlineProps<api.DocumentInlineButton>) {
-    const { inline } = props;
+export async function InlineButton(props: InlineProps<api.DocumentInlineButton>) {
+    const { inline, context } = props;

-    const buttonProps: ButtonProps = {
-        label: inline.data.label,
-        variant: inline.data.kind,
-        icon: inline.data.icon as IconName | undefined,
-        size: 'medium',
-        className: 'leading-normal',
-    };
-
-    const ButtonImplementation = () => {
-        if ('action' in inline.data && 'query' in inline.data.action) {
-            return (
-                <InlineActionButton
-                    action={inline.data.action.action}
-                    query={inline.data.action.query ?? ''}
-                    buttonProps={buttonProps}
-                />
-            );
-        }
-
-        if ('ref' in inline.data) {
-            return <InlineLinkButton {...props} buttonProps={buttonProps} />;
-        }
-
-        return <Button {...buttonProps} disabled />;
-    };
-
-    const inlineElement = (
-        // Set the leading to have some vertical space between adjacent buttons
-        <span className="inline-button leading-12 [&:has(+.inline-button)]:mr-2">
-            <ButtonImplementation />
-        </span>
-    );
-
-    return inlineElement;
-}
-
-export async function InlineLinkButton(
-    props: InlineProps<api.DocumentInlineButton> & { buttonProps: ButtonProps }
-) {
-    const { inline, context, buttonProps } = props;
-
-    if (!('ref' in inline.data)) return;
-
-    const resolved =
-        context.contentContext && inline.data.ref
-            ? await resolveContentRef(inline.data.ref, context.contentContext)
-            : null;
-
-    const href =
-        resolved?.href ??
-        (inline.data.ref ? resolveContentRefFallback(inline.data.ref)?.href : undefined);
-
-    const button = (
-        <Button
-            {...buttonProps}
-            insights={{
-                type: 'link_click',
-                link: {
-                    target: inline.data.ref,
-                    position: api.SiteInsightsLinkPosition.Content,
-                },
-            }}
-            href={href}
-            disabled={href === undefined}
-        />
-    );
-
-    if (inline.data.ref && !resolved) {
-        return <NotFoundRefHoverCard context={context}>{button}</NotFoundRefHoverCard>;
+    if (!context.contentContext) {
+        throw new Error('InlineButton requires a contentContext');
    }

-    return button;
+    const resolved = await resolveContentRef(inline.data.ref, context.contentContext);
+
+    if (!resolved) {
+        return null;
+    }
+
+    return (
+        // Set the leading to have some vertical space between adjacent buttons
+        <span className="inline-button leading-12 [&:has(+.inline-button)]:mr-2">
+            <Button
+                href={resolved.href}
+                label={inline.data.label}
+                // TODO: use a variant specifically for user-defined buttons.
+                variant={inline.data.kind}
+                className="leading-normal"
+                icon={inline.data.icon as IconName | undefined}
+                insights={{
+                    type: 'link_click',
+                    link: {
+                        target: inline.data.ref,
+                        position: api.SiteInsightsLinkPosition.Content,
+                    },
+                }}
+            />
+        </span>
+    );
 }
@@ -1,4 +1,4 @@
-import type { DocumentInlineIcon } from '@gitbook/api';
+import type { DocumentInlineIcon, DocumentMarkColor } from '@gitbook/api';

 import { tcls } from '@/lib/tailwind';
 import { Icon, type IconName } from '@gitbook/icons';
@@ -7,11 +7,16 @@ import { textColorToStyle } from './utils/colors';

 export async function InlineIcon(props: InlineProps<DocumentInlineIcon>) {
    const { inline } = props;
-    const { color, icon } = inline.data;
+    const icon = inline.data.icon as IconName;
+    // @ts-expect-error remove this comment once API is updated
+    const color = inline.data.color
+        ? // @ts-expect-error remove "as DocumentMarkColor['data']['text']" once API is updated
+          (inline.data.color as DocumentMarkColor['data']['text'])
+        : undefined;

    return (
        <Icon
-            icon={icon as IconName}
+            icon={icon}
            className={tcls('inline size-[1em]', color ? textColorToStyle[color] : null)}
        />
    );
@@ -49,7 +49,8 @@ export async function InlineImage(props: InlineProps<DocumentInlineImage>) {
                          }
                        : null,
                }}
-                loading="lazy"
+                priority="lazy"
+                preload
                style={[size === 'line' ? ['max-h-lh', 'h-lh', 'w-auto'] : null]}
                inline
                zoom={!isInLink}
@@ -1,17 +1,12 @@
-import { type ContentRef, type DocumentInlineLink, SiteInsightsLinkPosition } from '@gitbook/api';
+import { type DocumentInlineLink, SiteInsightsLinkPosition } from '@gitbook/api';

 import { getSpaceLanguage, tString } from '@/intl/server';
 import { type TranslationLanguage, languages } from '@/intl/translations';
-import {
-    type ResolvedContentRef,
-    resolveContentRef,
-    resolveContentRefFallback,
-} from '@/lib/references';
+import { type ResolvedContentRef, resolveContentRef } from '@/lib/references';
 import { Icon } from '@gitbook/icons';
-import { StyledLink } from '../../primitives';
+import { HoverCard, HoverCardRoot, HoverCardTrigger, StyledLink } from '../../primitives';
 import type { InlineProps } from '../Inline';
 import { Inlines } from '../Inlines';
-import { NotFoundRefHoverCard } from '../NotFoundRefHoverCard';
 import { InlineLinkTooltip } from './InlineLinkTooltip';

 export async function InlineLink(props: InlineProps<DocumentInlineLink>) {
@@ -23,75 +18,52 @@ export async function InlineLink(props: InlineProps<DocumentInlineLink>) {
              resolveAnchorText: false,
          })
        : null;
-
    const { contentContext } = context;

-    const inlinesElement = (
-        <Inlines
-            context={context}
-            document={document}
-            nodes={inline.nodes}
-            ancestorInlines={[...ancestorInlines, inline]}
-        />
-    );
+    const language = contentContext ? getSpaceLanguage(contentContext) : languages.en;

-    if (!resolved) {
-        const fallback = resolveContentRefFallback(inline.data.ref);
+    if (!contentContext || !resolved) {
        return (
-            <NotFoundRefHoverCard context={context}>
-                {fallback ? (
-                    <InlineLinkAnchor href={fallback.href} contentRef={inline.data.ref} isExternal>
-                        {inlinesElement}
-                    </InlineLinkAnchor>
-                ) : (
-                    <span className="cursor-not-allowed underline">{inlinesElement}</span>
-                )}
-            </NotFoundRefHoverCard>
+            <HoverCardRoot>
+                <HoverCardTrigger>
+                    <span className="cursor-not-allowed underline">
+                        <Inlines
+                            context={context}
+                            document={document}
+                            nodes={inline.nodes}
+                            ancestorInlines={[...ancestorInlines, inline]}
+                        />
+                    </span>
+                </HoverCardTrigger>
+                <HoverCard className="flex flex-col gap-1 p-4">
+                    <div className="flex items-center gap-2">
+                        <Icon icon="ban" className="size-4 text-tint-subtle" />
+                        <h5 className="font-semibold">{tString(language, 'notfound_title')}</h5>
+                    </div>
+                    <p className="text-sm text-tint">{tString(language, 'notfound_link')}</p>
+                </HoverCard>
+            </HoverCardRoot>
        );
    }
-    const anchorElement = (
-        <InlineLinkAnchor
-            href={resolved.href}
-            contentRef={inline.data.ref}
-            isExternal={inline.data.ref.kind === 'url'}
-        >
-            {inlinesElement}
-        </InlineLinkAnchor>
-    );
-
-    if (context.withLinkPreviews) {
-        const language = contentContext ? getSpaceLanguage(contentContext) : languages.en;
-
-        return (
-            <InlineLinkTooltipWrapper inline={inline} language={language} resolved={resolved}>
-                {anchorElement}
-            </InlineLinkTooltipWrapper>
-        );
-    }
-
-    return anchorElement;
-}
-
-function InlineLinkAnchor(props: {
-    href: string;
-    contentRef: ContentRef;
-    isExternal?: boolean;
-    children: React.ReactNode;
-}) {
-    const { href, isExternal, contentRef, children } = props;
-    const isMailto = href.startsWith('mailto:');
-    return (
+    const isExternal = inline.data.ref.kind === 'url';
+    const isMailto = resolved.href.startsWith('mailto:');
+    const content = (
        <StyledLink
-            href={href}
+            href={resolved.href}
            insights={{
                type: 'link_click',
                link: {
-                    target: contentRef,
+                    target: inline.data.ref,
                    position: SiteInsightsLinkPosition.Content,
                },
            }}
        >
-            {children}
+            <Inlines
+                context={context}
+                document={document}
+                nodes={inline.nodes}
+                ancestorInlines={[...ancestorInlines, inline]}
+            />
            {isMailto ? (
                <Icon
                    icon="envelope"
@@ -105,6 +77,16 @@ function InlineLinkAnchor(props: {
            ) : null}
        </StyledLink>
    );
+
+    if (context.withLinkPreviews) {
+        return (
+            <InlineLinkTooltipWrapper inline={inline} language={language} resolved={resolved}>
+                {content}
+            </InlineLinkTooltipWrapper>
+        );
+    }
+
+    return content;
 }

 /**
@@ -1,9 +1,37 @@
 'use client';
-import { tcls } from '@/lib/tailwind';
-import { Icon } from '@gitbook/icons';
-import { Fragment } from 'react';
-import { Button, HoverCard, HoverCardRoot, HoverCardTrigger, StyledLink } from '../../primitives';
+import dynamic from 'next/dynamic';
+import React from 'react';

+const LoadingValueContext = React.createContext<React.ReactNode>(null);
+
+// To avoid polluting the RSC payload with the tooltip implementation,
+// we lazily load it on the client side. This way, the tooltip is only loaded
+// when the user interacts with the link, and it doesn't block the initial render.
+
+const InlineLinkTooltipImpl = dynamic(
+    () => import('./InlineLinkTooltipImpl').then((mod) => mod.InlineLinkTooltipImpl),
+    {
+        // Disable server-side rendering for this component, it's only
+        // visible on user interaction.
+        ssr: false,
+        loading: () => {
+            // The fallback should be the children (the content of the link),
+            // but as next/dynamic is aiming for feature parity with React.lazy,
+            // it doesn't support passing children to the loading component.
+            // https://github.com/vercel/next.js/issues/7906
+            const children = React.useContext(LoadingValueContext);
+            return <>{children}</>;
+        },
+    }
+);
+
+/**
+ * Tooltip for inline links. It's lazily loaded to avoid blocking the initial render
+ * and polluting the RSC payload.
+ *
+ * The link text and href have already been rendered on the server for good SEO,
+ * so we can be as lazy as possible with the tooltip.
+ */
 export function InlineLinkTooltip(props: {
    isSamePage: boolean;
    isExternal: boolean;
@@ -17,79 +45,28 @@ export function InlineLinkTooltip(props: {
    openInNewTabLabel: string;
    children: React.ReactNode;
 }) {
-    const { isSamePage, isExternal, openInNewTabLabel, target, breadcrumbs, children } = props;
+    const { children, ...rest } = props;
+    const [shouldLoad, setShouldLoad] = React.useState(false);

-    return (
-        <HoverCardRoot>
-            <HoverCardTrigger>{children}</HoverCardTrigger>
-            <HoverCard className="p-4">
-                <div className="flex items-start gap-4">
-                    <div className="flex flex-col">
-                        {breadcrumbs && breadcrumbs.length > 0 ? (
-                            <div className="mb-1 flex grow flex-wrap items-center gap-x-2 gap-y-0.5 font-semibold text-tint text-xs uppercase leading-tight tracking-wide">
-                                {breadcrumbs.map((crumb, index) => {
-                                    const Tag = crumb.href ? StyledLink : 'div';
+    // Once the browser is idle, we set shouldLoad to true.
+    // NOTE: to be slightly more performant, we could load when a link is hovered.
+    // But I found this was too much of a delay for the tooltip to appear.
+    // Loading on idle is a good compromise, as it allows the initial render to be fast,
+    // while still loading the tooltip in the background and not polluting the RSC payload.
+    React.useEffect(() => {
+        if ('requestIdleCallback' in window) {
+            (window as globalThis.Window).requestIdleCallback(() => setShouldLoad(true));
+        } else {
+            // fallback for old browsers
+            setTimeout(() => setShouldLoad(true), 2000);
+        }
+    }, []);

-                                    return (
-                                        <Fragment key={crumb.label}>
-                                            {index !== 0 ? (
-                                                <Icon
-                                                    icon="chevron-right"
-                                                    className="size-3 text-tint-subtle"
-                                                />
-                                            ) : null}
-                                            <Tag
-                                                className={tcls(
-                                                    'flex gap-1',
-                                                    crumb.href &&
-                                                        'links-default:text-tint no-underline hover:underline contrast-more:underline contrast-more:decoration-current'
-                                                )}
-                                                href={crumb.href ?? '#'}
-                                            >
-                                                {crumb.icon ? (
-                                                    <span className="mt-0.5 text-tint-subtle empty:hidden">
-                                                        {crumb.icon}
-                                                    </span>
-                                                ) : null}
-                                                {crumb.label}
-                                            </Tag>
-                                        </Fragment>
-                                    );
-                                })}
-                            </div>
-                        ) : null}
-                        <div
-                            className={tcls(
-                                'flex gap-2 leading-snug',
-                                isExternal && 'wrap-anywhere text-sm'
-                            )}
-                        >
-                            {target.icon ? (
-                                <div className="mt-1 text-tint-subtle empty:hidden">
-                                    {target.icon}
-                                </div>
-                            ) : null}
-                            <h5 className="font-semibold">{target.text}</h5>
-                        </div>
-                    </div>
-                    {!isSamePage && target.href ? (
-                        <Button
-                            className={tcls(
-                                '-mx-2 -my-2 ml-auto',
-                                breadcrumbs?.length === 0 ? 'place-self-center' : null
-                            )}
-                            variant="blank"
-                            href={target.href}
-                            target="_blank"
-                            label={openInNewTabLabel}
-                            size="small"
-                            icon="arrow-up-right-from-square"
-                            iconOnly={true}
-                        />
-                    ) : null}
-                </div>
-                {target.subText ? <p className="mt-1 text-sm text-tint">{target.subText}</p> : null}
-            </HoverCard>
-        </HoverCardRoot>
+    return shouldLoad ? (
+        <LoadingValueContext.Provider value={children}>
+            <InlineLinkTooltipImpl {...rest}>{children}</InlineLinkTooltipImpl>
+        </LoadingValueContext.Provider>
+    ) : (
+        children
    );
 }
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Samy Pessé	ae33c09aa7	Version Packages (#3724 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2025-10-15 13:30:24 +02:00
Greg Bergé	7ff69c3b72	Fix bun token (#3727 )	2025-10-15 10:43:44 +02:00
Greg Bergé	6142d6bf80	Build all packages using tsdown (#3722 )	2025-10-14 14:39:19 +02:00
Brett Jephson	75543b140f	Update Node version to work with globalThis.process.getBuiltinModule (#3725 )	2025-10-14 11:13:26 +01:00
Nolann B.	511f1cfbe5	Add scroll margin to Expandable (#3723 )	2025-10-13 15:54:32 +02:00
Samy Pessé	46fa9d954c	Version Packages (#3720 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2025-10-13 08:42:09 +02:00
Greg Bergé	5e1ed5358e	Add npm token to publish with bun (#3721 )	2025-10-13 11:38:57 +05:30
Greg Bergé	295f03db49	Force republishing packages (#3719 )	2025-10-11 07:36:58 +00:00
Claire Chabas	bdde3929fc	Fix web frame height (#3709 )	2025-10-10 17:41:54 +02:00
conico974	4f4210d24a	Update @opennextjs/cloudflare to version 1.9.2 (#3710 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-10-10 17:20:11 +02:00
Greg Bergé	c038ec8f81	Fix package publishing (#3718 )	2025-10-10 13:39:39 +00:00
Samy Pessé	75b52eac28	Version Packages (#3651 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2025-10-10 15:11:33 +02:00
Greg Bergé	ad4d07dc06	Support inline icon colors (#3717 )	2025-10-10 14:51:40 +02:00
Greg Bergé	75086740f8	Fix bundling of embed package (#3716 )	2025-10-10 10:57:06 +02:00
Nolann B.	eea8f1e00f	Enhance OpenAPI security scopes handling (#3712 )	2025-10-09 10:16:12 +02:00
Greg Bergé	4f9abfb6f2	Display headings from reusable content in TOC (#3708 )	2025-10-08 12:17:05 +02:00
conico974	252afceab0	Store customization in a cookie for preview route (#3707 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-10-08 10:37:52 +02:00
Viktor Renkema	bef191660a	Allow hiding toolbar for one session or persistent (#3698 )	2025-10-08 09:48:38 +02:00
Zeno Kapitein	145625142d	Unify section display condition (#3706 )	2025-10-07 15:12:08 +02:00
Greg Bergé	f70a2aa310	Disable flashing when navigating between sections (#3705 )	2025-10-07 12:00:42 +02:00
Samy Pessé	56e46ce8ab	Add Italian translation (#3704 )	2025-10-06 17:07:30 +02:00
Nolann B.	754cc11e0b	Fix merge logic for allOf alternatives (#3515 )	2025-10-06 14:37:51 +02:00
Nolann B.	3551d147e9	Move to urls for page actions (#3703 )	2025-10-06 09:42:37 +02:00
Zeno Kapitein	162cfe4163	Hide sections if only one is present (#3701 )	2025-10-04 20:16:02 +02:00
Nolann B.	6815dd197e	Fix markdownPageURL for PageActions (#3702 )	2025-10-04 19:02:30 +02:00
Zeno Kapitein	d74f8a7098	Improve wide page width (#3692 )	2025-10-03 18:52:05 +02:00
Zeno Kapitein	1e53f46521	Fix button content truncate (#3693 )	2025-10-03 18:51:32 +02:00
Claire Chabas	1a6216df4f	Fix URL used for Ask to LLM (#3697 )	2025-10-03 14:24:24 +02:00
Nolann B.	a629900324	Add dev script for @gitbook/expr (#3700 )	2025-10-03 13:23:15 +02:00
Nolann B.	a4c33997fe	Fix OpenAPI alternatives not showing (#3699 )	2025-10-03 13:06:10 +02:00
Brett Jephson	badf3a92f6	RND-8165: make sure we get alt text coming through on InlineImage (#3696 )	2025-10-03 09:40:34 +01:00
Claire Chabas	e0fb9ac3ca	Support image frame (#3695 )	2025-10-02 10:17:48 +02:00
spastorelli	f3e40410c4	Adapt OpenAPI code samples to prefill API key using visitor data (#3666 )	2025-09-30 11:09:05 +02:00
spastorelli	8e99871004	Highlight discriminator properties in oneOf, allOf, anyOf objects (#3691 )	2025-09-29 17:09:21 +02:00
Zeno Kapitein	1e4e54e752	Fix rounded outline items (#3694 )	2025-09-29 13:33:40 +02:00
spastorelli	50c1be3447	Move inline expression evaluation from API to GBO (#3687 )	2025-09-26 10:55:09 +02:00
spastorelli	319a1e536c	Ensure operation security reqs inherits from spec-level when not defined (#3690 )	2025-09-26 09:11:52 +02:00
conico974	50cb0c6e15	Fix NavigationLoader on search and cmd/click (#3689 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-09-26 08:34:41 +02:00
Zeno Kapitein	ceb32b1a2e	Redo search scopes (#3688 ) Co-authored-by: Claire Chabas <claire.chabas@gmail.com>	2025-09-25 16:49:53 +00:00
Zeno Kapitein	f8c54b4d34	Improve assistant demo (#3686 )	2025-09-25 17:07:07 +02:00
Greg Bergé	c06ad70f8a	Improve fonts loading (#3682 )	2025-09-25 13:17:21 +02:00
Brett Jephson	0ef5dc8538	Update column width sizing (#3676 )	2025-09-25 08:14:15 +01:00
Zeno Kapitein	28adc9b5f1	Add graphic to embed assistant demo page (#3685 )	2025-09-24 14:37:41 +00:00
Zeno Kapitein	912d1693f5	Fix section group alignment (#3684 )	2025-09-24 13:58:34 +00:00
Samy Pessé	c23d4ef331	Fix crash for card cover defined without objectFit (#3683 )	2025-09-24 11:01:06 +02:00
Zeno Kapitein	c21693fe50	Improve screen reader accessibility for hints (#3680 )	2025-09-24 10:23:34 +02:00
Zeno Kapitein	c06b3dd60d	Improve default site icon (#3679 )	2025-09-24 10:22:49 +02:00
conico974	f173e014db	Use cloudflare regional cache instead of our own implementation. (#3673 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-09-24 10:11:11 +02:00
conico974	1b458c436e	Fix NavigationLoader not visible with bold header (#3681 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-09-24 09:54:57 +02:00
conico974	b42b0b3910	Add navigation loader and rename context provider (#3642 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io> Co-authored-by: Zeno Kapitein <zeno@gitbook.io>	2025-09-23 15:00:27 +02:00
Brett Jephson	2fc21272ff	RND-7985: accessible search (#3637 )	2025-09-23 11:36:50 +01:00
Zeno Kapitein	379d486488	Expose "Best match" when site has translations (#3670 )	2025-09-22 22:31:17 +02:00
Zeno Kapitein	cba583a31c	Use siteSpace title instead of space title in search (#3677 )	2025-09-22 18:03:50 +02:00
Zeno Kapitein	7a504b7cc5	Fix OpenAPI response dropdown & vertical overflow (#3678 )	2025-09-22 18:03:43 +02:00
Addison	8ec5fd0986	Add blob: to style source for integrations (#3675 )	2025-09-22 18:41:16 +09:00
spastorelli	529f940a45	Fix OpenAPISecurities and code sample not using operation security requirements (#3671 )	2025-09-22 10:00:46 +02:00
Viktor Renkema	8a3c15911f	Update tooltip labels in docs sites toolbars (#3674 )	2025-09-22 09:28:42 +02:00
spastorelli	d7948e34b2	Fix OpenAPI response showing as JSON instead of YAML (#3669 )	2025-09-18 18:40:24 +02:00
conico974	9f42211993	Enhance tracking with geolocation headers and continent info in analytics proxy (#3667 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-09-18 18:31:21 +02:00
conico974	65e62307bf	Update @opennextjs/cloudflare to version 1.8.3 (#3668 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-09-18 18:04:38 +02:00
spastorelli	469b332da2	Add support for inline expressions rendering with visitor data on GBO side (#3660 )	2025-09-18 16:30:52 +02:00
Zeno Kapitein	e434442f1e	Support site section groups (#3664 )	2025-09-18 15:28:39 +02:00
Samy Pessé	9344431bfc	Fix API URL we proxy insights events to (#3665 )	2025-09-18 13:14:25 +00:00
conico974	622ecbec1d	Handle broken links in header and footer (#3663 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-09-18 11:22:57 +02:00
conico974	fa1382b289	Add responsive image sizes for RecordCard component (#3654 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-09-18 08:55:11 +02:00
Zeno Kapitein	b8388e5a2a	Add ScrollContainer component, use for section tabs (#3661 )	2025-09-17 22:20:32 +02:00
Zeno Kapitein	2bce12798f	Fix section group dropdown offset on big screens (#3662 )	2025-09-17 19:10:52 +02:00
Greg Bergé	f89e889d18	Convert relative URL to absolute in Markdown (page and copy) (#3659 )	2025-09-17 18:12:01 +02:00
Zeno Kapitein	2b8a2d24b6	Add stable scroll gutter to search container (#3656 )	2025-09-17 17:27:47 +02:00
Zeno Kapitein	b85eccdff5	Refactor site section tabs (#3655 )	2025-09-17 17:27:34 +02:00
Viktor Renkema	d924e655c0	Add visibility label and smoothen magnification (#3657 )	2025-09-16 16:34:21 +02:00
Zeno Kapitein	b932e4e2e9	Scope search across sections and variants (#3640 ) Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>	2025-09-16 12:07:29 +02:00
Samy Pessé	ca4a3e8c9a	Track utm on links from the toolbar (#3653 )	2025-09-15 16:51:31 +02:00
John Cashman	b498521196	Refactor robots.txt generation logic (#3621 ) Co-authored-by: Samy Pessé <samypesse@gmail.com>	2025-09-15 14:37:02 +02:00
Samy Pessé	8a8cf2025d	Skip using __session cookie if it's in the old format (#3652 )	2025-09-15 12:10:51 +02:00
Samy Pessé	ed7d47d9b8	Toolbar for authenticated GitBook users (#3650 ) Co-authored-by: Viktor Renkema <vrenkema@gmail.com>	2025-09-15 10:32:23 +02:00
Viktor Renkema	b5494cc04b	Restyle the toolbar in CR and revision preview links (#3631 ) Co-authored-by: Samy Pessé <samypesse@gmail.com>	2025-09-15 08:33:23 +02:00
Samy Pessé	229f2ba9d5	Version Packages (#3646 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2025-09-12 16:40:28 +02:00
spastorelli	6da36558f6	Fix exports in `gitbook/expr` package.json after removing src (#3648 )	2025-09-12 16:20:29 +02:00
Samy Pessé	ca71c1fad6	Fix MCP in production (#3647 )	2025-09-12 14:59:47 +02:00
Samy Pessé	262afa357b	Implement an MCP server on each docs site (#3641 )	2025-09-12 13:19:16 +02:00
Samy Pessé	7375d3c597	Version Packages (#3645 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2025-09-12 11:37:22 +02:00
spastorelli	3548fa6dff	Fix eval estree expr cjs named import when gitbook/expr is imported in playwright tests (#3643 )	2025-09-12 11:20:33 +02:00
conico974	cb73040e0f	Bump Next.js to version 15.4.0 (#3644 ) Co-authored-by: Nicolas Dorseuil <nicolas@gitbook.io>	2025-09-12 11:17:43 +02:00