# Changelog

## 2.0.5 - 2026-01-14

### Added

- Add support for Category and Product selectors in the Deck content editor.

### Changed

- Updated dependencies
  - @lightspeed/crane-api@1.1.1

### Fixed

- Add better error handling during 'preview' mode.
- Fix reference template showcases errors for 'preview' mode.

## 2.0.4 - 2026-01-07

### Added

- Fetch the local content configuration for Instant Site in 'preview' mode.
- Add support for initialising, building and deploying custom template pages.

### Changed

- Updated dependencies
  - @lightspeed/crane-api@1.1.0

### Fixed

- Fix object transformation immutability during the 'deploy' process.
- Fix faulty configuration amongst reference custom sections, headers and footers.
- Overwrite the preview folder files to automatically enable new preview capabilities for older apps.

## 2.0.3 - 2025-12-17

### Fixed

- Fix 'layoutIcon' property validation for custom sections' layout configuration file.
- Fix preview rendering error caused by updated `SELECTBOX` component.

## 2.0.2 - 2025-12-11

### Added

- Add template categories support for Template Market filtering. Templates can now specify categories (e.g., vape_smoke, electronics) that will be used for filtering in Template Market.

### Changed

- Update version of 'glob' dependency.
- Updated dependencies
  - @lightspeed/crane-api@1.0.2

## 2.0.1 - 2025-12-09

### Added

- Add handling of tile state upon re-ordering in 'preview' mode.
- Provide default layout in 'preview' mode if not specified.

### Changed

- Add dependency to the new internal packages.
- Updated dependencies
  - @lightspeed/crane-api@1.0.1

### Fixed

- Fix showcase translations by removing unused translation keys.
- Fix incorrect editor configuration examples in template showcase files.

## 2.0.0 - 2025-12-02

### Added

- Introduce new reference sections: 'Featured Products' and 'Trending Categories', providing examples that showcase the capabilities of the Product and Category selectors.
- Introduce support for static image editors in 'content' and 'design' configuration.
- **Category/Product Selectors (experimental):** add support for Category and Product selectors.
- Keep uncompressed original server.js file for 'preview' during 'build' process.
- Add support for `INFO` configuration type for 'preview' execution.
- Add JSON schema validation for section layout files.
- Introduce support for static text labels.
- Add support for multisection resource fetching during 'preview' process.
- Implement vue SSR rendering for 'preview' execution.
- Use dynamic URLs from the Chrome extension during 'preview' process.

### Changed

- Move Crane app to a new package named crane-api.
- Move 'Category/Product Selectors' functionality from experimental to the core feature list.
- Update showcase validation to disallow settings that exists in showcases but not in content configuration file.
- Add validation for 'DECK' configuration type's 'defaultCardContent' property.
- Pass bearer token in the process of 'preview' execution.
- Update 'build' output validation during 'deploy' command execution.
- Updated dependencies
  - @lightspeed/crane-api@1.0.0

### Fixed

- Fix 'preview' execution displaying stale data.
- Fix division by zero error in 'intro-slider' of the reference template.
- Fix the position of top bar during 'preview' process.
- Allow 'visible' property on 'BUTTON' design configuration in showcase files during 'build' execution.

## 1.4.2 - 2025-11-04

### Added

- Implement fetching of local section content via Chrome extension.

### Fixed

- Fix static JSON asset files during 'build' command.

### Removed

- Remove text font size restriction during the 'build' command.

## 1.4.1 - 2025-10-23

### Added

- Add support for extended ISO 639-1 language codes in the format of [ISO 639-1]\_[ISO 3166-1].
- Add `showcaseOverrides` support to custom header/footer inside multipage templates.

### Changed

- Update version of several dependencies.

## 1.4.0 - 2025-10-06

### Changed

- Update CLI TypeScript type definitions to improve type safety, code organization, and maintainability.
- Update Local Preview to support external content mocking.

### Fixed

- Fix Local Preview to correctly handle background colours in custom sections.

## 1.3.3 - 2025-09-23

### Added

- Add support for Local Preview analytics tracking.

### Changed

- Update folder structure of generated reference custom templates.
- Update version of 'eslint' dependency.

### Fixed

- Fix Local Preview for Windows operating systems.
- Fix Local Preview warning message during 'deploy' command execution.

## 1.3.2 - 2025-09-10

### Changed

- Increase server file size threshold to 500 KiB in the 'build' flow.

## 1.3.1 - 2025-09-09

### Added

- Move 'Storefront' functionality from experimental to the core feature list.

### Fixed

- Fix the 'Go to store category' action for the 'BUTTON' configuration type in custom sections.

## 1.3.0 - 2025-09-01

### Added

- Add hot reload support for local preview.

### Changed

- Update version of 'axios' dependency.

## 1.2.6 - 2025-08-06

### Added

- **Storefront (experimental):** add support for custom slots in storefront page layouts.

## 1.2.5 - 2025-07-07

### Added

- Move 'Local Preview' functionality from experimental to the core feature list.
- Add new CLI command to start a local development server to serve previews of custom sections.

### Changed

- Update version of 'vite' dependency.

## 1.2.4 - 2025-06-02

### Added

- **Storefront (experimental):** add multipage template support in the 'deploy' flow.
- **Storefront (experimental):** add external layout support during compilation of multipage templates.
- **Storefront (experimental):** implement external layout selection and deployment integration for multipage templates.
- **Local Preview (experimental):** add structural support for local custom section preview generation.
- Add validation for translation label properties in custom section configuration files during the 'build' command.
- Add typing for all the available font sets in the custom section configuration files.

### Changed

- Update versions of 'unbuild' and 'vite-plugin-static-copy' dependencies.

### Fixed

- Fix the validation flow for template section showcase overrides.

## 1.2.3 - 2025-05-15

### Changed

- Update the custom header's 'Navigation' component to display a hover-activated category dropdown.

### Fixed

- Fix the image validation for custom section and template configuration files during the 'build' command.

## 1.2.2 - 2025-05-12

_If you are upgrading: please see [UPGRADE.md](UPGRADE.md)._

### Added

- **Storefront (experimental):** add multipage support for Custom Templates.
- Add image validation for custom section and template configuration files during the 'build' command.
- Provide icon URL for 'Made With' component through the external content.

### Changed

- **Breaking:** Change minimal supported Node.js version to 22 LTS.
- **Breaking:** Upgrade ESLint dependency to version 9.

### Removed

- **Breaking:** Remove unused image resolutions from the templating files across all sections.

## 1.2.1 - 2025-04-17

### Added

- Add support for 'Divider' configuration type for custom sections.

### Changed

- Update versions of 'unbuild' and 'axios' dependencies.
- Clean up unused package dependencies for the reference custom section.

### Fixed

- Fix preview image name of the example header.
- Fix reference custom section to respect the global design configurations.
- Display CLI help instructions consistently.

## 1.2.0 - 2025-03-07

### Added

- **Breaking:** Add a maximum server file size restriction during 'build' execution.
- Move 'header & footer' functionality from experimental to the core feature list.
- Add usage example of all the missing available configuration types to the reference section.
- Add compressed source code bundle to 'deployment' process.

### Changed

- Update error message display upon asset deployment to be more descriptive.

### Fixed

- Fix 'shared' folder generation while creating sections, headers and footers.
- Fix section showcase validation during the 'build' execution in case of empty content and design configurations.
- Fix validation rules around newly generated section, header and footer.
- Fix the external content usage of the 'Language Selector' component in headers and footers.

## 1.1.3 - 2025-02-03

### Added

- **Header & Footer (experimental):** add support for 'Made With' component in footers.
- **Header & Footer (experimental):** add validation to custom header and footer setting files during 'build' execution.
- **Header & Footer (experimental):** add individual header and footer resource initialisation to the CLI options.
- **Header & Footer (experimental):** add support for external content for headers and footers.
- **Header & Footer (experimental):** implement mandatory content settings for custom headers and footers.
- Add validation to custom section setting files during 'build' execution.
- Add two new reference custom templates.

### Changed

- Update progress bar for deployment to monitor upload speed.
- Make externalization default during 'build' process.
- Enhance client-side performance by enabling code splitting.
- Improve 'BUTTON' configuration type's interface.

### Fixed

- **Header & Footer (experimental):** fix showcase URL for headers and footers.
- Fix the need to manually install 'vite:terser' as a dependency for the 'build' process.
- Fix template name prompt for names containing numbers.
- Fix 'BUTTON' configuration type validation during 'build'.

## 1.1.2 - 2025-01-09

### Added

- **Header & Footer (experimental):** add support for 'Language Selector' component in headers and footers.
- **Header & Footer (experimental):** add support for 'Logo' component in headers.
- **Header & Footer (experimental):** add support for 'Navigation' component in headers.
- **Header & Footer (experimental):** add support for 'Account' component in headers.
- **Header & Footer (experimental):** add support for 'Legal Pages' component in footers.

### Fixed

- Fix showcase overrides for images in case of the 'DECK' configuration element.

## 1.1.1 - 2024-12-10

### Added

- **Header & Footer (experimental):** add support for 'Report Abuse' component in footers.
- **Header & Footer (experimental):** add support for 'Cart' component in headers.
- **Header & Footer (experimental):** add support for 'Search' component in headers.
- **Header & Footer (experimental):** include header and footer generation in template initialisation.
- Add compression and minification to 'build' process.
- Add new 'DECK' configuration element to custom sections.

### Fixed

- Fix 'BUTTON' configuration element with 'GO_TO_PAGE' type.

## 1.1.0 - 2024-11-07

### Added

- **Header & Footer (experimental):** add skeleton folder structure for custom reference header and footer.
- Perform a clean operation of the 'dist' folder during the 'build' command.
- Add support for deployment of high number of sections at one time.
- Add a progress bar for the deployment process.
- Add retry mechanism for recoverable errors during the section deployment.
- Update template descriptor to include optional showcase ID.
- Add optional custom template url to use for template previews.
- Add optional showcase overrides to template descriptor.

### Changed

- Update section validation to make layout descriptor file optional.
- Change error message display upon failed deployment.

### Fixed

- Update failed command executions to return the proper exit code.

## 1.0.3 - 2024-09-24

### Added

- Add Layout support.

### Fixed

- Apply line breaks and multiple spaces to 'TEXTAREA' types.

## 1.0.2 - 2024-09-12

### Added

- Add the possibility to specify a cover image for the created templates.
- Add 'test_site_id' to the template descriptor.
- Impose file size restriction during build execution.

### Changed

- Update 'build' and 'deploy' flows to include the template assets.

### Fixed

- Fix logic regarding determining correct 'BUTTON' type.
- Fix deployment on Windows machines.

## 1.0.1 - 2024-08-08

### Added

- Add font support for design configurations.
- Clean 'dist' folder before every 'build' command execution.
- Add licensing.

### Fixed

- Fix handling of thumbnails for reference custom section.
- Fix version increment in case of failed deployment.
- Fix application creation with same name to avoid overriding an existing version.

## 1.0.0 - 2024-07-29

### Added

- Add reference section for third party developers.

## 0.1.1 - 2024-07-22

### Added

- Include a README.md file.

## 0.1.0 - 2024-07-22

### Changed

- Include template descriptor in 'deploy' command.
- Standardize CLI commands.

## 0.0.1-beta.24 - 2024-05-13

_Last beta release._
