apex-ruby 1.0.17 → 1.0.20

data/ext/apex_ext/apex_src/cli/main.c

@@ -3,6 +3,7 @@
  */
 
 #include "../include/apex/apex.h"
+#include "../include/apex/ast_terminal.h"
 #include "../src/extensions/metadata.h"
 #include "../src/extensions/includes.h"
 #include <stdio.h>
@@ -27,6 +28,7 @@ static char *read_file(const char *filename, size_t *len);
 typedef struct apex_cli_option_mask {
     bool mode;
     bool output_format;
+    bool toc_min_max;
     bool xhtml;
     bool strict_xhtml;
     bool theme_name;
@@ -57,8 +59,11 @@ typedef struct apex_cli_option_mask {
     bool unsafe;
     bool enable_sup_sub;
     bool enable_divs;
+    bool enable_py_callouts;
+    bool enable_quarto_callouts;
     bool enable_definition_lists;
     bool enable_spans;
+    bool enable_grid_tables;
     bool enable_autolink;
     bool enable_strikethrough;
     bool obfuscate_emails;
@@ -90,14 +95,37 @@ typedef struct apex_cli_option_mask {
     bool show_tooltips;
     bool indices;
     bool suppress_index;
+    bool concordance;
     bool stylesheet;
 } apex_cli_option_mask;
 
 static void apex_cli_restore_argv_options(apex_options *opts,
                                           const apex_options *snap,
                                           const apex_cli_option_mask *m) {
-    if (m->mode) opts->mode = snap->mode;
+    if (m->mode) {
+        opts->mode = snap->mode;
+        /* Global/project config may reset quarto defaults when mode is overridden via metadata. */
+        if (snap->mode == APEX_MODE_QUARTO) {
+            opts->enable_quarto_extensions = snap->enable_quarto_extensions;
+            opts->enable_quarto_raw = snap->enable_quarto_raw;
+            opts->enable_quarto_example_lists = snap->enable_quarto_example_lists;
+            opts->enable_quarto_line_blocks = snap->enable_quarto_line_blocks;
+            opts->enable_quarto_roman_lists = snap->enable_quarto_roman_lists;
+            opts->enable_quarto_code_attrs = snap->enable_quarto_code_attrs;
+            opts->enable_quarto_diagrams = snap->enable_quarto_diagrams;
+            opts->enable_quarto_shortcodes = snap->enable_quarto_shortcodes;
+            opts->enable_quarto_strict_lists = snap->enable_quarto_strict_lists;
+            opts->enable_quarto_xrefs = snap->enable_quarto_xrefs;
+            if (!m->enable_quarto_callouts) {
+                opts->enable_quarto_callouts = snap->enable_quarto_callouts;
+            }
+        }
+    }
     if (m->output_format) opts->output_format = snap->output_format;
+    if (m->toc_min_max) {
+        opts->toc_min = snap->toc_min;
+        opts->toc_max = snap->toc_max;
+    }
     if (m->xhtml) opts->xhtml = snap->xhtml;
     if (m->strict_xhtml) opts->strict_xhtml = snap->strict_xhtml;
     if (m->theme_name) opts->theme_name = snap->theme_name;
@@ -131,8 +159,11 @@ static void apex_cli_restore_argv_options(apex_options *opts,
     if (m->unsafe) opts->unsafe = snap->unsafe;
     if (m->enable_sup_sub) opts->enable_sup_sub = snap->enable_sup_sub;
     if (m->enable_divs) opts->enable_divs = snap->enable_divs;
+    if (m->enable_py_callouts) opts->enable_py_callouts = snap->enable_py_callouts;
+    if (m->enable_quarto_callouts) opts->enable_quarto_callouts = snap->enable_quarto_callouts;
     if (m->enable_definition_lists) opts->enable_definition_lists = snap->enable_definition_lists;
     if (m->enable_spans) opts->enable_spans = snap->enable_spans;
+    if (m->enable_grid_tables) opts->enable_grid_tables = snap->enable_grid_tables;
     if (m->enable_autolink) opts->enable_autolink = snap->enable_autolink;
     if (m->enable_strikethrough) opts->enable_strikethrough = snap->enable_strikethrough;
     if (m->obfuscate_emails) opts->obfuscate_emails = snap->obfuscate_emails;
@@ -185,30 +216,19 @@ static void apex_cli_restore_argv_options(apex_options *opts,
         opts->enable_leanpub_index_syntax = snap->enable_leanpub_index_syntax;
     }
     if (m->suppress_index) opts->suppress_index = snap->suppress_index;
+    if (m->concordance) {
+        opts->concordance_files = snap->concordance_files;
+        opts->enable_indices = snap->enable_indices;
+        opts->enable_textindex_syntax = snap->enable_textindex_syntax;
+    }
     if (m->stylesheet) {
         opts->stylesheet_paths = snap->stylesheet_paths;
         opts->stylesheet_count = snap->stylesheet_count;
     }
 }
 
-    /* Remote plugin directory helpers (from plugins_remote.c) */
-typedef struct apex_remote_plugin apex_remote_plugin;
-typedef struct apex_remote_plugin_list apex_remote_plugin_list;
-
-apex_remote_plugin_list *apex_remote_fetch_directory(const char *url);
-apex_remote_plugin_list *apex_remote_fetch_filters_directory(const char *url);
-void apex_remote_print_plugins(apex_remote_plugin_list *list);
-void apex_remote_print_plugins_filtered(apex_remote_plugin_list *list,
-                                        const char **installed_ids,
-                                        size_t installed_count,
-                                        const char *noun);
-apex_remote_plugin *apex_remote_find_plugin(apex_remote_plugin_list *list, const char *id);
-void apex_remote_free_plugins(apex_remote_plugin_list *list);
-const char *apex_remote_plugin_repo(apex_remote_plugin *p);
-
-/* Shared JSON helpers used for filters as well */
-char *apex_remote_fetch_json(const char *url);
-char *apex_remote_extract_string(const char *obj, const char *key);
+#include "plugins_remote.h"
+#include <apex/plugins.h>
 
 /* ------------------------------------------------------------------------- */
 /* Syntax highlighting theme listing                                         */
@@ -980,6 +1000,7 @@ static void print_usage(const char *program_name) {
     fprintf(stderr, "  --combine              Concatenate Markdown files (expanding includes) into a single Markdown stream\n");
     fprintf(stderr, "                         When a SUMMARY.md file is provided, treat it as a GitBook index and combine\n");
     fprintf(stderr, "                         the linked files in order. Output is raw Markdown suitable for piping back into Apex.\n");
+    fprintf(stderr, "  --concordance FILE      TextIndex concordance TSV file (can be used multiple times; enables indices)\n");
     fprintf(stderr, "  --csl FILE              Citation style file (CSL format)\n");
     fprintf(stderr, "  --css FILE, --style FILE  Link to CSS file(s) in document head. With HTML: requires -s/--standalone.\n");
     fprintf(stderr, "                         With -t man-html -s: include custom CSS in the man page. Can be used multiple times or comma-separated (e.g., --css style.css)\n");
@@ -1013,8 +1034,8 @@ static void print_usage(const char *program_name) {
     fprintf(stderr, "  --[no-]mixed-lists     Allow mixed list markers at same level (inherit type from first item)\n");
     fprintf(stderr, "  --mmd-merge            Merge files from one or more mmd_merge-style index files into a single Markdown stream\n");
     fprintf(stderr, "                         Index files list document parts line-by-line; indentation controls header level shifting.\n");
-    fprintf(stderr, "  -m, --mode MODE        Processor mode: commonmark, gfm, mmd, kramdown, unified (default)\n");
-    fprintf(stderr, "  -t, --to FORMAT        Output format: html (default), xhtml (alias for html + --xhtml), strict-xhtml (alias for html + --strict-xhtml), json (before filters), json-filtered/ast-json/ast (after filters), markdown/md, mmd, commonmark/cmark, kramdown, gfm, terminal/cli, terminal256, man, man-html\n");
+    fprintf(stderr, "  -m, --mode MODE        Processor mode: commonmark, gfm, mmd, kramdown, unified, quarto (default)\n");
+    fprintf(stderr, "  -t, --to FORMAT        Output format: html (default), xhtml (alias for html + --xhtml), strict-xhtml (alias for html + --strict-xhtml), json (before filters), json-filtered/ast-json/ast (after filters), markdown/md, mmd, commonmark/cmark, kramdown, gfm, terminal/cli, terminal256, man, man-html, toc, rtf\n");
     fprintf(stderr, "  --no-bibliography       Suppress bibliography output\n");
     fprintf(stderr, "  --no-footnotes         Disable footnote support\n");
     fprintf(stderr, "  --no-ids                Disable automatic header ID generation\n");
@@ -1027,6 +1048,8 @@ static void print_usage(const char *program_name) {
     fprintf(stderr, "  --no-smart             Disable smart typography\n");
     fprintf(stderr, "  --no-sup-sub           Disable superscript/subscript syntax\n");
     fprintf(stderr, "  --[no-]divs            Enable or disable Pandoc fenced divs (Unified mode only)\n");
+    fprintf(stderr, "  --[no-]py-callouts     Enable or disable Python-Markdown !!! callout syntax (default: disabled)\n");
+    fprintf(stderr, "  --[no-]quarto-callouts Enable or disable Quarto ::: {.callout-*} syntax (default: disabled)\n");
     fprintf(stderr, "  --[no-]one-line-definitions  Enable or disable one-line definition lists (Term :: Definition)\n");
     fprintf(stderr, "  --[no-]spans           Enable or disable bracketed spans [text]{IAL} (Pandoc-style, enabled by default in unified mode)\n");
     fprintf(stderr, "  --no-tables            Disable table support\n");
@@ -1043,6 +1066,7 @@ static void print_usage(const char *program_name) {
     fprintf(stderr, "  --strict-xhtml         Polyglot XHTML/XML for parsers (xmlns, application/xhtml+xml meta; implies --xhtml). Mutually exclusive with --xhtml. Same as -t strict-xhtml.\n");
     fprintf(stderr, "  --reject               Reject all Critic Markup changes (revert edits)\n");
     fprintf(stderr, "  --[no-]relaxed-tables  Enable or disable relaxed table parsing (no separator rows required)\n");
+    fprintf(stderr, "  --[no-]grid-tables     Enable or disable Pandoc grid table syntax (+---+ borders; disabled by default)\n");
     fprintf(stderr, "  --[no-]per-cell-alignment  Enable or disable per-cell alignment markers (colons at start/end of cells, enabled by default in unified mode)\n");
     fprintf(stderr, "  --script VALUE         Inject <script> tags before </body> (standalone) or at end of HTML (snippet).\n");
     fprintf(stderr, "                          VALUE can be a path, URL, or shorthand (mermaid, mathjax, katex). Can be used multiple times or as a comma-separated list.\n");
@@ -1051,6 +1075,7 @@ static void print_usage(const char *program_name) {
     fprintf(stderr, "  --[no-]sup-sub         Enable or disable MultiMarkdown-style superscript (^text^) and subscript (~text~) syntax\n");
     fprintf(stderr, "  --[no-]strikethrough   Enable or disable GFM-style ~~strikethrough~~ processing\n");
     fprintf(stderr, "  --title TITLE          Document title (requires --standalone, default: \"Document\")\n");
+    fprintf(stderr, "  --toc-min-max MIN,MAX  TOC heading depth (default 1,3) for -t toc and bare HTML TOC markers; marker ranges still override\n");
     fprintf(stderr, "  --[no-]transforms      Enable or disable metadata variable transforms [%%key:transform]\n");
     fprintf(stderr, "  --[no-]unsafe          Allow or disallow raw HTML in output\n");
     fprintf(stderr, "  --widont               Prevent short widows in headings by inserting non-breaking spaces between trailing words\n");
@@ -1073,6 +1098,8 @@ static void print_usage(const char *program_name) {
     fprintf(stderr, "  --no-terminal-images    Do not render local images via imgcat/chafa/viu/catimg on terminal output\n");
     fprintf(stderr, "  --terminal-image-width N  Max width/cells for terminal image tools (default: 50)\n");
     fprintf(stderr, "  -p, --paginate          Page terminal/cli/terminal256 output through a pager (APEX_PAGER, then PAGER, then less -R)\n");
+    fprintf(stderr, "  --paginate-symbols      Page output and render images as chafa ANSI art (compatible with less -R)\n");
+    fprintf(stderr, "  --no-paginate           Do not page terminal output (overrides -p and paginate: true in config/metadata)\n");
     fprintf(stderr, "\n");
     fprintf(stderr, "If no file is specified, reads from stdin.\n");
 }
@@ -1218,16 +1245,34 @@ static int add_script_tag(char ***tags, size_t *count, size_t *capacity, const c
     return 0;
 }
 
+/* Detect inline terminal graphics that pagers (less -R, etc.) cannot render. */
+static bool terminal_output_has_graphics(const char *buf, size_t len) {
+    if (!buf || len == 0) {
+        return false;
+    }
+    /* iTerm / WezTerm inline images (also chafa -f iterm). */
+    if (memmem(buf, len, "]1337;", 6) != NULL) {
+        return true;
+    }
+    /* Kitty graphics protocol. */
+    if (memmem(buf, len, "\033_G", 3) != NULL) {
+        return true;
+    }
+    return false;
+}
+
 /* Wrap ANSI-colored output to a fixed column width.
  * This operates on the final rendered string and counts only visible
  * characters toward the width, skipping over ANSI CSI sequences.
  */
-static char *wrap_ansi_to_width(const char *input, int width) {
+static char *wrap_ansi_to_width(const char *input, size_t in_len, int width) {
     if (!input || width <= 0) {
         return NULL;
     }
+    if (in_len == 0) {
+        in_len = strlen(input);
+    }
 
-    size_t in_len = strlen(input);
     /* Heuristic for output capacity: input length plus space for added newlines. */
     size_t cap = in_len + (in_len / (size_t)width + 2) * 2 + 1;
     char *out = malloc(cap);
@@ -1274,6 +1319,62 @@ static char *wrap_ansi_to_width(const char *input, int width) {
             continue;
         }
 
+        /* Preserve OSC sequences (e.g. iTerm inline images: ESC ] ... BEL or ST). */
+        if (c == '\x1b' && i + 1 < in_len && input[i + 1] == ']') {
+            size_t start = i;
+            i += 2;
+            while (i < in_len) {
+                if (input[i] == '\x07') {
+                    i++;
+                    break;
+                }
+                if (input[i] == '\x1b' && i + 1 < in_len && input[i + 1] == '\\') {
+                    i += 2;
+                    break;
+                }
+                i++;
+            }
+            size_t seq_len = i - start;
+            if (oi + seq_len + 1 >= cap) {
+                cap = cap + seq_len + 16;
+                char *nb = realloc(out, cap);
+                if (!nb) {
+                    free(out);
+                    return NULL;
+                }
+                out = nb;
+            }
+            memcpy(out + oi, input + start, seq_len);
+            oi += seq_len;
+            continue;
+        }
+
+        /* Preserve DCS (sixel) and kitty graphics (ESC _ ... ST). */
+        if (c == '\x1b' && i + 1 < in_len && (input[i + 1] == 'P' || input[i + 1] == '_')) {
+            size_t start = i;
+            i += 2;
+            while (i < in_len) {
+                if (input[i] == '\x1b' && i + 1 < in_len && input[i + 1] == '\\') {
+                    i += 2;
+                    break;
+                }
+                i++;
+            }
+            size_t seq_len = i - start;
+            if (oi + seq_len + 1 >= cap) {
+                cap = cap + seq_len + 16;
+                char *nb = realloc(out, cap);
+                if (!nb) {
+                    free(out);
+                    return NULL;
+                }
+                out = nb;
+            }
+            memcpy(out + oi, input + start, seq_len);
+            oi += seq_len;
+            continue;
+        }
+
         /* Preserve ANSI CSI sequences without counting them toward width. */
         if (c == '\x1b' && i + 1 < in_len && input[i + 1] == '[') {
             size_t start = i;
@@ -1755,7 +1856,7 @@ static char *apex_cli_combine_process_file(const char *filepath) {
     }
 
     char *base_dir = apex_cli_get_directory(filepath);
-    char *processed = apex_process_includes(markdown, base_dir, doc_metadata, 0);
+    char *processed = apex_process_includes(markdown, base_dir, doc_metadata, 0, NULL, NULL, NULL);
 
     if (doc_metadata) {
         apex_free_metadata(doc_metadata);
@@ -1926,6 +2027,11 @@ int main(int argc, char *argv[]) {
     size_t bibliography_count = 0;
     size_t bibliography_capacity = 4;
 
+    /* Concordance files (NULL-terminated array) */
+    char **concordance_files = NULL;
+    size_t concordance_count = 0;
+    size_t concordance_capacity = 4;
+
     /* Stylesheet files (NULL-terminated array) */
     char **stylesheet_files = NULL;
     size_t stylesheet_count = 0;
@@ -1953,6 +2059,8 @@ int main(int argc, char *argv[]) {
 
     /* Pagination for terminal/terminal256 output */
     bool paginate_cli = false;
+    bool paginate_symbols_cli = false;
+    bool no_paginate_cli = false;
 
     /* Terminal inline images: --no-terminal-images / --terminal-image-width N */
     bool no_terminal_images_cli = false;
@@ -1992,6 +2100,8 @@ int main(int argc, char *argv[]) {
                 options = apex_options_for_mode(APEX_MODE_KRAMDOWN);
             } else if (strcmp(argv[i], "unified") == 0) {
                 options = apex_options_for_mode(APEX_MODE_UNIFIED);
+            } else if (strcmp(argv[i], "quarto") == 0) {
+                options = apex_options_for_mode(APEX_MODE_QUARTO);
             } else {
                 fprintf(stderr, "Error: Unknown mode '%s'\n", argv[i]);
                 return 1;
@@ -2040,11 +2150,40 @@ int main(int argc, char *argv[]) {
                 options.output_format = APEX_OUTPUT_MAN;
             } else if (strcmp(argv[i], "man-html") == 0) {
                 options.output_format = APEX_OUTPUT_MAN_HTML;
+            } else if (strcmp(argv[i], "toc") == 0) {
+                options.output_format = APEX_OUTPUT_TOC;
+            } else if (strcmp(argv[i], "rtf") == 0) {
+                options.output_format = APEX_OUTPUT_RTF;
             } else {
                 fprintf(stderr, "Error: Unknown output format '%s'\n", argv[i]);
-                fprintf(stderr, "Supported formats: html, xhtml, strict-xhtml, json, json-filtered/ast-json/ast, markdown/md, mmd, commonmark/cmark, kramdown, gfm, terminal/cli, terminal256, man, man-html\n");
+                fprintf(stderr, "Supported formats: html, xhtml, strict-xhtml, json, json-filtered/ast-json/ast, markdown/md, mmd, commonmark/cmark, kramdown, gfm, terminal/cli, terminal256, man, man-html, toc, rtf\n");
+                return 1;
+            }
+        } else if (strncmp(argv[i], "--toc-min-max=", 14) == 0 ||
+                   strcmp(argv[i], "--toc-min-max") == 0) {
+            const char *arg_value = NULL;
+            if (strncmp(argv[i], "--toc-min-max=", 14) == 0) {
+                arg_value = argv[i] + 14;
+            } else {
+                if (++i >= argc) {
+                    fprintf(stderr, "Error: --toc-min-max requires MIN,MAX\n");
+                    return 1;
+                }
+                arg_value = argv[i];
+            }
+
+            int toc_min = 0;
+            int toc_max = 0;
+            int consumed = 0;
+            if (sscanf(arg_value, "%d,%d%n", &toc_min, &toc_max, &consumed) != 2 ||
+                arg_value[consumed] != '\0' ||
+                toc_min < 1 || toc_min > toc_max || toc_max > 6) {
+                fprintf(stderr, "Error: --toc-min-max must be MIN,MAX with 1 <= MIN <= MAX <= 6\n");
                 return 1;
             }
+            cli_opt_mask.toc_min_max = true;
+            options.toc_min = toc_min;
+            options.toc_max = toc_max;
         } else if (strcmp(argv[i], "--theme") == 0) {
             if (++i >= argc) {
                 fprintf(stderr, "Error: --theme requires a name argument\n");
@@ -2063,6 +2202,10 @@ int main(int argc, char *argv[]) {
             }
         } else if (strcmp(argv[i], "-p") == 0 || strcmp(argv[i], "--paginate") == 0) {
             paginate_cli = true;
+        } else if (strcmp(argv[i], "--paginate-symbols") == 0) {
+            paginate_symbols_cli = true;
+        } else if (strcmp(argv[i], "--no-paginate") == 0) {
+            no_paginate_cli = true;
         } else if (strcmp(argv[i], "--no-terminal-images") == 0) {
             no_terminal_images_cli = true;
         } else if (strcmp(argv[i], "--terminal-image-width") == 0) {
@@ -2173,6 +2316,12 @@ int main(int argc, char *argv[]) {
         } else if (strcmp(argv[i], "--no-tables") == 0) {
             cli_opt_mask.enable_tables = true;
             options.enable_tables = false;
+        } else if (strcmp(argv[i], "--grid-tables") == 0 || strcmp(argv[i], "--enable-grid-tables") == 0) {
+            cli_opt_mask.enable_grid_tables = true;
+            options.enable_grid_tables = true;
+        } else if (strcmp(argv[i], "--no-grid-tables") == 0) {
+            cli_opt_mask.enable_grid_tables = true;
+            options.enable_grid_tables = false;
         } else if (strcmp(argv[i], "--no-footnotes") == 0) {
             cli_opt_mask.enable_footnotes = true;
             options.enable_footnotes = false;
@@ -2505,6 +2654,18 @@ int main(int argc, char *argv[]) {
         } else if (strcmp(argv[i], "--no-divs") == 0) {
             cli_opt_mask.enable_divs = true;
             options.enable_divs = false;
+        } else if (strcmp(argv[i], "--py-callouts") == 0) {
+            cli_opt_mask.enable_py_callouts = true;
+            options.enable_py_callouts = true;
+        } else if (strcmp(argv[i], "--no-py-callouts") == 0) {
+            cli_opt_mask.enable_py_callouts = true;
+            options.enable_py_callouts = false;
+        } else if (strcmp(argv[i], "--quarto-callouts") == 0) {
+            cli_opt_mask.enable_quarto_callouts = true;
+            options.enable_quarto_callouts = true;
+        } else if (strcmp(argv[i], "--no-quarto-callouts") == 0) {
+            cli_opt_mask.enable_quarto_callouts = true;
+            options.enable_quarto_callouts = false;
         } else if (strcmp(argv[i], "--one-line-definitions") == 0) {
             cli_opt_mask.enable_definition_lists = true;
             options.enable_definition_lists = true;
@@ -2671,6 +2832,30 @@ int main(int argc, char *argv[]) {
             cli_opt_mask.bibliography = true;
             bibliography_files[bibliography_count++] = argv[i];
             options.enable_citations = true;  /* Enable citations when bibliography is provided */
+        } else if (strcmp(argv[i], "--concordance") == 0) {
+            if (++i >= argc) {
+                fprintf(stderr, "Error: --concordance requires an argument\n");
+                return 1;
+            }
+            if (!concordance_files) {
+                concordance_files = malloc(concordance_capacity * sizeof(char*));
+                if (!concordance_files) {
+                    fprintf(stderr, "Error: Memory allocation failed\n");
+                    return 1;
+                }
+            } else if (concordance_count >= concordance_capacity) {
+                concordance_capacity *= 2;
+                char **new_files = realloc(concordance_files, concordance_capacity * sizeof(char*));
+                if (!new_files) {
+                    fprintf(stderr, "Error: Memory allocation failed\n");
+                    return 1;
+                }
+                concordance_files = new_files;
+            }
+            cli_opt_mask.concordance = true;
+            concordance_files[concordance_count++] = argv[i];
+            options.enable_indices = true;
+            options.enable_textindex_syntax = true;
         } else if (strcmp(argv[i], "--csl") == 0) {
             if (++i >= argc) {
                 fprintf(stderr, "Error: --csl requires an argument\n");
@@ -3844,7 +4029,7 @@ int main(int argc, char *argv[]) {
 
     if (options.mode == APEX_MODE_MULTIMARKDOWN ||
         options.mode == APEX_MODE_KRAMDOWN ||
-        options.mode == APEX_MODE_UNIFIED) {
+        apex_mode_is_unified_family(options.mode)) {
         /* Make a copy to extract metadata without modifying original */
         char *doc_copy = malloc(input_len + 1);
         if (doc_copy) {
@@ -3937,6 +4122,17 @@ int main(int argc, char *argv[]) {
         }
     }
 
+    /* Set concordance files in options (NULL-terminated array) */
+    if (concordance_count > 0) {
+        concordance_files = realloc(concordance_files, (concordance_count + 1) * sizeof(char*));
+        if (concordance_files) {
+            concordance_files[concordance_count] = NULL;
+            options.concordance_files = concordance_files;
+            options.enable_indices = true;
+            options.enable_textindex_syntax = true;
+        }
+    }
+
     /* Set stylesheet files in options (NULL-terminated array) */
     if (stylesheet_count > 0) {
         stylesheet_files = realloc(stylesheet_files, (stylesheet_count + 1) * sizeof(char*));
@@ -4224,6 +4420,16 @@ int main(int argc, char *argv[]) {
     if (terminal_image_width_cli > 0) {
         options.terminal_image_width = terminal_image_width_cli;
     }
+    if (no_paginate_cli) {
+        options.paginate = false;
+        options.paginate_symbols = false;
+    } else if (paginate_symbols_cli) {
+        options.paginate = true;
+        options.paginate_symbols = true;
+    } else if (paginate_cli) {
+        options.paginate = true;
+        options.paginate_symbols = false;
+    }
 
     /* Convert to output (HTML, Markdown, terminal, etc.) */
     char *html = apex_markdown_to_html(final_markdown, final_len, &options);
@@ -4252,12 +4458,21 @@ int main(int argc, char *argv[]) {
         return 1;
     }
 
+    bool is_terminal_output = (options.output_format == APEX_OUTPUT_TERMINAL ||
+                               options.output_format == APEX_OUTPUT_TERMINAL256);
+    size_t html_len = 0;
+    if (html) {
+        html_len = is_terminal_output ? apex_terminal_output_length() : strlen(html);
+        if (html_len == 0) {
+            html_len = strlen(html);
+        }
+    }
+
     /* For terminal output, optionally wrap to a fixed width when requested.
      * Precedence: CLI --width > metadata/config terminal.width > theme default.
      * (Theme files are currently not consulted for width.)
      */
-    if (options.output_format == APEX_OUTPUT_TERMINAL ||
-        options.output_format == APEX_OUTPUT_TERMINAL256) {
+    if (is_terminal_output) {
         int effective_width = 0;
         if (width_override > 0) {
             effective_width = width_override;
@@ -4265,10 +4480,11 @@ int main(int argc, char *argv[]) {
             effective_width = options.terminal_width;
         }
         if (effective_width > 0) {
-            char *wrapped = wrap_ansi_to_width(html, effective_width);
+            char *wrapped = wrap_ansi_to_width(html, html_len, effective_width);
             if (wrapped) {
                 apex_free_string(html);
                 html = wrapped;
+                html_len = strlen(html);
             }
         }
     }
@@ -4281,11 +4497,22 @@ int main(int argc, char *argv[]) {
     if (!output_file &&
         (options.output_format == APEX_OUTPUT_TERMINAL ||
          options.output_format == APEX_OUTPUT_TERMINAL256)) {
-        if (paginate_cli || options.paginate) {
+        if (!no_paginate_cli && (paginate_cli || options.paginate)) {
             paginate_effective = true;
         }
     }
 
+    if (paginate_effective && is_terminal_output && !options.paginate_symbols &&
+        terminal_output_has_graphics(html, html_len)) {
+        if (getenv("APEX_DEBUG_TERMINAL")) {
+            fprintf(stderr, "[APEX_DEBUG_TERMINAL] pager disabled (inline graphics in output)\n");
+        }
+        fprintf(stderr,
+                "apex: skipping pager (inline terminal graphics require direct TTY output; "
+                "less and most pagers only support ANSI color)\n");
+        paginate_effective = false;
+    }
+
     /* Write output (optionally via pager) */
     PROFILE_START(file_write);
     if (paginate_effective) {
@@ -4298,7 +4525,6 @@ int main(int argc, char *argv[]) {
         }
 
         FILE *pager = popen(pager_cmd, "w");
-        size_t html_len = strlen(html);
         if (!pager) {
             /* Fall back to direct stdout if pager cannot be started */
             fwrite(html, 1, html_len, stdout);
@@ -4313,11 +4539,9 @@ int main(int argc, char *argv[]) {
             apex_free_string(html);
             return 1;
         }
-        size_t html_len = strlen(html);
         fwrite(html, 1, html_len, fp);
         fclose(fp);
     } else {
-        size_t html_len = strlen(html);
         fwrite(html, 1, html_len, stdout);
         /* Don't fflush - let the system buffer for better performance */
     }
@@ -4332,6 +4556,11 @@ int main(int argc, char *argv[]) {
         free(bibliography_files);
     }
 
+    /* Free concordance files array */
+    if (concordance_files) {
+        free(concordance_files);
+    }
+
     /* Free script tags array and contents */
     if (script_tags) {
         for (size_t i = 0; i < script_tag_count; i++) {

data/ext/apex_ext/apex_src/debug.log

@@ -0,0 +1,7 @@
+DEBUG: Found second d1 row
+  tentative_row_idx: 2
+  ast_row_idx: 3
+  min_equals_row_idx: 2
+  html_row_before_equals_calc: 1
+  force_tbody before check: 0
+  -> Row is NOT marked as tfoot in AST