# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

-   replace the readme description with a full documentation page with a sandbox and some examples.

## [3.0.0] - 2025-10-06

### Changed

-   add esc filter and short hand to escape parameter and partial values

### Removed

-   $ prefix that used to represent escaped values. this is now replace with the esc filter

## [2.5.0] - 2025-07-06

### Changed

-   add stringify, upper, lower, capitalize, trim, abs, round, floor, ceil, first, last, min and max parameter and partial filters to jepy.Template

## [2.4.1] - 2025-07-05

### Changed

-   added new milestone to the road map
-   updated readme to have more details and fixed icon size

## [2.4.0] - 2025-07-05

### Added

-   an option for validation partial to the Cached blocks in jepy.Template

### Fixed

-   Cached block validation logic passed the block instead of cached params

## [2.3.5] - 2025-07-04

### Changed

-   optimised the Indented block logic and the indentation of multi-line parameters

## [2.3.4] - 2025-07-03

### Changed

-   optimised regex pattern generation
-   improved Conditional block logic

## [2.3.3] - 2025-07-03

### Changed

-   greatly improved rendering performance

## [2.3.2] - 2025-07-01

### Changed

-   improved placeholder and block regex performance for jepy.Template

## [2.3.1] - 2025-06-29

### Fixed

-   fixed readme for Conditional block

## [2.3.0] - 2025-06-29

### Added

-   "else" tag to Conditional blocks in jepy.Template to make it more readable and lean

## [2.2.0] - 2025-06-26

### Added

-   loop.index, loop.first, loop.last, loop.number, loop.size parameters for Repeating blocks

### Fixed

-   removed deprecated bool param from example for multi-line indenting
-   nested Repeating blocks do not work in jepy.Template

## [2.1.0] - 2025-06-26

### Added

-   benchmarking with mitata

### Changed

-   multi-line parameters will now be indented to their placeholder location
-   improved Indented block performance
-   improved Repeating block performance

## [2.0.1] - 2025-06-24

### Fixed

-   fixed package.json repository url and added versioned cdn link in readme

## [2.0.0] - 2025-06-24

### Added

-   added the alias property to the Repeating block, allowing you to encapsulate elements into a named object. this is handy, for example, if you provide an array of strings that you wish to refer to in your template with a specific name

### Changed

-   jepy.Placeholder changed into jepy.Template with block logic support and expanded capabilities
-   made the @ partial placeholder into an operator that could be used in other placeholder and block logic. for example it is now possible to have an raw %{@partialName} and escaped %{@partialName} partial placeholder

## [1.3.4] - 2023-12-30

### Added

-   jepy.Indented to indent rendered blocks. The rendered content of the Block provided to this will be returned indented

## [1.3.3] - 2023-12-27

### Changed

-   use the built in private class field format

## [1.3.2] - 2023-04-02

### Fixed

-   module settings and added a section to README about using this as a module

## [1.3.1] - 2023-03-27

### Changed

-   the Block interface to be public

## [1.3.0] - 2023-03-30

### Added

-   jepy.Cached to cache rendered blocks. This will return the cached value on subsequent render requests, which you may verify against if you want it to be updated.

## [1.2.1] - 2023-03-28

### Changed

-   Improved the "Usage" part of the README

## [1.2.0] - 2023-03-27

### Changed

-   Removed matchAll dependency for better browser support

## [1.1.1] - 2023-03-27

### Fixed

-   JSDoc param types and visibility

## [1.1.0] - 2023-03-27

### Added

-   The Callback block for more complex use cases. This will return the text produced by the callback function that was passed on initialisation
-   More examples and CDN link for the README usage section

### Fixed

-   Terser regex setting to the format to mangle private properties

## [1.0.1] - 2023-03-26

### Added

-   Examples for each block in the README "Usage" section

### Fixed

-   Grammar in the "Usage" section

## [1.0.0] - 2023-03-26

### Added

-   Support for parameter paths (for example "params.first-level.second-level.third-level")
-   Default block classes and Block interface for custom classes
-   Support for raw and escaped parameters through the Placeholder block
-   Automated tests for Block class functionalities
-   Building tools to generate dist files
-   Simple examples page