Changelog

All notable changes to this project are documented here. The format follows Keep a Changelog.

Unreleased

1.2.0 - 2026-05-22

Added

• Added :title caption support to the high-level table API, rendered as a centered banner for text formats and as a <caption> element for :html.
• Added :footers to the table API, mirroring :headers for totals and trailing rows.
• Added a :cell-fn decoration callback so per-cell styling (such as ANSI color wrapping) is possible without :raw? true post-processing.
• Added :fill? to the table API so generated formats honor :width via fill markers in cell padding.
• Added layout-into! and table-into! writer sinks that stream rendered output to a java.io.Writer.
• Added parse-row-layout and explain-row-layout so callers no longer have to pass a positional boolean.
• Added a dedicated preset catalog (doc/presets.md) and CLI reference (doc/cli.md).
• Added a Babashka-native bb bb-format task that runs the CLI in tens of milliseconds with no JVM startup.
• Added a Babashka test runner (bb bb-test) that exercises every namespace bb supports.
• Added a --width CLI flag wired through to fill-aware output formats.

Changed

• Replaced the Instaparse-based grammar with a hand-rolled recursive descent parser. The library now has zero third-party Clojure dependencies and can be (require ...)d directly from a bb script.
• Consolidated box-drawing character sets into clj-string-layout.impl.box so presets and the high-level table API share one source of truth for each box style.
• Programmatically generate the clj-string-layout.layout compatibility shim from predicates and presets, shrinking the file from 226 lines to 57 while keeping all public aliases.
• Slimmed the README; preset catalog moved to doc/presets.md, CLI reference to doc/cli.md.
• Bumped runtime and tooling dependencies: Clojure 1.12.5, test.check 1.1.3, deps-deploy 0.2.4.
• Pinned newer GitHub Actions (checkout v6, setup-java v5, cache v5, setup-clojure 13.6.1).

Fixed

• Fixed the psql and org preset rule rows so the separator length matches the data row width.
• Markdown table output now only emits the header rule when a header is present, so headerless :markdown no longer treats the first data row as a header.
• table/table now throws :invalid-table-column for unknown :align values instead of silently defaulting to left.
• table/table now throws :empty-table-spec up front when neither :rows, :headers, nor :columns is supplied.
• :html output now honors :raw?. :width and :display-width are documented as intentionally not applying to structural HTML.
• Cleared all reflection and primitive-boxing warnings; CI now fails on regression.

Removed

• Removed the Instaparse runtime dependency.

1.1.0 - 2026-05-05

Added

• Added high-level clj-string-layout.table APIs with named formats, column specs, map-row support, and overflow policies.
• Added high-level :ascii-box and :ascii-double-box table formats with Unicode box-drawing borders.
• Added high-level Markdown alignment formats and clearer Unicode box aliases.
• Added clj-string-layout.width/ansi-width and strip-ansi helpers for ANSI-styled terminal output.
• Added Unicode-aware codepoint-width, unicode-width, and terminal-width display-width helpers.
• Added TSV, Org mode, reStructuredText, and log-safe escaping helpers.
• Added a command-line formatter for CSV, TSV, and whitespace-separated input.
• Added Babashka bb.edn tasks for formatting, testing, linting, and jar builds.
• Added an examples gallery comparing built-in table output styles side by side.
• Added a repeatable :bench alias and benchmark runner for common layout paths.
• Added structured error and ex-data reference documentation.
• Expanded the examples gallery with backing layout definitions for each high-level table format.
• Added a dedicated layout language reference with structured examples and troubleshooting notes.
• Added plain column, TSV, CSV, pipe-separated, ASCII grid, psql, Org mode, and reStructuredText preset layouts.
• Added clj-string-layout.escape/csv-cell for CSV cell escaping.

1.0.4 - 2026-05-04

Added

• Added layout-str, layout-seq, parse-layout, and explain-layout public helpers.
• Added escaped layout literals for reserved delimiter characters such as \f, \F, \{, and \}.
• Added configurable :display-width, explicit :col-widths, and :row-count options for wide glyphs and large data sets.
• Added HTML and Markdown cell escaping helpers in clj-string-layout.escape.
• Added a GitHub-readable recipe book with common layout examples.
• Added deterministic randomized and property-based test coverage for layout invariants.
• Added a tag-triggered GitHub Actions release workflow for Clojars and GitHub Releases.

Changed

• Migrated the project from Leiningen to Clojure CLI, deps.edn, and tools.build.
• Updated runtime dependencies to Clojure 1.12.4 and Instaparse 1.5.0.
• Replaced Midje tests with clojure.test.
• Removed the Specter runtime dependency by rewriting the internal transformations with standard Clojure data operations.
• Reworked CI to run linting, tests, and jar builds on Java 11, 17, and 21.
• Expanded README documentation for the layout language, predicates, built-in layouts, development commands, and release flow.
• Expanded public API docstrings and marked internal implementation namespaces as hidden from generated docs.
• Split the internals into parser, config, render, error, and predicate namespaces with a tagged internal layout representation.
• Added :repeat-for as the clearer key for repeat-group column predicates while keeping column-layout :apply-for compatibility.
• Moved the release version to version.edn and kept deploy-only dependencies out of normal jar builds.
• Changed the published Maven coordinate from com.github.mbjarland/clj-string-layout to io.github.mbjarland/clj-string-layout.

Fixed

• Removed parser debug output from normal library execution.
• Fixed the built-in HTML table layouts to emit </table>.

Removed

• Removed old Leiningen, IDE, Groovy prototype, scratch, and commented-out source files from the public artifact.

1.0.2

• Previous published release.