Changelog

2024-09-09

🐞 Fixed

• Remove unnecessary invocations of getUrl.

2024-09-05

🐞 Fixed

• Fixed container thumbnail image squeezed narrow when the container's name is long.

2024-08-27

🧰 Added

• Allow the Image, Audio and Video listed in FindResourcesResponse to not provide a url. When the resource does not have a url, it has to provide a getUrl: () => Promise<string> callback that when invoked, resolves to the URL. This is useful if you need to take extra steps to decide the URL of asset you are trying to upload, for example, if you need to make an additional HTTPS request to fetch the URL.

🔧 Changed

• If the durationMs for Audio is 0 or unspecified, the template will try to detect the actual duration of the audio by loading the audio metadata in virtual DOM.

2024-08-13

🧰 Added

• Add an additional parameter, designTitle?: string to saveExportedDesign. The designTitle will be the title of exported design, if it has been set by user.

2024-07-23

🐞 Fixed

• Fixed attachment badge being stretched on Firefox and Safari.

🔧 Changed

• If enableAppStatePersistence is turned on and user last navigated to the export design page, do not take user back to export page when they open the app again. Instead take user to the page before export.

2024-07-08

Added

• Added dragAndDropPreview to Image, Video and Embed resource types. It can be used to specify a fall-back image for preview when user is dragging an asset to the design, when the image at thumbnail.url does not allow canva.com as an origin.
• Trigger a refetch of resources when user has successfully exported their Canva design, so that the newly exported design will be reflected.
• Allow user to click the tags on the item details page to trigger a search:
  • if the app supports filtering by tag and the current tag is available as an option, start a search by filtering with this tag;
  • if the app does not support filtering by tag or the current tag is not an available option, start a keyword search with the tag's text label.

🐞 Fixed

• Ensure the page has a bottom padding of 16px when there are no more resources to be loaded.
• Ensure user can still navigate to the asset details page when the id contains special character.

2024-06-18

🧰 Added

• Added tab field in FindResourcesRequest to indicate which tab user is currently at, so that the app backend can choose to provide different resources for different tab, even when multiple tabs are showing the same resource type.
• Added tabs field for ContainerType, so that each container type can have their customized tabs.

🐞 Fixed

• Fix typo for "Asset" -> "Assets" tab label inside containers.
• Allow apps to display the more info bubble even when there are no tabs.

🔧 Changed

• Changed tabValues field for OVERVIEW tab optional, and default to all tabs on the current page.

2024-05-30

🔧 Changed

• Updated @canva/app-ui-kit version to 3.5.1 (changelog)

🐞 Fixed

• Fixed search menu overlapping tabs when tab carousel appears

2024-05-03

🔧 Changed

• Reduced the top space of back buttons to give more space for content.

🐞 Fixed

• Fixed export requested multiple times if no container needs to be selected for export.

2024-04-26

🧰 Added

• Added support for customizable tabs.
• Added support for an optional exit button.

🔧 Changed

• Improve mobile experience with filter form.

2024-04-11

🔧 Changed

• Improved the drag-and-drop experience in list layout by making the whole list item draggable.
• Restrict the maximum width for the preview image for drag-and-drop to 200px.

🐞 Fixed

• Fixed item details button not visible enough in light mode.

2024-04-09

🧰 Added

• Included Audio to exported resource types.

🔧 Changed

• Improved toolkit UI.

2024-04-08

🧰 Added

• Added support for audio resource.
• Added two optional config, resourcesPerPage and containersPerPage.

🐞 Fixed

• Fixed type cannot be resolved correctly as ESM modules.
• Fixed inconsistent width of the scrollable area when user has different OS or browser settings for scrollbar.

2024-03-26

Fixed

• Fixed uploading of asset will fail if the asset id contains non-alphanumeric characters.

2024-03-21

🧰 Added

• Add support for dynamically fetch filters during run time.
• Allow Image, Video and Embed resources to have attachments, allow user to add image/video/embed attachments to their design, and open any other attachment types in a new tab.

🔧 Changed

• Show export button when user has navigated inside a container or search result page.

2024-03-11

🔨 Breaking changes

• Change Tag type to be value-label instead of id-name to be consistent with all other filters
• Remove getFilterTags callback from props (we have a more powerful alternative coming out soon)

🐞 Fixed

• Fixed clearing filter does not exit search result page when query string is empty.
• Make scroll smooth when hiding sort bar.

2024-03-07

🐞 Fixed

• Fix SearchableListView overflow caused by paddings.
• Fix progress bar starting too early for export.
• Add empty message when there are no containers to choose for export.

2024-03-06

🐞 Fixed

• Make sure placeholders have consistent shape and layout as assets.
• Remove border from video cards.
• Fix export page broken because ToastProvider is unavailable.
• Fix sort menu blinks when repeatedly triggering scroll event.

2024-03-05

🔧 Changed

• UI improvement: Improve masonry display and infinite scrolling using react-infinite-scrollers and Masonry component from @canva/app-ui-kit.
• UI improvement: Combine error or empty message into one on the "All" tab when no results are available.

2024-03-01

🐞 Fixed

• Fix updateDate and createDate cannot be shown on item details view, when provided a date string instead of Date object
• Fix filter button dis-positioned for some users

2024-02-28

🔨 Breaking changes

• Rename config.search.filterFormConfig.containerTypeFilters to config.search.filterFormConfig.containerTypes

🔧 Added

• Apply generic type ContainerTypeKey on config.search.filterFormConfig.containerTypes, config.export.containerTypes, findResourcesRequest.containerTypes and findResourcesRequest.parentContainerType

2024-02-27

🔨 Breaking changes

• Renamed filter fieldName to label

🧰 Added

• Added additional ListingSurface option for config.containerTypes, "SEARCH". Once included in listingSurfaces of a container type, this container type can be listed in the search results when user is searching using query/filters.

• Added additional parentContainerType field in FindResourcesRequest, this field be provided in the request when searching for results from inside a container.

🐞 Fixed

• Fixed search suggestion will pop out unexpectedly when user types in filter form

• Fixed redundant retry attempts when FindResourcesCallback returns an error

2024-02-22

🔨 Breaking changes

• Replaced all exported enums with type unions of string literals.
• Removed unnecessarily exported types.

🐞 Fixed

• Fixed importing the package from a node.js environment not working by removing React component from node.js environment export.