Changelog

What changed, and when.

Every released version of the toc-depth extension, and what each one changed.

0

0.7

0.7.1 (2026-09-23)

Bug Fixes
  • fix: Read toc-depth and the default option as the integers the schema declares. A fraction such as 1.5 was applied while the same document was told the value was invalid, and it is now reported and ignored. (#35)
  • fix: Report a key nested inside an option as a warning rather than an error, so one nested typo does not invalidate the whole configuration. This matches how the extension already reports an unknown key at the top of its own block. (#35)
Documentation
  • docs: Serve the extension’s social card as the Open Graph image, so a shared link shows the card rather than the first image on the page. (#32)
Refactoring
  • build: Update the vendored Lua modules to 2.3.0, which includes the schema-check fix for an extension whose entry points are in a subdirectory. A module no longer carries a version line in its header, so its checksum changes only when its code changes. (#33)
  • build: Fetch the schema validator from a Quarto Wizard release asset rather than a raw path inside its repository, which a refactor could move without notice. The vendored file is unchanged. (#34)
  • build: Update the vendored Lua modules to 2.5.0, which adds the accessors that read what the schema resolves an option, an element’s attributes and a format’s options to. The schema validator moves to its own release train and is pinned at schema-v2.2.0, which accepts only true and false as a boolean. (#35)

0.7.0 (2026-09-07)

New Features
  • feat: Check the document configuration against the extension schema and report what it does not accept. (#28)

0.6

0.6.1 (2026-08-01)

Documentation
  • docs: Add a documentation website under docs/, built on the atelier project type and published to https://m.canouil.dev/quarto-toc-depth/.
  • docs: Record the interaction with Quarto’s own toc-depth, which is applied first, so a heading attribute can narrow the contents but not widen them beyond that limit.
  • docs: Trim README.md to a landing page pointing at the website, and example.qmd to a short starting point to copy.
  • docs: Add the Pages workflow, which renders docs/ on pull requests and deploys it from the release tag.
  • docs: Add the Quarto Extensions Updates workflow, scanning docs for the website’s own dependencies.

0.6.0 (2026-05-31)

Bug Fixes
  • fix: Reset module-level cascade state in the Meta pass so batch renders no longer leak state between documents.
  • fix: Clamp negative toc-depth values to 0 and emit a warning instead of silently producing inverted cascade behaviour.
  • fix: Warn on non-numeric toc-depth attributes and on non-numeric extensions.toc-depth.default values instead of accepting them silently.
Documentation
  • docs: Document the toc-depth=0 dual effect (unlisted and unnumbered).
  • docs: Document the cascade-override rule with a worked example where a child re-opens the TOC for its sub-tree.
  • docs: Add a cross-format support statement covering HTML, LaTeX/PDF, DOCX, and Typst.
  • docs: Document input validation (negative and non-numeric values).
Refactoring
  • refactor: Add shared logging.lua module and route warnings through quarto.log.warning with the [toc-depth] prefix.

0.5

0.5.0 (2026-05-24)

New Features
  • feat: Add extensions.toc-depth.default option to set a document-wide default depth applied to headers without an explicit toc-depth attribute.

0.4

0.4.0 (2026-03-23)

Refactoring
  • refactor: Replace monolithic utils.lua with focused modules (string.lua, logging.lua, metadata.lua, pandoc-helpers.lua, html.lua, paths.lua, colour.lua).

0.3

0.3.1 (2026-02-21)

New Features
  • feat: Rename element-attributes to attributes in schema (#11).

0.3.0 (2026-02-21)

New Features
  • feat: Add extension-provided code snippets (#9).
  • feat: Add _schema.yml for configuration validation and IDE support (#6).

0.2

0.2.1 (2026-02-11)

Bug Fixes
  • fix: Update copyright year.
  • fix: Use british english spelling.

0.2.0 (2025-10-25)

Refactoring
  • refactor: Use module and enhance extension (#3).

0.1

0.1.0 (2025-08-13)

New Features
  • feat: Toc-depth filter.
Back to top