Skip to content

Releases

v0.10.0

Choose a tag to compare

@github-actions github-actions released this 17 Oct 04:36

v0.10.0

Release date: 2026-10-17
Maintainer: exyonefs

Highlights

  • Restructured the starter as a flat, minimal blog, reducing directory depth and default structural complexity for a lighter out-of-the-box experience.
  • Modularized the theme into components and layers, and renamed design tokens by purpose to improve theme customization and long-term maintainability.
  • Updated Feeds to accept the feed path and language as parameters, making it easier to support multilingual sites or multiple feed output paths.

Fixes and Improvements

  • Fixed the extra blank line appearing below code blocks.
  • Tightened starter typography and spacing for a better default reading experience.

Refactoring and Internal Changes

  • Split theme styles into components and layers.
  • Renamed design tokens to follow a purpose-based naming convention.
  • Parameterized the Feeds module: feed path and language are no longer implicitly configured.
  • Flattened the starter structure into a minimal blog layout.
  • Established an initial commit containing only the current state as the version baseline.

Upgrade Notes

This release includes changes to theme token naming, Feeds invocation, and starter structure. Before upgrading customized projects, please check the following:

  1. Custom themes: Check for references to old design token names. If you have custom overrides, migrate them according to the new purpose-based naming rules. Since the theme is now split into components and layers, component/layer override paths may also need to be updated.
  2. Feeds usage: Check all Feeds call sites and confirm that the feed path and language are passed using the new parameterized approach. If you relied on the previous default behavior, verify the output paths and language results.
  3. Projects based on the old starter: If you modified the previous starter directly, re-check templates, configuration, and asset paths when migrating to the new flat structure.
  4. Back up your custom themes, starter configuration, and Feeds-related configuration before upgrading.

Full Changelog: https://github.com/exyonefs/zest/commits/v0.10.0

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 06 Oct 10:27

v0.9.0 (2026-10-06)

  • DSL convergence: figure, details, and joinWith now live on the unified DSL layer.
  • Starter refresh: Updated default styles for Zest.App.Starter.
  • Self-documenting templates: Renamed starter partials and taxonomy templates to clearly describe what they style.

Full Changelog: v0.8.0...v0.9.0

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 06 Oct 04:20

v0.8.0 (2026-10-06)

Highlights

This release introduces a major naming and architectural refactor, a new markup DSL, improved templating, and enhanced build tooling.

Features & Improvements

Templating & Compatibility

  • Renamed Nunjucks compatibility layer to Zealucks, then subsequently to Zestucks, while preserving full Nunjucks compatibility.
  • Native Nunjucks includes are now correctly resolved from the includes directory.
  • Updated project documentation (README.md, Claude.md) to reflect the new naming and architecture.

Project Structure & Tooling

  • Simplified and restructured the project directory layout for better clarity.
  • Refactored project to clarify naming and responsibility boundaries across modules.
  • Set up development tooling and project configuration for a smoother contributor experience.
  • Added _prebuild.fsx and _finalize.fsx hooks to extend and customize the build pipeline.

Markup DSL

  • Unified DSL naming conventions across the codebase.
  • Filled in missing Markup element builders and class shortcuts for a more complete and ergonomic API.
  • Fixed self-closed non-void elements in the markup DSL to ensure standards-compliant output.

CLI & Build Experience

  • Polished CLI help layout for improved readability.
  • Hardened the build animator for more reliable feedback during builds.

Stats

  • 12 commits
  • 206 files changed
  • 1 contributor

Contributors

  • @exyone-js

Upgrade Notes

  • If you were using the previous Nunjucks compatibility layer, update any references from Nunjucks → Zealucks → Zestucks.
  • Review your template includes paths to ensure they align with the new includes directory resolution.
  • The new _prebuild.fsx and _finalize.fsx hooks are optional but recommended for custom build steps.

Full Changelog: v0.7.3...v0.8.0

v0.7.3

Choose a tag to compare

@github-actions github-actions released this 12 Sep 02:42

v0.7.3 — Layout opt-out for self-contained pages

This release adds support for layout = "none", allowing pages to explicitly opt out of the layout chain.

  • Layout bypass: The renderer now checks meta.Layout before falling back to the configured default. When set to "none" (case-insensitive), the page is rendered as raw output with no layout wrapper.
  • Self-contained outputs: Feeds, standalone scripts, and similar pages no longer inherit the site template, making them truly self-contained.

Full Changelog: v0.7.2...v0.7.3

v0.7.2

Choose a tag to compare

@github-actions github-actions released this 12 Sep 02:23

Separate categories from tags in the build pipeline.

Categories and tags were previously conflated into a single taxonomy
concept, which forced every page into one flat grouping and made it
impossible to model hierarchical categories alongside free-form tags.

Split the two into distinct domain types and generators so that
categories can drive navigation structure while tags remain
cross-cutting labels. Affected parsing, domain models, and the
taxonomy and pagination generators.

Full Changelog: v0.7.1...v0.7.2

v0.7.1

Choose a tag to compare

@github-actions github-actions released this 11 Sep 18:11

Zest SSG v0.7.1 — Release Notes

Released: September 12, 2026
Range: 0.7.0 → 0.7.1 (6 commits, 62 files changed, +1,088 / −2,973)

This is a focused follow-up to 0.7.0. The two themes are a substantially reworked incremental cache that now rebuilds only genuinely changed pages, and a drastic simplification of the bundled starter theme into a single-article LaTeX-style "paper" design. A number of i18n, metadata, routing, and theme modules were also tightened up.


Breaking Changes (Starter Template Only)

The zest init scaffold was reduced from a full blog to a single-article site. If you were relying on the old starter as a reference, note that the following were removed from the template:

  • _init.zest.fsx, _data/nav.toml, and theme _data/nav.toml
  • Locales (_locales/en.toml, _locales/zh.toml) and the | t translation usage
  • Layouts base.html, default.html, home.html, tag.html, tags.html, terms.html
  • Includes footer.html, page-shell.html, themevars.html
  • Content pages 404, about, archives, features, index.zest.fsx, search, tags
  • All sample posts plus content/posts/index.njk
  • The split ZCSS slices (tokens, base, components, pages, responsive)

The site is now one Markdown article (content/index.md) rendered through a single post layout, with rss.zest.fsx, atom.zest.fsx, and sitemap.zest.fsx retained. Styles were consolidated into a single main.zcss.

The theme manifest was reset accordingly: oxygen is now version 1.0.0, author exyone, license BSD-2-Clause, description "The default theme for Zest SSG."

Note that this affects only newly generated sites. Existing projects are unaffected.


Incremental Build Correctness

This is the headline fix. The previous cache keyed staleness on file modification time and a global template signature, which in practice rebuilt more than necessary and could miss changes.

  • Content-hash based staleness. BuildCache.needsRebuildWithText replaces needsRebuildWithDeps, comparing the source text hash rather than relying on mtime. Editing a file without advancing its timestamp is now detected.
  • Per-template diffing. loadCache now takes a list of (templatePath, templateText) pairs instead of a single signature. It diffs each template's content hash and marks only the pages that depend on a changed template as stale, so editing one layout rebuilds the affected pages rather than the whole site.
  • Per-page dependency tracking is broader. During the write phase, each page records a dependency on every level of its layout chain plus every include those layouts reference, resolved via the new LayoutEngine.layoutChain, collectIncludePaths, and getIncludePathMap. Previously only the top-level layout was recorded.
  • Cache writes are keyed by output path. updateCacheWithHash now takes the outPath explicitly, keeping the dependency and page caches consistent.

Layout and Include Loading

  • Timestamp caching removed from loadLayouts and loadIncludes. Files are now read on every call. The rationale, documented in the code, is that an editor can rewrite a file without advancing its modification time; reading a handful of templates is negligible next to rendering the site.
  • Include-set content signature. setIncludesMtime was replaced by setIncludesSignature, which invalidates the include-substituted layout cache when the content of any include changes — again, independent of timestamps.
  • Processed-layout cache key. applyLayoutCached now keys on path | layoutHash | includesSignature instead of path | mtime.
  • Include path map merging. BuildEngine now merges the theme and project include path maps so a page can resolve which include files it depends on, with project entries winning.

Build Diagnostics

  • Timing output trimmed. The per-phase [Zest][timing] instrumentation added in 0.7.0 (including fsi-cold-start, content-batchlayout, html-format, content-write, taxonomy-render, and the pagination/taxonomy sub-phases) was removed in favor of the simplified build-time prompt introduced in this release. The markPhase calls that remain use shorter labels (setup, content, assets).

Module Optimizations

The commit "Optimize i18n, metadata, routing, and theme modules" touched several subsystems:

I18n (LocaleLoader.fs)

  • Inner locale dictionaries are now built directly as IDictionary values, removing the second widening pass and copy in loadLocales.
  • formatText appends literal runs in bulk instead of character by character.
  • A shared empty argument bag avoids allocating a dictionary for lookups without interpolation.
  • JSON array values are read via GetString() rather than ToString().Trim('"').
  • Directory.GetFiles replaced with Directory.EnumerateFiles.

Metadata (MetaParser.fs)

  • parseTomlWithLines now returns option, so a malformed +++ block degrades to the extension-specific parser instead of being silently ignored — and reports the parse failure via a warning.
  • The F# comment header scan is index-based and stops at the first content line rather than walking the whole body.
  • Compiled tagSplitPat replaces an inline Regex.Split call.
  • applyDefault lowercases the key once so recognized keys and Extra entries share a single spelling.

Routing (PermalinkRouter.fs)

  • slugify removes invalid characters before collapsing hyphens, so punctuation between two words can no longer leave a doubled hyphen.
  • computePermalink and defaultRoute normalize the directory once and reuse it for both URL segments and file paths.

Theme (ThemeResolver.fs, ThemeConfigLoader.fs)

  • git clone now drains stdout and stderr before waiting, avoiding a pipe-buffer deadlock on verbose clones; a timeout kills the process tree and cleans up the partial cache entry.
  • URL theme caching tests for any filesystem entry, not just files, so a theme whose root contains only directories is still a valid cache hit.
  • path theme resolution wraps GetFullPath in a try/with so a malformed path is reported instead of throwing.
  • Theme manifest parsing cleaned up with tryGetString and Option.orElse/Option.defaultValue, and pre-sized dictionaries.
  • ThemeResolver documentation now states the invariant that resolve never throws for a bad source.

Documentation

  • README.md substantially revised (large diff).
  • src/Zest.App/Starters/README.md rewritten to describe the single-article scaffold.
  • src/Zest.App/Starters/_config.toml reduced to site metadata, build options, a [theme] block, and a single [[taxonomies]] entry for series (keeping the starter free of generated /tags/ pages).
  • Directory.Build.props and zest.toml bumped to 0.7.1.

Internal Notes

  • BuildLayout.setIncludesMtime renamed to setIncludesSignature.
  • LayoutEngine.currentIncludesMtime renamed to currentIncludesSignature.
  • LayoutEngine.getLastIncludesMtime replaced by getIncludePathMap / setIncludePathMap.
  • Starter Zest.App.csproj embedded resource list updated to match the reduced file set; _init.zest.fsx is no longer embedded.
  • atom.zest.fsx, rss.zest.fsx, and sitemap.zest.fsx now filter articles by p.date <> "" instead of a /posts/ URL prefix, matching the single-article layout.

Full Changelog: v0.7.0...v0.7.1

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 11 Sep 15:50

Zest SSG v0.7.0 — Release Notes

Released: September 11, 2026
Range: 0.6.1 → 0.7.0 (11 commits, 78 files changed, +4,494 / −2,781)

This release is a major internal reorganization and a substantial build-performance push, alongside meaningful template-engine parity work. Highlights include batched F# layout evaluation, lock-safe atomic output writes, a template-aware incremental cache, an enable_html_minification switch, and full directory restructurings of the DSL, ZCSS, Nunjucks, and Handlebars subsystems.


Breaking Changes

  • the project tagline is now "Zest: Easy Static-site Toolkit" (previously "Zealous Efficient Static Toolkit"). Package metadata, README, and zest.toml were updated.

Performance

  • Batched F# layout evaluation. Taxonomy and pagination generators previously entered FSI once per generated page (e.g. once per tag — ~25 round-trips per build). Layouts are now applied to all pages in a single batched FSI run per layout-chain level, cutting the dominant build cost. Failed tasks are retried individually so one bad page never loses its siblings.
  • Two-phase content write. The content pipeline now partitions results into cached and rebuild pages first, applies layouts in one batched pass, then post-processes (format/minify) and writes in parallel. This removed the per-page FSI re-entry that dominated large builds.
  • Parallel asset post-processing. CSS/JS formatting and minification now enumerate files once and process them with Parallel.ForEach.
  • Template-aware incremental cache. A content hash over every layout and include (computeTemplateSignature) invalidates the page cache when templates are edited, added, or deleted — while unchanged templates keep per-page reuse intact for fast incremental builds.
  • Includes mtime from single traversal. The second directory sweep for includes was eliminated; LayoutEngine.getLastIncludesMtime() now reuses the traversal already done by loadIncludes.
  • F# context caching. Zest.Dsl.Context.ensure caches the parsed context by (path, mtime), so repeated FSI evaluations within one build no longer re-read the JSON context file. Stale contexts are never served across builds.
  • Reference-equality context cache. The Nunjucks site-context cache now keys on Object.ReferenceEquals for both globalData and SiteConfig instead of hash codes, eliminating accidental cache collisions.
  • Build phase timing. The build engine and content pipeline now emit [Zest][timing] lines for setup-init, fsi-cold-start, content-pipeline, taxonomy, pagination, assets-copy, asset-format, and sub-phases (content-batchlayout, html-format, html-minify, content-write, taxonomy-render, pagination-batchlayout, etc.), making long builds attributable to a specific stage.
  • Streaming FSI I/O. FSI stdout/stderr collection moved from ConcurrentQueue to BlockingCollection, giving the reader a proper blocking wait (TryTake(&line, 10)) instead of Thread.Sleep 10 polling.

Build Reliability

  • New AtomicFile module. Output writes go to a unique sibling temp file and are then File.Move'd over the target with a bounded retry. This lets the preview/dev server's open read handles finish on the old file while new requests see the new one, and absorbs transient locks from antivirus scanners and editors. Used by the content pipeline, taxonomy generator, pagination generator, and asset post-processing.
  • Preview server reads with FileShare.Delete. HttpServer now reads HTML and compressed assets through ReadAllTextWithDeleteShareAsync / ReadAllBytesWithDeleteShareAsync, so a concurrent atomic rename can swap the file under an in-flight response.
  • In-flight request tracking. HttpServer tracks fire-and-forget request tasks and waits up to 5 seconds for them on Shutdown, instead of abandoning responses mid-write.
  • SSE/WebSocket broadcast no longer blocks the rebuild loop. DevServer, PreviewService, and SocketHub now snapshot the client list under the lock and write outside it, on a background task.
  • FSI child process is shut down on exit. One-shot builds (BuildController) and both serve modes (DevServer, PreviewService) now call FsiSession.shutdown(), so the long-running dotnet fsi child no longer holds the terminal open after Zest exits. Watch mode deliberately keeps it alive for reuse.
  • Non-blocking shutdown. FsiSession.shutdown() uses Monitor.TryEnter(sync, 500) and falls back to killing the process tree directly, so shutdown never blocks on a 60 s evaluation timeout.
  • Failed page writes no longer abort the build. Individual write failures in the content pipeline are collected as errors and reported, rather than propagating.

New Features

  • enable_html_minification. A new SiteConfig flag (default false), wired through ConfigLoader from _config.toml, [site], or [build] sections. HTML post-processing is split into its own phase with dedicated timing output; formatting takes priority when both flags are enabled.
  • HAML converter expanded:
    • #{expr} interpolation → {{ expr }}
    • !!! / !!! 5 / strict / frameset / transitional / 1.1 / basic / mobile / xml → correct DOCTYPE declarations
    • &= expr escaped output (alias of =)
    • Multi-line {...} attribute hashes joined until braces balance
    • Attribute values now run through renderInterp, so class="#{cls}" works
  • Liquid converter expanded:
    • forloop.parentloop captured into __parentloop before each nested loop
    • break / continue → Nunjucks equivalents
    • increment / decrement → set-based arithmetic with output
  • Pug converter expanded:
    • case / when / default → {% if %} / {% elif %} / {% else %} chains (when a, b becomes a or b equality tests)
    • while cond → bounded {% for __while_i in range(0, 100000) %} with immediate {% break %} (documented 100k iteration cap)
    • Attribute parsing now handles optional commas and keeps nested ()/[]/{} values intact
  • ITemplateEngine documented. Filter, tag, and render contracts are now specified with XML docs, including the concurrency requirement that Render be safe to call from parallel page workers.

Refactoring & Reorganization

The codebase was restructured into layered directories across four subsystems. All renames preserve public type names and namespaces, so external consumers are unaffected.

  • Zest.Dsl reorganized into Core/, Utility/, Css/, Sugar/, Html/, Data/, Metadata/, Migration/. Zest.Dsl.fsproj compile order rewritten to reflect the new dependency layers.
  • Zest.Engine/Zcss reorganized into Syntax/, Evaluation/, Parsing/, Builtins/, Compilation/, Tooling/.
  • NunjucksEngine.fs (1,610 lines) split into a dedicated NunjucksEngine/ directory: NunjucksTypes → NunjucksTokenizer → NunjucksCompiler → NunjucksEvaluator → NunjucksBlocks → NunjucksRenderer → NunjucksEntry.
  • HbsEngine.fs (575 lines) split into a dedicated HbsEngine/ directory: HbsTypes → HbsTokenizer → HbsParser → HbsContext → HbsRenderer → HbsEntry.
  • Engine entry files renamed to drop the redundant Engine suffix.
  • BuildCache.clearCache moved earlier in the module so a signature mismatch during load can discard a stale cache immediately.
  • Project references cleaned up in Zest.Dsl and Zest.Engine.

Documentation

  • README.md updated for the _init.zest.fsx rename and the new tagline; the Acknowledgements section was removed.
  • CLAUDE.md substantially revised (large diff).
  • Directory.Build.props version, assembly version, file version, description, and package tags updated to 0.7.0.
  • zest.toml [meta] version and header updated.

Internal Notes

  • New cache header shape: # zest-cache v3 | engine=<sig> | tpl=<sig>.
  • New build dependency: System.Threading / System.Threading.Tasks in BuildEngine.
  • ScriptRunner now deletes the previous per-build context file on resetSession, preventing %TEMP% accumulation across builds.

Full Changelog: v0.6.1...v0.7.0

v0.6.1

Choose a tag to compare

@github-actions github-actions released this 08 Aug 06:15

Zest SSG v0.6.1 – August 8, 2026

A patch release with two important fixes for F# script evaluation.

  • Fixed generic type inference – explicit type annotations are now injected for the tags field, resolving a compile‑time ambiguity that could occur in some page scripts.
  • Improved page data injection – data is now embedded directly into the generated .fsx script instead of using a separate #load data file, reducing file I/O and improving reliability during builds.

No breaking changes. Upgrade to 0.6.1 via Directory.Build.props.

Full Changelog: v0.6.0...v0.6.1

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 08 Aug 04:39

Zest SSG v0.6.0 – August 8, 2026

A special thank you to Mistral-Vibe, our newest AI collaborator, for contributing to this release – code reviews, refactoring suggestions, and pair‑programming sessions have been invaluable in raising code quality and consistency across the project. 🤝

This is a significant infrastructure release that improves maintainability, performance, and developer experience.


Added

  • ZCSS caching layers – incremental compilation now caches parsed stylesheets; rebuilds of unchanged ZCSS files are almost instant.
  • DSL helpers – new functions and shortcuts in the F# DSL to reduce boilerplate when building pages.
  • Split Oxygen theme CSS – the theme’s styles are now organised into smaller, maintainable files (base, layout, components, utilities) instead of one monolithic main.zcss.

Changed

  • File renaming – all files and core types now follow the two‑word naming convention from CLAUDE.md. This improves code clarity and consistency across the codebase. (Breaking change for direct references – see upgrade notes below.)
  • Locale system upgraded – multi‑language support is now more robust, with better fallback and language‑detection logic.
  • Dev servers – improved reliability and faster hot‑reload feedback.
  • Template engines – version alignment and internal cleanup across all renderers.

Upgrade Notes
This release introduces breaking changes due to file/type renames. If you are a contributor or maintainer working on the Zest source code, you will need to update your imports and references.
For end‑users using Zest as a tool, your site content and _config.toml remain unaffected – the changes are internal to the framework.

Update Directory.Build.props to 0.6.0 and enjoy the faster rebuilds and cleaner codebase.

Thanks again to Mistral for the collaboration – onward! 🚀

Full Changelog: v0.5.2...v0.6.0

v0.5.2

Choose a tag to compare

@github-actions github-actions released this 07 Aug 10:00

Zest SSG v0.5.2 – August 7, 2026

This release brings theme customisation, auto‑generated tag archives, performance improvements to FSI script evaluation, and listing pagination.


Added

  • Theme parameters in _config.toml – themes can now expose configurable options (e.g. [theme] accent_color = "#3c6a5a") to adjust styling without touching the theme files.
  • Auto‑generated tag archives – pages for each tag are automatically created at /tags/<tag>/, listing all posts with that tag. No manual setup required.
  • Pagination for listings – posts list (/posts/) now supports pagination via {% paginate %} blocks, with currentPage, totalPages, and prev/next links.

Fixed

  • FSI script evaluation – resolved a bug that caused inconsistent variable resolution in _init.zest.fsx; full builds now run reliably.
  • Full‑build speed – FSI session reuse is now more aggressive, reducing cold‑start overhead across multiple build passes.

Changed

  • Documentation – updated CLAUDE.md (AI guidance) to reflect .NET 10+ target.

Upgrade Notes
If you use custom themes, you can now define theme parameters in _config.toml – see updated theme documentation.
Tag archives are built automatically; ensure your layout includes a /tags/ route if you wish to link them.

Full Changelog: v0.5.1...v0.5.2