What's Changed

• Fix spelling of pub topic by @parlough in #41

New Contributors

• @parlough made their first contribution in #41

Full Changelog: liquify-v1.6.0...liquify-v1.6.1

• fix topic typo

package:liquify v1.6.1 Latest

Latest

Compare

Choose a tag to compare

Browser Support

• Make the package usable from browser builds - Split the filesystem exports so webdev/browser entrypoints no longer pull in dart:io, allowing the package to be used more freely in the browser and in the playground.

Bug Fixes

• Switch date filter strftime formatting to d4_time_format - Replaced custom _applyStrftime() converter with d4_time_format package for standard strftime specifiers. Custom %P, %:z, %Z (timezone name), and %q (ordinal suffix) specifiers are preserved via a small shim.

Browser Support

• Make the package usable from browser builds - Split the filesystem exports so webdev/browser entrypoints no longer pull in dart:io, allowing the package to be used more freely in the browser and in the playground.

Bug Fixes

• Switch date filter strftime formatting to d4_time_format - Replaced custom _applyStrftime() converter with d4_time_format package for standard strftime specifiers. Custom %P, %:z, %Z (timezone name), and %q (ordinal suffix) specifiers are preserved via a small shim.

package:liquify v1.6.0

Compare

Choose a tag to compare

Bug Fixes

• Fix keyword word boundary parsing - Keywords empty, true, false, and nil no longer incorrectly match prefixes of identifiers (e.g., empty_title, true_value, false_flag, nil_check now correctly parse as identifiers)

Bug Fixes

• Fix keyword word boundary parsing - Keywords empty, true, false, and nil no longer incorrectly match prefixes of identifiers (e.g., empty_title, true_value, false_flag, nil_check now correctly parse as identifiers)

package:liquify v1.5.1

Compare

Choose a tag to compare

New Features

• Custom delimiters support - Configure alternative template delimiters via LiquidConfig
  • Use ERB-style (<% %>, <%= %>), bracket-style ([% %], [[ ]]), or any custom delimiters
  • Built-in presets: LiquidConfig.erb for ERB-style templates
  • Custom tags automatically support configured delimiters via createTagStart(), createTagEnd(), etc.
  • Parser caching ensures performance is not impacted when using multiple configurations

Performance Improvements

• 92-95% reduction in parser activations through comprehensive optimization:
  • Lookahead-based element routing (skips tag parsers for plain text)
  • Precedence-based expression parser (eliminates repeated prefix parsing)
  • Pattern-based text(), identifier(), and memberAccess() parsers
  • First-character routing in primaryTerm() (skips impossible alternatives)

Breaking Changes

• Custom tags using {{ }} syntax must now explicitly declare their delimiter type

  If you have a custom tag that uses variable-style delimiters ({{ mytag }}), you must now override delimiterType:

  class MyCustomTag with CustomTagParser {
    @override
    TagDelimiterType get delimiterType => TagDelimiterType.variable;
    
    @override
    Parser parser() {
      // ... your parser implementation
    }
  }

  Custom tags using standard {% %} syntax (the default) require no changes.

Internal Changes

• Add TagDelimiterType enum to distinguish custom tag delimiter styles
• Optimize parser routing based on delimiter lookahead

New Features

• Custom delimiters support - Configure alternative template delimiters via LiquidConfig
  • Use ERB-style (<% %>, <%= %>), bracket-style ([% %], [[ ]]), or any custom delimiters
  • Built-in presets: LiquidConfig.erb for ERB-style templates
  • Custom tags automatically support configured delimiters via createTagStart(), createTagEnd(), etc.
  • Parser caching ensures performance is not impacted when using multiple configurations

Performance Improvements

• 92-95% reduction in parser activations through comprehensive optimization:
  • Lookahead-based element routing (skips tag parsers for plain text)
  • Precedence-based expression parser (eliminates repeated prefix parsing)
  • Pattern-based text(), identifier(), and memberAccess() parsers
  • First-character routing in primaryTerm() (skips impossible alternatives)

Breaking Changes

• Custom tags using {{ }} syntax must now explicitly declare their delimiter type

  If you have a custom tag that uses variable-style delimiters ({{ mytag }}), you must now override delimiterType:

  class MyCustomTag with CustomTagParser {
    @override
    TagDelimiterType get delimiterType => TagDelimiterType.variable;
    
    @override
    Parser parser() {
      // ... your parser implementation
    }
  }
  

  Custom tags using standard {% %} syntax (the default) require no changes.

Internal Changes

• Add TagDelimiterType enum to distinguish custom tag delimiter styles
• Optimize parser routing based on delimiter lookahead

package:liquify v1.5.0

Compare

Choose a tag to compare

Full Changelog: v1.4.1...v1.4.2

• Bump dependencies

v1.4.2

Compare

Choose a tag to compare

Full Changelog: v1.4.0...v1.4.1

Fix: Add better handling of filtered assignments

v1.4.1

Compare

Choose a tag to compare

What's Changed

• Generic Buffer by @kingwill101 in #34

Full Changelog: v1.3.1...v1.4.0

Liquid tag improvements

• Treat each non-empty line in {% liquid %} blocks as a statement
• Ignore whitespace-only lines inside {% liquid %} blocks
• Error on CR-only line endings in {% liquid %} blocks for consistent parsing behavior
• Route {% liquid %} output through the active buffer (works correctly inside captures)

Output and scope semantics

• Preserve value types for single-expression tag content so numeric filters (e.g., times) behave correctly
• assign inside for loops now persists after the loop while keeping forloop and loop variables local

Tests

• Add {% liquid %} shorthand syntax and whitespace handling tests
• Add capture regression coverage for {% liquid %} output routing

v1.4.0

Compare

Choose a tag to compare

What's Changed

• Better string escaping by @kingwill101 in #33

Full Changelog: v1.3.0...v1.3.1

• Fix string literal parsing to correctly handle escaped quotes and characters
• Add regression tests covering render tag and evaluator behaviour with escaped strings

v1.3.1

Compare

Choose a tag to compare

What's Changed

• Fix MapRoot docs by @kingwill101 in #27
• Better parsing of if/for/case tags by @kingwill101 in #31

Full Changelog: v1.2.0...v1.3.0

• Correctly check for elsif tags and not elseif
• tablerow - use seperate buffer for each row being rendered
• refactor parsers for if/case/for to better capture content in else branches etc

v1.3.0

Compare

Choose a tag to compare

🔒 Environment-Scoped Registry

• Add environment-scoped filter and tag registration
• Add strict mode for security sandboxing
• Add Environment.withStrictMode() constructor
• Add Template API support for custom environments
• Add environment cloning with local registrations

🔧 Parser Improvements

• Fix operators to prevent invalid matches with adjacent words
• Enhance comparison, logical, and unary operator parsing
• Improve operator precedence handling

🏷️ Render Tag Fixes

• Fix variable scope isolation in render tags
• Prevent variable leakage to parent scope
• Add comprehensive scope isolation tests

📚 Documentation

• Add environment-scoped registry documentation

📚 Documentation

• Complete documentation overhaul: Added comprehensive documentation system
• Examples documentation: Added 5 detailed example guides covering basic usage, layouts, custom tags, drop objects, and file system integration
• Tags documentation: Complete reference for all 21 tags with usage patterns and examples
• Filters documentation: Comprehensive documentation for 68+ filters across 7 categories (array, string, math, date, HTML, URL, misc)
• API documentation: Structured documentation hub with cross-references and navigation

🧮 Filters

• NEW: Add parse_json filter for parsing JSON strings into Dart objects
• Enhancement: Math filters now handle null values gracefully (null treated as 0, prevents runtime type cast errors)
• Enhancement: Complete expression-based filters (where_exp, find_exp, group_by_exp, etc.) with proper Liquid expression evaluation
• Enhancement: Add missing array manipulation filters: compact, concat, push, pop, shift, unshift, reject, sum, sort_natural, group_by, has
• Fix: Filter arguments now support member access expressions (e.g., append: features.size)

🏗️ Core Improvements

• Fix: Boolean literal parsing in comparison operations (true/false now parsed as literals instead of identifiers)
• Enhancement: FileSystemRoot and MapRoot now have extensions and throwOnError support
• Complete: 100% filter test coverage with comprehensive regression tests

🏷️ Tags

• NEW: comment
• NEW: doc

🧪 Testing

• Complete test coverage for all implemented filters
• Add regression tests for boolean literal parsing
• Enhanced render tag tests

• Fix FileSystemRoot to handle null fileSystem argument safely and consistently fallback to LocalFileSystem
• Add tests for FileSystemRoot null fileSystem behavior

• Fix contains operator

• allow iterating over key value pairs in for tags

• Disable internal resolver/analyzer logging

• Layout tag support
• Async rendering support

• Template Enhancements:

  • Added layout tag support with title filter.
  • Implemented template analyzer and resolver.

• Analyzer Improvements:

  • Initial support for a static analyzer.
  • Extensive testing and improvements in static analysis.
  • Enhanced resolver and analyzer integration.

• Filter Enhancements:

  • Enabled dot notation for array filters.

• layout tag support

• Make sure we register all the missing string filters

• support elseif tags

• Start throwing exceptions when parsing fails

• For tag: make sure iterable is not null before assignment

• Truthy support for binary operators

0.7.2

• Array support

• array support

• Fix parse failure for single { character
• Better whitespace control handling
• Optional tracing and linting

• Allow identifiers with hyphens

• Member access fix

• Filtered assignment fix

• Group filters into modules

• Empty type
• MapRoot Root implementation

• Filesystem lookup
• Render tag

• Support floating point numbers
• Support negative numbers

• Add built in filters

• Initial version.