@canva/design 2.7.6-beta.2 → 2.8.1-alpha.0

package/{beta.d.ts → alpha.d.ts}

@@ -2,7 +2,7 @@
  * @beta
  * Information about a page within a design with fixed or unbounded dimensions.
  */
-export declare type AbsolutePageMetadata = {
+declare type AbsolutePageMetadata = {
     /**
      * The type of page.
      */
@@ -386,6 +386,46 @@ export declare const addPage: (opts?: {
     };
 }) => Promise<void>;
 
+/**
+ * @public
+ * A disclosure identifying if the app generated this asset using AI.
+ *
+ * @remarks
+ * Helps users make informed decisions about the content they interact with.
+ *
+ * AI is generally defined as any machine system that, given an objective, infers how to generate an output from an input.
+ * Some examples include "generative AI", "large language models", and "machine learning".
+ *
+ * **App Generated**
+ *
+ * 'app_generated' indicates when the app creates or significantly alters an asset using AI. Includes when
+ * the app makes a request to a third-party service to do so.
+ *
+ * A significantly altered asset means the AI changes key information or details, such as
+ * removing or replacing key components in the original content, which can include applying style transfer, or changing facial expressions.
+ *
+ * Label this asset as 'app_generated' under these conditions:
+ *
+ * The following is true:
+ *
+ * - The app generates the asset in response to a user's request (including past requests), for example, the asset is not from an asset library.
+ *
+ * And any of these conditions are also true:
+ *
+ *  - The AI creates entirely new content from scratch.
+ *  - The AI introduces new multimedia, details, or creative elements not originally present.
+ *  - The AI removes and replaces the asset's key components.
+ *  - The AI alters the asset's appearance, meaning, or context in a way that conveys a different message than the original.
+ *
+ * **None**
+ *
+ * 'none' indicates when the asset wasn't generated by the app as a part of any user's specific request, for example, a third-party
+ * request, or when the asset wasn't significantly altered by AI.
+ */
+declare type AiDisclosure = 'app_generated' | 'none';
+
+declare type AllOrNone<T> = T | Never<T>;
+
 /**
  * @public
  * Alternative text for a11y compliance.
@@ -788,6 +828,17 @@ export declare type AppElementClientConfiguration<A extends AppElementData> = {
     render: AppElementRenderer<A>;
 };
 
+/**
+ * @alpha
+ * Configuration for an App Element
+ */
+export declare type AppElementClientConfigurationV2<A extends AppElementData> = {
+    /**
+     * The AppElementRenderer to use when rendering the app element
+     */
+    render: AppElementRendererV2<A>;
+};
+
 /**
  * @public
  * The data associated with an app element.
@@ -823,6 +874,22 @@ export declare type AppElementRenderer<A extends AppElementData> = (appElementDa
  */
 export declare type AppElementRendererOutput = GroupContentAtPoint[];
 
+/**
+ * @alpha
+ * A return value of {@link AppElementRendererV2} function.
+ * It is an array of elements to render within an app element.
+ */
+export declare type AppElementRendererOutputV2 = AppElementRendererOutput;
+
+/**
+ * @alpha
+ * A callback that runs when an app's element is changed.
+ *
+ * @remarks
+ * This callback must return one or more elements to render within the app element.
+ */
+export declare type AppElementRendererV2<A extends AppElementData> = (appElementData: A) => AppElementRendererOutputV2;
+
 /**
  * @public
  * A unique identifier that references an app runtime process
@@ -875,6 +942,108 @@ export declare type AudioTrack = {
     ref: AudioRef;
 };
 
+/**
+ * @alpha
+ * Configuration for the Autofill call to request the Data Connector intent implemented by the app
+ * and skipping the data preview modal.
+ */
+export declare type AutofillDataConnectorNoPreview = {
+    dataSelectionDisplay: 'hide';
+    dataSourceRef: DataSourceRef;
+};
+
+/**
+ * @alpha
+ * Configuration for the Autofill call to request the Data Connector intent implemented by the app
+ * and displaying the data preview modal.
+ */
+export declare type AutofillDataConnectorWithPreview = {
+    dataSelectionDisplay: 'show';
+};
+
+/**
+ * @alpha
+ * Wrapper for the configurations that will query the app owned Data Connector.
+ */
+export declare type AutofillFromDataConnector = {
+    type: 'data_connector';
+    withDataConnector: 'self';
+    limit?: DataTableLimit;
+} & (AutofillDataConnectorWithPreview | AutofillDataConnectorNoPreview);
+
+/**
+ * @alpha
+ * Configuration for providing a fully populated data table to the Autofill call.
+ */
+export declare type AutofillFromDataTable = {
+    type: 'data_table';
+    dataTable: DataTable;
+};
+
+/**
+ * @alpha
+ * A set of options to configure the Autofill call.
+ * @param title - an optional title that will be set to the document after Autofill is done.
+ */
+export declare type AutofillOptions = {
+    title?: string;
+} & (AutofillFromDataTable | AutofillFromDataConnector);
+
+/**
+ * @alpha
+ * Response object from the Autofill operation.
+ */
+export declare type AutofillResponse = {
+    status: 'success';
+};
+
+/**
+ * @public
+ * Cell containing a boolean value.
+ *
+ * @example Creating a boolean cell
+ * ```ts
+ * import type { BooleanDataTableCell } from '@canva/intents/data';
+ *
+ * const isActiveCell: BooleanDataTableCell = {
+ *   type: 'boolean',
+ *   value: true
+ * };
+ * ```
+ *
+ * @example Creating a boolean cell with false value
+ * ```ts
+ * import type { BooleanDataTableCell } from '@canva/intents/data';
+ *
+ * const isCompleteCell: BooleanDataTableCell = {
+ *   type: 'boolean',
+ *   value: false
+ * };
+ * ```
+ *
+ * @example Creating an empty boolean cell
+ * ```ts
+ * import type { BooleanDataTableCell } from '@canva/intents/data';
+ *
+ * const emptyBooleanCell: BooleanDataTableCell = {
+ *   type: 'boolean',
+ *   value: undefined
+ * };
+ * ```
+ */
+declare type BooleanDataTableCell = {
+    /**
+     * Indicates this cell contains a boolean value.
+     */
+    type: 'boolean';
+    /**
+     * Boolean value (true or false).
+     *
+     * Use `undefined` for an empty cell.
+     */
+    value: boolean | undefined;
+};
+
 /**
  * @public
  * A segment of a richtext range.
@@ -903,6 +1072,23 @@ export declare type Bounds = {
  */
 export declare type Box = Point & (WidthAndHeight | Width | Height);
 
+/**
+ * @alpha
+ * A unique identifier that references a brand template.
+ */
+export declare type BrandTemplateId = string & {
+    __brandTemplateId: never;
+};
+
+/**
+ * @alpha
+ * Metadata for a brand template.
+ */
+export declare type BrandTemplateMetadata = Omit<TemplateMetadata, 'domain'> & {
+    domain: 'brand';
+    dataset?: DataField[];
+};
+
 /**
  * @public
  * An alias for the BulkCreateLauncher interface, providing access to bulk create related functionality
@@ -987,6 +1173,26 @@ declare type CellContent = {
     value: string;
 };
 
+/**
+ * @public
+ * Configuration for a table column.
+ */
+declare type ColumnConfig = {
+    /**
+     * Name for the column, displayed as header text.
+     *
+     * If `undefined`, the column will have no header text.
+     */
+    name: string | undefined;
+    /**
+     * Expected data type for cells in this column.
+     *
+     * Use a specific `DataType` for columns with consistent types,
+     * or `'variant'` for columns that may contain mixed types.
+     */
+    type: DataType | 'variant';
+};
+
 /**
  * Image element or content to be added to the design at the end of a drag event.
  */
@@ -1078,7 +1284,7 @@ export declare interface ContentDraft<T> {
 /**
  * @beta
  */
-export declare type ContentType = 'richtext' | 'fill';
+declare type ContentType = 'richtext' | 'fill';
 
 /**
  * @public
@@ -1193,6 +1399,198 @@ export declare type Coordinates = {
  */
 export declare const createRichtextRange: () => RichtextRange;
 
+/**
+ * @beta
+ * Metadata for a data field in a brand template.
+ */
+export declare type DataField = {
+    label: string;
+    type: 'image' | 'text' | 'chart';
+};
+
+/**
+ * @alpha
+ * A representation of the data source that is given to the Data Connector.
+ */
+export declare type DataSourceRef = {
+    /**
+     * This 'source' will be passed on to the Data Connector intent.
+     */
+    source: string;
+    title?: string;
+};
+
+/**
+ * @public
+ * Structured tabular data for import into Canva.
+ *
+ * This format allows you to provide typed data with proper formatting
+ * to ensure it displays correctly in Canva designs.
+ *
+ * @example Creating a data table
+ * ```ts
+ * import type { ColumnConfig, DataTableCell, DataTable, DataTableRow } from '@canva/intents/data';
+ *
+ * const myTable: DataTable = {
+ *   columnConfigs: [
+ *     { name: 'Name', type: 'string' },
+ *     { name: 'Age', type: 'number' },
+ *     { name: 'Subscribed', type: 'boolean' },
+ *     { name: 'Join Date', type: 'date' }
+ *   ],
+ *   rows: [
+ *     {
+ *       cells: [
+ *         { type: 'string', value: 'Alice' },
+ *         { type: 'number', value: 30 },
+ *         { type: 'boolean', value: true },
+ *         { type: 'date', value: Math.floor(new Date('2023-01-15').getTime() / 1000) }
+ *       ]
+ *     },
+ *     {
+ *       cells: [
+ *         { type: 'string', value: 'Bob' },
+ *         { type: 'number', value: 24 },
+ *         { type: 'boolean', value: false },
+ *         { type: 'date', value: Math.floor(new Date('2022-07-20').getTime() / 1000) }
+ *       ]
+ *     }
+ *   ]
+ * };
+ * ```
+ */
+declare type DataTable = {
+    /**
+     * Column definitions with names and data types.
+     *
+     * These help Canva interpret and display your data correctly.
+     */
+    columnConfigs?: ColumnConfig[];
+    /**
+     * The data rows containing the actual values.
+     *
+     * Each row contains an array of cells with typed data values.
+     */
+    rows: DataTableRow[];
+};
+
+/**
+ * @public
+ * Generic type for table cells that resolves to a specific cell type.
+ */
+declare type DataTableCell<T extends DataType = DataType> = {
+    date: DateDataTableCell;
+    string: StringDataTableCell;
+    number: NumberDataTableCell;
+    boolean: BooleanDataTableCell;
+    media: MediaCollectionDataTableCell;
+}[T];
+
+/**
+ * @public
+ * Options for uploading an image asset to the user's private media library.
+ */
+declare type DataTableImageUpload = Omit<ImageUploadOptions, 'type' | 'parentRef'> & {
+    /**
+     * Indicates this value contains options for image uploading.
+     */
+    type: 'image_upload';
+};
+
+/**
+ * @public
+ * Maximum dimensions for imported data tables.
+ */
+declare type DataTableLimit = {
+    /**
+     * The maximum number of rows allowed.
+     *
+     * Your app should ensure data does not exceed this limit.
+     */
+    row: number;
+    /**
+     * The maximum number of columns allowed.
+     *
+     * Your app should ensure data does not exceed this limit.
+     */
+    column: number;
+};
+
+/**
+ * @public
+ * A row in the data table.
+ *
+ * @example Creating a single row of data cells
+ * ```ts
+ * import type { DataTableCell, DataTableRow } from '@canva/intents/data';
+ *
+ * const row: DataTableRow = {
+ *   cells: [
+ *     { type: 'string', value: 'Product Alpha' },
+ *     { type: 'number', value: 199.99 },
+ *     { type: 'boolean', value: true }
+ *   ]
+ * };
+ * ```
+ */
+declare type DataTableRow = {
+    /**
+     * Array of cells containing the data values.
+     *
+     * Each cell must have a type that matches the corresponding column definition (if provided).
+     */
+    cells: DataTableCell<DataType>[];
+};
+
+/**
+ * @public
+ * Options for uploading a video asset to the user's private media library.
+ */
+declare type DataTableVideoUpload = Omit<VideoUploadOptions, 'type' | 'parentRef'> & {
+    /**
+     * Indicates this value contains options for video uploading.
+     */
+    type: 'video_upload';
+};
+
+/**
+ * @public
+ * Data types supported for table cells.
+ */
+declare type DataType = 'string' | 'number' | 'date' | 'boolean' | 'media';
+
+/**
+ * @public
+ * Cell containing a date value.
+ *
+ * @example Creating a date cell
+ * ```ts
+ * import type { DateDataTableCell } from '@canva/intents/data';
+ *
+ * const todayCell: DateDataTableCell = {
+ *   type: 'date',
+ *   value: Math.floor(Date.now() / 1000) // Unix timestamp in seconds
+ * };
+ *
+ * const emptyDateCell: DateDataTableCell = {
+ *   type: 'date',
+ *   value: undefined
+ * };
+ * ```
+ */
+declare type DateDataTableCell = {
+    /**
+     * Indicates this cell contains a date value.
+     */
+    type: 'date';
+    /**
+     * Unix timestamp in seconds representing the date.
+     *
+     * Use `undefined` for an empty cell.
+     */
+    value: number | undefined;
+};
+
 /**
  * @public
  * Describes a part of a design.
@@ -2728,7 +3126,7 @@ export declare type DesignElement = ImageElement | VideoElement | EmbedElement |
  * @beta
  * Information about the design.
  */
-export declare type DesignMetadata = {
+declare type DesignMetadata = {
     /**
      * The title of the user's design.
      * @remarks
@@ -2756,6 +3154,46 @@ export declare type DesignMetadata = {
      * This is the precise value, which differs from what is displayed in the UI as duration in Canva UI is formatted differently.
      */
     durationInSeconds: number;
+    /**
+     * The set of data fields that were tagged for Autofill.
+     * @remarks
+     * This field might be undefined or empty to represent a design that has no tagged fields.
+     */
+    dataset?: DataField[];
+};
+
+/**
+ * @public
+ * Information about the design.
+ */
+declare type DesignMetadata_2 = {
+    /**
+     * The title of the user's design.
+     * @remarks
+     * This is optional and will be `undefined` if the user hasn't set a title.
+     */
+    title?: string;
+    /**
+     * The default dimensions that a new page will have when it is added to a design.
+     * It is possible for a user to resize a page without resizing the entire design, e.g. by clicking
+     * "Expand to Whiteboard". However, there will always be a single set of default dimensions for a
+     * design that is applied whenever a new page is created.
+     * @remarks
+     * This is optional and will be `undefined` if the design is unbounded (e.g. Whiteboard or Doc).
+     */
+    defaultPageDimensions?: PageDimensions;
+    /**
+     * The information associated with each page of the design.
+     * @remarks
+     * The order of pages is not guaranteed.
+     */
+    pageMetadata: Iterable<PageMetadata_2>;
+    /**
+     * The duration of the whole design in seconds.
+     * @remarks
+     * This is the precise value, which differs from what is displayed in the UI as duration in Canva UI is formatted differently.
+     */
+    durationInSeconds: number;
 };
 
 /**
@@ -2783,12 +3221,6 @@ export declare type DesignOpenAllPagesOptions = {
  */
 export declare type DesignOpenCallback = (session: DesignEditing.CurrentPageSession) => Promise<void>;
 
-/**
- * @beta
- * A callback for operating on the design.
- */
-declare type DesignOpenCallback_2 = DesignOpenCurrentPageCallback | DesignOpenAllPagesCallback;
-
 /**
  * @beta
  * A callback for operating on the current page of the design.
@@ -3092,51 +3524,53 @@ export declare type Dimensions = {
 
 /**
  * @public
- * An event that occurs when a user starts dragging an HTML element.
+ * A set of dimensions.
  */
-export declare type DragStartEvent<E extends Element> = Pick<DragEvent, 'dataTransfer' | 'currentTarget' | 'preventDefault' | 'clientX' | 'clientY'> & {
-    currentTarget: E;
+declare type Dimensions_2 = {
+    /**
+     * A width, in pixels.
+     */
+    width: number;
+    /**
+     * A height, in pixels.
+     */
+    height: number;
 };
 
 /**
- * @beta
- * Reads and edits richtext content from the user's design.
- * @param options - Options for configuring how a design is read. Must specify `contentType: 'richtext'`.
- * @param callback - A callback that receives a `RichtextContentSession` for editing.
- * @returns A promise that resolves when editing is complete.
+ * @public
+ * An event that occurs when a user starts dragging an HTML element.
  */
-export declare function editContent(options: EditContentOptions & {
-    contentType: 'richtext';
-}, callback: (session: RichtextContentSession) => Promise<void> | void): Promise<void>;
+export declare type DragStartEvent<E extends Element> = Pick<DragEvent, 'dataTransfer' | 'currentTarget' | 'preventDefault' | 'clientX' | 'clientY'> & {
+    currentTarget: E;
+};
 
 /**
- * @beta
- * Reads and edits fill content from the user's design.
- * @param options - Options for configuring how a design is read. Must specify `contentType: 'fill'`.
- * @param callback - A callback that receives a `FillContentSession` for editing.
- * @returns A promise that resolves when editing is complete.
- */
-export declare function editContent(options: EditContentOptions & {
-    contentType: 'fill';
-}, callback: (session: FillContentSession) => Promise<void> | void): Promise<void>;
-
-/**
- * @beta
- * Reads and edits content from the user's design.
- * @param options - Options for configuring how a design is read. Must specify a content type.
- * @param callback - A callback that receives a session for editing.
- * @returns A promise that resolves when editing is complete.
+ * @public
+ * Reads and edits content of the specified type from the user's design.
+ * @param options - Options for configuring how a design is read.
+ * @param callback - A callback for operating on the read content.
+ *
+ * @example Read richtext content
+ * ```typescript
+ * import { editContent } from "@canva/design";
+ *
+ * await editContent(
+ *   { contentType: 'richtext', target: 'current_page' },
+ *   async (session) => {
+ *     // Do something with the richtext content, e.g. `session.contents`
+ *   }
+ * );
+ * ```
  */
-export declare function editContent<T extends ContentType>(options: EditContentOptions & {
-    contentType: T;
-}, callback: (session: ContentTypeMap[T]) => Promise<void> | void): Promise<void>;
+export declare const editContent: (options: EditContentOptions_2, callback: EditContentCallback_2) => Promise<void>;
 
 /**
  * @beta
  * A callback for reading and updating the requested design content.
  * @param session - Session for reading and updating content in the design.
  */
-export declare type EditContentCallback = (session: RichtextContentSession | FillContentSession) => Promise<void> | void;
+declare type EditContentCallback = (session: RichtextContentSession | FillContentSession) => Promise<void> | void;
 
 /**
  * @public
@@ -3149,7 +3583,7 @@ declare type EditContentCallback_2 = (session: RichtextContentSession) => Promis
  * @beta
  * Options for configuring how the design content is read.
  */
-export declare type EditContentOptions = {
+declare type EditContentOptions = {
     /**
      * The type of content to edit from the user's design
      */
@@ -3494,6 +3928,21 @@ export declare type FontRef = string & {
  **/
 export declare type FontWeight = 'normal' | 'thin' | 'extralight' | 'light' | 'medium' | 'semibold' | 'bold' | 'ultrabold' | 'heavy';
 
+/**
+ * @alpha
+ * Return metadata for a brand template given its ID.
+ *
+ * @example Get brand template metadata
+ * ```typescript
+ * import { getBrandTemplateMetadata, BrandTemplateId } from "@canva/design";
+ *
+ * const templateId = resolveToken(requestBrandTemplates()) as BrandTemplateId;
+ *
+ * const metadata = await getBrandTemplateMetadata(templateId);
+ * ```
+ */
+export declare const getBrandTemplateMetadata: (id: BrandTemplateId) => Promise<BrandTemplateMetadata>;
+
 /**
  * Allows to get the context of currently selected page.
  * @public
@@ -3564,25 +4013,19 @@ export declare const getCurrentPageContext: () => Promise<PageContext>;
 export declare const getDefaultPageDimensions: () => Promise<Dimensions | undefined>;
 
 /**
- * @beta
+ * @public
  * Retrieves information about the design.
- */
-export declare const getDesignMetadata: () => Promise<DesignMetadata>;
-
-/**
- * @beta
- * Retrieves information about the template that was used in a design.
  *
- * @example Get design template metadata
+ * @example Get design metadata
  * ```typescript
- * import { getDesignTemplateMetadata } from "@canva/design";
+ * import { getDesignMetadata } from "@canva/design";
  *
- * const templateMetadata = await getDesignTemplateMetadata();
+ * const metadata = await getDesignMetadata();
  *
- * const { keywords, domain } = templateMetadata;
+ * const { title, defaultPageDimensions,  pageMetadata, durationInSeconds } = metadata;
  * ```
  */
-export declare const getDesignTemplateMetadata: () => Promise<DesignTemplateMetadata>;
+export declare const getDesignMetadata: () => Promise<DesignMetadata_2>;
 
 /**
  * @public
@@ -3742,6 +4185,12 @@ export declare type ImageFill = {
     altText?: AltText;
 };
 
+/**
+ * @public
+ * The MIME type of an image file that's supported by Canva's backend.
+ */
+declare type ImageMimeType = 'image/jpeg' | 'image/heic' | 'image/png' | 'image/svg+xml' | 'image/webp' | 'image/tiff';
+
 /**
  * @public
  * A unique identifier that references an image asset in Canva's backend.
@@ -3752,43 +4201,185 @@ export declare type ImageRef = string & {
 
 /**
  * @public
+ * A unique identifier that points to an image asset in Canva's backend.
+ */
+declare type ImageRef_2 = string & {
+    __imageRef: never;
+};
+
+/**
+ * @public
+ * Options for uploading an image asset to the user's private media library.
+ */
+declare type ImageUploadOptions = {
+    /**
+     * The type of asset.
+     */
+    type: 'image';
+    /**
+     * A human-readable name for the image asset.
+     *
+     * @remarks
+     * This name is displayed in the user's media library and helps users identify
+     * and find the asset later. If not provided, Canva will generate a name based
+     * on the asset's URL or a unique identifier.
+     *
+     * Requirements:
+     * - Minimum length: 1 character (empty strings are not allowed)
+     * - Maximum length: 255 characters
+     */
+    name?: string;
+    /**
+     * The ref of the original asset from which this new asset was derived.
+     *
+     * @remarks
+     * For example, if an app applies an effect to an image, `parentRef` should contain the ref of the original image.
+     */
+    parentRef?: ImageRef_2;
+    /**
+     * The URL of the image file to upload.
+     * This can be an external URL or a data URL.
+     *
+     * @remarks
+     * Requirements for external URLs:
+     *
+     * - Must use HTTPS
+     * - Must return a `200` status code
+     * - `Content-Type` must match the file's MIME type
+     * - Must be publicly accessible (i.e. not a localhost URL)
+     * - Must not redirect
+     * - Must not contain an IP address
+     * - Maximum length: 4096 characters
+     * - Must not contain whitespace
+     * - Must not contain these characters: `>`, `<`, `{`, `}`, `^`, backticks
+     * - Maximum file size: 50MB
+     *
+     * Requirements for data URLs:
+     *
+     * - Must include `;base64` for base64-encoded data
+     * - Maximum size: 10MB (10 × 1024 × 1024 characters)
+     *
+     * Requirements for SVGs:
+     *
+     * - Disallowed elements:
+     *    - `a`
+     *    - `altglyph`
+     *    - `altglyphdef`
+     *    - `altglyphitem`
+     *    - `animate`
+     *    - `animatemotion`
+     *    - `animatetransform`
+     *    - `cursor`
+     *    - `discard`
+     *    - `font`
+     *    - `font-face`
+     *    - `font-face-format`
+     *    - `font-face-name`
+     *    - `font-face-src`
+     *    - `font-face-uri`
+     *    - `foreignobject`
+     *    - `glyph`
+     *    - `glyphref`
+     *    - `missing-glyph`
+     *    - `mpath`
+     *    - `script`
+     *    - `set`
+     *    - `switch`
+     *    - `tref`
+     * - Disallowed attributes:
+     *    - `crossorigin`
+     *    - `lang`
+     *    - `media`
+     *    - `onload`
+     *    - `ping`
+     *    - `referrerpolicy`
+     *    - `rel`
+     *    - `rendering-intent`
+     *    - `requiredextensions`
+     *    - `requiredfeatures`
+     *    - `systemlanguage`
+     *    - `tabindex`
+     *    - `transform-origin`
+     *    - `unicode`
+     *    - `vector-effect`
+     * - The `href` attribute of an `image` element only supports data URLs for PNG and JPEG images.
+     * - The URL in the `href` attribute must not point to a location outside of the SVG.
+     * - The `style` attribute must not use the `mix-blend-mode` property.
+     */
+    url: string;
+    /**
+     * The MIME type of the image file.
+     */
+    mimeType: ImageMimeType;
+    /**
+     * The URL of a thumbnail image to display while the image is queued for upload.
+     * This can be an external URL or a data URL.
+     *
+     * @remarks
+     * Requirements for external URLs:
+     *
+     * - Must use HTTPS
+     * - Must support [Cross-Origin Resource Sharing](https://www.canva.dev/docs/apps/cross-origin-resource-sharing/)
+     * - Must be a PNG, JPEG, or SVG file
+     * - Maximum length: 4096 characters
+     *
+     * Requirements for data URLs:
+     *
+     * - Must include `;base64` for base64-encoded data
+     * - Maximum size: 10MB (10 × 1024 × 1024 characters)
+     */
+    thumbnailUrl: string;
+    /**
+     * A disclosure identifying if the app generated this image using AI
+     *
+     * @remarks
+     * Helps users make informed decisions about the content they interact with.
+     * See {@link AiDisclosure} for the full definition.
+     *
+     * **App Generated**
+     *
+     * 'app_generated' indicates when the app creates or significantly alters an asset using AI. Includes when
+     * the app requests a third-party service to take similar action on an image using AI.
+     *
+     *  Required for the following cases (this list is not exhaustive):
+     *  | Case                                                            | Reason                               |
+     *  | --                                                              | --                                   |
+     *  | AI generates a new image from scratch                           | Creates new creative content         |
+     *  | AI changes the style of the image e.g. makes it cartoon         | Significantly alters the style       |
+     *  | AI removes an object and replaces it with new content           | Creates new creative content         |
+     *  | AI changes the facial expression of a person in an image        | Can alter content's original meaning |
+     *  | AI composites multiple images together                          | Significantly alters context         |
+     *  | AI expands an image by generating new content to fill the edges | Creates new creative content         |
+     *  | AI replaces background by generating new content                | Creates new creative content         |
+     *
+     * **None**
+     *
+     * 'none' indicates when the app doesn't create or significantly alter an asset using AI, or as a part of a request
+     * to third-party hosted content.
+     *
+     * Required for the following cases (this list is not exhaustive):
+     *  | Case                                                    | Reason                                    |
+     *  | --                                                      | --                                        |
+     *  | Asset comes from an asset library                       | Didn't generate the asset itself          |
+     *  | AI corrects red eyes                                    | A minor correction                        |
+     *  | AI removes background without replacement               | Doesn't change original meaning by itself |
+     *  | AI changes the color of an object in an image           | Doesn't change original meaning by itself |
+     *  | AI detects image defects and suggests manual fixes      | Didn't change the asset itself            |
+     *  | AI adjusts brightness and contrast on an image          | Doesn't change original meaning by itself |
+     *  | AI upscales an image                                    | Doesn't change original meaning by itself |
+     */
+    aiDisclosure: AiDisclosure;
+
+} & AllOrNone<Dimensions_2>;
+
+/**
+ * @alpha
  * @param appElementConfig - Configuration for an AppElementClient
- *
- * @example Initialize app element client
- * ```typescript
- * import { initAppElement } from "@canva/design";
- *
- * const appElement = initAppElement<{ content: string }>({
- *   render: (data) => {
- *     return [{
- *       type: 'text',
- *       children: [data.content],
- *       top: 100,
- *       left: 100,
- *       width: 200
- *     }];
- *   }
- * });
- * ```
- *
- * @example Initialize V2 app element client
- * ```typescript
- * import { initAppElement } from "@canva/design";
- *
- * const appElement = initAppElement<{ content: string }>({
- *   render: (data) => {
- *     return [{
- *       type: 'text',
- *       children: [data.content],
- *       top: 100,
- *       left: 100,
- *       width: 200
- *     }];
- *   }
- * });
- * ```
  */
-export declare const initAppElement: <A extends AppElementData>(appElementConfig: AppElementClientConfiguration<A>) => AppElementClient<A>;
+export declare const initAppElement: {
+    <A extends AppElementData>(appElementConfig: AppElementClientConfigurationV2<A>): AppElementClient<A>;
+    <A extends AppElementData>(appElementConfig: AppElementClientConfiguration<A>): AppElementClient<A>;
+};
 
 /**
  * @public
@@ -3857,6 +4448,49 @@ export declare type LaunchPublishOpts = {
     withContentPublisher: 'self';
 };
 
+/**
+ * @public
+ * Cell containing a media collection (images) value.
+ *
+ * @example Creating a media cell with an image
+ * ```ts
+ * import type { MediaCollectionDataTableCell } from '@canva/intents/data';
+ *
+ * const mediaCell: MediaCollectionDataTableCell = {
+ *   type: 'media',
+ *   value: [{
+ *     type: 'image_upload',
+ *     url: 'https://www.canva.dev/example-assets/image-import/image.jpg',
+ *     mimeType: 'image/jpeg',
+ *     thumbnailUrl: 'https://www.canva.dev/example-assets/image-import/thumbnail.jpg',
+ *     aiDisclosure: 'none'
+ *   }]
+ * };
+ * ```
+ *
+ * @example Creating an empty media cell
+ * ```ts
+ * import type { MediaCollectionDataTableCell } from '@canva/intents/data';
+ *
+ * const emptyMediaCell: MediaCollectionDataTableCell = {
+ *   type: 'media',
+ *   value: []
+ * };
+ * ```
+ */
+declare type MediaCollectionDataTableCell = {
+    /**
+     * Indicates this cell contains a media collection.
+     */
+    type: 'media';
+    /**
+     * Media collection values.
+     *
+     * Use empty array for an empty cell.
+     */
+    value: (DataTableImageUpload | DataTableVideoUpload)[];
+};
+
 /**
  * @deprecated The type has been superseded by `DesignElement`.
  * @public
@@ -3969,22 +4603,130 @@ export declare type NativeVideoElement = VideoElement;
  */
 export declare type NativeVideoElementWithBox = VideoElementAtPoint;
 
+declare type Never<T> = {
+    [key in keyof T]?: never;
+};
+
+/**
+ * @public
+ * Formatting metadata for number cells.
+ *
+ * @example Formatting as currency
+ * ```ts
+ * import type { NumberDataTableCell } from '@canva/intents/data';
+ *
+ * const currencyCell: NumberDataTableCell = {
+ *   type: 'number',
+ *   value: 1234.57,
+ *   metadata: { formatting: '[$$]#,##0.00' }
+ * };
+ * ```
+ *
+ * @example Formatting as a percentage
+ * ```ts
+ * import type { NumberDataTableCell } from '@canva/intents/data';
+ *
+ * const percentCell: NumberDataTableCell = {
+ *   type: 'number',
+ *   value: 0.1234,
+ *   metadata: { formatting: '0.00%' }
+ * };
+ * ```
+ *
+ * @example Applying a thousands separator
+ * ```ts
+ * import type { NumberDataTableCell } from '@canva/intents/data';
+ *
+ * const largeNumberCell: NumberDataTableCell = {
+ *   type: 'number',
+ *   value: 1234567.89234,
+ *   metadata: { formatting: '#,##0.00' }
+ * };
+ * ```
+ */
+declare type NumberCellMetadata = {
+    /**
+     * Formatting pattern using Office Open XML Format.
+     *
+     * These patterns control how numbers are displayed to users,
+     * including currency symbols, decimal places, and separators.
+     */
+    formatting?: string;
+};
+
+/**
+ * @public
+ * Cell containing a numeric value.
+ *
+ * @example Creating a number cell
+ * ```ts
+ * import type { NumberCellMetadata, NumberDataTableCell } from '@canva/intents/data';
+ *
+ * const priceCell: NumberDataTableCell = {
+ *   type: 'number',
+ *   value: 29.99,
+ *   metadata: { formatting: '[$$]#,##0.00' }
+ * };
+ *
+ * const quantityCell: NumberDataTableCell = {
+ *   type: 'number',
+ *   value: 150
+ * };
+ *
+ * const emptyNumberCell: NumberDataTableCell = {
+ *   type: 'number',
+ *   value: undefined
+ * };
+ * ```
+ */
+declare type NumberDataTableCell = {
+    /**
+     * Indicates this cell contains a number value.
+     */
+    type: 'number';
+    /**
+     * Numeric value within safe integer range.
+     *
+     * Valid range: `Number.MIN_SAFE_INTEGER` to `Number.MAX_SAFE_INTEGER`
+     *
+     * Invalid values:
+     *
+     * - Infinity or -Infinity
+     * - NaN
+     * - Negative zero (-0)
+     * - Denormalized numbers
+     *
+     * Use `undefined` for an empty cell.
+     */
+    value: number | undefined;
+    /**
+     * Optional formatting information for displaying the number.
+     *
+     * @example Applying display formatting to a number
+     * ```ts
+     * import type { NumberCellMetadata } from '@canva/intents/data';
+     *
+     * const currencyFormatting: NumberCellMetadata = { formatting: '[$USD]#,##0.00' };
+     * const percentageFormatting: NumberCellMetadata = { formatting: '0.00%' };
+     * ```
+     */
+    metadata?: NumberCellMetadata;
+};
+
 /**
  * An object primitive data type that can be used in app element data.
  */
 declare type ObjectPrimitive = Boolean | String;
 
 /**
- * @beta
- * Reads (and optionally updates) a specified part of the user's design.
+ * @public
+ *
+ * Reads a specified part of the user's design and returns all elements in that part.
+ *
  * @param options - Options for configuring how the design is read.
  * @param callback - A callback for operating on the design.
  */
-export declare const openDesign: {
-    (options: DesignOpenCurrentPageOptions, callback: DesignOpenCurrentPageCallback): Promise<void>;
-    (options: DesignOpenAllPagesOptions, callback: DesignOpenAllPagesCallback): Promise<void>;
-    (options: DesignOpenOptions_2, callback: DesignOpenCallback_2): Promise<void>;
-};
+export declare const openDesign: (options: DesignOpenOptions, callback: DesignOpenCallback) => Promise<void>;
 
 /**
  * @public
@@ -4081,7 +4823,23 @@ export declare type PageDimensions = {
  * @beta
  * Information about a page within a design.
  */
-export declare type PageMetadata = AbsolutePageMetadata | UnsupportedPageMetadata;
+declare type PageMetadata = AbsolutePageMetadata | UnsupportedPageMetadata;
+
+/**
+ * @public
+ * Information about a page.
+ */
+declare type PageMetadata_2 = {
+
+    /**
+     *
+     * The dimensions of the page, in pixels.
+     *
+     * @remarks
+     * This may be `undefined` because some types of pages don't have dimensions, such as whiteboards.
+     */
+    dimensions?: PageDimensions;
+};
 
 /**
  * @public
@@ -4188,6 +4946,106 @@ export declare type PublishLauncher = {
     launch(opts: LaunchPublishOpts): Promise<void>;
 };
 
+/**
+ * @alpha
+ * Requests the Autofill flow to start of the given options. The flow can request data from the app
+ * owned Data Connector, or use any given data that is passed in the options object.
+ *
+ * @param opts - The configuration options for this Autofill flow.
+ *
+ * @example Basic usage - Open data connector preview dialog to request data
+ * ```typescript
+ * import { requestAutofillDesign } from "@canva/design";
+ * import type { AutofillOptions } from "@canva/design";
+ *
+ * const opts: AutofillOptions = {
+ *   title: 'Updated design',
+ *   type: 'data_connector',
+ *   dataSelectionDisplay: 'show',
+ * };
+ *
+ * const response = await requestAutofillDesign(element);
+ * ```
+ *
+ * @example Basic usage - Request data from the data connector without preview
+ * ```typescript
+ * import { requestAutofillDesign } from "@canva/design";
+ * import type { AutofillOptions } from "@canva/design";
+ *
+ * const opts: AutofillOptions = {
+ *   title: 'Updated design',
+ *   type: 'data_connector',
+ *   dataSelectionDisplay: 'hide',
+ *   dataSourceRef: { source: 'serialized_content' }
+ * };
+ *
+ * const response = await requestAutofillDesign(element);
+ * ```
+ *
+ * @example Basic usage - Use the data given in the options
+ * ```typescript
+ * import { requestAutofillDesign } from "@canva/design";
+ * import type { AutofillOptions } from "@canva/design";
+ *
+ * const opts: AutofillOptions = {
+ *   title: 'Updated design',
+ *   type: 'data_table',
+ *   dataTable: // Set the data table containing the data entries for each field.
+ * };
+ *
+ * const response = await requestAutofillDesign(element);
+ * ```
+ */
+export declare const requestAutofillDesign: (opts: AutofillOptions) => Promise<AutofillResponse>;
+
+/**
+ * @alpha
+ * Trigger brand template selection panel and returns the selected template token.
+ *
+ * @example Request brand templates
+ * ```typescript
+ * import { requestBrandTemplates } from "@canva/design";
+ *
+ * const response = await requestBrandTemplates();
+ *
+ * if (response.status === 'aborted') return;
+ *
+ * const { token } = response.brandTemplates[0];
+ * ```
+ */
+export declare const requestBrandTemplates: () => Promise<RequestBrandTemplatesResponse>;
+
+/**
+ * @alpha
+ * Response object from the RequestBrandTemplate operation.
+ */
+export declare type RequestBrandTemplatesResponse = RequestBrandTemplatesResponseCompleted | RequestBrandTemplatesResponseAborted;
+
+/**
+ * @alpha
+ * Response object from the RequestBrandTemplate operation that was aborted.
+ */
+export declare type RequestBrandTemplatesResponseAborted = {
+    status: 'aborted';
+};
+
+/**
+ * @alpha
+ * Response object from the RequestBrandTemplate operation completed successfully.
+ */
+export declare type RequestBrandTemplatesResponseCompleted = {
+    status: 'completed';
+    brandTemplates: RequestBrandTemplatesResponseContent[];
+};
+
+/**
+ * @alpha
+ * Response object from the RequestBrandTemplate operation completed successfully.
+ */
+export declare type RequestBrandTemplatesResponseContent = {
+    token: string;
+};
+
 /**
  * @public
  * Exports the user's design as one or more static files.
@@ -4966,6 +5824,40 @@ export declare type ShapeViewBox = {
     height: number;
 };
 
+/**
+ * @public
+ * Cell containing a text value.
+ *
+ * @example Creating a string cell
+ * ```ts
+ * import type { StringDataTableCell } from '@canva/intents/data';
+ *
+ * const nameCell: StringDataTableCell = {
+ *   type: 'string',
+ *   value: 'John Doe'
+ * };
+ *
+ * const emptyStringCell: StringDataTableCell = {
+ *   type: 'string',
+ *   value: undefined
+ * };
+ * ```
+ */
+declare type StringDataTableCell = {
+    /**
+     * Indicates this cell contains a string value.
+     */
+    type: 'string';
+    /**
+     * Text content of the cell.
+     *
+     * Maximum length: 10,000 characters
+     *
+     * Use `undefined` for an empty cell.
+     */
+    value: string | undefined;
+};
+
 /**
  * @public
  * An element that renders a table.
@@ -5192,7 +6084,7 @@ export declare const ui: UI;
  * @beta
  * Pages that do not have fixed or unbounded dimensions currently do not return metadata.
  */
-export declare type UnsupportedPageMetadata = {
+declare type UnsupportedPageMetadata = {
     /**
      * The type of page.
      */
@@ -5296,6 +6188,16 @@ export declare type VideoFill = {
     altText?: AltText;
 };
 
+/**
+ * @public
+ * The MIME type of a video file that's supported by Canva's backend.
+ *
+ * @remarks
+ * - GIFs are treated as videos, not images.
+ * - `"application/json"` is only used for Lottie files.
+ */
+declare type VideoMimeType = 'video/avi' | 'video/x-msvideo' | 'image/gif' | 'video/x-m4v' | 'video/x-matroska' | 'video/quicktime' | 'video/mp4' | 'video/mpeg' | 'video/webm' | 'application/json';
+
 /**
  * @public
  * A unique identifier that references a video asset in Canva's backend.
@@ -5304,6 +6206,138 @@ export declare type VideoRef = string & {
     __videoRef: never;
 };
 
+/**
+ * @public
+ * A unique identifier that points to a video asset in Canva's backend.
+ */
+declare type VideoRef_2 = string & {
+    __videoRef: never;
+};
+
+/**
+ * @public
+ * Options for uploading a video asset to the user's private media library.
+ */
+declare type VideoUploadOptions = {
+    /**
+     * The type of asset.
+     */
+    type: 'video';
+    /**
+     * A human-readable name for the video asset.
+     *
+     * @remarks
+     * This name is displayed in the user's media library and helps users identify
+     * and find the asset later. If not provided, Canva will generate a name based
+     * on the asset's URL or a unique identifier.
+     *
+     * Requirements:
+     * - Minimum length: 1 character (empty strings are not allowed)
+     * - Maximum length: 255 characters
+     */
+    name?: string;
+    /**
+     * The ref of the original asset from which this new asset was derived.
+     *
+     * @remarks
+     * For example, if an app applies an effect to a video, `parentRef` should contain the ref of the original video.
+     */
+    parentRef?: VideoRef_2;
+    /**
+     * The URL of the video file to upload.
+     *
+     * @remarks
+     * Requirements:
+     *
+     * - Must use HTTPS
+     * - Must return a `200` status code
+     * - `Content-Type` must match the file's MIME type
+     * - Must be publicly accessible (i.e. not a localhost URL)
+     * - Must not redirect
+     * - Must not contain an IP address
+     * - Maximum length: 4096 characters
+     * - Must not contain whitespace
+     * - Must not contain these characters: `>`, `<`, `{`, `}`, `^`, backticks
+     * - Maximum file size: 1000MB (1GB)
+     */
+    url: string;
+    /**
+     * The MIME type of the video file.
+     */
+    mimeType: VideoMimeType;
+    /**
+     * The URL of a thumbnail video to display while the video is queued for upload.
+     *
+     * @remarks
+     * Requirements:
+     *
+     * - Must use HTTPS
+     * - Must support [Cross-Origin Resource Sharing](https://www.canva.dev/docs/apps/cross-origin-resource-sharing/)
+     * - Maximum length: 4096 characters
+     * - The dimensions of the thumbnail video must match the video's aspect ratio to prevent the thumbnail from appearing squashed or stretched
+     * - Must not be an AVI file. Although our APIs support uploading AVI videos, Canva can't preview them because of native support of browsers
+     */
+    thumbnailVideoUrl?: string;
+    /**
+     * The URL of a thumbnail image to use as a fallback if `thumbnailVideoUrl` isn't provided.
+     * This can be an external URL or a data URL.
+     *
+     * @remarks
+     * Requirements for external URLs:
+     *
+     * - Must use HTTPS
+     * - Must support [Cross-Origin Resource Sharing](https://www.canva.dev/docs/apps/cross-origin-resource-sharing/)
+     * - Must be a PNG, JPEG, or SVG file
+     * - Maximum length: 4096 characters
+     *
+     * Requirements for data URLs:
+     *
+     * - Must include `;base64` for base64-encoded data
+     * - Maximum size: 10MB (10 × 1024 × 1024 characters)
+     * - The dimensions of the thumbnail must match the video's aspect ratio to prevent the thumbnail from appearing squashed or stretched
+     */
+    thumbnailImageUrl: string;
+    /**
+     * A disclosure identifying if the app generated this video using AI.
+     *
+     * @remarks
+     * Helps users make informed decisions about the content they interact with.
+     * See {@link AiDisclosure} for the full definition.
+     *
+     * **App Generated**
+     *
+     * 'app_generated' indicates when the app creates or significantly alters an asset using AI. Includes when
+     * the app requests a third-party service to take similar action on a video using AI.
+     *
+     *  Required for the following cases (this list is not exhaustive):
+     *  | Case                                                             | Reason                               |
+     *  | --                                                               | --                                   |
+     *  | AI generates a new video from scratch                            | Creates new creative content         |
+     *  | AI changes the style of the video e.g. makes it cartoon          | Significantly alters the style       |
+     *  | AI adds subtitles that rely on subjective interpretation         | Creates new creative content         |
+     *  | AI expands a video by generating new content to fill the edges   | Creates new creative content         |
+     *  | AI animates an image                                             | Creates new creative content         |
+     *  | AI fixes defects e.g. blur in a video by generating details      | Creates new creative content         |
+     *  | AI generates a talking head presenter                            | Creates new creative content         |
+     *
+     * **None**
+     *
+     * 'none' indicates when the app doesn't create or significantly alter an asset using AI, or as a part of
+     * a request to third-party hosted content.
+     *
+     * Required for the following cases (this list is not exhaustive):
+     *  | Case                                                     | Reason                                    |
+     *  | --                                                       | --                                        |
+     *  | Asset comes from an asset library                        | Didn't generate the asset itself          |
+     *  | AI corrects red eyes                                     | A minor correction                        |
+     *  | AI adjusts brightness and contrast on a video            | Doesn't change original meaning by itself |
+     *  | AI creates a slow motion effect in a video               | Doesn't change original meaning by itself |
+     *  | AI adds AI word-by-word transcribed subtitles to a video | Doesn't change original meaning by itself |
+     */
+    aiDisclosure: AiDisclosure;
+
+} & AllOrNone<Dimensions_2>;
+
 /**
  * A set of dimensions with an auto-calculated height.
  */