github.com/open2b/scriggo

This release brings improvements and new features across several parts of Scriggo: the command-line tool gains new commands and flags, the template engine adds new builtins and API, and several bugs have been fixed.

Scriggo command

• New build command that compiles a template and writes the output to files. This makes it easy to deploy a site by uploading the generated files to a static file hosting platform — a simple and fast way to bring a website to production. The build command also accepts a -llms flag to generate LLM-friendly Markdown output.
• New -http flag for scriggo serve to specify the address to listen on.
• The serve command now has the -conts flag, aligning its behavior with the existing run command.
• The serve command now also checks for path/index.html or path/index.md when neither path.html nor path.md is found.

Builtins and API

• New indentJSON builtin that indents a json value while preserving the existing object key order.
• New Template.Format method.
• New tree transformation APIs: the transformations methods of the tree now allow transforming the syntax tree at different stages of the compilation pipeline — one before the expansion of imported and extended files, and one after. This gives greater flexibility and control over how the AST tree is transformed.

Other fixes and improvements

• Fixed the handling of panic(nil).
• Various improvements and fixes to the template and the rest of Scriggo. See the full list of changes.

Breaking changes

• BuildOptions.TreeTransformer has been renamed to ExpandedTransformer to better reflect when it is executed.

Go version

The minimum required Go version is now Go 1.25, while the Scriggo command is compiled with Go 1.26.

This release follows the release of Go 1.24 and introduces updates to ensure compatibility. The minimum supported Go version is now 1.23, while the Scriggo command is compiled with Go 1.24.

Changes:

• scriggo: require Go 1.23 as the minimum supported version (breaking change)

Bug-fix release

This release addresses a bug in the emitter (issue #967).

For further details, please refer to the commit that fixed the issue.

This release introduces LiveReload functionality to the Scriggo Serve command, enabling automatic page reloads in the browser whenever the page’s template files are modified.

With LiveReload and the automatic template rebuild, changes are instantly reflected in the browser as soon as you save the files.

To disable LiveReload, use the --disable-livereload flag.

This release focuses on bug fixes and updates dependencies. It addresses the following issues:

• Resolved a race condition occurring when a function or macro was called indirectly.
• Fixed issues causing empty output when invoking a macro, especially in cases of recursive calls.
• Addressed template recompilation errors in the Scriggo serve command when a render operator was indirectly used within a show statement.

This release fixes the following issues:

• Fixed a panic in the Scriggo command when trying to import or extend a non-existent file.
• Fixed rendering issues when a non-Markdown file is rendered inside a Markdown context.

Additionally, files with the ".mdx" extension are now treated as Markdown files by default.

We’ve added the MarkdownConverter method to native.Env. A function or method, whether passed globally or imported into a template, can now use this method to retrieve the Markdown converter passed when building the template.

Finally, the scriggo serve command now enables support for footnotes in Markdown parsing.

Changes

• cmd/scriggo: fix panic when importing or extending a non-existent file
• cmd/scriggo: add extension.Footnote to goldmark (breaking change)
• internal/runtime: refactor macro calls and renderer implementation
• internal/compiler: add .mdx as default Markdown file extension (breaking change)
• native,internal/runtime: introduce the Env.MarkdownConverter method (breaking change)

This release only updates the GitHub Action files and the GoReleaser configuration for the release of Scriggo binaries.

Support for Go Compiler Versions 1.22 or Higher

This release adds support for Go compiler versions 1.22 or later.

Note that support for Go versions 1.21 or earlier is therefore removed, as functionality of Scriggo is no longer guaranteed for these compiler versions.

Fixes

• compiler/parser: fix panic on invalid default left expression

Dependency Updates

• scriggo: update goldmark from v1.4.13 to v1.7.4
• scriggo: update fsnotify from v1.5.4 to v1.7.0

This is a bug-fix release.

Changes

• builtin: fix invalid behavior of function 'HasSuffix'