Fix some build issues in docs (#1236)

harmony7 · web-flow · commit 482104bb2d39 · 2025-12-02T14:30:04.000Z
diff --git a/documentation/docs/backend/Backend/Backend.mdx b/documentation/docs/backend/Backend/Backend.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # `Backend()`
 
diff --git a/documentation/docs/backend/Backend/prototype/name.mdx b/documentation/docs/backend/Backend/prototype/name.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # name
 
diff --git a/documentation/docs/backend/Backend/prototype/toString.mdx b/documentation/docs/backend/Backend/prototype/toString.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # toString
 
diff --git a/documentation/docs/backend/allowDynamicBackends.mdx b/documentation/docs/backend/allowDynamicBackends.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # allowDynamicBackends
 
diff --git a/documentation/docs/backend/setDefaultDynamicBackendConfig.mdx b/documentation/docs/backend/setDefaultDynamicBackendConfig.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # setDefaultDynamicBackendConfig()
 
diff --git a/documentation/docs/cache-override/CacheOverride/CacheOverride.mdx b/documentation/docs/cache-override/CacheOverride/CacheOverride.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # `CacheOverride()`
 
diff --git a/documentation/docs/config-store/ConfigStore/ConfigStore.mdx b/documentation/docs/config-store/ConfigStore/ConfigStore.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # `ConfigStore()`
 
diff --git a/documentation/docs/config-store/ConfigStore/prototype/get.mdx b/documentation/docs/config-store/ConfigStore/prototype/get.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # ConfigStore.prototype.get
 
diff --git a/documentation/docs/device/Device/prototype/toJSON.mdx b/documentation/docs/device/Device/prototype/toJSON.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # toJSON
 
diff --git a/documentation/docs/dictionary/Dictionary/Dictionary.mdx b/documentation/docs/dictionary/Dictionary/Dictionary.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # `Dictionary()`
 
diff --git a/documentation/docs/dictionary/Dictionary/prototype/get.mdx b/documentation/docs/dictionary/Dictionary/prototype/get.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # Dictionary.prototype.get
 
diff --git a/documentation/docs/env/env.mdx b/documentation/docs/env/env.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # env
 
diff --git a/documentation/docs/experimental/allowDynamicBackends.mdx b/documentation/docs/experimental/allowDynamicBackends.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # allowDynamicBackends
 
diff --git a/documentation/docs/geolocation/getGeolocationForIpAddress.mdx b/documentation/docs/geolocation/getGeolocationForIpAddress.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # getGeolocationForIpAddress
 
diff --git a/documentation/docs/index.mdx b/documentation/docs/index.mdx
@@ -6,7 +6,6 @@ pagination_next: null
 pagination_prev: null
 ---
 
-import {Fiddle} from '@site/src/components/fiddle';
 
 # JavaScript for Fastly Compute
 
diff --git a/documentation/docs/logger/Logger/Logger.mdx b/documentation/docs/logger/Logger/Logger.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # `Logger()`
 
diff --git a/documentation/docs/logger/Logger/prototype/log.mdx b/documentation/docs/logger/Logger/prototype/log.mdx
@@ -4,7 +4,6 @@ hide_table_of_contents: false
 pagination_next: null
 pagination_prev: null
 ---
-import {Fiddle} from '@site/src/components/fiddle';
 
 # Logger.prototype.log
 
diff --git a/documentation/package-lock.json b/documentation/package-lock.json
diff --git a/documentation/src/theme/MDXComponents.js b/documentation/src/theme/MDXComponents.js
@@ -0,0 +1,8 @@
+import React from 'react';
+import MDXComponents from '@theme-original/MDXComponents';
+import {Fiddle} from '@site/src/components/fiddle';
+
+export default {
+  ...MDXComponents,
+  Fiddle,
+};
diff --git a/documentation/versioned_docs/version-3.36.0/experimental/allowDynamicBackends.mdx b/documentation/versioned_docs/version-3.36.0/experimental/allowDynamicBackends.mdx
@@ -47,7 +47,7 @@ or
 
 ## Examples
 
-In this example an implicit Dynamic Backend is created when making the fetch request to <https://www.fastly.com/> and the response is then returned to the client.
+In this example an implicit Dynamic Backend is created when making the fetch request to [https://www.fastly.com/](https://www.fastly.com/) and the response is then returned to the client.
 
 <Fiddle config={{
   "type": "javascript",
diff --git a/documentation/versioned_docs/version-3.36.0/globals/Math/asin.mdx b/documentation/versioned_docs/version-3.36.0/globals/Math/asin.mdx
@@ -21,7 +21,7 @@ Math.asin(x)
 
 ### Return value
 
-The inverse sine (angle in radians between <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">-\frac{\pi}{2}</annotation></semantics></math> and <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">\frac{\pi}{2}</annotation></semantics></math>, inclusive) of `x`. If `x` is less than -1 or greater than 1, returns `NaN`.
+The inverse sine (angle in radians between <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">{String.raw`-\frac{\pi}{2}`}</annotation></semantics></math> and <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">{String.raw`\frac{\pi}{2}`}</annotation></semantics></math>, inclusive) of `x`. If `x` is less than -1 or greater than 1, returns `NaN`.
 
 ## Description
 
diff --git a/documentation/versioned_docs/version-3.36.0/globals/Math/atan.mdx b/documentation/versioned_docs/version-3.36.0/globals/Math/atan.mdx
@@ -21,7 +21,7 @@ Math.atan(x)
 
 ### Return value
 
-The inverse tangent (angle in radians between <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">-\frac{\pi}{2}</annotation></semantics></math> and <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">\frac{\pi}{2}</annotation></semantics></math>, inclusive) of `x`. If `x` is `Infinity`, it returns <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">\frac{\pi}{2}</annotation></semantics></math>. If `x` is `-Infinity`, it returns <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">-\frac{\pi}{2}</annotation></semantics></math>.
+The inverse tangent (angle in radians between <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">{String.raw`-\frac{\pi}{2}`}</annotation></semantics></math> and <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">{String.raw`\frac{\pi}{2}`}</annotation></semantics></math>, inclusive) of `x`. If `x` is `Infinity`, it returns <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">{String.raw`\frac{\pi}{2}`}</annotation></semantics></math>. If `x` is `-Infinity`, it returns <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">{String.raw`-\frac{\pi}{2}`}</annotation></semantics></math>.
 
 ## Description
 
diff --git a/documentation/versioned_docs/version-3.36.0/globals/Math/atan2.mdx b/documentation/versioned_docs/version-3.36.0/globals/Math/atan2.mdx
@@ -46,6 +46,6 @@ The `Math.atan2()` method measures the counterclockwise angle θ, in radians, be
 | `-Infinity`          | < 0         | -π                 | 0                  |
 | -0                   | < 0         | -π / 2             | π / 2              |
 
-In addition, for points in the second and third quadrants (`x < 0`), `Math.atan2()` would output an angle less than <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">-\frac{\pi}{2}</annotation></semantics></math> or greater than <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">\frac{\pi}{2}</annotation></semantics></math>.
+In addition, for points in the second and third quadrants (`x < 0`), `Math.atan2()` would output an angle less than <math><semantics><mrow><mo>-</mo><mfrac><mi>π</mi><mn>2</mn></mfrac></mrow><annotation encoding="TeX">{String.raw`-\frac{\pi}{2}`}</annotation></semantics></math> or greater than <math><semantics><mfrac><mi>π</mi><mn>2</mn></mfrac><annotation encoding="TeX">{String.raw`\frac{\pi}{2}`}</annotation></semantics></math>.
 
 Because `atan2()` is a static method of `Math`, you always use it as `Math.atan2()`, rather than as a method of a `Math` object you created (`Math` is not a constructor).
diff --git a/documentation/versioned_docs/version-3.36.0/globals/Math/expm1.mdx b/documentation/versioned_docs/version-3.36.0/globals/Math/expm1.mdx
@@ -27,6 +27,6 @@ A number representing e<sup>x</sup> - 1, where e is [the base of the natural log
 
 For very small values of _x_, adding 1 can reduce or eliminate precision. The double floats used in JS give you about 15 digits of precision. 1 + 1e-15 \= 1.000000000000001, but 1 + 1e-16 = 1.000000000000000 and therefore exactly 1.0 in that arithmetic, because digits past 15 are rounded off.
 
-When you calculate <math display="inline"><semantics><msup><mi mathvariant="normal">e</mi><mi>x</mi></msup><annotation encoding="TeX">\mathrm{e}^x</annotation></semantics></math> where x is a number very close to 0, you should get an answer very close to 1 + x, because <math display="inline"><semantics><mrow><munder><mo lspace="0em" rspace="0em">lim</mo><mrow><mi>x</mi><mo stretchy="false">→</mo><mn>0</mn></mrow></munder><mfrac><mrow><msup><mi mathvariant="normal">e</mi><mi>x</mi></msup><mo>−</mo><mn>1</mn></mrow><mi>x</mi></mfrac><mo>=</mo><mn>1</mn></mrow><annotation encoding="TeX">\lim\_{x \to 0} \frac{\mathrm{e}^x - 1}{x} = 1</annotation></semantics></math>. If you calculate `Math.exp(1.1111111111e-15) - 1`, you should get an answer close to `1.1111111111e-15`. Instead, due to the highest significant figure in the result of `Math.exp` being the units digit `1`, the final value ends up being `1.1102230246251565e-15`, with only 3 correct digits. If, instead, you calculate `Math.exp1m(1.1111111111e-15)`, you will get a much more accurate answer `1.1111111111000007e-15`, with 11 correct digits of precision.
+When you calculate <math display="inline"><semantics><msup><mi mathvariant="normal">e</mi><mi>x</mi></msup><annotation encoding="TeX">{String.raw`\mathrm{e}^x`}</annotation></semantics></math> where x is a number very close to 0, you should get an answer very close to 1 + x, because <math display="inline"><semantics><mrow><munder><mo lspace="0em" rspace="0em">lim</mo><mrow><mi>x</mi><mo stretchy="false">→</mo><mn>0</mn></mrow></munder><mfrac><mrow><msup><mi mathvariant="normal">e</mi><mi>x</mi></msup><mo>−</mo><mn>1</mn></mrow><mi>x</mi></mfrac><mo>=</mo><mn>1</mn></mrow><annotation encoding="TeX">{String.raw`\lim\_{x \to 0} \frac{\mathrm{e}^x - 1}{x} = 1`}</annotation></semantics></math>. If you calculate `Math.exp(1.1111111111e-15) - 1`, you should get an answer close to `1.1111111111e-15`. Instead, due to the highest significant figure in the result of `Math.exp` being the units digit `1`, the final value ends up being `1.1102230246251565e-15`, with only 3 correct digits. If, instead, you calculate `Math.exp1m(1.1111111111e-15)`, you will get a much more accurate answer `1.1111111111000007e-15`, with 11 correct digits of precision.
 
 Because `expm1()` is a static method of `Math`, you always use it as `Math.expm1()`, rather than as a method of a `Math` object you created (`Math` is not a constructor).
diff --git a/documentation/versioned_docs/version-3.36.0/globals/Math/log1p.mdx b/documentation/versioned_docs/version-3.36.0/globals/Math/log1p.mdx
@@ -27,7 +27,7 @@ The natural logarithm (base [E](./E.mdx)) of `x + 1`. If `x` is -1, returns [`-I
 
 For very small values of _x_, adding 1 can reduce or eliminate precision. The double floats used in JS give you about 15 digits of precision. 1 + 1e-15 \= 1.000000000000001, but 1 + 1e-16 = 1.000000000000000 and therefore exactly 1.0 in that arithmetic, because digits past 15 are rounded off.
 
-When you calculate log(1 + _x_) where _x_ is a small positive number, you should get an answer very close to _x_, because <math display="inline"><semantics><mrow><munder><mo movablelimits="true" form="prefix">lim</mo><mrow ><mi>x</mi><mo stretchy="false">→</mo><mn>0</mn></mrow></munder><mfrac><mrow><mi>log</mi><mo>⁡</mo><mo stretchy="false">(</mo><mn>1</mn><mo>+</mo><mi>x</mi><mo stretchy="false">)</mo></mrow><mi>x</mi></mfrac><mo>=</mo><mn>1</mn></mrow><annotation encoding="TeX">\lim\_{x \to 0} \frac{\log(1+x)}{x} = 1</annotation></semantics></math>. If you calculate `Math.log(1 + 1.1111111111e-15)`, you should get an answer close to `1.1111111111e-15`. Instead, you will end up taking the logarithm of `1.00000000000000111022` (the roundoff is in binary, so sometimes it gets ugly), and get the answer 1.11022…e-15, with only 3 correct digits. If, instead, you calculate `Math.log1p(1.1111111111e-15)`, you will get a much more accurate answer `1.1111111110999995e-15`, with 15 correct digits of precision (actually 16 in this case).
+When you calculate log(1 + _x_) where _x_ is a small positive number, you should get an answer very close to _x_, because <math display="inline"><semantics><mrow><munder><mo movablelimits="true" form="prefix">lim</mo><mrow ><mi>x</mi><mo stretchy="false">→</mo><mn>0</mn></mrow></munder><mfrac><mrow><mi>log</mi><mo>⁡</mo><mo stretchy="false">(</mo><mn>1</mn><mo>+</mo><mi>x</mi><mo stretchy="false">)</mo></mrow><mi>x</mi></mfrac><mo>=</mo><mn>1</mn></mrow><annotation encoding="TeX">{String.raw`\lim\_{x \to 0} \frac{\log(1+x)}{x} = 1`}</annotation></semantics></math>. If you calculate `Math.log(1 + 1.1111111111e-15)`, you should get an answer close to `1.1111111111e-15`. Instead, you will end up taking the logarithm of `1.00000000000000111022` (the roundoff is in binary, so sometimes it gets ugly), and get the answer 1.11022…e-15, with only 3 correct digits. If, instead, you calculate `Math.log1p(1.1111111111e-15)`, you will get a much more accurate answer `1.1111111110999995e-15`, with 15 correct digits of precision (actually 16 in this case).
 
 If the value of `x` is less than -1, the return value is always `NaN`.
 
