@cesdk/engine 1.72.0-nightly.20260310 → 1.72.0-nightly.20260312

package/index.d.ts

@@ -4326,6 +4326,78 @@ export declare class BlockAPI {
      * @param to - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
      */
     setTextCase(id: DesignBlockId, textCase: TextCase, from?: number, to?: number): void;
+    /**
+     * Gets the list style for a specific paragraph of a text block.
+     *
+     * ```javascript
+     * const listStyle = engine.block.getTextListStyle(text, 0);
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block whose list style should be returned.
+     * @param paragraphIndex - The 0-based index of the paragraph.
+     * @returns The list style of the paragraph.
+     */
+    getTextListStyle(id: DesignBlockId, paragraphIndex: number): ListStyle;
+    /**
+     * 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);
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block whose list style should be changed.
+     * @param listStyle - The list style to apply.
+     * @param paragraphIndex - The 0-based index of the paragraph to modify. Negative values apply to all paragraphs.
+     * @param 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'.
+     */
+    setTextListStyle(id: DesignBlockId, listStyle: ListStyle, paragraphIndex?: number, listLevel?: number): void;
+    /**
+     * Gets the list nesting level for a specific paragraph of a text block.
+     *
+     * ```javascript
+     * const listLevel = engine.block.getTextListLevel(text, 0);
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block whose list level should be returned.
+     * @param paragraphIndex - The 0-based index of the paragraph.
+     * @returns The list nesting level of the paragraph.
+     */
+    getTextListLevel(id: DesignBlockId, paragraphIndex: number): number;
+    /**
+     * 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);
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block whose list level should be changed.
+     * @param listLevel - The list nesting level (0 = outermost).
+     * @param paragraphIndex - The 0-based index of the paragraph to modify. Negative values apply to all paragraphs.
+     */
+    setTextListLevel(id: DesignBlockId, listLevel: number, paragraphIndex?: number): void;
+    /**
+     * Returns the 0-based paragraph indices that overlap the given UTF-16 range.
+     *
+     * ```javascript
+     * const indices = engine.block.getTextParagraphIndices(text);
+     * const indices = engine.block.getTextParagraphIndices(text, 0, 5);
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block to query.
+     * @param from - The start index of the UTF-16 range. Negative values reference the entire text.
+     * @param to - The end index of the UTF-16 range. Negative values reference the entire text.
+     * @returns The paragraph indices overlapping the range.
+     */
+    getTextParagraphIndices(id: DesignBlockId, from?: number, to?: number): number[];
     /**
      * Checks if the bold font weight can be toggled for a range of text.
      *
@@ -7830,6 +7902,13 @@ export declare type _LegacySource<T> = (handler: (value: T) => void) => () => vo
  */
 export declare type _Listener<T> = (value: T) => void;
 
+/**
+ * Represents the list style of a paragraph.
+ *
+ * @public
+ */
+export declare type ListStyle = 'None' | 'Unordered' | 'Ordered';
+
 /**
  * e.g. `en`, `de`, etc.
  * @public
@@ -9005,7 +9084,7 @@ export declare type SettingEnumType = {
 export declare type SettingEnumValues = TouchPinchAction | TouchRotateAction | CameraClampingOvershootMode | DoubleClickSelectionMode | ColorPickerColorMode | TimelineTrackVisibility | (string & {});
 
 /** @public */
-export declare type SettingFloatPropertyName = 'positionSnappingThreshold' | 'rotationSnappingThreshold' | 'controlGizmo/blockScaleDownLimit' | (string & {});
+export declare type SettingFloatPropertyName = 'positionSnappingThreshold' | 'rotationSnappingThreshold' | 'controlGizmo/blockScaleDownLimit' | 'listIndentPerLevel' | (string & {});
 
 /** @public */
 export declare type SettingIntPropertyName = 'maxImageSize' | (string & {});
@@ -9135,6 +9214,8 @@ export declare interface Settings {
     'web/fetchCredentials': 'omit' | 'same-origin' | 'include';
     /** Scale-down limit for blocks in screen pixels when scaling with gizmos or touch gestures. */
     'controlGizmo/blockScaleDownLimit': number;
+    /** The width of each list indentation level, in EM units. */
+    listIndentPerLevel: number;
     /** The threshold distance in pixels for position snapping. */
     positionSnappingThreshold: number;
     /** The threshold angle in degrees for rotation snapping. */