@adobe/ccweb-add-on-sdk-types 1.27.0 → 1.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/ccweb-add-on-sdk-types",
-  "version": "1.27.0",
+  "version": "1.29.0",
   "author": "Adobe",
   "license": "MIT",
   "description": "Type definitions for Adobe Creative Cloud Web Add-on SDK.",

package/sandbox/express-document-sdk.d.ts

@@ -84,10 +84,12 @@ declare namespace ApiConstants {
         TextLayout,
         TextScriptStyle,
         EditorEvent,
+        ResizeBehavior,
         VisualEffectType,
         TextStyleSource,
         ParagraphListType,
-        OrderedListNumbering
+        OrderedListNumbering,
+        CreateRenditionFormat
     };
 }
 
@@ -170,6 +172,23 @@ export declare class ArtboardNode extends VisualNode implements Readonly<IRectan
      * The children of an Artboard are all subclasses of Node (not just the more minimal BaseNode or VisualNode).
      */
     get allChildren(): Readonly<Iterable<Node>>;
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * Helper to recursively traverse *all* the exposed scenegraph content within the subtree of this node.
+     * Every container node and every leaf node will be visited via a pre-order tree traversal.
+     * Although once called the list of direct descendants is static, changes to further descendants may appear while
+     * iterating depending on when the operation occurs relative to the parent being yielded.
+     * Note that the root node (i.e. what this API was called on) is not visited.
+     *
+     * The descendants of an Artboard are all subclasses of Node (not just the more minimal BaseNode or VisualNode).
+     *
+     * Warning: Processing text content via this API can be error-prone. Use {@link VisualNode.allTextContent}
+     */
+    get allDescendants(): Readonly<Iterable<Node>>;
     /**
      * The artboards's regular children (does not include any "background layer" content if present; use {@link allChildren}
      * for a read-only view that includes background content). Use the methods on this `children` ItemList object to get,
@@ -392,7 +411,7 @@ export declare class BitmapImage {
      * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
      *
      * @experimental
-     * Fetches the bitmap data as a Blob. This will wait for the bitmap to be available if necessary.
+     * Fetches the bitmap data as a Blob. Waits up to 1 minute for the bitmap to be available if necessary.
      */
     data(): Promise<Blob>;
 }
@@ -553,6 +572,22 @@ export declare class ColorUtils {
 
 export declare const colorUtils: ExpressColorUtilsWrapper;
 
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * An interface for arbitrary resize operations regardless of whether given a width or height when using {@link Node.resize}.
+ */
+declare interface CommonResizeOptions {
+    /**
+     * Whether to try to avoid scaling the content's visual styling (e.g. stroke width, corner detailing, etc.).
+     * Note that some kinds of content may not be able to avoid rescaling in some scenarios.
+     */
+    avoidScalingVisualDetailsIfPossible: boolean;
+}
+
 /**
  * A ComplexShapeNode is a complex prepackaged shape that appears as a leaf node in the UI, even if it is composed
  * of multiple separate paths.
@@ -630,6 +665,60 @@ export declare class Context {
     get insertionParent(): ContainerNode;
 }
 
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * The format of the rendition output.
+ */
+export declare enum CreateRenditionFormat {
+    png = "png",
+    jpeg = "jpeg"
+}
+
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * An interface for configuring {@link VisualNode.createRendition}.
+ */
+export declare interface CreateRenditionOptions {
+    /**
+     * Whether to output in PNG or JPEG format.  Defaults to PNG.
+     */
+    format?: CreateRenditionFormat;
+    /**
+     * The scale factor to apply to the content before it is rendered.
+     */
+    scale?: number;
+}
+
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * An interface for the result of {@link VisualNode.createRendition}.
+ */
+export declare interface CreateRenditionResult {
+    /**
+     * The PNG or JPEG data for the rendition.
+     */
+    blob?: Blob;
+    /**
+     * The bounds of the rendition in the global coordinate space.
+     * This may be larger than the {@link VisualNode.boundsLocal} due to rotations, borders, filters, or other effects.
+     * Only provided if the {@link VisualNode} is not orphaned.
+     *
+     */
+    drawBoundsGlobal?: Rect;
+}
+
 /**
  * Entry point for APIs that read or modify the document's content.
  */
@@ -771,6 +860,25 @@ export declare class Editor {
      * @returns a stroke configured with the given options.
      */
     makeStroke(options?: Partial<SolidColorStroke>): SolidColorStroke;
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * @param parentNode - The parent node that will contain the threaded text node. This must be a container node (e.g., ArtboardNode, GroupNode) that is attached to the document.
+     * @param textContent - The initial text content for the threaded text node.
+     * @param geometry - The geometry of the threaded text node.
+     * @returns A new ThreadedTextNode that is part of a threaded text flow.
+     *
+     * @throws if parentNode is not provided or is not a valid container node.
+     * @throws if textContent is empty or invalid.
+     */
+    createThreadedText(
+        parentNode: ContainerNode,
+        textContent: string,
+        geometry?: TextFrameAreaGeometry
+    ): ThreadedTextNode;
     /**
      * @returns a path node with a default stroke and no initial fill.
      * @param path - a string representing any [SVG path element](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths).
@@ -849,13 +957,7 @@ export declare class ExpressContext extends Context {
  * Entry point for Express specific APIs that read or modify the document's content.
  */
 export declare class ExpressEditor extends Editor {
-    /**
-     * User's current selection context
-     */
     get context(): ExpressContext;
-    /**
-     * @returns the root of the document.
-     */
     get documentRoot(): ExpressRootNode;
 }
 
@@ -980,6 +1082,17 @@ export declare const fonts: ExpressFontsWrapper;
  * media rectangle child when those actions are applied.
  */
 export declare class GridCellNode extends Node implements IMediaContainerNode {
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * Proxy resizing of the MediaRectangleNode *inside* this grid cell. The enclosing grid layout keeps
+     * the crop window (and thus the overall GridCellNode/MediaContainerNode bounds) fixed in position.
+     * *Warning:* This will not change the bounds reported by this GridCellNode itself.
+     */
+    resize(options: ResizeOptions): void;
     /**
      * Always throws as it's not possible to clone a single grid slot.
      * Use the parent grid container instead.
@@ -1387,6 +1500,23 @@ declare class Node extends VisualNode implements INodeBounds {
      * The children of a Node are always other Node classes (never the more minimal BaseNode).
      */
     get allChildren(): Readonly<Iterable<Node>>;
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * Helper to recursively traverse *all* the exposed scenegraph content within the subtree of this node.
+     * Every container node and every leaf node will be visited via a pre-order tree traversal.
+     * Although once called the list of direct descendants is static, changes to further descendants may appear while
+     * iterating depending on when the operation occurs relative to the parent being yielded.
+     * Note that the root node (i.e. what this API was called on) is not visited.
+     *
+     * The descendants of a Node are always other Node classes (never the more minimal BaseNode).
+     *
+     * Warning: Processing text content via this API can be error-prone. Use {@link VisualNode.allTextContent}
+     */
+    get allDescendants(): Readonly<Iterable<Node>>;
     get boundsInParent(): Readonly<Rect>;
     boundsInNode(targetNode: VisualNode): Readonly<Rect>;
     get translation(): Readonly<Point>;
@@ -1449,60 +1579,9 @@ declare class Node extends VisualNode implements INodeBounds {
      * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
      *
      * @experimental
-     * Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to
-     * preserve its existing aspect ratio, keeping its top-left corner ({@link topLeftLocal}) at a fixed location.
-     *
-     * Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size.
-     * Contrast this to *resizing* operations (such as {@link resizeToFitWithin}), which adjust the bounding box of an
-     * element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts.
-     *
-     * Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not
-     * a separate, persistent scale factor multiplier).
-     */
-    rescaleProportionalToWidth(width: number): void;
-    /**
-     * <InlineAlert slots="text" variant="warning"/>
-     *
-     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
-     *
-     * @experimental
-     * Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to
-     * preserve its existing aspect ratio. See {@link rescaleProportionalToWidth} documentation for additional explanation.
+     * Resizes this node based on the given {@link ResizeOptions}.
      */
-    rescaleProportionalToHeight(height: number): void;
-    /**
-     * <InlineAlert slots="text" variant="warning"/>
-     *
-     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
-     *
-     * @experimental
-     * Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ({@link topLeftLocal})
-     * at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes
-     * with flexible aspect ratio will be resized to the exact box size specified.
-     *
-     * Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing,
-     * and font size as much as possible. Contrast with *rescaling* (such as {@link rescaleProportionalToWidth}), which
-     * always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This
-     * API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing
-     * to fit the box better.
-     *
-     * @see resizeToCover
-     */
-    resizeToFitWithin(width: number, height: number): void;
-    /**
-     * <InlineAlert slots="text" variant="warning"/>
-     *
-     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
-     *
-     * @experimental
-     * Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ({@link topLeftLocal})
-     * at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but
-     * nodes with flexible aspect ratio will be resized to the exact box size specified. See {@link resizeToFitWithin}
-     * documentation for additional explanation.
-     *
-     * @see resizeToFitWithin
-     */
-    resizeToCover(width: number, height: number): void;
+    resize(options: ResizeOptions): void;
     /**
      * Creates a copy of this node and its entire subtree of descendants.
      *
@@ -1582,6 +1661,37 @@ export declare class PageNode extends BaseNode implements IRectangularNode {
      * To create new artboards, see {@link ArtboardList.addArtboard}.
      */
     get artboards(): ArtboardList;
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * Helper to recursively traverse *all* the exposed scenegraph content within the subtree of this node.
+     * Every container node and every leaf node will be visited via a pre-order tree traversal.
+     * Although once called the list of direct descendants is static, changes to further descendants may appear while
+     * iterating depending on when the operation occurs relative to the parent being yielded.
+     * Note that the root node (i.e. what this API was called on) is not visited.
+     *
+     * Warning: Processing text content via this API can be error-prone. Use {@link VisualNode.allTextContent}
+     */
+    get allDescendants(): Readonly<Iterable<VisualNode>>;
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * Helper to process all text content that is found as part of or within this node. This can be hard to do correctly
+     * via manual tree traversal since multiple {@link ThreadedTextNode} can share a single {@link TextContentModel}.
+     *
+     * This iterator returns a single result per TextContentModel that is at least partially displayed within this node,
+     * even if that content is split across several separate TextNode "frames". If this node is or contains some but not
+     * all of the display frames of an overall TextContentModel, that model is still included as a result.
+     *
+     * Note that visibleRanges and visibleText may not be sorted as TextNode "frames" can appear in any order in the scenegraph.
+     */
+    get allTextContent(): Readonly<Iterable<TextContent>>;
     /**
      * The width of the node.
      *
@@ -1845,6 +1955,111 @@ declare interface RemoveListStyleInput extends BaseParagraphListStyle {
     type: ParagraphListType.none;
 }
 
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * An interface for rescaling the node based on a given height when using {@link Node.resize}.
+ */
+declare interface RescaleProportionalToHeightOptions extends CommonResizeOptions {
+    behavior: ResizeBehavior.proportional;
+    height: number;
+    /** Instead of providing a width, it will be calculated by multiplying the given height by the current aspect ratio. */
+    width?: never;
+}
+
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * An interface for rescaling the node based on a given width when using {@link Node.resize}.
+ */
+declare interface RescaleProportionalToWidthOptions extends CommonResizeOptions {
+    behavior: ResizeBehavior.proportional;
+    width: number;
+    /** Instead of providing a height, it will be calculated by multiplying the given width by the current aspect ratio. */
+    height?: never;
+}
+
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * An enum for controlling the behavior of {@link Node.resize}.
+ */
+export declare enum ResizeBehavior {
+    /**
+     * Resizes the node to fit entirely *within* a box of the given dimensions, keeping its {@link topLeftLocal}
+     * at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result,
+     * but nodes with flexible aspect ratio will be resized to the exact box size specified.
+     */
+    contain = "contain",
+    /**
+     * Resizes the node to completely *cover* a box of the given dimensions, keeping its {@link topLeftLocal}
+     * at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result,
+     * but nodes with flexible aspect ratio will be resized to the exact box size specified.
+     */
+    cover = "cover",
+    /**
+     * Resizes the node to the given width or height while preserving its current aspect ratio, keeping its
+     * {@link topLeftLocal} at a fixed location.
+     */
+    proportional = "proportional"
+}
+
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * A type union for providing the necessary arguments to {@link Node.resize}.
+ *
+ * Note that some nodes only support proportional resizing. In some cases this is always true (e.g. images) while in
+ * other cases it is due to the current visual details (e.g. the stroke being too thick to shrink the size of a shape).
+ */
+export declare type ResizeOptions =
+    | RescaleProportionalToWidthOptions
+    | RescaleProportionalToHeightOptions
+    | ResizeUsingWidthOptions
+    | ResizeUsingHeightOptions;
+
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * An interface for resizing the node based on a given height when using {@link Node.resize}.
+ */
+declare interface ResizeUsingHeightOptions extends CommonResizeOptions {
+    behavior: ResizeBehavior.contain | ResizeBehavior.cover;
+    height: number;
+    /** If a width is not provided, it will be calculated by multiplying the given height by the current aspect ratio. */
+    width?: number;
+}
+
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * An interface for resizing the node based on a given width when using {@link Node.resize}.
+ */
+declare interface ResizeUsingWidthOptions extends CommonResizeOptions {
+    behavior: ResizeBehavior.contain | ResizeBehavior.cover;
+    width: number;
+    /** If a height is not provided, it will be calculated by multiplying the given width by the current aspect ratio. */
+    height?: number;
+}
+
 /**
  * Base for ItemLists that restrict how items are added to the list, but freely allow items to be removed and
  * reordered. The {@link ItemList} subclass adds more capabilities, however.
@@ -2095,6 +2310,32 @@ declare enum TextAlignment {
     justifyLeft = 4
 }
 
+/**
+ * <InlineAlert slots="text" variant="warning"/>
+ *
+ * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+ *
+ * @experimental
+ * The values yielded by {@link VisualNode.allTextContent} and {@link PageNode.allTextContent}.
+ */
+export declare interface TextContent {
+    textContentModel: TextContentModel;
+    /**
+     * An unsorted list of the subranges of the related text content model that are visible within the node.
+     *
+     * Since a single text content model can be displayed across multiple TextNode "frames", any of which could be
+     * outside of the node, the union of all the subranges in this value may still be a subset of the total range.
+     */
+    visibleRanges: TextRange[];
+    /**
+     * An unsorted list of the parts of the related text content model that are visible within the node.
+     *
+     * Since a single text content model can be displayed across multiple TextNode "frames", any of which could be
+     * outside of the node, the union of all the text in this value may still be a subset of the total text.
+     */
+    visibleText: string[];
+}
+
 /**
  * TextContentModel is an abstract base class representing a complete piece of text content.
  * Use this model to get or modify the text string and the style ranges applied to it.
@@ -2258,6 +2499,15 @@ export declare abstract class TextContentModel {
     hasUnavailableFonts(): boolean;
 }
 
+/**
+ * Geometry for an area text frame in pixels.
+ * @experimental
+ */
+export declare interface TextFrameAreaGeometry {
+    width: number;
+    height: number;
+}
+
 /**
  * <InlineAlert slots="text" variant="warning"/>
  *
@@ -2482,12 +2732,23 @@ export declare enum TextStyleSource {
  * ThreadedTextContentModel represents a complete piece of text content that is split across multiple
  * {@link ThreadedTextNode} frames for display. This subclass provides a mutable {@link allFrames} list
  * that supports adding, removing, and reordering text frames.
- *
- * The append and insert operations will automatically parent the new frame to the same parent as the
- * reference frame and place it in the correct z-order.
  */
 export declare class ThreadedTextContentModel extends TextNodeContentModel {
     get allTextNodes(): Readonly<Iterable<ThreadedTextNode>>;
+    get frames(): ThreadedTextList;
+}
+
+export declare class ThreadedTextList extends ReadOnlyItemList<ThreadedTextNode> {
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * @param geometry - The geometry of the threaded text node in pixels (width and height).
+     * @returns A new ThreadedTextNode that is part of a threaded text flow.
+     */
+    addFrame(geometry?: TextFrameAreaGeometry): ThreadedTextNode;
 }
 
 /**
@@ -2496,8 +2757,6 @@ export declare class ThreadedTextContentModel extends TextNodeContentModel {
  * instead it refers to a {@link TextNodeContentModel}, which may be shared across multiple ThreadedTextNode frames.
  *
  * All linked ThreadedTextNodes that share a single TextContentModel must remain together within the same artboard.
- *
- * APIs are not yet available to create multi-frame text flows. To create *non*-threaded text, use {@link Editor.createText}.
  */
 export declare class ThreadedTextNode extends TextNode {
     /**
@@ -2593,6 +2852,15 @@ declare enum VisualEffectType {
  * Some VisualNodes might have a non-visual parent such as a PageNode.
  */
 export declare class VisualNode extends BaseNode implements IVisualNodeBounds {
+    /**
+     * Returns a read-only list of all children of the node. General-purpose content containers such as ArtboardNode or
+     * GroupNode also provide a mutable {@link ContainerNode.children} list. Other nodes with a more specific structure can
+     * hold children in various discrete "slots"; this `allChildren` list includes *all* such children and reflects their
+     * overall display z-order.
+     *
+     * The children of a VisualNode are always other VisualNode classes (never the more minimal BaseNode).
+     */
+    get allChildren(): Readonly<Iterable<VisualNode>>;
     /**
      * The highest ancestor that still has visual presence in the document. Typically an Artboard, but for orphaned
      * content, it will be the root of the deleted content (which might be this node itself).
@@ -2602,10 +2870,54 @@ export declare class VisualNode extends BaseNode implements IVisualNodeBounds {
      * meaningful comparison or conversion between the bounds or coordinate spaces of such nodes.
      */
     get visualRoot(): VisualNode;
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * Helper to recursively traverse *all* the exposed scenegraph content within the subtree of this node.
+     * Every container node and every leaf node will be visited via a pre-order tree traversal.
+     * Although once called the list of direct descendants is static, changes to further descendants may appear while
+     * iterating depending on when the operation occurs relative to the parent being yielded.
+     * Note that the root node (i.e. what this API was called on) is not visited.
+     *
+     * Warning: Processing text content via this API can be error-prone. Use {@link VisualNode.allTextContent}
+     */
+    get allDescendants(): Readonly<Iterable<VisualNode>>;
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * Helper to process all text content that is found as part of or within this node. This can be hard to do correctly
+     * via manual tree traversal since multiple {@link ThreadedTextNode} can share a single {@link TextContentModel}.
+     *
+     * This iterator returns a single result per TextContentModel that is at least partially displayed within this node,
+     * even if that content is split across several separate TextNode "frames". If this node is or contains some but not
+     * all of the display frames of an overall TextContentModel, that model is still included as a result.
+     *
+     * Note that visibleRanges and visibleText may not be sorted as TextNode "frames" can appear in any order in the scenegraph.
+     */
+    get allTextContent(): Readonly<Iterable<TextContent>>;
     get boundsLocal(): Readonly<Rect>;
     get centerPointLocal(): Readonly<Point>;
     get topLeftLocal(): Readonly<Point>;
     localPointInNode(localPoint: Point, targetNode: VisualNode): Readonly<Point>;
+    /**
+     * <InlineAlert slots="text" variant="warning"/>
+     *
+     * **IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`.
+     *
+     * @experimental
+     * Generates a rendition of this node and its descendants.
+     *
+     * If this node contains images, it will wait for the best quality to be available before capturing.
+     * As such, there is a 20s timeout before an error is thrown to prevent indefinite waiting.
+     *
+     */
+    createRendition(options?: CreateRenditionOptions): Promise<CreateRenditionResult>;
 }
 
 export {};

package/ui/ui-sdk.d.ts

@@ -945,6 +945,11 @@ declare interface Document_2 {
      * Run print quality check
      */
     runPrintQualityCheck(options: PrintQualityCheckOptions): void;
+    /**
+     * @experimental - Experimental API
+     * @returns true if the document is a presentation document.
+     */
+    isPresentation(): Promise<boolean>;
 }
 export { Document_2 as Document };
 
@@ -1315,7 +1320,8 @@ export declare interface JpgRenditionOptions extends RenditionOptions {
      */
     quality?: number;
     /**
-     * Requested size
+     * The desired dimensions for the image rendition.
+     * NOTE: Only downscaling is supported on mobile and chrome OS devices.
      */
     requestedSize?: {
         width?: number;
@@ -1750,7 +1756,8 @@ export declare interface PngRenditionOptions extends RenditionOptions {
      */
     backgroundColor?: number;
     /**
-     * Requested size
+     * The desired dimensions for the image rendition.
+     * NOTE: Only downscaling is supported on mobile and chrome OS devices.
      */
     requestedSize?: {
         width?: number;