humanbydefinition · humanbydefinition · Aug 22, 2026 · Aug 22, 2026 · Aug 22, 2026 · Aug 22, 2026
diff --git a/api/textmode.export.js/index.md b/api/textmode.export.js/index.md
@@ -7,7 +7,7 @@ category: API Reference
 api: true
 kind: Project
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 # textmode.export.js
@@ -65,6 +65,12 @@ the [Exporting guide](/docs/exporting).
 | [SVGExportOptions](type-aliases/SVGExportOptions.md) | Options for exporting the textmode content to SVG format. |
 | [TXTExportOptions](type-aliases/TXTExportOptions.md) | Options for exporting the textmode content to TXT format. |
 
+## Other
+
+| Type Alias | Description |
+| ------ | ------ |
+| [VideoContentHint](type-aliases/VideoContentHint.md) | Hint for the encoder's content-aware rate control. |
+
 ## Overlay
 
 | Name | Description |

diff --git a/api/textmode.export.js/interfaces/ExportOverlayController.md b/api/textmode.export.js/interfaces/ExportOverlayController.md
@@ -7,7 +7,7 @@ category: Interfaces
 api: true
 kind: Interface
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 isInterface: true
 ---
 

diff --git a/api/textmode.export.js/interfaces/ExportOverlayPosition.md b/api/textmode.export.js/interfaces/ExportOverlayPosition.md
@@ -7,7 +7,7 @@ category: Interfaces
 api: true
 kind: Interface
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 isInterface: true
 ---
 

diff --git a/api/textmode.export.js/interfaces/ExportOverlayPositionInput.md b/api/textmode.export.js/interfaces/ExportOverlayPositionInput.md
@@ -7,7 +7,7 @@ category: Interfaces
 api: true
 kind: Interface
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 isInterface: true
 ---
 

diff --git a/api/textmode.export.js/interfaces/LayerExportOptions.md b/api/textmode.export.js/interfaces/LayerExportOptions.md
@@ -7,7 +7,7 @@ category: Interfaces
 api: true
 kind: Interface
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 isInterface: true
 ---
 

diff --git a/api/textmode.export.js/interfaces/TextmodeExportAPI.md b/api/textmode.export.js/interfaces/TextmodeExportAPI.md
@@ -7,7 +7,7 @@ category: Interfaces
 api: true
 kind: Interface
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 isInterface: true
 ---
 

diff --git a/api/textmode.export.js/type-aliases/ExportDefaults.md b/api/textmode.export.js/type-aliases/ExportDefaults.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / ExportDefaults

diff --git a/api/textmode.export.js/type-aliases/ExportDefaultsPatch.md b/api/textmode.export.js/type-aliases/ExportDefaultsPatch.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / ExportDefaultsPatch

diff --git a/api/textmode.export.js/type-aliases/GIFExportOptions.md b/api/textmode.export.js/type-aliases/GIFExportOptions.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / GIFExportOptions

diff --git a/api/textmode.export.js/type-aliases/GIFExportProgress.md b/api/textmode.export.js/type-aliases/GIFExportProgress.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / GIFExportProgress

diff --git a/api/textmode.export.js/type-aliases/GIFOverlayDefaults.md b/api/textmode.export.js/type-aliases/GIFOverlayDefaults.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / GIFOverlayDefaults

diff --git a/api/textmode.export.js/type-aliases/ImageExportOptions.md b/api/textmode.export.js/type-aliases/ImageExportOptions.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / ImageExportOptions

diff --git a/api/textmode.export.js/type-aliases/ImageOverlayDefaults.md b/api/textmode.export.js/type-aliases/ImageOverlayDefaults.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / ImageOverlayDefaults

diff --git a/api/textmode.export.js/type-aliases/JSONExportColorMode.md b/api/textmode.export.js/type-aliases/JSONExportColorMode.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / JSONExportColorMode

diff --git a/api/textmode.export.js/type-aliases/JSONExportOptions.md b/api/textmode.export.js/type-aliases/JSONExportOptions.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / JSONExportOptions

diff --git a/api/textmode.export.js/type-aliases/JSONExportTarget.md b/api/textmode.export.js/type-aliases/JSONExportTarget.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / JSONExportTarget

diff --git a/api/textmode.export.js/type-aliases/JSONOverlayDefaults.md b/api/textmode.export.js/type-aliases/JSONOverlayDefaults.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / JSONOverlayDefaults

diff --git a/api/textmode.export.js/type-aliases/SVGExportOptions.md b/api/textmode.export.js/type-aliases/SVGExportOptions.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / SVGExportOptions

diff --git a/api/textmode.export.js/type-aliases/SVGOverlayDefaults.md b/api/textmode.export.js/type-aliases/SVGOverlayDefaults.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / SVGOverlayDefaults

diff --git a/api/textmode.export.js/type-aliases/TXTExportOptions.md b/api/textmode.export.js/type-aliases/TXTExportOptions.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / TXTExportOptions

diff --git a/api/textmode.export.js/type-aliases/TXTOverlayDefaults.md b/api/textmode.export.js/type-aliases/TXTOverlayDefaults.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / TXTOverlayDefaults

diff --git a/api/textmode.export.js/type-aliases/TextmodeDocumentJSON.md b/api/textmode.export.js/type-aliases/TextmodeDocumentJSON.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / TextmodeDocumentJSON

diff --git a/api/textmode.export.js/type-aliases/VideoBitrateMode.md b/api/textmode.export.js/type-aliases/VideoBitrateMode.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / VideoBitrateMode

diff --git a/api/textmode.export.js/type-aliases/VideoBitratePreset.md b/api/textmode.export.js/type-aliases/VideoBitratePreset.md
@@ -7,20 +7,20 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / VideoBitratePreset
 
 # Type Alias: VideoBitratePreset
 
 ```ts
-type VideoBitratePreset = "low" | "medium" | "high";
+type VideoBitratePreset = "low" | "medium" | "high" | "ultra";
 ```
 
 Subjective bitrate preset used when an exact bits-per-second value is not supplied.
 
-Higher presets produce larger files with more detail. Each preset maps to a fixed bits-per-pixel budget
-(bits per pixel per second), so a given preset resolves to the same bitrate regardless of the export
-frame rate. For exact control, pass a numeric `bitrate` value in bits per second instead.
+Higher presets request higher constant perceptual quality from Mediabunny. The `ultra` preset requests quantizer
+zero with a frame-rate-aware bitrate fallback and should be described as near-lossless, never mathematically
+lossless. For exact bitrate control, pass a numeric `bitrate` value in bits per second instead.
 
diff --git a/api/textmode.export.js/type-aliases/VideoContentHint.md b/api/textmode.export.js/type-aliases/VideoContentHint.md
@@ -0,0 +1,22 @@
+---
+layout: doc
+editLink: false
+title: VideoContentHint
+description: Hint for the encoder's content-aware rate control.
+category: Type Aliases
+api: true
+kind: TypeAlias
+ecosystem: textmode.js
+lastModified: 2026-08-22
+---
+
+[textmode.export.js](../index.md) / VideoContentHint
+
+# Type Alias: VideoContentHint
+
+```ts
+type VideoContentHint = "" | "motion" | "detail" | "text";
+```
+
+Hint for the encoder's content-aware rate control.
+
diff --git a/api/textmode.export.js/type-aliases/VideoExportFormat.md b/api/textmode.export.js/type-aliases/VideoExportFormat.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / VideoExportFormat

diff --git a/api/textmode.export.js/type-aliases/VideoExportOptions.md b/api/textmode.export.js/type-aliases/VideoExportOptions.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / VideoExportOptions
@@ -23,6 +23,17 @@ Options for exporting the textmode content to video format.
 
 ## Properties
 
+### allowLargeInMemory?
+
+```ts
+optional allowLargeInMemory?: boolean;
+```
+
+Allows `toVideoBlob()` to retain its in-memory contract above the safe 100 MB default.
+
+
+***
+
 ### bitrate?
 
 ```ts
@@ -31,10 +42,9 @@ optional bitrate?: number | VideoBitratePreset;
 
 Target bitrate in bits per second or a quality preset. Defaults to `'medium'`.
 
-Bitrate controls how much encoded data is available per second of video. Higher values can preserve more detail
-in noisy or fast-changing sketches, but create larger files. Presets resolve to a fixed bits-per-pixel budget
-from the export dimensions only, so a given preset targets the same bitrate regardless of the frame rate.
-Numeric values are passed directly to the encoder.
+String values request constant-quality encoding through Mediabunny. `low`, `medium`, and `high` map to the
+upstream `medium`, `high`, and `very-high` quality levels; `ultra` requests quantizer zero and may create very
+large files. Numeric values remain exact bits-per-second targets and are wrapped in Mediabunny `Quality`.
 
 
 ***
@@ -45,12 +55,23 @@ Numeric values are passed directly to the encoder.
 optional bitrateMode?: VideoBitrateMode;
 ```
 
-Encoder bitrate allocation mode. Defaults to `'variable'`.
+Bitrate allocation mode for numeric bitrates and quality fallback paths. Defaults to `'variable'`.
 
 Use `'variable'` for most exports so simple frames can compress efficiently and complex frames can receive more
 bits. Use `'constant'` only when a steadier data rate is more important than compression efficiency.
 
 
+***
+
+### contentHint?
+
+```ts
+optional contentHint?: VideoContentHint;
+```
+
+Content hint passed to the native video encoder. Defaults to `'text'`.
+
+
 ***
 
 ### debugLogging?
@@ -178,7 +199,7 @@ Progress callback invoked throughout the recording lifecycle.
 optional pixelDensity?: number;
 ```
 
-Pixel density used during export. Defaults to `1` so video dimensions match the live canvas.
+Pixel density used during export. Defaults to `1` so video dimensions match the logical canvas size.
 
 
 ***

diff --git a/api/textmode.export.js/type-aliases/VideoExportPhase.md b/api/textmode.export.js/type-aliases/VideoExportPhase.md
@@ -7,7 +7,7 @@ category: Type Aliases
 api: true
 kind: TypeAlias
 ecosystem: textmode.js
-lastModified: 2026-08-17
+lastModified: 2026-08-22
 ---
 
 [textmode.export.js](../index.md) / VideoExportPhase
@@ -21,6 +21,7 @@ type VideoExportPhase =
   | "capturing"
   | "encoding"
   | "draining"
+  | "writing"
   | "finalizing";
 ```