Version Packages (#3724 )

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Fix bun token (#3727 )
2026-09-16 07:35:16 +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
135 changed files with 2165 additions and 991 deletions
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Hide sections if only one is present
@@ -1,5 +0,0 @@
---
-"@gitbook/expr": patch
---
-
-Add dev script for @gitbook/expr
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix missing geo data in site insights because of incorrect proxying of events.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add stable scroll gutter to search container
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix robots.txt preventing favicon from being indexed.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Redo search scope UI
@@ -1,6 +0,0 @@
---
-"@gitbook/react-openapi": patch
-"gitbook": patch
---
-
-Highlight discriminator properties in oneOf, allOf, anyOf objects
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Make search accessible
@@ -1,6 +0,0 @@
---
-"@gitbook/react-openapi": patch
-"gitbook": patch
---
-
-Adapt OpenAPI code samples to prefill API key using visitor data
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix markdownPageURL for PageActions
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Improve default site icon
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Use sitespace title instead of space title in search
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Support nested site section groups
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Show a toolbar for authenticated users with access to the current site.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add support for inline expressions rendering with visitor data on GBO side
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Update to column width sizing
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Move inline expression evaluation from API to GBO
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix rounded outline items
@@ -1,5 +0,0 @@
---
-"@gitbook/react-openapi": patch
---
-
-Ensure operation security requirements inherits from spec-level when not defined
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Expose "Best match" when site has translations
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Improve screen reader accessibility for hints
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add alt text to inline image
@@ -1,5 +0,0 @@
---
-"@gitbook/react-openapi": minor
---
-
-Fix OpenAPISecurities and code sample not using operation security requirements
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix crash for card cover defined without objectFit
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Improve wide page width layout
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add scrollcontainer component
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Refactor section tabs
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix button content truncate
@@ -1,5 +0,0 @@
---
-'@gitbook/react-openapi': patch
---
-
-Fix merge logic for allOf alternatives
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix OpenAPI response dropdown & vertical overflow
@@ -1,5 +0,0 @@
---
-"@gitbook/react-openapi": patch
---
-
-Fix OpenAPI response showing as JSON instead of YAML when it should
@@ -1,6 +0,0 @@
---
-"@gitbook/react-openapi": patch
-"gitbook": patch
---
-
-Fix OpenAPI alternatives not showing
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Scope search across sections and variants
@@ -54,7 +54,7 @@ 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 (Version: >=20.6)
+- 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
@@ -5,7 +5,7 @@ on:
        branches:
            - main
 env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    format:
        runs-on: ubuntu-latest
@@ -41,7 +41,7 @@ jobs:
        name: Build (Open Source)
        timeout-minutes: 6
        env:
-            NPM_TOKEN_READONLY: ''
+            BUN_NPM_TOKEN: ''
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -5,7 +5,7 @@ on:
      branches:
        - main
 env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (preview)
@@ -4,7 +4,7 @@ on:
        branches:
            - main
 env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (production)
@@ -4,7 +4,7 @@ on:
        branches:
            - main
 env:
-    NPM_TOKEN_READONLY: ${{ secrets.NPM_TOKEN_READONLY }}
+    BUN_NPM_TOKEN: ${{ secrets.NPM_TOKEN_READONLY }}
 jobs:
    deploy-v2-vercel:
        name: Deploy v2 to Vercel (staging)
@@ -6,7 +6,7 @@ on:
            - main

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

@@ -36,7 +36,6 @@ jobs:
                  # Using a PAT instead of GITHUB_TOKEN because we need to run workflows when releases are created
                  # https://github.com/orgs/community/discussions/26875#discussioncomment-3253761
                  GITHUB_TOKEN: ${{ secrets.GH_PERSONAL_TOKEN }}
-                  NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
                  CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
                  CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

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

 # TypeScript
 *.tsbuildinfo
+.npmrc
@@ -1 +1 @@
-v20.6
+v22.3
@@ -35,7 +35,7 @@ To run a local version of this project, please follow these simple steps.

 ### Prerequisites

- Node.js (Version: >=20.6)
+- 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
@@ -90,7 +90,7 @@ If you are GitBook staff, you'll need our NPM token in your local environment.
 ```
 .env.local

-NPM_TOKEN_READONLY=xxx
+BUN_NPM_TOKEN=xxx
 ```

 and then reinstall dependencies.
@@ -1,2 +1,2 @@
 [install.scopes]
-"gitbook" = { token = "$NPM_TOKEN_READONLY", url = "https://registry.npmjs.org" }
+"gitbook" = { token = "$BUN_NPM_TOKEN", url = "https://registry.npmjs.org" }
@@ -3,15 +3,15 @@
    "version": "0.1.0",
    "devDependencies": {
        "@biomejs/biome": "^1.9.4",
-        "@changesets/cli": "^2.27.12",
-        "turbo": "^2.5.0",
-        "vercel": "^39.3.0"
+        "@changesets/cli": "^2.29.7",
+        "turbo": "^2.5.8",
+        "vercel": "^39.4.2"
    },
    "packageManager": "bun@1.2.15",
    "overrides": {
        "@codemirror/state": "6.4.1",
-        "react": "^19.0.0",
-        "react-dom": "^19.0.0",
+        "react": "catalog:",
+        "react-dom": "catalog:",
        "esbuild": "0.24.2"
    },
    "private": true,
@@ -26,8 +26,9 @@
        "e2e": "turbo run e2e",
        "e2e-customers": "turbo run e2e-customers",
        "changeset": "changeset",
-        "changeset-version": "changeset version && bun run format",
-        "release": "turbo run release && changeset publish",
+        "changeset-version": "changeset version && bun run format && bun update",
+        "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"
    },
@@ -35,7 +36,15 @@
        "packages": ["packages/*"],
        "catalog": {
            "@gitbook/api": "0.143.2",
-            "bidc": "^0.0.2"
+            "assert-never": "^1.4.0",
+            "bidc": "^0.0.2",
+            "bun-types": "^1.1.20",
+            "classnames": "^2.5.1",
+            "react": "^19.0.0",
+            "react-dom": "^19.0.0",
+            "tsdown": "^0.15.6",
+            "typescript": "^5.5.3",
+            "usehooks-ts": "^3.1.0"
        }
    },
    "patchedDependencies": {
@@ -1,5 +1,21 @@
 # @gitbook/browser-types

+## 0.1.2
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+- Updated dependencies [6142d6b]
+  - @gitbook/icons@0.3.3
+
+## 0.1.1
+
+### Patch Changes
+
+- 295f03d: Republish packages
+- Updated dependencies [295f03d]
+  - @gitbook/icons@0.3.2
+
 ## 0.1.0

 ### Minor Changes
@@ -8,17 +8,24 @@
            "default": "./dist/index.js"
        }
    },
-    "version": "0.1.0",
+    "sideEffects": false,
+    "version": "0.1.2",
    "dependencies": {
        "@gitbook/api": "catalog:",
        "@gitbook/icons": "workspace:"
    },
    "devDependencies": {
-        "typescript": "^5.5.3"
+        "tsdown": "catalog:",
+        "typescript": "catalog:"
    },
    "scripts": {
-        "build": "tsc",
-        "typecheck": "tsc --noEmit"
+        "build": "tsdown",
+        "typecheck": "tsc --noEmit",
+        "dev": "bun run build -- --watch ./src"
    },
-    "files": ["dist", "README.md", "CHANGELOG.md"]
+    "files": ["dist", "README.md", "CHANGELOG.md"],
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
 }
@@ -1,5 +1,17 @@
 # @gitbook/cache-tags

+## 0.3.3
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+
+## 0.3.2
+
+### Patch Changes
+
+- 295f03d: Republish packages
+
 ## 0.3.1

 ### Patch Changes
@@ -4,22 +4,27 @@
    "exports": {
        ".": {
            "types": "./dist/index.d.ts",
-            "development": "./src/index.ts",
            "default": "./dist/index.js"
        }
    },
-    "version": "0.3.1",
+    "sideEffects": false,
+    "version": "0.3.3",
    "dependencies": {
        "@gitbook/api": "catalog:",
-        "assert-never": "^1.2.1"
+        "assert-never": "catalog:"
    },
    "devDependencies": {
-        "typescript": "^5.5.3"
+        "tsdown": "catalog:",
+        "typescript": "catalog:"
    },
    "scripts": {
-        "build": "tsc",
+        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "dev": "tsc -w"
+        "dev": "bun run build -- --watch ./src"
    },
-    "files": ["dist", "src", "README.md", "CHANGELOG.md"]
+    "files": ["dist", "README.md", "CHANGELOG.md"],
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
 }
@@ -1,5 +1,17 @@
 # @gitbook/colors

+## 0.4.2
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+
+## 0.4.1
+
+### Patch Changes
+
+- 295f03d: Republish packages
+
 ## 0.4.0

 ### Minor Changes
@@ -4,18 +4,23 @@
    "exports": {
        ".": {
            "types": "./dist/index.d.ts",
-            "development": "./src/index.ts",
            "default": "./dist/index.js"
        }
    },
-    "version": "0.4.0",
+    "sideEffects": false,
+    "version": "0.4.2",
    "devDependencies": {
-        "typescript": "^5.5.3"
+        "tsdown": "catalog:",
+        "typescript": "catalog:"
    },
    "scripts": {
-        "build": "tsc",
+        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "dev": "tsc -w"
+        "dev": "bun run build -- --watch ./src"
    },
-    "files": ["dist", "src", "README.md", "CHANGELOG.md"]
+    "files": ["dist", "README.md", "CHANGELOG.md"],
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
 }
@@ -1,5 +1,27 @@
 # @gitbook/embed

+## 0.1.4
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+- Updated dependencies [6142d6b]
+  - @gitbook/icons@0.3.3
+
+## 0.1.3
+
+### Patch Changes
+
+- 295f03d: Republish packages
+- Updated dependencies [295f03d]
+  - @gitbook/icons@0.3.2
+
+## 0.1.2
+
+### Patch Changes
+
+- 7508674: Fix bundling of packages
+
 ## 0.1.1

 ### Patch Changes
@@ -5,27 +5,39 @@
    "exports": {
        ".": {
            "types": "./dist/index.d.ts",
-            "default": "./dist/index.js",
-            "standalone": "./dist/standalone/index.js",
-            "react": "./dist/react/index.js"
+            "default": "./dist/index.js"
+        },
+        "./react": {
+            "types": "./dist/react/index.d.ts",
+            "default": "./dist/react/index.js"
        }
    },
-    "version": "0.1.1",
+    "sideEffects": false,
+    "version": "0.1.4",
    "dependencies": {
        "@gitbook/api": "catalog:",
        "@gitbook/icons": "workspace:",
        "bidc": "catalog:"
    },
    "peerDependencies": {
-        "react": "^18.0.0"
+        "react": "*"
    },
    "devDependencies": {
-        "typescript": "^5.5.3",
-        "react": "^19.0.0"
+        "tsdown": "catalog:",
+        "typescript": "catalog:",
+        "react": "catalog:"
    },
    "scripts": {
-        "build": "tsc && bun build src/standalone/index.ts --bundle --minify --outdir=standalone",
-        "typecheck": "tsc --noEmit"
+        "build": "bun run build-lib && bun run build-standalone",
+        "build-lib": "tsdown",
+        "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"
    },
-    "files": ["dist", "README.md", "CHANGELOG.md", "standalone"]
+    "files": ["dist", "README.md", "CHANGELOG.md"],
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
 }
@@ -1,4 +1,6 @@
-import React from 'react';
+'use client';
+
+import { useEffect, useMemo, useRef, useState } from 'react';
 import type {
    GetFrameURLOptions,
    GitBookEmbeddableConfiguration,
@@ -17,19 +19,19 @@ export type GitBookFrameProps = {
 export function GitBookFrame(props: GitBookFrameProps) {
    const { className, visitor, buttons, welcomeMessage, suggestions, tools } = props;

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

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

-    React.useEffect(() => {
+    useEffect(() => {
        if (frameRef.current) {
            setGitbookFrame(gitbook.createFrame(frameRef.current));
        }
    }, [gitbook]);

-    React.useEffect(() => {
+    useEffect(() => {
        gitbookFrame?.configure({
            buttons,
            welcomeMessage,
@@ -0,0 +1,13 @@
+import { defineConfig } from 'tsdown';
+
+export default defineConfig([
+    {
+        entry: 'src/index.ts',
+        outDir: 'dist',
+    },
+    {
+        entry: 'src/react/index.ts',
+        outDir: 'dist/react',
+        unbundle: true,
+    },
+]);
@@ -1,13 +1,25 @@
 # @gitbook/emoji-codepoints

+## 0.2.2
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+
+## 0.2.1
+
+### Patch Changes
+
+- 295f03d: Republish packages
+
 ## 0.2.0

 ### Minor Changes

-   57adb3e: Second release to fix publishing with changeset
+- 57adb3e: Second release to fix publishing with changeset

 ## 0.1.0

 ### Minor Changes

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

+## 1.2.3
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+
+## 1.2.2
+
+### Patch Changes
+
+- 295f03d: Republish packages
+
+## 1.2.1
+
+### Patch Changes
+
+- a629900: Add dev script for @gitbook/expr
+
 ## 1.2.0

 ### Minor Changes
@@ -1,38 +1,40 @@
 {
    "name": "@gitbook/expr",
    "description": "Safely evaluate & parse user-defined GitBook expressions.",
-    "version": "1.2.0",
+    "version": "1.2.3",
    "type": "module",
    "exports": {
        ".": {
            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
            "default": "./dist/index.js"
        }
    },
    "sideEffects": false,
    "dependencies": {
-        "eval-estree-expression": "github:jonschlinkert/eval-estree-expression#9cf28d2",
        "acorn": "^8.14.0",
        "acorn-loose": "8.4.0",
        "acorn-walk": "^8.3.4",
+        "assert-never": "catalog:",
        "escodegen": "^2.1.0",
-        "assert-never": "^1.2.1"
+        "eval-estree-expression": "github:jonschlinkert/eval-estree-expression#9cf28d2"
    },
    "devDependencies": {
-        "bun-types": "^1.1.20",
-        "tsdown": "^0.15.0",
+        "@types/escodegen": "^0.0.10",
        "@types/estree": "^1.0.6",
-        "@babel/types": "^7.26.0",
        "@types/json-schema": "^7.0.15",
-        "@types/escodegen": "^0.0.10"
+        "bun-types": "catalog:",
+        "tsdown": "catalog:"
    },
    "scripts": {
-        "build": "tsdown --project tsconfig.build.json",
+        "build": "tsdown",
        "typecheck": "tsc --noEmit",
        "unit": "bun test",
        "clean": "rm -rf ./dist",
-        "dev": "bun run build -- --watch"
+        "dev": "bun run build -- --watch ./src"
    },
-    "files": ["dist", "README.md", "CHANGELOG.md"]
+    "files": ["dist", "README.md", "CHANGELOG.md"],
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
 }
@@ -1,10 +0,0 @@
-{
-    "$schema": "https://json.schemastore.org/tsconfig",
-    "extends": ["./tsconfig.json"],
-    "exclude": ["**/*.test.ts"],
-    "compilerOptions": {
-        "declaration": true,
-        "noEmit": false,
-        "outDir": "dist"
-    }
-}
@@ -1,5 +1,17 @@
 # @gitbook/fonts

+## 0.1.2
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+
+## 0.1.1
+
+### Patch Changes
+
+- 295f03d: Republish packages
+
 ## 0.1.0

 ### Minor Changes
@@ -4,28 +4,33 @@
    "exports": {
        ".": {
            "types": "./dist/index.d.ts",
-            "development": "./src/index.ts",
            "default": "./dist/index.js"
        }
    },
-    "version": "0.1.0",
+    "sideEffects": false,
+    "version": "0.1.2",
    "dependencies": {
        "@gitbook/api": "catalog:"
    },
    "devDependencies": {
-        "google-font-metadata": "^6.0.3",
-        "typescript": "^5.5.3"
+        "google-font-metadata": "^6.0.7",
+        "tsdown": "catalog:",
+        "typescript": "catalog:"
    },
    "scripts": {
        "generate": "bun ./bin/generate.js",
-        "build": "tsc --project tsconfig.build.json",
+        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "dev": "tsc -w",
+        "dev": "bun run build -- --watch ./src",
        "clean": "rm -rf ./dist && rm -rf ./src/data",
        "unit": "bun test"
    },
-    "files": ["dist", "src", "bin", "README.md", "CHANGELOG.md"],
+    "files": ["dist", "bin", "README.md", "CHANGELOG.md"],
    "engines": {
        "node": ">=20.0.0"
+    },
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
    }
 }
@@ -1,57 +1,57 @@
-// Bun Snapshot v1, https://goo.gl/fbAQLP
+// Bun Snapshot v1, https://bun.sh/docs/test/snapshots

 exports[`getDefaultFont should return correct object for Latin text 1`] = `
 {
  "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
 }
 `;

 exports[`getDefaultFont should return correct object for Cyrillic text 1`] = `
 {
  "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZthjp-Ek-_0ewmM.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZthjp-Ek-_0ewmM.woff",
 }
 `;

 exports[`getDefaultFont should return correct object for Greek text 1`] = `
 {
  "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZxhjp-Ek-_0ewmM.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZxhjp-Ek-_0ewmM.woff",
 }
 `;

 exports[`getDefaultFont should handle mixed script text 1`] = `
 {
  "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZthjp-Ek-_0ewmM.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZthjp-Ek-_0ewmM.woff",
 }
 `;

 exports[`getDefaultFont should handle different font weights: regular 1`] = `
 {
  "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
 }
 `;

 exports[`getDefaultFont should handle different font weights: bold 1`] = `
 {
  "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuFuYAZ9hjp-Ek-_0ew.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuFuYAZ9hjp-Ek-_0ew.woff",
 }
 `;

 exports[`getDefaultFont should handle different fonts: inter 1`] = `
 {
  "font": "Inter",
-  "url": "https://fonts.gstatic.com/s/inter/v18/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
+  "url": "https://fonts.gstatic.com/s/inter/v20/UcCO3FwrK3iLTeHuS_nVMrMxCp50SjIw2boKoduKmMEVuLyfAZ9hjp-Ek-_0ew.woff",
 }
 `;

 exports[`getDefaultFont should handle different fonts: roboto 1`] = `
 {
  "font": "Roboto",
-  "url": "https://fonts.gstatic.com/s/roboto/v32/KFOmCnqEu92Fr1Mu4mxMKTU1Kg.woff",
+  "url": "https://fonts.gstatic.com/s/roboto/v49/KFOMCnqEu92Fr1ME7kSn66aGLdTylUAMQXC89YmC2DPNWubEbVmUiAz0klQm_20.woff",
 }
 `;
@@ -1,4 +0,0 @@
-{
-    "extends": "./tsconfig.json",
-    "exclude": ["node_modules", "src/**/*.test.ts"]
-}
@@ -1,5 +1,94 @@
 # gitbook

+## 0.19.2
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+- 75543b1: Update minimum Node version in .npmrc
+- 511f1cf: Add scroll margin to Expandable
+- Updated dependencies [6142d6b]
+  - @gitbook/emoji-codepoints@0.2.2
+  - @gitbook/react-contentkit@0.7.7
+  - @gitbook/openapi-parser@3.0.4
+  - @gitbook/browser-types@0.1.2
+  - @gitbook/react-openapi@1.5.2
+  - @gitbook/cache-tags@0.3.3
+  - @gitbook/react-math@0.6.3
+  - @gitbook/colors@0.4.2
+  - @gitbook/fonts@0.1.2
+  - @gitbook/icons@0.3.3
+  - @gitbook/expr@1.2.3
+
+## 0.19.1
+
+### Patch Changes
+
+- 295f03d: Republish packages
+- Updated dependencies [bdde392]
+- Updated dependencies [295f03d]
+  - @gitbook/react-contentkit@0.7.6
+  - @gitbook/browser-types@0.1.1
+  - @gitbook/cache-tags@0.3.2
+  - @gitbook/colors@0.4.1
+  - @gitbook/emoji-codepoints@0.2.1
+  - @gitbook/expr@1.2.2
+  - @gitbook/fonts@0.1.1
+  - @gitbook/icons@0.3.2
+  - @gitbook/openapi-parser@3.0.3
+  - @gitbook/react-math@0.6.2
+  - @gitbook/react-openapi@1.5.1
+
+## 0.19.0
+
+### Minor Changes
+
+- ed7d47d: Show a toolbar for authenticated users with access to the current site.
+- 50c1be3: Move inline expression evaluation from API to GBO
+- 56e46ce: Add Italian translation
+- b932e4e: Scope search across sections and variants
+
+### Patch Changes
+
+- 162cfe4: Hide sections if only one is present
+- 1456251: Unify section display condition
+- 9344431: Fix missing geo data in site insights because of incorrect proxying of events.
+- eea8f1e: Enhance OpenAPI security scopes handling
+- 2b8a2d2: Add stable scroll gutter to search container
+- b498521: Fix robots.txt preventing favicon from being indexed.
+- ceb32b1: Redo search scope UI
+- 8e99871: Highlight discriminator properties in oneOf, allOf, anyOf objects
+- 2fc2127: Make search accessible
+- f3e4041: Adapt OpenAPI code samples to prefill API key using visitor data
+- 6815dd1: Fix markdownPageURL for PageActions
+- c06b3dd: Improve default site icon
+- cba583a: Use sitespace title instead of space title in search
+- e434442: Support nested site section groups
+- 469b332: Add support for inline expressions rendering with visitor data on GBO side
+- 0ef5dc8: Update to column width sizing
+- 1e4e54e: Fix rounded outline items
+- 379d486: Expose "Best match" when site has translations
+- c21693f: Improve screen reader accessibility for hints
+- badf3a9: Add alt text to inline image
+- c23d4ef: Fix crash for card cover defined without objectFit
+- d74f8a7: Improve wide page width layout
+- b8388e5: Add scrollcontainer component
+- b85eccd: Refactor section tabs
+- 1e53f46: Fix button content truncate
+- 7a504b7: Fix OpenAPI response dropdown & vertical overflow
+- a4c3399: Fix OpenAPI alternatives not showing
+- Updated dependencies [a629900]
+- Updated dependencies [eea8f1e]
+- Updated dependencies [8e99871]
+- Updated dependencies [f3e4041]
+- Updated dependencies [319a1e5]
+- Updated dependencies [529f940]
+- Updated dependencies [754cc11]
+- Updated dependencies [d7948e3]
+- Updated dependencies [a4c3399]
+  - @gitbook/expr@1.2.1
+  - @gitbook/react-openapi@1.5.0
+
 ## 0.18.0

 ### Minor Changes
@@ -1,14 +1,14 @@
 {
    "name": "gitbook",
-    "version": "0.18.0",
+    "version": "0.19.2",
    "private": true,
    "dependencies": {
        "@gitbook/api": "catalog:",
-        "@gitbook/expr": "workspace:*",
        "@gitbook/browser-types": "workspace:*",
        "@gitbook/cache-tags": "workspace:*",
        "@gitbook/colors": "workspace:*",
        "@gitbook/emoji-codepoints": "workspace:*",
+        "@gitbook/expr": "workspace:*",
        "@gitbook/fonts": "workspace:*",
        "@gitbook/icons": "workspace:*",
        "@gitbook/openapi-parser": "workspace:*",
@@ -16,7 +16,7 @@
        "@gitbook/react-math": "workspace:*",
        "@gitbook/react-openapi": "workspace:*",
        "@modelcontextprotocol/sdk": "^1.17.5",
-        "@opennextjs/cloudflare": "^1.8.3",
+        "@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",
@@ -28,10 +28,9 @@
        "@tailwindcss/typography": "^0.5.16",
        "@tusbar/cache-control": "^1.0.2",
        "ai": "^4.2.2",
-        "assert-never": "^1.2.1",
+        "assert-never": "catalog:",
        "bidc": "catalog:",
-        "bun-types": "^1.1.20",
-        "classnames": "^2.5.1",
+        "classnames": "catalog:",
        "direction": "^2.0.1",
        "event-iterator": "^2.0.0",
        "framer-motion": "^10.16.14",
@@ -39,7 +38,6 @@
        "js-cookie": "^3.0.5",
        "jsontoxml": "^1.0.1",
        "jwt-decode": "^4.0.0",
-        "katex": "^0.16.9",
        "mathjax": "^3.2.2",
        "mcp-handler": "^1.0.2",
        "mdast-util-from-markdown": "^2.0.2",
@@ -51,7 +49,7 @@
        "micromark-extension-gfm": "^3.0.0",
        "motion": "^12.23.12",
        "next": "15.4.0",
-        "next-themes": "^0.2.1",
+        "next-themes": "^0.4.6",
        "nuqs": "^2.2.3",
        "object-hash": "^3.0.0",
        "object-identity": "^0.1.2",
@@ -73,7 +71,7 @@
        "unist-util-remove": "^4.0.0",
        "unist-util-visit": "^5.0.0",
        "url-join": "^5.0.0",
-        "usehooks-ts": "^3.1.0",
+        "usehooks-ts": "catalog:",
        "warn-once": "^0.1.1",
        "zod": "^3",
        "zustand": "^5.0.3"
@@ -92,6 +90,7 @@
        "@types/react": "18.3.13",
        "@types/react-dom": "18.3.1",
        "@types/rison": "^0.0.9",
+        "bun-types": "catalog:",
        "deepmerge": "^4.3.1",
        "env-cmd": "^10.1.0",
        "jsonwebtoken": "^9.0.2",
@@ -99,7 +98,7 @@
        "stylelint": "^16.16.0",
        "tailwindcss": "^4.1.11",
        "ts-essentials": "^10.0.1",
-        "typescript": "^5.5.3",
+        "typescript": "catalog:",
        "vercel": "^39.3.0"
    },
    "scripts": {
@@ -121,5 +120,9 @@
    },
    "browserslist": [
        ">0.3%, chrome >= 64, edge >= 79, firefox >= 67, opera >= 51, safari >= 12 and not dead"
-    ]
+    ],
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
 }
@@ -5,6 +5,7 @@ import { useCheckForContentUpdate } from '../AutoRefreshContent';
 import { useVisitorSession } from '../Insights';
 import { useCurrentPagePath } from '../hooks';
 import { DateRelative } from '../primitives';
+import { HideToolbarButton } from './HideToolbarButton';
 import { IframeWrapper } from './IframeWrapper';
 import { RefreshContentButton } from './RefreshContentButton';
 import {
@@ -17,48 +18,108 @@ import {
    ToolbarSubtitle,
    ToolbarTitle,
 } from './Toolbar';
-import type { AdminToolbarClientProps } from './types';
+import {
+    type ToolbarControlsContextValue,
+    ToolbarControlsProvider,
+} from './ToolbarControlsContext';
+import type { AdminToolbarClientProps, AdminToolbarContext } from './types';
+import { useToolbarVisibility } from './utils';

 export function AdminToolbarClient(props: AdminToolbarClientProps) {
-    const { context } = props;
+    const { context, onPersistentClose, onSessionClose, onToggleMinify } = props;
+    const {
+        minified,
+        setMinified,
+        shouldAutoExpand,
+        hidden,
+        minimize,
+        closeSession,
+        closePersistent,
+    } = useToolbarVisibility({
+        onPersistentClose,
+        onSessionClose,
+        onToggleMinify,
+    });
+
    const visitorSession = useVisitorSession();

+    const toolbarControls: ToolbarControlsContextValue = {
+        minimize,
+        closeSession,
+        closePersistent,
+        shouldAutoExpand,
+    };
+
+    if (hidden) {
+        return null;
+    }
+
    // If there is a change request, show the change request toolbar
    if (context.changeRequest) {
        return (
-            <IframeWrapper>
-                <MotionConfig reducedMotion="user">
-                    <ChangeRequestToolbar context={context} />
-                </MotionConfig>
-            </IframeWrapper>
+            <ToolbarControlsWrapper value={toolbarControls}>
+                <ChangeRequestToolbar
+                    context={context}
+                    minified={minified}
+                    onMinifiedChange={setMinified}
+                />
+            </ToolbarControlsWrapper>
        );
    }

    // If the revision is not the current revision, the user is looking at a previous version of the site, so show the revision toolbar
    if (context.revisionId !== context.space.revision) {
        return (
-            <IframeWrapper>
-                <MotionConfig reducedMotion="user">
-                    <RevisionToolbar context={context} />
-                </MotionConfig>
-            </IframeWrapper>
+            <ToolbarControlsWrapper value={toolbarControls}>
+                <RevisionToolbar
+                    context={context}
+                    minified={minified}
+                    onMinifiedChange={setMinified}
+                />
+            </ToolbarControlsWrapper>
        );
    }

    // If the user is authenticated and part of the organization owning this site, show the authenticated user toolbar
    if (visitorSession?.organizationId === context.organizationId) {
        return (
-            <IframeWrapper>
-                <MotionConfig reducedMotion="user">
-                    <AuthenticatedUserToolbar context={context} />
-                </MotionConfig>
-            </IframeWrapper>
+            <ToolbarControlsWrapper value={toolbarControls}>
+                <AuthenticatedUserToolbar
+                    context={context}
+                    minified={minified}
+                    onMinifiedChange={setMinified}
+                />
+            </ToolbarControlsWrapper>
        );
    }
+
+    return null;
 }

-function ChangeRequestToolbar(props: AdminToolbarClientProps) {
-    const { context } = props;
+/**
+ * Reusable wrapper that provides tooling and containers that are used by all types of toolbar views.
+ */
+export function ToolbarControlsWrapper(
+    props: React.PropsWithChildren<{ value: ToolbarControlsContextValue | null }>
+) {
+    const { children, value } = props;
+    return (
+        <ToolbarControlsProvider value={value}>
+            <IframeWrapper>
+                <MotionConfig reducedMotion="user">{children}</MotionConfig>
+            </IframeWrapper>
+        </ToolbarControlsProvider>
+    );
+}
+
+interface ToolbarViewProps {
+    context: AdminToolbarContext;
+    minified: boolean;
+    onMinifiedChange: (value: boolean) => void;
+}
+
+function ChangeRequestToolbar(props: ToolbarViewProps) {
+    const { context, minified, onMinifiedChange } = props;
    const { changeRequest, site } = context;
    if (!changeRequest) {
        throw new Error('Change request is not set');
@@ -71,11 +132,11 @@ function ChangeRequestToolbar(props: AdminToolbarClientProps) {
    });

    return (
-        <Toolbar label="Site preview">
+        <Toolbar minified={minified} onMinifiedChange={onMinifiedChange} label="Site preview">
            <ToolbarBody>
                <ToolbarTitle
-                    prefix="Change request"
-                    suffix={`#${changeRequest.number} ${changeRequest.subject || 'Untitled'}`}
+                    prefix={`Change #${changeRequest.number}:`}
+                    suffix={`${changeRequest.subject || 'Untitled'}`}
                />
                <ToolbarSubtitle
                    subtitle={
@@ -88,9 +149,13 @@ function ChangeRequestToolbar(props: AdminToolbarClientProps) {

            <ToolbarSeparator />

-            <ToolbarButtonGroup>
+            <ToolbarActions>
                {/* Refresh to retrieve latest changes */}
                {updated ? <RefreshContentButton refreshForUpdates={refreshForUpdates} /> : null}
+
+                {/* Edit in GitBook */}
+                <EditPageButton href={changeRequest.urls.app} siteId={site.id} />
+
                {/* Comment in app */}
                <ToolbarButton
                    title="Comment in a GitBook"
@@ -125,16 +190,13 @@ function ChangeRequestToolbar(props: AdminToolbarClientProps) {
                    })}
                    icon="code-pull-request"
                />
-
-                {/* Edit in GitBook */}
-                <EditPageButton href={changeRequest.urls.app} siteId={site.id} />
-            </ToolbarButtonGroup>
+            </ToolbarActions>
        </Toolbar>
    );
 }

-function RevisionToolbar(props: AdminToolbarClientProps) {
-    const { context } = props;
+function RevisionToolbar(props: ToolbarViewProps) {
+    const { context, minified, onMinifiedChange } = props;
    const { revision, site } = context;
    if (!revision) {
        throw new Error('Revision is not set');
@@ -145,7 +207,7 @@ function RevisionToolbar(props: AdminToolbarClientProps) {
    const gitProvider = isGitHub ? 'GitHub' : 'GitLab';

    return (
-        <Toolbar label="Site preview">
+        <Toolbar minified={minified} onMinifiedChange={onMinifiedChange} label="Site preview">
            <ToolbarBody>
                <ToolbarTitle prefix="Site version" suffix={context.site.title} />
                <ToolbarSubtitle
@@ -157,7 +219,7 @@ function RevisionToolbar(props: AdminToolbarClientProps) {
                />
            </ToolbarBody>
            <ToolbarSeparator />
-            <ToolbarButtonGroup>
+            <ToolbarActions>
                {/* Open commit in Git client */}
                <ToolbarButton
                    title={
@@ -205,22 +267,26 @@ function RevisionToolbar(props: AdminToolbarClientProps) {
                    })}
                    icon="code-commit"
                />
-            </ToolbarButtonGroup>
+            </ToolbarActions>
        </Toolbar>
    );
 }

-function AuthenticatedUserToolbar(props: AdminToolbarClientProps) {
-    const { context } = props;
+function AuthenticatedUserToolbar(props: ToolbarViewProps) {
+    const { context, minified, onMinifiedChange } = props;
    const { revision, space, site } = context;
    const { refreshForUpdates, updated } = useCheckForContentUpdate({
        revisionId: space.revision,
    });

    return (
-        <Toolbar label="Only visible to your GitBook organization">
+        <Toolbar
+            minified={minified}
+            onMinifiedChange={onMinifiedChange}
+            label="Only visible to your GitBook organization"
+        >
            <ToolbarBody>
-                <ToolbarTitle prefix="Site" suffix={context.site.title} />
+                <ToolbarTitle suffix={context.site.title} />
                <ToolbarSubtitle
                    subtitle={
                        <>
@@ -230,9 +296,14 @@ function AuthenticatedUserToolbar(props: AdminToolbarClientProps) {
                />
            </ToolbarBody>
            <ToolbarSeparator />
-            <ToolbarButtonGroup>
+            <ToolbarActions>
                {/* Refresh to retrieve latest changes */}
                {updated ? <RefreshContentButton refreshForUpdates={refreshForUpdates} /> : null}
+
+                {/* Edit in GitBook */}
+                <EditPageButton href={space.urls.app} siteId={site.id} />
+
+                {/* Open site in GitBook */}
                <ToolbarButton
                    title="Open site in GitBook"
                    href={getToolbarHref({
@@ -240,8 +311,10 @@ function AuthenticatedUserToolbar(props: AdminToolbarClientProps) {
                        siteId: site.id,
                        buttonId: 'site',
                    })}
-                    icon="gear"
+                    icon="gears"
                />
+
+                {/* Customize in GitBook */}
                <ToolbarButton
                    title="Customize in GitBook"
                    href={getToolbarHref({
@@ -251,6 +324,8 @@ function AuthenticatedUserToolbar(props: AdminToolbarClientProps) {
                    })}
                    icon="palette"
                />
+
+                {/* Open insights in GitBook */}
                <ToolbarButton
                    title="Open insights in GitBook"
                    href={getToolbarHref({
@@ -260,12 +335,22 @@ function AuthenticatedUserToolbar(props: AdminToolbarClientProps) {
                    })}
                    icon="chart-simple"
                />
-                <EditPageButton href={space.urls.app} siteId={site.id} />
-            </ToolbarButtonGroup>
+            </ToolbarActions>
        </Toolbar>
    );
 }

+function ToolbarActions(props: { children: React.ReactNode }) {
+    const { children } = props;
+
+    return (
+        <ToolbarButtonGroup>
+            {children}
+            <HideToolbarButton />
+        </ToolbarButtonGroup>
+    );
+}
+
 function EditPageButton(props: {
    href: string;
    siteId: string;
@@ -11,9 +11,15 @@
  vector-effect: non-scaling-stroke;
 }

-:global(html.dark) .svgLogo {
-  --logo-fill: var(--color-neutral-800);
-  --trace-color: #dedfe3;
+.static .trace {
+  animation: none;
+  fill: var(--logo-fill);
+  stroke: none;
+}
+
+.static .seg {
+  animation: none;
+  opacity: 0;
 }

 /* Base segment animation */
@@ -176,4 +182,4 @@
    fill: var(--logo-fill);
    stroke:none;
  }
-}
+}
@@ -2,10 +2,16 @@ import { tcls } from '@/lib/tailwind';
 import type React from 'react';
 import styles from './AnimatedLogo.module.css';

-export const AnimatedLogo: React.FC = () => {
+interface AnimatedLogoProps {
+    shouldAnimate?: boolean;
+}
+
+export const AnimatedLogo: React.FC<AnimatedLogoProps> = (props) => {
+    const { shouldAnimate = true } = props;
+
    return (
        <svg
-            className={styles.svgLogo}
+            className={tcls(styles.svgLogo, shouldAnimate ? undefined : styles.static)}
            width="28"
            height="28"
            viewBox="0 0 28 28"
@@ -0,0 +1,232 @@
+'use client';
+import { tcls } from '@/lib/tailwind';
+import { Icon, type IconName, IconStyle } from '@gitbook/icons';
+import { motion } from 'motion/react';
+import React, { useRef } from 'react';
+import { useOnClickOutside } from 'usehooks-ts';
+import { ToolbarButton, type ToolbarButtonProps } from './Toolbar';
+import styles from './Toolbar.module.css';
+import { useToolbarControls } from './ToolbarControlsContext';
+
+const ARC_DURATION_SECONDS = 0.4;
+const ARC_STAGGER_MS = 80;
+const BASE_ROTATION_DEG = 95;
+const ROTATION_STEP_DEG = 18;
+
+interface HideToolbarButtonProps {
+    motionValues?: ToolbarButtonProps['motionValues'];
+}
+
+/**
+ * Hide menu trigger. Expands a macOS Dock-like submenu with 3 labeled actions.
+ */
+export function HideToolbarButton(props: HideToolbarButtonProps) {
+    const { motionValues } = props;
+    const [open, setOpen] = React.useState(false);
+    const controls = useToolbarControls();
+
+    const ref = useRef<HTMLDivElement>(null);
+    const buttonRef = useRef<HTMLDivElement>(null);
+
+    const handleClickOutsideArcMenu = (event: Event) => {
+        // Don't close the arc if we are clicking on the button itself
+        if (buttonRef.current?.contains(event.target as Node)) {
+            return;
+        }
+        setOpen(false);
+    };
+    useOnClickOutside(ref, handleClickOutsideArcMenu);
+
+    // Close arc menu on scroll
+    React.useEffect(() => {
+        if (!open) return;
+
+        const handleScroll = () => setOpen(false);
+        window.addEventListener('scroll', handleScroll, { passive: true });
+
+        return () => window.removeEventListener('scroll', handleScroll);
+    }, [open]);
+
+    const items = [
+        controls?.minimize
+            ? {
+                  id: 'minimize',
+                  icon: 'minus',
+                  label: 'Minimize',
+                  onClick: controls.minimize,
+              }
+            : null,
+        controls?.closeSession
+            ? {
+                  id: 'session-close',
+                  icon: 'xmark',
+                  label: 'Close for one session',
+                  onClick: controls.closeSession,
+              }
+            : null,
+        controls?.closePersistent
+            ? {
+                  id: 'persistent-close',
+                  icon: 'ban',
+                  label: "Don't show again",
+                  onClick: controls.closePersistent,
+              }
+            : null,
+    ].filter(Boolean) as Array<ArcMenuItem>;
+
+    const sharedMotionStyle = motionValues
+        ? {
+              x: motionValues.x,
+          }
+        : undefined;
+
+    return (
+        <ToolbarButton
+            ref={buttonRef}
+            title={open ? 'Hide options' : 'Hide toolbar'}
+            onClick={() => {
+                setOpen((v) => !v);
+            }}
+            motionValues={motionValues}
+            icon="eye-slash"
+        >
+            {/* Expanding arc menu */}
+            {open && (
+                <motion.div
+                    className={tcls('pointer-events-none absolute inset-0', styles.arcMenu)}
+                    style={sharedMotionStyle as React.CSSProperties | undefined}
+                >
+                    <div
+                        className={tcls(
+                            'pointer-events-none absolute left-0 overflow-visible',
+                            styles.arcMenuPath
+                        )}
+                        ref={ref}
+                    >
+                        {items.map((item, index) => (
+                            <ArcToolbarButton
+                                index={index}
+                                staggerIndex={items.length - 1 - index}
+                                key={item.icon}
+                                {...item}
+                                onClick={() => {
+                                    setOpen(false);
+                                    item.onClick?.();
+                                }}
+                            />
+                        ))}
+                    </div>
+                </motion.div>
+            )}
+        </ToolbarButton>
+    );
+}
+
+type ArcMenuItem = {
+    id: string;
+    icon: IconName;
+    label: string;
+    description: string;
+    onClick?: () => void;
+};
+
+type ArcToolbarButtonProps = Pick<ArcMenuItem, 'label' | 'icon' | 'onClick'> & {
+    index: number;
+    staggerIndex?: number;
+    disabled?: boolean;
+    className?: string;
+    iconClassName?: string;
+};
+
+export function ArcToolbarButton(props: ArcToolbarButtonProps) {
+    const {
+        index,
+        staggerIndex = index,
+        label,
+        disabled,
+        className,
+        onClick = () => {},
+        icon,
+        iconClassName,
+    } = props;
+
+    const targetOffset = `calc(var(--start-distance) + ${index} * var(--spread-distance))`;
+
+    // Calculate rotation based on position along the arc
+    const calculateRotation = () => {
+        return BASE_ROTATION_DEG - index * ROTATION_STEP_DEG;
+    };
+
+    const itemRotation = calculateRotation();
+
+    return (
+        <div className="pointer-events-none">
+            <button
+                type="button"
+                onClick={() => {
+                    onClick();
+                }}
+                style={
+                    {
+                        '--target-offset-distance': targetOffset,
+                        '--arc-duration': `${ARC_DURATION_SECONDS}s`,
+                        '--arc-delay': `${(staggerIndex ?? 0) * ARC_STAGGER_MS}ms`,
+                        '--rotation-offset': `${itemRotation}deg`,
+                        offsetPath: 'border-box',
+                        offsetDistance: targetOffset,
+                        offsetAnchor: '0% 40%',
+                        offsetRotate: `auto ${itemRotation}deg`,
+                    } as React.CSSProperties
+                }
+                className={tcls(
+                    'group',
+                    'absolute',
+                    'top-0',
+                    'left-0',
+                    'w-40',
+                    'opacity-0',
+                    'pointer-events-auto',
+                    'flex',
+                    'items-center',
+                    'gap-2',
+                    styles.arcMenuItem,
+                    className
+                )}
+            >
+                <div
+                    className={tcls(
+                        'flex shrink-0 items-center justify-center gap-1',
+                        'h-8 w-8 rounded-full border',
+                        'truncate text-sm',
+                        'cursor-pointer transition-colors',
+                        'group-hover:-rotate-5 group-hover:scale-105',
+                        disabled ? 'cursor-not-allowed opacity-50' : '',
+                        'text-tint-1 dark:text-tint-12',
+                        'bg-[linear-gradient(110deg,rgba(51,53,57,1)_0%,rgba(50,52,56,1)_100%)]',
+                        'dark:[background:linear-gradient(110deg,rgba(255,255,255,1)_0%,rgba(240,246,248,1)_100%)]',
+                        'border border-solid dark:border-[rgba(256,_256,_256,_0.06)]'
+                    )}
+                    style={{
+                        background: 'linear-gradient(rgb(51, 53, 57), rgb(50, 52, 56))',
+                    }}
+                >
+                    <Icon
+                        icon={icon as IconName}
+                        iconStyle={IconStyle.Solid}
+                        className={tcls('size-4 shrink-0 group-hover:scale-110', iconClassName)}
+                    />
+                </div>
+                <span
+                    className={tcls(
+                        'whitespace-nowrap rounded-lg px-3 py-1 font-normal text-sm transition-transform',
+                        'group-hover:rotate-2 group-hover:scale-105',
+                        'text-neutral-1 dark:text-neutral-12',
+                        'bg-[linear-gradient(110deg,rgba(51,53,57,1)_0%,rgba(50,52,56,1)_100%)]'
+                    )}
+                >
+                    {label}
+                </span>
+            </button>
+        </div>
+    );
+}
@@ -0,0 +1,40 @@
+.arcMenu {
+    --arc-width: 505px;
+    --arc-height: 400px;
+    --arc-radius: 34%;
+    --start-distance: -240px;
+    --spread-distance: 45px;
+}
+
+.arcMenuPath {
+    bottom: calc(var(--arc-height) / -2);
+    width: var(--arc-width);
+    height: var(--arc-height);
+    border-radius: var(--arc-radius);
+    transform: translate(0%, 0%);
+}
+
+.arcMenuItem {
+    animation-name: hide-toolbar-arc-enter;
+    animation-timing-function: cubic-bezier(0.22, 1, 0.36, 1);
+    animation-fill-mode: forwards;
+    animation-duration: var(--arc-duration, 0.4s);
+    animation-delay: var(--arc-delay, 0s);
+    transform-origin: center left;
+    offset-path: border-box;
+    offset-anchor: 0% 0%;
+    offset-rotate: auto var(--rotation-offset, 0deg);
+}
+
+@keyframes hide-toolbar-arc-enter {
+    from {
+        offset-distance: var(--start-distance);
+        transform: scale(0.5);
+        opacity: 0;
+    }
+    to {
+        offset-distance: var(--target-offset-distance);
+        transform: scale(1);
+        opacity: 1;
+    }
+}
@@ -1,27 +1,39 @@
 'use client';
-import { AnimatePresence, type MotionValue, motion, useReducedMotion } from 'motion/react';
+import {
+    AnimatePresence,
+    type MotionValue,
+    motion,
+    useReducedMotion,
+    useSpring,
+} from 'motion/react';
 import React from 'react';
 import { AnimatedLogo } from './AnimatedLogo';
+import { useToolbarControls } from './ToolbarControlsContext';

 import { tcls } from '@/lib/tailwind';
-import { Icon, type IconName } from '@gitbook/icons';
+import { Icon, type IconName, IconStyle } from '@gitbook/icons';
 import { Tooltip } from '../primitives';
-import { getCopyVariants, minifyButtonAnimation, toolbarEasings } from './transitions';
+import { getCopyVariants, toolbarEasings } from './transitions';
 import { useMagnificationEffect } from './useMagnificationEffect';

 const DURATION_LOGO_APPEARANCE = 2000;
 const DELAY_BETWEEN_LOGO_AND_CONTENT = 100;

 interface ToolbarProps {
-    children: React.ReactNode;
    label: React.ReactNode;
+    children: React.ReactNode;
+    minified: boolean;
+    onMinifiedChange: (value: boolean) => void;
 }

 export function Toolbar(props: ToolbarProps) {
-    const { children, label } = props;
-    const [minified, setMinified] = React.useState(true);
-    const [showToolbarControls, setShowToolbarControls] = React.useState(false);
+    const { children, label, minified, onMinifiedChange } = props;
+    const controls = useToolbarControls();
    const [isReady, setIsReady] = React.useState(false);
+    const autoExpandTriggeredRef = React.useRef(false);
+
+    const shouldAutoExpand = Boolean(controls?.shouldAutoExpand);
+    const [shouldAnimateLogo, setShouldAnimateLogo] = React.useState(shouldAutoExpand);

    // Wait for page to be ready, then show the toolbar
    React.useEffect(() => {
@@ -37,16 +49,41 @@ export function Toolbar(props: ToolbarProps) {
        }
    }, []);

-    // After toolbar appears, wait then show the full content
+    // After toolbar appears, wait, then show the full content
    React.useEffect(() => {
-        if (isReady) {
-            const expandAfterTimeout = setTimeout(() => {
-                setMinified(false);
-            }, DURATION_LOGO_APPEARANCE + DELAY_BETWEEN_LOGO_AND_CONTENT);
-
-            return () => clearTimeout(expandAfterTimeout);
+        if (!isReady || autoExpandTriggeredRef.current) {
+            return;
        }
-    }, [isReady]);
+
+        if (!shouldAutoExpand) {
+            // When we already know the toolbar should stay expanded (e.g. the user previously
+            // opened it this session) we short-circuit the auto-expand animation and immediately
+            // render the expanded state without replaying the logo animation.
+            autoExpandTriggeredRef.current = true;
+            setShouldAnimateLogo(false);
+            return;
+        }
+
+        autoExpandTriggeredRef.current = true;
+
+        // On a fresh session we let the toolbar appear in its compact form, play the logo
+        // animation, and only then expand the toolbar. The timeout mirrors the duration of the
+        // logo animation so both transitions feel connected.
+        const expandAfterTimeout = setTimeout(() => {
+            setShouldAnimateLogo(false);
+            onMinifiedChange(false);
+        }, DURATION_LOGO_APPEARANCE + DELAY_BETWEEN_LOGO_AND_CONTENT);
+
+        return () => clearTimeout(expandAfterTimeout);
+    }, [isReady, onMinifiedChange, shouldAutoExpand]);
+
+    React.useEffect(() => {
+        if (!minified) {
+            // Any manual expansion should stop the logo animation so the icon stays in its
+            // “settled” state once the toolbar is open.
+            setShouldAnimateLogo(false);
+        }
+    }, [minified]);

    // Don't render anything until page is ready
    if (!isReady) {
@@ -55,16 +92,13 @@ export function Toolbar(props: ToolbarProps) {

    return (
        <Tooltip label={label}>
-            <motion.div
-                onMouseEnter={() => setShowToolbarControls(true)}
-                onMouseLeave={() => setShowToolbarControls(false)}
-                className="-translate-x-1/2 fixed bottom-5 left-1/2 z-40 w-auto max-w-xl transform px-4"
-            >
+            <motion.div className="-translate-x-1/2 fixed bottom-5 left-1/2 z-40 w-auto max-w-xl transform px-4">
                <AnimatePresence mode="wait">
                    <motion.div
                        onClick={() => {
                            if (minified) {
-                                setMinified((prev) => !prev);
+                                setShouldAnimateLogo(false);
+                                onMinifiedChange(false);
                            }
                        }}
                        layout
@@ -78,37 +112,22 @@ export function Toolbar(props: ToolbarProps) {
                            'min-w-12',
                            'h-12',
                            'py-2',
-                            'border-tint-1/3',
                            'backdrop-blur-sm',
                            'origin-center',
-                            'bg-[linear-gradient(110deg,rgba(20,23,28,0.90)_0%,rgba(20,23,28,0.80)_100%)]',
-                            'dark:bg-[linear-gradient(110deg,rgba(256,256,256,0.90)_0%,rgba(256,256,256,0.80)_100%)]'
+                            'border-[0.5px] border-neutral-5 border-solid dark:border-neutral-8',
+                            'bg-[linear-gradient(45deg,rgba(39,39,39,0.8)_100%,rgba(39,39,39,0.4)_80%)]',
+                            'dark:bg-[linear-gradient(45deg,rgba(39,39,39,0.5)_100%,rgba(39,39,39,0.3)_80%)]'
                        )}
-                        initial={{
-                            scale: 1,
-                            opacity: 1,
-                        }}
-                        animate={{
-                            scale: 1,
-                            opacity: 1,
-                            boxShadow: minified
-                                ? '0 4px 40px 8px rgba(0, 0, 0, .2), 0 0 0 .5px rgba(0, 0, 0, .4), inset 0 .5px 0 0 hsla(0, 0%, 100%, .15)'
-                                : '0 4px 40px 8px rgba(0, 0, 0, .4), 0 0 0 .5px rgba(0, 0, 0, .8), inset 0 .5px 0 0 hsla(0, 0%, 100%, .3)',
-                        }}
                        style={{
                            borderRadius: '100px', // This is set on `style` so Framer Motion can correct for distortions
                        }}
                    >
                        {/* Logo with stroke segments animation in blue-tints */}
                        <motion.div layout>
-                            <AnimatedLogo />
+                            <AnimatedLogo shouldAnimate={shouldAnimateLogo} />
                        </motion.div>

                        {!minified ? children : null}
-
-                        {!minified && showToolbarControls && (
-                            <MinifyButton setMinified={setMinified} />
-                        )}
                    </motion.div>
                </AnimatePresence>
            </motion.div>
@@ -139,12 +158,15 @@ export function ToolbarButtonGroup(props: { children: React.ReactNode }) {
            className="flex items-center gap-1 overflow-visible pr-2 pl-4"
        >
            {buttonChildren.map((child, index) => {
-                const motionValues = buttonMotionValues[index];
                const childEl = child as React.ReactElement;
-                return React.cloneElement(childEl, {
-                    key: index,
-                    motionValues,
-                });
+                const childKey = childEl.key ?? `toolbar-button-${index}`;
+                return (
+                    <ToolbarButtonWrapper
+                        key={childKey}
+                        child={childEl}
+                        rawMotionValues={buttonMotionValues[index]}
+                    />
+                );
            })}
        </motion.div>
    );
@@ -158,15 +180,27 @@ export interface ToolbarButtonProps extends Omit<React.HTMLProps<HTMLAnchorEleme
    icon: IconName;
    iconClassName?: string;
    title?: React.ReactNode;
+    children?: React.ReactNode;
 }

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

    return (
-        <motion.div variants={toolbarEasings.staggeringChild}>
+        <motion.div variants={toolbarEasings.staggeringChild} className="relative" ref={ref}>
+            {children ? children : null}
            <Tooltip label={title}>
                <motion.a
                    href={href}
@@ -199,39 +233,77 @@ export function ToolbarButton(props: ToolbarButtonProps) {
                        'gap-1',
                        'text-sm',
                        'rounded-full',
-                        'border-neutral-500',
-                        'outline-neutral-800',
-                        'outline-1',
-                        'border',
                        'truncate',
                        'text-tint-1',
                        'dark:text-tint-12',
                        'cursor-pointer',
                        'transition-colors',
                        'size-8',
-                        'bg-tint-1/3',
-                        'hover:bg-tint-1/4',
-                        'dark:bg-tint-3',
-                        'dark:hover:bg-tint-1',
                        disabled ? 'cursor-not-allowed opacity-50' : '',
-                        'shadow-1xs'
+                        'border border-[rgba(256,_256,_256,_0.06)] border-solid',
+                        'bg-[linear-gradient(45deg,rgba(51,53,57,1)_0%,rgba(50,52,56,1)_100%)]'
                    )}
                >
-                    <Icon icon={icon} className={tcls('size-4', iconClassName)} />
+                    <Icon
+                        icon={icon}
+                        iconStyle={IconStyle.Solid}
+                        className={tcls(
+                            'size-4 shrink-0 group-hover:scale-110 group-hover:text-tint-3',
+                            iconClassName
+                        )}
+                    />
                </motion.a>
            </Tooltip>
        </motion.div>
    );
+});
+
+ToolbarButton.displayName = 'ToolbarButton';
+
+function ToolbarButtonWrapper(props: {
+    child: React.ReactElement;
+    rawMotionValues?: { scale: MotionValue<number>; x: MotionValue<number> };
+}) {
+    const { child, rawMotionValues } = props;
+
+    // Convert the raw motion values to smooth spring easings
+    const springScale = useSpring(rawMotionValues?.scale.get() ?? 1, {
+        stiffness: 400,
+        damping: 30,
+    });
+    const springX = useSpring(rawMotionValues?.x.get() ?? 0, { stiffness: 400, damping: 30 });
+
+    // Sync springs with raw motion values
+    React.useEffect(() => {
+        if (!rawMotionValues) return;
+
+        const unsubScale = rawMotionValues.scale.on('change', (v) => springScale.set(v));
+        const unsubX = rawMotionValues.x.on('change', (v) => springX.set(v));
+
+        return () => {
+            unsubScale();
+            unsubX();
+        };
+    }, [rawMotionValues, springScale, springX]);
+
+    const motionValues = {
+        scale: springScale,
+        x: springX,
+    };
+
+    return React.cloneElement(child, {
+        motionValues,
+    });
 }

 export function ToolbarSeparator() {
    return <div className="h-5 w-px bg-tint-1/3" />;
 }

-export function ToolbarTitle(props: { prefix: string; suffix: string }) {
+export function ToolbarTitle(props: { prefix?: string; suffix: string }) {
    return (
        <div className="flex items-center gap-1 text-xs ">
-            <ToolbarTitlePrefix title={props.prefix} />
+            {props.prefix ? <ToolbarTitlePrefix title={props.prefix} /> : null}
            <ToolbarTitleSuffix title={props.suffix} />
        </div>
    );
@@ -241,7 +313,7 @@ function ToolbarTitlePrefix(props: { title: string }) {
    return (
        <motion.span
            {...getCopyVariants(0)}
-            className="font-light text-neutral-7 dark:text-neutral-3"
+            className="truncate font-medium text-neutral-1 dark:text-neutral-12"
        >
            {props.title}
        </motion.span>
@@ -252,7 +324,7 @@ function ToolbarTitleSuffix(props: { title: string }) {
    return (
        <motion.span
            {...getCopyVariants(1)}
-            className="max-w-[24ch] truncate font-semibold text-neutral-3 dark:text-neutral-2"
+            className="max-w-[20ch] truncate text-neutral-1 dark:text-neutral-12"
        >
            {props.title}
        </motion.span>
@@ -263,36 +335,9 @@ export function ToolbarSubtitle(props: { subtitle: React.ReactNode }) {
    return (
        <motion.span
            {...getCopyVariants(1)}
-            className="text-neutral-7 text-xxs dark:text-neutral-2"
+            className="text-neutral-1/80 text-xxs dark:text-neutral-12/80"
        >
            {props.subtitle}
        </motion.span>
    );
 }
-
-function MinifyButton(props: { setMinified: (minified: boolean) => void }) {
-    return (
-        <Tooltip label="Minify">
-            <motion.div
-                {...minifyButtonAnimation}
-                transition={{
-                    duration: 0.2,
-                }}
-                whileHover={{
-                    scale: 1.05,
-                }}
-                onClick={(e) => {
-                    e.stopPropagation();
-                    props.setMinified(true);
-                }}
-                className={tcls(
-                    '-top-2 -right-4 absolute flex size-4 cursor-pointer items-center justify-center rounded-full border',
-                    'border-neutral-500 bg-neutral-700 hover:border-neutral-400 hover:bg-neutral-600',
-                    'dark:border-neutral-400 dark:bg-neutral-200 dark:hover:border-neutral-200 dark:hover:bg-neutral-100'
-                )}
-            >
-                <Icon icon="minus" className="size-2 text-neutral-1 dark:text-neutral-9" />
-            </motion.div>
-        </Tooltip>
-    );
-}
@@ -0,0 +1,27 @@
+'use client';
+import React from 'react';
+
+export interface ToolbarControlsContextValue {
+    minimize: () => void;
+    closeSession?: () => void;
+    closePersistent?: () => void;
+    shouldAutoExpand?: boolean;
+}
+
+const ToolbarControlsContext = React.createContext<ToolbarControlsContextValue | null>(null);
+
+/*
+ * Provides reusable state setters (mainly for hiding/showing the toolbar) for the toolbar controls propagated through to the children
+ */
+export function ToolbarControlsProvider(
+    props: React.PropsWithChildren<{ value: ToolbarControlsContextValue | null }>
+) {
+    const { children, value } = props;
+    return (
+        <ToolbarControlsContext.Provider value={value}>{children}</ToolbarControlsContext.Provider>
+    );
+}
+
+export function useToolbarControls() {
+    return React.useContext(ToolbarControlsContext);
+}
@@ -3,3 +3,4 @@ export * from './AdminToolbarClient';
 export * from './IframeWrapper';
 export * from './Toolbar';
 export * from './transitions';
+export * from './utils';
@@ -54,4 +54,7 @@ export type AdminToolbarContext = {

 export interface AdminToolbarClientProps {
    context: AdminToolbarContext;
+    onSessionClose?: () => void;
+    onPersistentClose?: () => void;
+    onToggleMinify?: () => void;
 }
@@ -1,11 +1,6 @@
-import { type MotionValue, motionValue } from 'framer-motion';
+import { type MotionValue, motionValue } from 'motion/react';
 import React from 'react';

-interface ButtonMotionValues {
-    scale: MotionValue<number>;
-    x: MotionValue<number>;
-}
-
 interface MagnificationConfig {
    /** Size of each button in pixels - used for spacing calculations */
    buttonSize?: number;
@@ -30,14 +25,9 @@ const defaultConfig: Required<MagnificationConfig> = {
    padding: 10, // Small buffer zone around container edges
 };

-// Helper functions for cleaner code
-const createMotionValues = (count: number): ButtonMotionValues[] =>
-    Array.from({ length: count }, () => ({
-        scale: motionValue(1),
-        x: motionValue(0),
-    }));
-
-const resetMotionValues = (motionValues: ButtonMotionValues[]) => {
+const resetMotionValues = (
+    motionValues: Array<{ scale: MotionValue<number>; x: MotionValue<number> }>
+) => {
    motionValues.forEach(({ scale, x }) => {
        scale.set(1);
        x.set(0);
@@ -62,23 +52,18 @@ const captureButtonPositions = (buttons: HTMLElement[]) => {

 const calculateScale = (
    mouseX: number,
-    mouseY: number,
    buttonCenterX: number,
-    buttonCenterY: number,
    containerRect: DOMRect,
    config: Required<MagnificationConfig>
 ) => {
-    // Calculate 2D distance from mouse to button center
-    const deltaX = mouseX - buttonCenterX;
-    const deltaY = mouseY - buttonCenterY;
-    const distance = Math.sqrt(deltaX * deltaX + deltaY * deltaY);
+    // Calculate only X-axis distance from mouse to button center
+    const distance = Math.abs(mouseX - buttonCenterX);

    if (distance > config.influenceRadius) return 1;

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

    // Define the "heart" zone - 8px from center (16x16px total area)
    const heartZoneRadius = 8;
@@ -155,13 +140,20 @@ export function useMagnificationEffect(props: {
    config?: MagnificationConfig;
 }) {
    const { childrenCount, containerRef, config } = props;
-    const [buttonMotionValues, setButtonMotionValues] = React.useState<ButtonMotionValues[]>([]);
    const originalPositionsRef = React.useRef<
        Array<{ left: number; width: number; top: number; height: number }>
    >([]);

    const finalConfig = React.useMemo(() => ({ ...defaultConfig, ...config }), [config]);

+    // Create basic motion values that will be consumed by springs in the components
+    const buttonMotionValues = React.useMemo(() => {
+        return Array.from({ length: childrenCount }, () => ({
+            scale: motionValue(1),
+            x: motionValue(0),
+        }));
+    }, [childrenCount]);
+
    React.useEffect(() => {
        const container = containerRef.current;
        if (!container) return;
@@ -175,11 +167,6 @@ export function useMagnificationEffect(props: {
            return;
        }

-        // Initialize motion values if button count changed
-        if (buttonMotionValues.length !== buttons.length) {
-            setButtonMotionValues(createMotionValues(buttons.length));
-        }
-
        const handleMouseMove = (event: MouseEvent) => {
            const buttons = Array.from(
                container.querySelectorAll('.toolbar-button')
@@ -211,15 +198,7 @@ export function useMagnificationEffect(props: {
                if (!pos) return { scale: 1, translateX: 0 };

                const buttonCenterX = pos.left + pos.width / 2;
-                const buttonCenterY = pos.top + pos.height / 2;
-                const scale = calculateScale(
-                    mouseX,
-                    mouseY,
-                    buttonCenterX,
-                    buttonCenterY,
-                    containerRect,
-                    finalConfig
-                );
+                const scale = calculateScale(mouseX, buttonCenterX, containerRect, finalConfig);
                return { scale, translateX: 0 };
            });

@@ -0,0 +1,154 @@
+import React from 'react';
+
+import {
+    getLocalStorageItem,
+    getSessionStorageItem,
+    removeSessionStorageItem,
+    setLocalStorageItem,
+    setSessionStorageItem,
+} from '@/lib/browser/local-storage';
+
+const STORAGE_KEY = 'gitbook_toolbar_closed';
+const SESSION_STORAGE_KEY = 'gitbook_toolbar_session_closed';
+const SESSION_MINIFIED_KEY = 'gitbook_toolbar_minified';
+
+type SessionHideReason = 'session' | 'persistent';
+
+/**
+ * Read the current session hide state. We store whether the toolbar was hidden “for session” or
+ * “persistently” so we can distinguish between a temporary dismissal and a user preference.
+ */
+export const getSessionHideState = (): { hidden: boolean; reason?: SessionHideReason } => {
+    const value = getSessionStorageItem<SessionHideReason | null>(SESSION_STORAGE_KEY, null);
+    if (value === 'session' || value === 'persistent') {
+        return { hidden: true, reason: value };
+    }
+    return { hidden: false, reason: undefined };
+};
+
+/**
+ * Persist the session hide state. Passing `false` clears the stored preference entirely.
+ */
+export const setSessionHidden = (value: boolean, reason?: SessionHideReason) => {
+    if (value && reason) {
+        setSessionStorageItem(SESSION_STORAGE_KEY, reason);
+    } else {
+        removeSessionStorageItem(SESSION_STORAGE_KEY);
+    }
+};
+
+/**
+ * Retrieve the last minified state from session storage. If no value was ever stored we return
+ * `undefined`, which signals that the toolbar should auto-expand once the logo animation finishes.
+ */
+export const getStoredMinified = (): boolean | undefined => {
+    const stored = getSessionStorageItem<boolean | null>(SESSION_MINIFIED_KEY, null);
+    if (stored === null || stored === undefined) {
+        removeSessionStorageItem(SESSION_MINIFIED_KEY);
+        return undefined;
+    }
+    return stored;
+};
+
+/**
+ * Persist the current minified state for the ongoing session.
+ */
+export const setStoredMinified = (value: boolean) => {
+    setSessionStorageItem(SESSION_MINIFIED_KEY, value);
+};
+
+interface UseToolbarVisibilityOptions {
+    onPersistentClose?: () => void;
+    onSessionClose?: () => void;
+    onToggleMinify?: () => void;
+}
+
+export function useToolbarVisibility(options: UseToolbarVisibilityOptions = {}) {
+    const { onPersistentClose, onSessionClose, onToggleMinify } = options;
+
+    const [initialStoredMinified] = React.useState<boolean | undefined>(() =>
+        typeof window !== 'undefined' ? getStoredMinified() : undefined
+    );
+    const shouldAutoExpand = initialStoredMinified === undefined;
+
+    const [minified, setMinifiedState] = React.useState<boolean>(() =>
+        initialStoredMinified !== undefined ? initialStoredMinified : true
+    );
+
+    const [persistentHidden, setPersistentHidden] = React.useState(() =>
+        getLocalStorageItem(STORAGE_KEY, false)
+    );
+
+    const [sessionReason, setSessionReason] = React.useState<SessionHideReason | undefined>(() => {
+        const state = getSessionHideState();
+        return state.hidden ? state.reason : undefined;
+    });
+
+    React.useEffect(() => {
+        if (typeof window === 'undefined') {
+            return;
+        }
+
+        const handleStorage = () => {
+            setPersistentHidden(getLocalStorageItem(STORAGE_KEY, false));
+            const state = getSessionHideState();
+            setSessionReason(state.hidden ? state.reason : undefined);
+        };
+
+        window.addEventListener('storage', handleStorage);
+        return () => window.removeEventListener('storage', handleStorage);
+    }, []);
+
+    React.useEffect(() => {
+        if (persistentHidden) {
+            if (sessionReason !== 'persistent') {
+                // Sync the session flag so we honour the persistent preference and avoid flashes when
+                // opening new tabs in the same browsing session.
+                setSessionHidden(true, 'persistent');
+                setSessionReason('persistent');
+            }
+            return;
+        }
+
+        if (sessionReason === 'persistent') {
+            // If the persistent preference was cleared we also clear the session flag so the toolbar
+            // can reappear immediately without requiring a full reload.
+            setSessionHidden(false);
+            setSessionReason(undefined);
+        }
+    }, [persistentHidden, sessionReason]);
+
+    const setMinified = (value: boolean) => {
+        setMinifiedState(value);
+        setStoredMinified(value);
+        onToggleMinify?.();
+    };
+
+    const minimize = () => setMinified(true);
+
+    const closeSession = () => {
+        setSessionHidden(true, 'session');
+        setSessionReason('session');
+        onSessionClose?.();
+    };
+
+    const closePersistent = () => {
+        setLocalStorageItem(STORAGE_KEY, true);
+        setPersistentHidden(true);
+        setSessionHidden(true, 'persistent');
+        setSessionReason('persistent');
+        onPersistentClose?.();
+    };
+
+    const hidden = persistentHidden || sessionReason === 'session';
+
+    return {
+        minified,
+        setMinified,
+        shouldAutoExpand,
+        hidden,
+        minimize,
+        closeSession,
+        closePersistent,
+    };
+}
@@ -25,7 +25,11 @@ export function Expandable(props: BlockProps<DocumentBlockExpandable>) {
    id = context.getId ? context.getId(id) : id;

    return (
-        <Details id={id} open={context.mode === 'print'} className={style}>
+        <Details
+            id={id}
+            open={context.mode === 'print'}
+            className={tcls('scroll-mt-(--content-scroll-margin)', style)}
+        >
            <summary
                className={tcls(
                    'cursor-pointer',
@@ -1,10 +1,23 @@
-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';
 import type { InlineProps } from './Inline';
+import { textColorToStyle } from './utils/colors';

 export async function InlineIcon(props: InlineProps<DocumentInlineIcon>) {
    const { inline } = props;
+    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={inline.data.icon as IconName} className="inline size-[1em]" />;
+    return (
+        <Icon
+            icon={icon}
+            className={tcls('inline size-[1em]', color ? textColorToStyle[color] : null)}
+        />
+    );
 }
@@ -317,10 +317,11 @@
 }

 .openapi-securities-oauth-flows {
-    @apply flex flex-col gap-2 divide-y divide-tint-subtle;
+    @apply flex flex-col gap-3;
 }

-.openapi-securities-oauth-content {
+.openapi-securities-oauth-content,
+.openapi-securities-scopes {
    @apply prose *:!prose-sm *:text-tint;
 }

@@ -328,7 +329,7 @@
    @apply text-xs;
 }

-.openapi-securities-oauth-content ul {
+.openapi-securities-scopes ul {
    @apply !my-0;
 }

@@ -12,7 +12,8 @@ import type {
 } from '@gitbook/api';
 import React from 'react';

-import { type ClassValue, tcls } from '@/lib/tailwind';
+import { tcls } from '@/lib/tailwind';
+import { backgroundColorToStyle, textColorToStyle } from './utils/colors';

 export function Text(props: { text: DocumentText }) {
    const { text } = props;
@@ -121,51 +122,3 @@ function Color(props: MarkedLeafProps<DocumentMarkColor>) {
        </span>
    );
 }
-
-/**
- * @TODO replace by DocumentMarkColor['data']['text'] and DocumentMarkColor['data']['background']
- * once the API is updated.
- */
-type DocumentMarkColorValue =
-    | 'default'
-    | 'green'
-    | 'blue'
-    | 'red'
-    | 'orange'
-    | 'yellow'
-    | 'purple'
-    | '$primary'
-    | '$info'
-    | '$success'
-    | '$warning'
-    | '$danger';
-
-const textColorToStyle: { [color in DocumentMarkColorValue]: ClassValue } = {
-    default: [],
-    blue: ['text-blue-500'],
-    red: ['text-red-500'],
-    green: ['text-green-500'],
-    yellow: ['text-yellow-600'],
-    purple: ['text-purple-500'],
-    orange: ['text-orange-500'],
-    $primary: ['text-primary'],
-    $info: ['text-info'],
-    $success: ['text-success'],
-    $warning: ['text-warning'],
-    $danger: ['text-danger'],
-};
-
-const backgroundColorToStyle: { [color in DocumentMarkColorValue]: ClassValue } = {
-    default: [],
-    blue: ['bg-mark-blue'],
-    red: ['bg-mark-red'],
-    green: ['bg-mark-green'],
-    yellow: ['bg-mark-yellow'],
-    purple: ['bg-mark-purple'],
-    orange: ['bg-mark-orange'],
-    $primary: ['bg-primary'],
-    $info: ['bg-info'],
-    $success: ['bg-success'],
-    $warning: ['bg-warning'],
-    $danger: ['bg-danger'],
-};
@@ -0,0 +1,34 @@
+import type { ClassValue } from '@/lib/tailwind';
+import type { DocumentMarkColor } from '@gitbook/api';
+
+export const textColorToStyle: { [color in DocumentMarkColor['data']['text']]: ClassValue } = {
+    default: [],
+    blue: ['text-blue-500'],
+    red: ['text-red-500'],
+    green: ['text-green-500'],
+    yellow: ['text-yellow-600'],
+    purple: ['text-purple-500'],
+    orange: ['text-orange-500'],
+    $primary: ['text-primary'],
+    $info: ['text-info'],
+    $success: ['text-success'],
+    $warning: ['text-warning'],
+    $danger: ['text-danger'],
+};
+
+export const backgroundColorToStyle: {
+    [color in DocumentMarkColor['data']['background']]: ClassValue;
+} = {
+    default: [],
+    blue: ['bg-mark-blue'],
+    red: ['bg-mark-red'],
+    green: ['bg-mark-green'],
+    yellow: ['bg-mark-yellow'],
+    purple: ['bg-mark-purple'],
+    orange: ['bg-mark-orange'],
+    $primary: ['bg-primary'],
+    $info: ['bg-info'],
+    $success: ['bg-success'],
+    $warning: ['bg-warning'],
+    $danger: ['bg-danger'],
+};
@@ -23,6 +23,12 @@ export function Header(props: {
    const { context, withTopHeader, withVariants } = props;
    const { siteSpace, siteSpaces, sections, customization } = context;

+    const withSections = Boolean(
+        sections &&
+            (sections.list.length > 1 || // Show section tabs if there are at least 2 sections or at least 1 section group
+                sections.list.some((s) => s.object === 'site-section-group'))
+    );
+
    return (
        <header
            id="site-header"
@@ -144,7 +150,7 @@ export function Header(props: {
                        </div>

                        {customization.header.links.length > 0 ||
-                        (!sections && withVariants === 'translations') ? (
+                        (!withSections && withVariants === 'translations') ? (
                            <HeaderLinks>
                                {customization.header.links.length > 0 ? (
                                    <>
@@ -164,7 +170,7 @@ export function Header(props: {
                                        />
                                    </>
                                ) : null}
-                                {!sections && withVariants === 'translations' ? (
+                                {!withSections && withVariants === 'translations' ? (
                                    <TranslationsDropdown
                                        context={context}
                                        siteSpace={siteSpace}
@@ -178,9 +184,7 @@ export function Header(props: {
                </div>
            </div>

-            {sections &&
-            (sections.list.length > 1 || // Show section tabs if there are at least 2 sections or at least 1 section group
-                sections.list.some((s) => s.object === 'site-section-group')) ? (
+            {sections && withSections ? (
                <div className="transition-[padding] duration-300 lg:chat-open:pr-80 xl:chat-open:pr-96">
                    <SiteSectionTabs sections={encodeClientSiteSections(context, sections)}>
                        {withVariants === 'translations' ? (
@@ -22,12 +22,17 @@ export function SiteLayoutClientContexts(props: {
    useClearRouterCache(contextId);

    return (
-        <NuqsAdapter>
-            <ThemeProvider attribute="class" enableSystem forcedTheme={forcedTheme}>
+        <ThemeProvider
+            attribute="class"
+            disableTransitionOnChange
+            enableSystem
+            forcedTheme={forcedTheme}
+        >
+            <NuqsAdapter>
                <LinkSettingsContext.Provider value={{ externalLinksTarget }}>
                    <SearchContextProvider>{children}</SearchContextProvider>
                </LinkSettingsContext.Provider>
-            </ThemeProvider>
-        </NuqsAdapter>
+            </NuqsAdapter>
+        </ThemeProvider>
    );
 }
@@ -2,6 +2,7 @@ import { de } from './de';
 import { en } from './en';
 import { es } from './es';
 import { fr } from './fr';
+import { it } from './it';
 import { ja } from './ja';
 import { nl } from './nl';
 import { no } from './no';
@@ -15,8 +16,9 @@ export * from './types';
 export const languages = {
    de,
    en,
-    fr,
    es,
+    fr,
+    it,
    zh,
    ja,
    nl,
@@ -0,0 +1,133 @@
+import type { TranslationLanguage } from './types';
+
+export const it: TranslationLanguage = {
+    locale: 'it',
+    powered_by_gitbook: 'Offerto da GitBook',
+    sponsored_via_gitbook: 'Sponsorizzato tramite GitBook',
+    switch_to_dark_theme: 'Passa al tema scuro',
+    switch_to_light_theme: 'Passa al tema chiaro',
+    switch_to_system_theme: 'Passa al tema di sistema',
+    search: 'Cerca',
+    search_or_ask: 'Chiedi o cerca',
+    search_input_placeholder: 'Cerca contenuti',
+    search_ask_input_placeholder: 'Cerca contenuti o fai una domanda',
+    search_no_results_for: 'Nessun risultato per "${1}".',
+    search_no_results: 'Nessun risultato',
+    search_results_count: '${1} risultati',
+    search_page_result_title: 'Pagina con titolo ${1}',
+    search_section_result_title: 'Sezione con titolo ${1}',
+    search_section_result_content: 'Sezione con contenuto ${1}',
+    search_section_result_default: 'Sezione',
+    search_scope_current: '${1}',
+    search_scope_all: 'Ovunque',
+    search_scope_include_all_title: 'Includi tutte le varianti',
+    search_scope_include_all_description: 'Cerca contenuti in ogni lingua/versione',
+    ask: 'Chiedi',
+    search_ask: 'Chiedi "${1}"',
+    search_ask_description: 'Trova la risposta con ${1}',
+    search_ask_sources: 'Fonti',
+    search_ask_sources_no_answer: 'Pagine correlate',
+    search_ask_no_answer:
+        'Non è stato possibile trovare una risposta alla tua domanda. Prova a riformularla o a essere più specifico.',
+    search_ask_error: 'Qualcosa è andato storto. Riprova più tardi.',
+    on_this_page: 'In questa pagina',
+    next_page: 'Successivo',
+    previous_page: 'Precedente',
+    page_last_modified: 'Ultimo aggiornamento ${1}',
+    was_this_helpful: 'È stato utile?',
+    was_this_helpful_positive: 'Sì, lo è stato!',
+    was_this_helpful_neutral: 'Non sono sicuro',
+    was_this_helpful_negative: 'No',
+    was_this_helpful_thank_you: 'Grazie!',
+    was_this_helpful_comment: "Vuoi aggiungere qualcos'altro?",
+    was_this_helpful_positive_label: 'Utile',
+    was_this_helpful_negative_label: 'Non utile',
+    submit: 'Invia',
+    annotation_button_label: 'Apri annotazione',
+    code_copied: 'Copiato!',
+    code_copy: 'Copia',
+    table_of_contents_button_label: 'Apri indice dei contenuti',
+    cookies_title: 'Cookie',
+    cookies_prompt:
+        'Questo sito utilizza i cookie per fornire il servizio e analizzare il traffico. Navigando su questo sito accetti la ${1}.',
+    cookies_prompt_privacy: 'informativa sulla privacy',
+    cookies_accept: 'Accetta',
+    cookies_reject: 'Rifiuta',
+    close: 'Chiudi',
+    view: 'Visualizza',
+    edit_on_git: 'Modifica su ${1}',
+    edit: 'Modifica',
+    notfound_title: 'Pagina non trovata',
+    notfound_link: 'Questo link punta a una pagina che è stata rimossa o non esiste più.',
+    notfound: 'La pagina che cerchi non esiste.',
+    unexpected_error_title: 'Si è verificato un errore',
+    unexpected_error: 'Spiacenti, si è verificato un errore imprevisto. Riprova più tardi.',
+    unexpected_error_retry: 'Riprova',
+    pdf_download: 'Esporta in PDF',
+    pdf_goback: 'Torna al contenuto',
+    pdf_print: 'Stampa o salva come PDF',
+    pdf_page_of: '${1} di ${2}',
+    pdf_mode_only_page: 'Solo questa pagina',
+    pdf_mode_all: 'Tutte le pagine',
+    pdf_limit_reached:
+        'Impossibile generare il PDF per ${1} pagine, la generazione si è fermata a ${2}.',
+    pdf_limit_reached_continue: 'Estendi con altre ${1} pagine.',
+    more: 'Altro',
+    link_tooltip_external_link: 'Link esterno a',
+    link_tooltip_email: "Invia un'email a",
+    link_tooltip_page_anchor: 'Vai alla sezione',
+    open_in_new_tab: 'Apri in una nuova scheda',
+    ai_chat_assistant_name: 'Assistente GitBook',
+    ai_chat_assistant_name_unbranded: 'Assistente AI',
+    ai_chat_assistant_description: 'Sono qui per aiutarti con la documentazione.',
+    ai_chat_assistant_greeting_morning: 'Buongiorno',
+    ai_chat_assistant_greeting_afternoon: 'Buon pomeriggio',
+    ai_chat_assistant_greeting_evening: 'Buonasera',
+    ai_chat_assistant_greeting_night: 'Buonanotte',
+    ai_chat_clear_conversation: 'Cancella conversazione',
+    ai_chat_thinking: 'Sto pensando...',
+    ai_chat_working: 'Sto lavorando...',
+    ai_chat_context_badge: 'IA',
+    ai_chat_error: 'Qualcosa è andato storto.',
+    ai_chat_hold_message_1: 'Ci sto pensando…',
+    ai_chat_hold_message_2: 'Un momento…',
+    ai_chat_context_title: 'Basato sul tuo contesto',
+    ai_chat_context_description:
+        "L'assistente usa l'IA e il tuo contesto per generare risposte ed eseguire azioni.",
+    ai_chat_context_pages_youve_read: 'Pagine che hai letto',
+    ai_chat_context_info_provided_by_the_site: 'Informazioni fornite dal sito',
+    ai_chat_context_previous_messages: 'Messaggi precedenti',
+    ai_chat_context_disclaimer: "Le risposte dell'IA possono contenere errori.",
+    ai_chat_input_placeholder: 'Chiedi, cerca o spiega...',
+    send: 'Invia',
+    actions: 'Azioni',
+    ai_chat_suggested_questions_title: 'Domande suggerite',
+    ai_chat_suggested_questions_about_this_page: 'Di cosa parla questa pagina?',
+    ai_chat_suggested_questions_read_next: 'Cosa dovrei leggere dopo?',
+    ai_chat_suggested_questions_example: 'Puoi fare un esempio?',
+    searched_for: 'Ricerca per ${1}',
+    ai_chat_tools_listed_pages: 'Ha esplorato la documentazione',
+    ai_chat_tools_read_page: 'Ha letto la pagina ${1}',
+    ai_chat_tools_mcp_tool: 'Ha chiamato ${1}',
+    ai_chat_ask: 'Chiedi a ${1}',
+    ai_chat_ask_about_page: 'Chiedi a ${1} di questa pagina',
+    copy_for_llms: 'Copia per LLM',
+    copy_page_markdown: 'Copia la pagina come Markdown per LLM',
+    copy_page: 'Copia pagina',
+    view_page_markdown: 'Visualizza come Markdown',
+    view_page_plaintext: 'Visualizza questa pagina come testo semplice',
+    open_in: 'Apri in ${1}',
+    open_in_llms_pre_prompt: 'Leggi ${1} e rispondi alle domande sul contenuto.',
+    connect_mcp_to: 'Connetti a ${1}',
+    install_mcp_on: 'Installa il server MCP su ${1}',
+    connect_with_mcp: 'Connettiti con MCP',
+    copy_mcp_url: "Copia l'URL del server MCP",
+    press_to_confirm: 'Premi ${1} per confermare',
+    tool_call_skipped: 'Saltato "${1}"',
+    scroll_back: 'Scorri indietro',
+    scroll_further: 'Scorri ancora',
+    hint_info: 'Informazioni',
+    hint_warning: 'Avviso',
+    hint_danger: 'Pericolo',
+    hint_success: 'Successo',
+};
@@ -1,13 +1,13 @@
 import { checkIsSecurityError } from './security-error';

 /**
- * Get an item from local storage safely.
+ * Reusable function to read from any kind of Storage
 */
-export function getLocalStorageItem<T>(key: string, defaultValue: T): T {
+function readStorage<T>(storage: Storage | undefined, key: string, defaultValue: T): T {
    try {
-        if (typeof localStorage !== 'undefined' && localStorage && 'getItem' in localStorage) {
-            const stored = localStorage.getItem(key);
-            return stored ? (JSON.parse(stored) as T) : defaultValue;
+        if (storage && 'getItem' in storage) {
+            const stored = storage.getItem(key);
+            return stored !== null ? (JSON.parse(stored) as T) : defaultValue;
        }
        return defaultValue;
    } catch (error) {
@@ -19,12 +19,12 @@ export function getLocalStorageItem<T>(key: string, defaultValue: T): T {
 }

 /**
- * Set an item in local storage safely.
+ * Reusable function to write to any kind of Storage
 */
-export function setLocalStorageItem(key: string, value: unknown) {
+function writeStorage(storage: Storage | undefined, key: string, value: unknown) {
    try {
-        if (typeof localStorage !== 'undefined' && localStorage && 'setItem' in localStorage) {
-            localStorage.setItem(key, JSON.stringify(value));
+        if (storage && 'setItem' in storage) {
+            storage.setItem(key, JSON.stringify(value));
        }
    } catch (error) {
        if (checkIsSecurityError(error)) {
@@ -33,3 +33,59 @@ export function setLocalStorageItem(key: string, value: unknown) {
        throw error;
    }
 }
+
+function removeStorage(storage: Storage | undefined, key: string) {
+    try {
+        if (storage && 'removeItem' in storage) {
+            storage.removeItem(key);
+        }
+    } catch (error) {
+        if (checkIsSecurityError(error)) {
+            return;
+        }
+        throw error;
+    }
+}
+
+/**
+ * Get an item from local storage safely.
+ */
+export function getLocalStorageItem<T>(key: string, defaultValue: T): T {
+    return readStorage(
+        typeof localStorage !== 'undefined' ? localStorage : undefined,
+        key,
+        defaultValue
+    );
+}
+
+/**
+ * Set an item in local storage safely.
+ */
+export function setLocalStorageItem(key: string, value: unknown) {
+    writeStorage(typeof localStorage !== 'undefined' ? localStorage : undefined, key, value);
+}
+
+/**
+ * Get an item from session storage safely.
+ */
+export function getSessionStorageItem<T>(key: string, defaultValue: T): T {
+    return readStorage(
+        typeof sessionStorage !== 'undefined' ? sessionStorage : undefined,
+        key,
+        defaultValue
+    );
+}
+
+/**
+ * Set an item in session storage safely.
+ */
+export function setSessionStorageItem(key: string, value: unknown) {
+    writeStorage(typeof sessionStorage !== 'undefined' ? sessionStorage : undefined, key, value);
+}
+
+/**
+ * Remove an item from session storage safely.
+ */
+export function removeSessionStorageItem(key: string) {
+    removeStorage(typeof sessionStorage !== 'undefined' ? sessionStorage : undefined, key);
+}
@@ -1,9 +1,11 @@
 import type { GitBookAnyContext } from '@/lib/context';
 import type { DocumentBlock, JSONDocument } from '@gitbook/api';

+import { getDataOrNull } from './data';
 import { getNodeText } from './document';
 import { resolveOpenAPIOperationBlock } from './openapi/resolveOpenAPIOperationBlock';
 import { resolveOpenAPISchemasBlock } from './openapi/resolveOpenAPISchemasBlock';
+import { resolveContentRef } from './references';

 export interface DocumentSection {
    id: string;
@@ -28,10 +30,11 @@ export async function getDocumentSections(
 */
 async function getSectionsFromNodes(
    nodes: DocumentBlock[],
-    context: GitBookAnyContext
+    context: GitBookAnyContext,
+    initialDepth = 0
 ): Promise<DocumentSection[]> {
    const sections: DocumentSection[] = [];
-    let depth = 0;
+    let depth = initialDepth;

    for (const block of nodes) {
        switch (block.type) {
@@ -64,7 +67,9 @@ async function getSectionsFromNodes(
            }
            case 'stepper': {
                const stepNodes = await Promise.all(
-                    block.nodes.map(async (step) => getSectionsFromNodes(step.nodes, context))
+                    block.nodes.map(async (step) =>
+                        getSectionsFromNodes(step.nodes, context, depth)
+                    )
                );
                for (const stepSections of stepNodes) {
                    sections.push(...stepSections);
@@ -116,6 +121,39 @@ async function getSectionsFromNodes(
                }
                continue;
            }
+            case 'reusable-content': {
+                const dataFetcher = block.meta?.token
+                    ? context.dataFetcher.withToken({ apiToken: block.meta.token })
+                    : context.dataFetcher;
+
+                const resolved = await resolveContentRef(block.data.ref, {
+                    ...context,
+                    dataFetcher,
+                });
+                if (!resolved) {
+                    continue;
+                }
+                const { reusableContent } = resolved;
+                if (!reusableContent) {
+                    continue;
+                }
+                const document = await getDataOrNull(
+                    dataFetcher.getRevisionReusableContentDocument({
+                        spaceId: reusableContent.context.space.id,
+                        revisionId: reusableContent.context.revisionId,
+                        reusableContentId: reusableContent.revisionReusableContent.id,
+                    })
+                );
+                if (!document) {
+                    continue;
+                }
+                const reusableContentSections = await getSectionsFromNodes(
+                    document.nodes,
+                    reusableContent.context,
+                    depth
+                );
+                sections.push(...reusableContentSections);
+            }
        }
    }

@@ -18,6 +18,7 @@ export type ResponseCookie = {
        sameSite: boolean | 'lax' | 'strict' | 'none' | undefined;
        secure: boolean;
        maxAge: number;
+        path: string;
    }>;
 };

@@ -296,16 +296,41 @@ async function serveSiteRoutes(requestURL: URL, request: NextRequest) {
        requestHeaders.set(MiddlewareHeaders.SiteURLData, JSON.stringify(stableSiteURLData));

        // Preview of customization/theme
-        const customization = siteRequestURL.searchParams.get('customization');
+        const customizationCookie = request.cookies.get(MiddlewareHeaders.Customization);
+        const customization =
+            siteRequestURL.searchParams.get('customization') ??
+            (customizationCookie ? decodeURIComponent(customizationCookie.value) : undefined);
        if (customization && validateSerializedCustomization(customization)) {
            routeType = 'dynamic';
            // We need to encode the customization headers, otherwise it will fail for some customization values containing non ASCII chars on vercel.
            requestHeaders.set(MiddlewareHeaders.Customization, encodeURIComponent(customization));
+            cookies.push({
+                name: MiddlewareHeaders.Customization,
+                value: encodeURIComponent(customization),
+                options: {
+                    httpOnly: true,
+                    sameSite: 'lax',
+                    maxAge: 10 * 60, // 10 minutes
+                    path: '/url/preview', // Only send the cookie to preview routes
+                },
+            });
        }
-        const theme = siteRequestURL.searchParams.get('theme');
+        const theme =
+            siteRequestURL.searchParams.get('theme') ??
+            request.cookies.get(MiddlewareHeaders.Theme)?.value;
        if (theme === CustomizationThemeMode.Dark || theme === CustomizationThemeMode.Light) {
            routeType = 'dynamic';
            requestHeaders.set(MiddlewareHeaders.Theme, theme);
+            cookies.push({
+                name: MiddlewareHeaders.Theme,
+                value: theme,
+                options: {
+                    httpOnly: true,
+                    sameSite: 'lax',
+                    maxAge: 10 * 60, // 10 minutes
+                    path: '/url/preview', // Only send the cookie to preview routes
+                },
+            });
        }

        // We support forcing dynamic routes by setting a `gitbook-dynamic-route` cookie
@@ -1,5 +1,17 @@
 # @gitbook/icons

+## 0.3.3
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+
+## 0.3.2
+
+### Patch Changes
+
+- 295f03d: Republish packages
+
 ## 0.3.1

 ### Patch Changes
@@ -12,11 +12,10 @@
            "development": "./src/icons.ts",
            "default": "./dist/icons.js"
        },
-        "./style.css": {
-            "default": "./src/style.css"
-        }
+        "./style.css": "./src/style.css"
    },
-    "version": "0.3.1",
+    "sideEffects": false,
+    "version": "0.3.3",
    "dependencies": {
        "@fortawesome/fontawesome-svg-core": "^6.6.0",
        "@fortawesome/fontawesome-free": "^6.6.0"
@@ -25,24 +24,30 @@
        "@gitbook/fontawesome-pro": "1.0.15"
    },
    "devDependencies": {
-        "typescript": "^5.5.3"
+        "react": "catalog:",
+        "tsdown": "catalog:",
+        "typescript": "catalog:"
    },
    "peerDependencies": {
        "react": "*"
    },
    "scripts": {
        "generate": "bun ./bin/gen-list.js",
-        "build": "tsc --project tsconfig.build.json",
+        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "dev": "tsc -w",
+        "dev": "bun run build -- --watch ./src",
        "clean": "rm -rf ./dist && rm -rf ./src/data",
        "unit": "bun test"
    },
    "bin": {
        "gitbook-icons": "./bin/gitbook-icons.js"
    },
-    "files": ["dist", "src", "bin", "README.md", "CHANGELOG.md"],
+    "files": ["dist", "bin", "README.md", "CHANGELOG.md"],
    "engines": {
        "node": ">=20.0.0"
+    },
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
    }
 }
@@ -1,4 +0,0 @@
-{
-    "extends": "./tsconfig.json",
-    "exclude": ["node_modules", "src/**/*.test.ts"]
-}
@@ -2,8 +2,7 @@ import { defineConfig } from 'tsdown';

 export default defineConfig([
    {
-        entry: ['src/index.ts'],
-        dts: true,
-        format: ['esm'],
+        entry: ['src/index.ts', 'src/icons.ts'],
+        unbundle: true,
    },
 ]);
@@ -1,5 +1,17 @@
 # @gitbook/openapi-parser

+## 3.0.4
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+
+## 3.0.3
+
+### Patch Changes
+
+- 295f03d: Republish packages
+
 ## 3.0.2

 ### Patch Changes
@@ -5,11 +5,10 @@
    "exports": {
        ".": {
            "types": "./dist/index.d.ts",
-            "development": "./src/index.ts",
            "default": "./dist/index.js"
        }
    },
-    "version": "3.0.2",
+    "version": "3.0.4",
    "sideEffects": false,
    "dependencies": {
        "@scalar/json-magic": "^0.3.1",
@@ -17,18 +16,23 @@
        "@scalar/openapi-types": "^0.3.7"
    },
    "devDependencies": {
-        "@tsconfig/strictest": "^2.0.5",
-        "@tsconfig/node20": "^20.1.4",
+        "@tsconfig/strictest": "^2.0.6",
+        "@tsconfig/node20": "^20.1.6",
        "@types/swagger2openapi": "^7.0.4",
-        "bun-types": "^1.1.20",
-        "typescript": "^5.5.3"
+        "bun-types": "catalog:",
+        "tsdown": "catalog:",
+        "typescript": "catalog:"
    },
    "scripts": {
-        "build": "tsc --project tsconfig.build.json",
+        "build": "tsdown",
        "typecheck": "tsc --noEmit",
        "unit": "bun test",
-        "dev": "bun run build -- --watch",
+        "dev": "bun run build -- --watch ./src",
        "clean": "rm -rf ./dist"
    },
-    "files": ["dist", "src", "README.md", "CHANGELOG.md"]
+    "files": ["dist", "README.md", "CHANGELOG.md"],
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
 }
@@ -1,10 +0,0 @@
-{
-    "$schema": "https://json.schemastore.org/tsconfig",
-    "extends": ["./tsconfig.json"],
-    "exclude": ["**/*.test.ts"],
-    "compilerOptions": {
-        "declaration": true,
-        "noEmit": false,
-        "outDir": "dist"
-    }
-}
@@ -1,5 +1,22 @@
 # @gitbook/react-contentkit

+## 0.7.7
+
+### Patch Changes
+
+- 6142d6b: Mark as sideEffects, fix all package bundles
+- Updated dependencies [6142d6b]
+  - @gitbook/icons@0.3.3
+
+## 0.7.6
+
+### Patch Changes
+
+- bdde392: Fix web frame height calculation
+- 295f03d: Republish packages
+- Updated dependencies [295f03d]
+  - @gitbook/icons@0.3.2
+
 ## 0.7.5

 ### Patch Changes
@@ -1,29 +1,36 @@
 {
    "name": "@gitbook/react-contentkit",
-    "version": "0.7.5",
+    "version": "0.7.7",
+    "type": "module",
    "exports": {
        ".": {
            "types": "./dist/index.d.ts",
-            "development": "./src/index.ts",
            "default": "./dist/index.js"
        }
    },
+    "sideEffects": false,
    "dependencies": {
-        "classnames": "^2.5.1",
+        "classnames": "catalog:",
        "@gitbook/api": "catalog:",
-        "@gitbook/icons": "workspace:*"
+        "@gitbook/icons": "workspace:*",
+        "usehooks-ts": "catalog:"
    },
    "peerDependencies": {
        "react": "*"
    },
    "devDependencies": {
-        "typescript": "^5.5.3"
+        "tsdown": "catalog:",
+        "typescript": "catalog:"
    },
    "scripts": {
-        "build": "tsc",
+        "build": "tsdown",
        "typecheck": "tsc --noEmit",
-        "dev": "tsc -w",
+        "dev": "bun run build -- --watch ./src",
        "clean": "rm -rf ./dist"
    },
-    "files": ["dist", "src", "README.md", "CHANGELOG.md"]
+    "files": ["dist", "README.md", "CHANGELOG.md"],
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
 }
@@ -2,7 +2,9 @@

 import type { ContentKitWebFrame } from '@gitbook/api';
 import React from 'react';
+import { useResizeObserver } from 'usehooks-ts';

+import { Icon } from '@gitbook/icons';
 import { useContentKitClientContext } from './context';
 import { resolveDynamicBinding } from './dynamic';
 import type { ContentKitClientElementProps } from './types';
@@ -47,9 +49,7 @@ export function ElementWebframe(props: ContentKitClientElementProps<ContentKitWe
        [renderer.security]
    );

-    //
-    // Listen to message coming from the webframe
-    //
+    // Listen to messages coming from the webframe
    React.useEffect(() => {
        const callback = (event: MessageEvent) => {
            if (!iframeRef.current) {
@@ -83,7 +83,7 @@ export function ElementWebframe(props: ContentKitClientElementProps<ContentKitWe
                    // https://docs.embed.ly/reference/provider-height-resizing
                    const parsed = JSON.parse(message);
                    if (parsed.context === 'iframe.resize' && typeof parsed.height === 'number') {
-                        const width = contentWindow.outerWidth;
+                        const width = iframeRef.current.clientWidth;
                        const height = parsed.height;

                        setSize({
@@ -145,9 +145,7 @@ export function ElementWebframe(props: ContentKitClientElementProps<ContentKitWe
        };
    }, [renderer, sendMessage]);

-    //
    // Send data to the webframe
-    //
    React.useEffect(() => {
        if (!element.data) {
            return;
@@ -161,12 +159,20 @@ export function ElementWebframe(props: ContentKitClientElementProps<ContentKitWe
        return sendMessage({ state });
    }, [element.data, renderer.state, sendMessage]);

-    if (!mounted) {
-        return null;
-    }
+    const { width: observedWidth = 0 } = useResizeObserver({ ref: iframeRef });
+    const liveWidth = observedWidth || iframeRef.current?.clientWidth || 0;

    const aspectRatio = size.aspectRatio || element.aspectRatio;

+    const height =
+        liveWidth && aspectRatio && liveWidth > (size.height ?? 0)
+            ? Math.min(Math.round(liveWidth / aspectRatio), size.height ?? 32)
+            : 'auto';
+
+    if (!mounted) {
+        return <Icon icon="spinner" className="contentkit-button-loading" style={{ height }} />;
+    }
+
    return (
        <iframe
            ref={iframeRef}
@@ -179,7 +185,8 @@ export function ElementWebframe(props: ContentKitClientElementProps<ContentKitWe
                width: '100%',
                maxWidth: '100%',
                aspectRatio,
-                height: size.height ? Math.max(size.height, 32) : '100%',
+                maxHeight: height,
+                height: 'fit-content',
                border: 'none',
            }}
        />
--- 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