@canva/design 2.7.6-beta.1 → 2.8.0

package/CHANGELOG.md

@@ -1,15 +1,154 @@
 # CHANGELOG
 
-## 2.7.6-beta.1 - 2026-01-18
+## 2.8.0 - 2026-02-02
 
 ### Added
 
-- Beta versions of `addElementAtPoint`, `initAppElement`, and `addPage` now support `trim` and `imageBox` on video elements.
-- New API `publish.launch` to launch the content publisher
-- New API `bulkCreate.launch` to open the Bulk Create experience with the Data Connector intent open.
 - Added a CHANGELOG.md to track changes.
-- New API `getDesignTemplateMetadata` in beta to return template metadata for a design that has used a template.
+- This introduces 2 new APIs, bulkCreate and publish, each with a corresponding launch function that allows the app to launch these experiences directly using the app's set up Data Connector and Content Publisher intents.
 
-## 2.7.6-beta.0 - 2025-11-12
+### Fixed
 
-- Initial changelog for the Preview Design SDK.
+- Improve `mailto` URI validation to more accurately detect valid email addresses.
+
+### Other
+
+- Updated types for `requestExport` into separate named objects
+
+## 2.7.5 - 2025-12-09
+
+### Added
+
+- Added support for custom dimensions in the `addPage` API call.
+- Added the ability to configure the zipped behaviour of certain types when exporting with `requestExport`.
+
+## 2.7.4 - 2025-11-28
+
+### Added
+
+- Added `design.getDesignMetadata` method, which allows apps to get information about the design. See the [documentation](https://www.canva.dev/docs/apps/api/latest/design-get-design-metadata/).
+
+## 2.7.3 - 2025-10-13
+
+### Deprecated
+
+- Deprecated `CurrentPageResult` in favour of `CurrentPageSession`.
+
+### Removed
+
+- We no longer provide `index` parameter in the `forEach` callbacks.
+
+## 2.7.2 - 2025-08-05
+
+### Deprecated
+
+- Deprecate `design.getDefaultPageDimensions`, use `design.getDesignMetadata` instead. See the [documentation](https://www.canva.dev/docs/apps/api/latest/design-get-design-metadata/).
+
+## 2.7.0 - 2025-07-15
+
+### Added
+
+- Added the `getDesignMetadata` method, which allows apps to get information about the design. See the [documentation](https://www.canva.dev/docs/apps/api/latest/design-get-design-metadata/).
+
+### Deprecated
+
+- Deprecated `design.getDefaultPageDimensions`, use `design.getDesignMetadata` instead. See the [documentation](https://www.canva.dev/docs/apps/api/latest/design-get-design-metadata/).
+
+## 2.6.1 - 2025-06-24
+
+### Added
+
+- `openDesign`: Added new async helper methods `group` and `ungroup`. See the documentation on [PageHelpers](https://www.canva.dev/docs/apps/api/latest/design-types-page-helpers/).
+
+### Changed
+
+- `openDesign`: [Design Editing API](https://www.canva.dev/docs/apps/api/latest/design-open-design/) is out of preview and Generally Available.
+- **Breaking:** `openDesign` function signature changes:
+  - `save` is superseded by `sync`. Unlike `save`, `sync` can be called multiple times as needed.
+  - Renamed page type: `fixed` → `absolute`.
+  - New page type: `unsupported`, which represents pages that are not `absolute`.
+  - Renamed `elementBuilder` to `elementStateBuilder`.
+  - Removed `cloneElement`.
+  - `media` and `color` fills are superseded by `mediaContainer` and `colorContainer`.
+  - For shape path fills, `isMediaEditable` introduced to indicate editability.
+
+## 2.4.0 - 2025-02-17
+
+### Added
+
+- Latest version of the App Element API is out of preview and Generally Available. This version enables atomic and predictable operations that are no longer tied current selection. To learn more, see [App Elements](https://www.canva.dev/docs/apps/creating-app-elements/).
+
+## 2.3.0 - 2024-12-15
+
+### Added
+
+- [Content Query API](https://www.canva.dev/docs/apps/querying/) is out of preview and Generally Available.
+- Introduced a test harness to allow for [unit testing](https://www.canva.dev/docs/apps/testing/) of the package.
+
+## 2.2.1 - 2024-10-21
+
+### Added
+
+- Updated App Element API to enable atomic and predictable operations that are no longer tied current selection. To learn more, see App Elements [documentation](https://www.canva.dev/docs/apps/app-elements/).
+
+## 2.1.0 - 2024-09-23
+
+### Deprecated
+
+- Deprecated `NativeElementType` type.
+
+## 2.0.0 - 2024-09-20
+
+### Changed
+
+- **Breaking:** See [Apps SDK Migration Guide](https://www.canva.dev/docs/apps/upgrades-and-migrations/v2-migration-guide/) for full list of changes.
+
+## 1.10.0 - 2024-08-22
+
+### Added
+
+- Added `altText` property to image elements.
+- Added [design.overlay.registerOnCanOpen](https://www.canva.dev/docs/apps/api/design-overlay-register-on-can-open/) which was previously in beta.
+
+## 1.9.0 - 2024-05-29
+
+### Added
+
+- Added the ability to read/write video via the [Selection API](https://www.canva.dev/docs/apps/selection/).
+
+## 1.8.0 - 2024-05-06
+
+### Added
+
+- NativeVideoElement is now supported in app elements. See the [documentation](https://www.canva.dev/docs/apps/creating-app-elements/).
+
+## 1.7.0 - 2024-04-10
+
+### Added
+
+- Added [design.getDesignToken](https://www.canva.dev/docs/apps/using-design-ids) which was previously in beta. See the [documentation](https://www.canva.dev/docs/apps/using-design-ids).
+
+## 1.6.0 - 2024-02-25
+
+## 1.5.0 - 2024-02-12
+
+### Changed
+
+- Updated `fontWeight` of `startDrag` to allow more values.
+- Exported some additional types, such as `FontWeight` and `TextAttributes`.
+
+## 1.4.0 - 2023-12-13
+
+### Removed
+
+- Removed video elements from `AppElementRendererOutput`.
+
+### Fixed
+
+- Excluded `undefined` in `Array` type, and removed `bigint`, `Set`, and `Map` types from `AppElementData` to align with existing internal validation.
+
+## 1.3.0 - 2023-12-12
+
+### Added
+
+- Initial NPM release of `@canva/design` package.