apex-ruby 1.0.6 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 246b73a353cd5ad9f40ddf21474502ddf7b7b35e094c1c4ce5010c3615ae2536
-  data.tar.gz: 82f2120a839c164d26c258ff2b7f034bc26ddf4bfa93e61d248cb893219a30c2
+  metadata.gz: fdc37bc1edbe1cbc062315b8f8230237c25e32cd9d4f496d8d36eee1124f12b6
+  data.tar.gz: 76db838f83910304811af4a9fd681621950a7e26df13dc6584a0b0231e5e226c
 SHA512:
-  metadata.gz: cf4368bc5090e6dbefae29f5c6d8af8981af1272b477805f8bb3ba56dbef4bf8fe80df4555ababe4c1eae1bdb554f7341b5f3ab89f631eb292f973630b3d2760
-  data.tar.gz: 5ef47aa92805e6d98f3928c8c309eb4128db716227241c3363fa16130b42b8e52edea7d167bc0dc0226f795015a5389b2fc68a1a922e2a10194ce24dc79c8952
+  metadata.gz: d014fea698d3c440d5f72a1040aa3cdb13904fb263c917b610664445e5d210185ef2330ea97675ea948f01e9965525d25defce226a1b5cc4e0beac823b3561b5
+  data.tar.gz: d44f20cbde484a9c484eeed196dd54faff2692087ee206e58228beedc60c7d13b12ea4f5e951f6d66253b336f6570d73bcd1c913fdda085b73ea857d5871bb1d

data/ext/apex_ext/apex_ext.c

@@ -110,6 +110,8 @@ options_from_hash(VALUE h)
   set_bool(h, "github_pre_lang", &o.github_pre_lang);
   set_bool(h, "standalone",      &o.standalone);
   set_bool(h, "pretty",          &o.pretty);
+  set_bool(h, "xhtml",           &o.xhtml);
+  set_bool(h, "strict_xhtml",    &o.strict_xhtml);
   set_cstr(h, "document_title",  &o.document_title);
 
   /* Line break handling */
@@ -155,6 +157,10 @@ options_from_hash(VALUE h)
   /* Emoji options */
   set_bool(h, "enable_emoji_autocorrect", &o.enable_emoji_autocorrect);
 
+  /* Terminal output (optional; defaults come from apex_options_default) */
+  set_bool(h, "terminal_inline_images", &o.terminal_inline_images);
+  set_int (h, "terminal_image_width",   &o.terminal_image_width);
+
   /* Syntax highlighting options */
   set_cstr(h, "code_highlighter",    &o.code_highlighter);
   set_bool(h, "code_line_numbers",   &o.code_line_numbers);

data/ext/apex_ext/apex_src/AGENTS.md

@@ -0,0 +1,41 @@
+# Agent Instructions
+
+This project uses **bd** (beads) for issue tracking. Run `bd onboard` to get started.
+
+## Quick Reference
+
+```bash
+bd ready              # Find available work
+bd show <id>          # View issue details
+bd update <id> --status in_progress  # Claim work
+bd close <id>         # Complete work
+bd sync               # Sync with git
+```
+
+## Landing the Plane (Session Completion)
+
+**When ending a work session**, you MUST complete ALL steps below. Work is NOT complete until `git push` succeeds.
+
+**MANDATORY WORKFLOW:**
+
+1. **File issues for remaining work** - Create issues for anything that needs follow-up
+2. **Run quality gates** (if code changed) - Tests, linters, builds
+3. **Update issue status** - Close finished work, update in-progress items
+4. **PUSH TO REMOTE** - This is MANDATORY:
+   ```bash
+   git pull --rebase
+   bd sync
+   git push
+   git status  # MUST show "up to date with origin"
+   ```
+5. **Clean up** - Clear stashes, prune remote branches
+6. **Verify** - All changes committed AND pushed
+7. **Hand off** - Provide context for next session
+
+**CRITICAL RULES:**
+- Work is NOT complete until `git push` succeeds
+- NEVER stop before pushing - that leaves work stranded locally
+- NEVER say "ready to push when you are" - YOU must push
+- If push fails, resolve and retry until it succeeds
+
+Use 'bd' for task tracking

data/ext/apex_ext/apex_src/CHANGELOG.md

@@ -2,6 +2,393 @@
 
 All notable changes to Apex will be documented in this file.
 
+## [0.1.98] - 2026-03-19
+
+### Changed
+
+- Homebrew formula bumped to 0.1.97.
+
+### Improved
+
+- SwiftPM now exports the raw C API via the `ApexC` product.
+
+### Fixed
+
+- Avoid Swift module-name collisions so `apex_*` symbols are visible from Swift.
+
+## [0.1.97] - 2026-03-19
+
+### Changed
+
+- Metadata extraction is now mode-aware so Combined/Unified and Kramdown keep YAML-first interpretation of delimiter blocks, while MMD uses MMD-compatible precedence.
+
+### New
+
+- CSV and TSV includes now support custom separators via {delimiter=X} and single-character shorthand {X} while keeping comma/tab defaults when no override is provided.
+- This release adds delimiter support as discussed in [#13](https://github.com/ApexMarkdown/apex/issues/13)
+
+### Improved
+
+- Metadata-to-meta conversion now works consistently in MultiMarkdown, Unified (combined), and Kramdown modes.
+- In --mode mmd, delimiter-style metadata is parsed using MultiMarkdown rules while still falling back to YAML parsing for true YAML front matter.
+- Include parsing now recognizes explicit delimiter overrides consistently across iA Writer, Marked, and MultiMarkdown include styles for CSV/TSV table conversion.
+
+### Fixed
+
+- Standalone HTML now emits generic metadata headers as <meta name="..."> tags instead of dropping them.
+- Generated meta tags preserve declared metadata order and safely escape attribute content.
+- MultiMarkdown mode now accepts delimited metadata blocks with dash or dot closers (for example "----" ... "......") without leaking the delimiter into HTML output.
+- Marked include syntax now supports embedded delimiter overrides inside the include token (for example <<[data.csv{;}] and <<[data.csv{delimiter=;}] ) to avoid conflicts with bracket-plus-brace parsing patterns.
+- MultiMarkdown transclusions now accept embedded delimiter overrides (for example {{data.csv{;}}} and {{data.csv{delimiter=;}}}) and no longer fail when braces appear inside the transclusion path.
+- This release resolves [#17](https://github.com/ApexMarkdown/apex/issues/17)
+
+## [0.1.96] - 2026-03-19
+
+### Improved
+
+- Swift plugin integrations can now fetch default low-level options through NSString.defaultApexOptions() and mutate apex_options fields directly.
+
+### Fixed
+
+- Swift-side module visibility for C interop is improved by exporting ApexC from the Apex Swift module.
+
+## [0.1.95] - 2026-03-16
+
+### Improved
+
+- Added all_checks target that runs C tests and Swift package builds together for one-command verification before publishing
+- Cleanup: quieter tests by fixing logical-op and unused-variable warnings in table test suite
+
+### Fixed
+
+- Swift package now compiles cleanly in debug and release as part of all_checks, catching Swift-side breakage before release
+- Man-page renderer builds without enum or options-type warnings in both CMake CLI and Swift package builds
+
+## [0.1.94] - 2026-03-07
+
+### Fixed
+
+- CMake/C99 build: add missing stdlib.h so malloc, free, realloc, getenv, and strtol are declared (fixes build on strict compilers)
+- Bracketed spans like [-]{.taskmarker} no longer trigger list parsing; markdown="span" is only emitted when the span content contains inline markdown syntax (emphasis, links, code, etc.)
+
+## [0.1.93] - 2026-03-05
+
+### New
+
+- Tests that one-line definition list syntax (term::definition) is not converted inside inline code spans, fenced code blocks, indented code blocks, and multi-line inline code
+- Tests that emoji (:name:) patterns are not converted inside inline code spans, fenced code blocks, and indented code blocks
+
+### Improved
+
+- HTML emoji replacement skips content inside <code> and <pre> elements so code examples display :emoji: patterns as written
+
+### Fixed
+
+- Definition list one-line term::definition no longer converts inside inline code spans (backticks), preserving literal syntax in code examples
+- Definition list processing now skips indented code blocks (4+ spaces or tab), not just fenced blocks
+- Kramdown-style : definition lines inside multi-line inline code spans are no longer incorrectly parsed as definition list items
+- Emoji replacement (:name:) is now skipped inside fenced code blocks, indented code blocks, and inline code spans so patterns remain literal
+- Emoji autocorrect no longer modifies :emoji: patterns inside any code context
+
+## [0.1.92] - 2026-03-05
+
+### Changed
+
+- Update apex_options cmark_init/cmark_done callback signatures to add a user_data parameter, requiring existing C/Obj-C callback implementations to add a fourth void* argument when upgrading
+
+### Improved
+
+- Ensure custom cmark-gfm init/done callbacks configured via apex_options work consistently so extension-based integrations remain stable across builds
+- Better integration of Apex as library
+
+### Fixed
+
+- Fix cmark_done callback invocation to match the 3-argument apex_options callback signature so builds succeed again
+- Update test cmark callback helper signatures and option fields to use the current cmark_init/cmark_done API and keep the test runner passing
+- Fix cmark_done callback invocation to match the 4-argument apex_options callback signature including user_data so builds succeed again
+- Add new tests and fix missing includes
+
+## [0.1.91] - 2026-03-04
+
+### New
+
+- Add test fixtures for percent decoding
+
+### Improved
+
+- Apex_extract_heading_text now recurses into inline containers (EMPH, STRONG, LINK) and includes HTML_INLINE literal content so extracted text matches rendered HTML for reliable (level, text) matching during ID injection
+
+### Fixed
+
+- Headings with inline emphasis (e.g. "### *Processing* modes") now receive IDs correctly instead of being skipped
+- Headings with ampersands (e.g. "## Documentation & resources") now receive IDs correctly by extracting text from HTML_INLINE nodes
+
+## [0.1.90] - 2026-03-04
+
+### New
+
+- Apex_options.cmark_init callback: register custom cmark-gfm syntax extensions before parsing; call cmark_parser_attach_syntax_extension() in your callback (include cmark-gfm.h and cmark-gfm-extension_api.h when implementing) Resolves [#10](https://github.com/ApexMarkdown/apex/issues/10)
+- Apex_version_string() exposed in ObjC/Swift via [NSString apexVersion] and Apex.version
+
+### Improved
+
+- CSV/TSV inline tables (```table fences, <!--TABLE-->, includes) now accept Markdown-style alignment specs in the second row. Cells containing only colons and dashes (e.g. :--, --:, :--:) are parsed by colon position: leading = left, trailing = right, both = center, neither = auto. Keywords (left, right, center, auto) continue to work unchanged. Resolves [#14](https://github.com/ApexMarkdown/apex/issues/14)
+
+### Fixed
+
+- Include paths now support percent encoding (e.g. <<[with%20space.txt], {{file%20name}}, /path%20to%2Ffile) so paths with spaces and special characters resolve correctly to files on disk. Resolves [#12](https://github.com/ApexMarkdown/apex/issues/12)
+
+## [0.1.89] - 2026-03-04
+
+### Improved
+
+- CSV/TSV inline tables: alignment row may use Markdown-style syntax (`:--`, `--:`, `:--:`) in addition to keywords (left, right, center, auto). Cells containing only colons and dashes are parsed by colon position: leading colon = left, trailing = right, both = center, neither = auto.
+
+### Changed
+
+- Definition lists rewritten as preprocessing (no cmark extension): supports Kramdown "term" + ": definition" or ":: definition", plus one-line "term::definition" and "term :: definition" using last :: to avoid splitting URLs
+- CLI flags --one-line-definitions and --no-one-line-definitions to enable or disable definition list processing
+- Metadata keys one-line-definitions and one_line_definitions for front-matter control of definition lists
+- Table caption ": Caption" no longer misparses Kramdown definition lines (e.g. "Term\n\n: definition 1") by requiring prev_line_was_table_row or in_table_section instead of prev_line_was_blank alone
+- Table captions before tables: ": Caption" now recognized when the next non-blank line is a table row
+- Table caption paragraphs removed from output so captions appear only in figcaption, not duplicated as standalone paragraphs
+
+## [0.1.88] - 2026-03-02
+
+### Changed
+
+- Formula/apex.rb: version 0.1.87, update macOS universal tarball sha256
+
+### Improved
+
+- Definition lists: support indented continuation lines (4+ spaces) so multi-line definitions stay within a single dd element instead of splitting into separate paragraphs
+
+### Fixed
+
+- Disable smart typography for man and man-html output so option names like --to and --standalone render as literal double hyphen instead of en-dash
+- Prevent metadata from overwriting -t man-html when document sets mode or other options in front matter
+- Force disable smart typography for man and man-html output in apex_markdown_to_html so option names stay as literal --
+- Man-html: Replace UTF-8 en-dash (U+2013) with "--" in rendered text and definition list HTML blocks so options like --standalone display correctly even when smart typography slips through
+
+## [0.1.87] - 2026-03-02
+
+### Changed
+
+- Formula/apex.rb: version 0.1.86, update macOS universal tarball sha256
+
+### Fixed
+
+- Linux release build: add missing limits.h include for INT_MAX in apex_cli_terminal_width
+
+## [0.1.86] - 2026-03-02
+
+### Changed
+
+- Syntax highlighter chooses HTML or ANSI output based on destination format (--format html vs --format ansi for Shiki when output is terminal).
+- Apex_apply_syntax_highlighting() now takes a fifth parameter ansi_output (bool); pass false for HTML output, true for terminal/ANSI. All internal call sites updated; direct callers (e.g. Swift/SPM) must be updated.
+- Pygments highlighting now respects code-highlight-theme for both HTML and terminal/terminal256 output (maps to style=THEME).
+- Skylighting highlighting now respects code-highlight-theme for both HTML and ANSI terminal output (maps to --style THEME) and chooses --color-level=16/256 based on terminal vs terminal256.
+- Shiki highlighting now uses --theme THEME for both HTML and ANSI output and chooses --format html/ansi based on destination format.
+
+### New
+
+- Support --code-highlight shiki (and abbreviation sh) on the command line; uses the shiki CLI (@shikijs/cli) when available.
+- Support code-highlight: shiki and code-highlight: sh in metadata and config (front matter, meta-file, config.yml).
+- Add --list-themes CLI command to print available Pygments and Skylighting themes in columns and point to bundled Shiki themes.
+- Add -p/--paginate flag to page terminal/cli/terminal256 output through a user-configurable pager instead of writing directly to stdout.
+- Add paginate: true config option (and terminal.paginate) to enable pagination by default for terminal-style output while still allowing per-run overrides.
+
+### Improved
+
+- When Shiki exits with an error (e.g. language not specified and cannot be auto-detected), the code block is left as plain text instead of failing.
+
+### Fixed
+
+- Prevent segfault when external code highlighting is enabled without an explicit theme by initializing the code highlight theme option safely in the default configuration.
+
+## [0.1.85] - 2026-03-01
+
+### Changed
+
+- Makefile "make man" now generates man pages with the built apex binary (apex -t man) after running "make build"; pandoc and go-md2man are no longer required.
+- When both a TOC marker in code and a TOC marker in normal flow exist, only the first marker that is not inside <code> or <pre> is replaced with the generated table of contents.
+
+### New
+
+- Definition list terms may use Kramdown-style double colon :: as well as single : before the definition (e.g. "term:: definition").
+- Man page creation
+- Man-html without -s/--standalone outputs content snippet only (no wrapper, no nav); with -s outputs full document with sidebar and headline.
+- Man-html standalone: fixed left sidebar nav (TOC) for top-level sections only (NAME, SYNOPSIS, etc.), large headline from NAME section (command and description), document_title metadata used when present (e.g. APEX(1)).
+- Man-html standalone: custom CSS via --css/--style emitted as <link rel="stylesheet"> after embedded style; optional syntax highlighting via --code-highlight (pygmentize/skylighting) for code blocks in both snippet and standalone output.
+
+### Improved
+
+- CMake man page generation uses only apex_cli -t man when pre-generated pages are missing; removed duplicate/broken pandoc branch from merge and fixed invalid add_custom_command structure.
+- Man-html CSS: bold and headline color #a02172, links #2376b1, section headings #3f789b, sidebar background #f5f4f0 and border #e0ddd6.
+- CLI help: --css/--style describes use with man-html and -s; -s/--standalone describes man-html behavior (with -s: nav sidebar and full page; without -s: snippet only).
+
+### Fixed
+
+- Man pages generated from Markdown no longer convert option hyphens to em dashes; pandoc is invoked with -f markdown-smart so -- stays as literal ASCII double hyphen in roff output.
+- When both MMD inline abbreviations [>(abbr) expansion] and reference-style definitions [>abbr]: expansion appear in the same document, all abbreviations are now wrapped in <abbr> tags instead of only the reference-style ones (inline entries were previously overwritten in the list).
+- Definition list terms and definitions now render with correct content when using "**term**" followed by ":: definition" (previously produced empty <dt></dt><dd></dd>).
+- TOC markers ({{TOC}}, <!--TOC--> and variants) inside inline code (backticks) or inside code blocks (fenced or indented) are no longer expanded; they are left as literal text in the output.
+
+## [0.1.84] - 2026-02-27
+
+### Changed
+
+- Homebrew formula bumped to 0.1.83 with updated release checksum
+
+### New
+
+- --width flag wraps terminal and terminal256 output to a fixed column width for better integration with terminal file managers and previews
+- Terminal.width metadata and config option lets you set a default wrap width per document instead of relying only on CLI flags
+- Terminal.theme metadata and config option lets documents select a default terminal theme when using -t terminal or -t terminal256
+- Terminal theme list_marker style controls the color and emphasis of bullet and numbered list markers, defaulting to bold bright red when unset
+
+### Improved
+
+- Terminal themes can now mark headings, links, code spans, code blocks, blockquotes, and tables as bold with a bold: true flag in theme YAML instead of encoding bold in the color string
+- Span_classes mappings in terminal themes style inline span classes and attribute list classes consistently in terminal and terminal256 output
+
+## [0.1.83] - 2026-02-26
+
+### New
+
+- Span_classes theme mapping lets you define styles for inline span classes in terminal and terminal256 output
+
+### Improved
+
+- Terminal output now respects classes from inline attribute lists and bracketed spans (e.g. *emphasis*{.tag} and [text]{.tag}) including spans generated by plugins
+- Terminal theme YAML parsing is more robust so existing themes continue to work even when libyaml is unavailable
+
+## [0.1.82] - 2026-02-25
+
+### New
+
+- Add -t/--to output formats for html, json, json-filtered/ast-json/ast, markdown/md, mmd, commonmark/cmark, kramdown, gfm, terminal/cli, and terminal256.
+- Add terminal and terminal256 ANSI renderers with theme support and compact list and blockquote formatting for comfortable reading in a TTY.
+- Add --theme option and support for user theme files in ~/.config/apex/terminal/themes/NAME.theme with automatic default.theme selection when no explicit theme is given.
+- Add JSON and AST JSON output points before and after AST filters so external tools can consume either the raw or fully-processed document structure.
+
+### Improved
+
+- Improve MultiMarkdown output so TOC markers and escaping work correctly in -t mmd output without breaking MMD-specific syntax.
+- Improve terminal table rendering with Unicode box drawing, column alignment, captions, footer rules, and advanced colspan/rowspan handling that more closely matches advanced_tables behavior.
+- Terminal output now replaces :emoji: patterns with Unicode emoji when in GFM or unified mode, matching HTML behavior.
+
+### Fixed
+
+- Replace APEXLTLT placeholders with literal << in terminal table cells so escaped \<< renders correctly in CLI output.
+- Integrate external code highlighters (Pygments/Skylighting) into terminal output when --code-highlight is enabled, using readable pastel styles appropriate for 8-color and 256-color modes.
+- Compact list item spacing and blockquote rendering in terminal output so lists, quotes, and callouts read cleanly without stray blank lines.
+
+## [0.1.81] - 2026-02-23
+
+### New
+
+- Tests for extended syntax in indented and fenced code blocks, inline code, nested list lines with 4-space indent, and real indented code without list markers
+
+### Improved
+
+- Lines that start with a list marker after 4+ spaces or tab (nested or continuation list lines) are no longer treated as code blocks, so sup/sub and highlight are still applied there
+
+### Fixed
+
+- Superscript (^), subscript (~), underline (~text~), strikethrough (~~), and highlight (==) are no longer processed inside indented code blocks (4+ spaces or tab)
+- Extended syntax remains skipped inside fenced code blocks and inline code as before
+
+## [0.1.80] - 2026-02-18
+
+## [0.1.79] - 2026-02-18
+
+### New
+
+- IAL attributes for picture formats: webp, avif (emit <picture> with srcset), and video formats: webm, ogg, mp4, mov, m4v (emit <video> with <source> elements)
+- IAL attribute "auto" discovers format variants (2x, 3x, webp, avif, video) from filesystem and expands img to picture/video when files exist
+- Video URLs (mp4, webm, ogg, mov, m4v, ogv) automatically render as <video> elements instead of <img>
+- --[no-]image-captions and --[no-]title-captions-only CLI options to control figure/figcaption wrapping (title-captions-only: only add captions for images with title, alt-only images get no caption)
+- Image URL ending in .* (e.g. ![](image.*)) auto-discovers format variants from filesystem, same as auto attribute
+
+### Improved
+
+- Image attribute matching uses URL + alt to disambiguate same-src images when injecting IAL attributes
+- Picture elements with title or alt now get figure/figcaption wrapping when image captions are enabled
+
+### Fixed
+
+- TOC HTML structure now produces valid ul > li > ul nesting instead of invalid ul > ul (nested lists inside list items, never ul directly in ul)
+- Image captions from title: ![alt](url "Title caption") now correctly uses the title for figcaption instead of alt text (quoted titles were being stripped by preprocessor before cmark could parse them)
+- Wildcard image syntax (![](image.*)) now expands correctly when document contains image examples in code blocks (e.g. `![](image.*)` in documentation)
+- Truncated </figure> tag in picture output (memcpy used wrong length for "</figcaption></figure>")
+- Invalid HTML5: strip <p> wrapper around figure, video, and picture elements (p may only contain phrasing content)
+- Auto media expansion when replacement exceeds buffer (grow buffer instead of falling back to original img tag)
+
+## [0.1.78] - 2026-02-13
+
+### New
+
+- Test added to verify autolinking does not run inside indented code blocks.
+
+### Fixed
+
+- Autolink preprocessor now skips indented code blocks (4+ spaces or tab at line start) so URLs inside them are not converted to links.
+
+## [0.1.77] - 2026-02-09
+
+### Fixed
+
+- Package.swift missing filters
+- Package.swift missing ast_json
+
+## [0.1.76] - 2026-02-07
+
+### Changed
+
+- Formula/apex.rb: version 0.1.75 and release sha256.
+
+### New
+
+- Install filter by path: directory JSON can specify "path" (e.g. "contrib/code-includes.lua"); apex clones repo to temp, copies that file to filters/<basename>, then removes temp.
+- Code blocks with info string "inc" emit Pandoc keyvals [["inc","yes"]] in AST JSON so code-includes-style filters can replace block content with file contents.
+
+### Improved
+
+- Uninstall: when filter is not a directory, try filters/NAME.lua, NAME.py, NAME.rb and remove that file.
+- Filter resolution: --filter NAME now resolves to filters/NAME, filters/NAME.lua, filters/NAME.py, or filters/NAME.rb (regular files) before trying NAME as a directory.
+
+### Fixed
+
+- .lua filters are run via `lua "path"` so scripts without a shebang work.
+
+## [0.1.75] - 2026-02-06
+
+## [0.1.74] - 2026-02-06
+
+### New
+
+- AST filters (Pandoc-style JSON): run filters via --filter, --filters, and --lua-filter; apex_options gains ast_filter_commands, ast_filter_count, and ast_filter_strict
+- --install-filter to install AST filters from the apex-filters directory or from a Git URL
+- --no-strict-filters to skip failing filters and invalid filter JSON instead of aborting
+- Div blocks in Pandoc JSON are now parsed (attributes skipped, inner blocks appended to the document)
+- --list-filters lists installed filters (from the user filters directory) and available filters from the central apex-filters directory, with titles, authors, descriptions, and homepages for available entries
+- --uninstall-filter ID removes a filter by id (file or directory) after a confirmation prompt; cannot be combined with --install-filter
+
+### Improved
+
+- Silence C compiler narrowing warnings in the abbreviations extension so embedding Apex and building language bindings can run with cleaner, warning-free builds
+- Images already inside a <figure> (e.g. from ::: >figure) are no longer wrapped again in figure/figcaption by the image-caption logic
+- Redundant <p> around a single <img> inside <figure> is stripped so ::: >figure with "< ![Image](...)" yields <figure><img...></figure> without an inner paragraph
+- Pandoc JSON parser accepts block and inline objects with keys in any order (e.g. "c" before "t" as emitted by dkjson/Lua) so filter output from Lua and other generators parses correctly
+- Filter directory JSON parsing is shared for both "plugins" and "filters" arrays; apex_remote_fetch_filters_directory fetches and parses apex-filters.json for list/install
+- Apex_remote_print_plugins_filtered accepts an optional noun so the empty-list message says "filters" when listing filters instead of "plugins"
+
+### Fixed
+
+- Pandoc JSON parser now consumes the closing "c" array bracket after Header inlines so multi-block filter output (e.g. unwrap filter with heading plus figure) parses correctly and renders full output
+- Multi-block Pandoc JSON (e.g. Header + RawBlock) now parses to all blocks instead of only the first; parse_blocks_array returns the container and callers adopt its children then free it so the block chain is preserved
+
 ## [0.1.73] - 2026-02-04
 
 ### New
@@ -2354,8 +2741,31 @@ Based on [cmark-gfm](https://github.com/github/cmark-gfm) by GitHub
 
 Developed for [Marked](https://marked2app.com) by Brett Terpstra
 
-z
-
+[0.1.98]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.98
+[0.1.97]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.97
+[0.1.96]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.96
+[0.1.95]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.95
+[0.1.94]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.94
+[0.1.93]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.93
+[0.1.92]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.92
+[0.1.91]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.91
+[0.1.90]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.90
+[0.1.89]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.89
+[0.1.88]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.88
+[0.1.87]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.87
+[0.1.86]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.86
+[0.1.85]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.85
+[0.1.84]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.84
+[0.1.83]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.83
+[0.1.82]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.82
+[0.1.81]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.81
+[0.1.80]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.80
+[0.1.79]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.79
+[0.1.78]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.78
+[0.1.77]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.77
+[0.1.76]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.76
+[0.1.75]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.75
+[0.1.74]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.74
 [0.1.73]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.73
 [0.1.72]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.72
 [0.1.71]: https://github.com/ApexMarkdown/apex/releases/tag/v0.1.71

data/ext/apex_ext/apex_src/CMakeLists.txt

@@ -6,7 +6,7 @@ if(POLICY CMP0000)
 endif()
 set(CMAKE_POLICY_VERSION_MINIMUM 3.5 CACHE STRING "Minimum CMake policy version" FORCE)
 
-project(apex VERSION 0.1.73 LANGUAGES C)
+project(apex VERSION 0.1.98 LANGUAGES C)
 
 # Set C standard
 set(CMAKE_C_STANDARD 99)
@@ -108,6 +108,11 @@ endif()
 # Library source files
 set(APEX_LIB_SOURCES
     src/apex.c
+    src/ast_json.c
+    src/ast_markdown.c
+    src/ast_terminal.c
+    src/ast_man.c
+    src/filters_ast.c
     src/plugins_env.c
     src/plugins.c
     src/plugins_remote.c
@@ -334,6 +339,7 @@ add_executable(apex_test_runner
     tests/test_helpers.c
     tests/test_runner.c
     tests/test_basic.c
+    tests/test_cmark_callback.c
     tests/test_metadata.c
     tests/test_links.c
     tests/test_tables.c
@@ -347,8 +353,9 @@ add_executable(apex_test_runner
 target_link_libraries(apex_test_runner apex_static)
 target_compile_definitions(apex_test_runner PRIVATE TEST_FIXTURES_DIR="${CMAKE_SOURCE_DIR}/tests/fixtures/includes")
 
-# Add test
+# Add test (run from source dir so fixture paths like tests/fixtures/... resolve)
 add_test(NAME apex_tests COMMAND apex_test_runner)
+set_tests_properties(apex_tests PROPERTIES WORKING_DIRECTORY ${CMAKE_SOURCE_DIR})
 
 # Documentation
 option(BUILD_DOCS "Build documentation" OFF)
@@ -402,24 +409,14 @@ foreach(MAN_PAGE_SPEC ${MAN_PAGES})
         )
         set(MAN_AVAILABLE TRUE)
     else()
-        # Try to generate man page from Markdown source
-        if(PANDOC_EXECUTABLE)
-            add_custom_command(
-                OUTPUT ${MAN_OUTPUT}
-                COMMAND ${PANDOC_EXECUTABLE} -s -t man -o ${MAN_OUTPUT} ${MAN_SOURCE}
-                DEPENDS ${MAN_SOURCE}
-                COMMENT "Generating man page ${MAN_NAME}.${MAN_SECTION} from Markdown using pandoc"
-            )
-            set(MAN_AVAILABLE TRUE)
-        elseif(GO_MD2MAN_EXECUTABLE)
-            add_custom_command(
-                OUTPUT ${MAN_OUTPUT}
-                COMMAND ${GO_MD2MAN_EXECUTABLE} -in=${MAN_SOURCE} -out=${MAN_OUTPUT}
-                DEPENDS ${MAN_SOURCE}
-                COMMENT "Generating man page ${MAN_NAME}.${MAN_SECTION} from Markdown using go-md2man"
-            )
-            set(MAN_AVAILABLE TRUE)
-        endif()
+        # Generate with apex -t man (roff); we build apex_cli in this tree
+        add_custom_command(
+            OUTPUT ${MAN_OUTPUT}
+            COMMAND $<TARGET_FILE:apex_cli> -t man ${MAN_SOURCE} > ${MAN_OUTPUT}
+            DEPENDS ${MAN_SOURCE} apex_cli
+            COMMENT "Generating man page ${MAN_NAME}.${MAN_SECTION} from Markdown using apex -t man"
+        )
+        set(MAN_AVAILABLE TRUE)
     endif()
 
     # Install man page
@@ -433,18 +430,33 @@ endforeach()
 
 # Create a target that depends on all man pages
 if(MAN_AVAILABLE)
-    if(PANDOC_EXECUTABLE OR GO_MD2MAN_EXECUTABLE)
-        add_custom_target(man_pages ALL DEPENDS ${MAN_OUTPUTS})
-        message(STATUS "Man pages: Will be generated from Markdown sources")
-    else()
-        add_custom_target(man_pages_copy ALL DEPENDS ${MAN_OUTPUTS})
-        message(STATUS "Man pages: Using pre-generated man pages")
-    endif()
+    add_custom_target(man_pages ALL DEPENDS ${MAN_OUTPUTS})
+    message(STATUS "Man pages: Will be built from Markdown (apex -t man) or copied if pre-generated")
 else()
-    message(WARNING "Pre-generated man pages not found and neither pandoc nor go-md2man available.")
-    message(STATUS "  Man pages will not be installed. Generate them with 'make man' before building.")
+    message(WARNING "Man page sources or pre-generated pages not found.")
+    message(STATUS "  Man pages will not be installed.")
 endif()
 
+add_custom_target(swift_package_check
+  COMMAND ${CMAKE_COMMAND} -E env
+          SWIFT_PACKAGE_PATH=${CMAKE_SOURCE_DIR}
+          swift build
+  WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+  COMMENT "Building Swift package (debug)"
+)
+
+add_custom_target(swift_package_check_release
+  COMMAND ${CMAKE_COMMAND} -E env
+          SWIFT_PACKAGE_PATH=${CMAKE_SOURCE_DIR}
+          swift build -c release
+  WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
+  COMMENT "Building Swift package (release)"
+)
+
+add_custom_target(all_checks
+  DEPENDS apex_test_runner swift_package_check swift_package_check_release
+)
+
 # Print configuration
 message(STATUS "Apex ${PROJECT_VERSION}")
 message(STATUS "Build type: ${CMAKE_BUILD_TYPE}")

data/ext/apex_ext/apex_src/Formula/apex.rb

@@ -7,14 +7,14 @@
 class Apex < Formula
   desc "Unified Markdown processor supporting CommonMark, GFM, MultiMarkdown, and Kramdown"
   homepage "https://github.com/ApexMarkdown/apex"
-  version "0.1.73"
+  version "0.1.97"
   license "MIT"
 
   depends_on "libyaml"
 
   on_macos do
     url "https://github.com/ApexMarkdown/apex/releases/download/v#{version}/apex-#{version}-macos-universal.tar.gz"
-    sha256 "cdcdc77d43cff76cd0bca0936f482f4053c0970f65e4165666251ad7e768ade4"
+    sha256 "4ca3d97305e94275397dfe9e3803feef7fb98fcbb0e472f56fcc0daff65f0f07"
   end
 
   def install

data/ext/apex_ext/apex_src/Package.swift

@@ -13,6 +13,10 @@ let package = Package(
         .library(
             name: "Apex",
             targets: ["Apex"]
+        ),
+        .library(
+            name: "ApexC",
+            targets: ["ApexC"]
         )
     ],
     targets: [
@@ -85,6 +89,11 @@ let package = Package(
             path: ".",
             sources: [
                 "src/apex.c",
+                "src/ast_markdown.c",
+                "src/ast_terminal.c",
+                "src/ast_man.c",
+                "src/filters_ast.c",
+                "src/ast_json.c",
                 "src/plugins_env.c",
                 "src/plugins.c",
                 "src/plugins_remote.c",