RubyGems - apex-ruby - Versions diffs - 1.0.6 → 1.0.8 - Mend

apex-ruby 1.0.6 → 1.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (85) hide show

checksums.yaml +4 -4
data/ext/apex_ext/apex_ext.c +6 -0
data/ext/apex_ext/apex_src/AGENTS.md +41 -0
data/ext/apex_ext/apex_src/CHANGELOG.md +412 -2
data/ext/apex_ext/apex_src/CMakeLists.txt +41 -29
data/ext/apex_ext/apex_src/Formula/apex.rb +2 -2
data/ext/apex_ext/apex_src/Package.swift +9 -0
data/ext/apex_ext/apex_src/README.md +31 -9
data/ext/apex_ext/apex_src/ROADMAP.md +5 -0
data/ext/apex_ext/apex_src/VERSION +1 -1
data/ext/apex_ext/apex_src/cli/main.c +1125 -13
data/ext/apex_ext/apex_src/docs/index.md +459 -0
data/ext/apex_ext/apex_src/include/apex/apex.h +67 -5
data/ext/apex_ext/apex_src/include/apex/ast_man.h +20 -0
data/ext/apex_ext/apex_src/include/apex/ast_markdown.h +39 -0
data/ext/apex_ext/apex_src/include/apex/ast_terminal.h +40 -0
data/ext/apex_ext/apex_src/include/apex/module.modulemap +1 -1
data/ext/apex_ext/apex_src/man/apex-config.5 +333 -258
data/ext/apex_ext/apex_src/man/apex-config.5.md +3 -1
data/ext/apex_ext/apex_src/man/apex-plugins.7 +401 -316
data/ext/apex_ext/apex_src/man/apex.1 +663 -620
data/ext/apex_ext/apex_src/man/apex.1.html +703 -0
data/ext/apex_ext/apex_src/man/apex.1.md +160 -90
data/ext/apex_ext/apex_src/objc/Apex.swift +6 -0
data/ext/apex_ext/apex_src/objc/NSString+Apex.h +12 -0
data/ext/apex_ext/apex_src/objc/NSString+Apex.m +9 -0
data/ext/apex_ext/apex_src/pages/index.md +459 -0
data/ext/apex_ext/apex_src/src/_README.md +4 -4
data/ext/apex_ext/apex_src/src/apex.c +702 -44
data/ext/apex_ext/apex_src/src/ast_json.c +1130 -0
data/ext/apex_ext/apex_src/src/ast_json.h +46 -0
data/ext/apex_ext/apex_src/src/ast_man.c +948 -0
data/ext/apex_ext/apex_src/src/ast_markdown.c +409 -0
data/ext/apex_ext/apex_src/src/ast_terminal.c +2516 -0
data/ext/apex_ext/apex_src/src/extensions/abbreviations.c +8 -5
data/ext/apex_ext/apex_src/src/extensions/definition_list.c +491 -1514
data/ext/apex_ext/apex_src/src/extensions/definition_list.h +8 -15
data/ext/apex_ext/apex_src/src/extensions/emoji.c +207 -0
data/ext/apex_ext/apex_src/src/extensions/emoji.h +14 -0
data/ext/apex_ext/apex_src/src/extensions/header_ids.c +178 -71
data/ext/apex_ext/apex_src/src/extensions/highlight.c +37 -5
data/ext/apex_ext/apex_src/src/extensions/ial.c +416 -47
data/ext/apex_ext/apex_src/src/extensions/includes.c +241 -10
data/ext/apex_ext/apex_src/src/extensions/includes.h +1 -0
data/ext/apex_ext/apex_src/src/extensions/metadata.c +166 -3
data/ext/apex_ext/apex_src/src/extensions/metadata.h +7 -0
data/ext/apex_ext/apex_src/src/extensions/sup_sub.c +34 -3
data/ext/apex_ext/apex_src/src/extensions/syntax_highlight.c +55 -10
data/ext/apex_ext/apex_src/src/extensions/syntax_highlight.h +7 -4
data/ext/apex_ext/apex_src/src/extensions/table_html_postprocess.c +84 -52
data/ext/apex_ext/apex_src/src/extensions/toc.c +133 -19
data/ext/apex_ext/apex_src/src/filters_ast.c +194 -0
data/ext/apex_ext/apex_src/src/filters_ast.h +36 -0
data/ext/apex_ext/apex_src/src/html_renderer.c +1265 -35
data/ext/apex_ext/apex_src/src/html_renderer.h +21 -0
data/ext/apex_ext/apex_src/src/plugins_remote.c +40 -14
data/ext/apex_ext/apex_src/tests/CMakeLists.txt +1 -0
data/ext/apex_ext/apex_src/tests/README.md +11 -5
data/ext/apex_ext/apex_src/tests/fixtures/comprehensive_test.md +13 -2
data/ext/apex_ext/apex_src/tests/fixtures/filters/filter_output_with_rawblock.json +1 -0
data/ext/apex_ext/apex_src/tests/fixtures/filters/unwrap.md +7 -0
data/ext/apex_ext/apex_src/tests/fixtures/images/auto-wildcard.md +8 -0
data/ext/apex_ext/apex_src/tests/fixtures/images/img/app-pass-1-profile-menu.avif +0 -0
data/ext/apex_ext/apex_src/tests/fixtures/images/img/app-pass-1-profile-menu.jpg +0 -0
data/ext/apex_ext/apex_src/tests/fixtures/images/img/app-pass-1-profile-menu.webp +0 -0
data/ext/apex_ext/apex_src/tests/fixtures/images/img/app-pass-1-profile-menu@2x.avif +0 -0
data/ext/apex_ext/apex_src/tests/fixtures/images/img/app-pass-1-profile-menu@2x.jpg +0 -0
data/ext/apex_ext/apex_src/tests/fixtures/images/img/app-pass-1-profile-menu@2x.webp +0 -0
data/ext/apex_ext/apex_src/tests/fixtures/images/media_formats_test.md +63 -0
data/ext/apex_ext/apex_src/tests/fixtures/includes/data-semi.csv +3 -0
data/ext/apex_ext/apex_src/tests/fixtures/includes/with space.txt +1 -0
data/ext/apex_ext/apex_src/tests/fixtures/tables/inline_tables_test.md +4 -1
data/ext/apex_ext/apex_src/tests/paginate_cli_test.sh +64 -0
data/ext/apex_ext/apex_src/tests/terminal_width_test.sh +29 -0
data/ext/apex_ext/apex_src/tests/test-swift-package.sh +14 -0
data/ext/apex_ext/apex_src/tests/test_cmark_callback.c +189 -0
data/ext/apex_ext/apex_src/tests/test_extensions.c +374 -0
data/ext/apex_ext/apex_src/tests/test_metadata.c +68 -0
data/ext/apex_ext/apex_src/tests/test_output.c +291 -2
data/ext/apex_ext/apex_src/tests/test_runner.c +10 -0
data/ext/apex_ext/apex_src/tests/test_syntax_highlight.c +1 -1
data/ext/apex_ext/apex_src/tests/test_tables.c +17 -1
data/lib/apex/version.rb +1 -1
metadata +32 -2
data/ext/apex_ext/apex_src/docs/FUTURE_FEATURES.md +0 -456

data/ext/apex_ext/apex_src/man/apex.1.md CHANGED Viewed

@@ -41,33 +41,67 @@ compatibility.
 **-s**, **--standalone**
 : Generate complete HTML document with `<html>`, `<head>`,
-and `<body>` tags.
+    and `<body>` tags.
 **--style** *FILE*, **--css** *FILE*
 : Link to CSS file(s) in document head (requires
-**--standalone**). Can be used multiple times or accept
-comma-separated list (e.g., `--css style.css --css syntax.css`
-or `--css style.css,syntax.css`). Overrides CSS metadata if
-specified.
+    **--standalone**). Can be used multiple times or accept
+    comma-separated list (e.g., `--css style.css --css syntax.css`
+    or `--css style.css,syntax.css`). Overrides CSS metadata if
+    specified.
 **--embed-css**
 :   When used with **--css FILE**, read the CSS file(s) and embed
-their contents into `<style>` tags in the document head instead
-of emitting `<link rel="stylesheet">` tags. All specified
-stylesheets are embedded.
+    their contents into `<style>` tags in the document head instead
+    of emitting `<link rel="stylesheet">` tags. All specified
+    stylesheets are embedded.
+**--width** *N*
+: When using **--to terminal** or **--to terminal256**, hard-wrap ANSI-colored
+    output at *N* visible columns. This is especially useful in file manager
+    preview panes (such as **lf** or **yazi**) where Apex cannot detect the pane
+    width automatically. ANSI escape sequences are preserved and are not counted
+    toward the column limit. If not specified, Apex does not add extra wrapping
+    and the terminal itself controls line wrapping.
+**-p**, **--paginate**
+: When using **--to terminal**, **--to cli**, or **--to terminal256**, send
+the rendered terminal output through a pager instead of writing directly to
+stdout. The pager command is chosen in this order:
+- If `$APEX_PAGER` is set and non-empty, Apex uses its value as the pager.
+- Otherwise, if `$PAGER` is set and non-empty, Apex uses that.
+- Otherwise, Apex falls back to `less -R`.
+Pagination is ignored when the output format is not a terminal format or when
+`-o/--output` is used to write to a file. You can also enable pagination via
+metadata or config by setting `paginate: true`.
 **--code-highlight** *TOOL*
 : Use external tool for syntax highlighting of code blocks.
-*TOOL* must be **pygments** (or **p**, **pyg**) or **skylighting**
-(or **s**, **sky**). Code blocks are sent to the external tool
-with their language specifier (if present) or with
-auto-detection enabled. The highlighted HTML output replaces the
-original code block in the document.
+*TOOL* must be **pygments** (or **p**, **pyg**), **skylighting**
+(or **s**, **sky**), or **shiki** (or **sh**). Code blocks are sent
+to the external tool with their language specifier (if present) or
+with auto-detection enabled. Output format is HTML or ANSI
+depending on destination (e.g. **--to terminal**). Shiki requires
+a language when it cannot auto-detect; on error, the block is
+left as plain text.
+**--code-highlight-theme** *THEME*
+: Theme/style name for external syntax highlighters.
+When using **pygments**, this maps to the Pygments style name in
+both HTML and terminal output (e.g. `style=THEME`). When using
+**skylighting**, it maps to the Skylighting style name via
+`--style THEME` for both HTML and ANSI terminal output. When using
+**shiki**, it maps to the Shiki theme via `--theme THEME` for
+both HTML and terminal/ANSI output. See **--list-themes** for
+available theme names for each tool.
 **--code-line-numbers**
 : Include line numbers in syntax-highlighted code blocks.
 Requires **--code-highlight**. When used with Pygments, adds
 `linenos=1` option. When used with Skylighting, adds `-n` flag.
+Shiki does not support line numbers in CLI mode.
 **--highlight-language-only**
 : Only apply syntax highlighting to code blocks that have a language
@@ -103,6 +137,19 @@ output. When enabled, adds:
 This enhances screen reader support and makes the HTML
 output more accessible. Default: disabled.
+**-t** *FORMAT*, **--to** *FORMAT*
+: Output format. One of:
+- **html** (default) - Rendered HTML
+- **json**, **json-filtered**, **ast-json**, **ast** - JSON output (before or after filters)
+- **markdown**, **md**, **mmd**, **commonmark**, **cmark**, **kramdown**, **gfm** - Markdown variants
+- **terminal**, **cli**, **terminal256** - ANSI-colored output for TTYs and terminal emulators
+- **man** - Man page roff source (.TH, .SH, etc.)
+- **man-html** - Styled HTML man page (use **--standalone** for full page with nav sidebar)
+When using a terminal format, Apex emits ANSI-colored output suitable for TTYs and
+terminal emulators.
 ## Feature Flags
 **--accept**
@@ -113,16 +160,18 @@ output more accessible. Default: disabled.
 **--code-highlight** *TOOL*
 : Use external tool for syntax highlighting of code blocks.
-*TOOL* must be **pygments** (or abbreviations **p**, **pyg**) or
-**skylighting** (or abbreviations **s**, **sky**). Code blocks
-are sent to the external tool with their language specifier (if
-present) or with auto-detection enabled. The highlighted HTML
-output replaces the original code block in the document.
+*TOOL* must be **pygments** (or **p**, **pyg**), **skylighting**
+(or **s**, **sky**), or **shiki** (or **sh**). Code blocks are sent
+to the external tool with their language specifier (if present) or
+with auto-detection enabled. Output format is HTML or ANSI
+depending on destination. Shiki falls back to plain text when
+language cannot be determined.
 **--code-line-numbers**
 : Include line numbers in syntax-highlighted code blocks.
 Requires **--code-highlight**. When used with Pygments, adds
 `linenos=1` option. When used with Skylighting, adds `-n` flag.
+Shiki does not support line numbers in CLI mode.
 **--highlight-language-only**
 : Only apply syntax highlighting to code blocks that have a language
@@ -130,11 +179,10 @@ specified (via ` ```language ` or IAL). Code blocks without a language
 will be left unhighlighted. Requires **--code-highlight**.
 **--includes**, **--no-includes**
-: Enable or disable file inclusion. Enabled by default in
-unified mode.
+: Enable or disable file inclusion. Enabled by default in unified mode.
 **--transforms**, **--no-transforms**
-:: Enable or disable metadata variable transforms
+: Enable or disable metadata variable transforms
 (`[%key:transform]`). When enabled, metadata values can be
 transformed (case conversion, string manipulation, regex
 replacement, date formatting, etc.) when inserted into the
@@ -231,35 +279,35 @@ first item).
 **--per-cell-alignment**, **--no-per-cell-alignment**
 : Enable per-cell alignment markers in tables. When enabled, cells
-starting with a colon (`:`) are left-aligned, ending with a colon
-(`:`) are right-aligned, or both (`:content:`) are center-aligned.
-The colons are stripped from the output and replaced with
-`style="text-align: ..."` attributes. Default: enabled in unified
-mode, disabled in commonmark, gfm, mmd, and kramdown modes.
+    starting with a colon (`:`) are left-aligned, ending with a colon
+    (`:`) are right-aligned, or both (`:content:`) are center-aligned.
+    The colons are stripped from the output and replaced with
+    `style="text-align: ..."` attributes. Default: enabled in unified
+    mode, disabled in commonmark, gfm, mmd, and kramdown modes.
 **--captions** *POSITION*
 : Table caption position: **above** or **below** (default:
-**below**). Controls where table captions appear relative to
-the table.
+    **below**). Controls where table captions appear relative to
+    the table.
 ## HTML and Links
 **--unsafe**, **--no-unsafe**
 : Allow raw HTML in output. Default: true for
-unified/mmd/kramdown modes, false for commonmark/gfm modes.
+    unified/mmd/kramdown modes, false for commonmark/gfm modes.
 **--autolink**, **--no-autolink**
 : Enable autolinking of URLs and email addresses. Default:
-enabled in GFM, MultiMarkdown, Kramdown, and unified modes;
-disabled in CommonMark mode.
+    enabled in GFM, MultiMarkdown, Kramdown, and unified modes;
+    disabled in CommonMark mode.
 **--obfuscate-emails**
 : Obfuscate email links and text using HTML entities
-(hex-encoded).
+    (hex-encoded).
 **--wikilink-space** *MODE*
-:: Control how spaces in wiki link page names are handled in
-the generated URL. **MODE** must be one of:
+: Control how spaces in wiki link page names are handled in
+    the generated URL. **MODE** must be one of:
 `dash` - Convert spaces to dashes: `[[Home Page]]` → `href="Home-Page"`
@@ -272,7 +320,10 @@ the generated URL. **MODE** must be one of:
     Default: `dash`.
 **--wikilink-extension** *EXT*
-::   Add a file extension to wiki link URLs. The extension is automatically prefixed with a dot if not provided. For example, `--wikilink-extension html` creates `href="Page.html"` and `--wikilink-extension .html` also creates `href="Page.html"`.
+:   Add a file extension to wiki link URLs. The extension is automatically
+    prefixed with a dot if not provided. For example, `--wikilink-extension html`
+    creates `href="Page.html"` and `--wikilink-extension .html` also creates
+    `href="Page.html"`.
 **--wikilink-sanitize**, **--no-wikilink-sanitize**
 :   Sanitize wiki link URLs for cleaner, more compatible links. When enabled:
@@ -331,7 +382,7 @@ relative paths.
 :   Enable or disable GFM-style strikethrough processing (`~~text~~`). When enabled, `~~text~~` renders as `<del>text</del>`. Default: enabled in GFM and unified modes; disabled in commonmark, mmd, and kramdown modes.
 **--divs**, **--no-divs**
-:   Enable or disable Pandoc fenced divs syntax (`::::: {#id .class} ... :::::`). Fenced divs allow you to create HTML block elements with attributes using a special fence syntax. By default, fenced divs create `<div>` elements, but you can specify different block types using the `>blocktype` syntax (e.g., `::: >aside {.sidebar} ... :::` creates an `<aside>` element instead). Opening fences must have at least 3 colons and attributes; closing fences need at least 3 colons. Fenced divs can be nested, including different block types. Default: enabled in unified mode only.
+:   Enable or disable Pandoc fenced divs syntax (`:::: {#id .class} ... :::::`). Fenced divs allow you to create HTML block elements with attributes using a special fence syntax. By default, fenced divs create `<div>` elements, but you can specify different block types using the `>blocktype` syntax (e.g., `:: >aside {.sidebar} ... :::` creates an `<aside>` element instead). Opening fences must have at least 3 colons and attributes; closing fences need at least 3 colons. Fenced divs can be nested, including different block types. Default: enabled in unified mode only.
 **--spans**, **--no-spans**
 :   Enable or disable Pandoc-style bracketed spans syntax (`[text]{#id .class key="val"}`). Bracketed spans allow you to create HTML `<span>` elements with attributes. The text inside the brackets is processed as markdown. If the bracketed text matches a reference link definition, it will be treated as a link instead of a span. Default: enabled in unified mode only.
@@ -379,22 +430,20 @@ found.
 **--indices**
 : Enable index processing. Supports both mmark and TextIndex
-syntax. Default: enabled in MultiMarkdown and unified modes.
+    syntax. Default: enabled in MultiMarkdown and unified modes.
 **--no-indices**
 :   Disable index processing.
 **--no-index**
 : Suppress index generation at the end of the document.
-Index markers are still created in the document, but the
-index section is not generated.
+    Index markers are still created in the document, but the
+    index section is not generated.
 Index syntax is supported in MultiMarkdown and unified
 modes:
-- **mmark syntax**: `(!item)`, `(!item, subitem)`, `(!!item,
-  subitem)` for primary entries
+- **mmark syntax**: `(!item)`, `(!item, subitem)`, `(!!item, subitem)` for primary entries
 - **TextIndex syntax**: `word{^}`, `[term]{^}`, `{^params}`
@@ -403,25 +452,62 @@ document or at the `<!--INDEX-->` marker if present. Entries
 are sorted alphabetically and can be grouped by first
 letter.
+## AST Filters
+**--filter** *NAME*
+: Run a single AST filter from the user filters directory
+    (`$XDG_CONFIG_HOME/apex/filters` or `~/.config/apex/filters`). *NAME* is
+    the basename of an executable that reads Pandoc JSON from stdin and writes
+    Pandoc JSON to stdout.
+**--filters**
+: Run all executable files in the user filters directory, in sorted
+    filename order. Directory filters run first if **--filter** is also used.
+**--lua-filter** *FILE*
+: Run a Lua script as an AST filter. Apex invokes the system **lua**
+    interpreter with *FILE*. The script reads a Pandoc JSON document from
+    stdin and must write a Pandoc JSON document to stdout. A JSON library
+    (e.g. dkjson) is required; see the Filters documentation for details.
+**--no-strict-filters**
+: Do not abort when a filter fails or returns invalid JSON; log a
+    warning and continue with the previous AST. Default: abort on error.
+**--list-filters**
+: List installed filters and available filters from the central
+    apex-filters directory. Shows filter IDs; available filters show
+    title, author, description, and homepage.
+**--install-filter** *ID-or-URL*
+: Install an AST filter into the user filters directory. *ID-or-URL*
+    may be a filter ID from the central apex-filters directory (e.g.
+    **unwrap**) or a Git URL / GitHub shorthand. When installing from a URL,
+    Apex may prompt for confirmation.
+**--uninstall-filter** *ID*
+: Uninstall a filter by ID. Removes the filter (file or directory)
+    from the user filters directory. Apex prompts for confirmation.
 ## Plugins
 **--plugins**, **--no-plugins**
 : Enable or disable external/plugin processing. Plugins
-extend Apex with custom processing capabilities.
+    extend Apex with custom processing capabilities.
 **--list-plugins**
 : List installed plugins and available plugins from the
-remote directory. Shows both locally installed plugins and
-plugins available for installation from the Apex plugin
-directory.
+    remote directory. Shows both locally installed plugins and
+    plugins available for installation from the Apex plugin
+    directory.
 **--install-plugin** *ID*
 :   Install a plugin by ID from the remote directory, or by Git URL/GitHub shorthand (user/repo). Plugins are installed to `$XDG_CONFIG_HOME/apex/plugins` (or `~/.config/apex/plugins` when `XDG_CONFIG_HOME` is not set). When installing from a URL or GitHub shorthand, Apex will prompt for confirmation since plugins execute unverified code.
 **--uninstall-plugin** *ID*
 : Uninstall a plugin by ID. Removes the plugin directory
-from the plugins folder. Apex will prompt for confirmation
-before removing the plugin.
+    from the plugins folder. Apex will prompt for confirmation
+    before removing the plugin.
 ## General Options
@@ -438,16 +524,15 @@ before removing the plugin.
 **--combine** *files...*
 : Concatenate one or more Markdown files into a single
-Markdown stream, expanding all supported include syntaxes.
-When a `SUMMARY.md` file is provided, Apex treats it as a
-GitBook-style index and combines the linked files in order.
-Output is raw Markdown suitable for piping back into Apex.
+    Markdown stream, expanding all supported include syntaxes.
+    When a `SUMMARY.md` file is provided, Apex treats it as a
+    GitBook-style index and combines the linked files in order.
+    Output is raw Markdown suitable for piping back into Apex.
 **--mmd-merge** *index files...*
-:   Merge files from one or more MultiMarkdown `mmd_merge`-style index files into a single Markdown stream. Each non-empty, non-comment line in an index file specifies a document to include. Lines whose first non-whitespace character is `#` are treated as comments and ignored. Indentation (tabs or groups of four spaces) before the filename increases the header level of the included document (each indent level shifts all Markdown headings in that file down one level). Output is raw Markdown suitable for piping into Apex, for example:
+:   Merge files from one or more MultiMarkdown `mmd_merge`-style index files into a  single Markdown stream. Each non-empty, non-comment line in an index file specifies a document to include. Lines whose first non-whitespace character is `#` are treated as comments and ignored. Indentation (tabs or groups of four spaces) before the filename increases the header level of the included document (each indent level shifts all Markdown headings in that file down one level). Output is raw Markdown suitable for piping into Apex, for example:
-apex --mmd-merge index.txt | apex --mode mmd --standalone -o
-book.html
+    apex --mmd-merge index.txt | apex --mode mmd --standalone -o book.html
 # EXAMPLES
@@ -493,20 +578,20 @@ Process from stdin:
 **commonmark**
 : Pure CommonMark specification. Minimal features, maximum
-compatibility.
+    compatibility.
 **gfm**
 : GitHub Flavored Markdown. Includes tables, strikethrough,
-task lists, autolinks, and more.
+    task lists, autolinks, and more.
 **mmd**, **multimarkdown**
 : MultiMarkdown compatibility. Includes metadata, definition
-lists, footnotes, and more.
+    lists, footnotes, and more.
 **kramdown**
 : Kramdown compatibility. Includes relaxed tables, IAL
-(Inline Attribute Lists) for adding HTML attributes to
-elements, and more.
+    (Inline Attribute Lists) for adding HTML attributes to
+    elements, and more.
 **unified** (default)
 :   All features enabled. Combines features from all modes.
@@ -567,59 +652,44 @@ Apex supports a wide range of Markdown extensions:
 - **Strikethrough**: GFM-style `~~text~~` (controlled by **--strikethrough**)
 - **Footnotes**: Reference-style footnotes
 - **Math**: Inline (`$...$`) and display (`$$...$$`) math
   with LaTeX
 - **Wiki Links**: `[[Page]]`, `[[Page|Display]]`,
   `[[Page#Section]]`
 - **Critic Markup**: All 5 types ({++add++}, {--del--},
   {~~sub~~}, {==mark==}, {>>comment<<})
 - **Smart Typography**: Smart quotes, dashes, ellipsis
 - **Definition Lists**: MultiMarkdown-style definition lists
 - **Task Lists**: GFM-style task lists
 - **Metadata**: YAML front matter, MultiMarkdown metadata,
   Pandoc title blocks
 - **Metadata Transforms**: Transform metadata values with
   `[%key:transform]` syntax (case conversion, string
   manipulation, regex replacement, date formatting, etc.)
 - **Metadata Control of Options**: Control command-line
   options via metadata for per-document configuration
 - **Header IDs**: Automatic or manual header IDs with
   multiple format options
 - **Relaxed Tables**: Support for tables without separator
-rows (Kramdown-style). Enabled by default in unified and
-Kramdown modes.
+  rows (Kramdown-style). Enabled by default in unified and
+  Kramdown modes.
 - **Per-Cell Alignment**: Support for alignment markers using
-colons at the start and/or end of table cells. Enabled by default
-in unified mode only.
-  rows (Kramdown-style)
+  colons at the start and/or end of table cells. Enabled by default
+  in unified mode only.
 - **Inline Tables from CSV/TSV**: Convert inline CSV/TSV
   text to tables using ```table fences or `<!--TABLE-->`
   markers
+- **Superscript/Subscript**: MultiMarkdown-style superscript (`^text`) and
+  subscript (`~text~` within words) syntax. Subscript uses paired tildes within
+  word boundaries (e.g., `H~2~O`), while tildes at word boundaries create
+  underline
+- **Image Embedding**: Embed local images as base64 data URLs with `--embed-images` flag
+- **Inline Attribute Lists (IAL)**: Kramdown-style syntax for adding HTML
+  attributes (IDs, classes, key-value pairs) to block-level and inline elements.
+  Supports Attribute List Definitions (ALDs) for reusable attribute sets. Available in
+  kramdown and unified modes. See
+  [Inline Attribute Lists](https://github.com/ttscoff/apex/wiki/Inline-Attribute-Lists)
+  for complete documentation
-**Superscript/Subscript**: MultiMarkdown-style superscript (`^text`) and subscript (`~text~` within words) syntax. Subscript uses paired tildes within word boundaries (e.g., `H~2~O`), while tildes at word boundaries create underline
-- **Image Embedding**: Embed local images as base64 data
-  URLs with `--embed-images` flag
-**Inline Attribute Lists (IAL)**: Kramdown-style syntax for adding HTML attributes (IDs, classes, key-value pairs) to block-level and inline elements. Supports Attribute List Definitions (ALDs) for reusable attribute sets. Available in kramdown and unified modes. See [Inline Attribute Lists](https://github.com/ttscoff/apex/wiki/Inline-Attribute-Lists) for complete documentation
 # SEE ALSO

data/ext/apex_ext/apex_src/objc/Apex.swift CHANGED Viewed

@@ -6,6 +6,7 @@
 import Foundation
 @_exported import ApexObjC
+@_exported import ApexC
 /// Apex processor mode
 /// Type-safe enum for processor modes
@@ -177,6 +178,11 @@ extension String {
 /// Static Apex converter
 /// Provides static methods for conversion
 public struct Apex {
+    /// Apex processor version string (e.g. "0.1.89")
+    public static var version: String {
+        return NSString.apexVersion() as String
+    }
     /**
      * Convert Markdown to HTML using Apex in unified mode
      */

data/ext/apex_ext/apex_src/objc/NSString+Apex.h CHANGED Viewed

@@ -4,6 +4,7 @@
  */
 #import <Foundation/Foundation.h>
+#import <apex/apex.h>
 NS_ASSUME_NONNULL_BEGIN
@@ -18,6 +19,17 @@ extern NSString * const ApexModeUnified;
 @interface NSString (Apex)
+/**
+ * Return Apex default C options structure.
+ * Exposed for Swift/plugin integrations that need low-level option flags.
+ */
++ (apex_options)defaultApexOptions;
+/**
+ * Apex processor version string (e.g. "0.1.89")
+ */
++ (NSString *)apexVersion;
 /**
  * Convert Markdown to HTML using Apex processor in unified mode
  * @param inputString The markdown text to convert

data/ext/apex_ext/apex_src/objc/NSString+Apex.m CHANGED Viewed

@@ -17,6 +17,15 @@ NSString *const ApexModeUnified = @"unified";
 @implementation NSString (Apex)
++ (apex_options)defaultApexOptions {
+  return apex_options_default();
+}
++ (NSString *)apexVersion {
+  const char *ver = apex_version_string();
+  return ver ? [NSString stringWithUTF8String:ver] : @"";
+}
 /**
  * Convert mode string to apex_mode_t enum
  */