@canva/design 2.7.5-beta.1 → 2.7.6-beta.0

package/beta.d.ts

@@ -133,7 +133,7 @@ export declare const addElementAtCursor: (
 ) => Promise<void>;
 
 /**
- * @beta
+ * @public
  * 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>;
 
 /**
- * @beta
+ * @public
  * Adds a new page immediately after the currently selected page.
  * @param opts - Configuration for the new page to be added.
  *
@@ -336,23 +336,43 @@ export declare const addNativeElement: (
  *   ]
  * });
  * ```
+ *
+ * @example Create page with custom dimensions
+ * ```typescript
+ * import { addPage } from "@canva/design";
+ *
+ * await addPage({
+ *   dimensions: {
+ *      width: 300,
+ *      height: 300,
+ *   },
+ * });
+ * ```
  */
 export declare const addPage: (opts?: {
-  /**  Elements to be added to the page */
+  /**  Elements to be added to the page. */
   elements?: ElementAtPoint[];
-  /**
-   * The page background. This can be a solid color, an image or a video.
-   **/
+  /**  The page background. This can be a solid color, an image or a video. */
   background?: PageBackgroundFill;
   /**  A page title which must be no longer than 255 characters */
   title?: string;
+  /**
+   * The optional custom dimensions in pixels for the new page. The following constraints apply:
+   * - `width` and `height` cannot be lower than 40 or higher than 8000
+   * - The total area of the new page cannot exceed 25_000_000
+   * In case this is not specified, the default dimensions for the design type will be used.
+   */
+  dimensions?: {
+    width: number;
+    height: number;
+  };
 }) => Promise<void>;
 
 /**
  * @public
  * Alternative text for a11y compliance.
  */
-declare type AltText = {
+export declare type AltText = {
   /**
    * The text content.
    */
@@ -438,7 +458,7 @@ declare type AltText = {
  * });
  * ```
  */
-declare type AppElementChangeHandler<A extends AppElementData> = (
+export declare type AppElementChangeHandler<A extends AppElementData> = (
   appElement:
     | {
         /**
@@ -510,7 +530,7 @@ declare type AppElementChangeHandler<A extends AppElementData> = (
  * @public
  * A client that provides methods for creating and managing the lifecycle of an app element.
  */
-declare interface AppElementClient<A extends AppElementData> {
+export 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 +764,7 @@ declare interface AppElementClient<A extends AppElementData> {
 }
 
 /**
- * @beta
+ * @public
  * Options for creating an app element client.
  */
 export declare type AppElementClientConfiguration<A extends AppElementData> = {
@@ -758,14 +778,14 @@ export declare type AppElementClientConfiguration<A extends AppElementData> = {
  * @public
  * The data associated with an app element.
  */
-declare type AppElementData = Record<string, Value>;
+export 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).
  */
-declare type AppElementOptions<A extends AppElementData> = {
+export declare type AppElementOptions<A extends AppElementData> = {
   /**
    * The data to attach to the app element.
    */
@@ -777,7 +797,7 @@ declare type AppElementOptions<A extends AppElementData> = {
 };
 
 /**
- * @beta
+ * @public
  * 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 +806,7 @@ export declare type AppElementRenderer<A extends AppElementData> = (
 ) => AppElementRendererOutput;
 
 /**
- * @beta
+ * @public
  * An array of one or more elements to render as output of an app element.
  */
 export declare type AppElementRendererOutput = GroupContentAtPoint[];
@@ -795,7 +815,7 @@ export declare type AppElementRendererOutput = GroupContentAtPoint[];
  * @public
  * A unique identifier that references an app runtime process
  */
-declare type AppProcessId = string & {
+export declare type AppProcessId = string & {
   __appProcessId: never;
 };
 
@@ -803,7 +823,7 @@ declare type AppProcessId = string & {
  * @public
  * Audio track to be added to the design at the end of a drag event.
  */
-declare type AudioDragConfig = {
+export declare type AudioDragConfig = {
   /**
    * The type of element.
    */
@@ -828,7 +848,7 @@ declare type AudioDragConfig = {
  * @public
  * A unique identifier that references an audio asset in Canva's backend.
  */
-declare type AudioRef = string & {
+export declare type AudioRef = string & {
   __audioRef: never;
 };
 
@@ -836,7 +856,7 @@ declare type AudioRef = string & {
  * @public
  * An audio track that can be added to a design.
  */
-declare type AudioTrack = {
+export declare type AudioTrack = {
   /**
    * A unique identifier that points to an audio asset in Canva's backend.
    */
@@ -847,7 +867,7 @@ declare type AudioTrack = {
  * @public
  * A segment of a richtext range.
  */
-declare type Bounds = {
+export declare type Bounds = {
   /**
    * The starting position of the segment.
    *
@@ -861,6 +881,16 @@ 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);
+
 /**
  * @beta
  * An alias for the BulkCreateLauncher interface, providing access to bulk create related functionality
@@ -895,7 +925,7 @@ export declare type BulkCreateLauncher = {
  * @public
  * An individual cell in a table element.
  */
-declare type Cell = {
+export declare type Cell = {
   /**
    * The attributes of the cell.
    */
@@ -965,7 +995,7 @@ declare type CommonImageDragConfig = {
  * @public
  * A snapshot of content from a user's design.
  */
-declare interface ContentDraft<T> {
+export declare interface ContentDraft<T> {
   /**
    * The individual content items that exist within the snapshot.
    *
@@ -1040,10 +1070,16 @@ 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
  */
-declare type ContentTypeMap = {
+export declare type ContentTypeMap = {
   richtext: RichtextContentSession;
   fill: FillContentSession;
 };
@@ -1052,10 +1088,25 @@ declare type ContentTypeMap = {
  * @public
  * Options for configuring where content in a design should be queried from.
  */
-declare type ContextOptions = {
+export 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.
@@ -2774,7 +2825,7 @@ export declare namespace DesignEditing {
 }
 
 /**
- * @beta
+ * @public
  * An element that's natively supported by the Canva editor.
  */
 export declare type DesignElement =
@@ -2791,7 +2842,7 @@ export declare type DesignElement =
  * @public
  * Information about the design.
  */
-declare type DesignMetadata = {
+export declare type DesignMetadata = {
   /**
    * The title of the user's design.
    * @remarks
@@ -2905,7 +2956,7 @@ export declare type DesignOpenPageCallback<
  * @public
  * Provides methods for managing the lifecycle of overlays, such as selected image overlays.
  */
-declare type DesignOverlay = {
+export declare type DesignOverlay = {
   /**
    * Registers a callback that runs when the `canOpen` state of an overlay target changes.
    * @param opts - Options for configuring the callback.
@@ -3005,7 +3056,7 @@ declare type DesignOverlay = {
  * @public
  * Provides methods for interacting with selected content.
  */
-declare type DesignSelection = {
+export declare type DesignSelection = {
   /**
    * Registers a callback that runs when the specified type of content is selected.
    *
@@ -3092,7 +3143,7 @@ declare type DesignSelection = {
  * @public
  * JWT that contains the Design ID and App ID.
  */
-declare type DesignToken = {
+export declare type DesignToken = {
   token: string;
 };
 
@@ -3100,7 +3151,7 @@ declare type DesignToken = {
  * @public
  * A set of dimensions.
  */
-declare type Dimensions = {
+export declare type Dimensions = {
   /**
    * A width, in pixels.
    */
@@ -3115,7 +3166,7 @@ declare type Dimensions = {
  * @public
  * An event that occurs when a user starts dragging an HTML element.
  */
-declare type DragStartEvent<E extends Element> = Pick<
+export declare type DragStartEvent<E extends Element> = Pick<
   DragEvent,
   "dataTransfer" | "currentTarget" | "preventDefault" | "clientX" | "clientY"
 > & {
@@ -3173,6 +3224,15 @@ 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.
@@ -3184,20 +3244,31 @@ 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
  **/
-declare type ElementAtCursor =
+export declare type ElementAtCursor =
   | ImageElement
-  | VideoElement_2
+  | VideoElement
   | EmbedElement
   | TextElement
   | RichtextElement
   | TableElement;
 
 /**
- * @beta
+ * @public
  * An element that's natively supported by the Canva editor and has positional properties.
  */
 export declare type ElementAtPoint =
@@ -3209,24 +3280,11 @@ 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.
  */
-declare type EmbedDragConfig = {
+export declare type EmbedDragConfig = {
   /**
    * The type of element.
    */
@@ -3252,7 +3310,7 @@ declare type EmbedDragConfig = {
  * @public
  * An element that renders rich media, such as a YouTube video.
  */
-declare type EmbedElement = {
+export declare type EmbedElement = {
   /**
    * The type of element.
    */
@@ -3270,7 +3328,7 @@ declare type EmbedElement = {
  * @public
  * An element that renders rich media, such as a YouTube video, and has positional properties.
  */
-declare type EmbedElementAtPoint = EmbedElement &
+export declare type EmbedElementAtPoint = EmbedElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -3278,7 +3336,7 @@ declare type EmbedElementAtPoint = EmbedElement &
  * @public
  * The result when a user abandons the export flow, such as by closing the export menu.
  */
-declare type ExportAborted = {
+export declare type ExportAborted = {
   /**
    * The status of the export flow.
    */
@@ -3289,7 +3347,7 @@ declare type ExportAborted = {
  * @public
  * The exported file.
  */
-declare type ExportBlob = {
+export declare type ExportBlob = {
   /**
    * The URL of the exported design.
    *
@@ -3327,7 +3385,7 @@ declare type ExportBlob = {
  * @public
  * The result when a user successfully completes an export flow.
  */
-declare type ExportCompleted = {
+export declare type ExportCompleted = {
   /**
    * The status of the export flow.
    */
@@ -3349,7 +3407,7 @@ declare type ExportCompleted = {
  * @public
  * The types of files that Canva supports for exported designs.
  */
-declare type ExportFileType =
+export declare type ExportFileType =
   | "png"
   | "jpg"
   | "pdf_standard"
@@ -3362,20 +3420,39 @@ declare type ExportFileType =
  * @public
  * Object representation of the supported file types with properties where applicable.
  */
-declare type ExportFileTypeWithProperties =
-  | {
-      type: "pdf_standard" | "pptx";
-    }
-  | {
-      type: "png" | "jpg" | "video" | "gif" | "svg";
-      zipped?: ZipBehavior;
-    };
+export declare type ExportFileTypeWithProperties =
+  | ExportImageFileType
+  | ExportVideoFileType
+  | ExportPrintFileType;
+
+/**
+ * @public
+ * Supported image file types with properties.
+ *
+ * @remarks
+ * Zip behavior for image file types:
+ * - `auto` (default): Files are zipped together if the design has multiple pages, unzipped if it has one page.
+ * - `always`: Files are always zipped into a single zip file, regardless of page count.
+ * - `never`: Files are never zipped, providing an array of files.
+ */
+export declare type ExportImageFileType = {
+  type: "png" | "jpg" | "svg";
+  zipped?: ZipBehavior;
+};
+
+/**
+ * @public
+ * Supported print file types.
+ */
+export declare type ExportPrintFileType = {
+  type: "pdf_standard" | "pptx";
+};
 
 /**
  * @public
  * Options for configuring the export of a design.
  */
-declare type ExportRequest = {
+export declare type ExportRequest = {
   /**
    * The types of files the user can export their design as.
    *
@@ -3389,7 +3466,21 @@ declare type ExportRequest = {
  * @public
  * The result of exporting a design.
  */
-declare type ExportResponse = ExportCompleted | ExportAborted;
+export declare type ExportResponse = ExportCompleted | ExportAborted;
+
+/**
+ * @public
+ * Supported video file types with properties.
+ *
+ * @remarks
+ * Zip behavior for video file types:
+ * - `auto` or `never` (default): Files are never zipped together, regardless of count.
+ * - `always`: Files are always zipped into a single file.
+ */
+export declare type ExportVideoFileType = {
+  type: "gif" | "video";
+  zipped?: ZipBehavior;
+};
 
 /**
  * @public
@@ -3398,7 +3489,7 @@ declare type ExportResponse = ExportCompleted | ExportAborted;
  * @remarks
  * This type is only used when the image data is from an external URL.
  */
-declare type ExternalImageDragConfig = CommonImageDragConfig & {
+export declare type ExternalImageDragConfig = CommonImageDragConfig & {
   /**
    * A function that returns a reference (ref) to an audio asset in Canva's backend.
    */
@@ -3422,7 +3513,7 @@ declare type ExternalImageDragConfig = CommonImageDragConfig & {
  * @remarks
  * The `color` and `asset` properties are mutually exclusive.
  */
-declare type Fill = {
+export declare type Fill = {
   /**
    * If `true`, users can replace a fill by dropping an image or video onto it.
    */
@@ -3447,7 +3538,7 @@ declare type Fill = {
  * @beta
  * Object for interacting with fill content (images/videos).
  */
-declare type FillContent =
+export declare type FillContent =
   | {
       type: "image";
       /**
@@ -3489,7 +3580,7 @@ declare type FillContent =
  * @beta
  * Session for reading and updating fill content in a user's design.
  */
-declare interface FillContentSession {
+export declare interface FillContentSession {
   /**
    * Fill content in the design.
    */
@@ -3508,7 +3599,7 @@ declare interface FillContentSession {
  * @public
  * A reference to a font that can be used in other parts of the SDK.
  */
-declare type FontRef = string & {
+export declare type FontRef = string & {
   __fontRef: never;
 };
 
@@ -3516,7 +3607,7 @@ declare type FontRef = string & {
  * @public
  * Font weights supported in the SDK.
  **/
-declare type FontWeight =
+export declare type FontWeight =
   | "normal"
   | "thin"
   | "extralight"
@@ -3645,7 +3736,7 @@ export declare const getDesignMetadata: () => Promise<DesignMetadata>;
 export declare const getDesignToken: () => Promise<DesignToken>;
 
 /**
- * @beta
+ * @public
  * An element that's natively supported by the Canva editor, can exist within a group, and has positional properties.
  */
 export declare type GroupContentAtPoint = Exclude<
@@ -3653,20 +3744,11 @@ 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.
  */
-declare type GroupElement = {
+export declare type GroupElement = {
   /**
    * The type of element.
    */
@@ -3678,14 +3760,14 @@ 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_2[];
+  children: GroupContentAtPoint[];
 };
 
 /**
  * @public
  * An element that contains two or more elements and has positional properties.
  */
-declare type GroupElementAtPoint = GroupElement &
+export declare type GroupElementAtPoint = GroupElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -3712,13 +3794,13 @@ declare type Height = {
  * @public
  * Image element or content to be added to the design at the end of a drag event.
  */
-declare type ImageDragConfig = ExternalImageDragConfig;
+export declare type ImageDragConfig = ExternalImageDragConfig;
 
 /**
  * @public
  * Image element or content to be added to the design at the end of a drag event.
  */
-declare type ImageDragConfigForElement<E extends Element> =
+export declare type ImageDragConfigForElement<E extends Element> =
   E extends HTMLImageElement
     ? Partial<ImageDragConfig> & Pick<ImageDragConfig, "type">
     : ImageDragConfig;
@@ -3727,7 +3809,7 @@ declare type ImageDragConfigForElement<E extends Element> =
  * @public
  * An element that renders image content.
  */
-declare type ImageElement = {
+export declare type ImageElement = {
   /**
    * The type of element.
    */
@@ -3766,7 +3848,7 @@ declare type ImageElement = {
  * @public
  * An element that renders image content and has positional properties.
  */
-declare type ImageElementAtPoint = ImageElement &
+export declare type ImageElementAtPoint = ImageElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -3774,7 +3856,7 @@ declare type ImageElementAtPoint = ImageElement &
  * @public
  * An image asset that fills a path's interior.
  */
-declare type ImageFill = {
+export declare type ImageFill = {
   /**
    * The type of fill.
    */
@@ -3796,12 +3878,12 @@ declare type ImageFill = {
  * @public
  * A unique identifier that references an image asset in Canva's backend.
  */
-declare type ImageRef = string & {
+export declare type ImageRef = string & {
   __imageRef: never;
 };
 
 /**
- * @beta
+ * @public
  * @param appElementConfig - Configuration for an AppElementClient
  *
  * @example Initialize app element client
@@ -3846,7 +3928,7 @@ export declare const initAppElement: <A extends AppElementData>(
  * @public
  * Options for formatting inline richtext.
  */
-declare type InlineFormatting = {
+export declare type InlineFormatting = {
   /**
    * The color of the text as a hex code.
    *
@@ -3914,22 +3996,34 @@ export declare type LaunchPublishOpts = {
  * @public
  * An element that's natively supported by the Canva editor.
  */
-declare type NativeElement =
+export declare type NativeElement =
   | NativeImageElement
-  | NativeVideoElement_2
+  | NativeVideoElement
   | 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.
  */
-declare type NativeElementWithBox =
+export declare type NativeElementWithBox =
   | NativeImageElementWithBox
-  | NativeVideoElementWithBox_2
+  | NativeVideoElementWithBox
   | NativeEmbedElementWithBox
   | NativeTextElementWithBox
   | NativeShapeElementWithBox
@@ -3940,98 +4034,91 @@ declare type NativeElementWithBox =
  * @public
  * An element that renders rich media, such as a YouTube video.
  */
-declare type NativeEmbedElement = EmbedElement;
+export 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.
  */
-declare type NativeEmbedElementWithBox = EmbedElementAtPoint;
+export declare type NativeEmbedElementWithBox = EmbedElementAtPoint;
 
 /**
  * @deprecated The type has been superseded by `GroupElement`.
  * @public
  * An element that contains two or more elements.
  */
-declare type NativeGroupElement = GroupElement;
+export 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.
  */
-declare type NativeGroupElementWithBox = GroupElementAtPoint;
+export declare type NativeGroupElementWithBox = GroupElementAtPoint;
 
 /**
  * @deprecated The type has been superseded by `ImageElement`.
  * @public
  * An element that renders image content.
  */
-declare type NativeImageElement = ImageElement;
+export declare type NativeImageElement = ImageElement;
 
 /**
  * @deprecated The type has been superseded by `ImageElementAtPoint`.
  * @public
  * An element that renders image content and has positional properties.
  */
-declare type NativeImageElementWithBox = ImageElementAtPoint;
+export declare type NativeImageElementWithBox = ImageElementAtPoint;
 
 /**
  * @deprecated The type has been superseded by `ShapeElement`.
  * @public
  * An element that renders a vector shape.
  */
-declare type NativeShapeElement = ShapeElement;
+export declare type NativeShapeElement = ShapeElement;
 
 /**
  * @deprecated The type has been superseded by `ShapeElementAtPoint`.
  * @public
  * An element that renders a vector shape and has positional properties.
  */
-declare type NativeShapeElementWithBox = ShapeElementAtPoint;
+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;
 
 /**
  * @deprecated The type has been superseded by `TextElement`.
  * @public
  * An element that renders text content.
  */
-declare type NativeTextElement = TextElement;
+export declare type NativeTextElement = TextElement;
 
 /**
  * @deprecated The type has been superseded by `TextElementAtPoint`.
  * @public
  * An element that renders text content and has positional properties.
  */
-declare type NativeTextElementWithBox = TextElementAtPoint;
-
-/**
- * @deprecated The type has been superseded by `VideoElement`.
- * @beta
- * An element that renders video content.
- */
-export declare type NativeVideoElement = VideoElement;
+export declare type NativeTextElementWithBox = TextElementAtPoint;
 
 /**
  * @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;
+export declare type NativeVideoElement = VideoElement;
 
 /**
  * @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;
+export declare type NativeVideoElementWithBox = VideoElementAtPoint;
 
 /**
  * An object primitive data type that can be used in app element data.
@@ -4066,7 +4153,7 @@ export declare const overlay: DesignOverlay;
  * @public
  * Information about whether or not an overlay can be opened for the specified target.
  */
-declare type OverlayOpenableEvent<Target extends OverlayTarget> = {
+export declare type OverlayOpenableEvent<Target extends OverlayTarget> = {
   /**
    * Information about whether or not an overlay can be opened or not for a selected image.
    */
@@ -4097,7 +4184,7 @@ declare type OverlayOpenableEvent<Target extends OverlayTarget> = {
  * @public
  * An entity that an overlay can be opened for.
  */
-declare type OverlayTarget = "image_selection";
+export declare type OverlayTarget = "image_selection";
 
 /**
  * @public
@@ -4118,13 +4205,13 @@ declare type OverlayUnopenableEvent = {
  * @public
  * The appearance of a page's background.
  */
-declare type PageBackgroundFill = Pick<Fill, "asset" | "color">;
+export declare type PageBackgroundFill = Pick<Fill, "asset" | "color">;
 
 /**
  * @public
  * Information about a page.
  */
-declare type PageContext = {
+export declare type PageContext = {
   /**
    * The dimensions of the page, in pixels.
    *
@@ -4138,7 +4225,7 @@ declare type PageContext = {
  * @public
  * A set of page dimensions, in pixels.
  */
-declare type PageDimensions = {
+export declare type PageDimensions = {
   /**
    * The width of the page, in pixels.
    */
@@ -4153,7 +4240,7 @@ declare type PageDimensions = {
  * @public
  * Information about a page.
  */
-declare type PageMetadata = {
+export declare type PageMetadata = {
   /**
    * The dimensions of the page, in pixels.
    *
@@ -4167,7 +4254,7 @@ declare type PageMetadata = {
  * @public
  * The outline of a path.
  */
-declare type PathStroke = {
+export declare type PathStroke = {
   /**
    * The weight (thickness) of the stroke.
    *
@@ -4196,7 +4283,7 @@ declare type PathStroke = {
  * @public
  * A position, set of dimensions, and rotation.
  */
-declare type Placement = Point & (WidthAndHeight | Width | Height);
+export declare type Placement = Point & (WidthAndHeight | Width | Height);
 
 /**
  * A position and rotation.
@@ -4281,7 +4368,7 @@ export declare const requestExport: (
  * @public
  * Provides methods for interacting with a range of formatted text.
  */
-declare interface RichtextContentRange extends RichtextRange {
+export declare interface RichtextContentRange extends RichtextRange {
   /**
    * Indicates whether the object containing this richtext range has been deleted.
    */
@@ -4369,7 +4456,7 @@ declare interface RichtextContentRange extends RichtextRange {
  * );
  * ```
  */
-declare interface RichtextContentSession {
+export declare interface RichtextContentSession {
   /**
    * Richtext content in the design.
    */
@@ -4412,7 +4499,7 @@ declare interface RichtextContentSession {
  * @public
  * An element that renders richtext content.
  */
-declare type RichtextElement = {
+export declare type RichtextElement = {
   /**
    * The type of element.
    */
@@ -4433,13 +4520,13 @@ 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.
  */
-declare type RichtextElementAtPoint = RichtextElement & TextBox;
+export declare type RichtextElementAtPoint = RichtextElement & TextBox;
 
 /**
  * @public
  * Options for formatting richtext.
  */
-declare type RichtextFormatting = InlineFormatting & {
+export declare type RichtextFormatting = InlineFormatting & {
   /**
    * @public
    * A unique identifier that points to a font asset in Canva's backend.
@@ -4487,7 +4574,7 @@ declare type RichtextFormatting = InlineFormatting & {
  * @public
  * Provides methods for interacting with a range of formatted text.
  */
-declare type RichtextRange = {
+export declare type RichtextRange = {
   /**
    * Formats all of the paragraphs that overlap the given bounds.
    *
@@ -4771,7 +4858,7 @@ export declare const selection: DesignSelection;
  * @public
  * Information about the user's selection. To access the selected content, call the `read` method.
  */
-declare interface SelectionEvent<Scope extends SelectionScope> {
+export declare interface SelectionEvent<Scope extends SelectionScope> {
   /**
    * The type of content that's selected.
    */
@@ -4857,7 +4944,7 @@ declare interface SelectionEvent<Scope extends SelectionScope> {
  * @public
  * Information about a user's selection.
  */
-declare interface SelectionEvent<Scope extends SelectionScope> {
+export declare interface SelectionEvent<Scope extends SelectionScope> {
   /**
    * The type of content.
    */
@@ -4879,7 +4966,11 @@ declare interface SelectionEvent<Scope extends SelectionScope> {
  * @public
  * A type of content that supports selection events.
  */
-declare type SelectionScope = "plaintext" | "image" | "video" | "richtext";
+export declare type SelectionScope =
+  | "plaintext"
+  | "image"
+  | "video"
+  | "richtext";
 
 /**
  * @public
@@ -4888,7 +4979,7 @@ declare type SelectionScope = "plaintext" | "image" | "video" | "richtext";
  * @remarks
  * The available properties depend on the type (scope) of content.
  */
-declare type SelectionValue<Scope extends SelectionScope> = {
+export declare type SelectionValue<Scope extends SelectionScope> = {
   /**
    * A selected range of plaintext.
    */
@@ -4985,7 +5076,7 @@ export declare const setCurrentPageBackground: (
  * @public
  * An element that renders a vector shape.
  */
-declare type ShapeElement = {
+export declare type ShapeElement = {
   /**
    * The type of element.
    */
@@ -5009,7 +5100,7 @@ declare type ShapeElement = {
  * @public
  * An element that renders a vector shape and has positional properties.
  */
-declare type ShapeElementAtPoint = ShapeElement &
+export declare type ShapeElementAtPoint = ShapeElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -5017,7 +5108,7 @@ declare type ShapeElementAtPoint = ShapeElement &
  * @public
  * A path that defines the structure of a shape element.
  */
-declare type ShapePath = {
+export declare type ShapePath = {
   /**
    * The shape of the path.
    *
@@ -5049,7 +5140,7 @@ declare type ShapePath = {
  * @remarks
  * This is similar to the `viewBox` attribute of an `SVGElement`.
  */
-declare type ShapeViewBox = {
+export declare type ShapeViewBox = {
   /**
    * The distance of the shape from the top edge of the element, in pixels.
    */
@@ -5072,7 +5163,7 @@ declare type ShapeViewBox = {
  * @public
  * An element that renders a table.
  */
-declare type TableElement = {
+export declare type TableElement = {
   /**
    * The type of element.
    */
@@ -5095,7 +5186,7 @@ declare type TableElement = {
  * @public
  * Options for configuring the appearance of text.
  */
-declare type TextAttributes = {
+export declare type TextAttributes = {
   /**
    * The size of the text.
    *
@@ -5162,7 +5253,7 @@ declare type TextBox = Point & {
  * @public
  * Text element or content to be added to the design at the end of a drag event.
  */
-declare type TextDragConfig = {
+export declare type TextDragConfig = {
   /**
    * The type of element.
    */
@@ -5202,7 +5293,7 @@ declare type TextDragConfig = {
  * @public
  * An element that renders text content.
  */
-declare type TextElement = {
+export declare type TextElement = {
   /**
    * The type of element.
    */
@@ -5220,13 +5311,13 @@ declare type TextElement = {
  * @public
  * An element that renders text content and has positional properties.
  */
-declare type TextElementAtPoint = TextElement & TextBox;
+export declare type TextElementAtPoint = TextElement & TextBox;
 
 /**
  * @public
  * A region of richtext.
  */
-declare type TextRegion = {
+export declare type TextRegion = {
   /**
    * The plaintext content of the region.
    */
@@ -5241,7 +5332,7 @@ declare type TextRegion = {
  * @public
  * Provides methods for adding drag and drop behavior to an app.
  */
-declare interface UI {
+export declare interface UI {
   /**
    * @deprecated The method has been superseded by `startDragToPoint`.
    * @public
@@ -5301,7 +5392,7 @@ export declare const ui: UI;
  * @public
  * A data type that can be used in app element data.
  */
-declare type Value =
+export declare type Value =
   | Primitive
   | ObjectPrimitive
   | Exclude<Value, undefined>[]
@@ -5313,7 +5404,7 @@ declare type Value =
  * @public
  * Video element or content to be added to the design at the end of a drag event.
  */
-declare type VideoDragConfig = {
+export declare type VideoDragConfig = {
   /**
    * The type of element.
    */
@@ -5346,32 +5437,17 @@ declare type VideoDragConfig = {
  * @public
  * Video element or content to be added to the design at the end of a drag event.
  */
-declare type VideoDragConfigForElement<E extends Element> =
+export 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.
  */
-declare type VideoElement_2 = {
+export declare type VideoElement = {
   /**
    * The type of element.
    */
@@ -5389,26 +5465,11 @@ declare type VideoElement_2 = {
   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.
  */
-declare type VideoElementAtPoint_2 = VideoElement_2 &
+export declare type VideoElementAtPoint = VideoElement &
   Point &
   (WidthAndHeight | Width | Height);
 
@@ -5416,7 +5477,7 @@ declare type VideoElementAtPoint_2 = VideoElement_2 &
  * @public
  * A video asset that fills a path's interior.
  */
-declare type VideoFill = {
+export declare type VideoFill = {
   /**
    * The type of fill.
    */
@@ -5434,52 +5495,14 @@ 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.
  */
-declare type VideoRef = string & {
+export 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.
  */
@@ -5537,6 +5560,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.
  */
-declare type ZipBehavior = "auto" | "always" | "never";
+export declare type ZipBehavior = "auto" | "always" | "never";
 
 export {};

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

@@ -9,21 +9,12 @@ function _export(target, all) {
     });
 }
 _export(exports, {
-    get addElementAtPoint () {
-        return addElementAtPoint;
-    },
-    get addPage () {
-        return addPage;
-    },
     get bulkCreate () {
         return bulkCreate;
     },
     get editContent () {
         return editContent;
     },
-    get initAppElement () {
-        return initAppElement;
-    },
     get openDesign () {
         return openDesign;
     },
@@ -53,7 +44,4 @@ function editContent(options, callback) {
     return canva_sdk.design.v2.designInteraction.editContent(options, (session)=>callback(session));
 }
 const openDesign = canva_sdk.design.v2.designInteraction.openDesign;
-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');
+window.__canva__?.sdkRegistration?.registerPackageVersion('design', _version.LATEST_VERSION_BETA, 'beta');

package/lib/cjs/sdk/design/fake/create_beta.js

@@ -57,6 +57,13 @@ class FakeBetaDesignInteractionClient extends _fake_design_interaction_client.Fa
             }
         });
     }
+    constructor(...args){
+        super(...args), this.publish = {
+            launch: ()=>this.delay()
+        }, this.bulkCreate = {
+            launch: ()=>this.delay()
+        };
+    }
 }
 const fakePageRef = {
     type: 'absolute',

package/lib/cjs/sdk/design/fake/fake_design_interaction_client.js

@@ -140,12 +140,6 @@ class FakeDesignInteractionClient {
                 return ()=>{};
             }
         };
-        this.publish = {
-            launch: ()=>this.delay()
-        };
-        this.bulkCreate = {
-            launch: ()=>this.delay()
-        };
     }
 }
 const fakeBounds = {

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

@@ -2,10 +2,23 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "LATEST_VERSION", {
-    enumerable: true,
-    get: function() {
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get LATEST_VERSION () {
         return LATEST_VERSION;
+    },
+    get LATEST_VERSION_ALPHA () {
+        return LATEST_VERSION_ALPHA;
+    },
+    get LATEST_VERSION_BETA () {
+        return LATEST_VERSION_BETA;
     }
 });
-const LATEST_VERSION = '2.7.4';
+const LATEST_VERSION = '2.7.5';
+const LATEST_VERSION_BETA = '2.7.5-beta-1';
+const LATEST_VERSION_ALPHA = 'NONE';

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

@@ -1,4 +1,4 @@
-import { LATEST_VERSION } from './version';
+import { LATEST_VERSION_BETA } from './version';
 const { canva_sdk } = window;
 export const publish = canva_sdk.design.v2.designInteraction.publish;
 export const bulkCreate = canva_sdk.design.v2.designInteraction.bulkCreate;
@@ -6,8 +6,5 @@ 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 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');
+window.__canva__?.sdkRegistration?.registerPackageVersion('design', LATEST_VERSION_BETA, 'beta');

package/lib/esm/sdk/design/fake/create_beta.js

@@ -47,6 +47,13 @@ class FakeBetaDesignInteractionClient extends FakeDesignInteractionClient {
             }
         });
     }
+    constructor(...args){
+        super(...args), this.publish = {
+            launch: ()=>this.delay()
+        }, this.bulkCreate = {
+            launch: ()=>this.delay()
+        };
+    }
 }
 const fakePageRef = {
     type: 'absolute',

package/lib/esm/sdk/design/fake/fake_design_interaction_client.js

@@ -119,12 +119,6 @@ export class FakeDesignInteractionClient {
                 return ()=>{};
             }
         };
-        this.publish = {
-            launch: ()=>this.delay()
-        };
-        this.bulkCreate = {
-            launch: ()=>this.delay()
-        };
     }
 }
 const fakeBounds = {

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

@@ -1 +1,3 @@
-export const LATEST_VERSION = '2.7.4';
+export const LATEST_VERSION = '2.7.5';
+export const LATEST_VERSION_BETA = '2.7.5-beta-1';
+export const LATEST_VERSION_ALPHA = 'NONE';

package/package.json

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