wip

Improve icon stabilization (#3147 )
2026-09-13 14:19:25 +00:00 · 2025-04-13 10:02:36 +02:00 · 2025-04-13 09:06:01 +02:00 · 2025-04-13 05:41:47 +00:00 · 2025-04-12 17:44:23 -07:00 · 2025-04-12 07:18:26 -07:00
73 changed files with 1823 additions and 1091 deletions
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Cache AI Page Link summary
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Tweak footer design (and refactor)
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix security issue with injection of "javacript:` url in the back button of PDFs
@@ -1,5 +0,0 @@
---
-"gitbook-v2": patch
---
-
-Fix incoming URL for requests that were proxied
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Implement retry logic for the DO cache to prevent when revalidating content.
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add superscript and subscript text rendering
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Fix OpenAPISchemas description padding
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Add support for buttons to GitBook.
@@ -1,5 +0,0 @@
---
-"@gitbook/colors": patch
---
-
-Desaturate text colors by decreasing chroma for the last steps of the color scale
@@ -1,6 +0,0 @@
---
-'@gitbook/react-openapi': patch
-'gitbook': patch
---
-
-Improve OpenAPI schema style
@@ -1,7 +0,0 @@
---
-'@gitbook/openapi-parser': patch
-'@gitbook/react-openapi': patch
-'gitbook': patch
---
-
-Remove stable from x-stability
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Improve the error message returned by the revalidate endpoint.
@@ -1,6 +0,0 @@
---
-'@gitbook/react-openapi': patch
-'gitbook': patch
---
-
-Improve OpenAPI codesample (add OpenAPISelect component)
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Fix ogimage generation crashing when site is using a custom WOFF2 font
@@ -1,5 +0,0 @@
---
-"gitbook": minor
---
-
-Do not set cookie to identify visitor for insights when disabled.
@@ -1,6 +0,0 @@
---
-"@gitbook/react-openapi": patch
-"gitbook": patch
---
-
-Improve OpenAPI schemas block ungrouped style. Classnames have changed, please refer to this PR to update GBX.
@@ -1,5 +0,0 @@
---
-'@gitbook/react-openapi': patch
---
-
-Handle optional security headers
@@ -1,5 +0,0 @@
---
-'gitbook': patch
---
-
-Override Scalar's overscroll-behavior
@@ -1,5 +0,0 @@
---
-"@gitbook/react-openapi": patch
---
-
-Hide deprecated properties in examples
@@ -1,5 +0,0 @@
---
-"gitbook": patch
---
-
-Better error handling in cache revalidation.
@@ -55,6 +55,7 @@ runs:
            GITBOOK_INTEGRATIONS_HOST: ${{ inputs.opItem }}/GITBOOK_INTEGRATIONS_HOST
            GITBOOK_IMAGE_RESIZE_SIGNING_KEY: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_SIGNING_KEY
            GITBOOK_IMAGE_RESIZE_URL: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_URL
+            GITBOOK_IMAGE_RESIZE_MODE: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_MODE
            GITBOOK_ASSETS_PREFIX: ${{ inputs.opItem }}/GITBOOK_ASSETS_PREFIX
            GITBOOK_FONTS_URL: ${{ inputs.opItem }}/GITBOOK_FONTS_URL
        - name: Build worker
@@ -54,6 +54,7 @@ runs:
            GITBOOK_INTEGRATIONS_HOST: ${{ inputs.opItem }}/GITBOOK_INTEGRATIONS_HOST
            GITBOOK_IMAGE_RESIZE_SIGNING_KEY: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_SIGNING_KEY
            GITBOOK_IMAGE_RESIZE_URL: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_URL
+            GITBOOK_IMAGE_RESIZE_MODE: ${{ inputs.opItem }}/GITBOOK_IMAGE_RESIZE_MODE
            GITBOOK_ASSETS_PREFIX: ${{ inputs.opItem }}/GITBOOK_ASSETS_PREFIX
            GITBOOK_FONTS_URL: ${{ inputs.opItem }}/GITBOOK_FONTS_URL
        - name: Build Project Artifacts
@@ -200,7 +200,7 @@ jobs:
        name: Visual Testing v2 (Cloudflare)
        needs: deploy-v2-cloudflare
        timeout-minutes: 10
-        if: startsWith(github.ref_name, 'cloudflare/')
+        if: startsWith(github.head_ref || github.ref_name, 'cloudflare/')
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -263,7 +263,7 @@ jobs:
        name: Visual Testing Customers v2 (Cloudflare)
        needs: deploy-v2-cloudflare
        timeout-minutes: 8
-        if: startsWith(github.ref_name, 'cloudflare/')
+        if: startsWith(github.head_ref || github.ref_name, 'cloudflare/')
        steps:
            - name: Checkout
              uses: actions/checkout@v4
@@ -59,15 +59,15 @@ bun install
 4. Start your local development server.

 ```
-bun dev
+bun dev:v2
 ```

 5. Open a published GitBook space in your web browser, prefixing it with `http://localhost:3000/`.

 examples:

-   http://localhost:3000/docs.gitbook.com
-   http://localhost:3000/open-source.gitbook.io/midjourney
+-   http://localhost:3000/url/docs.gitbook.com
+-   http://localhost:3000/url/open-source.gitbook.io/midjourney

 Any published GitBook site can be accessed through your local development instance, and any updates you make to the codebase will be reflected in your browser.

@@ -24,9 +24,9 @@
    },
    "packages/cache-tags": {
      "name": "@gitbook/cache-tags",
-      "version": "0.2.0",
+      "version": "0.3.1",
      "dependencies": {
-        "@gitbook/api": "*",
+        "@gitbook/api": "^0.109.0",
        "assert-never": "^1.2.1",
      },
      "devDependencies": {
@@ -35,7 +35,7 @@
    },
    "packages/colors": {
      "name": "@gitbook/colors",
-      "version": "0.3.1",
+      "version": "0.3.2",
      "devDependencies": {
        "typescript": "^5.5.3",
      },
@@ -49,7 +49,7 @@
    },
    "packages/gitbook": {
      "name": "gitbook",
-      "version": "0.9.2",
+      "version": "0.10.1",
      "dependencies": {
        "@gitbook/api": "*",
        "@gitbook/cache-do": "workspace:*",
@@ -110,7 +110,7 @@
        "zustand": "^5.0.3",
      },
      "devDependencies": {
-        "@argos-ci/playwright": "^4.3.0",
+        "@argos-ci/playwright": "^5.0.3",
        "@cloudflare/next-on-pages": "1.13.7",
        "@cloudflare/workers-types": "^4.20241230.0",
        "@playwright/test": "^1.51.1",
@@ -140,11 +140,12 @@
    },
    "packages/gitbook-v2": {
      "name": "gitbook-v2",
-      "version": "0.2.3",
+      "version": "0.2.5",
      "dependencies": {
        "@gitbook/api": "*",
        "@gitbook/cache-tags": "workspace:*",
        "@sindresorhus/fnv1a": "^3.1.0",
+        "assert-never": "^1.2.1",
        "jwt-decode": "^4.0.0",
        "next": "canary",
        "react": "^19.0.0",
@@ -154,7 +155,7 @@
        "warn-once": "^0.1.1",
      },
      "devDependencies": {
-        "@opennextjs/cloudflare": "https://pkg.pr.new/opennextjs/opennextjs-cloudflare/@opennextjs/cloudflare@7b3b305",
+        "@opennextjs/cloudflare": "https://pkg.pr.new/opennextjs/opennextjs-cloudflare/@opennextjs/cloudflare@8f7ed38",
        "@types/rison": "^0.0.9",
        "gitbook": "*",
        "postcss": "^8",
@@ -183,7 +184,7 @@
    },
    "packages/openapi-parser": {
      "name": "@gitbook/openapi-parser",
-      "version": "2.1.2",
+      "version": "2.1.3",
      "dependencies": {
        "@scalar/openapi-parser": "^0.10.10",
        "@scalar/openapi-types": "^0.1.9",
@@ -230,7 +231,7 @@
    },
    "packages/react-openapi": {
      "name": "@gitbook/react-openapi",
-      "version": "1.1.9",
+      "version": "1.1.10",
      "dependencies": {
        "@gitbook/openapi-parser": "workspace:*",
        "@scalar/api-client-react": "^1.2.5",
@@ -273,15 +274,15 @@

    "@alloc/quick-lru": ["@alloc/quick-lru@5.2.0", "", {}, "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw=="],

-    "@argos-ci/api-client": ["@argos-ci/api-client@0.8.0", "", { "dependencies": { "debug": "^4.4.0", "openapi-fetch": "0.13.4" } }, "sha512-UHa1vAf8gwHVpkqM/RaSryrFe1juqWH6dHpPeMtT4e/ZMB9hNYwYFinaGq/KRWe88JEi2WeAu776YdoeUSZQkQ=="],
+    "@argos-ci/api-client": ["@argos-ci/api-client@0.8.1", "", { "dependencies": { "debug": "^4.4.0", "openapi-fetch": "0.13.5" } }, "sha512-3IHv7ANSPNO6OwWgwULlHbP9/tFV9kQDu6+nL9jysfPkGj0GgtrOsyBb+iU931c7wSMo1OD+XNujCnRzDD968w=="],

-    "@argos-ci/browser": ["@argos-ci/browser@3.2.0", "", {}, "sha512-mHLUamfywbdzrM6SRV4KB4kEQs2lrFxC1yS+QWB/9lME7FKzr7MJW/Q++iWcQli8IbmtLsZ+PqP2eqLaDiRsUw=="],
+    "@argos-ci/browser": ["@argos-ci/browser@4.1.1", "", {}, "sha512-UyKdnprGftUjWQkb0jqJ0zGHJmcWBzdko8zRy4y+4efukVX4jjC/Px2HvWW8aqwjoR4aplouMZuzhmOkq2SCsA=="],

-    "@argos-ci/core": ["@argos-ci/core@3.1.0", "", { "dependencies": { "@argos-ci/api-client": "0.8.0", "@argos-ci/util": "2.3.0", "axios": "^1.7.9", "convict": "^6.2.4", "debug": "^4.4.0", "fast-glob": "^3.3.3", "sharp": "^0.33.5", "tmp": "^0.2.3" } }, "sha512-bo/pNKk6P0pz4NRdymgU1letwQrRbMPTeFyMsUEW8fhKNdesSFnFIWZBFGsGkkh05uw75PBjl2ZN4PvQ2TxSog=="],
+    "@argos-ci/core": ["@argos-ci/core@3.1.1", "", { "dependencies": { "@argos-ci/api-client": "0.8.1", "@argos-ci/util": "2.3.1", "axios": "^1.8.4", "convict": "^6.2.4", "debug": "^4.4.0", "fast-glob": "^3.3.3", "sharp": "^0.33.5", "tmp": "^0.2.3" } }, "sha512-7iE3o1XGxlfHC5AF05pzT0OxuO387sryrZt3gKGj/e+6R20DXz7J49yI8++nQ2cuT+wLhcJp8+X0ox+SGMYHmw=="],

-    "@argos-ci/playwright": ["@argos-ci/playwright@4.3.0", "", { "dependencies": { "@argos-ci/browser": "3.2.0", "@argos-ci/core": "3.1.0", "@argos-ci/util": "2.3.0", "chalk": "^5.4.1", "debug": "^4.4.0" } }, "sha512-UQBC78zWg+bWXDaevWOL4m6zkrNeprMfdqjy6zagvU9kq7sPQC7nN/qZQ15hs/FT+JpTCa8CbbSAq13eQrmxKQ=="],
+    "@argos-ci/playwright": ["@argos-ci/playwright@5.0.3", "", { "dependencies": { "@argos-ci/browser": "4.1.1", "@argos-ci/core": "3.1.1", "@argos-ci/util": "2.3.1", "chalk": "^5.4.1", "debug": "^4.4.0" } }, "sha512-sqoARsgnDRrwKm1x10L3Z8+OQukk0F9OksVj9v9rvbzNI2WVCw5zbCUMY0qD4Q3Ba7vMFbl1ELUODRc2mfCbNw=="],

-    "@argos-ci/util": ["@argos-ci/util@2.3.0", "", {}, "sha512-tkxnCpaj7yN9nCFzo9MX0FJ5YjUepEOGYfdvF8COQqp+EdY1qubOPpc4Z0l1B60BlC8YtjQv/oRxHSh1XzxWFg=="],
+    "@argos-ci/util": ["@argos-ci/util@2.3.1", "", {}, "sha512-kE61HU2480fbAnimmA4x9HK45ZJvkoqLdW5GxT5uvwhkclQykVd2S6WfGFUr3JokTXfZ5LZEEfoWgtGA316KSQ=="],

    "@ast-grep/napi": ["@ast-grep/napi@0.35.0", "", { "optionalDependencies": { "@ast-grep/napi-darwin-arm64": "0.35.0", "@ast-grep/napi-darwin-x64": "0.35.0", "@ast-grep/napi-linux-arm64-gnu": "0.35.0", "@ast-grep/napi-linux-arm64-musl": "0.35.0", "@ast-grep/napi-linux-x64-gnu": "0.35.0", "@ast-grep/napi-linux-x64-musl": "0.35.0", "@ast-grep/napi-win32-arm64-msvc": "0.35.0", "@ast-grep/napi-win32-ia32-msvc": "0.35.0", "@ast-grep/napi-win32-x64-msvc": "0.35.0" } }, "sha512-3ucaaSxV6fxXoqHrE/rxAvP1THnDdY5jNzGlnvx+JvnY9C/dSRKc0jlRMRz59N3El572+/yNRUUpAV1T9aBJug=="],

@@ -785,9 +786,9 @@

    "@nodelib/fs.walk": ["@nodelib/fs.walk@1.2.8", "", { "dependencies": { "@nodelib/fs.scandir": "2.1.5", "fastq": "^1.6.0" } }, "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg=="],

-    "@opennextjs/aws": ["@opennextjs/aws@3.5.5", "", { "dependencies": { "@ast-grep/napi": "^0.35.0", "@aws-sdk/client-cloudfront": "3.398.0", "@aws-sdk/client-dynamodb": "^3.398.0", "@aws-sdk/client-lambda": "^3.398.0", "@aws-sdk/client-s3": "^3.398.0", "@aws-sdk/client-sqs": "^3.398.0", "@node-minify/core": "^8.0.6", "@node-minify/terser": "^8.0.6", "@tsconfig/node18": "^1.0.1", "aws4fetch": "^1.0.18", "chalk": "^5.3.0", "esbuild": "0.19.2", "express": "5.0.1", "path-to-regexp": "^6.3.0", "urlpattern-polyfill": "^10.0.0", "yaml": "^2.7.0" }, "bin": { "open-next": "dist/index.js" } }, "sha512-vIqCcNxy7vPdC5HQQkCN+AXhxdNvagZ8EYw5XvuYIAP2T1Ci9ai/8m6UXtjgd3L9+aBA8pbWfr2Wr/BNLX5m2Q=="],
+    "@opennextjs/aws": ["@opennextjs/aws@3.5.6", "", { "dependencies": { "@ast-grep/napi": "^0.35.0", "@aws-sdk/client-cloudfront": "3.398.0", "@aws-sdk/client-dynamodb": "^3.398.0", "@aws-sdk/client-lambda": "^3.398.0", "@aws-sdk/client-s3": "^3.398.0", "@aws-sdk/client-sqs": "^3.398.0", "@node-minify/core": "^8.0.6", "@node-minify/terser": "^8.0.6", "@tsconfig/node18": "^1.0.1", "aws4fetch": "^1.0.18", "chalk": "^5.3.0", "esbuild": "0.19.2", "express": "5.0.1", "path-to-regexp": "^6.3.0", "urlpattern-polyfill": "^10.0.0", "yaml": "^2.7.0" }, "bin": { "open-next": "dist/index.js" } }, "sha512-hYI3uYLVEK15zoxjlGKLSlzOrSf1GvnFWARCmS2gllL6aYaDspw2HIJ2OP+RS3wn+Npqs9iKVV2Dwiejdt5vxQ=="],

-    "@opennextjs/cloudflare": ["@opennextjs/cloudflare@https://pkg.pr.new/opennextjs/opennextjs-cloudflare/@opennextjs/cloudflare@7b3b305", { "dependencies": { "@dotenvx/dotenvx": "1.31.0", "@opennextjs/aws": "3.5.5", "enquirer": "^2.4.1", "glob": "^11.0.0", "ts-tqdm": "^0.8.6" }, "peerDependencies": { "wrangler": "^3.114.3 || ^4.7.0" }, "bin": { "opennextjs-cloudflare": "dist/cli/index.js" } }],
+    "@opennextjs/cloudflare": ["@opennextjs/cloudflare@https://pkg.pr.new/opennextjs/opennextjs-cloudflare/@opennextjs/cloudflare@8f7ed38", { "dependencies": { "@dotenvx/dotenvx": "1.31.0", "@opennextjs/aws": "3.5.6", "enquirer": "^2.4.1", "glob": "^11.0.0", "ts-tqdm": "^0.8.6" }, "peerDependencies": { "wrangler": "^3.114.3 || ^4.7.0" }, "bin": { "opennextjs-cloudflare": "dist/cli/index.js" } }],

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

@@ -1441,7 +1442,7 @@

    "aws4fetch": ["aws4fetch@1.0.20", "", {}, "sha512-/djoAN709iY65ETD6LKCtyyEI04XIBP5xVvfmNxsEP0uJB5tyaGBztSryRr4HqMStr9R06PisQE7m9zDTXKu6g=="],

-    "axios": ["axios@1.7.9", "", { "dependencies": { "follow-redirects": "^1.15.6", "form-data": "^4.0.0", "proxy-from-env": "^1.1.0" } }, "sha512-LhLcE7Hbiryz8oMDdDptSrWowmB4Bl6RCt6sIJKpRB4XtVf0iEgewX3au/pJqm+Py1kCASkb/FFKjxQaLtxJvw=="],
+    "axios": ["axios@1.8.4", "", { "dependencies": { "follow-redirects": "^1.15.6", "form-data": "^4.0.0", "proxy-from-env": "^1.1.0" } }, "sha512-eBSYY4Y68NNlHbHBMdeDmKNtDgXWhQsJcGqzO3iLUM0GraQFSS9cVgPX5I9b3lbdFKyYoAEGAZF1DwhTaljNAw=="],

    "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="],

@@ -2363,7 +2364,7 @@

    "oniguruma-to-es": ["oniguruma-to-es@4.1.0", "", { "dependencies": { "emoji-regex-xs": "^1.0.0", "oniguruma-parser": "^0.5.4", "regex": "^6.0.1", "regex-recursion": "^6.0.2" } }, "sha512-SNwG909cSLo4vPyyPbU/VJkEc9WOXqu2ycBlfd1UCXLqk1IijcQktSBb2yRQ2UFPsDhpkaf+C1dtT3PkLK/yWA=="],

-    "openapi-fetch": ["openapi-fetch@0.13.4", "", { "dependencies": { "openapi-typescript-helpers": "^0.0.15" } }, "sha512-JHX7UYjLEiHuQGCPxa3CCCIqe/nc4bTIF9c4UYVC8BegAbWoS3g4gJxKX5XcG7UtYQs2060kY6DH64KkvNZahg=="],
+    "openapi-fetch": ["openapi-fetch@0.13.5", "", { "dependencies": { "openapi-typescript-helpers": "^0.0.15" } }, "sha512-AQK8T9GSKFREFlN1DBXTYsLjs7YV2tZcJ7zUWxbjMoQmj8dDSFRrzhLCbHPZWA1TMV3vACqfCxLEZcwf2wxV6Q=="],

    "openapi-types": ["openapi-types@12.1.3", "", {}, "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw=="],

@@ -4017,7 +4018,7 @@

    "gaxios/node-fetch": ["node-fetch@2.7.0", "", { "dependencies": { "whatwg-url": "^5.0.0" }, "peerDependencies": { "encoding": "^0.1.0" }, "optionalPeers": ["encoding"] }, "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A=="],

-    "gitbook-v2/next": ["next@15.3.0-canary.43", "", { "dependencies": { "@next/env": "15.3.0-canary.43", "@swc/counter": "0.1.3", "@swc/helpers": "0.5.15", "busboy": "1.6.0", "caniuse-lite": "^1.0.30001579", "postcss": "8.4.31", "styled-jsx": "5.1.6" }, "optionalDependencies": { "@next/swc-darwin-arm64": "15.3.0-canary.43", "@next/swc-darwin-x64": "15.3.0-canary.43", "@next/swc-linux-arm64-gnu": "15.3.0-canary.43", "@next/swc-linux-arm64-musl": "15.3.0-canary.43", "@next/swc-linux-x64-gnu": "15.3.0-canary.43", "@next/swc-linux-x64-musl": "15.3.0-canary.43", "@next/swc-win32-arm64-msvc": "15.3.0-canary.43", "@next/swc-win32-x64-msvc": "15.3.0-canary.43", "sharp": "^0.34.1" }, "peerDependencies": { "@opentelemetry/api": "^1.1.0", "@playwright/test": "^1.41.2", "babel-plugin-react-compiler": "*", "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "sass": "^1.3.0" }, "optionalPeers": ["@opentelemetry/api", "@playwright/test", "babel-plugin-react-compiler", "sass"], "bin": { "next": "dist/bin/next" } }, "sha512-am6xpZIx2P0VJ26N7K2CImmznYUP65XS0e0nkYtypWf/RiMsScwmCqrA4qrEK9u/tiPlA+583IcQPos9yKLg1Q=="],
+    "gitbook-v2/next": ["next@15.3.1-canary.7", "", { "dependencies": { "@next/env": "15.3.1-canary.7", "@swc/counter": "0.1.3", "@swc/helpers": "0.5.15", "busboy": "1.6.0", "caniuse-lite": "^1.0.30001579", "postcss": "8.4.31", "styled-jsx": "5.1.6" }, "optionalDependencies": { "@next/swc-darwin-arm64": "15.3.1-canary.7", "@next/swc-darwin-x64": "15.3.1-canary.7", "@next/swc-linux-arm64-gnu": "15.3.1-canary.7", "@next/swc-linux-arm64-musl": "15.3.1-canary.7", "@next/swc-linux-x64-gnu": "15.3.1-canary.7", "@next/swc-linux-x64-musl": "15.3.1-canary.7", "@next/swc-win32-arm64-msvc": "15.3.1-canary.7", "@next/swc-win32-x64-msvc": "15.3.1-canary.7", "sharp": "^0.34.1" }, "peerDependencies": { "@opentelemetry/api": "^1.1.0", "@playwright/test": "^1.41.2", "babel-plugin-react-compiler": "*", "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "sass": "^1.3.0" }, "optionalPeers": ["@opentelemetry/api", "@playwright/test", "babel-plugin-react-compiler", "sass"], "bin": { "next": "dist/bin/next" } }, "sha512-RblvC7A7k8cKpSa6JSCbaatb6JAncv2niUSH7TqXt6xHUoItnxa3Fu7xkducFJQdcW2Hv2h0+NBu6kaKf0S4zw=="],

    "global-dirs/ini": ["ini@1.3.7", "", {}, "sha512-iKpRpXP+CrP2jyrxvg1kMUpXDyRUFDWurxbnVT1vQPx+Wz9uCYsMIqYuSBLV+PAaZG/d7kRLKRFc9oDMsH+mFQ=="],

@@ -4885,23 +4886,23 @@

    "gaxios/https-proxy-agent/debug": ["debug@4.3.7", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-Er2nc/H7RrMXZBFCEim6TCmMk02Z8vLC2Rbi1KEBggpo0fS6l0S1nnapwmIi3yW/+GOJap1Krg4w0Hg80oCqgQ=="],

-    "gitbook-v2/next/@next/env": ["@next/env@15.3.0-canary.43", "", {}, "sha512-ogryUGufxhtidxr/42NY6+ADlvxt9Hq6Q/DOMS/20vGuePZ70wO6Z5m1RP3Q397RGgpe1gSWyYdlg+Mt7H4KeQ=="],
+    "gitbook-v2/next/@next/env": ["@next/env@15.3.1-canary.7", "", {}, "sha512-QSzAlzxaGrQYj3Nzgxd35WM6pmxmNk9lOCn0nsNLPidvc3H6wj/fV3Pl8/tVCYQP61luGuA0Ib0VwZc8ja119w=="],

-    "gitbook-v2/next/@next/swc-darwin-arm64": ["@next/swc-darwin-arm64@15.3.0-canary.43", "", { "os": "darwin", "cpu": "arm64" }, "sha512-eXrs8CyIBgdnMTNjku+h/xm61gmRCcKAT+tM2CjpEXbEqXBux5hRIakOk5kJJDu2fA2P3pzQGt5PRD1hg4srXA=="],
+    "gitbook-v2/next/@next/swc-darwin-arm64": ["@next/swc-darwin-arm64@15.3.1-canary.7", "", { "os": "darwin", "cpu": "arm64" }, "sha512-fs7JYU0MKtpgsDBIvbT/wn1MwKP8C+bqcb6IjWnDtVcciFKzYDs/tPCBW6CtYg1wpHqm9horZDA1ytb/sAghxA=="],

-    "gitbook-v2/next/@next/swc-darwin-x64": ["@next/swc-darwin-x64@15.3.0-canary.43", "", { "os": "darwin", "cpu": "x64" }, "sha512-iRGvblEh/b2grxkkp9pT+yea9EzGNM4tLyUZoCzkejkU2jMLsn2DH6h3bQwCfEYZL3YFGsYmVISrVCOVi8LeMw=="],
+    "gitbook-v2/next/@next/swc-darwin-x64": ["@next/swc-darwin-x64@15.3.1-canary.7", "", { "os": "darwin", "cpu": "x64" }, "sha512-Efl6es/IEXJf5groF78fc1PrTEwK9bOyi6fRjp1bsa/AWOHp8rTc3l0T6EeY5T0SWeYilisZZa9rax7nTgw4bw=="],

-    "gitbook-v2/next/@next/swc-linux-arm64-gnu": ["@next/swc-linux-arm64-gnu@15.3.0-canary.43", "", { "os": "linux", "cpu": "arm64" }, "sha512-IqknHGNxpL03uIutIuv7FPjGHuD/AnJVC5exi5g+C7P3f6JVvOjFLS264eqi91tVCXhN2LpcKNGwTlK81bJVVg=="],
+    "gitbook-v2/next/@next/swc-linux-arm64-gnu": ["@next/swc-linux-arm64-gnu@15.3.1-canary.7", "", { "os": "linux", "cpu": "arm64" }, "sha512-IS71I8z2wlecRZRHXqWTtxVozZt1h9IH/2MX1P/WkCjQH98acFmCkw0jo/y70mrZ4lw6tRGTNkSBMun+5P5P+w=="],

-    "gitbook-v2/next/@next/swc-linux-arm64-musl": ["@next/swc-linux-arm64-musl@15.3.0-canary.43", "", { "os": "linux", "cpu": "arm64" }, "sha512-FbO0dnFsNe3f1LWTn4vyXTWTSrZdwNRnURYExSQ+0AINHphNfwKQNrPqVLrapQ9CAOCOz8R5p9Kf1++IsH3JJQ=="],
+    "gitbook-v2/next/@next/swc-linux-arm64-musl": ["@next/swc-linux-arm64-musl@15.3.1-canary.7", "", { "os": "linux", "cpu": "arm64" }, "sha512-uJ4env9fZxIFM+aRBCjNeG91HHZ2cRXiF25xJqGmCC1Y5jT5oYAB/tIBCFRSj6NRzdt4pZAamCMRS41WzzVVUQ=="],

-    "gitbook-v2/next/@next/swc-linux-x64-gnu": ["@next/swc-linux-x64-gnu@15.3.0-canary.43", "", { "os": "linux", "cpu": "x64" }, "sha512-MAaLEm8eO6Xir3YC3xLYDHDjLGogAAGRrxhuflvaqAtGQZ6NIMG4YjvAyramYTq/SwrUIDobggKxdQLtu8/pPQ=="],
+    "gitbook-v2/next/@next/swc-linux-x64-gnu": ["@next/swc-linux-x64-gnu@15.3.1-canary.7", "", { "os": "linux", "cpu": "x64" }, "sha512-/+efTL2TxoSAYCxdf+g6WvDKIJDoaETvF3I+lxpixhctfrIwpr2qnG0e6u2M55k1iYiiyFIOA63fpIsGnIMJZA=="],

-    "gitbook-v2/next/@next/swc-linux-x64-musl": ["@next/swc-linux-x64-musl@15.3.0-canary.43", "", { "os": "linux", "cpu": "x64" }, "sha512-gdwF79/EQjY3zgcolO0jlDe0yfII9tXyXQeqL+uvzA8gZT5FpH0KkwSWzxj8EUswWzZcprbDa87sq8H0Eo+whw=="],
+    "gitbook-v2/next/@next/swc-linux-x64-musl": ["@next/swc-linux-x64-musl@15.3.1-canary.7", "", { "os": "linux", "cpu": "x64" }, "sha512-Hb+agfULOjEhJAmq/r9OTVAo8KxFlnuCT7BEUbSuVP/Gxn883al6juSG7ZZfk7P4a+ZU6iVYyHKIFAKCarZmUA=="],

-    "gitbook-v2/next/@next/swc-win32-arm64-msvc": ["@next/swc-win32-arm64-msvc@15.3.0-canary.43", "", { "os": "win32", "cpu": "arm64" }, "sha512-5WYne3jvo1478kUfe901wFxvPMdC8tRKundKIgU5Upe1HafMMS7ymm1hQ7CUpp3/1vY/R1TV1oKHHJfqDubiNg=="],
+    "gitbook-v2/next/@next/swc-win32-arm64-msvc": ["@next/swc-win32-arm64-msvc@15.3.1-canary.7", "", { "os": "win32", "cpu": "arm64" }, "sha512-gNd5Vq7k9xIEQj85JoavHGRsyvu1zKOjVoPUYtsZRxXw6kcBg84x2g8NeT/3SmwH1PiFU/sjQXtRzr2Kuc2j3A=="],

-    "gitbook-v2/next/@next/swc-win32-x64-msvc": ["@next/swc-win32-x64-msvc@15.3.0-canary.43", "", { "os": "win32", "cpu": "x64" }, "sha512-xE3WZhwjb91eezecVsmXn/OtdISfMsIfS3t0ZXsS/+bMvO/LZLdcVBtl0Zy5yR+XJyKfXXmwpdYbL6WH4dGuQg=="],
+    "gitbook-v2/next/@next/swc-win32-x64-msvc": ["@next/swc-win32-x64-msvc@15.3.1-canary.7", "", { "os": "win32", "cpu": "x64" }, "sha512-D5i+KinvNNmspXfgIvEZ1RFOKVhOgdtoSC7/xEUm55hEkcWFVHOtVVPvgV7WUeo1elNxbgxytzmyKbLaifP03g=="],

    "gitbook-v2/next/postcss": ["postcss@8.4.31", "", { "dependencies": { "nanoid": "^3.3.6", "picocolors": "^1.0.0", "source-map-js": "^1.0.2" } }, "sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ=="],

@@ -1,5 +1,17 @@
 # @gitbook/cache-tags

+## 0.3.1
+
+### Patch Changes
+
+- 77397ca: Fix version of @gitbook/api referenced in package.json
+
+## 0.3.0
+
+### Minor Changes
+
+- 116575c: Improve typing of getComputedContentSourceCacheTags to match latest API specification
+
 ## 0.2.0

 ### Minor Changes
@@ -8,9 +8,9 @@
            "default": "./dist/index.js"
        }
    },
-    "version": "0.2.0",
+    "version": "0.3.1",
    "dependencies": {
-        "@gitbook/api": "*",
+        "@gitbook/api": "^0.109.0",
        "assert-never": "^1.2.1"
    },
    "devDependencies": {
@@ -1,5 +1,11 @@
 # @gitbook/colors

+## 0.3.2
+
+### Patch Changes
+
+- cdffd7c: Desaturate text colors by decreasing chroma for the last steps of the color scale
+
 ## 0.3.1

 ### Patch Changes
@@ -8,7 +8,7 @@
            "default": "./dist/index.js"
        }
    },
-    "version": "0.3.1",
+    "version": "0.3.2",
    "devDependencies": {
        "typescript": "^5.5.3"
    },
@@ -1,5 +1,20 @@
 # gitbook-v2

+## 0.2.5
+
+### Patch Changes
+
+- Updated dependencies [77397ca]
+  - @gitbook/cache-tags@0.3.1
+
+## 0.2.4
+
+### Patch Changes
+
+- 4234289: Fix incoming URL for requests that were proxied
+- Updated dependencies [116575c]
+  - @gitbook/cache-tags@0.3.0
+
 ## 0.2.3

 ### Patch Changes
@@ -7,10 +7,7 @@ const nextConfig = {
    experimental: {
        // This is needed to throw "forbidden" when the api token expired during revalidation
        authInterrupts: true,
-
-        // We don't use 'use cache' as it's not supported in OpenNext yet
-        // and instead we scope `unstable_cache` to the parameters of the function
-        useCache: false,
+        useCache: true,

        // Content is fully static, we can cache it in the session memory cache for a long time
        staleTimes: {
@@ -34,6 +31,7 @@ const nextConfig = {
        GITBOOK_ASSETS_PREFIX: process.env.GITBOOK_ASSETS_PREFIX,
        GITBOOK_SECRET: process.env.GITBOOK_SECRET,
        GITBOOK_IMAGE_RESIZE_SIGNING_KEY: process.env.GITBOOK_IMAGE_RESIZE_SIGNING_KEY,
+        GITBOOK_IMAGE_RESIZE_MODE: process.env.GITBOOK_IMAGE_RESIZE_MODE,
        GITBOOK_FONTS_URL: process.env.GITBOOK_FONTS_URL,
        GITBOOK_RUNTIME: process.env.GITBOOK_RUNTIME,

@@ -1,6 +1,6 @@
 {
    "name": "gitbook-v2",
-    "version": "0.2.3",
+    "version": "0.2.5",
    "private": true,
    "dependencies": {
        "next": "canary",
@@ -12,11 +12,12 @@
        "server-only": "^0.0.1",
        "warn-once": "^0.1.1",
        "rison": "^0.1.1",
-        "jwt-decode": "^4.0.0"
+        "jwt-decode": "^4.0.0",
+        "assert-never": "^1.2.1"
    },
    "devDependencies": {
        "gitbook": "*",
-        "@opennextjs/cloudflare": "https://pkg.pr.new/opennextjs/opennextjs-cloudflare/@opennextjs/cloudflare@7b3b305",
+        "@opennextjs/cloudflare": "https://pkg.pr.new/opennextjs/opennextjs-cloudflare/@opennextjs/cloudflare@8f7ed38",
        "@types/rison": "^0.0.9",
        "tailwindcss": "^3.4.0",
        "postcss": "^8"
@@ -98,6 +98,10 @@ export async function wrapDataFetcherError<T>(
 */
 export function getExposableError(error: Error): DataFetcherErrorData {
    if (error instanceof GitBookAPIError) {
+        if (error.code >= 500) {
+            throw error;
+        }
+
        return {
            code: error.code,
            message: error.errorMessage,
@@ -105,6 +109,10 @@ export function getExposableError(error: Error): DataFetcherErrorData {
    }

    if (error instanceof DataFetcherError) {
+        if (error.code >= 500) {
+            throw error;
+        }
+
        return {
            code: error.code,
            message: error.message,
@@ -4,7 +4,7 @@ import { withCacheKey, withoutConcurrentExecution } from './memoize';

 describe('withoutConcurrentExecution', () => {
    it('should memoize the function based on the cache key', async () => {
-        const fn = mock(async (a: number, b: number) => a + b);
+        const fn = mock(async (_cacheKey: string, a: number, b: number) => a + b);
        const memoized = withoutConcurrentExecution(() => null, fn);

        const p1 = memoized('c1', 1, 2);
@@ -4,7 +4,7 @@
 */
 export function withoutConcurrentExecution<ArgsType extends any[], ReturnType>(
    getGlobalContext: () => object | null | undefined,
-    wrapped: (...args: ArgsType) => Promise<ReturnType>
+    wrapped: (key: string, ...args: ArgsType) => Promise<ReturnType>
 ): (cacheKey: string, ...args: ArgsType) => Promise<ReturnType> {
    const globalPromiseCache = new WeakMap<object, Map<string, Promise<ReturnType>>>();

@@ -26,7 +26,7 @@ export function withoutConcurrentExecution<ArgsType extends any[], ReturnType>(

        const promise = (async () => {
            try {
-                const result = await wrapped(...args);
+                const result = await wrapped(key, ...args);
                return result;
            } finally {
                promiseCache.delete(key);
@@ -85,6 +85,15 @@ export const GITBOOK_IMAGE_RESIZE_URL = process.env.GITBOOK_IMAGE_RESIZE_URL ??
 export const GITBOOK_IMAGE_RESIZE_SIGNING_KEY =
    process.env.GITBOOK_IMAGE_RESIZE_SIGNING_KEY ?? null;

+/**
+ * Mode used for resizing images.
+ */
+export const GITBOOK_IMAGE_RESIZE_MODE = enforceEnum(
+    'GITBOOK_IMAGE_RESIZE_MODE',
+    process.env.GITBOOK_IMAGE_RESIZE_MODE || 'cdn-cgi',
+    ['cdn-cgi', 'cf-fetch']
+);
+
 /**
 * Endpoint where icons are served.
 */
@@ -100,3 +109,12 @@ export const GITBOOK_ICONS_TOKEN = process.env.GITBOOK_ICONS_TOKEN;
 * Secret used to validate requests from the GitBook app.
 */
 export const GITBOOK_SECRET = process.env.GITBOOK_SECRET ?? null;
+
+function enforceEnum<T extends string>(key: string, value: string, enumValues: T[]): T {
+    if (!enumValues.includes(value as T)) {
+        throw new Error(
+            `Invalid value for ${key}: "${value}", expected one of: ${enumValues.join(', ')}`
+        );
+    }
+    return value as T;
+}
@@ -0,0 +1,27 @@
+import { checkIsHttpURL } from '@/lib/urls';
+
+/**
+ * Check if an image URL is resizable.
+ * Skip it for non-http(s) URLs (data, etc).
+ * Skip it for SVGs.
+ * Skip it for GitBook images (to avoid recursion).
+ */
+export function checkIsSizableImageURL(input: string): boolean {
+    if (!URL.canParse(input)) {
+        return false;
+    }
+
+    if (input.includes('/~gitbook/image')) {
+        return false;
+    }
+
+    const parsed = new URL(input);
+    if (parsed.pathname.endsWith('.svg') || parsed.pathname.endsWith('.avif')) {
+        return false;
+    }
+    if (!checkIsHttpURL(parsed)) {
+        return false;
+    }
+
+    return true;
+}
@@ -1,34 +1,11 @@
 import 'server-only';
-
 import { GITBOOK_IMAGE_RESIZE_SIGNING_KEY, GITBOOK_IMAGE_RESIZE_URL } from '../env';
 import type { GitBookLinker } from '../links';
+import { checkIsSizableImageURL } from './checkIsSizableImageURL';
+import { getImageSize } from './resizer';
 import { type SignatureVersion, generateImageSignature } from './signatures';
 import type { ImageResizer } from './types';

-interface CloudflareImageJsonFormat {
-    width: number;
-    height: number;
-    original: {
-        file_size: number;
-        width: number;
-        height: number;
-        format: string;
-    };
-}
-
-/**
- * https://developers.cloudflare.com/images/image-resizing/resize-with-workers/
- */
-export interface CloudflareImageOptions {
-    format?: 'webp' | 'avif' | 'json' | 'jpeg';
-    fit?: 'scale-down' | 'contain' | 'cover' | 'crop' | 'pad';
-    width?: number;
-    height?: number;
-    dpr?: number;
-    anim?: boolean;
-    quality?: number;
-}
-
 /**
 * Create an image resizer for a rendering context.
 */
@@ -106,124 +83,6 @@ export function createNoopImageResizer(): ImageResizer {
    };
 }

-/**
- * Check if a URL is an HTTP URL.
- */
-export function checkIsHttpURL(input: string | URL): boolean {
-    if (!URL.canParse(input)) {
-        return false;
-    }
-    const parsed = new URL(input);
-    return parsed.protocol === 'http:' || parsed.protocol === 'https:';
-}
-
-/**
- * Check if an image URL is resizable.
- * Skip it for non-http(s) URLs (data, etc).
- * Skip it for SVGs.
- * Skip it for GitBook images (to avoid recursion).
- */
-export function checkIsSizableImageURL(input: string): boolean {
-    if (!URL.canParse(input)) {
-        return false;
-    }
-
-    if (input.includes('/~gitbook/image')) {
-        return false;
-    }
-
-    const parsed = new URL(input);
-    if (parsed.pathname.endsWith('.svg') || parsed.pathname.endsWith('.avif')) {
-        return false;
-    }
-    if (!checkIsHttpURL(parsed)) {
-        return false;
-    }
-
-    return true;
-}
-
-/**
- * Get the size of an image.
- */
-export async function getImageSize(
-    input: string,
-    defaultSize: Partial<CloudflareImageOptions> = {}
-): Promise<{ width: number; height: number } | null> {
-    if (!checkIsSizableImageURL(input)) {
-        return null;
-    }
-
-    try {
-        const response = await resizeImage(input, {
-            // Abort the request after 2 seconds to avoid blocking rendering for too long
-            signal: AbortSignal.timeout(2000),
-            // Measure size and resize it to the most common size
-            // to optimize caching
-            ...defaultSize,
-            format: 'json',
-            anim: false,
-        });
-
-        const json = (await response.json()) as CloudflareImageJsonFormat;
-        return {
-            width: json.original.width,
-            height: json.original.height,
-        };
-    } catch (_error) {
-        return null;
-    }
-}
-
-/**
- * Execute a Cloudflare Image Resize operation on an image.
- */
-export async function resizeImage(
-    input: string,
-    options: CloudflareImageOptions & {
-        signal?: AbortSignal;
-    }
-): Promise<Response> {
-    const { signal, ...resizeOptions } = options;
-
-    const parsed = new URL(input);
-    if (parsed.protocol === 'data:') {
-        throw new Error('Cannot resize data: URLs');
-    }
-
-    if (parsed.hostname === 'localhost') {
-        throw new Error('Cannot resize localhost URLs');
-    }
-
-    // Since Cloudflare Images options on fetch are not supported on Cloudflare Pages,
-    // we need to use the Cloudflare Image Resize API directly.
-    if (!GITBOOK_IMAGE_RESIZE_URL) {
-        throw new Error('GITBOOK_IMAGE_RESIZE_URL is not set');
-    }
-
-    return await fetch(
-        `${GITBOOK_IMAGE_RESIZE_URL}${stringifyOptions(
-            resizeOptions
-        )}/${encodeURIComponent(input)}`,
-        {
-            headers: {
-                // Pass the `Accept` header, as Cloudflare uses this to validate the format.
-                Accept:
-                    resizeOptions.format === 'json'
-                        ? 'application/json'
-                        : `image/${resizeOptions.format || 'jpeg'}`,
-            },
-            signal,
-        }
-    );
-}
-
-function stringifyOptions(options: CloudflareImageOptions): string {
-    return Object.entries({ ...options }).reduce((rest, [key, value]) => {
-        return `${rest}${rest ? ',' : ''}${key}=${value}`;
-    }, '');
-}
-
 /**
 * Because of a bug in Cloudflare, 127.0.0.1 is replaced by localhost.
 * We protect against it by converting to a special token, and then parsing
@@ -3,3 +3,5 @@ export * from './createImageResizer';
 export * from './signatures';
 export * from './utils';
 export * from './getImageResizingContextId';
+export * from './resizer';
+export * from './checkIsSizableImageURL';
@@ -0,0 +1,48 @@
+import { GITBOOK_IMAGE_RESIZE_URL } from '@v2/lib/env';
+import type { CloudflareImageOptions } from './types';
+import { copyImageResponse } from './utils';
+
+/**
+ * Resize an image by doing a request to a /cdn/cgi/ endpoint.
+ * https://developers.cloudflare.com/images/transform-images/transform-via-url/
+ */
+export async function resizeImageWithCDNCgi(
+    input: string,
+    options: CloudflareImageOptions & {
+        signal?: AbortSignal;
+    }
+): Promise<Response> {
+    const { signal, ...resizeOptions } = options;
+
+    // Since Cloudflare Images options on fetch are not supported on Cloudflare Pages,
+    // we need to use the Cloudflare Image Resize API directly.
+    if (!GITBOOK_IMAGE_RESIZE_URL) {
+        throw new Error('GITBOOK_IMAGE_RESIZE_URL is not set for cdn-cgi image resize mode');
+    }
+
+    const resizeURL = `${GITBOOK_IMAGE_RESIZE_URL}${stringifyOptions(
+        resizeOptions
+    )}/${encodeURIComponent(input)}`;
+
+    // biome-ignore lint/suspicious/noConsole: this log is useful for debugging
+    console.log(`resize image using cdn-cgi: ${resizeURL}`);
+
+    return copyImageResponse(
+        await fetch(resizeURL, {
+            headers: {
+                // Pass the `Accept` header, as Cloudflare uses this to validate the format.
+                Accept:
+                    resizeOptions.format === 'json'
+                        ? 'application/json'
+                        : `image/${resizeOptions.format || 'jpeg'}`,
+            },
+            signal,
+        })
+    );
+}
+
+function stringifyOptions(options: CloudflareImageOptions): string {
+    return Object.entries({ ...options }).reduce((rest, [key, value]) => {
+        return `${rest}${rest ? ',' : ''}${key}=${value}`;
+    }, '');
+}
@@ -0,0 +1,34 @@
+import type { CloudflareImageOptions } from './types';
+import { copyImageResponse } from './utils';
+
+/**
+ * Resize an image by doing a request to the image itself using the Cloudflare fetch.
+ * https://developers.cloudflare.com/images/transform-images/transform-via-workers/
+ *
+ * This method doesn't work in Cloudflare Pages and is only supported in workers.
+ */
+export async function resizeImageWithCFFetch(
+    input: string,
+    options: CloudflareImageOptions & {
+        signal?: AbortSignal;
+    }
+): Promise<Response> {
+    const { signal, ...resizeOptions } = options;
+
+    // biome-ignore lint/suspicious/noConsole: this log is useful for debugging
+    console.log(`resize image using cf-fetch: ${input}`);
+
+    return copyImageResponse(
+        await fetch(input, {
+            headers: {
+                // Pass the `Accept` header, as Cloudflare uses this to validate the format.
+                Accept:
+                    resizeOptions.format === 'json'
+                        ? 'application/json'
+                        : `image/${resizeOptions.format || 'jpeg'}`,
+            },
+            signal,
+            cf: { image: resizeOptions },
+        })
+    );
+}
@@ -0,0 +1,2 @@
+export * from './types';
+export * from './resizeImage';
@@ -0,0 +1,68 @@
+import 'server-only';
+import assertNever from 'assert-never';
+import { GITBOOK_IMAGE_RESIZE_MODE } from '../../env';
+import { checkIsSizableImageURL } from '../checkIsSizableImageURL';
+import { resizeImageWithCDNCgi } from './cdn-cgi';
+import { resizeImageWithCFFetch } from './cf-fetch';
+import type { CloudflareImageJsonFormat, CloudflareImageOptions } from './types';
+
+/**
+ * Get the size of an image.
+ */
+export async function getImageSize(
+    input: string,
+    defaultSize: Partial<CloudflareImageOptions> = {}
+): Promise<{ width: number; height: number } | null> {
+    if (!checkIsSizableImageURL(input)) {
+        return null;
+    }
+
+    try {
+        const response = await resizeImage(input, {
+            // Abort the request after 2 seconds to avoid blocking rendering for too long
+            signal: AbortSignal.timeout(2000),
+            // Measure size and resize it to the most common size
+            // to optimize caching
+            ...defaultSize,
+            format: 'json',
+            anim: false,
+        });
+
+        const json = (await response.json()) as CloudflareImageJsonFormat;
+        return {
+            width: json.original.width,
+            height: json.original.height,
+        };
+    } catch (error) {
+        console.warn(`Error getting image size for ${input}:`, error);
+        return null;
+    }
+}
+
+/**
+ * Execute a Cloudflare Image Resize operation on an image.
+ */
+export async function resizeImage(
+    input: string,
+    options: CloudflareImageOptions & {
+        signal?: AbortSignal;
+    }
+): Promise<Response> {
+    const parsed = new URL(input);
+    if (parsed.protocol === 'data:') {
+        throw new Error('Cannot resize data: URLs');
+    }
+
+    if (parsed.hostname === 'localhost') {
+        throw new Error('Cannot resize localhost URLs');
+    }
+
+    switch (GITBOOK_IMAGE_RESIZE_MODE) {
+        case 'cdn-cgi':
+            return resizeImageWithCDNCgi(input, options);
+        case 'cf-fetch':
+            return resizeImageWithCFFetch(input, options);
+        default:
+            assertNever(GITBOOK_IMAGE_RESIZE_MODE);
+    }
+}
@@ -0,0 +1,23 @@
+export interface CloudflareImageJsonFormat {
+    width: number;
+    height: number;
+    original: {
+        file_size: number;
+        width: number;
+        height: number;
+        format: string;
+    };
+}
+
+/**
+ * https://developers.cloudflare.com/images/image-resizing/resize-with-workers/
+ */
+export interface CloudflareImageOptions {
+    format?: 'webp' | 'avif' | 'json' | 'jpeg';
+    fit?: 'scale-down' | 'contain' | 'cover' | 'crop' | 'pad';
+    width?: number;
+    height?: number;
+    dpr?: number;
+    anim?: boolean;
+    quality?: number;
+}
@@ -0,0 +1,7 @@
+/**
+ * Copy a response to make sure it can be mutated by the rest of the middleware.
+ * To avoid errors "Can't modify immutable headers".
+ */
+export function copyImageResponse(response: Response) {
+    return new Response(response.body, response);
+}
@@ -1,5 +1,48 @@
 # gitbook

+## 0.10.1
+
+### Patch Changes
+
+- Updated dependencies [77397ca]
+  - @gitbook/cache-tags@0.3.1
+
+## 0.10.0
+
+### Minor Changes
+
+- b62b101: Do not set cookie to identify visitor for insights when disabled.
+
+### Patch Changes
+
+- 95ea22d: Cache AI Page Link summary
+- daf41fc: Tweak footer design (and refactor)
+- de53946: Fix security issue with injection of "javacript:` url in the back button of PDFs
+- b92ecfa: Implement retry logic for the DO cache to prevent when revalidating content.
+- 528eee3: Add superscript and subscript text rendering
+- aa3357a: Fix OpenAPISchemas description padding
+- 168a4fa: Add support for buttons to GitBook.
+- 70c4182: Improve OpenAPI schema style
+- 2b6c593: Remove stable from x-stability
+- 580f7ad: Improve the error message returned by the revalidate endpoint.
+- cbd768a: Improve OpenAPI codesample (add OpenAPISelect component)
+- c765463: Fix ogimage generation crashing when site is using a custom WOFF2 font
+- e59076a: Improve OpenAPI schemas block ungrouped style. Classnames have changed, please refer to this PR to update GBX.
+- 29aaba5: Override Scalar's overscroll-behavior
+- 90ead98: Better error handling in cache revalidation.
+- Updated dependencies [116575c]
+- Updated dependencies [cdffd7c]
+- Updated dependencies [70c4182]
+- Updated dependencies [2b6c593]
+- Updated dependencies [cbd768a]
+- Updated dependencies [e59076a]
+- Updated dependencies [eedefdd]
+- Updated dependencies [23cedd2]
+  - @gitbook/cache-tags@0.3.0
+  - @gitbook/colors@0.3.2
+  - @gitbook/react-openapi@1.1.10
+  - @gitbook/openapi-parser@2.1.3
+
 ## 0.9.2

 ### Patch Changes
@@ -219,10 +219,10 @@ export function runTestCases(testCases: TestsCase[]) {
                                fullPage: testEntry.fullPage ?? false,
                                beforeScreenshot: async ({ runStabilization }) => {
                                    await runStabilization();
-                                    await waitForIcons(page);
                                    if (screenshotOptions?.waitForTOCScrolling !== false) {
                                        await waitForTOCScrolling(page);
                                    }
+                                    await waitForIcons(page);
                                },
                            });
                        }
@@ -345,61 +345,74 @@ export function getCustomizationURL(partial: DeepPartial<SiteCustomizationSettin
 */
 async function waitForIcons(page: Page) {
    await page.waitForFunction(() => {
-        const urls = new Set<string>();
+        const urlStates: Record<string, 'pending' | 'loaded'> =
+            (window as any).__ICONS_STATES__ || {};
+        (window as any).__ICONS_STATES__ = urlStates;
+
+        const loadUrl = (url: string) => {
+            // Mark the URL as pending.
+            urlStates[url] = 'pending';
+
+            const img = new Image();
+            img.onload = () => {
+                urlStates[url] = 'loaded';
+            };
+            img.src = url;
+        };
+
        const icons = Array.from(document.querySelectorAll('svg.gb-icon'));
        const results = icons.map((icon) => {
            if (!(icon instanceof SVGElement)) {
                throw new Error('Icon is not an SVGElement');
            }

-            // If loaded, good it passes the test.
-            if (icon.dataset.loadingState === 'loaded') {
-                return true;
-            }
-
-            // If not loaded yet, we need to load it.
-            if (icon.dataset.loadingState === 'pending') {
-                return false;
-            }
-
            // Ignore icons that are not visible.
            if (!icon.checkVisibility()) {
                return true;
            }

+            const state = icon.getAttribute('data-argos-state');
+
+            if (state === 'pending') {
+                return false;
+            }
+
+            if (state === 'loaded') {
+                return true;
+            }
+
            // url("https://ka-p.fontawesome.com/releases/v6.6.0/svgs/light/moon.svg?v=2&token=a463935e93")
            const maskImage = window.getComputedStyle(icon).getPropertyValue('mask-image');
            const urlMatch = maskImage.match(/url\("([^"]+)"\)/);
-            const url = urlMatch ? urlMatch[1] : null;
+            const url = urlMatch?.[1];

            // If URL is invalid we throw an error.
            if (!url) {
                throw new Error('No mask-image');
            }

-            // If the URL is already loaded, we just mark it as loaded.
-            if (urls.has(url)) {
-                icon.dataset.loadingState = 'loaded';
-                return true;
+            // If the URL is already queued for loading, we return the state.
+            if (urlStates[url]) {
+                if (urlStates[url] === 'loaded') {
+                    icon.setAttribute('data-argos-state', 'pending');
+                    const bckMaskImage = icon.style.maskImage;
+                    const bckDisplay = icon.style.display;
+                    icon.style.maskImage = '';
+                    icon.style.display = 'none';
+                    requestAnimationFrame(() => {
+                        icon.style.maskImage = bckMaskImage;
+                        icon.style.display = bckDisplay;
+                        requestAnimationFrame(() => {
+                            icon.setAttribute('data-argos-state', 'loaded');
+                        });
+                    });
+                    return false;
+                }
+
+                return false;
            }

-            // Mark the icon as pending and load the image.
-            icon.dataset.loadingState = 'pending';
-
-            // Mark the URL as seen.
-            urls.add(url);
-
-            const img = new Image();
-            img.src = url;
-            img.decode().then(() => {
-                // Wait two frames to let the time to the icon to repaint.
-                requestAnimationFrame(() => {
-                    requestAnimationFrame(() => {
-                        icon.dataset.loadingState = 'loaded';
-                    });
-                });
-            });
-
+            loadUrl(url);
            return false;
        });

@@ -1,6 +1,6 @@
 {
    "name": "gitbook",
-    "version": "0.9.2",
+    "version": "0.10.1",
    "private": true,
    "scripts": {
        "dev": "env-cmd --silent -f ../../.env.local next dev",
@@ -75,7 +75,7 @@
        "zustand": "^5.0.3"
    },
    "devDependencies": {
-        "@argos-ci/playwright": "^4.3.0",
+        "@argos-ci/playwright": "^5.0.3",
        "@cloudflare/next-on-pages": "1.13.7",
        "@cloudflare/workers-types": "^4.20241230.0",
        "@playwright/test": "^1.51.1",
@@ -26,6 +26,7 @@ export function ClientCodeBlock(props: ClientBlockProps) {
    const [isInViewport, setIsInViewport] = useState(false);
    const plainLines = useMemo(() => plainHighlight(block, []), [block]);
    const [lines, setLines] = useState<null | HighlightLine[]>(null);
+    const [highlighting, setHighlighting] = useState(false);

    // Preload the highlighter when the block is mounted.
    useEffect(() => {
@@ -77,6 +78,7 @@ export function ClientCodeBlock(props: ClientBlockProps) {
            let cancelled = false;

            if (typeof window !== 'undefined') {
+                setHighlighting(true);
                import('./highlight').then(({ highlight }) => {
                    highlight(block, inlines).then((lines) => {
                        if (cancelled) {
@@ -84,6 +86,7 @@ export function ClientCodeBlock(props: ClientBlockProps) {
                        }

                        setLines(lines);
+                        setHighlighting(false);
                    });
                });
            }
@@ -98,6 +101,12 @@ export function ClientCodeBlock(props: ClientBlockProps) {
    }, [isInViewport, block, inlines]);

    return (
-        <CodeBlockRenderer ref={blockRef} block={block} style={style} lines={lines ?? plainLines} />
+        <CodeBlockRenderer
+            ref={blockRef}
+            aria-busy={highlighting}
+            block={block}
+            style={style}
+            lines={lines ?? plainLines}
+        />
    );
 }
@@ -14,6 +14,7 @@ import './CodeBlockRenderer.css';

 type CodeBlockRendererProps = Pick<BlockProps<DocumentBlockCode>, 'block' | 'style'> & {
    lines: HighlightLine[];
+    'aria-busy'?: boolean;
 };

 /**
@@ -23,7 +24,7 @@ export const CodeBlockRenderer = forwardRef(function CodeBlockRenderer(
    props: CodeBlockRendererProps,
    ref: React.ForwardedRef<HTMLDivElement>
 ) {
-    const { block, style, lines } = props;
+    const { block, style, lines, 'aria-busy': ariaBusy } = props;

    const id = useId();
    const withLineNumbers = Boolean(block.data.lineNumbers) && block.nodes.length > 1;
@@ -31,7 +32,11 @@ export const CodeBlockRenderer = forwardRef(function CodeBlockRenderer(
    const title = block.data.title;

    return (
-        <div ref={ref} className={tcls('group/codeblock grid grid-flow-col', style)}>
+        <div
+            ref={ref}
+            aria-busy={ariaBusy}
+            className={tcls('group/codeblock grid grid-flow-col', style)}
+        >
            <div className="flex items-center justify-start gap-2 text-sm [grid-area:1/1]">
                {title ? (
                    <div className="inline-flex items-center justify-center rounded-t straight-corners:rounded-t-s bg-tint px-3 py-2 text-tint text-xs leading-none tracking-wide">
@@ -1,51 +1,65 @@
 'use client';

 import { Icon } from '@gitbook/icons';
-import { usePathname } from 'next/navigation';
-import { useEffect, useRef } from 'react';
+import { useRef } from 'react';

 import { tString, useLanguage } from '@/intl/client';
 import { tcls } from '@/lib/tailwind';

+import { usePathnameChange } from '../hooks';
 import { useScrollListener } from '../hooks/useScrollListener';

 const globalClassName = 'navigation-open';

-const SCROLL_DISTANCE = 320;
+
+/**
+ * Detect if the user has scrolled in the page, meaning the TOC is not visible.
+ */
+function useHasScrolledRef() {
+    const hasScrollRef = useRef(false);
+    const windowRef = useRef(typeof window === 'undefined' ? null : window);
+    useScrollListener(() => {
+        hasScrollRef.current = window.scrollY >= 320;
+    }, windowRef);
+    return hasScrollRef
+}

 /**
 * Button to show/hide the table of content on mobile.
 */
 export function HeaderMobileMenu(props: Partial<React.ButtonHTMLAttributes<HTMLButtonElement>>) {
    const language = useLanguage();
+    const hasScrollRef = useHasScrolledRef();

-    const pathname = usePathname();
-    const hasScrollRef = useRef(false);
+    // Close the navigation when navigating to a page
+    usePathnameChange(() => {
+        document.body.classList.remove(globalClassName);
+    });

-    const toggleNavigation = () => {
-        if (!hasScrollRef.current && document.body.classList.contains(globalClassName)) {
-            document.body.classList.remove(globalClassName);
-        } else {
+    const handleNavigationClick = () => {
+        // If already opened
+        if (document.body.classList.contains(globalClassName)) {
+            // If the user has scrolled down, we need to scroll back to the top.
+            if (hasScrollRef.current) {
+                window.scrollTo(0, 0);
+            }
+            // Else we close the table of contents
+            else {
+                document.body.classList.remove(globalClassName);
+            }
+        }
+        // If not opened, we open it an scroll to the top
+        else {
            document.body.classList.add(globalClassName);
            window.scrollTo(0, 0);
        }
-    };
-
-    const windowRef = useRef(typeof window === 'undefined' ? null : window);
-    useScrollListener(() => {
-        hasScrollRef.current = window.scrollY >= SCROLL_DISTANCE;
-    }, windowRef);
-
-    // Close the navigation when navigating to a page
-    useEffect(() => {
-        document.body.classList.remove(globalClassName);
-    }, [pathname]);
+    }; 

    return (
        <button
            {...props}
            aria-label={tString(language, 'table_of_contents_button_label')}
-            onClick={toggleNavigation}
+            onClick={handleNavigationClick}
            className={tcls(
                'flex flex-row items-center rounded straight-corners:rounded-sm px-2 py-1',
                props.className
@@ -1,18 +1,19 @@
 'use client';
 import { motion } from 'framer-motion';
-import React from 'react';
+import React, { useRef } from 'react';

-import { useScrollActiveId } from '@/components/hooks';
+// import { useScrollActiveId } from '@/components/hooks';
 import type { DocumentSection } from '@/lib/document-sections';
 import { tcls } from '@/lib/tailwind';

-import { HEADER_HEIGHT_DESKTOP } from '../layout';
+import { usePageActiveSections } from '../hooks/usePageActiveSections';
+// import { HEADER_HEIGHT_DESKTOP } from '../layout';
 import { AsideSectionHighlight } from './AsideSectionHighlight';

 /**
 * The threshold at which we consider a section as intersecting the viewport.
 */
-const SECTION_INTERSECTING_THRESHOLD = 0.9;
+// const SECTION_INTERSECTING_THRESHOLD = 0.9;

 const springCurve = {
    type: 'spring',
@@ -30,10 +31,13 @@ export function ScrollSectionsList(props: { sections: DocumentSection[] }) {
        });
    }, [sections]);

-    const activeId = useScrollActiveId(ids, {
-        rootMargin: `-${HEADER_HEIGHT_DESKTOP}px 0px -40% 0px`,
-        threshold: SECTION_INTERSECTING_THRESHOLD,
-    });
+    const windowRef = useRef(typeof window === 'undefined' ? null : window);
+    const activeIds = usePageActiveSections(ids, windowRef);
+
+    // const activeId = useScrollActiveId(ids, {
+    //     rootMargin: `-${HEADER_HEIGHT_DESKTOP}px 0px -40% 0px`,
+    //     threshold: SECTION_INTERSECTING_THRESHOLD,
+    // });

    return (
        <ul className={tcls('sidebar-list-line:border-l', 'border-tint-subtle')}>
@@ -49,7 +53,7 @@ export function ScrollSectionsList(props: { sections: DocumentSection[] }) {
                        section.depth > 1 && ['ml-3', 'my-0', 'sidebar-list-line:ml-0']
                    )}
                >
-                    {activeId === section.id ? (
+                    {activeIds.includes(section.id) ? (
                        <AsideSectionHighlight
                            transition={springCurve}
                            className={tcls(
@@ -102,7 +106,7 @@ export function ScrollSectionsList(props: { sections: DocumentSection[] }) {
                                'sidebar-list-default:border-tint',
                            ],

-                            activeId === section.id && [
+                            activeIds.includes(section.id) && [
                                'text-primary-subtle',
                                'hover:text-primary',
                                'contrast-more:text-primary',
@@ -4,3 +4,5 @@ export * from './useHash';
 export * from './useIsMounted';
 export * from './useToggleAnimation';
 export * from './useCurrentPagePath';
+export * from './usePrevious';
+export * from './usePathnameChange';
@@ -1,24 +1,26 @@
 'use client';

-import { useParams } from 'next/navigation';
-import React from 'react';
+import { useCallback, useEffect, useState } from 'react';

-function getHash(): string | null {
-    if (typeof window === 'undefined') {
-        return null;
-    }
-    return window.location.hash.slice(1);
-}
-
-/**
- * Hook to get the current hash from the URL.
- * @see https://github.com/vercel/next.js/discussions/49465
- */
+// How do I get the pathname with hash.
+// source: https://github.com/vercel/next.js/discussions/49465
 export function useHash() {
-    const params = useParams();
-    const [hash, setHash] = React.useState<string | null>(getHash);
-    React.useEffect(() => {
-        setHash(getHash());
-    }, [params]);
+    const getCurrentHash = useCallback(
+        () => (typeof window !== 'undefined' ? window.location.hash.replace(/^#!?/, '') : ''),
+        []
+    );
+    const [hash, setHash] = useState<string>(getCurrentHash());
+
+    useEffect(() => {
+        const handleHashChange = () => {
+            setHash(getCurrentHash());
+        };
+        window.addEventListener('hashchange', handleHashChange);
+
+        return () => {
+            window.removeEventListener('hashchange', handleHashChange);
+        };
+    }, [getCurrentHash]);
+
    return hash;
 }
@@ -0,0 +1,128 @@
+'use client';
+import * as React from 'react';
+import { useEventCallback } from 'usehooks-ts';
+import { useScrollListener } from './useScrollListener';
+
+/**
+ * Hook that returns the active section key of the page.
+ * The active section is the section that is currently visible on the viewport.
+ *
+ * Here's a diagram: https://user-images.githubusercontent.com/8937991/206921462-14e5b8b7-5a19-4c8b-912d-ed1f17710bc4.png
+ */
+export function usePageActiveSections(
+    ids: string[],
+    scrollRef: React.RefObject<HTMLElement | Window | null>
+): string[] {
+    const [activeSections, setActiveSections] = React.useState<string[]>(noActiveSections);
+
+    const update = useEventCallback(() => {
+        const element = scrollRef.current;
+        if (element) {
+            const rect =
+                element instanceof Window
+                    ? new DOMRect(0, 0, window.innerWidth, window.innerHeight)
+                    : element.getBoundingClientRect();
+            const activeSections = findActiveSectionIds({
+                ids,
+                containerRect: rect,
+            });
+            setActiveSections((previous) => {
+                if (activeSections.length !== previous.length) {
+                    return activeSections;
+                }
+                if (activeSections.some((key, i) => key !== previous[i])) {
+                    return activeSections;
+                }
+                return previous;
+            });
+        }
+    });
+
+    useScrollListener(update, scrollRef);
+
+    React.useEffect(() => {
+        update();
+    }, [update]);
+
+    return activeSections;
+}
+
+const noActiveSections: string[] = [];
+
+// We consider anything in [-MARGINpx; +MARGINpx] to be at the boundary
+const MARGIN = 24;
+
+/**
+ * findActiveSectionIndex finds the section that is in the window's view
+ * it uses binary-search to efficiently (minimize DOM queries)
+ * find the DOM node whose .top is closest to but below `0` (the window's top)
+ */
+function findActiveSectionIndex(ids: string[], scrollTop: number): number {
+    const N = ids.length;
+    // Number of max iterations to find the element (so our search is bounded)
+    // in theory, at most floor(log(n)+1) steps to find the specific element
+    const maxIterations = Math.floor(Math.log2(N) + 1);
+    // Our binary search variables
+    let start = 0;
+    let end = N - 1;
+    let mid = Math.ceil((start + end) / 2);
+    let idx = -1;
+    let y: number | null = null;
+    for (let i = 0; i < maxIterations; i++) {
+        const id = ids[mid];
+        // Double check that we have a section, else exit
+        if (!id) {
+            return -1;
+        }
+        const element = document.getElementById(id);
+        const sy = element ? element.getBoundingClientRect().top - scrollTop : null;
+        if (sy === null || sy > MARGIN) {
+            // Go left
+            end = mid;
+            mid = Math.floor((start + end) / 2);
+        } else if (sy >= -MARGIN && sy <= MARGIN) {
+            // Hit
+            return mid;
+        } else if (sy < MARGIN) {
+            // If bigger than previous (but still smaller than 0)
+            // that becomes our new active index
+            if (y === null || sy > y) {
+                y = sy;
+                idx = mid;
+            }
+            // Go right
+            start = mid;
+            mid = Math.ceil((start + end) / 2);
+        }
+    }
+    return idx;
+}
+
+/**
+ * Find the active sections in the viewport.
+ */
+function findActiveSectionIds(input: {
+    ids: string[];
+    containerRect: DOMRect;
+}): string[] {
+    const activeIndex = findActiveSectionIndex(input.ids, input.containerRect.top);
+
+    // Check if the next sections are visible, stop when they are not.
+    const activeSections: string[] = input.ids[activeIndex] ? [input.ids[activeIndex]] : [];
+
+    for (let i = activeIndex + 1; i < input.ids.length; i++) {
+        const id = input.ids[i];
+        const element = document.getElementById(id);
+        if (!element) {
+            continue;
+        }
+
+        const rect = element.getBoundingClientRect();
+        if (rect.bottom + MARGIN > input.containerRect.bottom) {
+            break;
+        }
+
+        activeSections.push(id);
+    }
+    return activeSections;
+}
@@ -0,0 +1,19 @@
+'use client';
+import { usePathname } from 'next/navigation';
+import * as React from 'react';
+import { useEventCallback } from 'usehooks-ts';
+import { usePrevious } from './usePrevious';
+
+/**
+ * Returns the value of the previous render.
+ */
+export function usePathnameChange(callback: () => void): void {
+    const pathname = usePathname();
+    const previousPathname = usePrevious(pathname);
+    const eventCallback = useEventCallback(callback);
+    React.useEffect(() => {
+        if (previousPathname !== undefined && pathname !== previousPathname) {
+            eventCallback();
+        }
+    }, [pathname, previousPathname, eventCallback]);
+}
@@ -0,0 +1,13 @@
+'use client';
+import * as React from 'react';
+
+/**
+ * Returns the value of the previous render.
+ */
+export function usePrevious<T>(value: T): T | undefined {
+    const ref = React.useRef<T | undefined>(undefined);
+    React.useLayoutEffect(() => {
+        ref.current = value;
+    });
+    return ref.current;
+}
@@ -17,7 +17,7 @@ import { type RefObject, useEffect, useLayoutEffect, useRef } from 'react';
 */
 export function useScrollListener(
    listener: (event: Event) => void,
-    elementRef: RefObject<HTMLElement | Window> | null
+    elementRef: RefObject<HTMLElement | Window | null> | null
 ) {
    const listenerRef = useRef(listener);
    useLayoutEffect(() => {
@@ -4,6 +4,7 @@ import { usePathname } from 'next/navigation';
 import React from 'react';

 import { useHash } from './useHash';
+import { usePrevious } from './usePrevious';

 /**
 * Scroll the page to an anchor point or
@@ -13,28 +14,29 @@ import { useHash } from './useHash';
 export function useScrollPage(props: { scrollMarginTop?: number }) {
    const hash = useHash();
    const pathname = usePathname();
+    const prevPathname = usePrevious(pathname);
+    const scrollMarginTopRef = React.useRef(props.scrollMarginTop);
    React.useLayoutEffect(() => {
        if (hash) {
            const element = document.getElementById(hash);
            if (element) {
-                if (props.scrollMarginTop) {
-                    element.style.scrollMarginTop = `${props.scrollMarginTop}px`;
+                const originalScrollMarginTop = element.style.scrollMarginTop;
+                if (scrollMarginTopRef.current) {
+                    element.style.scrollMarginTop = `${scrollMarginTopRef.current}px`;
                }
-                element.scrollIntoView({
-                    block: 'start',
-                    behavior: 'smooth',
-                });
+                element.scrollIntoView({ block: 'start', behavior: 'smooth' });
+                return () => {
+                    const element = document.getElementById(hash);
+                    if (element) {
+                        element.style.scrollMarginTop = originalScrollMarginTop;
+                    }
+                };
            }
-        } else {
+            return;
+        }
+
+        if (prevPathname && pathname !== prevPathname) {
            window.scrollTo(0, 0);
        }
-        return () => {
-            if (hash) {
-                const element = document.getElementById(hash);
-                if (element) {
-                    element.style.scrollMarginTop = '';
-                }
-            }
-        };
-    }, [hash, pathname, props.scrollMarginTop]);
+    }, [hash, pathname, prevPathname]);
 }
@@ -1,9 +1,10 @@
 /* eslint-disable @next/next/no-img-element */
-import { type ImageResizer, checkIsHttpURL } from '@v2/lib/images';
+import type { ImageResizer } from '@v2/lib/images';
 import ReactDOM from 'react-dom';

 import { type ClassValue, tcls } from '@/lib/tailwind';

+import { checkIsHttpURL } from '@/lib/urls';
 import { ZoomImage } from './ZoomImage';
 import type { PolymorphicComponentProp } from './types';

@@ -242,7 +242,7 @@ export const getLatestOpenAPISpecVersionContent = cache({
 * Resolve a URL to the content to render.
 */
 export const getPublishedContentByUrl = cache({
-    name: 'api.getPublishedContentByUrl.v4',
+    name: 'api.getPublishedContentByUrl.v7',
    tag: (url) => getCacheTagForURL(url),
    get: async (
        url: string,
@@ -267,6 +267,10 @@ export const getPublishedContentByUrl = cache({

            const parsed = parseCacheResponse(response);

+            console.log(
+                `Parsed ttl: ${parsed.ttl} at ${Date.now()}, for ${'apiToken' in response.data ? response.data.apiToken : '<no-token>'}`
+            );
+
            const data: PublishedContentWithCache = {
                ...response.data,
                cacheMaxAge: parsed.ttl,
@@ -1,8 +1,12 @@
 import { GITBOOK_ASSETS_URL, GITBOOK_URL } from '@v2/lib/env';
+import { joinPath, joinPathWithBaseURL } from './paths';

 /**
 * Create a public URL for an asset.
 */
 export function getAssetURL(path: string): string {
-    return `${GITBOOK_ASSETS_URL || GITBOOK_URL}/~gitbook/static/${path}`;
+    return joinPathWithBaseURL(
+        GITBOOK_ASSETS_URL || GITBOOK_URL,
+        joinPath('~gitbook/static', path)
+    );
 }
@@ -9,6 +9,7 @@ import type {
 } from '@/lib/openapi/types';
 import { getCloudflareRequestGlobal } from '@v2/lib/data/cloudflare';
 import { withCacheKey, withoutConcurrentExecution } from '@v2/lib/data/memoize';
+import { GITBOOK_RUNTIME } from '@v2/lib/env';
 import { assert } from 'ts-essentials';
 import { resolveContentRef } from '../references';
 import { isV2 } from '../v2';
@@ -68,26 +69,27 @@ const fetchFilesystemV1 = cache({
    },
 });

-const fetchFilesystemV2 = withCacheKey(async (cacheKey, url: string) => {
-    const uncached = unstable_cache(
-        async () => fetchFilesystemV2Uncached(cacheKey, url),
-        [cacheKey],
-        {
-            revalidate: 60 * 60 * 24,
+const fetchFilesystemV2 = withCacheKey(
+    withoutConcurrentExecution(getCloudflareRequestGlobal, async (cacheKey, url: string) => {
+        if (GITBOOK_RUNTIME !== 'cloudflare') {
+            return fetchFilesystemUseCache(url);
        }
-    );

-    const response = await uncached();
-    return response;
-});
-const fetchFilesystemV2Uncached = withoutConcurrentExecution(
-    getCloudflareRequestGlobal,
-    async function fetchFilesystemV2(url: string) {
-        const response = await fetchFilesystemUncached(url);
+        // FIXME: OpenNext doesn't support 'use cache' yet
+        const uncached = unstable_cache(async () => fetchFilesystemUncached(url), [cacheKey], {
+            revalidate: 60 * 60 * 24,
+        });
+
+        const response = await uncached();
        return response;
-    }
+    })
 );

+const fetchFilesystemUseCache = async (url: string) => {
+    'use cache';
+    return fetchFilesystemUncached(url);
+};
+
 async function fetchFilesystemUncached(
    url: string,
    options?: {
@@ -0,0 +1,10 @@
+/**
+ * Check if a URL is an HTTP URL.
+ */
+export function checkIsHttpURL(input: string | URL): boolean {
+    if (!URL.canParse(input)) {
+        return false;
+    }
+    const parsed = new URL(input);
+    return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+}
@@ -107,12 +107,13 @@ export async function serveResizedImage(
    try {
        const response = await resizeImage(url, options);
        if (!response.ok) {
-            throw new Error('Failed to resize image');
+            throw new Error(`Failed to resize image, received status code ${response.status}`);
        }

        return response;
-    } catch (_error) {
+    } catch (error) {
        // Redirect to the original image if resizing fails
+        console.warn('Error while resizing image, redirecting to original', error);
        return NextResponse.redirect(url, 302);
    }
 }
@@ -54,6 +54,9 @@ async function main() {
        writeDataFile('styles-map', JSON.stringify(onlyStyles, null, 2)),
        writeDataFile('icons', JSON.stringify(result, null, 2)),
    ]);
+
+    // biome-ignore lint/suspicious/noConsole: We want the CLI to log
+    console.log(`Generated ${result.length} icons`);
 }

 async function writeDataFile(name, content) {
@@ -74,6 +77,7 @@ async function writeDataFile(name, content) {
    ]);
 }

-main().catch((_error) => {
+main().catch((error) => {
+    console.error(`Error generating icons list: ${error}`);
    process.exit(1);
 });
@@ -20,8 +20,6 @@ async function main() {
    // Create the output folder if it doesn't exist
    await fs.mkdir(outputFolder, { recursive: true });

-    const _printOutputFolder = path.relative(process.cwd(), outputFolder);
-
    // Copy the assets from
    // source/sprites to outputFolder/sprites
    // source/svgs to outputFolder/svgs
@@ -45,8 +43,12 @@ async function main() {
            }
        }),
    ]);
+
+    // biome-ignore lint/suspicious/noConsole: We want the CLI to log
+    console.log(`Copied ${stylesToCopy.length} styles to ${outputFolder}`);
 }

-main().catch((_error) => {
+main().catch((error) => {
+    console.error(`Error copying icons: ${error}`);
    process.exit(1);
 });
@@ -2,6 +2,7 @@
    "extends": ["//"],
    "tasks": {
        "generate": {
+            "inputs": ["bin/**/*", "package.json"],
            "outputs": ["src/data/*.json", "dist/data/*.json"]
        }
    }
@@ -1,5 +1,11 @@
 # @gitbook/openapi-parser

+## 2.1.3
+
+### Patch Changes
+
+- 2b6c593: Remove stable from x-stability
+
 ## 2.1.2

 ### Patch Changes
@@ -9,7 +9,7 @@
            "default": "./dist/index.js"
        }
    },
-    "version": "2.1.2",
+    "version": "2.1.3",
    "sideEffects": false,
    "dependencies": {
        "@scalar/openapi-parser": "^0.10.10",
@@ -1,5 +1,18 @@
 # @gitbook/react-openapi

+## 1.1.10
+
+### Patch Changes
+
+- 70c4182: Improve OpenAPI schema style
+- 2b6c593: Remove stable from x-stability
+- cbd768a: Improve OpenAPI codesample (add OpenAPISelect component)
+- e59076a: Improve OpenAPI schemas block ungrouped style. Classnames have changed, please refer to this PR to update GBX.
+- eedefdd: Handle optional security headers
+- 23cedd2: Hide deprecated properties in examples
+- Updated dependencies [2b6c593]
+  - @gitbook/openapi-parser@2.1.3
+
 ## 1.1.9

 ### Patch Changes
@@ -8,7 +8,7 @@
            "default": "./dist/index.js"
        }
    },
-    "version": "1.1.9",
+    "version": "1.1.10",
    "sideEffects": false,
    "dependencies": {
        "@gitbook/openapi-parser": "workspace:*",
Author	SHA1	Message	Date
Greg Bergé	5eba878657	wip	2025-04-13 10:02:36 +02:00
Greg Bergé	f29d2b8e9c	wip	2025-04-13 09:06:01 +02:00
Greg Bergé	a9a643f222	Improve icon stabilization (#3147 )	2025-04-13 05:41:47 +00:00
Samy Pessé	77d6cb75be	Improve error message when image resizing failed (#3148 )	2025-04-12 17:44:23 -07:00
Samy Pessé	1942d221df	Bump the cache of getPublishedContentByUrl in v1 (#3146 )	2025-04-12 07:18:26 -07:00
Greg Bergé	041601ed65	Upgrade Argos (#3145 )	2025-04-12 15:48:51 +02:00
Steven H	5567281a85	Bump getPublishedContentByUrl cache. (#3144 )	2025-04-11 17:13:01 +01:00
Samy Pessé	4c3753046b	Cloudflare: fix image resizing (#3143 )	2025-04-11 16:48:43 +02:00
Samy Pessé	89f8e16184	Cloudflare: resize images in v2 using direct fetch (#3141 )	2025-04-11 15:18:44 +02:00
Samy Pessé	a3e1125ced	Hotfix for v1 crashes (#3139 )	2025-04-10 22:00:41 +02:00
Samy Pessé	4dae8acfed	Cloudflare: fix image resizing (#3138 )	2025-04-10 19:30:15 +02:00
Samy Pessé	bc081c4344	Fix cache revalidation for computed revisions (#3134 )	2025-04-10 16:36:02 +02:00
Samy Pessé	e4275b235d	Version Packages (#3137 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2025-04-10 13:31:27 +02:00
Samy Pessé	77397cac82	Fix version of @gitbook/api referenced in cache-tags (#3136 )	2025-04-10 13:30:28 +02:00
Samy Pessé	b6a08bc679	Version Packages (#3084 ) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>	2025-04-10 13:18:22 +02:00
Samy Pessé	116575c811	Changeset for cache-tags (#3135 )	2025-04-10 13:16:01 +02:00