RubyGems - apex-ruby - Versions diffs - 1.0.7 → 1.0.9 - Mend

apex-ruby 1.0.7 → 1.0.9

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 (51) hide show

checksums.yaml +4 -4
data/ext/apex_ext/apex_src/CHANGELOG.md +69 -0
data/ext/apex_ext/apex_src/CMakeLists.txt +2 -1
data/ext/apex_ext/apex_src/Formula/apex.rb +2 -2
data/ext/apex_ext/apex_src/Package.swift +14 -2
data/ext/apex_ext/apex_src/README.md +12 -9
data/ext/apex_ext/apex_src/VERSION +1 -1
data/ext/apex_ext/apex_src/cli/main.c +625 -98
data/ext/apex_ext/apex_src/ial.html +24 -0
data/ext/apex_ext/apex_src/include/apex/apex.h +57 -7
data/ext/apex_ext/apex_src/include/apex/ast_markdown.h +3 -0
data/ext/apex_ext/apex_src/include/apex/module.modulemap +8 -0
data/ext/apex_ext/apex_src/include/apexc.h +6 -0
data/ext/apex_ext/apex_src/include/module.modulemap +4 -0
data/ext/apex_ext/apex_src/man/apex-config.5 +8 -2
data/ext/apex_ext/apex_src/man/apex-plugins.7 +13 -13
data/ext/apex_ext/apex_src/man/apex.1 +150 -442
data/ext/apex_ext/apex_src/man/apex.1.md +13 -0
data/ext/apex_ext/apex_src/src/_README.md +3 -1
data/ext/apex_ext/apex_src/src/apex.c +151 -6
data/ext/apex_ext/apex_src/src/ast_terminal.c +459 -8
data/ext/apex_ext/apex_src/src/extensions/advanced_tables.c +6 -6
data/ext/apex_ext/apex_src/src/extensions/callouts.c +1 -1
data/ext/apex_ext/apex_src/src/extensions/citations.c +24 -12
data/ext/apex_ext/apex_src/src/extensions/critic.c +14 -6
data/ext/apex_ext/apex_src/src/extensions/emoji.c +2 -2
data/ext/apex_ext/apex_src/src/extensions/grid_tables.c +1 -1
data/ext/apex_ext/apex_src/src/extensions/header_ids.c +19 -6
data/ext/apex_ext/apex_src/src/extensions/ial.c +25 -13
data/ext/apex_ext/apex_src/src/extensions/includes.c +7 -7
data/ext/apex_ext/apex_src/src/extensions/index.c +19 -7
data/ext/apex_ext/apex_src/src/extensions/inline_footnotes.c +2 -2
data/ext/apex_ext/apex_src/src/extensions/insert.c +1 -1
data/ext/apex_ext/apex_src/src/extensions/math.c +11 -2
data/ext/apex_ext/apex_src/src/extensions/metadata.c +46 -0
data/ext/apex_ext/apex_src/src/extensions/metadata.h +12 -0
data/ext/apex_ext/apex_src/src/html_renderer.c +2 -2
data/ext/apex_ext/apex_src/src/plugins.c +97 -55
data/ext/apex_ext/apex_src/src/plugins.h +0 -10
data/ext/apex_ext/apex_src/src/pretty_html.c +1 -1
data/ext/apex_ext/apex_src/tests/fixtures/metadata/mmd-metadata.md +5 -0
data/ext/apex_ext/apex_src/tests/fixtures/metadata/pandoc-meta.md +4 -0
data/ext/apex_ext/apex_src/tests/fixtures/metadata/yaml-frontmatter.md +6 -0
data/ext/apex_ext/apex_src/tests/metadata_cli_test.sh +119 -0
data/ext/apex_ext/apex_src/tests/test_custom_plugins.c +78 -0
data/ext/apex_ext/apex_src/tests/test_extensions.c +27 -0
data/ext/apex_ext/apex_src/tests/test_metadata.c +42 -0
data/ext/apex_ext/apex_src/tests/test_output.c +83 -0
data/ext/apex_ext/apex_src/tests/test_runner.c +4 -1
data/lib/apex/version.rb +1 -1
metadata +10 -2

data/ext/apex_ext/apex_src/ial.html ADDED Viewed

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="generator" content="Apex 0.1.93">
+  <title>Document</title>
+</head>
+<body>
+  <p class="tip">This is a paragraph with a class.</p>
+  <p id="main" class="tip">With no spaces.</p>
+  <ul class="this-list">
+    <li>this</li>
+    <li>is a list</li>
+    <li>with a class</li>
+  </ul>
+</body>
+</html>

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

@@ -14,14 +14,15 @@ extern "C" {
 #include <stddef.h>
 #include <stdbool.h>
-#include "ast_markdown.h"
 #include "ast_terminal.h"
-#include "ast_man.h"
+#ifndef CMARK_GFM_H
+typedef struct cmark_node cmark_node;
+#endif
-#define APEX_VERSION_MAJOR 0
-#define APEX_VERSION_MINOR 1
-#define APEX_VERSION_PATCH 98
-#define APEX_VERSION_STRING "0.1.98"
+#define APEX_VERSION_MAJOR 1
+#define APEX_VERSION_MINOR 0
+#define APEX_VERSION_PATCH 4
+#define APEX_VERSION_STRING "1.0.4"
 /**
  * Processor compatibility modes
@@ -55,6 +56,36 @@ typedef enum {
     APEX_OUTPUT_MAN_HTML = 11       /* styled HTML man page */
 } apex_output_format_t;
+/* Markdown dialects for AST->Markdown serialization. */
+#ifndef APEX_MARKDOWN_DIALECT_DEFINED
+#define APEX_MARKDOWN_DIALECT_DEFINED
+typedef enum {
+    APEX_MD_DIALECT_UNIFIED = 0,
+    APEX_MD_DIALECT_MMD = 1,
+    APEX_MD_DIALECT_COMMONMARK = 2,
+    APEX_MD_DIALECT_KRAMDOWN = 3,
+    APEX_MD_DIALECT_GFM = 4
+} apex_markdown_dialect_t;
+#endif
+/* Plugin phases */
+typedef enum {
+    APEX_PLUGIN_PHASE_PRE_PARSE  = 1 << 0,
+    APEX_PLUGIN_PHASE_BLOCK      = 1 << 1,
+    APEX_PLUGIN_PHASE_INLINE     = 1 << 2,
+    APEX_PLUGIN_PHASE_POST_RENDER= 1 << 3
+} apex_plugin_phase_mask;
+typedef struct apex_plugin_manager apex_plugin_manager;
+/**
+ * Register a new callback plugin.
+ * @return Returns true if the plugin was registered successfully.
+ */
+bool apex_plugin_register(apex_plugin_manager *manager, const char *id, apex_plugin_phase_mask phase, char *(*callback)(const char *text, const char *id_plugin, apex_plugin_phase_mask phase, const struct apex_options *options));
 struct cmark_parser;  /* Opaque; for cmark_init callback. Include cmark-gfm when implementing. */
 /**
@@ -65,6 +96,9 @@ typedef struct apex_options {
     /* Feature flags */
     bool enable_plugins;  /* Enable external/plugin processing */
+    bool allow_external_plugin_detection; /* Enable detection of external plugins */
+    void (*plugin_register)(apex_plugin_manager *manager, const struct apex_options *options); /* Function to register callback plugins */
     bool enable_tables;
     bool enable_footnotes;
     bool enable_definition_lists;
@@ -100,7 +134,7 @@ typedef struct apex_options {
     bool standalone;  /* Generate complete HTML document */
     bool pretty;      /* Pretty-print HTML with indentation */
     bool xhtml;       /* HTML5 output with self-closing void/empty tags (<br />, <meta ... />) */
-    bool strict_xhtml; /* Polyglot XHTML/XML: xmlns, strict Content-Type meta, well-formed void tags (implies xhtml serialization) */
+    bool strict_xhtml; /* Polyglot XHTML/XML: xmlns, strict Content-Type meta with --standalone; void-tag serialization always (implies xhtml). Fragments are not fully validated as XML if raw HTML is ill-formed */
     const char **stylesheet_paths;  /* NULL-terminated array of CSS file paths to link in head */
     size_t stylesheet_count;        /* Number of stylesheets */
     const char *document_title;   /* Title for HTML document */
@@ -109,6 +143,8 @@ 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 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) */
     /* Line break handling */
     bool hardbreaks;  /* Treat newlines as hard breaks (GFM style) */
@@ -249,6 +285,13 @@ typedef struct apex_options {
     void *cmark_user_data; /* User data passed to cmark init/done callback */
 } apex_options;
+/* AST serializers */
+char *apex_cmark_to_markdown(cmark_node *document,
+                             const struct apex_options *options,
+                             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);
 /**
  * Get default options for a specific mode
  */
@@ -265,6 +308,13 @@ 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);
+/**
+ * Resolve a local image path against base_directory (same rules as HTML embedding).
+ * Returns a newly allocated path, or NULL on allocation failure.
+ * Caller must free with free() or apex_free_string.
+ */
+char *apex_resolve_local_image_path(const char *filepath, const char *base_dir);
 /**
  * Wrap HTML content in complete HTML5 document structure
  *

data/ext/apex_ext/apex_src/include/apex/ast_markdown.h CHANGED Viewed

@@ -15,6 +15,8 @@ struct apex_options;
 /**
  * Markdown dialect types
  */
+#ifndef APEX_MARKDOWN_DIALECT_DEFINED
+#define APEX_MARKDOWN_DIALECT_DEFINED
 typedef enum {
     APEX_MD_DIALECT_UNIFIED = 0,      /* Unified-mode compatible */
     APEX_MD_DIALECT_MMD = 1,          /* MultiMarkdown-compatible */
@@ -22,6 +24,7 @@ typedef enum {
     APEX_MD_DIALECT_KRAMDOWN = 3,     /* Kramdown-compatible */
     APEX_MD_DIALECT_GFM = 4           /* GitHub Flavored Markdown */
 } apex_markdown_dialect_t;
+#endif
 /**
  * Serialize a cmark-gfm document node to Markdown

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

@@ -12,5 +12,13 @@ module ApexHeaders {
         header "buffer.h"
         export *
     }
+    explicit module ast_markdown {
+        header "ast_markdown.h"
+        export *
+    }
+    explicit module ast_man {
+        header "ast_man.h"
+        export *
+    }
     export *
 }

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

@@ -0,0 +1,6 @@
+#ifndef APEXC_H
+#define APEXC_H
+#include <apex/apex.h>
+#endif /* APEXC_H */

data/ext/apex_ext/apex_src/include/module.modulemap ADDED Viewed

@@ -0,0 +1,4 @@
+module ApexC {
+  header "apexc.h"
+  export *
+}

data/ext/apex_ext/apex_src/man/apex-config.5 CHANGED Viewed

@@ -219,7 +219,7 @@ A document can override defaults from \fRconfig.yml\f[] or \fR\-\-meta\-file\f[]
 Explicit CLI flags still behave as final overrides where applicable
 .PP
-\f[B]Note:\f[] If \fRmode\f[] is specified in metadata (file or document), Apex resets options to that mode’s defaults before applying other metadata keys, so the mode behaves as if you had passed it on the command line first.
+\f[B]Note:\f[] If \fRmode\f[] is specified in metadata (file or document), Apex resets options to that mode's defaults before applying other metadata keys, so the mode behaves as if you had passed it on the command line first.
 .SH CONFIGURATION KEYS
@@ -396,7 +396,13 @@ Human\-readable language name used for quote styling (e.g. \fRenglish\f[], \fRfr
 \fRcode\-highlight\f[]
 .IP \(bu 2
-External syntax highlighting tool: \fRpygments\f[] (or \fRp\f[]/\fRpyg\f[]), \fRskylighting\f[] (or \fRs\f[]/\fRsky\f[]), or \fRfalse\f[]/\fRnone\f[] to disable
+External syntax highlighting tool: \fRpygments\f[] (or \fRp\f[]/\fRpyg\f[]), \fRskylighting\f[] (or \fRs\f[]/\fRsky\f[]), \fRshiki\f[] (or \fRsh\f[]), or \fRfalse\f[]/\fRnone\f[] to disable
+.IP \(bu 2
+\fRcode\-highlight\-theme\f[] / \fRcode_highlight_theme\f[]
+.IP \(bu 2
+Preferred syntax highlighting theme/style name. Maps to Pygments styles, Skylighting styles, or Shiki themes in both HTML and terminal/ANSI output. Use \fRapex \-\-list\-themes\f[] for an overview of built\-in themes.
 .PP
 You can also use arbitrary keys for your own templates and transforms; Apex simply passes them through to the metadata system so they can be referenced via \fR[%key]\f[] and \fR[%key:transform]\f[].

data/ext/apex_ext/apex_src/man/apex-plugins.7 CHANGED Viewed

@@ -11,7 +11,7 @@ apex\-plugins \- Apex plugin system for extending Markdown processing
 Apex supports a lightweight plugin system that lets you add new syntax and post\-processing behavior without patching the core. Plugins can be small scripts (Ruby, Python, etc.) or simple declarative regex rules defined in YAML.
 .PP
-Plugins are disabled by default so Apex’s performance and behavior are unchanged unless you explicitly opt in.
+Plugins are disabled by default so Apex's performance and behavior are unchanged unless you explicitly opt in.
 .SH ENABLING PLUGINS
@@ -26,7 +26,7 @@ Plugins are disabled by default so Apex’s performance and behavior are unchang
 .SS Metadata keys
 .PP
-In the document’s front matter, any of these keys are recognized (case\-insensitive):
+In the document's front matter, any of these keys are recognized (case\-insensitive):
 .IP \(bu 2
 \fRplugins\f[]
@@ -121,7 +121,7 @@ Good for: custom syntax (e.g. \fRAPEX_LIQUID_TAG_0\f[]), textual rewrites, addin
 Runs on the final HTML output after Apex finishes rendering.
 .IP \(bu 2
-Good for: wrapping elements in spans/divs, adding CSS classes, simple HTML post\-processing (e.g. turning \fR:memo:\f[] into \fR<span>\f[])
+Good for: wrapping elements in spans/divs, adding CSS classes, simple HTML post\-processing (e.g. turning \fR:emoji:\f[] into \fR<span>\f[])
 .PP
 Internally, plugins for each phase are run in a deterministic order:
@@ -141,7 +141,7 @@ Each plugin is defined by a manifest file:
 \f[B]File name\f[]: \fRplugin.yml\f[]
 .IP \(bu 2
-\f[B]Location\f[]: inside the plugin’s directory
+\f[B]Location\f[]: inside the plugin's directory
 .PP
 At minimum, a plugin needs:
@@ -168,7 +168,7 @@ From there, you choose one of two plugin types:
 \f[B]Declarative regex plugin\f[] \- No external code; in\-process regex search/replace. Declared with \fRpattern\f[] and \fRreplacement\f[] fields.
 .PP
-You can’t mix both styles in a single plugin; if \fRhandler.command\f[] is present, the plugin is treated as external.
+You can't mix both styles in a single plugin; if \fRhandler.command\f[] is present, the plugin is treated as external.
 .SS Metadata fields
@@ -262,7 +262,7 @@ If your plugin fails, times out, or prints nothing, Apex will treat it as a no\-
 .SH DECLARATIVE REGEX PLUGINS
 .PP
-For many cases, you don’t need a script at all. A declarative regex plugin uses \fRregex.h\f[] inside Apex for fast in\-process search/replace.
+For many cases, you don't need a script at all. A declarative regex plugin uses \fRregex.h\f[] inside Apex for fast in\-process search/replace.
 .SS Manifest example
@@ -273,7 +273,7 @@ For many cases, you don’t need a script at all. A declarative regex plugin use
 id: emoji\-span
 title: Emoji span wrapper
 author: Brett Terpstra
-description: Wrap :memo: markers in a span for styling
+description: Wrap :emoji: markers in a span for styling
 homepage: https://github.com/ApexMarkdown/apex\-emoji\-plugin
 repo: https://github.com/ApexMarkdown/apex\-emoji\-plugin.git
 phase: post_render
@@ -359,7 +359,7 @@ When Apex runs an external handler plugin, it sets:
 \f[B]\fRAPEX_PLUGIN_DIR\f[]\f[]
 .IP \(bu 2
-Filesystem path to the plugin’s directory (where \fRplugin.yml\f[] lives).
+Filesystem path to the plugin's directory (where \fRplugin.yml\f[] lives).
 .IP \(bu 2
 Useful for loading sidecar files, templates, etc.
@@ -386,7 +386,7 @@ When Apex is invoked on a file, this is the original path that was passed on the
 When Apex reads from stdin, \fRAPEX_FILE_PATH\f[] is set to the current \fRbase_directory\f[] (if one was set) or an empty string.
 .PP
-All of these variables apply only during the external command’s execution and are restored afterward.
+All of these variables apply only during the external command's execution and are restored afterward.
 .SH INSTALLING PLUGINS
@@ -440,7 +440,7 @@ apex \-\-uninstall\-plugin kbd
 .fi
 .PP
-The \fR\-\-uninstall\-plugin\f[] command verifies that the plugin directory exists, prompts for confirmation, and removes the plugin’s directory. Support data under \fR.../apex/support/<plugin\-id>/\f[] is left intact.
+The \fR\-\-uninstall\-plugin\f[] command verifies that the plugin directory exists, prompts for confirmation, and removes the plugin's directory. Support data under \fR.../apex/support/<plugin\-id>/\f[] is left intact.
 .PP
 This command only works for plugins installed in the user plugin directory. Project\-local plugins (in \fR.apex/plugins/\f[]) must be removed manually.
@@ -491,10 +491,10 @@ handler:
 .PP
 The Ruby script reads JSON from stdin, extracts \fRtext\f[], replaces each \fRAPEX_LIQUID_TAG_6\f[] occurrence with properly formatted \fR<kbd>\f[] HTML, and prints the full transformed text to stdout.
-.SS Example: \fR:memo:\f[] span plugin (declarative)
+.SS Example: \fR:emoji:\f[] span plugin (declarative)
 .PP
-This plugin turns \fR:memo:\f[] tokens in the final HTML into \fR<span class="emoji">:memo:</span>\f[].
+This plugin turns \fR:emoji:\f[] tokens in the final HTML into \fR<span class="emoji">:emoji:</span>\f[].
 .SS \fRplugin.yml\f[]
@@ -505,7 +505,7 @@ This plugin turns \fR:memo:\f[] tokens in the final HTML into \fR<span class="em
 id: emoji\-span
 title: Emoji span wrapper
 author: Brett Terpstra
-description: Wrap :memo: markers in a span for styling
+description: Wrap :emoji: markers in a span for styling
 homepage: https://github.com/ApexMarkdown/apex\-emoji\-plugin
 repo: https://github.com/ApexMarkdown/apex\-emoji\-plugin.git
 phase: post_render