@canva/design 2.7.4-beta.2 → 2.7.5-beta.0

package/beta.d.ts

@@ -133,7 +133,7 @@ export declare const addElementAtCursor: (
 ) => Promise<void>;
 
 /**
- * @public
+ * @beta
  * Add element to fixed designs, which use a coordinate-based positioning system.
  *
  * @example Insert an image at specific coordinates
@@ -245,7 +245,7 @@ export declare const addNativeElement: (
 ) => Promise<void>;
 
 /**
- * @public
+ * @beta
  * Adds a new page immediately after the currently selected page.
  * @param opts - Configuration for the new page to be added.
  *
@@ -352,7 +352,7 @@ export declare const addPage: (opts?: {
  * @public
  * Alternative text for a11y compliance.
  */
-export declare type AltText = {
+declare type AltText = {
   /**
    * The text content.
    */
@@ -438,7 +438,7 @@ export declare type AltText = {
  * });
  * ```
  */
-export declare type AppElementChangeHandler<A extends AppElementData> = (
+declare type AppElementChangeHandler<A extends AppElementData> = (
   appElement:
     | {
         /**
@@ -510,7 +510,7 @@ export declare type AppElementChangeHandler<A extends AppElementData> = (
  * @public
  * A client that provides methods for creating and managing the lifecycle of an app element.
  */
-export declare interface AppElementClient<A extends AppElementData> {
+declare interface AppElementClient<A extends AppElementData> {
   /**
    * @deprecated This type has been superseded, use `addElement` or `registerOnElementChange` instead.
    * If an app element is selected, the element's data is overwritten and the element is re-rendered.
@@ -744,7 +744,7 @@ export declare interface AppElementClient<A extends AppElementData> {
 }
 
 /**
- * @public
+ * @beta
  * Options for creating an app element client.
  */
 export declare type AppElementClientConfiguration<A extends AppElementData> = {
@@ -758,14 +758,14 @@ export declare type AppElementClientConfiguration<A extends AppElementData> = {
  * @public
  * The data associated with an app element.
  */
-export declare type AppElementData = Record<string, Value>;
+declare type AppElementData = Record<string, Value>;
 
 /**
  * @public
  * Used to add or update an app element to the design.
  * The update function is provided in the AppElementChangeHandler callback (registerOnElementChange).
  */
-export declare type AppElementOptions<A extends AppElementData> = {
+declare type AppElementOptions<A extends AppElementData> = {
   /**
    * The data to attach to the app element.
    */
@@ -777,7 +777,7 @@ export declare type AppElementOptions<A extends AppElementData> = {
 };
 
 /**
- * @public
+ * @beta
  * A callback function that renders an app element based on the data it receives.
  * @param appElementData - The data the callback must use to render the app element.
  */
@@ -786,7 +786,7 @@ export declare type AppElementRenderer<A extends AppElementData> = (
 ) => AppElementRendererOutput;
 
 /**
- * @public
+ * @beta
  * An array of one or more elements to render as output of an app element.
  */
 export declare type AppElementRendererOutput = GroupContentAtPoint[];
@@ -795,7 +795,7 @@ export declare type AppElementRendererOutput = GroupContentAtPoint[];
  * @public
  * A unique identifier that references an app runtime process
  */
-export declare type AppProcessId = string & {
+declare type AppProcessId = string & {
   __appProcessId: never;
 };
 
@@ -803,7 +803,7 @@ export declare type AppProcessId = string & {
  * @public
  * Audio track to be added to the design at the end of a drag event.
  */
-export declare type AudioDragConfig = {
+declare type AudioDragConfig = {
   /**
    * The type of element.
    */
@@ -828,7 +828,7 @@ export declare type AudioDragConfig = {
  * @public
  * A unique identifier that references an audio asset in Canva's backend.
  */
-export declare type AudioRef = string & {
+declare type AudioRef = string & {
   __audioRef: never;
 };
 
@@ -836,7 +836,7 @@ export declare type AudioRef = string & {
  * @public
  * An audio track that can be added to a design.
  */
-export declare type AudioTrack = {
+declare type AudioTrack = {
   /**
    * A unique identifier that points to an audio asset in Canva's backend.
    */
@@ -847,7 +847,7 @@ export declare type AudioTrack = {
  * @public
  * A segment of a richtext range.
  */
-export declare type Bounds = {
+declare type Bounds = {
   /**
    * The starting position of the segment.
    *
@@ -861,21 +861,11 @@ export declare type Bounds = {
   length: number;
 };
 
-/**
- * @deprecated
- * @public
- * A position, rotation, and set of dimensions.
- *
- * @remarks
- * The position and dimensions are relative to the container.
- */
-export declare type Box = Point & (WidthAndHeight | Width | Height);
-
 /**
  * @public
  * An individual cell in a table element.
  */
-export declare type Cell = {
+declare type Cell = {
   /**
    * The attributes of the cell.
    */
@@ -945,7 +935,7 @@ declare type CommonImageDragConfig = {
  * @public
  * A snapshot of content from a user's design.
  */
-export declare interface ContentDraft<T> {
+declare interface ContentDraft<T> {
   /**
    * The individual content items that exist within the snapshot.
    *
@@ -1020,16 +1010,10 @@ export declare interface ContentDraft<T> {
  */
 export declare type ContentType = "richtext" | "fill";
 
-/**
- * @public
- * A type of content that can be read from a user's design.
- */
-declare type ContentType_2 = "richtext";
-
 /**
  * @beta
  */
-export declare type ContentTypeMap = {
+declare type ContentTypeMap = {
   richtext: RichtextContentSession;
   fill: FillContentSession;
 };
@@ -1038,25 +1022,10 @@ export declare type ContentTypeMap = {
  * @public
  * Options for configuring where content in a design should be queried from.
  */
-export declare type ContextOptions = {
+declare type ContextOptions = {
   target: "current_page";
 };
 
-/**
- * @public
- * A set of X and Y coordinates.
- */
-export declare type Coordinates = {
-  /**
-   * X coordinate, in pixels.
-   */
-  x: number;
-  /**
-   * Y coordinate, in pixels.
-   */
-  y: number;
-};
-
 /**
  * @public
  * Creates a new RichtextRange object, which contains methods to manipulate text.
@@ -2775,7 +2744,7 @@ export declare namespace DesignEditing {
 }
 
 /**
- * @public
+ * @beta
  * An element that's natively supported by the Canva editor.
  */
 export declare type DesignElement =
@@ -2792,7 +2761,7 @@ export declare type DesignElement =
  * @public
  * Information about the design.
  */
-export declare type DesignMetadata = {
+declare type DesignMetadata = {
   /**
    * The title of the user's design.
    * @remarks
@@ -2906,7 +2875,7 @@ export declare type DesignOpenPageCallback<
  * @public
  * Provides methods for managing the lifecycle of overlays, such as selected image overlays.
  */
-export declare type DesignOverlay = {
+declare type DesignOverlay = {
   /**
    * Registers a callback that runs when the `canOpen` state of an overlay target changes.
    * @param opts - Options for configuring the callback.
@@ -3006,7 +2975,7 @@ export declare type DesignOverlay = {
  * @public
  * Provides methods for interacting with selected content.
  */
-export declare type DesignSelection = {
+declare type DesignSelection = {
   /**
    * Registers a callback that runs when the specified type of content is selected.
    *
@@ -3093,7 +3062,7 @@ export declare type DesignSelection = {
  * @public
  * JWT that contains the Design ID and App ID.
  */
-export declare type DesignToken = {
+declare type DesignToken = {
   token: string;
 };
 
@@ -3101,7 +3070,7 @@ export declare type DesignToken = {
  * @public
  * A set of dimensions.
  */
-export declare type Dimensions = {
+declare type Dimensions = {
   /**
    * A width, in pixels.
    */
@@ -3116,7 +3085,7 @@ export declare type Dimensions = {
  * @public
  * An event that occurs when a user starts dragging an HTML element.
  */
-export declare type DragStartEvent<E extends Element> = Pick<
+declare type DragStartEvent<E extends Element> = Pick<
   DragEvent,
   "dataTransfer" | "currentTarget" | "preventDefault" | "clientX" | "clientY"
 > & {
@@ -3174,15 +3143,6 @@ export declare type EditContentCallback = (
   session: RichtextContentSession | FillContentSession,
 ) => Promise<void> | void;
 
-/**
- * @public
- * A callback for reading and updating the requested design content.
- * @param session - The result of reading the content in the design.
- */
-declare type EditContentCallback_2 = (
-  session: RichtextContentSession,
-) => Promise<void> | void;
-
 /**
  * @beta
  * Options for configuring how the design content is read.
@@ -3194,31 +3154,20 @@ export declare type EditContentOptions = {
   contentType: ContentType;
 } & ContextOptions;
 
-/**
- * @public
- * Options for configuring how the design content is read.
- */
-declare type EditContentOptions_2 = {
-  /**
-   * The type of content to edit from the user's design
-   */
-  contentType: ContentType_2;
-} & ContextOptions;
-
 /**
  * @public
  * Elements targeting a cursor are a subset of the base Element
  **/
-export declare type ElementAtCursor =
+declare type ElementAtCursor =
   | ImageElement
-  | VideoElement
+  | VideoElement_2
   | EmbedElement
   | TextElement
   | RichtextElement
   | TableElement;
 
 /**
- * @public
+ * @beta
  * An element that's natively supported by the Canva editor and has positional properties.
  */
 export declare type ElementAtPoint =
@@ -3230,11 +3179,24 @@ export declare type ElementAtPoint =
   | GroupElementAtPoint
   | RichtextElementAtPoint;
 
+/**
+ * @public
+ * An element that's natively supported by the Canva editor and has positional properties.
+ */
+declare type ElementAtPoint_2 =
+  | ImageElementAtPoint
+  | VideoElementAtPoint_2
+  | EmbedElementAtPoint
+  | TextElementAtPoint
+  | ShapeElementAtPoint
+  | GroupElementAtPoint
+  | RichtextElementAtPoint;
+
 /**
  * @public
  * Embed element to be added to the design at the end of a drag event.
  */
-export declare type EmbedDragConfig = {
+declare type EmbedDragConfig = {
   /**
    * The type of element.
    */
@@ -3260,7 +3222,7 @@ export declare type EmbedDragConfig = {
  * @public
  * An element that renders rich media, such as a YouTube video.
  */
-export declare type EmbedElement = {
+declare type EmbedElement = {
   /**
    * The type of element.
    */
@@ -3278,7 +3240,7 @@ export declare type EmbedElement = {
  * @public
  * An element that renders rich media, such as a YouTube video, and has positional properties.
  */
-export declare type EmbedElementAtPoint = EmbedElement &
+declare type EmbedElementAtPoint = EmbedElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -3286,7 +3248,7 @@ export declare type EmbedElementAtPoint = EmbedElement &
  * @public
  * The result when a user abandons the export flow, such as by closing the export menu.
  */
-export declare type ExportAborted = {
+declare type ExportAborted = {
   /**
    * The status of the export flow.
    */
@@ -3297,47 +3259,13 @@ export declare type ExportAborted = {
  * @public
  * The exported file.
  */
-export declare type ExportBlob = {
+declare type ExportBlob = {
   /**
    * The URL of the exported design.
    *
    * @remarks
    * If a user's design contains multiple pages but is exported in a format that doesn't support multiple pages,
-   * this URL will point to a ZIP file that contains each page as a separate file.
-   *
-   * For example:
-   *
-   * - If a single-page design is exported as a JPG, the URL will point to a JPG file.
-   * - If a multi-page design is exported as a JPG, the URL will point to a ZIP file that contains a JPG file for each page.
-   * - If a multi-page design is exported as a PDF file, the URL will point to a PDF file.
-   *
-   * The following file types support multiple pages:
-   *
-   * - `"GIF"`
-   * - `"PDF_STANDARD"`
-   * - `"PPTX"`
-   * - `"VIDEO"`
-   *
-   * The following file types do not support multiple pages:
-   *
-   * - `"JPG"`
-   * - `"PNG"`
-   * - `"SVG"`
-   */
-  url: string;
-};
-
-/**
- * @beta
- * The exported file.
- */
-export declare type ExportBlobWithZippedOptionOutput = {
-  /**
-   * The URL of the exported design.
-   *
-   * @remarks
-   * If a user's design contains multiple pages but is exported in a format that doesn't support multiple pages,
-   * by defaultthis URL will point to a ZIP file that contains each page as a separate file.
+   * by default this URL will point to a ZIP file that contains each page as a separate file.
    *
    * If the user has configured the export to not zip the exported files (using the `zipped` property), this URL will point to a single file.
    *
@@ -3369,30 +3297,7 @@ export declare type ExportBlobWithZippedOptionOutput = {
  * @public
  * The result when a user successfully completes an export flow.
  */
-export declare type ExportCompleted = {
-  /**
-   * The status of the export flow.
-   */
-  status: "completed";
-  /**
-   * The title of the design, if set by the user.
-   */
-  title?: string;
-  /**
-   * The exported files.
-   *
-   * @remarks
-   * This array only contains one element. This is because, if a multi-page design is exported as multiple files, the files
-   * are exported in a ZIP file. In the future, there'll be an option for each file to be a separate element in the array.
-   */
-  exportBlobs: ExportBlob[];
-};
-
-/**
- * @beta
- * The result when a user successfully completes an export flow.
- */
-export declare type ExportCompletedWithZippedOptionOutput = {
+declare type ExportCompleted = {
   /**
    * The status of the export flow.
    */
@@ -3407,14 +3312,14 @@ export declare type ExportCompletedWithZippedOptionOutput = {
    * @remarks
    * This array can contain a single link either to a file or a ZIP, or multiple links to individual files.
    */
-  exportBlobs: ExportBlobWithZippedOptionOutput[];
+  exportBlobs: ExportBlob[];
 };
 
 /**
  * @public
  * The types of files that Canva supports for exported designs.
  */
-export declare type ExportFileType =
+declare type ExportFileType =
   | "png"
   | "jpg"
   | "pdf_standard"
@@ -3424,10 +3329,10 @@ export declare type ExportFileType =
   | "svg";
 
 /**
- * @beta
+ * @public
  * Object representation of the supported file types with properties where applicable.
  */
-export declare type ExportFileTypeWithProperties =
+declare type ExportFileTypeWithProperties =
   | {
       type: "pdf_standard" | "pptx";
     }
@@ -3440,21 +3345,7 @@ export declare type ExportFileTypeWithProperties =
  * @public
  * Options for configuring the export of a design.
  */
-export declare type ExportRequest = {
-  /**
-   * The types of files the user can export their design as.
-   *
-   * @remarks
-   * You must provide at least one file type.
-   */
-  acceptedFileTypes: ExportFileType[];
-};
-
-/**
- * @beta
- * Options for configuring the export of a design.
- */
-export declare type ExportRequestWithFileTypeProperties = {
+declare type ExportRequest = {
   /**
    * The types of files the user can export their design as.
    *
@@ -3468,15 +3359,7 @@ export declare type ExportRequestWithFileTypeProperties = {
  * @public
  * The result of exporting a design.
  */
-export declare type ExportResponse = ExportCompleted | ExportAborted;
-
-/**
- * @beta
- * The result of exporting a design.
- */
-export declare type ExportResponseWithZippedOptionOutput =
-  | ExportCompletedWithZippedOptionOutput
-  | ExportAborted;
+declare type ExportResponse = ExportCompleted | ExportAborted;
 
 /**
  * @public
@@ -3485,7 +3368,7 @@ export declare type ExportResponseWithZippedOptionOutput =
  * @remarks
  * This type is only used when the image data is from an external URL.
  */
-export declare type ExternalImageDragConfig = CommonImageDragConfig & {
+declare type ExternalImageDragConfig = CommonImageDragConfig & {
   /**
    * A function that returns a reference (ref) to an audio asset in Canva's backend.
    */
@@ -3509,7 +3392,7 @@ export declare type ExternalImageDragConfig = CommonImageDragConfig & {
  * @remarks
  * The `color` and `asset` properties are mutually exclusive.
  */
-export declare type Fill = {
+declare type Fill = {
   /**
    * If `true`, users can replace a fill by dropping an image or video onto it.
    */
@@ -3534,7 +3417,7 @@ export declare type Fill = {
  * @beta
  * Object for interacting with fill content (images/videos).
  */
-export declare type FillContent =
+declare type FillContent =
   | {
       type: "image";
       /**
@@ -3576,7 +3459,7 @@ export declare type FillContent =
  * @beta
  * Session for reading and updating fill content in a user's design.
  */
-export declare interface FillContentSession {
+declare interface FillContentSession {
   /**
    * Fill content in the design.
    */
@@ -3595,7 +3478,7 @@ export declare interface FillContentSession {
  * @public
  * A reference to a font that can be used in other parts of the SDK.
  */
-export declare type FontRef = string & {
+declare type FontRef = string & {
   __fontRef: never;
 };
 
@@ -3603,7 +3486,7 @@ export declare type FontRef = string & {
  * @public
  * Font weights supported in the SDK.
  **/
-export declare type FontWeight =
+declare type FontWeight =
   | "normal"
   | "thin"
   | "extralight"
@@ -3732,7 +3615,7 @@ export declare const getDesignMetadata: () => Promise<DesignMetadata>;
 export declare const getDesignToken: () => Promise<DesignToken>;
 
 /**
- * @public
+ * @beta
  * An element that's natively supported by the Canva editor, can exist within a group, and has positional properties.
  */
 export declare type GroupContentAtPoint = Exclude<
@@ -3740,11 +3623,20 @@ export declare type GroupContentAtPoint = Exclude<
   GroupElementAtPoint
 >;
 
+/**
+ * @public
+ * An element that's natively supported by the Canva editor, can exist within a group, and has positional properties.
+ */
+declare type GroupContentAtPoint_2 = Exclude<
+  ElementAtPoint_2,
+  GroupElementAtPoint
+>;
+
 /**
  * @public
  * An element that contains two or more elements.
  */
-export declare type GroupElement = {
+declare type GroupElement = {
   /**
    * The type of element.
    */
@@ -3756,14 +3648,14 @@ export declare type GroupElement = {
    * - Each element within a group must have dimensions and a position.
    * - The dimensions and positions are relative to the dimensions and positions of the group.
    */
-  children: GroupContentAtPoint[];
+  children: GroupContentAtPoint_2[];
 };
 
 /**
  * @public
  * An element that contains two or more elements and has positional properties.
  */
-export declare type GroupElementAtPoint = GroupElement &
+declare type GroupElementAtPoint = GroupElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -3790,13 +3682,13 @@ declare type Height = {
  * @public
  * Image element or content to be added to the design at the end of a drag event.
  */
-export declare type ImageDragConfig = ExternalImageDragConfig;
+declare type ImageDragConfig = ExternalImageDragConfig;
 
 /**
  * @public
  * Image element or content to be added to the design at the end of a drag event.
  */
-export declare type ImageDragConfigForElement<E extends Element> =
+declare type ImageDragConfigForElement<E extends Element> =
   E extends HTMLImageElement
     ? Partial<ImageDragConfig> & Pick<ImageDragConfig, "type">
     : ImageDragConfig;
@@ -3805,7 +3697,7 @@ export declare type ImageDragConfigForElement<E extends Element> =
  * @public
  * An element that renders image content.
  */
-export declare type ImageElement = {
+declare type ImageElement = {
   /**
    * The type of element.
    */
@@ -3844,7 +3736,7 @@ export declare type ImageElement = {
  * @public
  * An element that renders image content and has positional properties.
  */
-export declare type ImageElementAtPoint = ImageElement &
+declare type ImageElementAtPoint = ImageElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -3852,7 +3744,7 @@ export declare type ImageElementAtPoint = ImageElement &
  * @public
  * An image asset that fills a path's interior.
  */
-export declare type ImageFill = {
+declare type ImageFill = {
   /**
    * The type of fill.
    */
@@ -3874,12 +3766,12 @@ export declare type ImageFill = {
  * @public
  * A unique identifier that references an image asset in Canva's backend.
  */
-export declare type ImageRef = string & {
+declare type ImageRef = string & {
   __imageRef: never;
 };
 
 /**
- * @public
+ * @beta
  * @param appElementConfig - Configuration for an AppElementClient
  *
  * @example Initialize app element client
@@ -3924,7 +3816,7 @@ export declare const initAppElement: <A extends AppElementData>(
  * @public
  * Options for formatting inline richtext.
  */
-export declare type InlineFormatting = {
+declare type InlineFormatting = {
   /**
    * The color of the text as a hex code.
    *
@@ -3970,34 +3862,22 @@ export declare type InlineFormatting = {
  * @public
  * An element that's natively supported by the Canva editor.
  */
-export declare type NativeElement =
+declare type NativeElement =
   | NativeImageElement
-  | NativeVideoElement
+  | NativeVideoElement_2
   | NativeEmbedElement
   | NativeTextElement
   | NativeShapeElement
   | NativeGroupElement;
 
-/**
- * @deprecated
- * @public
- * The types of elements an app can add to a user's design.
- */
-export declare type NativeElementType =
-  | "image"
-  | "embed"
-  | "text"
-  | "shape"
-  | "video";
-
 /**
  * @deprecated The type has been superseded by `ElementAtPoint`.
  * @public
  * An element that's natively supported by the Canva editor and has positional properties.
  */
-export declare type NativeElementWithBox =
+declare type NativeElementWithBox =
   | NativeImageElementWithBox
-  | NativeVideoElementWithBox
+  | NativeVideoElementWithBox_2
   | NativeEmbedElementWithBox
   | NativeTextElementWithBox
   | NativeShapeElementWithBox
@@ -4008,92 +3888,99 @@ export declare type NativeElementWithBox =
  * @public
  * An element that renders rich media, such as a YouTube video.
  */
-export declare type NativeEmbedElement = EmbedElement;
+declare type NativeEmbedElement = EmbedElement;
 
 /**
  * @deprecated The type has been superseded by `EmbedElementAtPoint`.
  * @public
  * An element that renders rich media, such as a YouTube video, and has positional properties.
  */
-export declare type NativeEmbedElementWithBox = EmbedElementAtPoint;
+declare type NativeEmbedElementWithBox = EmbedElementAtPoint;
 
 /**
  * @deprecated The type has been superseded by `GroupElement`.
  * @public
  * An element that contains two or more elements.
  */
-export declare type NativeGroupElement = GroupElement;
+declare type NativeGroupElement = GroupElement;
 
 /**
  * @deprecated The type has been superseded by `GroupElementAtPoint`.
  * @public
  * An element that contains two or more elements and has positional properties.
  */
-export declare type NativeGroupElementWithBox = GroupElementAtPoint;
+declare type NativeGroupElementWithBox = GroupElementAtPoint;
 
 /**
  * @deprecated The type has been superseded by `ImageElement`.
  * @public
  * An element that renders image content.
  */
-export declare type NativeImageElement = ImageElement;
+declare type NativeImageElement = ImageElement;
 
 /**
  * @deprecated The type has been superseded by `ImageElementAtPoint`.
  * @public
  * An element that renders image content and has positional properties.
  */
-export declare type NativeImageElementWithBox = ImageElementAtPoint;
+declare type NativeImageElementWithBox = ImageElementAtPoint;
 
 /**
  * @deprecated The type has been superseded by `ShapeElement`.
  * @public
  * An element that renders a vector shape.
  */
-export declare type NativeShapeElement = ShapeElement;
+declare type NativeShapeElement = ShapeElement;
 
 /**
  * @deprecated The type has been superseded by `ShapeElementAtPoint`.
  * @public
  * An element that renders a vector shape and has positional properties.
  */
-export declare type NativeShapeElementWithBox = ShapeElementAtPoint;
-
-/**
- * @deprecated The type has been superseded by `GroupContentAtPoint`.
- * @public
- * An element that's natively supported by the Canva editor, can exist within a group, and has positional properties.
- */
-export declare type NativeSimpleElementWithBox = GroupContentAtPoint;
+declare type NativeShapeElementWithBox = ShapeElementAtPoint;
 
 /**
  * @deprecated The type has been superseded by `TextElement`.
  * @public
  * An element that renders text content.
  */
-export declare type NativeTextElement = TextElement;
+declare type NativeTextElement = TextElement;
 
 /**
  * @deprecated The type has been superseded by `TextElementAtPoint`.
  * @public
  * An element that renders text content and has positional properties.
  */
-export declare type NativeTextElementWithBox = TextElementAtPoint;
+declare type NativeTextElementWithBox = TextElementAtPoint;
 
 /**
  * @deprecated The type has been superseded by `VideoElement`.
- * @public
+ * @beta
  * An element that renders video content.
  */
 export declare type NativeVideoElement = VideoElement;
 
 /**
- * @deprecated The type has been superseded by `VideoElementAtPoint`.
+ * @deprecated The type has been superseded by `VideoElement`.
  * @public
+ * An element that renders video content.
+ */
+declare type NativeVideoElement_2 = VideoElement_2;
+
+/**
+ * @deprecated The type has been superseded by `VideoElementAtPoint`.
+ * @beta
  * An element that renders video content and has positional properties.
  */
 export declare type NativeVideoElementWithBox = VideoElementAtPoint;
 
+/**
+ * @deprecated The type has been superseded by `VideoElementAtPoint`.
+ * @public
+ * An element that renders video content and has positional properties.
+ */
+declare type NativeVideoElementWithBox_2 = VideoElementAtPoint_2;
+
 /**
  * An object primitive data type that can be used in app element data.
  */
@@ -4127,7 +4014,7 @@ export declare const overlay: DesignOverlay;
  * @public
  * Information about whether or not an overlay can be opened for the specified target.
  */
-export declare type OverlayOpenableEvent<Target extends OverlayTarget> = {
+declare type OverlayOpenableEvent<Target extends OverlayTarget> = {
   /**
    * Information about whether or not an overlay can be opened or not for a selected image.
    */
@@ -4158,7 +4045,7 @@ export declare type OverlayOpenableEvent<Target extends OverlayTarget> = {
  * @public
  * An entity that an overlay can be opened for.
  */
-export declare type OverlayTarget = "image_selection";
+declare type OverlayTarget = "image_selection";
 
 /**
  * @public
@@ -4179,13 +4066,13 @@ declare type OverlayUnopenableEvent = {
  * @public
  * The appearance of a page's background.
  */
-export declare type PageBackgroundFill = Pick<Fill, "asset" | "color">;
+declare type PageBackgroundFill = Pick<Fill, "asset" | "color">;
 
 /**
  * @public
  * Information about a page.
  */
-export declare type PageContext = {
+declare type PageContext = {
   /**
    * The dimensions of the page, in pixels.
    *
@@ -4199,7 +4086,7 @@ export declare type PageContext = {
  * @public
  * A set of page dimensions, in pixels.
  */
-export declare type PageDimensions = {
+declare type PageDimensions = {
   /**
    * The width of the page, in pixels.
    */
@@ -4214,7 +4101,7 @@ export declare type PageDimensions = {
  * @public
  * Information about a page.
  */
-export declare type PageMetadata = {
+declare type PageMetadata = {
   /**
    * The dimensions of the page, in pixels.
    *
@@ -4228,7 +4115,7 @@ export declare type PageMetadata = {
  * @public
  * The outline of a path.
  */
-export declare type PathStroke = {
+declare type PathStroke = {
   /**
    * The weight (thickness) of the stroke.
    *
@@ -4257,7 +4144,7 @@ export declare type PathStroke = {
  * @public
  * A position, set of dimensions, and rotation.
  */
-export declare type Placement = Point & (WidthAndHeight | Width | Height);
+declare type Placement = Point & (WidthAndHeight | Width | Height);
 
 /**
  * A position and rotation.
@@ -4300,19 +4187,19 @@ declare type Point = {
 declare type Primitive = undefined | null | number | boolean | string;
 
 /**
- * @beta
+ * @public
  * Exports the user's design as one or more static files.
  * @param request - The request object containing configurations of the design export.
  */
 export declare const requestExport: (
-  request: ExportRequestWithFileTypeProperties,
-) => Promise<ExportResponseWithZippedOptionOutput>;
+  request: ExportRequest,
+) => Promise<ExportResponse>;
 
 /**
  * @public
  * Provides methods for interacting with a range of formatted text.
  */
-export declare interface RichtextContentRange extends RichtextRange {
+declare interface RichtextContentRange extends RichtextRange {
   /**
    * Indicates whether the object containing this richtext range has been deleted.
    */
@@ -4400,7 +4287,7 @@ export declare interface RichtextContentRange extends RichtextRange {
  * );
  * ```
  */
-export declare interface RichtextContentSession {
+declare interface RichtextContentSession {
   /**
    * Richtext content in the design.
    */
@@ -4443,7 +4330,7 @@ export declare interface RichtextContentSession {
  * @public
  * An element that renders richtext content.
  */
-export declare type RichtextElement = {
+declare type RichtextElement = {
   /**
    * The type of element.
    */
@@ -4464,13 +4351,13 @@ export declare type RichtextElement = {
  * It will be positioned and sized relative to its parent container.
  * The parent container may be an app element, or the current page.
  */
-export declare type RichtextElementAtPoint = RichtextElement & TextBox;
+declare type RichtextElementAtPoint = RichtextElement & TextBox;
 
 /**
  * @public
  * Options for formatting richtext.
  */
-export declare type RichtextFormatting = InlineFormatting & {
+declare type RichtextFormatting = InlineFormatting & {
   /**
    * @public
    * A unique identifier that points to a font asset in Canva's backend.
@@ -4518,7 +4405,7 @@ export declare type RichtextFormatting = InlineFormatting & {
  * @public
  * Provides methods for interacting with a range of formatted text.
  */
-export declare type RichtextRange = {
+declare type RichtextRange = {
   /**
    * Formats all of the paragraphs that overlap the given bounds.
    *
@@ -4802,7 +4689,7 @@ export declare const selection: DesignSelection;
  * @public
  * Information about the user's selection. To access the selected content, call the `read` method.
  */
-export declare interface SelectionEvent<Scope extends SelectionScope> {
+declare interface SelectionEvent<Scope extends SelectionScope> {
   /**
    * The type of content that's selected.
    */
@@ -4888,7 +4775,7 @@ export declare interface SelectionEvent<Scope extends SelectionScope> {
  * @public
  * Information about a user's selection.
  */
-export declare interface SelectionEvent<Scope extends SelectionScope> {
+declare interface SelectionEvent<Scope extends SelectionScope> {
   /**
    * The type of content.
    */
@@ -4910,11 +4797,7 @@ export declare interface SelectionEvent<Scope extends SelectionScope> {
  * @public
  * A type of content that supports selection events.
  */
-export declare type SelectionScope =
-  | "plaintext"
-  | "image"
-  | "video"
-  | "richtext";
+declare type SelectionScope = "plaintext" | "image" | "video" | "richtext";
 
 /**
  * @public
@@ -4923,7 +4806,7 @@ export declare type SelectionScope =
  * @remarks
  * The available properties depend on the type (scope) of content.
  */
-export declare type SelectionValue<Scope extends SelectionScope> = {
+declare type SelectionValue<Scope extends SelectionScope> = {
   /**
    * A selected range of plaintext.
    */
@@ -5020,7 +4903,7 @@ export declare const setCurrentPageBackground: (
  * @public
  * An element that renders a vector shape.
  */
-export declare type ShapeElement = {
+declare type ShapeElement = {
   /**
    * The type of element.
    */
@@ -5044,7 +4927,7 @@ export declare type ShapeElement = {
  * @public
  * An element that renders a vector shape and has positional properties.
  */
-export declare type ShapeElementAtPoint = ShapeElement &
+declare type ShapeElementAtPoint = ShapeElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -5052,7 +4935,7 @@ export declare type ShapeElementAtPoint = ShapeElement &
  * @public
  * A path that defines the structure of a shape element.
  */
-export declare type ShapePath = {
+declare type ShapePath = {
   /**
    * The shape of the path.
    *
@@ -5084,7 +4967,7 @@ export declare type ShapePath = {
  * @remarks
  * This is similar to the `viewBox` attribute of an `SVGElement`.
  */
-export declare type ShapeViewBox = {
+declare type ShapeViewBox = {
   /**
    * The distance of the shape from the top edge of the element, in pixels.
    */
@@ -5107,7 +4990,7 @@ export declare type ShapeViewBox = {
  * @public
  * An element that renders a table.
  */
-export declare type TableElement = {
+declare type TableElement = {
   /**
    * The type of element.
    */
@@ -5130,7 +5013,7 @@ export declare type TableElement = {
  * @public
  * Options for configuring the appearance of text.
  */
-export declare type TextAttributes = {
+declare type TextAttributes = {
   /**
    * The size of the text.
    *
@@ -5197,7 +5080,7 @@ declare type TextBox = Point & {
  * @public
  * Text element or content to be added to the design at the end of a drag event.
  */
-export declare type TextDragConfig = {
+declare type TextDragConfig = {
   /**
    * The type of element.
    */
@@ -5237,7 +5120,7 @@ export declare type TextDragConfig = {
  * @public
  * An element that renders text content.
  */
-export declare type TextElement = {
+declare type TextElement = {
   /**
    * The type of element.
    */
@@ -5255,13 +5138,13 @@ export declare type TextElement = {
  * @public
  * An element that renders text content and has positional properties.
  */
-export declare type TextElementAtPoint = TextElement & TextBox;
+declare type TextElementAtPoint = TextElement & TextBox;
 
 /**
  * @public
  * A region of richtext.
  */
-export declare type TextRegion = {
+declare type TextRegion = {
   /**
    * The plaintext content of the region.
    */
@@ -5276,7 +5159,7 @@ export declare type TextRegion = {
  * @public
  * Provides methods for adding drag and drop behavior to an app.
  */
-export declare interface UI {
+declare interface UI {
   /**
    * @deprecated The method has been superseded by `startDragToPoint`.
    * @public
@@ -5336,7 +5219,7 @@ export declare const ui: UI;
  * @public
  * A data type that can be used in app element data.
  */
-export declare type Value =
+declare type Value =
   | Primitive
   | ObjectPrimitive
   | Exclude<Value, undefined>[]
@@ -5348,7 +5231,7 @@ export declare type Value =
  * @public
  * Video element or content to be added to the design at the end of a drag event.
  */
-export declare type VideoDragConfig = {
+declare type VideoDragConfig = {
   /**
    * The type of element.
    */
@@ -5381,17 +5264,32 @@ export declare type VideoDragConfig = {
  * @public
  * Video element or content to be added to the design at the end of a drag event.
  */
-export declare type VideoDragConfigForElement<E extends Element> =
+declare type VideoDragConfigForElement<E extends Element> =
   E extends HTMLImageElement
     ? Partial<VideoDragConfig> &
         Pick<VideoDragConfig, "type" | "resolveVideoRef">
     : VideoDragConfig;
 
+/**
+ * @beta
+ * An element that renders video content.
+ */
+export declare type VideoElement = VideoElement_2 & {
+  /**
+   * Options for configuring the cropping of the video.
+   */
+  imageBox?: VideoImageBox;
+  /**
+   * Options for configuring the start, and end of the video.
+   */
+  trim?: VideoTrim;
+};
+
 /**
  * @public
  * An element that renders video content.
  */
-export declare type VideoElement = {
+declare type VideoElement_2 = {
   /**
    * The type of element.
    */
@@ -5409,11 +5307,26 @@ export declare type VideoElement = {
   altText: AltText | undefined;
 };
 
+/**
+ * @beta
+ * An element that renders video content and has positional properties.
+ */
+export declare type VideoElementAtPoint = VideoElementAtPoint_2 & {
+  /**
+   * Options for configuring the cropping of the video.
+   */
+  imageBox?: VideoImageBox;
+  /**
+   * Options for configuring the start, and end of the video.
+   */
+  trim?: VideoTrim;
+};
+
 /**
  * @public
  * An element that renders video content and has positional properties.
  */
-export declare type VideoElementAtPoint = VideoElement &
+declare type VideoElementAtPoint_2 = VideoElement_2 &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -5421,7 +5334,7 @@ export declare type VideoElementAtPoint = VideoElement &
  * @public
  * A video asset that fills a path's interior.
  */
-export declare type VideoFill = {
+declare type VideoFill = {
   /**
    * The type of fill.
    */
@@ -5439,14 +5352,52 @@ export declare type VideoFill = {
   altText?: AltText;
 };
 
+/**
+ * @beta
+ * Options for configuring the visible portion of a video.
+ */
+export declare type VideoImageBox = {
+  /**
+   * The distance of the image box from the top edge of the video, in pixels.
+   */
+  top: number;
+  /**
+   * The distance of the image box from the left edge of the video, in pixels.
+   */
+  left: number;
+  /**
+   * The width of the image box, in pixels.
+   */
+  width: number;
+  /**
+   * The height of the image box, in pixels.
+   */
+  height: number;
+};
+
 /**
  * @public
  * A unique identifier that references a video asset in Canva's backend.
  */
-export declare type VideoRef = string & {
+declare type VideoRef = string & {
   __videoRef: never;
 };
 
+/**
+ * @beta
+ * Options for configuring the start and end points for video playback.
+ */
+export declare type VideoTrim = {
+  /**
+   * The start point of the video, in milliseconds relative to the start of the source video.
+   */
+  startMs: number;
+  /**
+   * The end point of the video, in milliseconds relative to the start of the source video.
+   */
+  endMs: number;
+};
+
 /**
  * A set of dimensions with an auto-calculated height.
  */
@@ -5491,7 +5442,7 @@ declare type WidthAndHeight = {
 };
 
 /**
- * @beta
+ * @public
  * The behavior of zipping the exported files.
  *
  * @remarks
@@ -5504,6 +5455,6 @@ declare type WidthAndHeight = {
  * - `auto` or `never` (default): Files are never zipped together, regardless of count.
  * - `always`: Files are always zipped into a single file.
  */
-export declare type ZipBehavior = "auto" | "always" | "never";
+declare type ZipBehavior = "auto" | "always" | "never";
 
 export {};

package/lib/cjs/sdk/design/beta.js

@@ -9,14 +9,20 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    get addElementAtPoint () {
+        return addElementAtPoint;
+    },
+    get addPage () {
+        return addPage;
+    },
     get editContent () {
         return editContent;
     },
+    get initAppElement () {
+        return initAppElement;
+    },
     get openDesign () {
         return openDesign;
-    },
-    get requestExport () {
-        return requestExport;
     }
 });
 const _version = require("./version");
@@ -39,6 +45,7 @@ function editContent(options, callback) {
     return canva_sdk.design.v2.designInteraction.editContent(options, (session)=>callback(session));
 }
 const openDesign = canva_sdk.design.v2.designInteraction.openDesign;
-const requestExport = canva_sdk.design.v2.export.requestExport;
+const addElementAtPoint = canva_sdk.design.v2.designInteraction.addElementAtPoint;
+const initAppElement = canva_sdk.design.v2.designInteraction.initAppElement;
+const addPage = canva_sdk.design.v2.designInteraction.addPage;
 window.__canva__?.sdkRegistration?.registerPackageVersion('design', _version.LATEST_VERSION, 'beta');
-'comment';

package/lib/esm/sdk/design/beta.js

@@ -4,7 +4,8 @@ export function editContent(options, callback) {
     return canva_sdk.design.v2.designInteraction.editContent(options, (session)=>callback(session));
 }
 export const openDesign = canva_sdk.design.v2.designInteraction.openDesign;
-export const requestExport = canva_sdk.design.v2.export.requestExport;
+export const addElementAtPoint = canva_sdk.design.v2.designInteraction.addElementAtPoint;
+export const initAppElement = canva_sdk.design.v2.designInteraction.initAppElement;
+export const addPage = canva_sdk.design.v2.designInteraction.addPage;
 export * from './public';
 window.__canva__?.sdkRegistration?.registerPackageVersion('design', LATEST_VERSION, 'beta');
-'comment';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canva/design",
-  "version": "2.7.4-beta.2",
+  "version": "2.7.5-beta.0",
   "description": "The Canva Apps SDK design library",
   "author": "Canva Pty Ltd.",
   "license": "SEE LICENSE IN LICENSE.md FILE",