@canva/design 2.7.1 → 2.7.2-beta.0

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

@@ -1015,11 +1015,16 @@ export declare interface ContentDraft<T> {
   save(): Promise<void>;
 }
 
+/**
+ * @beta
+ */
+export declare type ContentType = "richtext" | "fill";
+
 /**
  * @public
  * A type of content that can be read from a user's design.
  */
-export declare type ContentType = "richtext";
+declare type ContentType_2 = "richtext";
 
 /**
  * @public
@@ -2921,39 +2926,53 @@ export declare type DragStartEvent<E extends Element> = Pick<
 };
 
 /**
- * @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`
- *   }
- * );
- * ```
+ * @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.
  */
-export declare const editContent: (
-  options: EditContentOptions,
-  callback: EditContentCallback,
-) => Promise<void>;
+export declare function editContent(
+  options: EditContentOptions & {
+    contentType: "richtext";
+  },
+  callback: (session: RichtextContentSession) => Promise<void> | void,
+): Promise<void>;
+
+/**
+ * @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
+ * 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;
 
 /**
  * @public
  * A callback for reading and updating the requested design content.
  * @param session - The result of reading the content in the design.
  */
-export declare type EditContentCallback = (
+declare type EditContentCallback_2 = (
   session: RichtextContentSession,
 ) => Promise<void> | void;
 
 /**
- * @public
+ * @beta
  * Options for configuring how the design content is read.
  */
 export declare type EditContentOptions = {
@@ -2963,6 +2982,17 @@ 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
@@ -3193,6 +3223,67 @@ export declare type Fill = {
   asset?: ImageFill | VideoFill;
 };
 
+/**
+ * @beta
+ * Object for interacting with fill content (images/videos).
+ */
+export declare type FillContent =
+  | {
+      type: "image";
+      /**
+       * A unique identifier that points to an image asset in Canva's backend.
+       */
+      ref: ImageRef;
+      /**
+       * A description of the image content.
+       *
+       * @remarks
+       * Use `undefined` for content with no description.
+       */
+      altText?: AltText;
+      /**
+       * Indicates whether the object containing this fill has been deleted.
+       */
+      deleted: boolean;
+    }
+  | {
+      type: "video";
+      /**
+       * A unique identifier that points to an video asset in Canva's backend.
+       */
+      ref: VideoRef;
+      /**
+       * A description of the video content.
+       *
+       * @remarks
+       * Use `undefined` for content with no description.
+       */
+      altText?: AltText;
+      /**
+       * Indicates whether the object containing this fill has been deleted.
+       */
+      deleted: boolean;
+    };
+
+/**
+ * @beta
+ * Session for reading and updating fill content in a user's design.
+ */
+export declare interface FillContentSession {
+  /**
+   * Fill content in the design.
+   */
+  readonly contents: readonly FillContent[];
+  /**
+   * Saves any changes made during the session while keeping the transaction open.
+   *
+   * @remarks
+   * - Any changes in the session are only reflected in the design after this method is called.
+   * - Once this method is called, further changes in the session can still be made.
+   */
+  sync(): Promise<void>;
+}
+
 /**
  * @public
  * A reference to a font that can be used in other parts of the SDK.
@@ -4823,6 +4914,11 @@ export declare type TextDragConfig = {
    * @defaultValue "none"
    */
   decoration?: "none" | "underline";
+  /**
+   * @beta
+   * A unique identifier that points to a font asset in Canva's backend.
+   */
+  fontRef?: FontRef;
 };
 
 /**

package/lib/cjs/sdk/design/{index.js → beta.js}

@@ -1,7 +1,13 @@
-"use strict"
+"use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
+Object.defineProperty(exports, "editContent", {
+    enumerable: true,
+    get: function() {
+        return editContent;
+    }
+});
 _export_star(require("./public"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {
@@ -17,4 +23,8 @@ function _export_star(from, to) {
     return from;
 }
 var _window___canva___sdkRegistration, _window___canva__;
-(_window___canva__ = window.__canva__) === null || _window___canva__ === void 0 ? void 0 : (_window___canva___sdkRegistration = _window___canva__.sdkRegistration) === null || _window___canva___sdkRegistration === void 0 ? void 0 : _window___canva___sdkRegistration.registerPackageVersion('design', '2.7.0', 'ga');
+const { canva_sdk } = window;
+function editContent(options, callback) {
+    return canva_sdk.design.v2.designInteraction.editContent(options, (session)=>callback(session));
+}
+(_window___canva__ = window.__canva__) === null || _window___canva__ === void 0 ? void 0 : (_window___canva___sdkRegistration = _window___canva__.sdkRegistration) === null || _window___canva___sdkRegistration === void 0 ? void 0 : _window___canva___sdkRegistration.registerPackageVersion('design', '2.7.0', 'beta');

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

@@ -0,0 +1,18 @@
+"use strict"
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./index"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}

package/lib/esm/sdk/design/{index.js → beta.js}

@@ -1,3 +1,7 @@
 var _window___canva___sdkRegistration, _window___canva__;
+const { canva_sdk } = window;
+export function editContent(options, callback) {
+    return canva_sdk.design.v2.designInteraction.editContent(options, (session)=>callback(session));
+}
 export * from './public';
-(_window___canva__ = window.__canva__) === null || _window___canva__ === void 0 ? void 0 : (_window___canva___sdkRegistration = _window___canva__.sdkRegistration) === null || _window___canva___sdkRegistration === void 0 ? void 0 : _window___canva___sdkRegistration.registerPackageVersion('design', '2.7.0', 'ga');
+(_window___canva__ = window.__canva__) === null || _window___canva__ === void 0 ? void 0 : (_window___canva___sdkRegistration = _window___canva__.sdkRegistration) === null || _window___canva___sdkRegistration === void 0 ? void 0 : _window___canva___sdkRegistration.registerPackageVersion('design', '2.7.0', 'beta');

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

@@ -0,0 +1 @@
+export * from './index';

package/package.json

@@ -1,25 +1,25 @@
 {
   "name": "@canva/design",
-  "version": "2.7.1",
+  "version": "2.7.2-beta.0",
   "description": "The Canva Apps SDK design library",
   "author": "Canva Pty Ltd.",
   "license": "SEE LICENSE IN LICENSE.md FILE",
   "peerDependencies": {
     "@canva/error": "^2.0.0"
   },
-  "main": "./lib/cjs/sdk/design/index.js",
-  "module": "./lib/esm/sdk/design/index.js",
+  "main": "./lib/cjs/sdk/design/beta.js",
+  "module": "./lib/esm/sdk/design/beta.js",
   "exports": {
     ".": {
-      "types": "./index.d.ts",
-      "require": "./lib/cjs/sdk/design/index.js",
-      "import": "./lib/esm/sdk/design/index.js"
+      "types": "./beta.d.ts",
+      "require": "./lib/cjs/sdk/design/beta.js",
+      "import": "./lib/esm/sdk/design/beta.js"
     },
     "./test": {
-      "types": "./test/index.d.ts",
-      "require": "./lib/cjs/sdk/design/test/index.js",
-      "import": "./lib/esm/sdk/design/test/index.js"
+      "types": "./test/beta.d.ts",
+      "require": "./lib/cjs/sdk/design/test/beta.js",
+      "import": "./lib/esm/sdk/design/test/beta.js"
     }
   },
-  "typings": "./index.d.ts"
+  "typings": "./beta.d.ts"
 }