apex-ruby 1.0.18 → 1.0.20

data/ext/apex_ext/apex_src/include/apex/apex.h

@@ -20,9 +20,9 @@ typedef struct cmark_node cmark_node;
 #endif
 
 #define APEX_VERSION_MAJOR 1
-#define APEX_VERSION_MINOR 0
-#define APEX_VERSION_PATCH 4
-#define APEX_VERSION_STRING "1.0.4"
+#define APEX_VERSION_MINOR 1
+#define APEX_VERSION_PATCH 20
+#define APEX_VERSION_STRING "1.1.20"
 
 /**
  * Processor compatibility modes
@@ -34,10 +34,21 @@ typedef enum {
     APEX_MODE_GFM = 1,              /* GitHub Flavored Markdown */
     APEX_MODE_MULTIMARKDOWN = 2,    /* MultiMarkdown compatibility */
     APEX_MODE_KRAMDOWN = 3,         /* Kramdown compatibility */
-    APEX_MODE_UNIFIED = 4           /* All features enabled */
+    APEX_MODE_UNIFIED = 4,          /* All features enabled */
+    APEX_MODE_QUARTO = 5            /* Pandoc/Quarto markdown (HTML-oriented) */
 } apex_mode_t;
 #endif
 
+/** True for unified and quarto processor modes. */
+static inline bool apex_mode_is_unified_family(apex_mode_t mode) {
+    return mode == APEX_MODE_UNIFIED || mode == APEX_MODE_QUARTO;
+}
+
+/** True for kramdown, unified, or quarto processor modes. */
+static inline bool apex_mode_is_kramdown_or_unified_family(apex_mode_t mode) {
+    return mode == APEX_MODE_KRAMDOWN || apex_mode_is_unified_family(mode);
+}
+
 /**
  * Output format options
  */
@@ -53,9 +64,21 @@ typedef enum {
     APEX_OUTPUT_TERMINAL = 8,       /* ANSI terminal output (8/16-color) */
     APEX_OUTPUT_TERMINAL256 = 9,    /* ANSI terminal output (256-color) */
     APEX_OUTPUT_MAN = 10,           /* roff (man page source) */
-    APEX_OUTPUT_MAN_HTML = 11       /* styled HTML man page */
+    APEX_OUTPUT_MAN_HTML = 11,      /* styled HTML man page */
+    APEX_OUTPUT_TOC = 12,           /* Markdown TOC list only */
+    APEX_OUTPUT_RTF = 13            /* Rich Text Format */
 } apex_output_format_t;
 
+/**
+ * Flat TOC entry for structured outlines (Swift/ObjC table views, etc.).
+ * level is 1-6; text and id are heap-owned when returned from Apex APIs.
+ */
+typedef struct apex_toc_entry {
+    int level;
+    char *text;
+    char *id;
+} apex_toc_entry;
+
 /* Markdown dialects for AST->Markdown serialization. */
 #ifndef APEX_MARKDOWN_DIALECT_DEFINED
 #define APEX_MARKDOWN_DIALECT_DEFINED
@@ -109,9 +132,22 @@ typedef struct apex_options {
     bool enable_task_lists;
     bool enable_attributes;
     bool enable_callouts;
+    bool enable_py_callouts;      /* Enable Python-Markdown !!! callout preprocessing */
+    bool enable_quarto_callouts;  /* Enable Quarto ::: callout preprocessing */
+    bool enable_quarto_extensions; /* Enable Pandoc/Quarto-specific preprocessors ({=raw}, example lists, etc.) */
+    bool enable_quarto_raw;        /* Enable {=format} raw content preprocessing */
+    bool enable_quarto_example_lists; /* Enable (@) example list markers (quarto-list-continuation) */
+    bool enable_quarto_line_blocks;  /* Enable | line blocks */
+    bool enable_quarto_roman_lists;  /* Enable i) ii) roman list markers */
+    bool enable_quarto_code_attrs;   /* Enable ```{.lang attr="val"} fence attributes */
+    bool enable_quarto_diagrams;   /* Enable Quarto diagram fences ({mermaid}, {dot}, {graphviz}) */
+    bool enable_quarto_shortcodes; /* Enable Quarto shortcode shim ({{< ... >}}) */
+    bool enable_quarto_strict_lists; /* Require blank line before list blocks (Pandoc strict) */
+    bool enable_quarto_xrefs;      /* Wrap @fig-/@sec- cross-refs in span.quarto-xref */
     bool enable_marked_extensions;
-    bool enable_divs;  /* Enable Pandoc fenced divs (Unified mode only) */
+    bool enable_divs;  /* Enable Pandoc fenced divs (unified/quarto modes) */
     bool enable_spans;  /* Enable bracketed spans [text]{IAL} (Pandoc-style) */
+    bool enable_grid_tables;  /* Enable Pandoc grid table syntax (preprocess to pipe tables) */
 
     /* Critic markup mode */
     int critic_mode;  /* 0=markup (default), 1=accept, 2=reject */
@@ -143,6 +179,7 @@ typedef struct apex_options {
     const char *theme_name;      /* Optional terminal theme name (for -t terminal/terminal256) */
     int terminal_width;          /* Optional fixed wrapping width for terminal output (0 = auto / none) */
     bool paginate;               /* When true and output_format is terminal/terminal256, page output via pager */
+    bool paginate_symbols;       /* When paginating, render images as chafa ANSI symbols (less -R compatible) */
     bool terminal_inline_images; /* When true, render local images via imgcat/chafa/viu/catimg on a TTY */
     int terminal_image_width;    /* Max width/cells for terminal image tools (default 50; 0 = use 50) */
 
@@ -155,6 +192,17 @@ typedef struct apex_options {
     bool header_anchors;  /* Generate <a> anchor tags instead of header IDs */
     int id_format;  /* 0=GFM (with dashes), 1=MMD (no dashes) */
 
+    /* TOC depth defaults (used by -t toc and by HTML TOC markers without an explicit range) */
+    int toc_min;  /* Inclusive min heading level (default 1) */
+    int toc_max;  /* Inclusive max heading level (default 3) */
+
+    /* Optional structured TOC capture (normally NULL). Prefer apex_markdown_to_toc_entries().
+     * When both are non-NULL and output_format is APEX_OUTPUT_TOC, apex_markdown_to_html
+     * fills *toc_entries_out / *toc_entries_count_out (free with apex_toc_entries_free)
+     * and returns an empty string. */
+    apex_toc_entry **toc_entries_out;
+    size_t *toc_entries_count_out;
+
     /* Table options */
     bool relaxed_tables;  /* Support tables without separator rows (kramdown/unified only) */
     int caption_position;  /* 0=above, 1=below (default: 1=below) */
@@ -195,6 +243,7 @@ typedef struct apex_options {
     bool enable_leanpub_index_syntax;  /* Enable Leanpub {i: "term"} syntax */
     bool suppress_index;  /* Suppress index output */
     bool group_index_by_letter;  /* Group index entries by first letter */
+    char **concordance_files;  /* NULL-terminated TextIndex concordance TSV paths */
 
     /* Wiki link options */
     int wikilink_space;  /* Space replacement: 0=dash, 1=none, 2=underscore, 3=space */
@@ -291,6 +340,7 @@ char *apex_cmark_to_markdown(cmark_node *document,
                              apex_markdown_dialect_t dialect);
 char *apex_cmark_to_man_roff(cmark_node *document, const struct apex_options *options);
 char *apex_cmark_to_man_html(cmark_node *document, const struct apex_options *options);
+char *apex_cmark_to_rtf(cmark_node *document, const struct apex_options *options);
 
 /**
  * Get default options for a specific mode
@@ -298,6 +348,17 @@ char *apex_cmark_to_man_html(cmark_node *document, const struct apex_options *op
 apex_options apex_options_default(void);
 apex_options apex_options_for_mode(apex_mode_t mode);
 
+/**
+ * Load metadata from an external file and apply it to options.
+ * Supports the same YAML, Pandoc, and MultiMarkdown formats as the CLI.
+ * String fields populated by this function are heap-allocated copies. The
+ * caller may leave them allocated for the process lifetime or free each field
+ * individually after the final conversion that uses these options.
+ * @return true on success; false if options or path is NULL, path is empty,
+ *         the file cannot be loaded, or ownership copies cannot be allocated.
+ */
+bool apex_options_apply_meta_file(apex_options *options, const char *path);
+
 /**
  * Main conversion function: Markdown to HTML
  *
@@ -308,6 +369,31 @@ apex_options apex_options_for_mode(apex_mode_t mode);
  */
 char *apex_markdown_to_html(const char *markdown, size_t len, const apex_options *options);
 
+/**
+ * Collect document headings as a flat array of TOC entries.
+ * Honors id_format, min/max levels, and .no_toc the same as -t toc.
+ * @param out_count Receives entry count (may be 0); required
+ * @return Heap array of count entries, or NULL if out_count is NULL / allocation fails.
+ *         Free with apex_toc_entries_free().
+ */
+apex_toc_entry *apex_generate_toc_entries(cmark_node *document, int id_format,
+                                          int min_level, int max_level,
+                                          size_t *out_count);
+
+/**
+ * Parse markdown and return structured TOC entries (same pipeline as -t toc).
+ * Uses options->toc_min / toc_max / id_format (defaults apply when options is NULL).
+ * Free the result with apex_toc_entries_free().
+ */
+apex_toc_entry *apex_markdown_to_toc_entries(const char *markdown, size_t len,
+                                             const apex_options *options,
+                                             size_t *out_count);
+
+/**
+ * Free an array returned by apex_generate_toc_entries / apex_markdown_to_toc_entries.
+ */
+void apex_toc_entries_free(apex_toc_entry *entries, size_t count);
+
 /**
  * Resolve a local image path against base_directory (same rules as HTML embedding).
  * Returns a newly allocated path, or NULL on allocation failure.

data/ext/apex_ext/apex_src/include/apex/ast_rtf.h

@@ -0,0 +1,23 @@
+#ifndef APEX_AST_RTF_H
+#define APEX_AST_RTF_H
+
+#include "cmark-gfm.h"
+
+/* Forward declaration of options struct; full typedef lives in apex.h */
+struct apex_options;
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * Serialize a cmark document to Rich Text Format (RTF).
+ * Returns a newly allocated string (caller frees with free/apex_free_string).
+ */
+char *apex_cmark_to_rtf(cmark_node *document, const struct apex_options *options);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

data/ext/apex_ext/apex_src/include/apex/ast_terminal.h

@@ -32,6 +32,12 @@ char *apex_cmark_to_terminal(cmark_node *document,
                              const struct apex_options *options,
                              bool use_256);
 
+/**
+ * Byte length of the most recent apex_cmark_to_terminal() result.
+ * Use instead of strlen() because inline image escape sequences may contain NUL bytes.
+ */
+size_t apex_terminal_output_length(void);
+
 #ifdef __cplusplus
 }
 #endif

data/ext/apex_ext/apex_src/include/apex/module.modulemap

@@ -1,5 +1,6 @@
 module ApexHeaders {
     umbrella header "apex.h"
+    header "plugins.h"
     explicit module parser {
         header "parser.h"
         export *
@@ -20,5 +21,9 @@ module ApexHeaders {
         header "ast_man.h"
         export *
     }
+    explicit module ast_rtf {
+        header "ast_rtf.h"
+        export *
+    }
     export *
 }

data/ext/apex_ext/apex_src/include/apex/plugins.h

@@ -0,0 +1,105 @@
+/**
+ * Apex plugin catalog and installation API.
+ *
+ * Fetch available plugins from the central directory, list installed plugins,
+ * and install or uninstall plugins into the user-global plugins directory.
+ */
+
+#ifndef APEX_PLUGINS_PUBLIC_H
+#define APEX_PLUGINS_PUBLIC_H
+
+#include <stddef.h>
+#include <stdbool.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** Default URL for apex-plugins.json (ApexMarkdown/apex-plugins). */
+#define APEX_PLUGIN_DIRECTORY_URL \
+    "https://raw.githubusercontent.com/ApexMarkdown/apex-plugins/refs/heads/main/apex-plugins.json"
+
+/** One plugin entry (catalog or installed). String fields are owned by the catalog. */
+typedef struct apex_plugin_info {
+    char *id;
+    char *title;
+    char *description;
+    char *author;
+    char *homepage;
+    char *repo;
+} apex_plugin_info;
+
+/** Array of plugin entries. */
+typedef struct apex_plugin_catalog {
+    apex_plugin_info *items;
+    size_t count;
+} apex_plugin_catalog;
+
+/** Options for discovering installed plugins (same precedence as runtime loading). */
+typedef struct apex_plugin_discovery_options {
+    /** Optional document/project base directory for .apex/plugins lookup. */
+    const char *base_directory;
+    /** Include project-scoped dirs (cwd, base_directory, git root). Default true when NULL opts. */
+    bool include_project;
+    /** Include user-global ~/.config/apex/plugins. Default true when NULL opts. */
+    bool include_user_global;
+} apex_plugin_discovery_options;
+
+/** Options for apex_plugin_install(). */
+typedef struct apex_plugin_install_options {
+    /** Allow install by Git URL or user/repo shorthand (not in the directory). */
+    bool allow_untrusted_repo;
+    /** Run post_install from plugin.yml after clone. Default true when NULL opts. */
+    bool run_post_install;
+} apex_plugin_install_options;
+
+/**
+ * Fetch the plugin catalog from a JSON directory URL.
+ * @return New catalog (caller must free with apex_plugin_catalog_free), or NULL on failure.
+ */
+apex_plugin_catalog *apex_plugin_catalog_fetch_url(const char *url);
+
+/** Fetch the catalog from APEX_PLUGIN_DIRECTORY_URL. */
+apex_plugin_catalog *apex_plugin_catalog_fetch_default(void);
+
+/** Free a catalog returned by fetch or list functions. */
+void apex_plugin_catalog_free(apex_plugin_catalog *catalog);
+
+/**
+ * List installed plugins using the same discovery order as apex_plugins_load().
+ * @return New catalog, or NULL on failure.
+ */
+apex_plugin_catalog *apex_plugins_list_installed(
+    const apex_plugin_discovery_options *options);
+
+/**
+ * Resolve the user-global plugins directory (~/.config/apex/plugins or XDG).
+ * @return 0 on success, -1 if buffer too small or HOME unset.
+ */
+int apex_plugin_global_directory(char *buf, size_t buflen);
+
+/**
+ * Install a plugin by directory id or Git URL / GitHub shorthand.
+ * Installs into the user-global plugins directory.
+ * @param error_buf Optional buffer for an error message (may be NULL).
+ * @return 0 on success, -1 on failure.
+ */
+int apex_plugin_install(const char *id_or_repo,
+                        const apex_plugin_install_options *options,
+                        char *error_buf,
+                        size_t error_buf_len);
+
+/**
+ * Remove an installed plugin from the user-global plugins directory.
+ * Does not remove support data under apex/support/<id>/.
+ * @return 0 on success, -1 on failure.
+ */
+int apex_plugin_uninstall(const char *id,
+                          char *error_buf,
+                          size_t error_buf_len);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* APEX_PLUGINS_PUBLIC_H */

data/ext/apex_ext/apex_src/include/apexc.h

@@ -2,5 +2,6 @@
 #define APEXC_H
 
 #include <apex/apex.h>
+#include <apex/plugins.h>
 
 #endif /* APEXC_H */