npm - @spiffcommerce/core - Versions diffs - 37.0.3 → 37.1.0 - Mend

@spiffcommerce/core 37.0.3 → 37.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -14,6 +14,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `Fixed` for any bug fixes.
 - `Security` in case of vulnerabilities.
+## [37.1.0] - 10-03-2026
+### Added
+- `VariantResource` now has the field `category`, and `Variant` now has the utility method `getCategory`.
+- A number of step handles now have a new method `isVariantCategoriesEnabled(): boolean`, which should be called to determine if the variants from their respective options should be categorized using the variant's associated `category` field.
+## [37.0.2] - 05-03-2026
+### Fixed
+- Resolved a frame step loading issue where missing option variants would prevent the default variant from being selected, causing visual artifacts (squares) to appear.
+## [37.0.1] - 04-03-2026
+### Changed
+- Don't delete workflows in read only mode
+### Fixed
+- Don't apply changes to bundle in readonly mode
 ## [37.0.0] - 04-03-2026
 ### Added
@@ -26,13 +49,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `Bundle` methods `getIntegrationProductIds`, `addIntegrationProductId`, and `removeIntegrationProductIds`.
 - `Bundle` events: `bundle-integration-products-added` and `bundle-integration-products-removed`.
+## [36.1.1] - 03-03-2026
+### Changed
+- Updated the internal preview dependency to the latest version.
 ## [36.1.0] - 02-03-2026
 ### Added
 - The option service now has the method `getTagsForAssets`.
-## [35.0.0] - 24-02-2026
+## [36.0.0] - 02-03-2026
+### Changed
+- Refactored the `WorkflowManager`, `Bundle`, and option service internals to remove deprecated 3D transform management code, streamline default variant initialization, and extract lower-level helper functions into separate utility files for reduced file bloat.
+- Moved `getDefaultVariant` from a standalone utility into the `OptionService` class, now accepting an optional `overrideDefaultVariantId` parameter for consistent default variant resolution across all step types.
+## [35.0.1] - 01-03-2026
+### Changed
+- Updated the internal preview dependency to the latest version.
+## [35.0.0] - 01-03-2026
 ### Added
@@ -52,6 +94,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `overrideTheme` has been removed from the workflow request payload.
 - The unused `introduction` implicit step type has been removed.
+## [34.4.10] - 25-02-2026
+### Changed
+- GraphQL requests now skip fetching the integration object when the operation context indicates it is not needed, reducing unnecessary network calls when loading existing workflows.
+### Fixed
+- Fixed an issue where the integration was not correctly fetched when loading an existing workflow, by switching from an internal synchronous accessor to the full asynchronous `getIntegration()` method.
+## [34.4.9] - 24-02-2026
+### Changed
+- The integration object is now fetched via the internal synchronous accessor during GraphQL context setup, avoiding a redundant network request on every API call.
+### Fixed
+- Resolved a recursion bug in the client's integration fetching logic by introducing a dedicated `getIntegrationInternal()` method that returns the cached integration without triggering a re-fetch loop.
 ## [34.4.8] - 24-02-2026
 ### Changed
@@ -70,7 +132,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Now handles global configuration colors for illustration steps with one color channel.
-## [34.4.5] - 13-02-2026
+## [34.4.5] - 11-02-2026
 ### Changed
@@ -82,6 +144,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Ensure mandatory flag is set for already set variants on reload.
+## [34.4.3] - 20-01-2026
+### Fixed
+- Fixed an issue where stroke would not init properly on text step
 ## [34.4.2] - 20-01-2026
 ### Fixed
@@ -94,13 +162,55 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Question steps now correctly respect the default variant override
+## [34.4.0] - 10-12-2025
+### Changed
+- Default variant resolution across all step types (frame, illustration, picture, shape, question, text) now respects the `overrideDefaultVariantId` field on each step, allowing workflows to specify a non-standard default variant for any option.
 ## [34.3.1] - 10-12-2025
 ### Fixed
 - Designs will now be updated on the server when the user modifies the design after initial creation.
-## [34.0.0] - 12-11-2025
+## [34.3.0] - 03-12-2025
+### Added
+- New `findBundleForTransactions` GraphQL query that looks up the associated bundle for a given list of transaction IDs, enabling the ability to edit individual bundle transactions.
+## [34.2.0] - 02-12-2025
+### Changed
+- Internal changes and improvements.
+## [34.1.0] - 21-11-2025
+### Changed
+- Design creation API requests now include the partner's `X-Spiff-Beta` header when the partner has the beta flag enabled, ensuring beta features are available during the design creation process.
+## [34.0.3] - 19-11-2025
+### Fixed
+- Fixed a GraphQL variable name mismatch in the `confirmWorkflowStates` query that was causing the workflow state confirmation step to fail during design creation.
+## [34.0.2] - 19-11-2025
+### Fixed
+- Workflow state confirmation requests are now batched into chunks of 100 transactions to prevent excessively large GraphQL requests when creating designs for bundles with many transactions.
+## [34.0.1] - 19-11-2025
+### Changed
+- SVG illustration elements without an explicit `fill` attribute now inherit the fill from their closest ancestor element (checking inline styles first, then attributes), rather than always defaulting to black. This improves color accuracy for nested SVG elements in illustration steps.
+## [34.0.0] - 13-11-2025
 ### Changed
@@ -112,18 +222,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `createDesign` is no longer available and anything that relied upon it has been wired to the bulk
   function which can handle creating multiple designs at once.
+## [33.13.5] - 13-11-2025
+### Removed
+- Revert "Black fill fix (#355)"
 ## [33.13.4] - 12-11-2025
 ### Fixed
 - Fix persisted state becoming clobbered when performing multiple calls to `client.getWorkflowExperiences` in parallel.
-## [33.13.3] - 12-11-2025
+## [33.13.3] - 11-11-2025
 ### Fixed
 - Corrected non-deterministic behavior with (de)serializing layout states for frame steps with multiple regions.
+## [33.13.2] - 11-11-2025
+### Added
+- The `externalOrderId` and `internalOrderId` fields are now fetched as part of the bundle's base GraphQL fields, making order identification data available on the `Bundle` type.
 ## [33.13.1] - 10-11-2025
 ### Fixed
@@ -148,6 +270,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added new method to `Bundle`: `removeIntegrationProductIds(ids: string[]): Promise<void>`
+## [33.10.0] - 07-11-2025
+### Added
+- `Bundle` initialization now accepts an optional `transactionLoadProgressCallback` parameter of type `(loaded: number, total: number) => void`, which fires as existing workflow experiences are loaded, allowing consumers to display a loading progress indicator.
 ## [33.9.0] - 06-11-2025
 ### Changed
@@ -160,7 +288,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Improved performance when loading many WorkflowExperiences at the same time.
-## [33.8.3] - 03-11-2025
+## [33.8.4] - 03-11-2025
+### Fixed
+- Corrected address validation utility functions that could incorrectly return `undefined` instead of a valid result.
+## [33.8.3] - 02-11-2025
 ### Fixed
@@ -170,12 +304,66 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `Bundle.addIntegrationProductId` is now asynchronous.
+## [33.8.2] - 31-10-2025
+### Added
+- The option GraphQL fragment now includes the `integrationOptions` field (with `id` and `integrationId`), making integration-specific option data available when loading workflow steps.
+## [33.8.1] - 30-10-2025
+### Added
+- New events for changing product and recipient on experience
 ## [33.8.0] - 29-10-2025
 ### Added
 - Custom data fields on Conversion Configurations may now optionally link to an Option. You should use this Option to drive the selections and provide the selected variant ID as the user's selection when updating a recipient. This process may be more strongly enforced in the future.
+## [33.7.0] - 29-10-2025
+### Added
+- New `clearProduct()` method on `WorkflowExperience` that removes the currently assigned product and workflow from the experience, resetting the transaction's product and integration product fields on both the client and server.
+## [33.6.0] - 28-10-2025
+### Added
+- New exported function `getIntegrationProducts(ids: string[])` that fetches integration products by their IDs, returning each product's `id` and associated `product.id` and `product.name`.
+## [33.5.3] - 28-10-2025
+### Fixed
+- Await async method in applyGlobalPropertyState
+## [33.5.2] - 28-10-2025
+### Removed
+- Reverted the automatic black fill assignment for SVG elements without explicit fills, as this caused unintended rendering of illustration steps.
+## [33.5.1] - 24-10-2025
+### Fixed
+- The `quantity` field is now included in the transaction read query, ensuring quantity data is available when loading existing transactions.
+## [33.5.0] - 23-10-2025
+### Added
+- A new callback is now fired when a transaction has been fully initialized during workflow experience creation, allowing consumers to be notified when the transaction is ready for interaction.
+## [33.4.2] - 23-10-2025
+### Fixed
+- The `bundleStateData` field is now included in the `duplicateBundle` GraphQL mutation response, ensuring bundle state is preserved when duplicating a bundle.
 ## [33.4.1] - 21-10-2025
 ### Fixed
@@ -188,12 +376,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Bundles now have an `updatedAt` field, which is automatically updated on the server whenever changes are made.
-## [33.2.4] - 21-10-2025
+## [33.2.4] - 20-10-2025
 ### Fixed
 - Recipient information is now populated correctly when creating new transactions via `getWorkflowExperience` with `GetWorkflowFromIntegrationProductOptions` or `GetWorkflowFromExternalProductOptions`.
+## [33.2.3] - 20-10-2025
+### Fixed
+- Removed overly strict validation checks on optional `quantity` and `recipient` parameters when creating workflow experiences, which were preventing valid calls with partial data from succeeding.
+## [33.2.2] - 20-10-2025
+### Fixed
+- Quantity and recipient now supported on all create cases
+## [33.2.1] - 20-10-2025
+### Fixed
+- Quantity & recipient data not reading on blank workflows
 ## [33.2.0] - 20-10-2025
 ### Changed
@@ -206,7 +412,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Global aspects that are transitively conditional now get cleared correctly when deactivated.
-## [33.0.0] - 14-10-2025
+## [33.0.0] - 19-10-2025
 ### Changed
@@ -219,7 +425,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added GraphQL mutation for updating a transaction's integration product, enabling backend synchronization of integration product changes.
 - Added `getState()` method to `BundleStateManager` for easier external access to the current bundle state.
-## [32.4.0] - 16-10-2025
+## [32.4.0] - 15-10-2025
 ### Added
@@ -237,7 +443,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added the new global function `deleteBundle` which takes a bundle id string and deletes the marks the bundle as deleted on the server.
-## [32.2.6] - 08-10-2025
+## [32.2.7] - 08-10-2025
+### Fixed
+- Calling `finish()` on a completed bundle now correctly re-computes and returns the full design creation results instead of returning an empty items array on subsequent calls.
+## [32.2.6] - 01-10-2025
 ### Fixed
@@ -283,12 +495,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - When calling `overrideWorkflowExperienceRecipientAddress`, the associated Transaction's `addressValidationStatus` is updated locally.
+## [32.1.1] - 23-09-2025
+### Fixed
+- Exported additional type definitions from the package index to make newly added types available to consumers.
 ## [32.1.0] - 23-09-2025
 ### Added
 - Added new `overrideWorkflowExperienceRecipientAddress` function to override the address of a specific workflow experience recipient.
+## [32.0.2] - 22-09-2025
+### Fixed
+- The `updateRecipient` method now uses nullish coalescing (`??`) instead of logical OR (`||`) when merging recipient fields, allowing empty strings to correctly clear field values instead of being ignored.
+## [32.0.1] - 22-09-2025
+### Changed
+- Internal changes and improvements.
+## [32.0.0] - 16-09-2025
+### Changed
+- Added `getMandatoryUnfulfilledSteps()` method to `WorkflowManager` that returns the step names of all active mandatory steps that have not yet been fulfilled. Also exposed `traversableScenes()` as a public method on `WorkflowManager`.
 ## [31.4.0] - 10-09-2025
 ### Added
@@ -301,17 +537,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - The function `ProductCollection.fetchProductsFeed` now supports an additional metafield filters parameter for filtering via attached workflows.
-## [31.2.4] - 04-09-2025
+## [31.2.4] - 07-09-2025
 ### Fixed
 - Vertical text steps now respect region boundaries, even if the text is really long.
-## [30.2.2] - 01-09-2025
+## [31.2.3] - 01-09-2025
-### Added
+### Fixed
-- The `collectionId` field will now be available on the complete event.
+- The `collectionId` field is now included in the `BundleDesignCreationMessage` returned by `Bundle.finish()`, ensuring the product collection ID is available in the completion event data.
 ## [31.2.2] - 01-09-2025
@@ -320,17 +556,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Text steps with templated input should have their font correctly resized in appropriate situations.
 - The templating context for a WorkflowManager now correctly provides first/last name fields with a custom `uniqueIdentifier`.
-## [30.2.1] - 01-09-2025
+## [31.2.1] - 01-09-2025
 ### Added
-- The `name`, `dispatchDate`, `purchaseOrder` and `collectionName` fields will now be available on the complete event.
+- The `BundleDesignCreationMessage` returned by `Bundle.finish()` now includes the `name`, `dispatchDate`, `purchaseOrder`, and `collectionName` fields, providing richer context in the completion event for iframe consumers.
-## [30.2.0] - 01-09-2025
+## [31.2.0] - 01-09-2025
 ### Added
-- The `getOrCreateCustomer` call will fetch an existing customer's product collection customers.
+- The product collection GraphQL fragment now fetches `productCollectionCustomers` with their associated `customer.id`, making customer association data available when loading product collections.
 ## [31.1.0] - 01-09-2025
@@ -344,12 +580,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Latest versions of internal build tools and libraries. EG. Vite and ESLint
+## [30.2.2] - 01-09-2025
+### Added
+- The `collectionId` field will now be available on the complete event.
+## [30.2.1] - 01-09-2025
+### Added
+- The `name`, `dispatchDate`, `purchaseOrder` and `collectionName` fields will now be available on the complete event.
+## [30.2.0] - 01-09-2025
+### Added
+- The `getOrCreateCustomer` call will fetch an existing customer's product collection customers.
+## [30.0.1] - 27-08-2025
+### Changed
+- Removed an unnecessary Preact import from the Bundle module.
+- When global property state is fully re-applied to a bundle, mandatory handle change events are now correctly fired, ensuring the UI reflects the current mandatory status of all global property handles.
 ## [30.0.0] - 27-08-2025
 ### Added
 - The `updateRecipient` method now has extra arguments, primarily for custom fields.
+## [29.4.0] - 27-08-2025
+### Changed
+- The recipient create and update GraphQL mutations now support additional fields: `apartment`, `customField1` through `customField5`, and `conversionConfigurationId`, enabling custom recipient column data to be stored and retrieved.
 ## [29.3.0] - 27-08-2025
 ### Added
@@ -365,7 +632,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added the function `TextGlobalPropertyHandle.isTemplatingEnabled(): boolean`. Use this to determine whether you should display any templating tools.
-## [29.1.2] - 25-08-2025
+## [29.1.2] - 24-08-2025
 ### Changed
@@ -377,6 +644,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Inputting an incorrect code when calling `verifyCode` will no longer prevent you from succeeding if you then input the correct code in a subsequent request.
+## [29.1.0] - 19-08-2025
+### Changed
+- Added persona-related fields to the GraphQL query definitions, enabling the persona form builder feature for customized user input collection.
 ## [29.0.4] - 14-08-2025
 ### Fixed
@@ -402,12 +675,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Missing `ExportedStepData` types.
-## [29.0.0] - 06-08-2025
+## [29.0.0] - 07-08-2025
 ### Changed
 - The `getExportedData` method has been renamed `getExportedStepData` for clarity, it now returns a list of steps and their metadata chronological to the workflow. Localization has also been removed as this is a theme concern.
+## [28.0.2] - 31-07-2025
+### Fixed
+- Fixed an issue where reloading a bundle would not correctly restore the global property state, by ensuring state is re-applied to the client after re-initialization.
+## [28.0.1] - 30-07-2025
+### Fixed
+- Fixed bundle reload incorrectly overwriting existing global property state with defaults. Default variant initialization now checks if an aspect already has a value before applying the default, preventing saved state from being clobbered on reload.
 ## [28.0.0] - 30-07-2025
 ### Changed
@@ -442,7 +727,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Correctly the case of handle multiple text steps that are conditional and share a text aspect.
-## [27.1.0] - 16-07-2025
+## [27.1.0] - 17-07-2025
 ### Changed
@@ -454,104 +739,248 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Modified the functions for logging in as a customer.
-## [26.40.0] - 10-07-2025
+## [26.42.1] - 14-07-2025
 ### Added
-- Added `setDispatchDate` and `setPurchaseOrder` to `Bundle`.
+- New exported function `getGlobalPropertyStateForBundle(bundleId: string)` that fetches the raw `GlobalPropertyState` for a given bundle ID via GraphQL, enabling external access to a bundle's global property state without needing a full bundle instance.
-## [26.39.0] - 08-07-2025
+## [26.42.0] - 14-07-2025
-### Fixed
+### Changed
-- The function `fetchProductsFeed` on `ProductCollection` now correctly reads from the in-memory cache for repeated calls with the same inputs.
+- Internal changes and improvements.
-## [26.38.0] - 07-07-2025
+## [26.41.2] - 13-07-2025
-### Added
+### Fixed
-- `WorkflowManager` now has the function `addRecipientCallback` to listen to changes to the attached Recipient.
+- The customer bundles feed GraphQL query now includes the `globalPropertyConfiguration.id` field, ensuring the global property configuration ID is available when listing bundles for a customer.
-## [26.35.0] - 03-07-2025
+## [26.41.1] - 10-07-2025
-### Added
+### Fixed
-- The `Bundle` type now has the `productsCount` property.
+- The bundle read and duplicate GraphQL queries now include the `template` field, and the update bundle mutation has been reformatted for clarity with proper multi-line variable definitions.
-## [26.33.0] - 02-07-2025
+## [26.41.0] - 10-07-2025
 ### Added
-- The method `getBundlesForCustomer` now has an "ordered" option.
+- New `getTemplate(): boolean` method on `Bundle` that indicates whether the bundle is a template. Also added `getCurrentStakeholder()` method documentation and the `getQuoteId()` JSDoc.
-## [26.31.0] - 24-06-2025
+## [26.40.0] - 09-07-2025
-### Fixed
+### Added
-- Fixed issues with authorizing certain requests affecting recipients.
+- Added `setDispatchDate` and `setPurchaseOrder` to `Bundle`.
-## [26.30.0] - 23-06-2025
+## [26.39.1] - 09-07-2025
-### Added
+### Changed
-- New global function `getProductCollections`, which fetches a list of Product Collections by their ids.
+- The `AddressComponent` type is now exported from the package, allowing consumers to use the address validation component types directly.
-## [26.29.3] - 19-06-2025
+## [26.39.0] - 08-07-2025
 ### Fixed
-- The method `updateRecipient` now saves its arguments correctly.
+- The function `fetchProductsFeed` on `ProductCollection` now correctly reads from the in-memory cache for repeated calls with the same inputs.
-## [26.29.1] - 18-06-2025
+## [26.38.0] - 07-07-2025
-### Fixed
+### Added
-- Fix issues with bleeding-edge endpoints.
+- `WorkflowManager` now has the function `addRecipientCallback` to listen to changes to the attached Recipient.
-## [26.29.0] - 18-06-2025
+## [26.37.0] - 07-07-2025
 ### Added
-- The method `updateRecipient` on `WorkflowManager`.
+- The `totalPriceSubunits` field is now included in the customer bundles feed GraphQL query, making the total price available when listing bundles for a customer.
-## [26.28.0] - 18-06-2025
+## [26.36.0] - 03-07-2025
 ### Added
-- The methods `filterProducts` and `fetchProductsFeed` on `ProductCollection` now accept the optional parameters `sortKey` and `sortDescending`. Sort key can be one of: Default, Name, Price.
+- The `company` field is now supported in recipient create and update operations, and the `updateRecipient` method on `WorkflowManager` now accepts an optional `company` parameter.
-## [26.27.0] - 11-06-2025
+## [26.35.0] - 03-07-2025
 ### Added
-- The methods `filterProducts` and `fetchProductsFeed` on `ProductCollection` now accept an optional parameter `tags`, which is an object with the shape `{ include: string[]; exclude: string[]; }`. Only products that have all tags in `include` and no tags in `exclude` will be returned. If either array is provided as empty they will have no effect on the query.
+- The `Bundle` type now has the `productsCount` property.
-## [26.26.0] - 27-05-2025
+## [26.34.0] - 02-07-2025
 ### Changed
-- The event emitter on `Bundle` has been improved and made generic. Two new events will also now fire. One for a workflow being added and one for a workflow being removed.
+- Introduced a new `addressValidation` module with functions for validating recipient addresses against configured address validation rules, including the exported `AddressComponent` type and validation utilities.
+## [26.33.0] - 02-07-2025
 ### Added
-- The `MetafieldManager` is now exposed for use. Certain functions such as CollectionProduct will now expose utility functions that allow pulling the metafields for the entity being called on.
+- The method `getBundlesForCustomer` now has an "ordered" option.
-## [26.24.0] - 12-05-2025
+## [26.32.2] - 02-07-2025
-### Changed
+### Added
-- The functions `getIntegrationProductById` and `getIntegrationProductFromExternalIds` now accept an additional boolean parameter that allows you to fetch all of the linked integration products on the product you have requested.
+- The customer bundles feed GraphQL query now includes `createdAt`, `transactionsCount`, `quoteId`, and `orderId` fields, providing richer data when listing bundles for a customer.
-### Fixed
+## [26.32.1] - 02-07-2025
+### Changed
+- Exported additional raw bundle-related type definitions from the package index.
+## [26.32.0] - 25-06-2025
+### Added
+- The `mobile` field is now supported in recipient create and update operations, and the `updateRecipient` method on `WorkflowManager` now accepts an optional `mobile` parameter.
+## [26.31.0] - 24-06-2025
+### Fixed
+- Fixed issues with authorizing certain requests affecting recipients.
+## [26.30.2] - 24-06-2025
+### Changed
+- Exported the `Recipient` type from the package index, making it available for consumers to use directly.
+## [26.30.1] - 23-06-2025
+### Added
+- The integration product GraphQL query now includes the `name` field on the associated product, making the product name available when fetching integration products.
+## [26.30.0] - 23-06-2025
+### Added
+- New global function `getProductCollections`, which fetches a list of Product Collections by their ids.
+## [26.29.4] - 20-06-2025
+### Changed
+- Internal changes and improvements.
+## [26.29.3] - 19-06-2025
+### Fixed
+- The method `updateRecipient` now saves its arguments correctly.
+## [26.29.2] - 18-06-2025
+### Fixed
+- Fixed the `updateRecipient` method not correctly persisting the recipient ID after creating a new recipient, which prevented subsequent recipient updates from targeting the correct record.
+## [26.29.1] - 18-06-2025
+### Fixed
+- Fix issues with bleeding-edge endpoints.
+## [26.29.0] - 18-06-2025
+### Added
+- The method `updateRecipient` on `WorkflowManager`.
+## [26.28.0] - 18-06-2025
+### Added
+- The methods `filterProducts` and `fetchProductsFeed` on `ProductCollection` now accept the optional parameters `sortKey` and `sortDescending`. Sort key can be one of: Default, Name, Price.
+## [26.27.1] - 18-06-2025
+### Changed
+- GraphQL network requests now correctly handle server redirects by detecting opaque redirect responses and re-sending the request to the appropriate regional endpoint (Moonlight), preventing failed API calls when the server issues a redirect.
+## [26.27.0] - 11-06-2025
+### Added
+- The methods `filterProducts` and `fetchProductsFeed` on `ProductCollection` now accept an optional parameter `tags`, which is an object with the shape `{ include: string[]; exclude: string[]; }`. Only products that have all tags in `include` and no tags in `exclude` will be returned. If either array is provided as empty they will have no effect on the query.
+## [26.26.1] - 28-05-2025
+### Changed
+- Removed verbose console logging from global property variant selection methods that was producing excessive output during normal operation.
+## [26.26.0] - 27-05-2025
+### Changed
+- The event emitter on `Bundle` has been improved and made generic. Two new events will also now fire. One for a workflow being added and one for a workflow being removed.
+### Added
+- The `MetafieldManager` is now exposed for use. Certain functions such as CollectionProduct will now expose utility functions that allow pulling the metafields for the entity being called on.
+## [26.25.0] - 21-05-2025
+### Added
+- Add metafield helper to collection products, include metafieldmanager
+## [26.24.0] - 12-05-2025
+### Changed
+- The functions `getIntegrationProductById` and `getIntegrationProductFromExternalIds` now accept an additional boolean parameter that allows you to fetch all of the linked integration products on the product you have requested.
+### Fixed
 - The `duplicateBundle` call no longer fails due to missing GraphQl fragments.
+## [26.23.4] - 12-05-2025
+### Fixed
+- Removed the strict file extension vs MIME type validation check for frame pattern images, as it was incorrectly rejecting valid image files whose extension did not exactly match their detected MIME type.
+## [26.23.3] - 05-05-2025
+### Changed
+- Bundle state serialization now recursively strips the `__typename` field from the state object before persisting, preventing GraphQL metadata from being included in the stored state string.
 ## [26.23.2] - 16-04-2025
 ### Fixed
 - The `duplicateBundle` will now correctly duplicate the global property state.
+## [26.23.1] - 14-04-2025
+### Fixed
+- Fixed product collection filtering to correctly match products, resolving an issue where certain collection products were not being returned in filter results.
+## [26.23.0] - 09-04-2025
+### Changed
+- Added new fields to the workflow/panel query types to support 2D panel configuration data on workflows.
+## [26.22.1] - 07-04-2025
+### Changed
+- Updated the Preact dependency to a newer version.
 ## [26.22.0] - 07-04-2025
 ### Changed
@@ -570,7 +999,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - The `getQuoteCompleteMessage` method on bundles. Pass the return value of this method to Theme Bridge's `SpiffThemeLoader.completeQuote` method.
-## [26.20.0] - 31-03-2025
+## [26.20.0] - 30-03-2025
 ### Added
@@ -582,7 +1011,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - `getOriginalColors`: Returns a promise that resolves with the original color configuration of the image asset.
     - `changeColors`: Updates the current color configuration and propagates the changes to all connected workflow experiences.
-## [26.19.0] - 26-03-2025
+## [26.19.0] - 25-03-2025
 ### Added
@@ -594,24 +1023,54 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added `OneToOne` mode to `BundleDesignCreationCartAddMode`, which adds each Transaction of a Bundle to the cart as individual line items.
+## [26.17.1] - 24-03-2025
+### Changed
+- Internal changes and improvements.
 ## [26.17.0] - 24-03-2025
 ### Added
 - The object returned by `Bundle.finish()`, `BundleDesignCreationMessage`, has a new field `cartAddMode?: BundleDesignCreationCartAddMode`. This controls the strategy for adding the items of a Bundle to an ecommerce cart.
-## [26.16.1] - 18-03-2025
+## [26.16.2] - 18-03-2025
+### Changed
+- Internal changes and improvements.
+## [26.16.1] - 17-03-2025
 ### Changed
 - If both the partner and workflow have terms and conditions, the workflow wins.
+## [26.16.0] - 16-03-2025
+### Changed
+- The `minimumOrderQuantity` field is now fetched as part of product queries, making minimum order quantity data available on products for validation and display purposes.
+## [26.15.1] - 05-03-2025
+### Changed
+- The `assignProductCollection` method on `Bundle` now always updates the local product collection reference and re-initializes the global property configuration, even if one was already set, allowing product collections to be reassigned.
 ## [26.15.0] - 03-03-2025
 ### Added
 - Methods on experiences and bundles to attach addresses and organizations.
+## [26.14.0] - 02-03-2025
+### Fixed
+- Fixed bundle loading to correctly handle readonly mode by skipping default variant initialization, and improved global property state initialization to properly handle cases where the state is not yet available. Also improved channel calculation for illustration steps in global configurations.
 ## [26.13.0] - 27-02-2025
 ### Changed
@@ -630,43 +1089,73 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - The `createPreviewImage` parameter in `Bundle.finish()` is now provided a second argument, `shouldRender3D: boolean`, which can be passed to `WorkflowExperience.createPreviewImage()`
-## [26.10.0] - 24-02-2025
+## [26.10.0] - 23-02-2025
 ### Added
 - Ability to handle illustrations with asset configurations.
+## [26.9.2] - 20-02-2025
+### Changed
+- Internal changes and improvements.
 ## [26.9.1] - 20-02-2025
 ### Fixed
 - Resolved an issue allowing empty text to pass mandatory checks on the text step.
-## [26.8.0] - 06-02-2025
+## [26.9.0] - 13-02-2025
+### Changed
+- `StepHandle.executeAnimations()` now accepts an optional `immediate` boolean parameter that is passed through to the model container's `executeAnimation` call, allowing animations to be triggered without transition effects.
+## [26.8.1] - 12-02-2025
+### Changed
+- Updated the product terms and conditions query reference in the client.
+## [26.8.0] - 05-02-2025
 ### Fixed
 - Resolved an issue causing clients using module steps not to handle errors correctly.
-## [26.7.9] - 21-01-2025
+## [26.7.9] - 20-01-2025
 ### Fixed
 - Resolved an issue when duplicating a bundle causing any copied workflow experiences to be missing in the javascript class returned.
+## [26.7.8] - 14-01-2025
+### Changed
+- Added diagnostic logging during global property default variant initialization to help trace issues with variant selection timing and state initialization order.
+## [26.7.7] - 14-01-2025
+### Changed
+- Fixed a race condition during bundle initialization where default global property variants were being set concurrently with global property state initialization. Default variant initialization now waits for both the workflow experiences and state to be fully loaded before running.
 ## [26.7.6] - 10-01-2025
 ### Fixed
 - Reverted the previous due to issues with other areas of opentype.
-## [26.7.5] - 10-01-2025
+## [26.7.5] - 09-01-2025
 ### Added
 - Updated opentype to access more functionality around font outlining.
-## [26.7.4] - 19-12-2024
+## [26.7.4] - 09-01-2025
 ### Fixed
@@ -684,6 +1173,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Corrected an issue with `TextStepService.availableFillColors` not returning the correct colors under certain conditions.
+## [26.7.1] - 28-11-2024
+### Fixed
+- Fixed frame step region element targeting to use the correct `FrameStepHandle` frame service when notifying about new elements, resolving issues with frame region element tracking after region changes.
 ## [26.7.0] - 27-11-2024
 ### Added
@@ -691,13 +1186,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Text steps now support custom stroke. Similar to other color customisation features, this is accessible via the functions `getAvailableStrokeColors`, `getStrokeColor`, and `setStrokeColor` on `TextStepHandle`.
   The thickness of the stroke, the colors to select from, and other options, are configurable via the Spiff Hub in the Workflow editor.
+## [26.6.1] - 27-11-2024
+### Fixed
+- Fixed frame step pattern image source resolution to use the correct SVG asset version URL, resolving rendering issues with frame patterns.
+## [26.6.0] - 25-11-2024
+### Changed
+- When a product collection is assigned to a bundle, the global property configuration is now automatically set from the product collection's configuration, linking the bundle to the correct global property setup.
 ## [26.5.2] - 20-11-2024
 ### Fixed
 - Fixed issues regarding EXIF orientation calculation throwing errors under specific conditions.
-## [26.5.1] - 20-11-2024
+## [26.5.1] - 19-11-2024
 ### Fixed
@@ -711,6 +1218,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - ProductCollection has a new function `fetchProductsFeed`, which fetches a paginated array of product collection products (entries in the product collection). Note that this does not edit the internal array of previously fetched products like `fetchProducts` does, so calls to `fetchProductsFeed` will not change the array that is returned by `getProducts`. If `fetchProducts` has already been called, or if the ProductCollection has been initialised with products, `fetchProductsFeed` will avoid making any network calls where it can.
+## [26.4.4] - 15-11-2024
+### Changed
+- SVG path elements generated during font outlining no longer have the `xmlns` attribute set explicitly, as it was causing rendering issues in certain environments.
+## [26.4.3] - 15-11-2024
+### Changed
+- SVG namespace attributes are now set after the element is appended to the DOM during font outlining, ensuring correct namespace resolution.
+## [26.4.2] - 15-11-2024
+### Changed
+- SVG path elements generated during font outlining now have the correct SVG namespace (`xmlns`) explicitly set to ensure cross-browser compatibility.
+## [26.4.1] - 08-11-2024
+### Changed
+- Asset fetch requests now include cache-busting headers to ensure the latest versions of assets are always retrieved from the server.
 ## [26.4.0] - 07-11-2024
 ### Added
@@ -726,6 +1257,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - IllustrationStepHandle now accepts providing PMS values when calling `setColor`
 - IllustrationStepHandle's `getAvailableColors` function now returns the names of the variants as PMS values.
+## [26.2.0] - 04-11-2024
+### Added
+- Added font outlining functionality that converts text glyphs into SVG path elements, enabling text to be rendered as outlines for print and export purposes.
 ## [26.1.2] - 30-10-2024
 ### Fixed
@@ -745,7 +1282,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Several internal functions have been changed, been merged or removed. This should not affect any public API.
 - `rehydrateSerializedLayout` is no longer exported from the package. No functionality is intended to take its place. The function was always intended for internal use only.
-## [26.0.0] - 30-10-2024
+## [26.0.0] - 29-10-2024
 ### Changed
@@ -753,244 +1290,2178 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `configureUrls` has been removed in favor of the `configure` function. Please use `configure` moving forwards.
 - The client constructor should know be called with an application in most use cases. We'll continue locking down functionality to require this in the future.
-## [22.0.0] - 10-07-2024
+## [25.1.4] - 29-10-2024
 ### Changed
-- `matchHexToPms` now returns a list of objects of `{ pms: string; hex: string; }` rather than strings.
+- When loading an existing bundle, global property state is now loaded as part of the bundle initialization process, removing the need for a separate manual load step.
-### Added
+## [25.1.3] - 28-10-2024
-- `findPmsColors(input: string, limit?: number): PmsSearchResult[]`: A function to find PMS colors by name using fuzzy search.
+### Changed
-## [21.8.1] - 27-03-2024
+- Product filtering logic has been moved from the theme layer into the core package, making it available as a shared utility for all consumers.
-### Fixed
+## [25.1.2] - 27-10-2024
-- `WorkflowExperience.getTotalPriceSubunits` no longer always returns the discounted price.
+### Changed
-## [21.8.0] - 26-03-2024
+- Internal changes and improvements.
+## [25.1.1] - 25-10-2024
+### Changed
+- The bundle owner ID is now passed through to workflow experience loading, ensuring correct authorization when loading bundle transactions.
+## [25.1.0] - 25-10-2024
 ### Added
-- `Bundle.removeStakeholder(email: string): Promise<void>`: Removes a single stakeholder from the Bundle, via email address.
+- Ability to check whether customer has bundle templates
-## [21.7.1] - 25-03-2024
+### Changed
-### Fixed
+- Remove legacy reference from default region settings
-- `Bundle.getAllStakeholders()` now returns correct results on subsequent calls.
+## [25.0.9] - 24-10-2024
-## [21.7.0] - 25-03-2024
+### Changed
-### Added
+- Enabled Apollo client caching for certain frequently accessed GraphQL fields to reduce redundant network requests.
+- Optimized bundle initialization by reducing unnecessary re-fetches during the setup phase.
-- `CollectionProduct.getAllWorkflows(): ProductWorkflow[]`: Returns all workflows associated with this product.
+## [25.0.8] - 23-10-2024
-## [21.6.0] - 22-03-2024
+### Changed
+- Improved GraphQL caching strategies to reduce redundant network requests during bundle and workflow operations.
+## [25.0.7] - 23-10-2024
 ### Added
-- `WorkflowExperienceEventType.PriceBreakChanged`: The relevant event fires whenever the price break to be used in a WorkflowExperience changes. This even will fire when the quantity changes, and will also fire when in a Bundle when other WorkflowExperiences using the same Product have quantity changes (or are added & removed from the Bundle).
+- The `completed` field is now available on bundle and transaction entities, indicating whether they have been finalized.
-## [21.5.0] - 22-03-2024
+## [25.0.6] - 22-10-2024
 ### Changed
-- `StepHandle`: The override global property state setting now has a different value for each Global Property Aspect type. The get/set functions have been renamed and have an extra parameter to determine the Aspect Type.
-    - `getOverrideGlobalPreviewConfiguration` -> `getOverrideGlobalPropertyConfiguration(type: AspectType): boolean`.
-    - `setOverrideGlobalPreviewConfiguration` -> `setOverrideGlobalPropertyConfiguration(type: AspectType, value: boolean): void`
+- Step tags are now populated from the workflow definition during step initialization, making tag metadata available on step handles.
-## [21.4.1] - 21-03-2024
+## [25.0.5] - 22-10-2024
 ### Changed
-- `readTransactionsQuery` now fetches `printFileUrl1` to `printFileUrl5` for each transaction.
+- Text step metadata is no longer updated when the text value is invalid or erroneous, preventing corrupted data from being persisted.
-## [21.4.0] - 20-03-2024
+## [25.0.4] - 21-10-2024
 ### Added
-- `StepHandle`:
-    - `getOverrideGlobalPreviewConfiguration(): boolean`: Returns a boolean that indicates whether this step should override (ignore) Global Property state.
-    - `setOverrideGlobalPreviewConfiguration(value: boolean): void`: Modifies whether this step should override (ignore) Global Property state.
-    - `getGlobalPropertyAspects(configurationId: string): string[]`: Returns all Aspect names in the supplied Global Property Configuration that this step is configured to use.
-- `Bundle.getGlobalPropertyConfiguration(): GlobalPropertyConfiguration | undefined`: Returns the Global Property Configuration object associated with the Bundle, if it exists.
+- The bundle stakeholder GraphQL queries now include authentication-related fields, making stakeholder authorization data available on the `BundleStakeholder` type.
-## [21.3.1] - 20-03-2024
+## [25.0.3] - 14-10-2024
 ### Fixed
-- When a `Bundle` is loaded by ID, the `WorkflowExperience` objects it loads will not correctly be linked internally. This resolves issues regarding price breaks not calculating correctly on bundle reload when multiple transactions share a product.
-## [21.3.0] - 20-03-2024
-### Added
+- Fixed an issue where default text values were not being correctly applied to text steps during initial workflow loading.
-- `WorkflowExperience.priceBreakToBeApplied()` returns the percentage that will be used in `WorkflowExperience.getTotalPriceSubunits()` and related methods.
+## [25.0.2] - 14-10-2024
 ### Changed
-- `WorkflowExperience.getTotalPriceSubunits()` and related methods now consider price breaks in their calculations, but also now have a `disablePriceBreaks` argument.
+- Added bundle share page query fields and types, enabling the bundle sharing workflow functionality.
-## [21.2.1] - 15-03-2024
+## [25.0.1] - 09-10-2024
-### Fixed
+### Changed
-- Fixed Global Property Handles not updating values when WorkflowExperiences in the Bundle share the same Workflow.
+- Added diagnostic logging when variants are selected, aiding in troubleshooting variant selection behavior during workflow interactions.
-## [21.2.0] - 15-03-2024
+## [25.0.0] - 30-09-2024
-### Added
+### Changed
-- `FileUploadGlobalPropertyHandle`:
-    - `hasImage(): boolean`: Returns a boolean value indicating if the associated state has an image.
-    - `getImage(): Promise<Asset | undefined>`: Retrieves the current image from the server.
+- Updated the package's public API exports, reorganizing and consolidating the entry points to improve discoverability and remove deprecated exports.
-## [21.1.1] - 15-03-2024
+## [24.0.2] - 18-09-2024
 ### Fixed
-- Exported missing `AspectType` for global property handles.
+- Specify correct data-uri-to-buffer version
-## [21.1.0] - 14-03-2024
+## [24.0.1] - 18-09-2024
-### Added
+### Changed
-- `Bundle.hasGlobalProperties(): boolean`: Returns true when the bundle is linked to a Global Property Configuration.
+- The initial zoom level field is now correctly wired during workflow initialization, ensuring the configured zoom level is applied when the preview loads.
-## [21.0.1] - 13-03-2024
+## [24.0.0] - 17-09-2024
-### Fixed
+### Changed
-- Package now supplies this `CHANGELOG.md` in published releases.
+- Merged the Papyrus rendering engine updates into core, bringing new rendering capabilities and internal API changes. This is a breaking change due to updated Papyrus interfaces.
-## [21.0.0] - 13-03-2024
+## [23.0.5] - 12-09-2024
-### Added
+### Changed
-- `DesignCreationMessage` now has `quantity: number | undefined`.
+- Improved default text handling to more reliably apply default text values when text steps are first activated.
+## [23.0.3] - 12-09-2024
+### Changed
+- Added support for design input step types in the workflow, allowing users to provide design assets as step inputs.
+- Improved error messaging for workflow validation to provide clearer feedback to consumers.
+## [23.0.2] - 08-09-2024
+### Changed
+- Frame step rendering now uses SVG groups for organizing frame region elements, improving layout management and element targeting.
+## [23.0.1] - 08-09-2024
+### Changed
+- Internal changes and improvements.
+## [23.0.0] - 08-09-2024
+### Changed
+- Internal changes and improvements.
+## [22.13.5] - 06-09-2024
+### Changed
+- Workflow error information is now accessible, allowing consumers to retrieve and display any errors that occurred during workflow loading or processing.
+## [22.13.4] - 06-09-2024
+### Changed
+- Internal changes and improvements.
+## [22.13.3] - 05-09-2024
+### Changed
+- Added support for custom color configurations on workflow steps, allowing users to define and apply non-standard colors.
+## [22.13.2] - 04-09-2024
+### Changed
+- Added the `option` field to variant query responses, associating each variant with its parent option for improved data access.
+## [22.13.1] - 04-09-2024
+### Fixed
+- Typo in query
+## [22.13.0] - 03-09-2024
+### Changed
+- Added the `getBundlesForCustomer` function, which fetches all bundles associated with a given customer ID.
+## [22.12.0] - 03-09-2024
+### Changed
+- Internal changes and improvements.
+## [22.11.0] - 03-09-2024
+### Changed
+- Product collection entities now include `description` and `image` fields in their GraphQL queries, making this data available for display in product collection listings.
+## [22.10.1] - 30-08-2024
+### Changed
+- Updated the Pith dependency to fix a whitespace rendering issue in text elements.
+## [22.10.0] - 28-08-2024
+### Changed
+- Text steps now expose error state and helper text data, enabling consumers to display validation feedback and contextual help for text inputs.
+## [22.9.2] - 28-08-2024
+### Fixed
+- Fixed Global Property State not correctly storing the aspect type for all aspect entries, ensuring type metadata is preserved across state operations.
+## [22.9.1] - 28-08-2024
+### Changed
+- Added the `getCustomer` function for fetching customer data by ID, providing a dedicated accessor for customer information.
+## [22.9.0] - 28-08-2024
+### Changed
+- Added the `getCustomerMetafields` function for fetching metafield data associated with a customer, enabling access to custom customer attributes.
+## [22.8.0] - 27-08-2024
+### Changed
+- The `duplicateBundle` function now also duplicates all transactions within the bundle, ensuring a complete copy of the bundle and its workflow experiences is created.
+## [22.7.5] - 27-08-2024
+### Changed
+- A theme configuration is now automatically assigned when creating a new bundle, ensuring the bundle has the correct theme from the start.
+## [22.7.4] - 26-08-2024
+### Changed
+- The `bundleOwnerId` field is now returned in bundle query responses, making the bundle owner's ID available to consumers.
+## [22.7.3] - 26-08-2024
+### Added
+- Added color picker change event handling, allowing consumers to be notified when a user changes a color selection.
+## [22.7.2] - 26-08-2024
+### Changed
+- Frame steps now respect the configured initial zoom level when first loaded, ensuring the correct zoom is applied on frame display.
+## [22.7.1] - 22-08-2024
+### Fixed
+- Fixed `fetchProducts` to correctly return all products in the collection instead of a filtered subset.
+## [22.7.0] - 22-08-2024
+### Added
+- Added a filter for products on fetchProducts
+- Bump FCH test to new AU
+## [22.6.6] - 20-08-2024
+### Added
+- The `allowNewlines` property is now exposed on text step handles, allowing consumers to check whether multi-line text input is permitted.
+## [22.6.5] - 20-08-2024
+### Fixed
+- The `mandatory` property is now exposed on step handles, allowing consumers to check whether a step is required to be completed.
+## [22.6.4] - 19-08-2024
+### Fixed
+- Fix transactionOwnerIds not saving in many create
+## [22.6.3] - 18-08-2024
+### Fixed
+- Fixed mandatory step validation to correctly track fulfillment status when variant selections change.
+## [22.6.2] - 14-08-2024
+### Changed
+- Internal changes and improvements.
+## [22.6.1] - 14-08-2024
+### Changed
+- The eager load option for product collections is now passed through during bundle creation, enabling products to be pre-fetched during initialization.
+## [22.6.0] - 14-08-2024
+### Changed
+- Added the `assignProductCollection` function to `Bundle`, allowing a product collection to be assigned to a bundle after creation.
+## [22.5.3] - 14-08-2024
+### Changed
+- Step tag data is now included in the step query responses, making workflow step tags available for filtering and categorization.
+## [22.5.2] - 14-08-2024
+### Changed
+- The `Integration` type definition is now exported from the package, making it available for consumers who need to reference integration types directly.
+## [22.5.1] - 09-08-2024
+### Fixed
+- Global property aspect filtering now correctly identifies which steps belong to a given global property configuration, resolving issues where steps were incorrectly excluded from global property updates.
+## [22.5.0] - 08-08-2024
+### Changed
+- Updated the `@spiffcommerce/theme-bridge` dependency to the latest version.
+### Fixed
+- Fixed type definitions for theme configuration to match the updated theme-bridge API.
+## [22.4.8] - 05-08-2024
+### Changed
+- Removed the display images feature from the step rendering pipeline, simplifying the step output.
+## [22.4.7] - 01-08-2024
+### Changed
+- Fixed a mutation reload bug that could cause incorrect state after reloading workflow data.
+- Updated the CI configuration for git settings and version bumping during the build process.
+## [22.4.6] - 29-07-2024
+### Changed
+- Updated the Papyrus dependency and added support for uploading and applying custom colors to frame pattern images.
+## [22.4.5] - 29-07-2024
+### Changed
+- Added type definitions and storage mechanisms for custom color configurations, enabling persistence of user-defined colors across sessions.
+## [22.4.4] - 28-07-2024
+### Changed
+- Updated the Papyrus rendering engine dependency to the latest version.
+## [22.4.3] - 26-07-2024
+### Changed
+- Internal changes and improvements.
+## [22.4.2] - 26-07-2024
+### Changed
+- Internal changes and improvements.
+## [22.4.1] - 26-07-2024
+### Fixed
+- Fixed an issue causing global properties to be overriden by workflow initialization
+## [22.4.0] - 25-07-2024
+### Changed
+- Added the `ModuleStepHandle` type for handling module-type workflow steps, enabling interaction with module step data and configuration.
+## [22.3.0] - 24-07-2024
+### Added
+- Transactions now have their theme configuration installed during creation, ensuring the correct theme is available from the start of the workflow.
+### Fixed
+- Fixed theme bridge integration to correctly resolve theme configurations for transactions.
+## [22.2.2] - 24-07-2024
+### Changed
+- Improved frame step rendering with better element positioning and region handling.
+## [22.2.1] - 24-07-2024
+### Changed
+- The `getExportedData` method now groups exported data items by their associated workflow step, providing a more organized output structure.
+## [22.2.0] - 23-07-2024
+### Changed
+- Updated authentication action handling to support new authorization flows and improved token management.
+## [22.1.5] - 18-07-2024
+### Changed
+- Updated the preview fetch mechanism for improved reliability.
+## [22.1.4] - 17-07-2024
+### Changed
+- Reapply global state when conditions change
+## [22.1.3] - 17-07-2024
+### Changed
+- Workflow initialization now correctly awaits global property state loading before proceeding, preventing race conditions during early access to global properties.
+## [22.1.2] - 17-07-2024
+### Changed
+- Updated the Papyrus rendering engine dependency to the latest version.
+## [22.1.1] - 16-07-2024
+### Fixed
+- Don't validate colors when colorpicker not enabled
+## [22.1.0] - 16-07-2024
+### Changed
+- Added support for a maximum color limit on color picker steps, allowing workflows to restrict the number of colors a user can select.
+## [22.0.2] - 12-07-2024
+### Added
+- Added text color global property handle
+## [22.0.1] - 11-07-2024
+### Added
+- Add svg data url support to pattern image frame
+## [22.0.0] - 10-07-2024
+### Changed
+- `matchHexToPms` now returns a list of objects of `{ pms: string; hex: string; }` rather than strings.
+### Added
+- `findPmsColors(input: string, limit?: number): PmsSearchResult[]`: A function to find PMS colors by name using fuzzy search.
+## [21.24.0] - 10-07-2024
+### Changed
+- Added the `DigitalContentStepHandle` type for handling digital content workflow steps, enabling interaction with digital content step data.
+## [21.23.2] - 09-07-2024
+### Changed
+- SVG dimension parsing now correctly handles `width` and `height` attributes specified with `px` unit suffixes, stripping the units before calculating dimensions.
+## [21.23.1] - 09-07-2024
+### Added
+- Update colors when selecting new image
+## [21.23.0] - 09-07-2024
+### Changed
+- Added the ability to remove backgrounds from uploaded images in picture steps, providing a cleaner image composition experience.
+## [21.22.0] - 08-07-2024
+### Fixed
+- Fixed the color picker to correctly update and display the selected color across all relevant step handles.
+## [21.21.5] - 08-07-2024
+### Changed
+- Frame steps now enforce a whitelist of accepted file extensions for uploaded images, preventing unsupported file types from being used.
+## [21.20.5] - 05-07-2024
+### Fixed
+- Missing text on default step load
+## [21.20.4] - 05-07-2024
+### Changed
+- Illustration step color metadata is now included in the exported step data, making color configuration information available for downstream processing.
+## [21.20.3] - 05-07-2024
+### Added
+- Add missing stakeholder fields
+## [21.20.2] - 03-07-2024
+### Changed
+- Added type definitions for `TransactionShareAction`, enabling typed access to transaction sharing action data.
+## [21.20.1] - 03-07-2024
+### Fixed
+- TransactionShareAction type export
+## [21.20.0] - 02-07-2024
+### Changed
+- Frame steps now support SVG colour extraction and customization, allowing users to modify colours within SVG-based frame patterns.
+## [21.19.2] - 27-06-2024
+### Changed
+- Added support for partner-level terms and conditions, allowing partners to define their own terms that are presented during the workflow experience.
+## [21.19.1] - 13-06-2024
+### Changed
+- The `Placeable` type is now exported from the package, making it available for consumers who need to reference placeable element types.
+## [21.19.0] - 12-06-2024
+### Changed
+- Pass design name to transactionCreate requests
+## [21.18.0] - 11-06-2024
+### Changed
+- Function to allow updating of share actions when login changes
+## [21.17.6] - 11-06-2024
+### Changed
+- Added MIME type validation for uploaded files, ensuring only supported file types are accepted during file upload steps.
+## [21.17.5] - 06-06-2024
+### Added
+- API requests now include a Bearer authentication header when a user authentication token is available, enabling authenticated access to protected endpoints.
+## [21.17.4] - 03-06-2024
+### Fixed
+- Fixed product image loading to correctly resolve and display product images from the integration product data.
+## [21.17.3] - 31-05-2024
+### Fixed
+- Fixed an issue where product images were not correctly loaded from the product data, resolving blank or missing product images.
+## [21.17.2] - 30-05-2024
+### Changed
+- Added transaction action types and query fields, enabling consumers to access and manage actions associated with transactions (e.g., share, approve, reject).
+## [21.17.1] - 30-05-2024
+### Changed
+- Internal changes and improvements.
+## [21.17.0] - 29-05-2024
+### Changed
+- Product descriptions are now fetched and available on product entities, providing descriptive text for display in product listings and workflow experiences.
+## [21.16.5] - 29-05-2024
+### Changed
+- Fill and stroke color lists are now combined into a unified color palette for text steps, providing a complete set of available colors in a single accessor.
+## [21.16.4] - 29-05-2024
+### Changed
+- Updated the Papyrus dependency to fix an SVG parsing regex issue that could cause incorrect rendering of certain SVG elements.
+## [21.16.3] - 28-05-2024
+### Changed
+- Updated the Papyrus rendering engine dependency to the latest version.
+## [21.16.2] - 28-05-2024
+### Changed
+- Handle mm in svg height and width
+## [21.16.1] - 27-05-2024
+### Added
+- Include postscript files as non-rasters
+## [21.16.0] - 15-05-2024
+### Changed
+- Updated the design product replacement logic to use the current product collection data when resolving design products.
+- Removed unused variables and values from the render code path, reducing complexity.
+## [21.15.4] - 13-05-2024
+### Changed
+- Remove the initial flag which is now not needed
+- Removed edge cases related to mandatory step
+- Update core preview
+## [21.15.3] - 07-05-2024
+### Changed
+- Added filtering to remove the heart symbol character from text input, preventing rendering issues with unsupported glyphs.
+## [21.15.2] - 06-05-2024
+### Changed
+- Print file name URLs (`printFileUrl1` through `printFileUrl5`) are now included in the transaction query response, making print file download links available.
+## [21.15.1] - 30-04-2024
+### Changed
+- Upload preview image before submitting design
+## [21.15.0] - 30-04-2024
+### Fixed
+- Fixed memory management issues that caused excessive memory usage during workflow rendering, reducing the memory highwater mark for large workflows.
+## [21.14.0] - 30-04-2024
+### Changed
+- Internal changes and improvements.
+## [21.13.1] - 30-04-2024
+### Changed
+- Question steps now expose a `displayType` property, allowing consumers to determine how the question options should be rendered (e.g., dropdown, radio buttons).
+## [21.13.0] - 24-04-2024
+### Changed
+- Optionally don't update frame offsets when updating image (for background remover)
+## [21.12.0] - 24-04-2024
+### Added
+- Add ability to remove toast callbacks
+## [21.11.1] - 16-04-2024
+### Fixed
+- Fixed mandatory step validation to correctly evaluate fulfillment status when checking whether all required steps have been completed.
+## [21.11.0] - 15-04-2024
+### Changed
+- Improved the caching strategy for background removal results, reducing redundant processing when the same image is used across multiple steps.
+## [21.10.1] - 15-04-2024
+### Changed
+- Step initialisation should not mark mandatory fulfilled flag
+## [21.10.0] - 12-04-2024
+### Changed
+- Background removal functionality is now gated behind an addon flag, requiring the feature to be explicitly enabled for the partner before it becomes available in workflows.
+## [21.9.2] - 11-04-2024
+### Changed
+- Updated asset utility functions with minor improvements to asset handling and type safety.
+## [21.9.1] - 09-04-2024
+### Added
+- Add auth header to create design call
+## [21.9.0] - 05-04-2024
+### Changed
+- Added background removal support for picture steps, allowing users to remove the background from uploaded images using an AI-powered service.
+## [21.8.2] - 02-04-2024
+### Changed
+- Bundle GraphQL requests now include additional authorization headers, ensuring correct authentication for bundle-related API operations.
+## [21.8.1] - 26-03-2024
+### Fixed
+- `WorkflowExperience.getTotalPriceSubunits` no longer always returns the discounted price.
+## [21.8.0] - 26-03-2024
+### Added
+- `Bundle.removeStakeholder(email: string): Promise<void>`: Removes a single stakeholder from the Bundle, via email address.
+## [21.7.1] - 25-03-2024
+### Fixed
+- `Bundle.getAllStakeholders()` now returns correct results on subsequent calls.
+## [21.7.0] - 24-03-2024
+### Added
+- `CollectionProduct.getAllWorkflows(): ProductWorkflow[]`: Returns all workflows associated with this product.
+## [21.6.1] - 22-03-2024
+### Changed
+- Internal changes and improvements.
+## [21.6.0] - 22-03-2024
+### Added
+- `WorkflowExperienceEventType.PriceBreakChanged`: The relevant event fires whenever the price break to be used in a WorkflowExperience changes. This even will fire when the quantity changes, and will also fire when in a Bundle when other WorkflowExperiences using the same Product have quantity changes (or are added & removed from the Bundle).
+## [21.5.0] - 21-03-2024
+### Changed
+- `StepHandle`: The override global property state setting now has a different value for each Global Property Aspect type. The get/set functions have been renamed and have an extra parameter to determine the Aspect Type.
+    - `getOverrideGlobalPreviewConfiguration` -> `getOverrideGlobalPropertyConfiguration(type: AspectType): boolean`.
+    - `setOverrideGlobalPreviewConfiguration` -> `setOverrideGlobalPropertyConfiguration(type: AspectType, value: boolean): void`
+## [21.4.1] - 20-03-2024
+### Changed
+- `readTransactionsQuery` now fetches `printFileUrl1` to `printFileUrl5` for each transaction.
+## [21.4.0] - 20-03-2024
+### Added
+- `StepHandle`:
+    - `getOverrideGlobalPreviewConfiguration(): boolean`: Returns a boolean that indicates whether this step should override (ignore) Global Property state.
+    - `setOverrideGlobalPreviewConfiguration(value: boolean): void`: Modifies whether this step should override (ignore) Global Property state.
+    - `getGlobalPropertyAspects(configurationId: string): string[]`: Returns all Aspect names in the supplied Global Property Configuration that this step is configured to use.
+- `Bundle.getGlobalPropertyConfiguration(): GlobalPropertyConfiguration | undefined`: Returns the Global Property Configuration object associated with the Bundle, if it exists.
+## [21.3.1] - 20-03-2024
+### Fixed
+- When a `Bundle` is loaded by ID, the `WorkflowExperience` objects it loads will not correctly be linked internally. This resolves issues regarding price breaks not calculating correctly on bundle reload when multiple transactions share a product.
+## [21.3.0] - 20-03-2024
+### Added
+- `WorkflowExperience.priceBreakToBeApplied()` returns the percentage that will be used in `WorkflowExperience.getTotalPriceSubunits()` and related methods.
+### Changed
+- `WorkflowExperience.getTotalPriceSubunits()` and related methods now consider price breaks in their calculations, but also now have a `disablePriceBreaks` argument.
+## [21.2.1] - 15-03-2024
+### Fixed
+- Fixed Global Property Handles not updating values when WorkflowExperiences in the Bundle share the same Workflow.
+## [21.2.0] - 15-03-2024
+### Added
+- `FileUploadGlobalPropertyHandle`:
+    - `hasImage(): boolean`: Returns a boolean value indicating if the associated state has an image.
+    - `getImage(): Promise<Asset | undefined>`: Retrieves the current image from the server.
+## [21.1.2] - 14-03-2024
+### Changed
+- Exported additional type definitions that were missing from the package index, ensuring all public types are accessible to consumers.
+## [21.1.1] - 14-03-2024
+### Fixed
+- Exported missing `AspectType` for global property handles.
+## [21.1.0] - 14-03-2024
+### Added
+- `Bundle.hasGlobalProperties(): boolean`: Returns true when the bundle is linked to a Global Property Configuration.
+## [21.0.2] - 14-03-2024
+### Fixed
+- Exported additional types from the `Bundle` module (`GlobalPropertyHandle`, `AspectType`, etc.), making bundle-related types available in the public API.
+## [21.0.1] - 13-03-2024
+### Fixed
+- Package now supplies this `CHANGELOG.md` in published releases.
+## [21.0.0] - 13-03-2024
+### Added
+- `DesignCreationMessage` now has `quantity: number | undefined`.
 ### Changed
 - `Bundle.finish()` no longer returns an array of `DesignCreationMessage` objects, but instead returns a `BundleDesignCreationMessage` object which wraps the array of `DesignCreationMessage` entries.
-## [20.5.1] - 12-03-2024
+## [20.5.1] - 12-03-2024
+### Fixed
+- `WorkflowExperience.getSelectionPriceSubunits()` (and consequently `getTotalPriceSubunits()`) can no longer return `NaN`.
+## [20.5.0] - 12-03-2024
+### Added
+- `WorkflowManager.injectIntoPreviewService()` now has a second argument `refocusCamera`, a boolean which allows you to disable the automatic refocusing of the camera when the model is loaded. This requires `@spiffcommerce/preview@^5.7.0`.
+## [20.4.5] - 08-03-2024
+### Added
+- `RenderableScene` objects will now contain a `workflowScene: WorkflowScene` field. This is only provided for backwards compatibility and is considered deprecated functionality.
+## [20.4.4] - 08-03-2024
+### Fixed
+- Updating quantity via `WorkflowExperience.setQuantity()` will now correctly update on the server.
+## [20.4.3] - 08-03-2024
+### Changed
+- `WorkflowExperience.setQuantity()` now returns a promise that resolves once the quantity has been updated on the server.
+## [20.4.2] - 07-03-2024
+### Changed
+- Moved a type export to the correct module location for proper package organization.
+## [20.4.1] - 07-03-2024
+### Fixed
+- Exported a missing type definition that consumers needed to interact with the quantity management API.
+## [20.4.0] - 07-03-2024
+### Added
+- `Transaction` entities now have `quantity: number | undefined`.
+- New functions on `WorkflowExperience` for managing quantity:
+    - `getQuantity()`: The amount that was, or will be, ordered of the underlying `Transaction`. This will default to `1` if the value is undefined. If you want to read the raw value, use `getWorkflowManager().getTransaction().quantity`.
+    - `setQuantity(<number>)`: Updates the quantity value on the underlying `Transaction` entity. Must be >= 1.
+- New events functionality on `WorkflowExperience`. Currently the only event is `QuantityChanged`.
+    - `addEventListener(<type>, <callback>)`: Registers a callback function to be called when the specified event is raised. The associated `WorkflowExperience` is passed as a parameter to the callback function.
+    - `removeEventListener(<type>, <callback>)`: Removes a previously registered callback.
+## [20.3.0] - 07-03-2024
+### Added
+- `CollectionProduct.getCurrentIntegration()`: returns the `IntegrationProductResource` associated with the product that is linked to the current Integration (resolved via the application key).
+## [20.2.2] - 05-03-2024
+### Changed
+- `WorkflowExperience.getStepById(<string>)` now internally caches the `StepHandle` objects that it creates. This resolves an issue with functional rendering systems that re-render when the object reference changes, where they would re-renderer whenever this function was called even if the object was identical.
+## [20.2.1] - 29-02-2024
+### Changed
+- The union type `GetWorkflowOptions` has some of its entries wrapped in another union. The types that will create a brand new `Transaction` are now nested under `GetNewWorkflowOptions`:
+    ```ts
+    // Before
+    export type GetWorkflowOptions =
+        | GetWorkflowFromTransactionOptions
+        | GetWorkflowFromIntegrationProductOptions
+        | GetWorkflowFromExternalProductOptions;
+    // After
+    export type GetNewWorkflowOptions =
+        | GetWorkflowFromIntegrationProductOptions
+        | GetWorkflowFromExternalProductOptions;
+    export type GetWorkflowOptions = GetWorkflowFromTransactionOptions | GetNewWorkflowOptions;
+    ```
+## [20.2.0] - 29-02-2024
+### Added
+- `SpiffCommerceClient.getIntegrationProduct(<options>)`: Fetches an `IntegrationProduct` object. Essentially a wrapper for the functions `getIntegrationProductById` and `getIntegrationProductFromExternalIds`. The options object type is as follows:
+    ```ts
+    {
+        type: "integration";
+        integrationProductId: string;
+    } | {
+        type: "external";
+        externalIntegrationId: string;
+        externalProductId: string;
+    }
+    ```
+## [20.1.0] - 23-02-2024
+### Added
+- `IntegrationProduct.getAllWorkflows()`: Returns an array of `ProductWorkflow`, ordered by their internal `index` value (matches the order seen on the SpiffCommerce Hub).
+## [20.0.1] - 22-02-2024
+### Changed
+- `StepHandle.executeAnimations()` now logs a warning to the console when the associated `WorkflowManager` is not associated with a `ThreeDPreviewService`.
+## [20.0.0] - 18-02-2024
+### Added
+- Additional configuration options for GraphQL on bundles.
+- A separate fetchProducts function on the ProductCollection interface.
+### Changed
+- Removed async on getProducts call.
+### Removed
+- Unused normalize.css file.
+- Identical links assigned in each translation file.
+- Duplicate index file for the english version.
+## [19.3.3] - 14-02-2024
+### Fixed
+- Fixed products caching issue in `ProductCollection` to prevent redundant fetches.
+## [19.3.2] - 13-02-2024
+### Changed
+- Improved product collection behavior with refinements to how products are fetched and stored internally.
+## [19.3.1] - 11-02-2024
+### Added
+- Exported additional types from the package index.
+### Changed
+- Refactored `ProductCollection` to load products asynchronously.
+- Simplified global properties member usage in `Bundle` by removing direct Papyrus `GlobalPropertyConfiguration` import.
+## [19.3.0] - 09-02-2024
+### Added
+- Added text input support to the flow execution service, enabling text-based step interactions in workflow flows.
+## [19.2.0] - 06-02-2024
+### Added
+- Added `getIntegration()` method to `SpiffCommerceClient` to fetch the current integration configuration.
+## [19.1.1] - 05-02-2024
+### Fixed
+- Fixed JPEG magic number detection to correctly identify JPEG files during asset upload validation.
+## [19.1.0] - 01-02-2024
+### Added
+- Added `getIntegrationProductById` and `getIntegrationProductFromExternalIds` functions to fetch integration products by their Spiff ID or external platform IDs.
+## [19.0.0] - 01-02-2024
+### Changed
+- Bundle state manager now supports multiple named transforms per workflow experience, replacing the single-transform model. Transforms are stored in a keyed object, enabling multi-transform configurations on bundles.
+## [18.4.4] - 01-02-2024
+### Fixed
+- Prevented workflow state synchronization from immediately firing during initialization, avoiding unnecessary server round-trips on load.
+## [18.4.3] - 30-01-2024
+### Changed
+- Improved `getWorkflowExperiences` performance by batching transaction lookups and reducing redundant API calls when loading multiple workflow experiences.
+## [18.4.2] - 29-01-2024
+### Changed
+- Updated the Papyrus rendering engine dependency for performance improvements.
+## [18.4.1] - 29-01-2024
+### Changed
+- Updated the Papyrus rendering engine dependency with loading performance improvements.
+- Adjusted silent step handler tests for updated APIs.
+## [18.4.0] - 25-01-2024
+### Added
+- Added `getSelectionPriceSubunits()` and `getBasePriceSubunits()` methods to `WorkflowExperience`, providing separate access to user selection price and product base price components.
+## [18.3.0] - 25-01-2024
+### Added
+- The `noPan` field is now fetched from the workflow configuration, allowing workflows to disable camera panning in the 3D preview.
+## [18.2.2] - 24-01-2024
+### Changed
+- The integration product data is now included in the transaction read query, making integration details available on reloaded transactions.
+## [18.2.1] - 22-01-2024
+### Fixed
+- Added a guard to prevent illustration step updates from firing while a previous update is still in progress.
+## [18.2.0] - 22-01-2024
+### Added
+- Added ability to fetch additional integration products linked to a product.
+- Added product collection loading from integration product data.
+## [18.1.0] - 22-01-2024
+### Added
+- Illustration steps now automatically select the default color variant when a new illustration is loaded, based on the configured color option.
+## [18.0.1] - 18-01-2024
+### Fixed
+- Fixed bundle metadata not being correctly passed during bundle creation.
+## [18.0.0] - 18-01-2024
+### Added
+- Added `copySelections()` method to `WorkflowExperience` for copying variant selections from one experience to another, enabling duplication of user customizations across workflow experiences.
+## [17.5.1] - 18-01-2024
+### Changed
+- Initial bundle metadata is now sent during bundle creation via the GraphQL mutation, allowing bundles to be initialized with metadata.
+## [17.5.0] - 17-01-2024
+### Changed
+- Simplified non-power-of-two texture support calculation in the layout preview service by computing it upfront during initialization.
+## [17.4.0] - 16-01-2024
+### Added
+- Product queries now fetch SKU data (`sku` and `skus` fields), making product SKU information available to consumers.
+## [17.3.0] - 15-01-2024
+### Added
+- Added `setAlignment()` method to `TextStepHandle`, enabling programmatic control over text alignment (left, center, right) within text steps.
+## [17.2.1] - 15-01-2024
+### Added
+- Added the `index` field to the `ProductWorkflow` type, enabling correct ordering of product workflows.
+## [17.2.0] - 15-01-2024
+### Changed
+- `Bundle.finish()` now accepts an optional `createPreviewImage` callback parameter, allowing consumers to provide custom preview image generation logic for each workflow experience.
+## [17.1.1] - 15-01-2024
+### Changed
+- The `index` field is now fetched for product workflows in the GraphQL query, enabling correct ordering of workflows on products.
+## [17.1.0] - 12-01-2024
+### Added
+- Added threshold functionality for frame steps, introducing `FrameThreshold` types and configurable threshold detection to control image placement behavior within frame regions.
+## [17.0.2] - 10-01-2024
+### Changed
+- Updated the Pith rendering dependency to include image filter support.
+## [17.0.1] - 09-01-2024
+### Changed
+- The `DesignCreationMessage` type now includes additional ID fields (`externalDesignProductId`, `externalDesignProductVariantId`, etc.) from the transaction, providing richer data in the design creation response.
+## [17.0.0] - 08-01-2024
+### Removed
+- Removed the legacy `BulkStepHandle` and associated bulk workflow functionality. Bulk email distribution is now handled differently via the consolidated workflow experience API.
+## [16.10.4] - 04-01-2024
+### Added
+- Exported the missing `FlowService` type from the package index.
+## [16.10.3] - 15-11-2023
+### Fixed
+- The transaction owner ID is now passed during variation record updates, ensuring correct authorization for persistence.
+## [16.10.2] - 15-11-2023
+### Fixed
+- The transaction owner ID is now included when assigning customer details, ensuring proper authorization.
+## [16.10.1] - 14-11-2023
+### Fixed
+- The model container is now set on the `WorkflowManager` immediately during injection rather than waiting for the model to fully load, preventing race conditions.
+## [16.10.0] - 13-11-2023
+### Changed
+- Removed static owner ID tracking from `SpiffCommerceClient`.
+### Added
+- `Bundle` now exposes `assignCustomerDetails` and the `GlobalPropertyStateManager` exposes an `assign` method for explicit customer association.
+## [16.9.0] - 13-11-2023
+### Added
+- The asset service now fetches reflection map fields (`reflectionMap`, `emissiveMap`, etc.), making PBR material textures available for 3D preview rendering.
+## [16.8.4] - 09-11-2023
+### Fixed
+- Fixed the GraphQL server authentication flow to correctly handle re-authentication when the token expires.
+## [16.8.3] - 08-11-2023
+### Fixed
+- Fixed text generation to use the correct fallback font replacement logic when an unsupported character is encountered.
+## [16.8.2] - 08-11-2023
+### Changed
+- Increased the resolution of preview images generated by `WorkflowExperience.createPreviewImage()`.
+## [16.8.1] - 08-11-2023
+### Added
+- Added Sentry trace ID propagation to GraphQL requests, enabling distributed tracing across the API layer.
+## [16.8.0] - 06-11-2023
+### Added
+- The promise cache service now supports toggling (enable/disable), allowing consumers to control caching behavior of workflow and asset requests.
+## [16.7.0] - 02-11-2023
+### Added
+- The `getWorkflowExperience` function now fetches environment intensity and rotation fields for 3D scenes, making environment lighting configuration available for preview rendering.
+## [16.6.0] - 01-11-2023
+### Changed
+- Silent step changes are now applied correctly to workflow experiences, and scene handling has been improved to process silent steps independently from user-interactive steps.
+## [16.5.0] - 31-10-2023
+### Added
+- Added filtering capability to `getIntegrationProduct` on product collections, allowing products to be filtered by additional criteria.
+## [16.4.3] - 26-10-2023
+### Added
+- Exported the canvas module setter function from the package index.
+## [16.4.2] - 25-10-2023
+### Changed
+- Updated the Papyrus rendering engine to support headless rendering mode.
+- Added code documentation comments.
+## [16.4.1] - 23-10-2023
+### Changed
+- GraphQL fetch function is now imported from the Papyrus package for consistent network handling.
+## [16.4.0] - 20-10-2023
+### Changed
+- Improvements to bundle state management, including transform handling refinements and preview service integration for better 3D positioning of workflow experiences.
+## [16.3.0] - 18-10-2023
+### Added
+- Added caching for font files and raw asset files, reducing redundant network requests during workflow rendering.
+## [16.2.6] - 18-10-2023
+### Fixed
+- Fixed a timing issue in model step initialization where the model variant was being applied before the model was fully loaded.
+## [16.2.5] - 17-10-2023
+### Fixed
+- Bundle state manager now flips input transform coordinates to match the 3D preview's coordinate system, ensuring correct positioning of workflow experiences in the preview.
+## [16.2.4] - 16-10-2023
+### Changed
+- Improved internal model step handling by cleaning up model variant loading and await patterns for more reliable model initialization.
+## [16.2.1] - 16-10-2023
+### Fixed
+- Added missing `await` on model variant loading during step initialization, preventing race conditions.
+## [16.2.0] - 15-10-2023
+### Added
+- Exposed `Vector3` and `TransformCollection` types from the package.
+### Changed
+- `ProductCollection` now wraps the raw resource with accessor methods.
+## [16.1.0] - 13-10-2023
+### Added
+- `CollectionProduct` now exposes `getDefaultWorkflow()` for retrieving the default workflow configuration.
+- Product collection query now fetches workflow index data.
+## [16.0.2] - 12-10-2023
+### Changed
+- Improved the product collection interface with typed `CollectionProduct` wrapper objects providing methods like `getId()`, `getName()`, and `getWorkflows()`.
+## [16.0.1] - 12-10-2023
+### Fixed
+- Fixed design creation metadata formatting to correctly handle undefined values, preventing errors during bundle finalization.
+## [16.0.0] - 12-10-2023
+### Removed
+- Removed all React dependencies and components from the package, making the core library framework-agnostic. The `AdvancedEditor`, `TransformWrapper`, and related React components have been removed.
+## [15.3.4] - 11-10-2023
+### Changed
+- Model and material variant selections are now applied when injecting a workflow experience into the preview service.
+### Fixed
+- Fixed a missing `break` in the flow execution state machine.
+## [15.3.3] - 11-10-2023
+### Fixed
+- Fixed flow service response handling to correctly parse execution results.
+- Improved `instanceof` checks for workflow step types.
+## [15.3.2] - 11-10-2023
+### Fixed
+- Fixed flow execution to correctly pass the execution ID in subsequent calls.
+## [15.3.1] - 11-10-2023
+### Changed
+- Internal dependency version bump.
+## [15.3.0] - 10-10-2023
+### Added
+- Major improvements to the flow execution service, including state management and support for multi-step execution flows with retry handling.
+## [15.2.4] - 09-10-2023
+### Fixed
+- Fixed a global property default variant issue where a missing null check could cause the variant initialization to fail.
+## [15.2.3] - 09-10-2023
+### Fixed
+- Variant `getThumbnail()` now checks the explicit thumbnail field first before falling back to the generated thumbnail version, ensuring the most appropriate image is returned.
+## [15.2.2] - 06-10-2023
+### Changed
+- Batched the `readWorkflowState` GraphQL calls during `createDesigns` for bundles, reducing the number of network requests when finalizing bundles with multiple transactions.
+## [15.2.1] - 06-10-2023
+### Fixed
+- Added fallback handling for global property default variant initialization when no matching variant is found, preventing crashes during bundle setup.
+## [15.2.0] - 05-10-2023
+### Added
+- The emission map configuration field is now fetched from the workflow, enabling emissive material support in 3D previews.
+## [15.1.5] - 04-10-2023
+### Fixed
+- Fixed `Variant.getThumbnail()` returning the base asset's thumbnail instead of the variant's own explicit thumbnail when available.
+## [15.1.4] - 04-10-2023
+### Changed
+- Design creation transaction fragment now includes `previewImageLink` field.
+- Improved deprecation message for `Variant.getDisplayImage()` to recommend `getThumbnail()`.
+## [15.1.3] - 03-10-2023
+### Fixed
+- Customer and bundle IDs are now correctly persisted when fetching stakeholders, preventing loss of customer context.
+## [15.1.2] - 03-10-2023
+### Fixed
+- Added a missing GraphQL query case for customer-specific bundle lookups.
+## [15.1.1] - 03-10-2023
+### Added
+- Exported additional types (`InformationStepHandle`, `InformationStepData`, etc.) from the package index.
+## [15.1.0] - 03-10-2023
+### Added
+- Added `InformationStepHandle` for information-type workflow steps, allowing consumers to read and interact with informational step content.
+## [15.0.4] - 02-10-2023
+### Fixed
+- Customers are now correctly stored and associated with bundles during creation and lookup, enabling customer-to-bundle relationship persistence.
+## [15.0.3] - 02-10-2023
+### Fixed
+- Fixed customer lookup for bundles by adding the missing `partner.id` field to the bundles-for-customer GraphQL query.
+## [15.0.2] - 02-10-2023
+### Changed
+- Design creation for bundles now uses a single batched `createDesigns` request instead of individual calls per transaction.
+### Added
+- Added missing `FileUploadGlobalPropertyHandle` export.
+## [15.0.1] - 28-09-2023
+### Fixed
+- Fixed the integration product type reference on product collection queries to use the correct singular field name.
+## [15.0.0] - 28-09-2023
+### Changed
+- Refactored `ProductCollection` from a plain type to a class with accessor methods. The `Bundle.getProductCollection()` now returns a `ProductCollection` wrapper instance.
+### Fixed
+- Fixed `instanceof Map` check that caused issues with generic type parameters.
+## [14.13.2] - 28-09-2023
+### Changed
+- Preview image capture during `Bundle.finish()` is now optional, controlled by a callback parameter that can return `undefined` to skip capturing.
+## [14.13.1] - 28-09-2023
+### Changed
+- Improved bundle loading performance by optimizing GraphQL query fetch policies.
+- Added extra argument to specify GraphQL options when loading bundles.
+- Text step service improvements.
+## [14.13.0] - 27-09-2023
+### Added
+- Added bulk transaction creation support. `getWorkflowExperiences()` now accepts arrays of options, enabling parallel creation of multiple workflow experiences in a single call.
+## [14.12.1] - 27-09-2023
+### Fixed
+- Fixed array mutation issues in `Bundle` when replacing or injecting workflow experiences, preventing unintended side effects on the internal array.
+## [14.12.0] - 27-09-2023
+### Added
+- Added array management methods to `Bundle`: `addWorkflowExperiences()`, `removeWorkflowExperiences()`, `removeWorkflowExperiencesByTransactions()`, `insertWorkflowExperience()`, and `replaceWorkflowExperience()`.
+## [14.11.0] - 27-09-2023
+### Added
+- Added custom color support for shape steps via global property configuration.
+### Fixed
+- Fixed bundle ordering not updating when appending new workflow experiences.
+## [14.10.0] - 26-09-2023
+### Added
+- Added bulk add/remove/insert/replace methods for workflow experiences on `Bundle`.
+- Added `transactionOwnerId` support in the state mutation function.
+### Fixed
+- Fixed duplicate insertion and removal splicing bugs.
+## [14.9.0] - 26-09-2023
+### Changed
+- Asset metadata is now fetched via GraphQL, and asset upload now uses the promise cache.
+- Improved cache handling with configurable reuse.
+## [14.8.1] - 26-09-2023
+### Added
+- Implemented a promise cache for workflow requests, caching identical in-flight requests to avoid duplicate network calls.
+## [14.8.0] - 25-09-2023
+### Added
+- The `transformCollection` field is now fetched from `ProductCollection` via GraphQL, making 3D transform configuration data available for bundle positioning.
+## [14.7.0] - 21-09-2023
+### Added
+- Added support for overriding HTTP header values in the GraphQL client, enabling custom authorization headers for bundle-specific API calls.
+## [14.6.0] - 21-09-2023
+### Added
+- Introduced `BundleStateManager` for tracking per-transaction 3D positioning state (transforms) within bundles, including coordinate system conversion between input and preview space.
+## [14.5.0] - 21-09-2023
+### Added
+- Added hover events on `Bundle` for workflow experiences, firing when the user hovers over a workflow experience's 3D model in the preview.
+## [14.4.0] - 21-09-2023
+### Added
+- Added tags to step handles via `StepHandle.getTags()`.
+- Exported additional step types from the package index.
+## [14.3.1] - 20-09-2023
+### Fixed
+- Fixed error when re-injecting a workflow experience into the same preview service by adding a guard for duplicate injection.
+## [14.3.0] - 20-09-2023
+### Added
+- Bundle workflow experiences are now automatically injected into the 3D preview service when added to a bundle, and removed when deleted.
+## [14.2.2] - 20-09-2023
+### Changed
+- Bundle metadata is now fetched when loading bundles for a customer.
+## [14.2.1] - 20-09-2023
+### Changed
+- Updated the Papyrus rendering engine to fix a default frame pattern rendering issue.
+## [14.2.0] - 20-09-2023
+### Added
+- Added `getBundleStakeholdersForCustomer()` to fetch all bundle stakeholders associated with a customer.
+## [14.1.6] - 19-09-2023
+### Changed
+- Added an automatic render trigger after injecting a workflow experience into the 3D preview service.
+## [14.1.5] - 19-09-2023
+### Fixed
+- The local bundle owner ID is now assigned before fetching a bundle, ensuring correct authorization during load.
+## [14.1.4] - 18-09-2023
+### Fixed
+- Fixed frame image zoom calculation and enforced image bounding within frame regions.
+## [14.1.3] - 18-09-2023
+### Fixed
+- Fixed inverted offset change detection in the frame service, which was incorrectly skipping offset updates.
+## [14.1.0] - 15-09-2023
+### Added
+- Added `getGlobalPropertyTotalSubunits()` to `Bundle` for calculating the total price of all option-type global property selections.
+## [14.0.1] - 15-09-2023
+### Changed
+- Frame creation now includes `data-frame-width` and `data-frame-height` attributes for correct sizing metadata.
+## [14.0.0] - 14-09-2023
+### Added
+- Full support for frames with multiple regions, including independent image handling, zoom, and offset controls per region.
+## [13.3.3] - 13-09-2023
+### Fixed
+- Fixed an Apollo cache bug by making the Bundle ID field `readonly` and fixing cache-related query issues.
+## [13.3.2] - 13-09-2023
+### Changed
+- Simplified the condition evaluation function for global properties, improving readability and correctness.
+## [13.3.1] - 13-09-2023
+### Fixed
+- Removed an unnecessary guard clause in the global property condition evaluation that was blocking valid property configurations.
+## [13.3.0] - 12-09-2023
+### Added
+- Introduced the `FlowService` for managing step-by-step execution flows on workflows, enabling programmatic sequential step interactions.
+## [13.2.0] - 12-09-2023
+### Changed
+- Internal dependency version bump.
+## [13.1.2] - 12-09-2023
+### Fixed
+- Fixed global property state creation to include `aspects` in the response.
+- Added null checks for `state.aspects` in condition evaluation to prevent crashes with empty states.
+## [13.1.1] - 11-09-2023
+### Added
+- Added `removeWorkflowExperienceByTransaction()` method to `Bundle` for removing experiences by transaction reference.
+### Fixed
+- Fixed global property state value type to use correct stored type.
+## [13.1.0] - 08-09-2023
+### Added
+- Added conditional global property support, allowing global properties to be shown/hidden based on the current global property state selections.
+## [13.0.0] - 07-09-2023
+### Changed
+- Moved `GlobalPropertyConfiguration` ownership from `Bundle` to `ProductCollection`. Refactored the global property workflow to load configuration from the product collection context.
+## [12.13.0] - 07-09-2023
+### Changed
+- Re-implemented animation name fetching from the server (re-applied after previous revert), optimizing workflow loading by fetching animation data as part of the main request.
+## [12.12.1] - 07-09-2023
+### Changed
+- Reverted the animation name fetching changes from 12.12.0 due to issues.
+## [12.12.0] - 07-09-2023
+### Added
+- Added fetching of animation names from the server to reduce the need for separate asset lookups for 3D model animations.
+## [12.11.4] - 06-09-2023
+### Added
+- Product tag data (`productTags`) is now fetched from the server on product and bundle queries, making tag metadata available.
+## [12.11.3] - 06-09-2023
+### Changed
+- Updated the Papyrus rendering engine dependency to the latest version.
+## [12.11.2] - 05-09-2023
+### Added
+- Added `getText()` method to the `TextGlobalPropertyHandle` for reading the current text value of a text-type global property.
+## [12.11.1] - 01-09-2023
 ### Fixed
-- `WorkflowExperience.getSelectionPriceSubunits()` (and consequently `getTotalPriceSubunits()`) can no longer return `NaN`.
+- Improved `Bundle.finish()` to properly handle design creation results and map them to the correct workflow experiences.
-## [20.5.0] - 12-03-2024
+## [12.11.0] - 29-08-2023
 ### Added
-- `WorkflowManager.injectIntoPreviewService()` now has a second argument `refocusCamera`, a boolean which allows you to disable the automatic refocusing of the camera when the model is loaded. This requires `@spiffcommerce/preview@^5.7.0`.
+- Added text aspect support for global property configuration, enabling text-type global properties alongside color and option types.
-## [20.4.5] - 08-03-2024
+## [12.10.9] - 28-08-2023
 ### Added
-- `RenderableScene` objects will now contain a `workflowScene: WorkflowScene` field. This is only provided for backwards compatibility and is considered deprecated functionality.
+- Added shared step tracking to global property configuration, allowing multiple steps to share the same global property aspect.
-## [20.4.4] - 08-03-2024
+## [12.10.8] - 28-08-2023
 ### Fixed
-- Updating quantity via `WorkflowExperience.setQuantity()` will now correctly update on the server.
+- Fixed client authentication flow to correctly handle edge cases during bundle authentication, preventing auth failures.
-## [20.4.3] - 08-03-2024
+## [12.10.7] - 28-08-2023
+### Fixed
+- Shape step handles now correctly handle variant selection, matching the behavior of other step types (illustration, material, etc.).
+## [12.10.6] - 28-08-2023
+### Fixed
+- Fixed a missing `return` statement in the global property handle filter function, which caused the filter to incorrectly return all steps.
+## [12.10.5] - 24-08-2023
 ### Changed
-- `WorkflowExperience.setQuantity()` now returns a promise that resolves once the quantity has been updated on the server.
+- Customer details are now fetched as part of the bundle get request, reducing the need for a separate customer lookup.
+## [12.10.4] - 24-08-2023
+### Changed
+- Disabled GraphQL caching for option service requests to ensure fresh option data is always loaded.
+## [12.10.3] - 24-08-2023
+### Changed
+- Moved the `optionService` initialization out of the Bundle constructor to avoid issues with async operations during construction.
+## [12.10.2] - 24-08-2023
-## [20.4.0] - 08-03-2024
+### Fixed
+- Fixed global property handle initialization to correctly `await` the internal promise before accessing property data.
+## [12.10.1] - 23-08-2023
+### Fixed
+- Added the missing entity ID field to the bundle query response.
+## [12.10.0] - 18-08-2023
 ### Added
-- `Transaction` entities now have `quantity: number | undefined`.
-- New functions on `WorkflowExperience` for managing quantity:
-    - `getQuantity()`: The amount that was, or will be, ordered of the underlying `Transaction`. This will default to `1` if the value is undefined. If you want to read the raw value, use `getWorkflowManager().getTransaction().quantity`.
-    - `setQuantity(<number>)`: Updates the quantity value on the underlying `Transaction` entity. Must be >= 1.
-- New events functionality on `WorkflowExperience`. Currently the only event is `QuantityChanged`.
-    - `addEventListener(<type>, <callback>)`: Registers a callback function to be called when the specified event is raised. The associated `WorkflowExperience` is passed as a parameter to the callback function.
-    - `removeEventListener(<type>, <callback>)`: Removes a previously registered callback.
+- Added multi-model loading support, allowing `WorkflowManager` to inject multiple 3D models into the preview service simultaneously.
-## [20.3.0] - 07-03-2024
+## [12.9.9] - 17-08-2023
+### Fixed
+- Fixed global property values returning `false` instead of the actual stored value due to an incorrect truthy check.
+## [12.9.8] - 15-08-2023
 ### Added
-- `CollectionProduct.getCurrentIntegration()`: returns the `IntegrationProductResource` associated with the product that is linked to the current Integration (resolved via the application key).
+- Additional integration product fields (`externalProductId`, `externalIntegrationId`, etc.) are now fetched in bundle and transaction queries.
-## [20.2.2] - 05-03-2024
+## [12.9.7] - 15-08-2023
 ### Changed
-- `WorkflowExperience.getStepById(<string>)` now internally caches the `StepHandle` objects that it creates. This resolves an issue with functional rendering systems that re-render when the object reference changes, where they would re-renderer whenever this function was called even if the object was identical.
+- Extended the `externalProductId` field to be included in additional integration product queries.
-## [20.2.1] - 29-02-2024
+## [12.9.6] - 15-08-2023
 ### Changed
-- The union type `GetWorkflowOptions` has some of its entries wrapped in another union. The types that will create a brand new `Transaction` are now nested under `GetNewWorkflowOptions`:
+- The `externalProductId` field is now fetched on integration products in the transaction query.
-    ```ts
-    // Before
-    export type GetWorkflowOptions =
-        | GetWorkflowFromTransactionOptions
-        | GetWorkflowFromIntegrationProductOptions
-        | GetWorkflowFromExternalProductOptions;
+## [12.9.5] - 14-08-2023
-    // After
-    export type GetNewWorkflowOptions =
-        | GetWorkflowFromIntegrationProductOptions
-        | GetWorkflowFromExternalProductOptions;
+### Changed
-    export type GetWorkflowOptions = GetWorkflowFromTransactionOptions | GetNewWorkflowOptions;
-    ```
+- Removed client-level experience option tracking in favor of per-experience options, simplifying the API and reducing shared state.
-## [20.2.0] - 29-02-2024
+## [12.9.4] - 14-08-2023
+### Fixed
+- Simplified bundle workflow experience reloading by using a separate buffer, avoiding issues with concurrent modifications to the experience array.
+## [12.9.3] - 11-08-2023
+### Fixed
+- Fixed `getWorkflowExperiences` to correctly return the promise from the async map operation.
+## [12.9.2] - 11-08-2023
+### Fixed
+- Fixed GraphQL query type annotation for global property workflow IDs (changed `[String]!` to `[String!]!`).
+## [12.9.1] - 11-08-2023
+### Fixed
+- Ensured workflow experiences in a bundle are reloaded by their index to maintain correct ordering.
+## [12.9.0] - 11-08-2023
 ### Added
-- `SpiffCommerceClient.getIntegrationProduct(<options>)`: Fetches an `IntegrationProduct` object. Essentially a wrapper for the functions `getIntegrationProductById` and `getIntegrationProductFromExternalIds`. The options object type is as follows:
-    ```ts
-    {
-        type: "integration";
-        integrationProductId: string;
-    } | {
-        type: "external";
-        externalIntegrationId: string;
-        externalProductId: string;
-    }
-    ```
+- Added workflow experience sorting and ordering within bundles via a new GraphQL mutation for transaction order updates.
-## [20.1.0] - 23-02-2024
+## [12.8.0] - 11-08-2023
 ### Added
-- `IntegrationProduct.getAllWorkflows()`: Returns an array of `ProductWorkflow`, ordered by their internal `index` value (matches the order seen on the SpiffCommerce Hub).
+- Added `updateNameAndMetadata()` helper to `Bundle`.
+- Global property state is now automatically applied to new transactions when they are added to a bundle.
+## [12.7.1] - 11-08-2023
+### Fixed
+- Improved option resolution for global property handles, fixing issues with variant loading and state management.
+## [12.7.0] - 11-08-2023
+### Added
+- Added methods for setting values on global property state aspects, enabling programmatic updates to global properties.
+## [12.6.0] - 11-08-2023
+### Added
+- Introduced the `GlobalPropertyStateManager` for creating and managing global property state on bundles.
+## [12.5.1] - 10-08-2023
-## [20.0.1] - 23-02-2024
+### Added
+- Added global step property configuration and handle system.
+- Product collections now fetch integration product data.
+- Added `GlobalPropertyConfiguration`, `GlobalPropertyHandle`, and `GlobalPropertyHandleService` classes.
+## [12.4.3] - 07-08-2023
 ### Changed
-- `StepHandle.executeAnimations()` now logs a warning to the console when the associated `WorkflowManager` is not associated with a `ThreeDPreviewService`.
+- Removed all calls to `resetStore` on the Apollo client and switched to `no-cache` fetch policy, preventing GraphQL cache invalidation issues.
-## [20.0.0] - 15-02-2024
+## [12.4.2] - 04-08-2023
 ### Added
-- Additional configuration options for GraphQL on bundles.
-- A separate fetchProducts function on the ProductCollection interface.
+- Added `bundleOwnerId` field to the bundle query response.
+## [12.4.1] - 03-08-2023
+### Added
+- Added `reloadTransactions()` method to `Bundle` for refreshing transaction data from the server.
 ### Changed
-- Removed async on getProducts call.
+- Improved client-side experience loading.
-### Removed
+## [12.4.0] - 03-08-2023
-- Unused normalize.css file.
-- Identical links assigned in each translation file.
-- Duplicate index file for the english version.
+### Added
+- Introduced `ProductCollection` support with product listing and integration product queries on bundles.
+## [12.3.2] - 01-08-2023
+### Changed
+- Updated the Papyrus rendering engine to include AR (augmented reality) support fields.
+## [12.3.1] - 01-08-2023
+### Added
+- The `enableAR` field is now fetched from the workflow configuration, making AR availability status accessible.
+## [12.3.0] - 31-07-2023
+### Added
+- Added `processExecutionId` tracking to design creation, enabling correlation of design creation requests with backend process tracking.
+## [12.2.0] - 28-07-2023
+### Added
+- Added `getName()`, `setName()`, `getMetadata()`, and `setMetadata()` methods to `Bundle` for reading and updating bundle names and metadata.
+## [12.1.3] - 27-07-2023
+### Fixed
+- Fixed missing `type` argument in the `bundleAddStakeholder` GraphQL mutation.
+## [12.1.2] - 27-07-2023
+### Changed
+- Made the `configurationId` parameter optional in the `createBundle` GraphQL mutation, allowing bundles to be created without a pre-existing configuration.
+## [12.1.1] - 26-07-2023
+### Fixed
+- Fixed the `GetCustomer` GraphQL query to use the correct field name.
+## [12.1.0] - 25-07-2023
+### Added
+- Added temporary asset upload functionality via a new exported function, enabling file uploads outside of the standard step workflow.
+## [12.0.0] - 24-07-2023
+### Added
+- Added `injectIntoPreviewService()` and `removeFromPreviewService()` methods to `WorkflowManager`.
+- Exposed the preview service instance via `getPreviewService()`.
+### Changed
+- Updated the 3D preview service integration.
+## [11.5.0] - 19-07-2023
+### Added
+- Added pricing calculation to bundles, with `getTotalSubunits()` on `Bundle` and `getTotalPriceSubunits()` on `WorkflowExperience` for computing total prices.
+## [11.4.0] - 13-07-2023
+### Added
+- Added full stakeholder CRUD to bundles: `addStakeholder()`, `getAllStakeholders()`, and `updateStakeholders()` methods with new GraphQL mutations.
+## [11.3.0] - 13-07-2023
+### Changed
+- Extended customer authentication to support bundles. Stakeholder functionality now operates across both transactions and bundles.
+## [11.2.0] - 12-07-2023
+### Added
+- Introduced the `Bundle` class for managing collections of workflow experiences, with methods for creating bundles, adding/removing transactions, and managing the bundle lifecycle.
+## [11.1.2] - 12-07-2023
+### Fixed
+- Fixed transaction owner ID not being loaded from local storage during authentication, causing authorization failures on reload.
+## [11.1.1] - 06-07-2023
+### Fixed
+- Fixed broken panning behavior in the `TransformWrapper` React component by simplifying the mouse event handling logic.
+## [11.1.0] - 04-07-2023
+### Changed
+- Updated authentication flow to properly handle token refresh and added new auth utility methods to the GraphQL server configuration.
+## [11.0.2] - 04-07-2023
+### Fixed
+- Fixed a typo in the GraphQL mutation for adding transaction stakeholders (`customers` → `customer`).
+## [11.0.1] - 04-07-2023
+### Changed
+- Expanded customer authentication with additional test coverage and authentication methods for transactions and bundles.
+## [11.0.0] - 04-07-2023
+### Changed
+- Internal dependency version bump with breaking changes.
+## [10.3.1] - 30-06-2023
+### Added
+- Added ordered state checking during transaction authentication, preventing users from authenticating against already-ordered transactions.
+## [10.3.0] - 29-06-2023
+### Added
+- Introduced customer authentication functionality, enabling customer login/logout, code verification, and transaction-specific authentication via `SpiffCommerceClient`.
+## [10.2.0] - 26-06-2023
+### Changed
+- Improved guidelines in the advanced editor with tweaks to guideline positioning and added test coverage for guideline interactions.
+## [10.1.8] - 25-06-2023
+### Fixed
+- Fixed mouse tracking in `TransformWrapper` to use a ref instead of state for smoother panning interactions.
+## [10.1.6] - 14-06-2023
+### Changed
+- Updated the Papyrus rendering engine dependency to the latest version.
+## [10.1.5] - 14-06-2023
+### Changed
+- Added Pith as a build target dependency for correct bundling.
+## [10.1.4] - 14-06-2023
+### Changed
+- Updated the Papyrus rendering engine dependency to the latest version.
+## [10.1.3] - 14-06-2023
+### Fixed
+- Restored text fill fields on the client configuration that were accidentally removed.
+## [10.1.1] - 13-06-2023
+### Changed
+- Removed `@swc/helpers` dependency and updated Papyrus rendering engine to latest version.
+## [10.1.0] - 13-06-2023
+### Changed
+- Migrated the rendering engine from Canvg to Pith for improved SVG rendering performance and capability.
+## [10.0.15] - 09-06-2023
+### Fixed
+- Fixed the delete key handler in the advanced editor to only remove elements from non-structured steps, preventing accidental deletion of required step elements.
+## [10.0.14] - 09-06-2023
+### Changed
+- Internal build and packaging updates.