@imgly/codesign-mcp 0.1.5 → 0.1.6

package/assets/docs/guide/api/BlockAPI.md

@@ -14,7 +14,6 @@ export(handle: DesignBlockId, options?: ExportOptions): Promise<Blob>
 ```
 
 **Parameters:**
-
 - `handle` - The design block element to export.
 - `options` - The options for exporting the block type, including mime type and export settings.
 
@@ -30,7 +29,6 @@ exportWithColorMask(handle: DesignBlockId, maskColorR: number, maskColorG: numbe
 ```
 
 **Parameters:**
-
 - `handle` - The design block element to export.
 - `maskColorR` - The red component of the special color mask color.
 - `maskColorG` - The green component of the special color mask color.
@@ -49,7 +47,6 @@ exportVideo(handle: DesignBlockId, options?: VideoExportOptions): Promise<Blob>
 ```
 
 **Parameters:**
-
 - `handle` - The design block element to export. Currently, only page blocks are supported.
 - `options` - The options for exporting the video, including mime type, h264 profile, level, bitrate, time offset, duration, framerate, target width and height.
 
@@ -64,12 +61,33 @@ exportAudio(handle: DesignBlockId, options?: AudioExportOptions): Promise<Blob>
 ```
 
 **Parameters:**
-
 - `handle` - The design block element to export. Currently, only audio blocks are supported.
 - `options` - The options for exporting the audio, including mime type, progress callback, and export settings.
 
 **Returns:** A promise that resolves with an audio blob or is rejected with an error.
 
+## Block Analysis
+
+### getDominantColors()
+
+Extracts the dominant colors from the rendered appearance of a block.
+Performs an internal update to resolve the final layout for the block. Will not
+complete as long as assets are in a pending state; asset loading progresses during
+engine updates. Crops, color adjustments, and effects applied to the block are
+reflected in the returned palette. Fully or mostly transparent pixels are excluded
+from the analysis.
+
+```typescript
+getDominantColors(handle: DesignBlockId, options?: DominantColorsOptions): Promise<DominantColor[]>
+```
+
+**Parameters:**
+- `handle` - The design block element to analyze. Must be attached to a scene
+and render visible content.
+- `options` - See `DominantColorsOptions`.
+
+**Returns:** A promise that resolves with the dominant colors sorted by weight, descending.
+
 ## Block Lifecycle
 
 Manage the complete lifecycle: create, find, duplicate, destroy, and serialize blocks.
@@ -85,7 +103,6 @@ loadFromString(content: string): Promise<DesignBlockId[]>
 ```
 
 **Parameters:**
-
 - `content` - A string representing the given blocks.
 
 **Returns:** A promise that resolves with a list of handles representing the found blocks or an error.
@@ -102,7 +119,6 @@ loadFromArchiveURL(url: string): Promise<DesignBlockId[]>
 ```
 
 **Parameters:**
-
 - `url` - The URL of the blocks archive file.
 
 **Returns:** A promise that resolves with a list of handles representing the found blocks or an error.
@@ -119,7 +135,6 @@ loadFromURL(url: string): Promise<DesignBlockId[]>
 ```
 
 **Parameters:**
-
 - `url` - The URL to the blocks file
 
 **Returns:** A promise that resolves with a list of block handles
@@ -134,13 +149,12 @@ saveToString(blocks: DesignBlockId[], allowedResourceSchemes?: string[], onDisal
 ```
 
 **Parameters:**
-
 - `blocks` - The blocks to save.
 - `allowedResourceSchemes` - The resource schemes to allow in the saved string. Defaults to ['buffer', 'http', 'https'].
 - `onDisallowedResourceScheme` - An optional callback that is called for each resource URL that has a scheme absent from
-  `resourceSchemesAllowed`. The `url` parameter is the resource URL and the `dataHash` parameter is the hash of the
-  resource's data. The callback should return a new URL for the resource, which will be used in the serialized
-  scene. The callback is expected to return the original URL if no persistence is needed.
+`resourceSchemesAllowed`. The `url` parameter is the resource URL and the `dataHash` parameter is the hash of the
+resource's data. The callback should return a new URL for the resource, which will be used in the serialized
+scene. The callback is expected to return the original URL if no persistence is needed.
 
 **Returns:** A promise that resolves to a string representing the blocks or an error.
 
@@ -155,7 +169,6 @@ saveToArchive(blocks: DesignBlockId[]): Promise<Blob>
 ```
 
 **Parameters:**
-
 - `blocks` - The blocks to save.
 
 **Returns:** A promise that resolves with a Blob on success or an error on failure.
@@ -163,7 +176,6 @@ saveToArchive(blocks: DesignBlockId[]): Promise<Blob>
 ### create()
 
 Creates a new block of a given type.
-
 ```javascript
 // Create a new text block
 const text = engine.block.create('text');
@@ -174,21 +186,13 @@ const image = engine.block.create('graphic');
 engine.block.setShape(image, engine.block.createShape('rect'));
 const imageFill = engine.block.createFill('image');
 engine.block.setFill(image, imageFill);
-engine.block.setString(
-  imageFill,
-  'fill/image/imageFileURI',
-  'https://img.ly/static/ubq_samples/sample_1.jpg'
-);
+engine.block.setString(imageFill, 'fill/image/imageFileURI', 'https://img.ly/static/ubq_samples/sample_1.jpg');
 engine.block.appendChild(page, image);
 // Create a new video block
 const video = engine.block.create('graphic');
 engine.block.setShape(video, engine.block.createShape('rect'));
 const videoFill = engine.block.createFill('video');
-engine.block.setString(
-  videoFill,
-  'fill/video/fileURI',
-  'https://cdn.img.ly/assets/demo/v3/ly.img.video/videos/pexels-drone-footage-of-a-surfer-barrelling-a-wave-12715991.mp4'
-);
+engine.block.setString(videoFill, 'fill/video/fileURI', 'https://cdn.img.ly/assets/demo/v3/ly.img.video/videos/pexels-drone-footage-of-a-surfer-barrelling-a-wave-12715991.mp4');
 engine.block.setFill(video, videoFill);
 engine.block.appendChild(page, video);
 ```
@@ -198,7 +202,6 @@ create(type: DesignBlockType): DesignBlockId
 ```
 
 **Parameters:**
-
 - `type` - The type of the block that shall be created.
 
 **Returns:** The created block's handle.
@@ -212,7 +215,6 @@ duplicate(id: DesignBlockId, attachToParent?: boolean): DesignBlockId
 ```
 
 **Parameters:**
-
 - `id` - The block to duplicate.
 - `attachToParent` - Whether the duplicated block should be attached to the original's parent. Defaults to true.
 
@@ -227,21 +229,21 @@ destroy(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block to destroy.
 
 ### forceLoadResources()
 
 Forces the loading of resources for a set of blocks and their children.
 This is useful for preloading resources. If a resource failed to load previously, it will be reloaded.
+Pass an empty array to load resources for every block currently known to the engine.
 
 ```typescript
 forceLoadResources(ids: DesignBlockId[]): Promise<void>
 ```
 
 **Parameters:**
-
-- `ids` - The blocks whose resources should be loaded.
+- `ids` - The blocks whose resources should be loaded. Pass an empty array to load resources for every
+  block currently known to the engine.
 
 **Returns:** A Promise that resolves once all resources have finished loading.
 
@@ -252,7 +254,6 @@ Create, configure, and manage block fills, including solid colors, gradients, an
 ### createFill()
 
 Creates a new fill block.
-
 ```javascript
 const solidColoFill = engine.block.createFill('color');
 // Longhand fill types are also supported
@@ -264,12 +265,11 @@ createFill(type: FillType): DesignBlockId
 ```
 
 **Parameters:**
-
 - `type` - The type of the fill object that shall be created.
 
 **Returns:** The created fill's handle.
 
-### hasContentFillMode() _(deprecated)_
+### hasContentFillMode() *(deprecated)*
 
 Checks if a block supports content fill modes.
 
@@ -278,7 +278,6 @@ hasContentFillMode(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has a content fill mode.
@@ -292,7 +291,6 @@ supportsContentFillMode(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has a content fill mode.
@@ -300,7 +298,6 @@ supportsContentFillMode(id: DesignBlockId): boolean
 ### setContentFillMode()
 
 Sets the content fill mode of a block.
-
 ```javascript
 engine.block.setContentFillMode(image, 'Cover');
 ```
@@ -310,14 +307,12 @@ setContentFillMode(id: DesignBlockId, mode: ContentFillMode): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `mode` - The content fill mode: 'Crop', 'Cover' or 'Contain'.
 
 ### getContentFillMode()
 
 Gets the content fill mode of a block.
-
 ```javascript
 engine.block.getContentFillMode(image);
 ```
@@ -327,15 +322,79 @@ getContentFillMode(id: DesignBlockId): ContentFillMode
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The current mode: 'Crop', 'Cover' or 'Contain'.
 
+### setContentFillHorizontalAlignment()
+
+Sets the horizontal alignment of the content fill within a block.
+Only affects 'Contain' and 'Cover' fill modes; has no visible effect in 'Crop' mode,
+where the user positions the content explicitly.
+```javascript
+engine.block.setContentFillHorizontalAlignment(image, 'Left');
+```
+
+```typescript
+setContentFillHorizontalAlignment(id: DesignBlockId, alignment: HorizontalContentFillAlignment): void
+```
+
+**Parameters:**
+- `id` - The block to update.
+- `alignment` - The horizontal alignment: 'Left', 'Center' or 'Right'.
+
+### getContentFillHorizontalAlignment()
+
+Gets the horizontal alignment of the content fill within a block.
+```javascript
+engine.block.getContentFillHorizontalAlignment(image);
+```
+
+```typescript
+getContentFillHorizontalAlignment(id: DesignBlockId): HorizontalContentFillAlignment
+```
+
+**Parameters:**
+- `id` - The block to query.
+
+**Returns:** The current alignment: 'Left', 'Center' or 'Right'.
+
+### setContentFillVerticalAlignment()
+
+Sets the vertical alignment of the content fill within a block.
+Only affects 'Contain' and 'Cover' fill modes; has no visible effect in 'Crop' mode,
+where the user positions the content explicitly.
+```javascript
+engine.block.setContentFillVerticalAlignment(image, 'Top');
+```
+
+```typescript
+setContentFillVerticalAlignment(id: DesignBlockId, alignment: VerticalContentFillAlignment): void
+```
+
+**Parameters:**
+- `id` - The block to update.
+- `alignment` - The vertical alignment: 'Top', 'Center' or 'Bottom'.
+
+### getContentFillVerticalAlignment()
+
+Gets the vertical alignment of the content fill within a block.
+```javascript
+engine.block.getContentFillVerticalAlignment(image);
+```
+
+```typescript
+getContentFillVerticalAlignment(id: DesignBlockId): VerticalContentFillAlignment
+```
+
+**Parameters:**
+- `id` - The block to query.
+
+**Returns:** The current alignment: 'Top', 'Center' or 'Bottom'.
+
 ### setGradientColorStops()
 
 Sets the color stops for a gradient property.
-
 ```javascript
 engine.block.setGradientColorStops(gradientFill, 'fill/gradient/colors', [
   { color: { r: 1.0, g: 0.8, b: 0.2, a: 1.0 }, stop: 0 },
@@ -348,7 +407,6 @@ setGradientColorStops(id: DesignBlockId, property: string, colors: GradientColor
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set, e.g. 'fill/gradient/colors'.
 - `colors` - An array of gradient color stops.
@@ -356,7 +414,6 @@ setGradientColorStops(id: DesignBlockId, property: string, colors: GradientColor
 ### getGradientColorStops()
 
 Gets the color stops from a gradient property.
-
 ```
 engine.block.getGradientColorStops(gradientFill, 'fill/gradient/colors');
 ```
@@ -366,7 +423,6 @@ getGradientColorStops(id: DesignBlockId, property: string): GradientColorStop[]
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
@@ -375,7 +431,6 @@ getGradientColorStops(id: DesignBlockId, property: string): GradientColorStop[]
 ### getSourceSet()
 
 Gets the source set from a block property.
-
 ```javascript
 const sourceSet = engine.block.getSourceSet(imageFill, 'fill/image/sourceSet');
 ```
@@ -385,7 +440,6 @@ getSourceSet(id: DesignBlockId, property: SourceSetPropertyName): Source[]
 ```
 
 **Parameters:**
-
 - `id` - The block that should be queried.
 - `property` - The name of the property to query, e.g. 'fill/image/sourceSet'.
 
@@ -395,15 +449,12 @@ getSourceSet(id: DesignBlockId, property: SourceSetPropertyName): Source[]
 
 Sets the source set for a block property.
 The crop and content fill mode of the associated block will be reset to default values.
-
 ```javascript
-engine.block.setSourceSet(imageFill, 'fill/image/sourceSet', [
-  {
-    uri: 'https://example.com/sample.jpg',
-    width: 800,
-    height: 600
-  }
-]);
+engine.block.setSourceSet(imageFill, 'fill/image/sourceSet', [{
+  uri: 'https://example.com/sample.jpg',
+  width: 800,
+  height: 600
+}]);
 ```
 
 ```typescript
@@ -411,7 +462,6 @@ setSourceSet(id: DesignBlockId, property: SourceSetPropertyName, sourceSet: Sour
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `sourceSet` - The block's new source set.
@@ -420,13 +470,8 @@ setSourceSet(id: DesignBlockId, property: SourceSetPropertyName, sourceSet: Sour
 
 Adds an image file URI to a source set property.
 If an image with the same width already exists in the source set, it will be replaced.
-
 ```javascript
-await engine.block.addImageFileURIToSourceSet(
-  imageFill,
-  'fill/image/sourceSet',
-  'https://example.com/sample.jpg'
-);
+await engine.block.addImageFileURIToSourceSet(imageFill, 'fill/image/sourceSet', 'https://example.com/sample.jpg');
 ```
 
 ```typescript
@@ -434,7 +479,6 @@ addImageFileURIToSourceSet(id: DesignBlockId, property: SourceSetPropertyName, u
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `property` - The name of the property to modify.
 - `uri` - The source to add to the source set.
@@ -445,13 +489,8 @@ addImageFileURIToSourceSet(id: DesignBlockId, property: SourceSetPropertyName, u
 
 Adds a video file URI to a source set property.
 If a video with the same width already exists in the source set, it will be replaced.
-
 ```javascript
-await engine.block.addVideoFileURIToSourceSet(
-  videoFill,
-  'fill/video/sourceSet',
-  'https://example.com/sample.mp4'
-);
+await engine.block.addVideoFileURIToSourceSet(videoFill, 'fill/video/sourceSet', 'https://example.com/sample.mp4');
 ```
 
 ```typescript
@@ -459,14 +498,13 @@ addVideoFileURIToSourceSet(id: DesignBlockId, property: SourceSetPropertyName, u
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `property` - The name of the property to modify.
 - `uri` - The source to add to the source set.
 
 **Returns:** A promise that resolves when the operation is complete.
 
-### hasFillColor() _(deprecated)_
+### hasFillColor() *(deprecated)*
 
 Checks if a block has fill color properties.
 
@@ -475,12 +513,11 @@ hasFillColor(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has fill color properties.
 
-### setFillColorRGBA() _(deprecated)_
+### setFillColorRGBA() *(deprecated)*
 
 Sets the fill color of a block using RGBA values.
 
@@ -489,14 +526,13 @@ setFillColorRGBA(id: DesignBlockId, r: number, g: number, b: number, a?: number)
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill color should be set.
 - `r` - The red color component in the range of 0 to 1.
 - `g` - The green color component in the range of 0 to 1.
 - `b` - The blue color component in the range of 0 to 1.
 - `a` - The alpha color component in the range of 0 to 1.
 
-### getFillColorRGBA() _(deprecated)_
+### getFillColorRGBA() *(deprecated)*
 
 Gets the fill color of a block as RGBA values.
 
@@ -505,12 +541,11 @@ getFillColorRGBA(id: DesignBlockId): RGBA
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill color should be queried.
 
 **Returns:** The fill color.
 
-### setFillColorEnabled() _(deprecated)_
+### setFillColorEnabled() *(deprecated)*
 
 Enables or disables the fill of a block.
 
@@ -519,11 +554,10 @@ setFillColorEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill should be enabled or disabled.
 - `enabled` - If true, the fill will be enabled.
 
-### isFillColorEnabled() _(deprecated)_
+### isFillColorEnabled() *(deprecated)*
 
 Checks if the fill of a block is enabled.
 
@@ -532,12 +566,11 @@ isFillColorEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill state should be queried.
 
 **Returns:** True, if fill is enabled.
 
-### hasFill() _(deprecated)_
+### hasFill() *(deprecated)*
 
 Checks if a block has fill properties.
 
@@ -546,7 +579,6 @@ hasFill(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has fill properties.
@@ -560,7 +592,6 @@ supportsFill(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block supports a fill.
@@ -568,7 +599,6 @@ supportsFill(id: DesignBlockId): boolean
 ### isFillEnabled()
 
 Checks if the fill of a block is enabled.
-
 ```javascript
 engine.block.isFillEnabled(block);
 ```
@@ -578,7 +608,6 @@ isFillEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill state should be queried.
 
 **Returns:** The fill state.
@@ -586,7 +615,6 @@ isFillEnabled(id: DesignBlockId): boolean
 ### setFillEnabled()
 
 Enables or disables the fill of a block.
-
 ```javascript
 engine.block.setFillEnabled(block, false);
 ```
@@ -596,10 +624,43 @@ setFillEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill should be enabled or disabled.
 - `enabled` - If true, the fill will be enabled.
 
+### getFillOverprint()
+
+Queries whether the fill of a block is marked as overprint for PDF export.
+```javascript
+const overprint = engine.block.getFillOverprint(block);
+```
+
+```typescript
+getFillOverprint(id: DesignBlockId): boolean
+```
+
+**Parameters:**
+- `id` - The block whose fill overprint flag should be queried.
+
+**Returns:** The fill overprint flag.
+
+### setFillOverprint()
+
+Marks the fill of a block as overprint for PDF export.
+The flag is only honored by the PDF writer when the fill uses a spot color
+(Separation/DeviceN). For process-color fills it is a silent no-op. On-screen
+rendering ignores the flag.
+```javascript
+engine.block.setFillOverprint(block, true);
+```
+
+```typescript
+setFillOverprint(id: DesignBlockId, overprint: boolean): void
+```
+
+**Parameters:**
+- `id` - The block whose fill overprint flag should be set.
+- `overprint` - If true, the fill is marked as overprint in exported PDFs.
+
 ### getFill()
 
 Gets the fill block attached to a given block.
@@ -609,7 +670,6 @@ getFill(id: DesignBlockId): DesignBlockId
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill block should be returned.
 
 **Returns:** The block that currently defines the given block's fill.
@@ -624,7 +684,6 @@ setFill(id: DesignBlockId, fill: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill should be changed.
 - `fill` - The new fill block.
 
@@ -637,7 +696,6 @@ setFillSolidColor(id: DesignBlockId, r: number, g: number, b: number, a?: number
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill color should be set.
 - `r` - The red color component in the range of 0 to 1.
 - `g` - The green color component in the range of 0 to 1.
@@ -653,7 +711,6 @@ getFillSolidColor(id: DesignBlockId): RGBA
 ```
 
 **Parameters:**
-
 - `id` - The block whose fill color should be queried.
 
 **Returns:** The fill color.
@@ -663,7 +720,6 @@ getFillSolidColor(id: DesignBlockId): RGBA
 ### getAudioTrackCountFromVideo()
 
 Gets the number of available audio tracks in a video fill block.
-
 ```javascript
 const trackCount = engine.block.getAudioTrackCountFromVideo(videoBlock);
 console.log(`Video has ${trackCount} audio tracks`);
@@ -674,7 +730,6 @@ getAudioTrackCountFromVideo(videoFillBlock: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `videoFillBlock` - The video fill block to examine.
 
 **Returns:** The number of audio tracks.
@@ -682,19 +737,13 @@ getAudioTrackCountFromVideo(videoFillBlock: DesignBlockId): number
 ### createAudioFromVideo()
 
 Creates a new audio block by extracting a specific audio track from a video fill block.
-
 ```javascript
 // Extract the first audio track (usually the main mix) with trim settings
 const audioBlock = engine.block.createAudioFromVideo(videoFillBlock, 0);
 // Extract full audio track without trim settings
-const audioBlock = engine.block.createAudioFromVideo(videoFillBlock, 0, {
-  keepTrimSettings: false
-});
+const audioBlock = engine.block.createAudioFromVideo(videoFillBlock, 0, { keepTrimSettings: false });
 // Extract a specific track, keep trim settings, and mute the original video
-const dialogueTrack = engine.block.createAudioFromVideo(videoFillBlock, 1, {
-  keepTrimSettings: true,
-  muteOriginalVideo: true
-});
+const dialogueTrack = engine.block.createAudioFromVideo(videoFillBlock, 1, { keepTrimSettings: true, muteOriginalVideo: true });
 ```
 
 ```typescript
@@ -702,7 +751,6 @@ createAudioFromVideo(videoFillBlock: DesignBlockId, trackIndex: number, options?
 ```
 
 **Parameters:**
-
 - `videoFillBlock` - The video fill block to extract audio from.
 - `trackIndex` - The index of the audio track to extract (0-based).
 - `options` - Options for the audio extraction operation.
@@ -712,20 +760,14 @@ createAudioFromVideo(videoFillBlock: DesignBlockId, trackIndex: number, options?
 ### createAudiosFromVideo()
 
 Creates multiple audio blocks by extracting all audio tracks from a video fill block.
-
 ```javascript
 // Extract all audio tracks from a video with trim settings
 const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock);
 console.log(`Created ${audioBlocks.length} audio blocks`);
 // Extract all tracks without trim settings (full audio)
-const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock, {
-  keepTrimSettings: false
-});
+const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock, { keepTrimSettings: false });
 // Extract all tracks with trim settings and mute the original video
-const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock, {
-  keepTrimSettings: true,
-  muteOriginalVideo: true
-});
+const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock, { keepTrimSettings: true, muteOriginalVideo: true });
 ```
 
 ```typescript
@@ -733,7 +775,6 @@ createAudiosFromVideo(videoFillBlock: DesignBlockId, options?: AudioFromVideoOpt
 ```
 
 **Parameters:**
-
 - `videoFillBlock` - The video fill block to extract audio from.
 - `options` - Options for the audio extraction operation.
 
@@ -742,20 +783,17 @@ createAudiosFromVideo(videoFillBlock: DesignBlockId, options?: AudioFromVideoOpt
 ### getAudioInfoFromVideo()
 
 Gets information about all audio tracks from a video fill block.
-
 ```javascript
 // Get information about all audio tracks
 const trackInfos = engine.block.getAudioInfoFromVideo(videoFillBlock);
 console.log(`Video has ${trackInfos.length} audio tracks`);
 // Display track information
 trackInfos.forEach((track, index) => {
-  console.log(
-    `Track ${index}: ${track.channels} channels, ${track.sampleRate}Hz, ${track.language}`
-  );
+  console.log(`Track ${index}: ${track.channels} channels, ${track.sampleRate}Hz, ${track.language}`);
 });
 // Use track info to create audio blocks selectively
-const englishTracks = trackInfos.filter((track) => track.language === 'eng');
-const audioBlocks = englishTracks.map((track) =>
+const englishTracks = trackInfos.filter(track => track.language === 'eng');
+const audioBlocks = englishTracks.map(track =>
   engine.block.createAudioFromVideo(videoFillBlock, track.trackIndex)
 );
 ```
@@ -765,7 +803,6 @@ getAudioInfoFromVideo(videoFillBlock: DesignBlockId): AudioTrackInfo[]
 ```
 
 **Parameters:**
-
 - `videoFillBlock` - The video fill block to analyze for audio track information.
 
 **Returns:** An array containing information about each audio track.
@@ -783,12 +820,11 @@ createCaptionsFromURI(uri: string): Promise<DesignBlockId[]>
 ```
 
 **Parameters:**
-
 - `uri` - The URI for the captions file to load. Supported file formats are: SRT and VTT.
 
 **Returns:** A promise that resolves with a list of the created caption blocks.
 
-### hasDuration() _(deprecated)_
+### hasDuration() *(deprecated)*
 
 Checks if a block has a duration property.
 
@@ -797,7 +833,6 @@ hasDuration(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true if the block has a duration property.
@@ -811,7 +846,6 @@ supportsDuration(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true if the block supports a duration property.
@@ -826,7 +860,6 @@ setDuration(id: DesignBlockId, duration: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose duration should be changed.
 - `duration` - The new duration in seconds.
 
@@ -839,7 +872,6 @@ getDuration(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose duration should be returned.
 
 **Returns:** The block's duration in seconds.
@@ -854,7 +886,6 @@ setPageDurationSource(page: DesignBlockId, id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `page` - The page block for which it should be enabled.
 - `id` - The block that should become the duration source.
 
@@ -867,7 +898,6 @@ isPageDurationSource(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose duration source property should be queried.
 
 **Returns:** true if the block is a duration source for a page.
@@ -881,7 +911,6 @@ supportsPageDurationSource(page: DesignBlockId, id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `page` - The page to check against.
 - `id` - The block to query.
 
@@ -897,10 +926,9 @@ removePageDurationSource(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose duration source property should be removed.
 
-### hasTimeOffset() _(deprecated)_
+### hasTimeOffset() *(deprecated)*
 
 Checks if a block has a time offset property.
 
@@ -909,7 +937,6 @@ hasTimeOffset(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has a time offset property.
@@ -923,7 +950,6 @@ supportsTimeOffset(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block supports a time offset.
@@ -938,7 +964,6 @@ setTimeOffset(id: DesignBlockId, offset: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose time offset should be changed.
 - `offset` - The new time offset in seconds.
 
@@ -951,12 +976,11 @@ getTimeOffset(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose time offset should be queried.
 
 **Returns:** The time offset of the block in seconds.
 
-### hasTrim() _(deprecated)_
+### hasTrim() *(deprecated)*
 
 Checks if a block has trim properties.
 
@@ -965,7 +989,6 @@ hasTrim(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has trim properties.
@@ -979,7 +1002,6 @@ supportsTrim(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block supports trim properties.
@@ -994,7 +1016,6 @@ setTrimOffset(id: DesignBlockId, offset: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose trim should be updated.
 - `offset` - The new trim offset, measured in timeline seconds (scaled by playback rate).
 
@@ -1007,7 +1028,6 @@ getTrimOffset(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose trim offset should be queried.
 
 **Returns:** the trim offset in seconds.
@@ -1022,7 +1042,6 @@ setTrimLength(id: DesignBlockId, length: number): void
 ```
 
 **Parameters:**
-
 - `id` - The object whose trim length should be updated.
 - `length` - The new trim length in seconds.
 
@@ -1035,12 +1054,11 @@ getTrimLength(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The object whose trim length should be queried.
 
 **Returns:** The trim length of the object in seconds.
 
-### getTotalSceneDuration() _(deprecated)_
+### getTotalSceneDuration() *(deprecated)*
 
 Gets the total duration of a scene in video mode.
 
@@ -1049,7 +1067,6 @@ getTotalSceneDuration(scene: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `scene` - The scene whose duration is being queried.
 
 **Returns:** the total scene duration.
@@ -1063,7 +1080,6 @@ setPlaying(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block that should be updated.
 - `enabled` - Whether the block should be playing its contents.
 
@@ -1076,12 +1092,11 @@ isPlaying(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** whether the block is playing during playback.
 
-### hasPlaybackTime() _(deprecated)_
+### hasPlaybackTime() *(deprecated)*
 
 Checks if a block has a playback time property.
 
@@ -1090,7 +1105,6 @@ hasPlaybackTime(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** whether the block has a playback time property.
@@ -1104,7 +1118,6 @@ supportsPlaybackTime(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** whether the block supports a playback time property.
@@ -1118,7 +1131,6 @@ setPlaybackTime(id: DesignBlockId, time: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose playback time should be updated.
 - `time` - The new playback time of the block in seconds.
 
@@ -1131,7 +1143,6 @@ getPlaybackTime(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The playback time of the block in seconds.
@@ -1140,7 +1151,6 @@ getPlaybackTime(id: DesignBlockId): number
 
 Enables or disables solo playback for a block.
 When enabled, only this block's content will play while the rest of the scene remains paused.
-
 ```javascript
 engine.block.setSoloPlaybackEnabled(videoFill, true);
 ```
@@ -1150,14 +1160,12 @@ setSoloPlaybackEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block or fill to update.
 - `enabled` - Whether solo playback should be enabled.
 
 ### isSoloPlaybackEnabled()
 
 Checks if solo playback is enabled for a block.
-
 ```javascript
 engine.block.isSoloPlaybackEnabled(videoFill);
 ```
@@ -1167,12 +1175,11 @@ isSoloPlaybackEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block or fill to query.
 
 **Returns:** Whether solo playback is enabled for this block.
 
-### hasPlaybackControl() _(deprecated)_
+### hasPlaybackControl() *(deprecated)*
 
 Checks if a block has playback controls.
 
@@ -1181,7 +1188,6 @@ hasPlaybackControl(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** Whether the block has playback control.
@@ -1195,7 +1201,6 @@ supportsPlaybackControl(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** Whether the block supports playback control.
@@ -1209,7 +1214,6 @@ setLooping(id: DesignBlockId, looping: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block or video fill to update.
 - `looping` - Whether the block should loop to the beginning or stop.
 
@@ -1222,7 +1226,6 @@ isLooping(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** Whether the block is looping.
@@ -1236,7 +1239,6 @@ setMuted(id: DesignBlockId, muted: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block or video fill to update.
 - `muted` - Whether the audio should be muted.
 
@@ -1249,7 +1251,6 @@ isForceMuted(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** Whether the block is force muted.
@@ -1263,7 +1264,6 @@ isMuted(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** Whether the block is muted.
@@ -1277,7 +1277,6 @@ setVolume(id: DesignBlockId, volume: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block or video fill to update.
 - `volume` - The desired volume, ranging from 0.0 to 1.0.
 
@@ -1290,7 +1289,6 @@ getVolume(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The volume, ranging from 0.0 to 1.0.
@@ -1306,10 +1304,9 @@ setPlaybackSpeed(id: DesignBlockId, speed: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block or video fill to update.
 - `speed` - The desired playback speed multiplier. Valid range is [0.25, 3.0] for audio blocks and
-  [0.25, infinity) for video fills.
+[0.25, infinity) for video fills.
 
 ### getPlaybackSpeed()
 
@@ -1320,7 +1317,6 @@ getPlaybackSpeed(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The playback speed multiplier.
@@ -1335,7 +1331,6 @@ forceLoadAVResource(id: DesignBlockId): Promise<void>
 ```
 
 **Parameters:**
-
 - `id` - The video fill or audio block whose resource should be loaded.
 
 **Returns:** A Promise that resolves once the resource has finished loading.
@@ -1349,7 +1344,6 @@ unstable_isAVResourceLoaded(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The video fill or audio block.
 
 **Returns:** The loading state of the resource.
@@ -1363,7 +1357,6 @@ getAVResourceTotalDuration(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The video fill or audio block.
 
 **Returns:** The video or audio file duration in seconds.
@@ -1377,7 +1370,6 @@ getVideoWidth(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The video fill block.
 
 **Returns:** The video width in pixels.
@@ -1391,7 +1383,6 @@ getVideoHeight(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The video fill block.
 
 **Returns:** The video height in pixels.
@@ -1407,7 +1398,6 @@ generateVideoThumbnailSequence(id: DesignBlockId, thumbnailHeight: number, timeB
 ```
 
 **Parameters:**
-
 - `id` - The video fill or design block.
 - `thumbnailHeight` - The height of each thumbnail.
 - `timeBegin` - The start time in seconds for the thumbnail sequence.
@@ -1429,7 +1419,6 @@ generateAudioThumbnailSequence(id: DesignBlockId, samplesPerChunk: number, timeB
 ```
 
 **Parameters:**
-
 - `id` - The audio block or video fill.
 - `samplesPerChunk` - The number of samples per chunk.
 - `timeBegin` - The start time in seconds for the thumbnail sequence.
@@ -1440,7 +1429,7 @@ generateAudioThumbnailSequence(id: DesignBlockId, samplesPerChunk: number, timeB
 
 **Returns:** A function to cancel the thumbnail generation request.
 
-### getVideoFillThumbnail() _(deprecated)_
+### getVideoFillThumbnail() *(deprecated)*
 
 Generates a thumbnail for a video fill.
 
@@ -1449,13 +1438,12 @@ getVideoFillThumbnail(id: DesignBlockId, thumbnailHeight: number): Promise<Blob>
 ```
 
 **Parameters:**
-
 - `id` - The video fill.
 - `thumbnailHeight` - The height of a thumbnail. The width will be calculated from the video aspect ratio.
 
 **Returns:** A promise that resolves with a thumbnail encoded as a JPEG blob.
 
-### getVideoFillThumbnailAtlas() _(deprecated)_
+### getVideoFillThumbnailAtlas() *(deprecated)*
 
 Generates a thumbnail atlas for a video fill.
 
@@ -1464,7 +1452,6 @@ getVideoFillThumbnailAtlas(id: DesignBlockId, numberOfColumns: number, numberOfR
 ```
 
 **Parameters:**
-
 - `id` - The video fill.
 - `numberOfColumns` - The number of columns in the atlas.
 - `numberOfRows` - The number of rows in the atlas.
@@ -1472,7 +1459,7 @@ getVideoFillThumbnailAtlas(id: DesignBlockId, numberOfColumns: number, numberOfR
 
 **Returns:** A promise that resolves with a thumbnail atlas encoded as a JPEG blob.
 
-### getPageThumbnailAtlas() _(deprecated)_
+### getPageThumbnailAtlas() *(deprecated)*
 
 Generates a thumbnail atlas for a page.
 
@@ -1481,7 +1468,6 @@ getPageThumbnailAtlas(id: DesignBlockId, numberOfColumns: number, numberOfRows:
 ```
 
 **Parameters:**
-
 - `id` - The page.
 - `numberOfColumns` - The number of columns in the atlas.
 - `numberOfRows` - The number of rows in the atlas.
@@ -1498,7 +1484,6 @@ setNativePixelBuffer(id: number, buffer: HTMLCanvasElement | HTMLVideoElement):
 ```
 
 **Parameters:**
-
 - `id` - The pixel stream fill block.
 - `buffer` - A canvas or video element to use as the pixel source.
 
@@ -1515,7 +1500,6 @@ getType(id: DesignBlockId): ObjectTypeLonghand
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The block's type.
@@ -1529,7 +1513,6 @@ setName(id: DesignBlockId, name: string): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `name` - The name to set.
 
@@ -1542,7 +1525,6 @@ getName(id: DesignBlockId): string
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The block's name.
@@ -1556,7 +1538,6 @@ getUUID(id: DesignBlockId): string
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The block's UUID.
@@ -1571,7 +1552,6 @@ isValid(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block is valid.
@@ -1586,7 +1566,6 @@ referencesAnyVariables(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to inspect.
 
 **Returns:** true if the block references variables and false otherwise.
@@ -1600,7 +1579,6 @@ isIncludedInExport(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block is included on the exported result, false otherwise.
@@ -1614,7 +1592,6 @@ setIncludedInExport(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose exportable state should be set.
 - `enabled` - If true, the block will be included on the exported result.
 
@@ -1627,7 +1604,6 @@ isVisibleAtCurrentPlaybackTime(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** Whether the block should be visible on the canvas at the current playback time.
@@ -1636,7 +1612,6 @@ isVisibleAtCurrentPlaybackTime(id: DesignBlockId): boolean
 
 Gets the current state of a block.
 A block's state is determined by its own state and that of its shape, fill, and effects.
-
 ```javascript
 const state = engine.block.getState(block);
 ```
@@ -1646,7 +1621,6 @@ getState(id: DesignBlockId): BlockState
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The block's state: 'Ready', 'Pending', or 'Error'.
@@ -1654,11 +1628,10 @@ getState(id: DesignBlockId): BlockState
 ### setState()
 
 Sets the state of a block.
-
 ```javascript
-engine.block.setState(video, { type: 'Pending', progress: 0.5 });
-engine.block.setState(page, { type: 'Ready' });
-engine.block.setState(image, { type: 'Error', error: 'ImageDecoding' });
+engine.block.setState(video, {type: 'Pending', progress: 0.5});
+engine.block.setState(page, {type: 'Ready'});
+engine.block.setState(image, {type: 'Error', error: 'ImageDecoding'});
 ```
 
 ```typescript
@@ -1666,7 +1639,6 @@ setState(id: DesignBlockId, state: BlockState): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose state should be set.
 - `state` - The new state to set.
 
@@ -1677,7 +1649,6 @@ Get and set a block's 'kind' identifier for custom categorization.
 ### getKind()
 
 Gets the kind of a given block.
-
 ```javascript
 const kind = engine.block.getKind(block);
 ```
@@ -1687,7 +1658,6 @@ getKind(id: DesignBlockId): string
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The block's kind.
@@ -1695,7 +1665,6 @@ getKind(id: DesignBlockId): string
 ### setKind()
 
 Sets the kind of a given block, a custom string for categorization of blocks.
-
 ```javascript
 engine.block.setKind(text, 'title');
 ```
@@ -1705,7 +1674,6 @@ setKind(id: DesignBlockId, kind: string): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose kind should be changed.
 - `kind` - The new kind.
 
@@ -1720,7 +1688,6 @@ select(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block to be selected.
 
 ### setSelected()
@@ -1732,7 +1699,6 @@ setSelected(id: DesignBlockId, selected: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 - `selected` - Whether or not the block should be selected.
 
@@ -1745,7 +1711,6 @@ isSelected(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True if the block is selected, false otherwise.
@@ -1769,7 +1734,6 @@ isVisible(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True if visible, false otherwise.
@@ -1783,7 +1747,6 @@ setVisible(id: DesignBlockId, visible: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `visible` - Whether the block shall be visible.
 
@@ -1800,7 +1763,6 @@ onSelectionChanged(callback: () => void): (() => void)
 ```
 
 **Parameters:**
-
 - `callback` - This function is called at the end of the engine update if the selection has changed.
 
 **Returns:** A method to unsubscribe.
@@ -1814,7 +1776,6 @@ onClicked(callback: (id: DesignBlockId) => void): (() => void)
 ```
 
 **Parameters:**
-
 - `callback` - This function is called at the end of the engine update if a block has been clicked.
 
 **Returns:** A method to unsubscribe.
@@ -1823,10 +1784,9 @@ onClicked(callback: (id: DesignBlockId) => void): (() => void)
 
 Subscribes to state changes for a set of blocks.
 The state is determined by the block and its associated shape, fill, and effects.
-
 ```javascript
 const unsubscribe = engine.block.onStateChanged([], (blocks) => {
-  blocks.forEach((block) => console.log(block));
+  blocks.forEach(block => console.log(block));
 });
 ```
 
@@ -1835,7 +1795,6 @@ onStateChanged(ids: DesignBlockId[], callback: (ids: DesignBlockId[]) => void):
 ```
 
 **Parameters:**
-
 - `ids` - A list of block IDs to monitor. If empty, all blocks are monitored.
 - `callback` - The function to call when a state changes.
 
@@ -1849,9 +1808,8 @@ Create and manage groups of blocks.
 
 Checks if a set of blocks can be grouped.
 A scene block or a block that is already part of a group cannot be grouped.
-
 ```javascript
-const groupable = engine.block.isGroupable([block1, block2]);
+const groupable = engine.block.isGroupable([block1, block2])
 ```
 
 ```typescript
@@ -1859,7 +1817,6 @@ isGroupable(ids: DesignBlockId[]): boolean
 ```
 
 **Parameters:**
-
 - `ids` - An array of block ids.
 
 **Returns:** Whether the blocks can be grouped together.
@@ -1867,7 +1824,6 @@ isGroupable(ids: DesignBlockId[]): boolean
 ### group()
 
 Groups multiple blocks into a new group block.
-
 ```javascript
 if (engine.block.isGroupable([block1, block2])) {
   const group = engine.block.group(block1, block2]);
@@ -1879,7 +1835,6 @@ group(ids: DesignBlockId[]): DesignBlockId
 ```
 
 **Parameters:**
-
 - `ids` - A non-empty array of block ids.
 
 **Returns:** The block id of the created group.
@@ -1887,7 +1842,6 @@ group(ids: DesignBlockId[]): DesignBlockId
 ### ungroup()
 
 Ungroups a group block, releasing its children.
-
 ```javascript
 engine.block.ungroup(group);
 ```
@@ -1897,14 +1851,12 @@ ungroup(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The group id from a previous call to `group`.
 
 ### enterGroup()
 
 Changes selection to a block within a selected group.
 Nothing happens if the target is not a group.
-
 ```javascript
 engine.block.enterGroup(group);
 ```
@@ -1914,14 +1866,12 @@ enterGroup(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The group id from a previous call to `group`.
 
 ### exitGroup()
 
 Changes selection from a block to its parent group.
 Nothing happens if the block is not part of a group.
-
 ```javascript
 engine.block.exitGroup(member1);
 ```
@@ -1931,7 +1881,6 @@ exitGroup(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - A block id.
 
 ## Block Boolean Operations
@@ -1949,7 +1898,6 @@ isCombinable(ids: DesignBlockId[]): boolean
 ```
 
 **Parameters:**
-
 - `ids` - An array of block ids.
 
 **Returns:** Whether the blocks can be combined.
@@ -1965,7 +1913,6 @@ combine(ids: DesignBlockId[], op: BooleanOperation): DesignBlockId
 ```
 
 **Parameters:**
-
 - `ids` - The blocks to combine. They will be destroyed if "lifecycle/destroy" scope is enabled.
 - `op` - The boolean operation to perform.
 
@@ -1984,7 +1931,6 @@ findByName(name: string): DesignBlockId[]
 ```
 
 **Parameters:**
-
 - `name` - The name to search for.
 
 **Returns:** A list of block ids.
@@ -1998,7 +1944,6 @@ findByType(type: ObjectType): DesignBlockId[]
 ```
 
 **Parameters:**
-
 - `type` - The type to search for.
 
 **Returns:** A list of block ids.
@@ -2006,7 +1951,6 @@ findByType(type: ObjectType): DesignBlockId[]
 ### findByKind()
 
 Finds all blocks with a given kind.
-
 ```javascript
 const allTitles = engine.block.findByKind('title');
 ```
@@ -2016,7 +1960,6 @@ findByKind(kind: string): DesignBlockId[]
 ```
 
 **Parameters:**
-
 - `kind` - The kind to search for.
 
 **Returns:** A list of block ids.
@@ -2041,6 +1984,22 @@ findAllPlaceholders(): DesignBlockId[]
 
 **Returns:** A list of block ids.
 
+### findAllUnused()
+
+Finds all blocks that are not attached to any scene.
+A block is considered unused when it has no path to a scene (no scene
+reference and no ancestor that belongs to a scene) and is not itself a
+scene. Generated blocks and render blocks (fills, effects, shapes, blurs)
+are excluded, matching the behaviour of {@link BlockAPI.findAll}.
+This is useful for cleanup workflows and for filtering the URIs returned
+by {@link EditorAPI.findAllMediaURIs} before relocating resources.
+
+```typescript
+findAllUnused(): DesignBlockId[]
+```
+
+**Returns:** A list of block ids that are not attached to any scene.
+
 ## Block Shapes
 
 Create and configure shape blocks and geometric forms.
@@ -2048,7 +2007,6 @@ Create and configure shape blocks and geometric forms.
 ### createShape()
 
 Creates a new shape block of a given type.
-
 ```javascript
 const star = engine.block.createShape('star');
 // Longhand shape types are also supported
@@ -2060,12 +2018,11 @@ createShape(type: ShapeType): DesignBlockId
 ```
 
 **Parameters:**
-
 - `type` - The type of the shape object that shall be created.
 
 **Returns:** The created shape's handle.
 
-### hasShape() _(deprecated)_
+### hasShape() *(deprecated)*
 
 Checks if a block has a shape property.
 
@@ -2074,7 +2031,6 @@ hasShape(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has a shape property, an error otherwise.
@@ -2088,7 +2044,6 @@ supportsShape(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has a shape property, an error otherwise.
@@ -2102,7 +2057,6 @@ getShape(id: DesignBlockId): DesignBlockId
 ```
 
 **Parameters:**
-
 - `id` - The block whose shape block should be returned.
 
 **Returns:** The block that currently defines the given block's shape.
@@ -2118,7 +2072,6 @@ setShape(id: DesignBlockId, shape: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose shape should be changed.
 - `shape` - The new shape.
 
@@ -2136,7 +2089,6 @@ isClipped(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True if clipped, false otherwise.
@@ -2150,7 +2102,6 @@ setClipped(id: DesignBlockId, clipped: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `clipped` - Whether the block should clips its contents to its frame.
 
@@ -2163,7 +2114,6 @@ getFlipHorizontal(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** A boolean indicating whether the block is flipped horizontally.
@@ -2177,7 +2127,6 @@ getFlipVertical(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** A boolean indicating whether the block is flipped vertically.
@@ -2191,7 +2140,6 @@ setFlipHorizontal(id: DesignBlockId, flip: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `flip` - If the flip should be enabled.
 
@@ -2204,11 +2152,10 @@ setFlipVertical(id: DesignBlockId, flip: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `flip` - If the flip should be enabled.
 
-### hasOpacity() _(deprecated)_
+### hasOpacity() *(deprecated)*
 
 Checks if a block has an opacity property.
 
@@ -2217,7 +2164,6 @@ hasOpacity(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has an opacity.
@@ -2231,7 +2177,6 @@ supportsOpacity(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block supports opacity.
@@ -2245,7 +2190,6 @@ setOpacity(id: DesignBlockId, opacity: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose opacity should be set.
 - `opacity` - The opacity to be set. The valid range is 0 to 1.
 
@@ -2258,12 +2202,11 @@ getOpacity(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose opacity should be queried.
 
 **Returns:** The opacity value.
 
-### hasBlendMode() _(deprecated)_
+### hasBlendMode() *(deprecated)*
 
 Checks if a block has a blend mode property.
 
@@ -2272,7 +2215,6 @@ hasBlendMode(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has a blend mode.
@@ -2286,7 +2228,6 @@ supportsBlendMode(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block supports blend modes.
@@ -2300,7 +2241,6 @@ setBlendMode(id: DesignBlockId, blendMode: BlendMode): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose blend mode should be set.
 - `blendMode` - The blend mode to be set.
 
@@ -2313,12 +2253,11 @@ getBlendMode(id: DesignBlockId): BlendMode
 ```
 
 **Parameters:**
-
 - `id` - The block whose blend mode should be queried.
 
 **Returns:** The blend mode.
 
-### hasBackgroundColor() _(deprecated)_
+### hasBackgroundColor() *(deprecated)*
 
 Checks if a block has background color properties.
 
@@ -2327,7 +2266,6 @@ hasBackgroundColor(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has background color properties.
@@ -2341,12 +2279,11 @@ supportsBackgroundColor(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block supports a background color.
 
-### setBackgroundColorRGBA() _(deprecated)_
+### setBackgroundColorRGBA() *(deprecated)*
 
 Sets the background color of a block using RGBA values.
 
@@ -2355,14 +2292,13 @@ setBackgroundColorRGBA(id: DesignBlockId, r: number, g: number, b: number, a?: n
 ```
 
 **Parameters:**
-
 - `id` - The block whose background color should be set.
 - `r` - The red color component in the range of 0 to 1.
 - `g` - The green color component in the range of 0 to 1.
 - `b` - The blue color component in the range of 0 to 1.
 - `a` - The alpha color component in the range of 0 to 1.
 
-### getBackgroundColorRGBA() _(deprecated)_
+### getBackgroundColorRGBA() *(deprecated)*
 
 Gets the background color of a block as RGBA values.
 
@@ -2371,7 +2307,6 @@ getBackgroundColorRGBA(id: DesignBlockId): RGBA
 ```
 
 **Parameters:**
-
 - `id` - The block whose background color should be queried.
 
 **Returns:** The background color.
@@ -2379,7 +2314,6 @@ getBackgroundColorRGBA(id: DesignBlockId): RGBA
 ### setBackgroundColorEnabled()
 
 Enables or disables the background of a block.
-
 ```javascript
 engine.block.setBackgroundColorEnabled(block, true);
 ```
@@ -2389,14 +2323,12 @@ setBackgroundColorEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose background should be enabled or disabled.
 - `enabled` - If true, the background will be enabled.
 
 ### isBackgroundColorEnabled()
 
 Checks if the background of a block is enabled.
-
 ```javascript
 const backgroundColorIsEnabled = engine.block.isBackgroundColorEnabled(block);
 ```
@@ -2406,7 +2338,6 @@ isBackgroundColorEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose background state should be queried.
 
 **Returns:** True, if background is enabled.
@@ -2425,11 +2356,25 @@ isTransformLocked(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True if transform locked, false otherwise.
 
+### isLineOrigin()
+
+Checks whether a graphic block originated as a line shape. Survives the
+line's conversion to a vector path during vector-edit; resets only when
+the shape is replaced by a non-line shape via `setShape`.
+
+```typescript
+isLineOrigin(id: DesignBlockId): boolean
+```
+
+**Parameters:**
+- `id` - The block to query.
+
+**Returns:** True if the block originated as a line shape, false otherwise.
+
 ### setTransformLocked()
 
 Sets the transform-locked state of a block.
@@ -2439,7 +2384,6 @@ setTransformLocked(id: DesignBlockId, locked: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `locked` - Whether the block's transform should be locked.
 
@@ -2452,7 +2396,6 @@ getPositionX(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The value of the x position.
@@ -2466,7 +2409,6 @@ getPositionXMode(id: DesignBlockId): PositionXMode
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The current mode for the x position: 'Absolute' or 'Percent'.
@@ -2480,7 +2422,6 @@ getPositionY(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The value of the y position.
@@ -2494,7 +2435,6 @@ getPositionYMode(id: DesignBlockId): PositionYMode
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The current mode for the y position: 'Absolute' or 'Percent'.
@@ -2503,7 +2443,6 @@ getPositionYMode(id: DesignBlockId): PositionYMode
 
 Sets the X position of a block.
 The position refers to the block's local space, relative to its parent with the origin at the top left.
-
 ```javascript
 engine.block.setPositionX(block, 0.25);
 ```
@@ -2513,14 +2452,12 @@ setPositionX(id: DesignBlockId, value: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `value` - The value of the x position.
 
 ### setPositionXMode()
 
 Sets the mode for the block's X position.
-
 ```javascript
 engine.block.setPositionXMode(block, 'Percent');
 ```
@@ -2530,7 +2467,6 @@ setPositionXMode(id: DesignBlockId, mode: PositionXMode): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `mode` - The x position mode: 'Absolute' or 'Percent'.
 
@@ -2538,7 +2474,6 @@ setPositionXMode(id: DesignBlockId, mode: PositionXMode): void
 
 Sets the Y position of a block.
 The position refers to the block's local space, relative to its parent with the origin at the top left.
-
 ```javascript
 engine.block.setPositionY(block, 0.25);
 ```
@@ -2548,14 +2483,12 @@ setPositionY(id: DesignBlockId, value: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `value` - The value of the y position.
 
 ### setPositionYMode()
 
 Sets the mode for the block's Y position.
-
 ```javascript
 engine.block.setPositionYMode(block, 'Absolute');
 ```
@@ -2565,7 +2498,6 @@ setPositionYMode(id: DesignBlockId, mode: PositionYMode): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `mode` - The y position mode: 'Absolute' or 'Percent'.
 
@@ -2579,7 +2511,6 @@ setAlwaysOnTop(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - the block to update.
 - `enabled` - whether the block shall be always-on-top.
 
@@ -2593,7 +2524,6 @@ setAlwaysOnBottom(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - the block to update.
 - `enabled` - whether the block shall always be below its siblings.
 
@@ -2606,7 +2536,6 @@ isAlwaysOnTop(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - the block to query.
 
 **Returns:** true if the block is set to be always-on-top, false otherwise.
@@ -2620,7 +2549,6 @@ isAlwaysOnBottom(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - the block to query.
 
 **Returns:** true if the block is set to be always-on-bottom, false otherwise.
@@ -2635,7 +2563,6 @@ bringToFront(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The id of the block to bring to the front.
 
 ### sendToBack()
@@ -2648,7 +2575,6 @@ sendToBack(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The id of the block to send to the back.
 
 ### bringForward()
@@ -2661,7 +2587,6 @@ bringForward(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The id of the block to bring forward.
 
 ### sendBackward()
@@ -2674,7 +2599,6 @@ sendBackward(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The id of the block to send backward.
 
 ### getRotation()
@@ -2686,7 +2610,6 @@ getRotation(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The block's rotation around its center in radians.
@@ -2701,14 +2624,12 @@ setRotation(id: DesignBlockId, radians: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `radians` - The new rotation in radians.
 
 ### getWidth()
 
 Gets the width of a block in the current width mode.
-
 ```javascript
 const width = engine.block.getWidth(block);
 ```
@@ -2718,7 +2639,6 @@ getWidth(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The value of the block's width.
@@ -2726,7 +2646,6 @@ getWidth(id: DesignBlockId): number
 ### getWidthMode()
 
 Gets the mode for the block's width.
-
 ```javascript
 const widthMode = engine.block.getWidthMode(block);
 ```
@@ -2736,7 +2655,6 @@ getWidthMode(id: DesignBlockId): WidthMode
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The current mode for the width: 'Absolute', 'Percent' or 'Auto'.
@@ -2744,7 +2662,6 @@ getWidthMode(id: DesignBlockId): WidthMode
 ### getHeight()
 
 Gets the height of a block in the current height mode.
-
 ```javascript
 const height = engine.block.getHeight(block);
 ```
@@ -2754,7 +2671,6 @@ getHeight(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The value of the block's height.
@@ -2762,7 +2678,6 @@ getHeight(id: DesignBlockId): number
 ### getHeightMode()
 
 Gets the mode for the block's height.
-
 ```javascript
 const heightMode = engine.block.getHeightMode(block);
 ```
@@ -2772,7 +2687,6 @@ getHeightMode(id: DesignBlockId): HeightMode
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The current mode for the height: 'Absolute', 'Percent' or 'Auto'.
@@ -2781,7 +2695,6 @@ getHeightMode(id: DesignBlockId): HeightMode
 
 Sets the width of a block in the current width mode.
 If the crop is maintained, the crop values will be automatically adjusted.
-
 ```javascript
 engine.block.setWidth(block, 2.5, true);
 ```
@@ -2791,7 +2704,6 @@ setWidth(id: DesignBlockId, value: number, maintainCrop?: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `value` - The new width of the block.
 - `maintainCrop` - Whether or not the crop values, if available, should be automatically adjusted.
@@ -2799,7 +2711,6 @@ setWidth(id: DesignBlockId, value: number, maintainCrop?: boolean): void
 ### setWidthMode()
 
 Sets the mode for the block's width.
-
 ```javascript
 engine.block.setWidthMode(block, 'Percent');
 ```
@@ -2809,7 +2720,6 @@ setWidthMode(id: DesignBlockId, mode: WidthMode): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `mode` - The width mode: 'Absolute', 'Percent' or 'Auto'.
 
@@ -2817,7 +2727,6 @@ setWidthMode(id: DesignBlockId, mode: WidthMode): void
 
 Sets the height of a block in the current height mode.
 If the crop is maintained, the crop values will be automatically adjusted.
-
 ```javascript
 engine.block.setHeight(block, 0.5);
 engine.block.setHeight(block, 2.5, true);
@@ -2828,7 +2737,6 @@ setHeight(id: DesignBlockId, value: number, maintainCrop?: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `value` - The new height of the block.
 - `maintainCrop` - Whether or not the crop values, if available, should be automatically adjusted.
@@ -2836,7 +2744,6 @@ setHeight(id: DesignBlockId, value: number, maintainCrop?: boolean): void
 ### setHeightMode()
 
 Sets the mode for the block's height.
-
 ```javascript
 engine.block.setHeightMode(block, 'Percent');
 ```
@@ -2846,7 +2753,6 @@ setHeightMode(id: DesignBlockId, mode: HeightMode): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `mode` - The height mode: 'Absolute', 'Percent' or 'Auto'.
 
@@ -2854,7 +2760,6 @@ setHeightMode(id: DesignBlockId, mode: HeightMode): void
 
 Gets the final calculated X position of a block's frame.
 The position is only available after an internal update loop.
-
 ```javascript
 const frameX = engine.block.getFrameX(block);
 ```
@@ -2864,7 +2769,6 @@ getFrameX(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The layout position on the x-axis.
@@ -2873,7 +2777,6 @@ getFrameX(id: DesignBlockId): number
 
 Gets the final calculated Y position of a block's frame.
 The position is only available after an internal update loop.
-
 ```javascript
 const frameY = engine.block.getFrameY(block);
 ```
@@ -2883,7 +2786,6 @@ getFrameY(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The layout position on the y-axis.
@@ -2892,7 +2794,6 @@ getFrameY(id: DesignBlockId): number
 
 Gets the final calculated width of a block's frame.
 The width is only available after an internal update loop.
-
 ```javascript
 const frameWidth = engine.block.getFrameWidth(block);
 ```
@@ -2902,7 +2803,6 @@ getFrameWidth(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The layout width.
@@ -2911,7 +2811,6 @@ getFrameWidth(id: DesignBlockId): number
 
 Gets the final calculated height of a block's frame.
 The height is only available after an internal update loop.
-
 ```javascript
 const frameHeight = engine.block.getFrameHeight(block);
 ```
@@ -2921,7 +2820,6 @@ getFrameHeight(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The layout height.
@@ -2930,7 +2828,6 @@ getFrameHeight(id: DesignBlockId): number
 
 Gets the X position of the block's global bounding box.
 The position is in the scene's global coordinate space, with the origin at the top left.
-
 ```javascript
 const globalX = engine.block.getGlobalBoundingBoxX(block);
 ```
@@ -2940,7 +2837,6 @@ getGlobalBoundingBoxX(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose bounding box should be calculated.
 
 **Returns:** The x coordinate of the axis-aligned bounding box.
@@ -2949,7 +2845,6 @@ getGlobalBoundingBoxX(id: DesignBlockId): number
 
 Gets the Y position of the block's global bounding box.
 The position is in the scene's global coordinate space, with the origin at the top left.
-
 ```javascript
 const globalY = engine.block.getGlobalBoundingBoxY(block);
 ```
@@ -2959,7 +2854,6 @@ getGlobalBoundingBoxY(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose bounding box should be calculated.
 
 **Returns:** The y coordinate of the axis-aligned bounding box.
@@ -2968,7 +2862,6 @@ getGlobalBoundingBoxY(id: DesignBlockId): number
 
 Gets the width of the block's global bounding box.
 The width is in the scene's global coordinate space.
-
 ```javascript
 const globalWidth = engine.block.getGlobalBoundingBoxWidth(block);
 ```
@@ -2978,7 +2871,6 @@ getGlobalBoundingBoxWidth(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose bounding box should be calculated.
 
 **Returns:** The width of the axis-aligned bounding box.
@@ -2987,7 +2879,6 @@ getGlobalBoundingBoxWidth(id: DesignBlockId): number
 
 Gets the height of the block's global bounding box.
 The height is in the scene's global coordinate space.
-
 ```javascript
 const globalHeight = engine.block.getGlobalBoundingBoxHeight(block);
 ```
@@ -2997,7 +2888,6 @@ getGlobalBoundingBoxHeight(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose bounding box should be calculated.
 
 **Returns:** The height of the axis-aligned bounding box.
@@ -3005,7 +2895,6 @@ getGlobalBoundingBoxHeight(id: DesignBlockId): number
 ### getScreenSpaceBoundingBoxXYWH()
 
 Gets the screen-space bounding box for a set of blocks.
-
 ```javascript
 const boundingBox = engine.block.getScreenSpaceBoundingBoxXYWH([block]);
 ```
@@ -3015,7 +2904,6 @@ getScreenSpaceBoundingBoxXYWH(ids: DesignBlockId[]): XYWH
 ```
 
 **Parameters:**
-
 - `ids` - The block to query.
 
 **Returns:** The position and size of the bounding box.
@@ -3030,7 +2918,6 @@ alignHorizontally(ids: DesignBlockId[], horizontalBlockAlignment: TextHorizontal
 ```
 
 **Parameters:**
-
 - `ids` - A non-empty array of block ids.
 - `horizontalBlockAlignment` - How they should be aligned: 'Left', 'Right', or 'Center'.
 
@@ -3044,7 +2931,6 @@ alignVertically(ids: DesignBlockId[], verticalBlockAlignment: TextVerticalAlignm
 ```
 
 **Parameters:**
-
 - `ids` - A non-empty array of block ids.
 - `verticalBlockAlignment` - How they should be aligned: 'Top', 'Bottom', or 'Center'.
 
@@ -3058,7 +2944,6 @@ distributeHorizontally(ids: DesignBlockId[]): void
 ```
 
 **Parameters:**
-
 - `ids` - A non-empty array of block ids.
 
 ### distributeVertically()
@@ -3071,7 +2956,6 @@ distributeVertically(ids: DesignBlockId[]): void
 ```
 
 **Parameters:**
-
 - `ids` - A non-empty array of block ids.
 
 ### fillParent()
@@ -3084,7 +2968,6 @@ fillParent(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block that should fill its parent.
 
 ### resizeContentAware()
@@ -3092,7 +2975,6 @@ fillParent(id: DesignBlockId): void
 Resizes blocks while adjusting content to fit.
 The content of the blocks is automatically adjusted to fit the new dimensions.
 Full-page blocks are resized to remain as full-page afterwards, while the blocks that are not full-page get resized as a group to the same scale factor and centered.
-
 ```javascript
 const pages = engine.scene.getPages();
 engine.block.resizeContentAware(pages, width: 100.0, 100.0);
@@ -3103,7 +2985,6 @@ resizeContentAware(ids: DesignBlockId[], width: number, height: number): void
 ```
 
 **Parameters:**
-
 - `ids` - The blocks to resize.
 - `width` - The new width of the blocks.
 - `height` - The new height of the blocks.
@@ -3113,7 +2994,6 @@ resizeContentAware(ids: DesignBlockId[], width: number, height: number): void
 Scales a block and its children proportionally.
 This updates the position, size and style properties (e.g. stroke width) of
 the block and its children around the specified anchor point.
-
 ```javascript
 // Scale a block to double its size, anchored at the center.
 engine.block.scale(block, 2.0, 0.5, 0.5);
@@ -3124,7 +3004,6 @@ scale(id: DesignBlockId, scale: number, anchorX?: number, anchorY?: number): voi
 ```
 
 **Parameters:**
-
 - `id` - The block that should be scaled.
 - `scale` - The scale factor to be applied to the current properties of the block.
 - `anchorX` - The relative position along the width of the block around which the scaling should occur (0=left, 0.5=center, 1=right). Defaults to 0.
@@ -3146,7 +3025,6 @@ setSize(id: DesignBlockId, width: number, height: number, options?: {
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `width` - The new width of the block.
 - `height` - The new height of the block.
@@ -3165,7 +3043,6 @@ setPosition(id: DesignBlockId, x: number, y: number, options?: {
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `x` - The new x position of the block.
 - `y` - The new y position of the block.
@@ -3182,7 +3059,6 @@ addImage(url: string, options?: AddImageOptions): Promise<DesignBlockId>
 ```
 
 **Parameters:**
-
 - `url` - URL or path to the image file
 - `options` - Configuration options for the image
 
@@ -3198,7 +3074,6 @@ addVideo(url: string, width: number, height: number, options?: AddVideoOptions):
 ```
 
 **Parameters:**
-
 - `url` - URL or path to the video file
 - `width` - Width of the video in scene design units
 - `height` - Height of the video in scene design units
@@ -3215,7 +3090,6 @@ applyAnimation(block: DesignBlockId, animation?: AnimationOptions): void
 ```
 
 **Parameters:**
-
 - `block` - The ID of the block to apply the animation to
 - `animation` - The animation configuration options
 
@@ -3228,7 +3102,6 @@ applyDropShadow(block: DesignBlockId, options?: DropShadowOptions): void
 ```
 
 **Parameters:**
-
 - `block` - The ID of the block to apply the shadow to
 - `options` - Shadow configuration options. If not provided, enables shadow with default settings
 
@@ -3241,7 +3114,6 @@ generateThumbnailAtTimeOffset(height: number, time: number): Promise<Blob>
 ```
 
 **Parameters:**
-
 - `height` - Height of the thumbnail in scene design units (maximum 512)
 - `time` - Time position in seconds to capture the thumbnail
 
@@ -3271,7 +3143,6 @@ moveToBackgroundTrack(block: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `block` - The ID of the block to move to the background track
 
 ## Block Hierarchies
@@ -3287,7 +3158,6 @@ getParent(id: DesignBlockId): DesignBlockId | null
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The parent's handle or null if the block has no parent.
@@ -3302,7 +3172,6 @@ getChildren(id: DesignBlockId): DesignBlockId[]
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** A list of block ids.
@@ -3316,7 +3185,6 @@ insertChild(parent: DesignBlockId, child: DesignBlockId, index: number): void
 ```
 
 **Parameters:**
-
 - `parent` - The block whose children should be updated.
 - `child` - The child to insert. Can be an existing child of `parent`.
 - `index` - The index to insert or move to.
@@ -3330,7 +3198,6 @@ appendChild(parent: DesignBlockId, child: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `parent` - The block whose children should be updated.
 - `child` - The child to insert. Can be an existing child of `parent`.
 
@@ -3347,7 +3214,6 @@ isAlignable(ids: DesignBlockId[]): boolean
 ```
 
 **Parameters:**
-
 - `ids` - An array of block ids.
 
 **Returns:** Whether the blocks can be aligned.
@@ -3361,7 +3227,6 @@ isDistributable(ids: DesignBlockId[]): boolean
 ```
 
 **Parameters:**
-
 - `ids` - An array of block ids.
 
 **Returns:** Whether the blocks can be distributed.
@@ -3379,7 +3244,6 @@ findAllProperties(id: DesignBlockId): string[]
 ```
 
 **Parameters:**
-
 - `id` - The block whose properties should be queried.
 
 **Returns:** A list of the property names.
@@ -3393,7 +3257,6 @@ isPropertyReadable(property: string): boolean
 ```
 
 **Parameters:**
-
 - `property` - The name of the property to check.
 
 **Returns:** Whether the property is readable. Returns false for unknown properties.
@@ -3407,7 +3270,6 @@ isPropertyWritable(property: string): boolean
 ```
 
 **Parameters:**
-
 - `property` - The name of the property to check.
 
 **Returns:** Whether the property is writable. Returns false for unknown properties.
@@ -3421,7 +3283,6 @@ getPropertyType(property: string): PropertyType
 ```
 
 **Parameters:**
-
 - `property` - The name of the property whose type should be queried.
 
 **Returns:** The property type.
@@ -3435,7 +3296,6 @@ getEnumValues<T = string>(enumProperty: string): T[]
 ```
 
 **Parameters:**
-
 - `enumProperty` - The name of the property whose enum values should be queried.
 
 **Returns:** A list of the enum value names as a string array.
@@ -3443,7 +3303,6 @@ getEnumValues<T = string>(enumProperty: string): T[]
 ### setBool()
 
 Sets a boolean property on a block.
-
 ```javascript
 engine.block.setBool(scene, 'scene/aspectRatioLock', false);
 ```
@@ -3453,7 +3312,6 @@ setBool(id: DesignBlockId, property: BoolPropertyName, value: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `value` - The value to set.
@@ -3461,7 +3319,6 @@ setBool(id: DesignBlockId, property: BoolPropertyName, value: boolean): void
 ### getBool()
 
 Gets a boolean property from a block.
-
 ```javascript
 engine.block.getBool(scene, 'scene/aspectRatioLock');
 ```
@@ -3471,7 +3328,6 @@ getBool(id: DesignBlockId, property: BoolPropertyName): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
@@ -3480,7 +3336,6 @@ getBool(id: DesignBlockId, property: BoolPropertyName): boolean
 ### setInt()
 
 Sets an integer property on a block.
-
 ```javascript
 engine.block.setInt(starShape, 'shape/star/points', points + 2);
 ```
@@ -3490,7 +3345,6 @@ setInt(id: DesignBlockId, property: IntPropertyName, value: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `value` - The value to set.
@@ -3498,7 +3352,6 @@ setInt(id: DesignBlockId, property: IntPropertyName, value: number): void
 ### getInt()
 
 Gets an integer property from a block.
-
 ```javascript
 engine.block.setInt(starShape, 'shape/star/points', points + 2);
 ```
@@ -3508,7 +3361,6 @@ getInt(id: DesignBlockId, property: IntPropertyName): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
@@ -3517,10 +3369,9 @@ getInt(id: DesignBlockId, property: IntPropertyName): number
 ### setFloat()
 
 Sets a float property on a block.
-
 ```javascript
-engine.block.setFloat(text, 'text/letterSpacing', 0.2);
-engine.block.setFloat(text, 'text/lineHeight', 1.2);
+engine.block.setFloat(text, "text/letterSpacing", 0.2);
+engine.block.setFloat(text, "text/lineHeight", 1.2);
 ```
 
 ```typescript
@@ -3528,7 +3379,6 @@ setFloat(id: DesignBlockId, property: FloatPropertyName, value: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `value` - The value to set.
@@ -3536,7 +3386,6 @@ setFloat(id: DesignBlockId, property: FloatPropertyName, value: number): void
 ### getFloat()
 
 Gets a float property from a block.
-
 ```javascript
 engine.block.getFloat(starShape, 'shape/star/innerDiameter');
 ```
@@ -3546,7 +3395,6 @@ getFloat(id: DesignBlockId, property: FloatPropertyName): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
@@ -3555,7 +3403,6 @@ getFloat(id: DesignBlockId, property: FloatPropertyName): number
 ### setDouble()
 
 Sets a double-precision float property on a block.
-
 ```javascript
 engine.block.setDouble(audio, 'playback/duration', 1.0);
 ```
@@ -3565,7 +3412,6 @@ setDouble(id: DesignBlockId, property: DoublePropertyName, value: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `value` - The value to set.
@@ -3573,7 +3419,6 @@ setDouble(id: DesignBlockId, property: DoublePropertyName, value: number): void
 ### getDouble()
 
 Gets a double-precision float property from a block.
-
 ```javascript
 engine.block.getDouble(audio, 'playback/duration');
 ```
@@ -3583,7 +3428,6 @@ getDouble(id: DesignBlockId, property: DoublePropertyName): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
@@ -3592,14 +3436,9 @@ getDouble(id: DesignBlockId, property: DoublePropertyName): number
 ### setString()
 
 Sets a string property on a block.
-
 ```javascript
 engine.block.setString(text, 'text/text', 'Hello World');
-engine.block.setString(
-  imageFill,
-  'fill/image/imageFileURI',
-  'https://example.com/sample.jpg'
-);
+engine.block.setString(imageFill, 'fill/image/imageFileURI', 'https://example.com/sample.jpg');
 ```
 
 ```typescript
@@ -3607,7 +3446,6 @@ setString(id: DesignBlockId, property: StringPropertyName, value: string): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `value` - The value to set.
@@ -3615,7 +3453,6 @@ setString(id: DesignBlockId, property: StringPropertyName, value: string): void
 ### getString()
 
 Gets a string property from a block.
-
 ```javascript
 engine.block.getString(text, 'text/text');
 engine.block.getString(imageFill, 'fill/image/imageFileURI');
@@ -3626,7 +3463,6 @@ getString(id: DesignBlockId, property: StringPropertyName): string
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
@@ -3635,15 +3471,9 @@ getString(id: DesignBlockId, property: StringPropertyName): string
 ### setColor()
 
 Sets a color property on a block.
-
 ```javascript
 // Set the block's fill color to white.
-engine.block.setColor(colorFill, 'fill/color/value', {
-  r: 1,
-  g: 1,
-  b: 1,
-  a: 1
-});
+engine.block.setColor(colorFill, 'fill/color/value', { r: 1, g: 1, b: 1, a: 1 });
 ```
 
 ```typescript
@@ -3651,7 +3481,6 @@ setColor(id: DesignBlockId, property: ColorPropertyName, value: Color): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `value` - The value to set.
@@ -3659,7 +3488,6 @@ setColor(id: DesignBlockId, property: ColorPropertyName, value: Color): void
 ### getColor()
 
 Gets a color property from a block.
-
 ```javascript
 engine.block.getColor(colorFill, 'fill/color/value');
 ```
@@ -3669,13 +3497,12 @@ getColor(id: DesignBlockId, property: ColorPropertyName): Color
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
 **Returns:** The value of the property.
 
-### setColorRGBA() _(deprecated)_
+### setColorRGBA() *(deprecated)*
 
 Sets a color property on a block using RGBA values.
 
@@ -3684,7 +3511,6 @@ setColorRGBA(id: DesignBlockId, property: string, r: number, g: number, b: numbe
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `r` - The red color component in the range of 0 to 1.
@@ -3692,7 +3518,7 @@ setColorRGBA(id: DesignBlockId, property: string, r: number, g: number, b: numbe
 - `b` - The blue color component in the range of 0 to 1.
 - `a` - The alpha color component in the range of 0 to 1. Defaults to 1.
 
-### getColorRGBA() _(deprecated)_
+### getColorRGBA() *(deprecated)*
 
 Gets a color property from a block as RGBA values.
 
@@ -3701,13 +3527,12 @@ getColorRGBA(id: DesignBlockId, property: string): RGBA
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
 **Returns:** A tuple of channels red, green, blue and alpha in the range of 0 to 1.
 
-### setColorSpot() _(deprecated)_
+### setColorSpot() *(deprecated)*
 
 Sets a spot color property on a block.
 
@@ -3716,13 +3541,12 @@ setColorSpot(id: DesignBlockId, property: string, name: string, tint?: number):
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `name` - The name of the spot color.
 - `tint` - The tint factor in the range of 0 to 1. Defaults to 1.
 
-### getColorSpotName() _(deprecated)_
+### getColorSpotName() *(deprecated)*
 
 Gets the spot color name from a color property.
 
@@ -3731,13 +3555,12 @@ getColorSpotName(id: DesignBlockId, property: string): string
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
 **Returns:** The name of the spot color.
 
-### getColorSpotTint() _(deprecated)_
+### getColorSpotTint() *(deprecated)*
 
 Gets the spot color tint from a color property.
 
@@ -3746,7 +3569,6 @@ getColorSpotTint(id: DesignBlockId, property: string): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
@@ -3755,7 +3577,6 @@ getColorSpotTint(id: DesignBlockId, property: string): number
 ### setEnum<T extends keyof BlockEnumType>()
 
 Sets an enum property on a block.
-
 ```javascript
 engine.block.setEnum(text, 'text/horizontalAlignment', 'Center');
 engine.block.setEnum(text, 'text/verticalAlignment', 'Center');
@@ -3766,7 +3587,6 @@ setEnum<T extends keyof BlockEnumType>(id: DesignBlockId, property: T, value: Bl
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be set.
 - `property` - The name of the property to set.
 - `value` - The enum value as a string.
@@ -3774,7 +3594,6 @@ setEnum<T extends keyof BlockEnumType>(id: DesignBlockId, property: T, value: Bl
 ### getEnum<T extends keyof BlockEnumType>()
 
 Gets an enum property from a block.
-
 ```javascript
 engine.block.getEnum(text, 'text/horizontalAlignment');
 engine.block.getEnum(text, 'text/verticalAlignment');
@@ -3785,7 +3604,6 @@ getEnum<T extends keyof BlockEnumType>(id: DesignBlockId, property: T): BlockEnu
 ```
 
 **Parameters:**
-
 - `id` - The block whose property should be queried.
 - `property` - The name of the property to query.
 
@@ -3795,7 +3613,7 @@ getEnum<T extends keyof BlockEnumType>(id: DesignBlockId, property: T): BlockEnu
 
 Crop, scale, translate, and transform block content.
 
-### hasCrop() _(deprecated)_
+### hasCrop() *(deprecated)*
 
 Checks if a block has crop properties.
 
@@ -3804,7 +3622,6 @@ hasCrop(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block has crop properties.
@@ -3812,7 +3629,6 @@ hasCrop(id: DesignBlockId): boolean
 ### supportsCrop()
 
 Checks if a block supports cropping.
-
 ```javascript
 engine.block.supportsCrop(image);
 ```
@@ -3822,7 +3638,6 @@ supportsCrop(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** true, if the block supports cropping.
@@ -3830,7 +3645,6 @@ supportsCrop(id: DesignBlockId): boolean
 ### setCropScaleX()
 
 Sets the horizontal crop scale of a block.
-
 ```javascript
 engine.block.setCropScaleX(image, 2.0);
 ```
@@ -3840,14 +3654,12 @@ setCropScaleX(id: DesignBlockId, scaleX: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be set.
 - `scaleX` - The scale in x direction.
 
 ### setCropScaleY()
 
 Sets the vertical crop scale of a block.
-
 ```javascript
 engine.block.setCropScaleY(image, 1.5);
 ```
@@ -3857,14 +3669,12 @@ setCropScaleY(id: DesignBlockId, scaleY: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be set.
 - `scaleY` - The scale in y direction.
 
 ### setCropRotation()
 
 Sets the crop rotation of a block in radians.
-
 ```javascript
 engine.block.setCropRotation(image, Math.PI);
 ```
@@ -3874,7 +3684,6 @@ setCropRotation(id: DesignBlockId, rotation: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be set.
 - `rotation` - The rotation in radians.
 
@@ -3882,7 +3691,6 @@ setCropRotation(id: DesignBlockId, rotation: number): void
 
 Sets the uniform crop scale ratio of a block.
 This scales the content up or down from the center of the crop frame.
-
 ```javascript
 engine.block.setCropScaleRatio(image, 3.0);
 ```
@@ -3892,14 +3700,12 @@ setCropScaleRatio(id: DesignBlockId, scaleRatio: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be set.
 - `scaleRatio` - The crop scale ratio.
 
 ### setCropTranslationX()
 
 Sets the horizontal crop translation of a block in percentage of the crop frame width.
-
 ```javascript
 engine.block.setCropTranslationX(image, -1.0);
 ```
@@ -3909,14 +3715,12 @@ setCropTranslationX(id: DesignBlockId, translationX: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be set.
 - `translationX` - The translation in x direction.
 
 ### setCropTranslationY()
 
 Sets the vertical crop translation of a block in percentage of the crop frame height.
-
 ```javascript
 engine.block.setCropTranslationY(image, 1.0);
 ```
@@ -3926,7 +3730,6 @@ setCropTranslationY(id: DesignBlockId, translationY: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be set.
 - `translationY` - The translation in y direction.
 
@@ -3934,7 +3737,6 @@ setCropTranslationY(id: DesignBlockId, translationY: number): void
 
 Resets the crop of a block to its default state.
 The block's content fill mode is set to 'Cover'.
-
 ```javascript
 engine.block.resetCrop(image);
 ```
@@ -3944,13 +3746,11 @@ resetCrop(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be reset.
 
 ### getCropScaleX()
 
 Gets the horizontal crop scale of a block.
-
 ```javascript
 const scaleX = engine.block.getCropScaleX(image);
 ```
@@ -3960,7 +3760,6 @@ getCropScaleX(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose scale should be queried.
 
 **Returns:** The scale on the x axis.
@@ -3968,7 +3767,6 @@ getCropScaleX(id: DesignBlockId): number
 ### getCropScaleY()
 
 Gets the vertical crop scale of a block.
-
 ```javascript
 const scaleY = engine.block.getCropScaleY(image);
 ```
@@ -3978,7 +3776,6 @@ getCropScaleY(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose scale should be queried.
 
 **Returns:** The scale on the y axis.
@@ -3986,7 +3783,6 @@ getCropScaleY(id: DesignBlockId): number
 ### getCropRotation()
 
 Gets the crop rotation of a block in radians.
-
 ```javascript
 const cropRotation = engine.block.getCropRotation(image);
 ```
@@ -3996,7 +3792,6 @@ getCropRotation(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop rotation should be queried.
 
 **Returns:** The crop rotation in radians.
@@ -4004,7 +3799,6 @@ getCropRotation(id: DesignBlockId): number
 ### getCropScaleRatio()
 
 Gets the uniform crop scale ratio of a block.
-
 ```javascript
 const cropScaleRatio = engine.block.getCropScaleRatio(image);
 ```
@@ -4014,7 +3808,6 @@ getCropScaleRatio(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop scale ratio should be queried.
 
 **Returns:** The crop scale ratio.
@@ -4022,7 +3815,6 @@ getCropScaleRatio(id: DesignBlockId): number
 ### getCropTranslationX()
 
 Gets the horizontal crop translation of a block in percentage of the crop frame width.
-
 ```javascript
 const cropTranslationX = engine.block.getCropTranslationX(image);
 ```
@@ -4032,7 +3824,6 @@ getCropTranslationX(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose translation should be queried.
 
 **Returns:** The translation on the x axis.
@@ -4040,7 +3831,6 @@ getCropTranslationX(id: DesignBlockId): number
 ### getCropTranslationY()
 
 Gets the vertical crop translation of a block in percentage of the crop frame height.
-
 ```javascript
 const cropTranslationY = engine.block.getCropTranslationY(image);
 ```
@@ -4050,7 +3840,6 @@ getCropTranslationY(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose translation should be queried.
 
 **Returns:** The translation on the y axis.
@@ -4058,7 +3847,6 @@ getCropTranslationY(id: DesignBlockId): number
 ### adjustCropToFillFrame()
 
 Adjusts the crop position and scale of the given image block to fill its crop frame, while maintaining the position and size of the crop frame.
-
 ```javascript
 const adjustedScaleRatio = engine.block.adjustCropToFillFrame(image, 1.0);
 ```
@@ -4068,7 +3856,6 @@ adjustCropToFillFrame(id: DesignBlockId, minScaleRatio: number): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be adjusted.
 - `minScaleRatio` - The minimal crop scale ratio to use.
 
@@ -4077,7 +3864,6 @@ adjustCropToFillFrame(id: DesignBlockId, minScaleRatio: number): number
 ### flipCropHorizontal()
 
 Flips the content horizontally within its crop frame.
-
 ```javascript
 engine.block.flipCropHorizontal(image);
 ```
@@ -4087,13 +3873,11 @@ flipCropHorizontal(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be updated.
 
 ### flipCropVertical()
 
 Flips the content vertically within its crop frame.
-
 ```javascript
 engine.block.flipCropVertical(image);
 ```
@@ -4103,14 +3887,12 @@ flipCropVertical(id: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose crop should be updated.
 
 ### isCropAspectRatioLocked()
 
 Checks if the crop aspect ratio is locked for a block.
 When locked, crop handles will maintain the current aspect ratio during resize.
-
 ```javascript
 const isLocked = engine.block.isCropAspectRatioLocked(block);
 ```
@@ -4120,7 +3902,6 @@ isCropAspectRatioLocked(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True if aspect ratio is locked, false otherwise.
@@ -4130,7 +3911,6 @@ isCropAspectRatioLocked(id: DesignBlockId): boolean
 Sets whether the crop aspect ratio should be locked for a block.
 When enabled, crop handles will maintain the current aspect ratio.
 When disabled, free resizing is allowed.
-
 ```javascript
 engine.block.setCropAspectRatioLocked(block, true);
 ```
@@ -4140,10 +3920,31 @@ setCropAspectRatioLocked(id: DesignBlockId, locked: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `locked` - Whether aspect ratio should be locked.
 
+### canRevertToOriginalRatio()
+
+Checks whether the "Original" crop preset (`ContentAspectRatio`) can be applied to a block.
+This runs the same preliminary check the apply path performs: it resolves the intrinsic
+content dimensions from the block's image/video fill (an image fill resolves only from its
+`sourceSet`; a video fill resolves from its `sourceSet` or the first decoded frame). Use it
+to gate UI that would otherwise call the preset and fail — e.g. an unreplaced placeholder
+image fill with an empty `sourceSet`.
+```javascript
+const canRevert = engine.block.canRevertToOriginalRatio(block);
+```
+
+```typescript
+canRevertToOriginalRatio(id: DesignBlockId): boolean
+```
+
+**Parameters:**
+- `id` - The block to query.
+
+**Returns:** True if the preset would resolve, false if it cannot (no/placeholder fill, empty
+sourceSet, video not yet decoded, or unsupported fill type).
+
 ## Block Effects
 
 Create, manage, and apply various visual effects to blocks.
@@ -4157,12 +3958,11 @@ createEffect(type: EffectType): DesignBlockId
 ```
 
 **Parameters:**
-
 - `type` - The type of the effect.
 
 **Returns:** The created effect's handle.
 
-### hasEffects() _(deprecated)_
+### hasEffects() *(deprecated)*
 
 Checks if a block supports effects.
 
@@ -4171,7 +3971,6 @@ hasEffects(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block can render effects, false otherwise.
@@ -4185,7 +3984,6 @@ supportsEffects(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block can render effects, false otherwise.
@@ -4199,7 +3997,6 @@ getEffects(id: DesignBlockId): DesignBlockId[]
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** A list of effects or an error, if the block doesn't support effects.
@@ -4213,7 +4010,6 @@ insertEffect(id: DesignBlockId, effectId: DesignBlockId, index: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `effectId` - The effect to insert.
 - `index` - The index at which the effect shall be inserted.
@@ -4227,7 +4023,6 @@ appendEffect(id: DesignBlockId, effectId: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block to append the effect to.
 - `effectId` - The effect to append.
 
@@ -4240,11 +4035,10 @@ removeEffect(id: DesignBlockId, index: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block to remove the effect from.
 - `index` - The index where the effect is stored.
 
-### hasEffectEnabled() _(deprecated)_
+### hasEffectEnabled() *(deprecated)*
 
 Checks if an effect block can be enabled or disabled.
 
@@ -4253,7 +4047,6 @@ hasEffectEnabled(effectId: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `effectId` - The 'effect' block to query.
 
 **Returns:** True, if the block supports enabling and disabling, false otherwise.
@@ -4261,7 +4054,6 @@ hasEffectEnabled(effectId: DesignBlockId): boolean
 ### setEffectEnabled()
 
 Sets the enabled state of an effect block.
-
 ```javascript
 engine.block.setEffectEnabled(effects[0], false);
 ```
@@ -4271,14 +4063,12 @@ setEffectEnabled(effectId: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `effectId` - The 'effect' block to update.
 - `enabled` - The new state.
 
 ### isEffectEnabled()
 
 Queries if an effect block is enabled.
-
 ```javascript
 engine.block.isEffectEnabled(effects[0]);
 ```
@@ -4288,7 +4078,6 @@ isEffectEnabled(effectId: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `effectId` - The 'effect' block to query.
 
 **Returns:** True, if the effect is enabled. False otherwise.
@@ -4306,12 +4095,11 @@ createBlur(type: BlurType): DesignBlockId
 ```
 
 **Parameters:**
-
 - `type` - The type of blur.
 
 **Returns:** The handle of the newly created blur.
 
-### hasBlur() _(deprecated)_
+### hasBlur() *(deprecated)*
 
 Checks if a block supports blur.
 
@@ -4320,7 +4108,6 @@ hasBlur(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block supports blur.
@@ -4334,7 +4121,6 @@ supportsBlur(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block supports blur.
@@ -4348,7 +4134,6 @@ setBlur(id: DesignBlockId, blurId: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `blurId` - A 'blur' block to apply.
 
@@ -4361,7 +4146,6 @@ getBlur(id: DesignBlockId): DesignBlockId
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** The 'blur' block.
@@ -4369,7 +4153,6 @@ getBlur(id: DesignBlockId): DesignBlockId
 ### setBlurEnabled()
 
 Enables or disables the blur effect on a block.
-
 ```javascript
 engine.block.setBlurEnabled(block, true);
 ```
@@ -4379,14 +4162,12 @@ setBlurEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block to update.
 - `enabled` - The new enabled value.
 
 ### isBlurEnabled()
 
 Checks if blur is enabled for a block.
-
 ```javascript
 const isBlurEnabled = engine.block.isBlurEnabled(block);
 ```
@@ -4396,7 +4177,6 @@ isBlurEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the blur is enabled. False otherwise.
@@ -4405,7 +4185,7 @@ isBlurEnabled(id: DesignBlockId): boolean
 
 Control stroke appearance, including color, width, style, and position.
 
-### hasStroke() _(deprecated)_
+### hasStroke() *(deprecated)*
 
 Checks if a block has a stroke property.
 
@@ -4414,7 +4194,6 @@ hasStroke(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True if the block has a stroke property.
@@ -4428,7 +4207,6 @@ supportsStroke(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True if the block supports a stroke.
@@ -4436,7 +4214,6 @@ supportsStroke(id: DesignBlockId): boolean
 ### setStrokeEnabled()
 
 Enables or disables the stroke of a block.
-
 ```javascript
 engine.block.setStrokeEnabled(block, true);
 ```
@@ -4446,14 +4223,12 @@ setStrokeEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke should be enabled or disabled.
 - `enabled` - If true, the stroke will be enabled.
 
 ### isStrokeEnabled()
 
 Checks if the stroke of a block is enabled.
-
 ```javascript
 const strokeIsEnabled = engine.block.isStrokeEnabled(block);
 ```
@@ -4463,12 +4238,45 @@ isStrokeEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke state should be queried.
 
 **Returns:** True if the block's stroke is enabled.
 
-### setStrokeColorRGBA() _(deprecated)_
+### setStrokeOverprint()
+
+Marks the stroke of a block as overprint for PDF export.
+The flag is only honored by the PDF writer when the stroke uses a spot color
+(Separation/DeviceN). For process-color strokes it is a silent no-op. On-screen
+rendering ignores the flag.
+```javascript
+engine.block.setStrokeOverprint(block, true);
+```
+
+```typescript
+setStrokeOverprint(id: DesignBlockId, overprint: boolean): void
+```
+
+**Parameters:**
+- `id` - The block whose stroke overprint flag should be set.
+- `overprint` - If true, the stroke is marked as overprint in exported PDFs.
+
+### getStrokeOverprint()
+
+Queries whether the stroke of a block is marked as overprint for PDF export.
+```javascript
+const overprint = engine.block.getStrokeOverprint(block);
+```
+
+```typescript
+getStrokeOverprint(id: DesignBlockId): boolean
+```
+
+**Parameters:**
+- `id` - The block whose stroke overprint flag should be queried.
+
+**Returns:** The stroke overprint flag.
+
+### setStrokeColorRGBA() *(deprecated)*
 
 Sets the stroke color of a block using RGBA values.
 
@@ -4477,7 +4285,6 @@ setStrokeColorRGBA(id: DesignBlockId, r: number, g: number, b: number, a?: numbe
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke color should be set.
 - `r` - The red color component in the range of 0 to 1.
 - `g` - The green color component in the range of 0 to 1.
@@ -4493,11 +4300,10 @@ setStrokeColor(id: DesignBlockId, color: Color): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke color should be set.
 - `color` - The color to set.
 
-### getStrokeColorRGBA() _(deprecated)_
+### getStrokeColorRGBA() *(deprecated)*
 
 Gets the stroke color of a block as RGBA values.
 
@@ -4506,7 +4312,6 @@ getStrokeColorRGBA(id: DesignBlockId): RGBA
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke color should be queried.
 
 **Returns:** The stroke color.
@@ -4520,7 +4325,6 @@ getStrokeColor(id: DesignBlockId): Color
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke color should be queried.
 
 **Returns:** The stroke color.
@@ -4534,7 +4338,6 @@ setStrokeWidth(id: DesignBlockId, width: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke width should be set.
 - `width` - The stroke width to be set.
 
@@ -4547,7 +4350,6 @@ getStrokeWidth(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke width should be queried.
 
 **Returns:** The stroke's width.
@@ -4561,7 +4363,6 @@ setStrokeStyle(id: DesignBlockId, style: StrokeStyle): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke style should be set.
 - `style` - The stroke style to be set.
 
@@ -4574,7 +4375,6 @@ getStrokeStyle(id: DesignBlockId): StrokeStyle
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke style should be queried.
 
 **Returns:** The stroke's style.
@@ -4588,7 +4388,6 @@ setStrokePosition(id: DesignBlockId, position: StrokePosition): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke position should be set.
 - `position` - The stroke position to be set.
 
@@ -4601,7 +4400,6 @@ getStrokePosition(id: DesignBlockId): StrokePosition
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke position should be queried.
 
 **Returns:** The stroke position.
@@ -4615,7 +4413,6 @@ setStrokeCornerGeometry(id: DesignBlockId, cornerGeometry: StrokeCornerGeometry)
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke corner geometry should be set.
 - `cornerGeometry` - The stroke corner geometry to be set.
 
@@ -4628,26 +4425,216 @@ getStrokeCornerGeometry(id: DesignBlockId): StrokeCornerGeometry
 ```
 
 **Parameters:**
-
 - `id` - The block whose stroke corner geometry should be queried.
 
 **Returns:** The stroke corner geometry.
 
-## Block Drop Shadow
+### setStrokeCap() *(deprecated)*
 
-Configure drop shadow effects, including blur, color, and offset.
+Sets the stroke cap of a block. Writes both the start and end caps to the
+same value.
 
-### hasDropShadow() _(deprecated)_
+```typescript
+setStrokeCap(id: DesignBlockId, cap: StrokeCap): void
+```
 
-Checks if a block has a drop shadow property.
+**Parameters:**
+- `id` - The block whose stroke cap should be set.
+- `cap` - The stroke cap to be set.
+
+### getStrokeCap() *(deprecated)*
+
+Gets the legacy single stroke cap of a block. Tracks the value last written
+via `setStrokeCap` or `setStrokeStartCap`; ignores changes made via
+`setStrokeEndCap`.
 
 ```typescript
-hasDropShadow(id: DesignBlockId): boolean
+getStrokeCap(id: DesignBlockId): StrokeCap
 ```
 
 **Parameters:**
+- `id` - The block whose stroke cap should be queried.
 
-- `id` - The block to query.
+**Returns:** The stroke cap.
+
+### setStrokeStartCap()
+
+Sets the cap geometry at the start of an open stroked path. Use this with
+`setStrokeEndCap` to set distinct caps for each end of a stroke (for
+example a flat start with an arrowhead end). `setStrokeCap` continues to
+set both ends at once and is preserved for backwards compatibility.
+
+```typescript
+setStrokeStartCap(id: DesignBlockId, cap: StrokeCap): void
+```
+
+**Parameters:**
+- `id` - The block whose stroke start cap should be set.
+- `cap` - The cap geometry to use at the path start.
+
+### getStrokeStartCap()
+
+Gets the cap geometry at the start of an open stroked path.
+
+```typescript
+getStrokeStartCap(id: DesignBlockId): StrokeCap
+```
+
+**Parameters:**
+- `id` - The block whose stroke start cap should be queried.
+
+**Returns:** The start cap.
+
+### setStrokeEndCap()
+
+Sets the cap geometry at the end of an open stroked path. Use this with
+`setStrokeStartCap` to set distinct caps for each end of a stroke.
+
+```typescript
+setStrokeEndCap(id: DesignBlockId, cap: StrokeCap): void
+```
+
+**Parameters:**
+- `id` - The block whose stroke end cap should be set.
+- `cap` - The cap geometry to use at the path end.
+
+### getStrokeEndCap()
+
+Gets the cap geometry at the end of an open stroked path.
+
+```typescript
+getStrokeEndCap(id: DesignBlockId): StrokeCap
+```
+
+**Parameters:**
+- `id` - The block whose stroke end cap should be queried.
+
+**Returns:** The end cap.
+
+### setStrokeDashStartCap()
+
+Sets the cap geometry at the leading edge of each dash piece (excluding the
+line's actual start). Only takes effect when a dash pattern is active.
+Distinct from `setStrokeStartCap`, which only applies to the start of the
+open path itself.
+
+```typescript
+setStrokeDashStartCap(id: DesignBlockId, cap: StrokeCap): void
+```
+
+**Parameters:**
+- `id` - The block whose dash start cap should be set.
+- `cap` - The cap geometry to use at the leading edge of each dash piece.
+
+### getStrokeDashStartCap()
+
+Gets the cap geometry at the leading edge of each dash piece.
+
+```typescript
+getStrokeDashStartCap(id: DesignBlockId): StrokeCap
+```
+
+**Parameters:**
+- `id` - The block whose dash start cap should be queried.
+
+**Returns:** The dash start cap.
+
+### setStrokeDashEndCap()
+
+Sets the cap geometry at the trailing edge of each dash piece (excluding the
+line's actual end). Only takes effect when a dash pattern is active. Distinct
+from `setStrokeEndCap`, which only applies to the end of the open path itself.
+
+```typescript
+setStrokeDashEndCap(id: DesignBlockId, cap: StrokeCap): void
+```
+
+**Parameters:**
+- `id` - The block whose dash end cap should be set.
+- `cap` - The cap geometry to use at the trailing edge of each dash piece.
+
+### getStrokeDashEndCap()
+
+Gets the cap geometry at the trailing edge of each dash piece.
+
+```typescript
+getStrokeDashEndCap(id: DesignBlockId): StrokeCap
+```
+
+**Parameters:**
+- `id` - The block whose dash end cap should be queried.
+
+**Returns:** The dash end cap.
+
+### setStrokeDashArray()
+
+Sets a custom dash pattern for the block's stroke. Semantics match SVG's
+`stroke-dasharray`: alternating on/off lengths in design-unit space. When the
+pattern is non-empty it overrides the preset implied by `StrokeStyle`. Pass an
+empty array to fall back to the preset.
+
+```typescript
+setStrokeDashArray(id: DesignBlockId, dashArray: number[]): void
+```
+
+**Parameters:**
+- `id` - The block whose stroke dash pattern should be set.
+- `dashArray` - Alternating on/off lengths. Odd-length arrays are doubled to
+  an even length, matching SVG behaviour.
+
+### getStrokeDashArray()
+
+Gets the custom dash pattern of the block's stroke.
+
+```typescript
+getStrokeDashArray(id: DesignBlockId): number[]
+```
+
+**Parameters:**
+- `id` - The block whose stroke dash pattern should be queried.
+
+**Returns:** The dash pattern, or an empty array if no custom pattern is set.
+
+### setStrokeDashOffset()
+
+Sets the dash offset of the block's stroke. Semantics match SVG's
+`stroke-dashoffset`. Ignored when the custom dash pattern is empty.
+
+```typescript
+setStrokeDashOffset(id: DesignBlockId, dashOffset: number): void
+```
+
+**Parameters:**
+- `id` - The block whose stroke dash offset should be set.
+- `dashOffset` - The dash offset in design-unit space.
+
+### getStrokeDashOffset()
+
+Gets the dash offset of the block's stroke.
+
+```typescript
+getStrokeDashOffset(id: DesignBlockId): number
+```
+
+**Parameters:**
+- `id` - The block whose stroke dash offset should be queried.
+
+**Returns:** The dash offset.
+
+## Block Drop Shadow
+
+Configure drop shadow effects, including blur, color, and offset.
+
+### hasDropShadow() *(deprecated)*
+
+Checks if a block has a drop shadow property.
+
+```typescript
+hasDropShadow(id: DesignBlockId): boolean
+```
+
+**Parameters:**
+- `id` - The block to query.
 
 **Returns:** True if the block has a drop shadow property.
 
@@ -4660,7 +4647,6 @@ supportsDropShadow(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True if the block supports a drop shadow.
@@ -4668,7 +4654,6 @@ supportsDropShadow(id: DesignBlockId): boolean
 ### setDropShadowEnabled()
 
 Enables or disables the drop shadow of a block.
-
 ```javascript
 engine.block.setDropShadowEnabled(block, true);
 ```
@@ -4678,14 +4663,12 @@ setDropShadowEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow should be enabled or disabled.
 - `enabled` - If true, the drop shadow will be enabled.
 
 ### isDropShadowEnabled()
 
 Checks if the drop shadow of a block is enabled.
-
 ```javascript
 const dropShadowIsEnabled = engine.block.isDropShadowEnabled(block);
 ```
@@ -4695,12 +4678,11 @@ isDropShadowEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow state should be queried.
 
 **Returns:** True if the block's drop shadow is enabled.
 
-### setDropShadowColorRGBA() _(deprecated)_
+### setDropShadowColorRGBA() *(deprecated)*
 
 Sets the drop shadow color of a block using RGBA values.
 
@@ -4709,7 +4691,6 @@ setDropShadowColorRGBA(id: DesignBlockId, r: number, g: number, b: number, a?: n
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow color should be set.
 - `r` - The red color component in the range of 0 to 1.
 - `g` - The green color component in the range of 0 to 1.
@@ -4725,11 +4706,10 @@ setDropShadowColor(id: DesignBlockId, color: Color): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow color should be set.
 - `color` - The color to set.
 
-### getDropShadowColorRGBA() _(deprecated)_
+### getDropShadowColorRGBA() *(deprecated)*
 
 Gets the drop shadow color of a block as RGBA values.
 
@@ -4738,7 +4718,6 @@ getDropShadowColorRGBA(id: DesignBlockId): RGBA
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow color should be queried.
 
 **Returns:** The drop shadow color.
@@ -4752,7 +4731,6 @@ getDropShadowColor(id: DesignBlockId): Color
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow color should be queried.
 
 **Returns:** The drop shadow color.
@@ -4766,7 +4744,6 @@ setDropShadowOffsetX(id: DesignBlockId, offsetX: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's X offset should be set.
 - `offsetX` - The X offset to be set.
 
@@ -4779,7 +4756,6 @@ getDropShadowOffsetX(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's X offset should be queried.
 
 **Returns:** The offset.
@@ -4793,7 +4769,6 @@ setDropShadowOffsetY(id: DesignBlockId, offsetY: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's Y offset should be set.
 - `offsetY` - The Y offset to be set.
 
@@ -4806,7 +4781,6 @@ getDropShadowOffsetY(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's Y offset should be queried.
 
 **Returns:** The offset.
@@ -4820,7 +4794,6 @@ setDropShadowBlurRadiusX(id: DesignBlockId, blurRadiusX: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's blur radius should be set.
 - `blurRadiusX` - The blur radius to be set.
 
@@ -4833,7 +4806,6 @@ getDropShadowBlurRadiusX(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's blur radius should be queried.
 
 **Returns:** The blur radius.
@@ -4847,7 +4819,6 @@ setDropShadowBlurRadiusY(id: DesignBlockId, blurRadiusY: number): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's blur radius should be set.
 - `blurRadiusY` - The blur radius to be set.
 
@@ -4860,7 +4831,6 @@ getDropShadowBlurRadiusY(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's blur radius should be queried.
 
 **Returns:** The blur radius.
@@ -4875,7 +4845,6 @@ setDropShadowClip(id: DesignBlockId, clip: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's clip should be set.
 - `clip` - The drop shadow's clip to be set.
 
@@ -4888,7 +4857,6 @@ getDropShadowClip(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose drop shadow's clipping should be queried.
 
 **Returns:** The drop shadow's clipping state.
@@ -4907,7 +4875,6 @@ createCutoutFromBlocks(ids: DesignBlockId[], vectorizeDistanceThreshold?: number
 ```
 
 **Parameters:**
-
 - `ids` - The blocks whose shape will serve as the basis for the cutout's path.
 - `vectorizeDistanceThreshold` - Max deviation from the original contour during vectorization.
 - `simplifyDistanceThreshold` - Max deviation for path simplification. 0 disables simplification.
@@ -4924,7 +4891,6 @@ createCutoutFromPath(path: string): DesignBlockId
 ```
 
 **Parameters:**
-
 - `path` - An SVG string describing a path.
 
 **Returns:** The newly created block or an error.
@@ -4938,7 +4904,6 @@ createCutoutFromOperation(ids: DesignBlockId[], op: CutoutOperation): DesignBloc
 ```
 
 **Parameters:**
-
 - `ids` - The cutout blocks with which to perform to the operation.
 - `op` - The boolean operation to perform.
 
@@ -4951,7 +4916,6 @@ Create, edit, and style text content.
 ### replaceText()
 
 Replaces a range of text in a text block.
-
 ```javascript
 engine.block.replaceText(text, 'Hello World');
 engine.block.replaceText(text, 'Alex', 6, 11);
@@ -4962,7 +4926,6 @@ replaceText(id: DesignBlockId, text: string, from?: number, to?: number): void
 ```
 
 **Parameters:**
-
 - `id` - The text block into which to insert the given text.
 - `text` - The text which should replace the selected range in the block.
 - `from` - The start index of the UTF-16 range to replace. Defaults to the start of the current selection or text.
@@ -4971,7 +4934,6 @@ replaceText(id: DesignBlockId, text: string, from?: number, to?: number): void
 ### removeText()
 
 Removes a range of text from a text block.
-
 ```javascript
 engine.block.removeText(text, 0, 6);
 ```
@@ -4981,7 +4943,6 @@ removeText(id: DesignBlockId, from?: number, to?: number): void
 ```
 
 **Parameters:**
-
 - `id` - The text block from which the selected text should be removed.
 - `from` - The start index of the UTF-16 range to remove. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range to remove. Defaults to the end of the current selection or text.
@@ -4989,7 +4950,6 @@ removeText(id: DesignBlockId, from?: number, to?: number): void
 ### setTextColor()
 
 Sets the color for a range of text.
-
 ```javascript
 engine.block.setTextColor(text, { r: 0.0, g: 0.0, b: 0.0, a: 1.0 }, 1, 4);
 ```
@@ -4999,7 +4959,6 @@ setTextColor(id: DesignBlockId, color: Color, from?: number, to?: number): void
 ```
 
 **Parameters:**
-
 - `id` - The text block whose color should be changed.
 - `color` - The new color of the selected text range.
 - `from` - The start index of the UTF-16 range to change. Defaults to the start of the current selection or text.
@@ -5008,7 +4967,6 @@ setTextColor(id: DesignBlockId, color: Color, from?: number, to?: number): void
 ### getTextColors()
 
 Gets the unique colors within a range of text.
-
 ```javascript
 const colorsInRange = engine.block.getTextColors(text, 2, 5);
 ```
@@ -5018,7 +4976,6 @@ getTextColors(id: DesignBlockId, from?: number, to?: number): Array<Color>
 ```
 
 **Parameters:**
-
 - `id` - The text block whose colors should be returned.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5028,7 +4985,6 @@ getTextColors(id: DesignBlockId, from?: number, to?: number): Array<Color>
 ### setTextFontWeight()
 
 Sets the font weight for a range of text.
-
 ```javascript
 engine.block.setTextFontWeight(text, 'bold', 0, 5);
 ```
@@ -5038,7 +4994,6 @@ setTextFontWeight(id: DesignBlockId, fontWeight: FontWeight, from?: number, to?:
 ```
 
 **Parameters:**
-
 - `id` - The text block whose weight should be changed.
 - `fontWeight` - The new weight of the selected text range.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
@@ -5047,7 +5002,6 @@ setTextFontWeight(id: DesignBlockId, fontWeight: FontWeight, from?: number, to?:
 ### getTextFontWeights()
 
 Gets the unique font weights within a range of text.
-
 ```javascript
 const fontWeights = engine.block.getTextFontWeights(text, 0, 6);
 ```
@@ -5057,7 +5011,6 @@ getTextFontWeights(id: DesignBlockId, from?: number, to?: number): FontWeight[]
 ```
 
 **Parameters:**
-
 - `id` - The text block whose font weights should be returned.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5067,7 +5020,6 @@ getTextFontWeights(id: DesignBlockId, from?: number, to?: number): FontWeight[]
 ### setTextFontSize()
 
 Sets the font size for a range of text.
-
 ```javascript
 // With numeric fontSize (in points)
 engine.block.setTextFontSize(text, 12, 0, 5);
@@ -5081,7 +5033,6 @@ setTextFontSize(id: DesignBlockId, fontSize: number, options?: TextFontSizeOptio
 ```
 
 **Parameters:**
-
 - `id` - The text block whose font size should be changed.
 - `fontSize` - The new font size value.
 - `options` - An options object with unit, from, and to properties.
@@ -5089,7 +5040,6 @@ setTextFontSize(id: DesignBlockId, fontSize: number, options?: TextFontSizeOptio
 ### getTextFontSizes()
 
 Gets the unique font sizes within a range of text.
-
 ```javascript
 // Get all font sizes
 const fontSizes = engine.block.getTextFontSizes(text);
@@ -5097,11 +5047,7 @@ const fontSizes = engine.block.getTextFontSizes(text);
 const fontSizes = engine.block.getTextFontSizes(text, 0, 10);
 // With options object
 const sizesInPx = engine.block.getTextFontSizes(text, { unit: 'Pixel' });
-const sizesInRange = engine.block.getTextFontSizes(text, {
-  unit: 'Millimeter',
-  from: 5,
-  to: 15
-});
+const sizesInRange = engine.block.getTextFontSizes(text, { unit: 'Millimeter', from: 5, to: 15 });
 ```
 
 ```typescript
@@ -5109,7 +5055,6 @@ getTextFontSizes(id: DesignBlockId, options?: TextFontSizeOptions): number[]
 ```
 
 **Parameters:**
-
 - `id` - The text block whose font sizes should be returned.
 - `options` - An options object with unit, from, and to properties.
 
@@ -5118,7 +5063,6 @@ getTextFontSizes(id: DesignBlockId, options?: TextFontSizeOptions): number[]
 ### setTextFontStyle()
 
 Sets the font style for a range of text.
-
 ```javascript
 engine.block.setTextFontStyle(text, 'italic', 0, 5);
 ```
@@ -5128,7 +5072,6 @@ setTextFontStyle(id: DesignBlockId, fontStyle: FontStyle, from?: number, to?: nu
 ```
 
 **Parameters:**
-
 - `id` - The text block whose style should be changed.
 - `fontStyle` - The new style of the selected text range.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
@@ -5137,7 +5080,6 @@ setTextFontStyle(id: DesignBlockId, fontStyle: FontStyle, from?: number, to?: nu
 ### getTextFontStyles()
 
 Gets the unique font styles within a range of text.
-
 ```javascript
 const fontStyles = engine.block.getTextFontStyles(text);
 ```
@@ -5147,7 +5089,6 @@ getTextFontStyles(id: DesignBlockId, from?: number, to?: number): FontStyle[]
 ```
 
 **Parameters:**
-
 - `id` - The text block whose font styles should be returned.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5157,7 +5098,6 @@ getTextFontStyles(id: DesignBlockId, from?: number, to?: number): FontStyle[]
 ### getTextCases()
 
 Gets the unique text cases within a range of text.
-
 ```javascript
 const textCases = engine.block.getTextCases(text);
 ```
@@ -5167,7 +5107,6 @@ getTextCases(id: DesignBlockId, from?: number, to?: number): TextCase[]
 ```
 
 **Parameters:**
-
 - `id` - The text block whose text cases should be returned.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5177,7 +5116,6 @@ getTextCases(id: DesignBlockId, from?: number, to?: number): TextCase[]
 ### setTextCase()
 
 Sets the text case for a range of text.
-
 ```javascript
 engine.block.setTextCase(text, 'Titlecase');
 ```
@@ -5187,7 +5125,6 @@ setTextCase(id: DesignBlockId, textCase: TextCase, from?: number, to?: number):
 ```
 
 **Parameters:**
-
 - `id` - The text block whose text case should be changed.
 - `textCase` - The new text case value.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
@@ -5198,7 +5135,6 @@ setTextCase(id: DesignBlockId, textCase: TextCase, from?: number, to?: number):
 Gets the unique text decoration configurations within a range of text.
 Each element of the returned array is a decoration configuration representing
 a unique combination of lines, style, color, and thickness found in the range.
-
 ```javascript
 const decorations = engine.block.getTextDecorations(text);
 // e.g., [{ lines: ['None'] }, { lines: ['Underline'], style: 'Dashed' }]
@@ -5209,7 +5145,6 @@ getTextDecorations(id: DesignBlockId, from?: number, to?: number): TextDecoratio
 ```
 
 **Parameters:**
-
 - `id` - The text block whose text decorations should be returned.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5221,18 +5156,10 @@ getTextDecorations(id: DesignBlockId, from?: number, to?: number): TextDecoratio
 Sets the text decoration for a range of text.
 The config specifies which decoration lines, style, underline color, thickness, and offset to apply.
 Use `{ lines: ['None'] }` to remove all decorations.
-
 ```javascript
 engine.block.setTextDecoration(text, { lines: ['Underline'] });
-engine.block.setTextDecoration(text, {
-  lines: ['Underline', 'Strikethrough'],
-  style: 'Dashed'
-});
-engine.block.setTextDecoration(text, {
-  lines: ['Overline'],
-  style: 'Wavy',
-  underlineThickness: 2.0
-});
+engine.block.setTextDecoration(text, { lines: ['Underline', 'Strikethrough'], style: 'Dashed' });
+engine.block.setTextDecoration(text, { lines: ['Overline'], style: 'Wavy', underlineThickness: 2.0 });
 engine.block.setTextDecoration(text, { lines: ['None'] }); // Remove decorations
 ```
 
@@ -5241,19 +5168,54 @@ setTextDecoration(id: DesignBlockId, config: TextDecorationConfig, from?: number
 ```
 
 **Parameters:**
-
 - `id` - The text block whose text decoration should be changed.
 - `config` - The decoration configuration to apply.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
 
+### setTextKerning()
+
+Sets kerning for a grapheme range.
+Applies an additional offset in em units on top of the font's built-in kern.
+`1.0` equals the run's font size, so the offset scales proportionally with text size.
+```javascript
+engine.block.setTextKerning(text, 0.1); // add 10% of font size as extra spacing
+engine.block.setTextKerning(text, -0.05, 0, 5); // tighten first 5 graphemes
+engine.block.setTextKerning(text, 0); // reset to no extra offset
+```
+
+```typescript
+setTextKerning(id: DesignBlockId, kerning: number, from?: number, to?: number): void
+```
+
+**Parameters:**
+- `id` - The text block to modify.
+- `kerning` - Additional kerning in em units (1.0 = one full em). Use 0 for no extra offset.
+- `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
+- `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
+
+### getTextKernings()
+
+Returns the unique kerning values across the grapheme range.
+```javascript
+const kernings = engine.block.getTextKernings(text); // e.g. [0] or [0.1, 0]
+```
+
+```typescript
+getTextKernings(id: DesignBlockId, from?: number, to?: number): number[]
+```
+
+**Parameters:**
+- `id` - The text block to query.
+- `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
+- `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
+
 ### toggleTextDecorationUnderline()
 
 Toggles the underline decoration for a text range.
 If any part of the range does not have underline, the entire range gets underline.
 If the entire range already has underline, it is removed.
 Other decoration lines (strikethrough, overline) on each text run are preserved.
-
 ```javascript
 engine.block.toggleTextDecorationUnderline(text);
 ```
@@ -5263,7 +5225,6 @@ toggleTextDecorationUnderline(id: DesignBlockId, from?: number, to?: number): vo
 ```
 
 **Parameters:**
-
 - `id` - The text block to modify.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5274,7 +5235,6 @@ Toggles the strikethrough decoration for a text range.
 If any part of the range does not have strikethrough, the entire range gets strikethrough.
 If the entire range already has strikethrough, it is removed.
 Other decoration lines (underline, overline) on each text run are preserved.
-
 ```javascript
 engine.block.toggleTextDecorationStrikethrough(text);
 ```
@@ -5284,7 +5244,6 @@ toggleTextDecorationStrikethrough(id: DesignBlockId, from?: number, to?: number)
 ```
 
 **Parameters:**
-
 - `id` - The text block to modify.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5295,7 +5254,6 @@ Toggles the overline decoration for a text range.
 If any part of the range does not have overline, the entire range gets overline.
 If the entire range already has overline, it is removed.
 Other decoration lines (underline, strikethrough) on each text run are preserved.
-
 ```javascript
 engine.block.toggleTextDecorationOverline(text);
 ```
@@ -5305,15 +5263,55 @@ toggleTextDecorationOverline(id: DesignBlockId, from?: number, to?: number): voi
 ```
 
 **Parameters:**
-
 - `id` - The text block to modify.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
 
+### getTextHorizontalAlignment()
+
+Gets the paragraph-level horizontal alignment override for a specific paragraph,
+or the block-level alignment.
+```javascript
+const alignment = engine.block.getTextHorizontalAlignment(text, 0);
+const blockAlignment = engine.block.getTextHorizontalAlignment(text); // paragraphIndex defaults to -1
+// e.g. 'Left' | 'Center' | 'Right' | 'Auto' | undefined
+```
+
+```typescript
+getTextHorizontalAlignment(id: DesignBlockId, paragraphIndex?: number): TextHorizontalAlignment | undefined
+```
+
+**Parameters:**
+- `id` - The text block to query.
+- `paragraphIndex` - The 0-based index of the paragraph to query.
+Negative values return the block-level `text/horizontalAlignment` setting.
+
+**Returns:** The paragraph override, `undefined` if no override is set,
+or the block-level alignment when `paragraphIndex < 0`.
+
+### setTextHorizontalAlignment()
+
+Sets the paragraph-level horizontal alignment override for one or all paragraphs.
+```javascript
+engine.block.setTextHorizontalAlignment(text, 'Center', 0);
+engine.block.setTextHorizontalAlignment(text, undefined, 0); // clear override
+engine.block.setTextHorizontalAlignment(text, 'Right'); // apply to all
+```
+
+```typescript
+setTextHorizontalAlignment(id: DesignBlockId, alignment: TextHorizontalAlignment | undefined, paragraphIndex?: number): void
+```
+
+**Parameters:**
+- `id` - The text block to modify.
+- `alignment` - The alignment to apply, or `undefined` to clear the paragraph override.
+- `paragraphIndex` - The 0-based index of the paragraph.
+Negative values clear all paragraph-level alignment overrides and, when `alignment` is provided,
+apply that alignment to the whole text block.
+
 ### getTextListStyle()
 
 Gets the list style for a specific paragraph of a text block.
-
 ```javascript
 const listStyle = engine.block.getTextListStyle(text, 0);
 ```
@@ -5323,7 +5321,6 @@ getTextListStyle(id: DesignBlockId, paragraphIndex: number): ListStyle
 ```
 
 **Parameters:**
-
 - `id` - The text block whose list style should be returned.
 - `paragraphIndex` - The 0-based index of the paragraph.
 
@@ -5332,7 +5329,6 @@ getTextListStyle(id: DesignBlockId, paragraphIndex: number): ListStyle
 ### setTextListStyle()
 
 Sets the list style for a specific paragraph or all paragraphs of a text block.
-
 ```javascript
 engine.block.setTextListStyle(text, 'Unordered');
 engine.block.setTextListStyle(text, 'Ordered', 0, 2);
@@ -5343,18 +5339,16 @@ setTextListStyle(id: DesignBlockId, listStyle: ListStyle, paragraphIndex?: numbe
 ```
 
 **Parameters:**
-
 - `id` - The text block whose list style should be changed.
 - `listStyle` - The list style to apply.
 - `paragraphIndex` - The 0-based index of the paragraph to modify. Negative values apply to all paragraphs.
 - `listLevel` - Optional list nesting level to set atomically with the list style (0 = outermost).
-  When omitted the existing list level of each paragraph is preserved.
-  Has no visual effect when listStyle is 'None'.
+                   When omitted the existing list level of each paragraph is preserved.
+                   Has no visual effect when listStyle is 'None'.
 
 ### getTextListLevel()
 
 Gets the list nesting level for a specific paragraph of a text block.
-
 ```javascript
 const listLevel = engine.block.getTextListLevel(text, 0);
 ```
@@ -5364,7 +5358,6 @@ getTextListLevel(id: DesignBlockId, paragraphIndex: number): number
 ```
 
 **Parameters:**
-
 - `id` - The text block whose list level should be returned.
 - `paragraphIndex` - The 0-based index of the paragraph.
 
@@ -5373,7 +5366,6 @@ getTextListLevel(id: DesignBlockId, paragraphIndex: number): number
 ### setTextListLevel()
 
 Sets the list nesting level for a specific paragraph or all paragraphs of a text block.
-
 ```javascript
 engine.block.setTextListLevel(text, 1);
 engine.block.setTextListLevel(text, 2, 0);
@@ -5384,7 +5376,6 @@ setTextListLevel(id: DesignBlockId, listLevel: number, paragraphIndex?: number):
 ```
 
 **Parameters:**
-
 - `id` - The text block whose list level should be changed.
 - `listLevel` - The list nesting level (0 = outermost).
 - `paragraphIndex` - The 0-based index of the paragraph to modify. Negative values apply to all paragraphs.
@@ -5392,10 +5383,15 @@ setTextListLevel(id: DesignBlockId, listLevel: number, paragraphIndex?: number):
 ### getTextParagraphIndices()
 
 Returns the 0-based paragraph indices that overlap the given UTF-16 range.
-
+The range is half-open (exclusive): `from` is inclusive, `to` is exclusive (one past the last
+code unit of interest). When `from === to` the range is a cursor position and the paragraph
+containing `from` is returned. This convention matches `getTextCursorRange`, so the values
+it returns can be passed directly without adjustment.
+Negative values for either parameter cause all paragraph indices to be returned.
 ```javascript
 const indices = engine.block.getTextParagraphIndices(text);
-const indices = engine.block.getTextParagraphIndices(text, 0, 5);
+const { from, to } = engine.block.getTextCursorRange();
+const indices = engine.block.getTextParagraphIndices(text, from, to);
 ```
 
 ```typescript
@@ -5403,18 +5399,52 @@ getTextParagraphIndices(id: DesignBlockId, from?: number, to?: number): number[]
 ```
 
 **Parameters:**
-
 - `id` - The text block to query.
-- `from` - The start index of the UTF-16 range. Negative values reference the entire text.
-- `to` - The end index of the UTF-16 range. Negative values reference the entire text.
+- `from` - The inclusive start UTF-16 index. Negative values reference the entire text.
+- `to` - The exclusive end UTF-16 index. Negative values reference the entire text.
 
 **Returns:** The paragraph indices overlapping the range.
 
+### setTextLineHeight()
+
+Sets the line height multiplier for a specific paragraph or all paragraphs of a text block.
+```javascript
+engine.block.setTextLineHeight(text, 1.5);
+engine.block.setTextLineHeight(text, 1.5, 0);
+engine.block.setTextLineHeight(text, null); // reset all paragraphs to block default
+```
+
+```typescript
+setTextLineHeight(id: DesignBlockId, lineHeight: number | null, paragraphIndex?: number): void
+```
+
+**Parameters:**
+- `id` - The text block to modify.
+- `lineHeight` - The line height multiplier, or `null` to reset to the block-level default.
+- `paragraphIndex` - The 0-based index of the paragraph to modify. Negative values apply to all paragraphs.
+
+### getTextLineHeight()
+
+Returns the line height multiplier for a specific paragraph of a text block.
+Returns the per-paragraph override if one is set, otherwise returns the block-level `lineHeight`.
+```javascript
+const lineHeight = engine.block.getTextLineHeight(text, 0);
+```
+
+```typescript
+getTextLineHeight(id: DesignBlockId, paragraphIndex: number): number
+```
+
+**Parameters:**
+- `id` - The text block to query.
+- `paragraphIndex` - The 0-based index of the paragraph.
+
+**Returns:** The line height multiplier for the paragraph.
+
 ### canToggleBoldFont()
 
 Checks if the bold font weight can be toggled for a range of text.
 Returns true if any part of the range is not bold and the bold font is available.
-
 ```javascript
 const canToggleBold = engine.block.canToggleBoldFont(text);
 ```
@@ -5424,7 +5454,6 @@ canToggleBoldFont(id: DesignBlockId, from?: number, to?: number): boolean
 ```
 
 **Parameters:**
-
 - `id` - The text block to check.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5435,7 +5464,6 @@ canToggleBoldFont(id: DesignBlockId, from?: number, to?: number): boolean
 
 Checks if the italic font style can be toggled for a range of text.
 Returns true if any part of the range is not italic and the italic font is available.
-
 ```javascript
 const canToggleItalic = engine.block.canToggleItalicFont(text);
 ```
@@ -5445,7 +5473,6 @@ canToggleItalicFont(id: DesignBlockId, from?: number, to?: number): boolean
 ```
 
 **Parameters:**
-
 - `id` - The text block to check.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5456,7 +5483,6 @@ canToggleItalicFont(id: DesignBlockId, from?: number, to?: number): boolean
 
 Toggles the font weight of a text range between bold and normal.
 If any part of the range is not bold, the entire range becomes bold. If the entire range is already bold, it becomes normal.
-
 ```javascript
 engine.block.toggleBoldFont(text);
 ```
@@ -5466,7 +5492,6 @@ toggleBoldFont(id: DesignBlockId, from?: number, to?: number): void
 ```
 
 **Parameters:**
-
 - `id` - The text block to modify.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5475,7 +5500,6 @@ toggleBoldFont(id: DesignBlockId, from?: number, to?: number): void
 
 Toggles the font style of a text range between italic and normal.
 If any part of the range is not italic, the entire range becomes italic. If the entire range is already italic, it becomes normal.
-
 ```javascript
 engine.block.toggleItalicFont(text);
 ```
@@ -5485,7 +5509,6 @@ toggleItalicFont(id: DesignBlockId, from?: number, to?: number): void
 ```
 
 **Parameters:**
-
 - `id` - The text block to modify.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
@@ -5494,7 +5517,6 @@ toggleItalicFont(id: DesignBlockId, from?: number, to?: number): void
 
 Sets the font and typeface for an entire text block.
 Existing formatting is reset.
-
 ```javascript
 engine.block.setFont(text, font.uri, typeface);
 ```
@@ -5504,7 +5526,6 @@ setFont(id: DesignBlockId, fontFileUri: string, typeface: Typeface): void
 ```
 
 **Parameters:**
-
 - `id` - The text block whose font should be changed.
 - `fontFileUri` - The URI of the new font file.
 - `typeface` - The typeface of the new font.
@@ -5513,7 +5534,6 @@ setFont(id: DesignBlockId, fontFileUri: string, typeface: Typeface): void
 
 Sets the typeface for a range of text.
 The current formatting is retained as much as possible.
-
 ```javascript
 engine.block.setTypeface(text, typeface, 2, 5);
 ```
@@ -5523,7 +5543,6 @@ setTypeface(id: DesignBlockId, typeface: Typeface, from?: number, to?: number):
 ```
 
 **Parameters:**
-
 - `id` - The text block whose font should be changed.
 - `typeface` - The new typeface.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
@@ -5533,7 +5552,6 @@ setTypeface(id: DesignBlockId, typeface: Typeface, from?: number, to?: number):
 
 Gets the base typeface of a text block.
 This does not return the typefaces of individual text runs.
-
 ```javascript
 const defaultTypeface = engine.block.getTypeface(text);
 ```
@@ -5543,7 +5561,6 @@ getTypeface(id: DesignBlockId): Typeface
 ```
 
 **Parameters:**
-
 - `id` - The text block whose typeface should be queried.
 
 **Returns:** the typeface property of the text block.
@@ -5551,7 +5568,6 @@ getTypeface(id: DesignBlockId): Typeface
 ### getTypefaces()
 
 Gets the unique typefaces within a range of text.
-
 ```javascript
 const currentTypefaces = engine.block.getTypefaces(text);
 ```
@@ -5561,18 +5577,38 @@ getTypefaces(id: DesignBlockId, from?: number, to?: number): Typeface[]
 ```
 
 **Parameters:**
-
 - `id` - The text block whose typefaces should be queried.
 - `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
 - `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
 
 **Returns:** The unique typefaces in the range.
 
+### getTextRuns()
+
+Gets all text runs within a range of text.
+Each run represents a contiguous span of text with uniform formatting.
+```javascript
+const runs = engine.block.getTextRuns(text);
+```
+
+```typescript
+getTextRuns(id: DesignBlockId, from?: number, to?: number): TextRunInfo[]
+```
+
+**Parameters:**
+- `id` - The text block to query.
+- `from` - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
+- `to` - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
+
+**Returns:** The ordered list of text runs covering the requested range.
+
 ### getTextCursorRange()
 
 Gets the current text cursor or selection range.
-Returns the UTF-16 indices of the selected range of the text block that is currently being edited.
-
+Returns the UTF-16 indices of the selected range of the text block that is currently being
+edited. The range is half-open (exclusive): `from` is the index of the first selected code
+unit, `to` is one past the last selected code unit. When `from === to` the cursor is
+positioned between characters with no text selected.
 ```javascript
 const selectedRange = engine.block.getTextCursorRange();
 ```
@@ -5592,13 +5628,11 @@ setTextCursorRange(range: Range): void
 ```
 
 **Parameters:**
-
 - `range` - The UTF-16 range to set as the selection. If `from` equals `to`, the cursor is positioned at that index. If `from` and `to` are set to -1, the whole text is selected.
 
 ### getTextVisibleLineCount()
 
 Gets the number of visible lines in a text block.
-
 ```javascript
 const lineCount = engine.block.getTextVisibleLineCount(text);
 ```
@@ -5608,7 +5642,6 @@ getTextVisibleLineCount(id: DesignBlockId): number
 ```
 
 **Parameters:**
-
 - `id` - The text block whose line count should be returned.
 
 **Returns:** The number of lines in the text block.
@@ -5617,12 +5650,8 @@ getTextVisibleLineCount(id: DesignBlockId): number
 
 Gets the global bounding box of a visible line of text.
 The values are in the scene's global coordinate space.
-
 ```javascript
-const lineBoundingBox = engine.block.getTextVisibleLineGlobalBoundingBoxXYWH(
-  text,
-  0
-);
+const lineBoundingBox = engine.block.getTextVisibleLineGlobalBoundingBoxXYWH(text, 0);
 ```
 
 ```typescript
@@ -5630,7 +5659,6 @@ getTextVisibleLineGlobalBoundingBoxXYWH(id: DesignBlockId, lineIndex: number): X
 ```
 
 **Parameters:**
-
 - `id` - The text block whose line bounding box should be returned.
 - `lineIndex` - The index of the line whose bounding box should be returned.
 
@@ -5645,12 +5673,28 @@ getTextVisibleLineContent(id: DesignBlockId, lineIndex: number): string
 ```
 
 **Parameters:**
-
 - `id` - The text block whose line content should be returned.
 - `lineIndex` - The index of the line whose content should be returned.
 
 **Returns:** The text content of the line.
 
+### getTextCharacterInkBoxes()
+
+Returns the tight ink-paint bounding box for each grapheme in the range.
+One entry per grapheme in [from, to). Non-printable graphemes get a zero-rect.
+Coordinates are in global scene space.
+
+```typescript
+getTextCharacterInkBoxes(id: DesignBlockId, from?: number, to?: number): CharacterInkBox[]
+```
+
+**Parameters:**
+- `id` - The text block to query.
+- `from` - Start grapheme index (-1 = start of cursor selection or 0).
+- `to` - End grapheme index (-1 = end of cursor selection or text length).
+
+**Returns:** Array of CharacterInkBox, one per grapheme in range, in text order.
+
 ### getTextEffectiveHorizontalAlignment()
 
 Gets the effective horizontal alignment of a text block.
@@ -5662,11 +5706,87 @@ getTextEffectiveHorizontalAlignment(id: DesignBlockId): 'Left' | 'Right' | 'Cent
 ```
 
 **Parameters:**
-
 - `id` - The text block whose effective alignment should be returned.
 
 **Returns:** The effective alignment ('Left', 'Right', or 'Center').
 
+### setTextOnPath()
+
+Sets the SVG path that the text baseline follows.
+Pass `null` to restore normal straight-line text layout.
+
+```typescript
+setTextOnPath(id: DesignBlockId, svgPath: string | null): void
+```
+
+**Parameters:**
+- `id` - The text block to modify.
+- `svgPath` - An SVG path string in the block's local coordinate space, or `null` to clear.
+
+### getTextOnPath()
+
+Gets the SVG path currently used as the text baseline.
+
+```typescript
+getTextOnPath(id: DesignBlockId): string | null
+```
+
+**Parameters:**
+- `id` - The text block to query.
+
+**Returns:** The SVG path string, or `null` if no path is set.
+
+### setTextOnPathOffset()
+
+Sets the start offset along the baseline path as a proportion of the path length.
+Values are clamped to `[-1, 1]`; `1` and `-1` wrap back to the path start.
+
+```typescript
+setTextOnPathOffset(id: DesignBlockId, offset: number): void
+```
+
+**Parameters:**
+- `id` - The text block to modify.
+- `offset` - The proportional offset. Positive values move the text forward along the path.
+
+### getTextOnPathOffset()
+
+Gets the start offset along the baseline path as a proportion of the path length.
+
+```typescript
+getTextOnPathOffset(id: DesignBlockId): number
+```
+
+**Parameters:**
+- `id` - The text block to query.
+
+**Returns:** The proportional offset in `[-1, 1]`.
+
+### setTextOnPathFlipped()
+
+Sets whether text is placed on the opposite side of the baseline path.
+
+```typescript
+setTextOnPathFlipped(id: DesignBlockId, flipped: boolean): void
+```
+
+**Parameters:**
+- `id` - The text block to modify.
+- `flipped` - When `true`, text sits on the underside of the curve and reads in the reverse direction.
+
+### getTextOnPathFlipped()
+
+Gets whether the text-on-path rendering is flipped.
+
+```typescript
+getTextOnPathFlipped(id: DesignBlockId): boolean
+```
+
+**Parameters:**
+- `id` - The text block to query.
+
+**Returns:** `true` when text is on the underside of the curve.
+
 ## Block Placeholder
 
 Manage placeholder functionality, controls, and behavior.
@@ -5675,7 +5795,6 @@ Manage placeholder functionality, controls, and behavior.
 
 Enables or disables the placeholder function for a block.
 When set to `true`, the given block becomes selectable by users and its placeholder capabilities are enabled in Adopter mode.
-
 ```javascript
 engine.block.setPlaceholderEnabled(block, true);
 ```
@@ -5685,14 +5804,12 @@ setPlaceholderEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose placeholder function should be enabled or disabled.
 - `enabled` - Whether the function should be enabled or disabled.
 
 ### isPlaceholderEnabled()
 
 Checks if the placeholder function for a block is enabled and can be selected by users in Adopter mode.
-
 ```javascript
 const placeholderIsEnabled = engine.block.isPlaceholderEnabled(block);
 ```
@@ -5702,12 +5819,11 @@ isPlaceholderEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose placeholder function state should be queried.
 
 **Returns:** The enabled state of the placeholder function.
 
-### hasPlaceholderBehavior() _(deprecated)_
+### hasPlaceholderBehavior() *(deprecated)*
 
 Checks if a block supports placeholder behavior.
 
@@ -5716,7 +5832,6 @@ hasPlaceholderBehavior(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block supports placeholder behavior.
@@ -5724,10 +5839,8 @@ hasPlaceholderBehavior(id: DesignBlockId): boolean
 ### supportsPlaceholderBehavior()
 
 Checks if a block supports placeholder behavior.
-
 ```javascript
-const placeholderBehaviorSupported =
-  engine.block.supportsPlaceholderBehavior(block);
+const placeholderBehaviorSupported = engine.block.supportsPlaceholderBehavior(block);
 ```
 
 ```typescript
@@ -5735,7 +5848,6 @@ supportsPlaceholderBehavior(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block supports placeholder behavior.
@@ -5744,7 +5856,6 @@ supportsPlaceholderBehavior(id: DesignBlockId): boolean
 
 Enables or disables the placeholder behavior for a block.
 When its fill block is set to `true`, an image block will act as a placeholder, showing a control overlay and a replacement button.
-
 ```javascript
 engine.block.setPlaceholderBehaviorEnabled(block, true);
 ```
@@ -5754,14 +5865,12 @@ setPlaceholderBehaviorEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose placeholder behavior should be enabled or disabled.
 - `enabled` - Whether the placeholder behavior should be enabled or disabled.
 
 ### isPlaceholderBehaviorEnabled()
 
 Checks if the placeholder behavior for a block is enabled.
-
 ```javascript
 engine.block.setPlaceholderBehaviorEnabled(block, true);
 ```
@@ -5771,12 +5880,11 @@ isPlaceholderBehaviorEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose placeholder behavior state should be queried.
 
 **Returns:** The enabled state of the placeholder behavior.
 
-### hasPlaceholderControls() _(deprecated)_
+### hasPlaceholderControls() *(deprecated)*
 
 Checks if a block supports placeholder controls.
 
@@ -5785,7 +5893,6 @@ hasPlaceholderControls(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block supports placeholder controls.
@@ -5799,7 +5906,6 @@ supportsPlaceholderControls(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** True, if the block supports placeholder controls.
@@ -5807,7 +5913,6 @@ supportsPlaceholderControls(id: DesignBlockId): boolean
 ### setPlaceholderControlsOverlayEnabled()
 
 Enables or disables the placeholder overlay pattern.
-
 ```javascript
 engine.block.setPlaceholderControlsOverlayEnabled(block, true);
 ```
@@ -5817,14 +5922,12 @@ setPlaceholderControlsOverlayEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose placeholder overlay should be enabled or disabled.
 - `enabled` - Whether the placeholder overlay should be shown or not.
 
 ### isPlaceholderControlsOverlayEnabled()
 
 Checks if the placeholder overlay pattern is enabled.
-
 ```javascript
 const overlayEnabled = engine.block.isPlaceholderControlsOverlayEnabled(block);
 ```
@@ -5834,7 +5937,6 @@ isPlaceholderControlsOverlayEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose placeholder overlay visibility state should be queried.
 
 **Returns:** The visibility state of the block's placeholder overlay pattern.
@@ -5842,7 +5944,6 @@ isPlaceholderControlsOverlayEnabled(id: DesignBlockId): boolean
 ### setPlaceholderControlsButtonEnabled()
 
 Enables or disables the placeholder button.
-
 ```javascript
 engine.block.setPlaceholderControlsButtonEnabled(block, true);
 ```
@@ -5852,14 +5953,12 @@ setPlaceholderControlsButtonEnabled(id: DesignBlockId, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose placeholder button should be shown or not.
 - `enabled` - Whether the placeholder button should be shown or not.
 
 ### isPlaceholderControlsButtonEnabled()
 
 Checks if the placeholder button is enabled.
-
 ```javascript
 const buttonEnabled = engine.block.isPlaceholderControlsButtonEnabled(block);
 ```
@@ -5869,7 +5968,6 @@ isPlaceholderControlsButtonEnabled(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose placeholder button visibility state should be queried.
 
 **Returns:** The visibility state of the block's placeholder button.
@@ -5886,7 +5984,6 @@ setMetadata(id: DesignBlockId, key: string, value: string): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose metadata will be accessed.
 - `key` - The key used to identify the desired piece of metadata.
 - `value` - The value to set.
@@ -5900,7 +5997,6 @@ getMetadata(id: DesignBlockId, key: string): string
 ```
 
 **Parameters:**
-
 - `id` - The block whose metadata will be accessed.
 - `key` - The key used to identify the desired piece of metadata.
 
@@ -5915,7 +6011,6 @@ hasMetadata(id: DesignBlockId, key: string): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose metadata will be accessed.
 - `key` - The key used to identify the desired piece of metadata.
 
@@ -5930,7 +6025,6 @@ findAllMetadata(id: DesignBlockId): string[]
 ```
 
 **Parameters:**
-
 - `id` - The block whose metadata will be accessed.
 
 **Returns:** A list of all metadata keys on this block.
@@ -5944,7 +6038,6 @@ removeMetadata(id: DesignBlockId, key: string): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose metadata will be accessed.
 - `key` - The key used to identify the desired piece of metadata.
 
@@ -5955,7 +6048,6 @@ Manage permissions and capabilities per block.
 ### setScopeEnabled()
 
 Enables or disables a scope for a block.
-
 ```javascript
 // Allow the user to move the image block.
 engine.block.setScopeEnabled(image, 'layer/move', true);
@@ -5966,7 +6058,6 @@ setScopeEnabled(id: DesignBlockId, key: Scope, enabled: boolean): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose scope should be enabled or disabled.
 - `key` - The scope to enable or disable.
 - `enabled` - Whether the scope should be enabled or disabled.
@@ -5974,7 +6065,6 @@ setScopeEnabled(id: DesignBlockId, key: Scope, enabled: boolean): void
 ### isScopeEnabled()
 
 Checks if a scope is enabled for a block.
-
 ```javascript
 engine.block.isScopeEnabled(image, 'layer/move');
 ```
@@ -5984,7 +6074,6 @@ isScopeEnabled(id: DesignBlockId, key: Scope): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block whose scope state should be queried.
 - `key` - The scope to query.
 
@@ -5993,7 +6082,6 @@ isScopeEnabled(id: DesignBlockId, key: Scope): boolean
 ### isAllowedByScope()
 
 Checks if an operation is allowed by a block's scopes.
-
 ```javascript
 // This will return true when the global scope is set to 'Defer'.
 engine.block.isAllowedByScope(image, 'layer/move');
@@ -6004,7 +6092,6 @@ isAllowedByScope(id: DesignBlockId, key: Scope): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to check.
 - `key` - The scope to check.
 
@@ -6017,7 +6104,6 @@ isAllowedByScope(id: DesignBlockId, key: Scope): boolean
 Splits a block at the specified time.
 The original block will be trimmed to end at the split time, and the returned duplicate
 will start at the split time and continue to the original end time.
-
 ```javascript
 const duplicate = engine.block.split(video, 10.0);
 ```
@@ -6027,7 +6113,6 @@ split(id: DesignBlockId, atTime: number, options?: SplitOptions): DesignBlockId
 ```
 
 **Parameters:**
-
 - `id` - The block to split.
 - `atTime` - The time (in seconds) relative to the block's time offset where the split should occur.
 - `options` - The options for configuring the split operation.
@@ -6047,7 +6132,6 @@ createAnimation(type: AnimationType): DesignBlockId
 ```
 
 **Parameters:**
-
 - `type` - The type of animation to create.
 
 **Returns:** The handle of the new animation instance.
@@ -6061,7 +6145,6 @@ supportsAnimation(id: DesignBlockId): boolean
 ```
 
 **Parameters:**
-
 - `id` - The block to query.
 
 **Returns:** Whether the block supports animation.
@@ -6075,7 +6158,6 @@ setInAnimation(id: DesignBlockId, animation: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose "in" animation should be set.
 - `animation` - The animation to set.
 
@@ -6088,7 +6170,6 @@ setLoopAnimation(id: DesignBlockId, animation: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose "loop" animation should be set.
 - `animation` - The animation to set.
 
@@ -6101,7 +6182,6 @@ setOutAnimation(id: DesignBlockId, animation: DesignBlockId): void
 ```
 
 **Parameters:**
-
 - `id` - The block whose "out" animation should be set.
 - `animation` - The animation to set.
 
@@ -6114,7 +6194,6 @@ getInAnimation(id: DesignBlockId): DesignBlockId
 ```
 
 **Parameters:**
-
 - `id` - The block whose "in" animation should be queried.
 
 **Returns:** The "in" animation of the block.
@@ -6128,7 +6207,6 @@ getLoopAnimation(id: DesignBlockId): DesignBlockId
 ```
 
 **Parameters:**
-
 - `id` - The block whose "loop" animation should be queried.
 
 **Returns:** The "loop" animation of the block.
@@ -6142,11 +6220,10 @@ getOutAnimation(id: DesignBlockId): DesignBlockId
 ```
 
 **Parameters:**
-
 - `id` - The block whose "out" animation should be queried.
 
 **Returns:** The "out" animation of the block.
 
 ---
 
-For complete type definitions, see the [CE.SDK TypeScript API Reference](https://img.ly/docs/cesdk/engine/api/).
+For complete type definitions, see the [CE.SDK TypeScript API Reference](https://img.ly/docs/cesdk/engine/api/).