@imgly/codesign-mcp 0.1.5 → 0.1.6

package/assets/docs/guide/text/decorations.md

@@ -1,330 +0,0 @@
-> This is one page of the CE.SDK Vanilla JS/TS documentation. For a complete overview, see the [Vanilla JS/TS Documentation Index](https://img.ly/docs/cesdk/js.md). For all docs in one file, see [llms-full.txt](./llms-full.txt.md).
-
-**Navigation:** [Guides](./guides.md) > [Create and Edit Text](./text.md) > [Text Decorations](./text/decorations.md)
-
----
-
-Add underline, strikethrough, and overline decorations to text blocks with configurable styles, colors, and thickness.
-
-![Text decorations demonstration showing underline, strikethrough, and overline styles](https://img.ly/docs/cesdk/./assets/browser.hero.webp)
-
-> **Reading time:** 5 minutes
->
-> **Resources:**
->
-> - [Download examples](https://github.com/imgly/cesdk-web-examples/archive/refs/tags/release-$UBQ_VERSION$.zip)
-> - [View source on GitHub](https://github.com/imgly/cesdk-web-examples/tree/release-$UBQ_VERSION$/guides-text-decorations-browser)
-> - [Open in StackBlitz](https://stackblitz.com/github/imgly/cesdk-web-examples/tree/v$UBQ_VERSION$/guides-text-decorations-browser)
-> - [Live demo](https://img.ly/docs/cesdk/examples/guides-text-decorations-browser/)
-
-CE.SDK supports three types of text decorations: underline, strikethrough, and overline. We can toggle decorations on and off, customize them with different line styles, and apply them to specific character ranges. All active decoration lines share the same style and thickness settings.
-
-```typescript file=@cesdk_web_examples/guides-text-decorations-browser/browser.ts reference-only
-import type { EditorPlugin, EditorPluginContext } from '@cesdk/cesdk-js';
-
-import {
-  BlurAssetSource,
-  ColorPaletteAssetSource,
-  CropPresetsAssetSource,
-  DemoAssetSources,
-  EffectsAssetSource,
-  FiltersAssetSource,
-  PagePresetsAssetSource,
-  StickerAssetSource,
-  TextAssetSource,
-  TextComponentAssetSource,
-  TypefaceAssetSource,
-  UploadAssetSources,
-  VectorShapeAssetSource
-} from '@cesdk/cesdk-js/plugins';
-import { DesignEditorConfig } from './design-editor/plugin';
-import packageJson from './package.json';
-
-/**
- * CE.SDK Plugin: Text Decorations Guide
- *
- * Demonstrates text decoration capabilities:
- * - Toggling underline, strikethrough, and overline
- * - Querying current decorations
- * - Setting custom decoration styles, colors, and thickness
- * - Applying decorations to character ranges
- * - Combining multiple decoration types
- */
-class Example implements EditorPlugin {
-  name = packageJson.name;
-
-  version = packageJson.version;
-
-  async initialize({ cesdk }: EditorPluginContext): Promise<void> {
-    if (!cesdk) {
-      throw new Error('CE.SDK instance is required for this plugin');
-    }
-
-    await cesdk.addPlugin(new DesignEditorConfig());
-
-    // Add asset source plugins
-    await cesdk.addPlugin(new BlurAssetSource());
-    await cesdk.addPlugin(new ColorPaletteAssetSource());
-    await cesdk.addPlugin(new CropPresetsAssetSource());
-    await cesdk.addPlugin(
-      new UploadAssetSources({ include: ['ly.img.image.upload'] })
-    );
-    await cesdk.addPlugin(
-      new DemoAssetSources({
-        include: [
-          'ly.img.templates.blank.*',
-          'ly.img.templates.presentation.*',
-          'ly.img.templates.print.*',
-          'ly.img.templates.social.*',
-          'ly.img.image.*'
-        ]
-      })
-    );
-    await cesdk.addPlugin(new EffectsAssetSource());
-    await cesdk.addPlugin(new FiltersAssetSource());
-    await cesdk.addPlugin(new PagePresetsAssetSource());
-    await cesdk.addPlugin(new StickerAssetSource());
-    await cesdk.addPlugin(new TextAssetSource());
-    await cesdk.addPlugin(new TextComponentAssetSource());
-    await cesdk.addPlugin(new TypefaceAssetSource());
-    await cesdk.addPlugin(new VectorShapeAssetSource());
-
-    await cesdk.actions.run('scene.create', {
-      page: { width: 800, height: 600, unit: 'Pixel' }
-    });
-
-    const engine = cesdk.engine;
-    const page = engine.block.findByType('page')[0];
-
-    // Create a text block to demonstrate decorations
-    const text = engine.block.create('text');
-    engine.block.appendChild(page, text);
-    engine.block.setPositionX(text, 100);
-    engine.block.setPositionY(text, 100);
-    engine.block.setWidthMode(text, 'Auto');
-    engine.block.setHeightMode(text, 'Auto');
-    engine.block.replaceText(text, 'Hello CE.SDK');
-
-    // Toggle underline on the entire text
-    engine.block.toggleTextDecorationUnderline(text);
-
-    // Toggle strikethrough on the entire text
-    engine.block.toggleTextDecorationStrikethrough(text);
-
-    // Toggle overline on the entire text
-    engine.block.toggleTextDecorationOverline(text);
-
-    // Calling toggle again removes the decoration
-    engine.block.toggleTextDecorationOverline(text);
-    // Query the current decoration configurations
-    // Returns a list of unique TextDecorationConfig objects in the range
-    const decorations = engine.block.getTextDecorations(text);
-    // Each config contains: lines, style, underlineColor, underlineThickness, underlineOffset, skipInk
-
-    // Set a specific decoration style
-    // Available styles: 'Solid', 'Double', 'Dotted', 'Dashed', 'Wavy'
-    engine.block.setTextDecoration(text, {
-      lines: ['Underline'],
-      style: 'Dashed'
-    });
-
-    // Set a custom underline color (only applies to underlines)
-    // Strikethrough and overline always use the text color
-    engine.block.setTextDecoration(text, {
-      lines: ['Underline'],
-      underlineColor: { r: 1, g: 0, b: 0, a: 1 }
-    });
-
-    // Adjust the underline thickness
-    // Default is 1.0, values above 1.0 make the line thicker
-    engine.block.setTextDecoration(text, {
-      lines: ['Underline'],
-      underlineThickness: 2.0
-    });
-
-    // Adjust the underline position relative to the font default
-    // 0 = font default, positive values move further from baseline, negative values move closer
-    engine.block.setTextDecoration(text, {
-      lines: ['Underline'],
-      underlineOffset: 0.1
-    });
-
-    // Apply decorations to a specific character range using UTF-16 indices
-    // Toggle underline on characters 0-5 ("Hello")
-    engine.block.toggleTextDecorationUnderline(text, 0, 5);
-
-    // Set strikethrough on characters 6-12 ("CE.SDK")
-    engine.block.setTextDecoration(text, { lines: ['Strikethrough'] }, 6, 12);
-
-    // Query decorations in a specific range
-    const subrangeDecorations = engine.block.getTextDecorations(text, 0, 5);
-
-    // Combine multiple decoration lines on the same text
-    // All active lines share the same style and thickness
-    engine.block.setTextDecoration(text, {
-      lines: ['Underline', 'Strikethrough'],
-      style: 'Solid'
-    });
-
-    // Remove all decorations
-    engine.block.setTextDecoration(text, { lines: ['None'] });
-
-    // Select the text block to show it in the inspector
-    engine.block.setSelected(text, true);
-
-    // Suppress unused variable warnings
-    void decorations;
-    void subrangeDecorations;
-  }
-}
-
-export default Example;
-```
-
-This guide covers toggling decorations, querying current state, setting custom styles, adjusting color and thickness, and applying decorations to character subranges.
-
-## Toggle Decorations
-
-We toggle decorations using `engine.block.toggleTextDecorationUnderline()`, `engine.block.toggleTextDecorationStrikethrough()`, and `engine.block.toggleTextDecorationOverline()`. If all characters in the range already have the decoration, it is removed; otherwise, it is added to all.
-
-```typescript highlight-toggle-decorations
-// Toggle underline on the entire text
-engine.block.toggleTextDecorationUnderline(text);
-
-// Toggle strikethrough on the entire text
-engine.block.toggleTextDecorationStrikethrough(text);
-
-// Toggle overline on the entire text
-engine.block.toggleTextDecorationOverline(text);
-
-// Calling toggle again removes the decoration
-engine.block.toggleTextDecorationOverline(text);
-```
-
-## Query Decorations
-
-We query the current decorations using `engine.block.getTextDecorations()`. It returns an ordered list of unique `TextDecorationConfig` objects. Each config includes the active lines, style, optional underline color, thickness multiplier, underline offset, and skip-ink setting.
-
-```typescript highlight-query-decorations
-// Query the current decoration configurations
-// Returns a list of unique TextDecorationConfig objects in the range
-const decorations = engine.block.getTextDecorations(text);
-// Each config contains: lines, style, underlineColor, underlineThickness, underlineOffset, skipInk
-```
-
-## Custom Decoration Styles
-
-We set a specific decoration style using `engine.block.setTextDecoration()` with a `TextDecorationConfig`. Available styles are `'Solid'` (default), `'Double'`, `'Dotted'`, `'Dashed'`, and `'Wavy'`.
-
-```typescript highlight-custom-style
-// Set a specific decoration style
-// Available styles: 'Solid', 'Double', 'Dotted', 'Dashed', 'Wavy'
-engine.block.setTextDecoration(text, {
-  lines: ['Underline'],
-  style: 'Dashed'
-});
-```
-
-## Underline Color
-
-We set a custom underline color that differs from the text color. The `underlineColor` property only applies to underlines; strikethrough and overline always use the text color.
-
-```typescript highlight-underline-color
-// Set a custom underline color (only applies to underlines)
-// Strikethrough and overline always use the text color
-engine.block.setTextDecoration(text, {
-  lines: ['Underline'],
-  underlineColor: { r: 1, g: 0, b: 0, a: 1 }
-});
-```
-
-## Decoration Thickness
-
-We adjust the underline thickness using the `underlineThickness` property. The default is `1.0`. Values above `1.0` make the underline thicker.
-
-```typescript highlight-thickness
-// Adjust the underline thickness
-// Default is 1.0, values above 1.0 make the line thicker
-engine.block.setTextDecoration(text, {
-  lines: ['Underline'],
-  underlineThickness: 2.0
-});
-```
-
-## Underline Offset
-
-We adjust the underline position using the `underlineOffset` property, which acts as a relative multiplier on the font-default distance. The actual position is computed as `fontDefault * (1 + underlineOffset)`. The default is `0`, which uses the font's default underline position. Positive values move the underline proportionally further from the baseline, negative values move it proportionally closer.
-
-```typescript highlight-offset
-// Adjust the underline position relative to the font default
-// 0 = font default, positive values move further from baseline, negative values move closer
-engine.block.setTextDecoration(text, {
-  lines: ['Underline'],
-  underlineOffset: 0.1
-});
-```
-
-## Subrange Decorations
-
-We apply decorations to specific character ranges using UTF-16 indices `[from, to)`. Both toggle and set operations accept range parameters.
-
-```typescript highlight-subrange
-// Apply decorations to a specific character range using UTF-16 indices
-// Toggle underline on characters 0-5 ("Hello")
-engine.block.toggleTextDecorationUnderline(text, 0, 5);
-
-// Set strikethrough on characters 6-12 ("CE.SDK")
-engine.block.setTextDecoration(text, { lines: ['Strikethrough'] }, 6, 12);
-
-// Query decorations in a specific range
-const subrangeDecorations = engine.block.getTextDecorations(text, 0, 5);
-```
-
-## Combine Decorations
-
-We combine multiple decoration types by passing an array of lines to `setTextDecoration()`. All active lines share the same style and thickness.
-
-```typescript highlight-combine
-// Combine multiple decoration lines on the same text
-// All active lines share the same style and thickness
-engine.block.setTextDecoration(text, {
-  lines: ['Underline', 'Strikethrough'],
-  style: 'Solid'
-});
-```
-
-## Remove Decorations
-
-We remove all decorations by setting the lines to `['None']`.
-
-```typescript highlight-remove
-// Remove all decorations
-engine.block.setTextDecoration(text, { lines: ['None'] });
-```
-
-## API Reference
-
-| Method                                             | Purpose                                         |
-| -------------------------------------------------- | ----------------------------------------------- |
-| `engine.block.toggleTextDecorationUnderline()`     | Toggle underline on entire text or range        |
-| `engine.block.toggleTextDecorationStrikethrough()` | Toggle strikethrough on entire text or range    |
-| `engine.block.toggleTextDecorationOverline()`      | Toggle overline on entire text or range         |
-| `engine.block.getTextDecorations()`                | Get ordered list of decoration configs in range |
-| `engine.block.setTextDecoration()`                 | Set decoration config for entire text or range  |
-
-## Troubleshooting
-
-**Decoration not visible**: Ensure the text block has content and the decoration lines are not set to `'None'`.
-
-**Underline color not changing**: The `underlineColor` property only applies to underlines. Strikethrough and overline always use the text color.
-
-**Toggle not adding decoration**: If all characters in the range already have the decoration, toggle removes it instead of adding it.
-
----
-
-## More Resources
-
-- **[Vanilla JS/TS Documentation Index](https://img.ly/docs/cesdk/js.md)** - Browse all Vanilla JS/TS documentation
-- **[Complete Documentation](./llms-full.txt.md)** - Full documentation in one file (for LLMs)
-- **[Web Documentation](./js.md)** - Interactive documentation with examples
-- **[Support](mailto:support@img.ly)** - Contact IMG.LY support

package/assets/docs/guide/text/enumerations.md

@@ -1,258 +0,0 @@
-> This is one page of the CE.SDK Vanilla JS/TS documentation. For a complete overview, see the [Vanilla JS/TS Documentation Index](https://img.ly/docs/cesdk/js.md). For all docs in one file, see [llms-full.txt](./llms-full.txt.md).
-
-**Navigation:** [Guides](./guides.md) > [Create and Edit Text](./text.md) > [Text Enumerations](./text/enumerations.md)
-
----
-
-Apply bullet lists and numbered lists to text blocks programmatically using per-paragraph list styles and nesting levels.
-
-![CE.SDK editor showing a text block with three paragraphs selected, ready for list style formatting](https://img.ly/docs/cesdk/./assets/browser.hero.webp)
-
-> **Reading time:** 5 minutes
->
-> **Resources:**
->
-> - [Download examples](https://github.com/imgly/cesdk-web-examples/archive/refs/heads/main.zip)
-> - [View source on GitHub](https://github.com/imgly/cesdk-web-examples/tree/main/guides-text-enumerations-browser)
-> - [Open in StackBlitz](https://stackblitz.com/~/github.com/imgly/cesdk-web-examples/tree/main/guides-text-enumerations-browser)
-> - [Live demo](https://img.ly/docs/cesdk/examples/guides-text-enumerations-browser/)
-
-CE.SDK represents list formatting as per-paragraph properties on a text block. Each paragraph independently holds a list style (`'None'`, `'Unordered'`, or `'Ordered'`) and a zero-based nesting level. A single call to `setTextListStyle()` targets either one paragraph or all paragraphs at once, making it straightforward to build structured lists without iterating manually.
-
-```typescript file=@cesdk_web_examples/guides-text-enumerations-browser/browser.ts reference-only
-import type { EditorPlugin, EditorPluginContext } from '@cesdk/cesdk-js';
-import {
-  BlurAssetSource,
-  ColorPaletteAssetSource,
-  CropPresetsAssetSource,
-  DemoAssetSources,
-  EffectsAssetSource,
-  FiltersAssetSource,
-  PagePresetsAssetSource,
-  StickerAssetSource,
-  TextAssetSource,
-  TextComponentAssetSource,
-  TypefaceAssetSource,
-  UploadAssetSources,
-  VectorShapeAssetSource
-} from '@cesdk/cesdk-js/plugins';
-import { DesignEditorConfig } from './design-editor/plugin';
-import packageJson from './package.json';
-
-class Example implements EditorPlugin {
-  name = packageJson.name;
-
-  version = packageJson.version;
-
-  async initialize({ cesdk }: EditorPluginContext): Promise<void> {
-    if (!cesdk) {
-      throw new Error('CE.SDK instance is required for this plugin');
-    }
-
-    // DesignEditorConfig uses settings not yet in the published package when this guide
-    // was authored. Guarded so the text block renders in both local and published contexts.
-    try {
-      await cesdk.addPlugin(new DesignEditorConfig());
-    } catch {
-      // noop — proceeds with asset sources and the enumeration example below
-    }
-    await cesdk.addPlugin(new BlurAssetSource());
-    await cesdk.addPlugin(new ColorPaletteAssetSource());
-    await cesdk.addPlugin(new CropPresetsAssetSource());
-    await cesdk.addPlugin(
-      new UploadAssetSources({ include: ['ly.img.image.upload'] })
-    );
-    await cesdk.addPlugin(
-      new DemoAssetSources({
-        include: [
-          'ly.img.templates.blank.*',
-          'ly.img.templates.presentation.*',
-          'ly.img.templates.print.*',
-          'ly.img.templates.social.*',
-          'ly.img.image.*'
-        ]
-      })
-    );
-    await cesdk.addPlugin(new EffectsAssetSource());
-    await cesdk.addPlugin(new FiltersAssetSource());
-    await cesdk.addPlugin(new PagePresetsAssetSource());
-    await cesdk.addPlugin(new StickerAssetSource());
-    await cesdk.addPlugin(new TextAssetSource());
-    await cesdk.addPlugin(new TextComponentAssetSource());
-    await cesdk.addPlugin(new TypefaceAssetSource());
-    await cesdk.addPlugin(new VectorShapeAssetSource());
-
-    // Create a new design scene with an 800×600 canvas
-    await cesdk.actions.run('scene.create', {
-      page: { width: 800, height: 600, unit: 'Pixel' }
-    });
-
-    const engine = cesdk.engine;
-    const page = engine.block.findByType('page')[0];
-
-    // Create a text block and populate it with three paragraphs
-    const textBlock = engine.block.create('text');
-    engine.block.appendChild(page, textBlock);
-    engine.block.replaceText(textBlock, 'First item\nSecond item\nThird item');
-    engine.block.setTextFontSize(textBlock, 36);
-    engine.block.setWidthMode(textBlock, 'Auto');
-    engine.block.setHeightMode(textBlock, 'Auto');
-    engine.block.setPositionX(textBlock, 80);
-    engine.block.setPositionY(textBlock, 80);
-
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const block = engine.block as any;
-
-    // Apply ordered list style to all paragraphs (paragraphIndex defaults to -1 = all)
-    block.setTextListStyle(textBlock, 'Ordered');
-
-    // Override the third paragraph (index 2) to unordered
-    block.setTextListStyle(textBlock, 'Unordered', 2);
-
-    // Set the second paragraph (index 1) to nesting level 1 (one indent deep)
-    block.setTextListLevel(textBlock, 1, 1);
-
-    // Read back the nesting level to confirm
-    const level = block.getTextListLevel(textBlock, 1);
-    console.log('Second paragraph nesting level:', level); // 1
-
-    // Atomically set both list style and nesting level in one call
-    // Sets paragraph 0 to ordered style at nesting level 0 (outermost)
-    block.setTextListStyle(textBlock, 'Ordered', 0, 0);
-
-    // Get all paragraph indices in the text block
-    const allIndices: number[] = block.getTextParagraphIndices(textBlock);
-    console.log('All paragraph indices:', allIndices); // [0, 1, 2]
-
-    // Get indices overlapping a specific grapheme range
-    const rangeIndices = block.getTextParagraphIndices(textBlock, 0, 10);
-    console.log('Indices for range [0, 10):', rangeIndices); // [0]
-
-    // Read back the list style and nesting level for each paragraph
-    const styles = allIndices.map((i) => block.getTextListStyle(textBlock, i));
-    const levels = allIndices.map((i) => block.getTextListLevel(textBlock, i));
-    console.log('Paragraph styles:', styles); // ['Ordered', 'Ordered', 'Unordered']
-    console.log('Paragraph levels:', levels); // [0, 1, 0]
-
-    engine.scene.zoomToBlock(textBlock, { padding: 40 });
-    engine.block.setSelected(textBlock, true);
-  }
-}
-
-export default Example;
-```
-
-This guide covers applying list styles, managing nesting levels, performing atomic style-and-level assignments, and resolving paragraph indices from text ranges.
-
-## Applying List Styles
-
-We start by creating a new design scene, then add a text block to it with three paragraphs separated by newlines. These paragraphs are the targets for all subsequent list operations.
-
-```typescript highlight-setup
-// Create a new design scene with an 800×600 canvas
-await cesdk.actions.run('scene.create', {
-  page: { width: 800, height: 600, unit: 'Pixel' }
-});
-
-const engine = cesdk.engine;
-const page = engine.block.findByType('page')[0];
-
-// Create a text block and populate it with three paragraphs
-const textBlock = engine.block.create('text');
-engine.block.appendChild(page, textBlock);
-engine.block.replaceText(textBlock, 'First item\nSecond item\nThird item');
-engine.block.setTextFontSize(textBlock, 36);
-engine.block.setWidthMode(textBlock, 'Auto');
-engine.block.setHeightMode(textBlock, 'Auto');
-engine.block.setPositionX(textBlock, 80);
-engine.block.setPositionY(textBlock, 80);
-```
-
-We apply list styles with `engine.block.setTextListStyle()`. Omitting `paragraphIndex` (or passing `-1`) applies the style to all paragraphs simultaneously. Passing a non-negative index targets a single paragraph.
-
-```typescript highlight-apply-list-styles
-// Apply ordered list style to all paragraphs (paragraphIndex defaults to -1 = all)
-block.setTextListStyle(textBlock, 'Ordered');
-
-// Override the third paragraph (index 2) to unordered
-block.setTextListStyle(textBlock, 'Unordered', 2);
-```
-
-After these two calls, paragraphs 0 and 1 are ordered (numbered) and paragraph 2 is unordered (bulleted).
-
-## Managing Nesting Levels
-
-We control the visual depth of list items with `engine.block.setTextListLevel()`. The `listLevel` parameter is zero-based: `0` is the outermost item and `1` is one indent deeper. Nesting has no visual effect when the list style is `'None'`. We read the current level back with `engine.block.getTextListLevel()`.
-
-```typescript highlight-manage-nesting
-// Set the second paragraph (index 1) to nesting level 1 (one indent deep)
-block.setTextListLevel(textBlock, 1, 1);
-
-// Read back the nesting level to confirm
-const level = block.getTextListLevel(textBlock, 1);
-console.log('Second paragraph nesting level:', level); // 1
-```
-
-## Atomic Style and Level Assignment
-
-We set both list style and nesting level in a single call by passing the optional `listLevel` parameter to `setTextListStyle()`. This saves a separate `setTextListLevel()` call when both properties need to change together.
-
-```typescript highlight-atomic
-// Atomically set both list style and nesting level in one call
-// Sets paragraph 0 to ordered style at nesting level 0 (outermost)
-block.setTextListStyle(textBlock, 'Ordered', 0, 0);
-```
-
-## Resolving Paragraph Indices from Text Ranges
-
-When working with a text selection or a known grapheme range, `engine.block.getTextParagraphIndices()` returns the 0-based paragraph indices that overlap the range. Passing negative values for `from` and `to` (the defaults) returns all indices in the block. This is useful before targeted per-paragraph operations.
-
-```typescript highlight-paragraph-indices
-// Get all paragraph indices in the text block
-const allIndices: number[] = block.getTextParagraphIndices(textBlock);
-console.log('All paragraph indices:', allIndices); // [0, 1, 2]
-
-// Get indices overlapping a specific grapheme range
-const rangeIndices = block.getTextParagraphIndices(textBlock, 0, 10);
-console.log('Indices for range [0, 10):', rangeIndices); // [0]
-```
-
-## Querying List Styles
-
-We read back the current list style and nesting level for each paragraph using `engine.block.getTextListStyle()` and `engine.block.getTextListLevel()`. Both getters require a non-negative `paragraphIndex`—use `getTextParagraphIndices()` to discover valid indices.
-
-```typescript highlight-query-list-styles
-// Read back the list style and nesting level for each paragraph
-const styles = allIndices.map((i) => block.getTextListStyle(textBlock, i));
-const levels = allIndices.map((i) => block.getTextListLevel(textBlock, i));
-console.log('Paragraph styles:', styles); // ['Ordered', 'Ordered', 'Unordered']
-console.log('Paragraph levels:', levels); // [0, 1, 0]
-```
-
-The logged output confirms styles `['Ordered', 'Ordered', 'Unordered']` and levels `[0, 1, 0]` across the three paragraphs.
-
-## Troubleshooting
-
-- **List markers not visible**: Verify the `text/character` scope is enabled on the text block before calling setters.
-- **`getTextListStyle()` throws**: The `paragraphIndex` must be non-negative for getters. Use `getTextParagraphIndices()` to retrieve valid indices.
-- **Nesting level has no effect**: Check that the list style is not `'None'`—nesting only applies when a list style is active.
-- **Numbered list restarting unexpectedly**: Ordered numbering is calculated per-paragraph across the entire block. A `'None'` paragraph between ordered items may reset the counter depending on the renderer.
-
-## API Reference
-
-| Method                                                     | Purpose                                                                                |
-| ---------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| <code>engine.block.<wbr />setTextListStyle()</code>        | Apply list style to one or all paragraphs, optionally setting nesting level atomically |
-| <code>engine.block.<wbr />getTextListStyle()</code>        | Get the list style of a specific paragraph                                             |
-| <code>engine.block.<wbr />setTextListLevel()</code>        | Set the nesting level of one or all paragraphs                                         |
-| <code>engine.block.<wbr />getTextListLevel()</code>        | Get the nesting level of a specific paragraph                                          |
-| <code>engine.block.<wbr />getTextParagraphIndices()</code> | Get 0-based paragraph indices overlapping a grapheme range                             |
-
----
-
-## More Resources
-
-- **[Vanilla JS/TS Documentation Index](https://img.ly/docs/cesdk/js.md)** - Browse all Vanilla JS/TS documentation
-- **[Complete Documentation](./llms-full.txt.md)** - Full documentation in one file (for LLMs)
-- **[Web Documentation](./js.md)** - Interactive documentation with examples
-- **[Support](mailto:support@img.ly)** - Contact IMG.LY support