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

apex-ruby 1.0.6

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

data/ext/apex_ext/apex_src/man/apex.1.new ADDED Viewed

@@ -0,0 +1,338 @@
+.\" Automatically generated by Pandoc 3.6.3
+.\"
+.TH "APEX" "1" "December 2025" ""
+.SH NAME
+apex \- Unified Markdown processor supporting CommonMark, GFM,
+MultiMarkdown, and Kramdown
+.SH SYNOPSIS
+\f[B]apex\f[R] [\f[I]options\f[R]] [\f[I]file\f[R]]
+.SH DESCRIPTION
+Apex is a unified Markdown processor that combines the best features
+from CommonMark, GitHub Flavored Markdown (GFM), MultiMarkdown,
+Kramdown, and Marked.
+One processor to rule them all.
+.PP
+If no file is specified, \f[B]apex\f[R] reads from stdin.
+.SH OPTIONS
+.SS Processing Modes
+.TP
+\f[B]\-m\f[R] \f[I]MODE\f[R], \f[B]\[en]mode\f[R] \f[I]MODE\f[R]
+Processor mode: \f[B]commonmark\f[R], \f[B]gfm\f[R], \f[B]mmd\f[R] (or
+\f[B]multimarkdown\f[R]), \f[B]kramdown\f[R], or \f[B]unified\f[R]
+(default).
+Each mode enables different features and syntax compatibility.
+.SS Input/Output
+.TP
+\f[B]\-o\f[R] \f[I]FILE\f[R], \f[B]\[en]output\f[R] \f[I]FILE\f[R]
+Write output to \f[I]FILE\f[R] instead of stdout.
+.TP
+\f[B]\-s\f[R], \f[B]\[en]standalone\f[R]
+Generate complete HTML document with \f[CR]<html>\f[R],
+\f[CR]<head>\f[R], and \f[CR]<body>\f[R] tags.
+.TP
+\f[B]\[en]style\f[R] \f[I]FILE\f[R]
+Link to CSS file in document head (requires \f[B]\[en]standalone\f[R]).
+.TP
+\f[B]\[en]title\f[R] \f[I]TITLE\f[R]
+Document title (requires \f[B]\[en]standalone\f[R], default:
+\[lq]Document\[rq]).
+.TP
+\f[B]\[en]pretty\f[R]
+Pretty\-print HTML with indentation and whitespace.
+.SS Feature Flags
+.TP
+\f[B]\[en]accept\f[R]
+Accept all Critic Markup changes (apply edits).
+.TP
+\f[B]\[en]reject\f[R]
+Reject all Critic Markup changes (revert edits).
+.TP
+\f[B]\[en]enable\-includes\f[R]
+Enable file inclusion.
+.TP
+\f[B]\[en]meta\-file\f[R] \f[I]FILE\f[R]
+Load metadata from an external file.
+Auto\-detects format: YAML (starts with \f[CR]\-\-\-\f[R]),
+MultiMarkdown (key: value pairs), or Pandoc (starts with \f[CR]%\f[R]).
+Metadata from the file is merged with document metadata, with document
+metadata taking precedence.
+.TP
+\f[B]\[en]meta\f[R] \f[I]KEY=VALUE\f[R]
+Set a metadata key\-value pair.
+Can be used multiple times.
+Supports comma\-separated pairs (e.g.,
+\f[CR]\-\-meta KEY1=value1,KEY2=value2\f[R]).
+Values can be quoted to include spaces and special characters.
+Command\-line metadata takes precedence over both file and document
+metadata.
+.TP
+\f[B]\[en]hardbreaks\f[R]
+Treat newlines as hard breaks.
+.TP
+\f[B]\[en]no\-footnotes\f[R]
+Disable footnote support.
+.TP
+\f[B]\[en]no\-math\f[R]
+Disable math support.
+.TP
+\f[B]\[en]no\-smart\f[R]
+Disable smart typography.
+.TP
+\f[B]\[en]no\-tables\f[R]
+Disable table support.
+.TP
+\f[B]\[en]no\-ids\f[R]
+Disable automatic header ID generation.
+.TP
+\f[B]\[en]header\-anchors\f[R]
+Generate \f[CR]<a>\f[R] anchor tags instead of header IDs.
+.TP
+\f[B]\[en]wikilinks\f[R], \f[B]\[en]no\-wikilinks\f[R]
+Enable wiki link syntax \f[CR][[PageName]]\f[R].
+Default: disabled.
+.SS Header ID Format
+.TP
+\f[B]\[en]id\-format\f[R] \f[I]FORMAT\f[R]
+Header ID format: \f[B]gfm\f[R] (default), \f[B]mmd\f[R], or
+\f[B]kramdown\f[R].
+Modes auto\-set format; use this to override in unified mode.
+.SS List Options
+.TP
+\f[B]\[en]alpha\-lists\f[R], \f[B]\[en]no\-alpha\-lists\f[R]
+Support alpha list markers (a., b., c.\ and A., B., C.).
+.TP
+\f[B]\[en]mixed\-lists\f[R], \f[B]\[en]no\-mixed\-lists\f[R]
+Allow mixed list markers at same level (inherit type from first item).
+.SS Table Options
+.TP
+\f[B]\[en]relaxed\-tables\f[R], \f[B]\[en]no\-relaxed\-tables\f[R]
+Enable relaxed table parsing (no separator rows required).
+Default: enabled in unified/kramdown modes, disabled in
+commonmark/gfm/multimarkdown modes.
+.SS HTML and Links
+.TP
+\f[B]\[en]unsafe\f[R], \f[B]\[en]no\-unsafe\f[R]
+Allow raw HTML in output.
+Default: true for unified/mmd/kramdown modes, false for commonmark/gfm
+modes.
+.TP
+\f[B]\[en]autolink\f[R], \f[B]\[en]no\-autolink\f[R]
+Enable autolinking of URLs and email addresses.
+Default: enabled in GFM, MultiMarkdown, Kramdown, and unified modes;
+disabled in CommonMark mode.
+.TP
+\f[B]\[en]obfuscate\-emails\f[R]
+Obfuscate email links and text using HTML entities (hex\-encoded).
+.SS Image Embedding
+.TP
+\f[B]\[en]embed\-images\f[R]
+Embed local images as base64 data URLs in HTML output.
+Only local images (file paths) are embedded; remote images (http://,
+https://) are not processed.
+Images are read from the filesystem and encoded as base64 data URLs
+(e.g., \f[CR]data:image/png;base64,...\f[R]).
+Relative paths are resolved using the base directory (see
+\f[B]\[en]base\-dir\f[R]).
+.SS Path Resolution
+.TP
+\f[B]\[en]base\-dir\f[R] \f[I]DIR\f[R]
+Base directory for resolving relative paths.
+Used for: \- Image embedding (with \f[B]\[en]embed\-images\f[R]) \- File
+includes/transclusions \- Relative path resolution when reading from
+stdin or when the working directory differs from the document location
+.RS
+.PP
+If not specified and reading from a file, the base directory is
+automatically set to the input file\[cq]s directory.
+When reading from stdin, this flag must be used to resolve relative
+paths.
+.RE
+.SS Superscript/Subscript
+.TP
+\f[B]\[en]sup\-sub\f[R], \f[B]\[en]no\-sup\-sub\f[R]
+Enable MultiMarkdown\-style superscript and subscript syntax.
+The \f[CR]\[ha]\f[R] character creates superscript for the text
+immediately following it (stops at space or punctuation).
+The \f[CR]\[ti]\f[R] character creates subscript when used within a
+word/identifier (e.g., \f[CR]H\[ti]2\[ti]O\f[R] creates H₂O).
+When tildes are at word boundaries (e.g., \f[CR]\[ti]text\[ti]\f[R]),
+they create underline instead.
+Default: enabled in unified and MultiMarkdown modes.
+.SS Citations and Bibliography
+.TP
+\f[B]\[en]bibliography\f[R] \f[I]FILE\f[R]
+Bibliography file in BibTeX, CSL JSON, or CSL YAML format.
+Can be specified multiple times to load multiple bibliography files.
+Citations are automatically enabled when this option is used.
+Bibliography can also be specified in document metadata.
+.TP
+\f[B]\[en]csl\f[R] \f[I]FILE\f[R]
+Citation Style Language (CSL) file for formatting citations and
+bibliography.
+Citations are automatically enabled when this option is used.
+CSL file can also be specified in document metadata.
+.TP
+\f[B]\[en]no\-bibliography\f[R]
+Suppress bibliography output even when citations are present.
+.TP
+\f[B]\[en]link\-citations\f[R]
+Link citations to their corresponding bibliography entries.
+Citations will include \f[CR]href\f[R] attributes pointing to the
+bibliography entry.
+.TP
+\f[B]\[en]show\-tooltips\f[R]
+Show tooltips on citations when hovering (requires CSS support).
+.PP
+Citation syntax is supported in MultiMarkdown and unified modes: \-
+Pandoc: \f[CR][\[at]key]\f[R], \f[CR][\[at]key1; \[at]key2]\f[R],
+\f[CR]\[at]key\f[R] \- MultiMarkdown: \f[CR][#key]\f[R] \- mmark:
+\f[CR][\[at]RFC1234]\f[R]
+.PP
+Bibliography is inserted at the \f[CR]<!\-\- REFERENCES \-\->\f[R]
+marker or appended to the end of the document if no marker is found.
+.SS General Options
+.TP
+\f[B]\-h\f[R], \f[B]\[en]help\f[R]
+Show help message and exit.
+.TP
+\f[B]\-v\f[R], \f[B]\[en]version\f[R]
+Show version information and exit.
+.SH EXAMPLES
+Process a markdown file:
+.IP
+.EX
+apex input.md
+.EE
+.PP
+Output to a file:
+.IP
+.EX
+apex input.md \-o output.html
+.EE
+.PP
+Generate standalone HTML document:
+.IP
+.EX
+apex input.md \-\-standalone \-\-title \[dq]My Document\[dq]
+.EE
+.PP
+Pretty\-print HTML output:
+.IP
+.EX
+apex input.md \-\-pretty
+.EE
+.PP
+Use GFM mode:
+.IP
+.EX
+apex input.md \-\-mode gfm
+.EE
+.PP
+Process document with citations and bibliography:
+.IP
+.EX
+apex document.md \-\-bibliography refs.bib
+.EE
+.PP
+Use metadata to specify bibliography:
+.IP
+.EX
+apex document.md
+.EE
+.PP
+(With bibliography specified in YAML front matter)
+.PP
+Use Kramdown mode with relaxed tables:
+.IP
+.EX
+apex input.md \-\-mode kramdown
+.EE
+.PP
+Process from stdin:
+.IP
+.EX
+echo \[dq]# Hello\[dq] | apex
+.EE
+.SH PROCESSING MODES
+.TP
+\f[B]commonmark\f[R]
+Pure CommonMark specification.
+Minimal features, maximum compatibility.
+.TP
+\f[B]gfm\f[R]
+GitHub Flavored Markdown.
+Includes tables, strikethrough, task lists, autolinks, and more.
+.TP
+\f[B]mmd\f[R], \f[B]multimarkdown\f[R]
+MultiMarkdown compatibility.
+Includes metadata, definition lists, footnotes, and more.
+.TP
+\f[B]kramdown\f[R]
+Kramdown compatibility.
+Includes relaxed tables, IAL (Inline Attribute Lists), and more.
+.TP
+\f[B]unified\f[R] (default)
+All features enabled.
+Combines features from all modes.
+.SH FEATURES
+Apex supports a wide range of Markdown extensions:
+.IP \[bu] 2
+\f[B]Tables\f[R]: GFM\-style tables with alignment
+.IP \[bu] 2
+\f[B]Footnotes\f[R]: Reference\-style footnotes
+.IP \[bu] 2
+\f[B]Math\f[R]: Inline (\f[CR]$...$\f[R]) and display
+(\f[CR]$$...$$\f[R]) math with LaTeX
+.IP \[bu] 2
+\f[B]Wiki Links\f[R]: \f[CR][[Page]]\f[R], \f[CR][[Page|Display]]\f[R],
+\f[CR][[Page#Section]]\f[R]
+.IP \[bu] 2
+\f[B]Critic Markup\f[R]: All 5 types ({++add++}, {\[en]del\[en]},
+{[STRIKEOUT:sub]}, {==mark==}, {>>comment<<})
+.IP \[bu] 2
+\f[B]Smart Typography\f[R]: Smart quotes, dashes, ellipsis
+.IP \[bu] 2
+\f[B]Definition Lists\f[R]: MultiMarkdown\-style definition lists
+.IP \[bu] 2
+\f[B]Task Lists\f[R]: GFM\-style task lists
+.IP \[bu] 2
+\f[B]Metadata\f[R]: YAML front matter, MultiMarkdown metadata, Pandoc
+title blocks
+.IP \[bu] 2
+\f[B]Metadata Transforms\f[R]: Transform metadata values with
+\f[CR][%key:transform]\f[R] syntax (case conversion, string
+manipulation, regex replacement, date formatting, etc.)
+.IP \[bu] 2
+\f[B]Header IDs\f[R]: Automatic or manual header IDs with multiple
+format options
+.IP \[bu] 2
+\f[B]Relaxed Tables\f[R]: Support for tables without separator rows
+(Kramdown\-style)
+.IP \[bu] 2
+\f[B]Superscript/Subscript\f[R]: MultiMarkdown\-style superscript
+(\f[CR]\[ha]text\f[R]) and subscript (\f[CR]\[ti]text\[ti]\f[R] within
+words) syntax.
+Subscript uses paired tildes within word boundaries (e.g.,
+\f[CR]H\[ti]2\[ti]O\f[R]), while tildes at word boundaries create
+underline
+.IP \[bu] 2
+\f[B]Image Embedding\f[R]: Embed local images as base64 data URLs with
+\f[CR]\-\-embed\-images\f[R] flag
+.SH SEE ALSO
+For complete documentation, see the \c
+.UR https://github.com/ttscoff/apex/wiki
+Apex Wiki
+.UE \c
+\&.
+.SH AUTHOR
+Brett Terpstra
+.SH COPYRIGHT
+Copyright (c) 2025 Brett Terpstra.
+Licensed under MIT License.
+.SH BUGS
+Report bugs at \c
+.UR https://github.com/ttscoff/apex/issues
+.UE \c
+\&.
+.SH AUTHORS
+Brett Terpstra.

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

@@ -0,0 +1,237 @@
+/**
+ * Apex.swift
+ * Swift API wrapper for Apex Markdown processor
+ * Provides idiomatic Swift interface over the Objective-C API
+ */
+import Foundation
+@_exported import ApexObjC
+/// Apex processor mode
+/// Type-safe enum for processor modes
+public enum ApexMode: String, CaseIterable {
+    case commonmark = "commonmark"
+    case gfm = "gfm"
+    case multimarkdown = "multimarkdown"
+    case kramdown = "kramdown"
+    case unified = "unified"
+    /// Convert to NSString for Objective-C API
+    internal var nsString: NSString {
+        return self.rawValue as NSString
+    }
+}
+/// Apex conversion options
+/// Swift struct for configuring conversion options
+public struct ApexOptions {
+    /// Pretty-print HTML with indentation
+    public var pretty: Bool = false
+    /// Generate complete HTML5 document
+    public var standalone: Bool = false
+    /// Path to CSS file to link in document head
+    public var stylesheet: String? = nil
+    /// Document title
+    public var title: String? = nil
+    /// Treat newlines as hard breaks
+    public var hardBreaks: Bool = false
+    /// Generate IDs for headers
+    public var generateHeaderIDs: Bool = false
+    /// Allow raw HTML in output
+    public var unsafe: Bool = false
+    /// Generate anchor tags instead of header IDs
+    public var headerAnchors: Bool = false
+    /// Obfuscate email links using HTML entities
+    public var obfuscateEmails: Bool = false
+    /// Embed local images as base64 data URLs
+    public var embedImages: Bool = false
+    /// Default initializer
+    public init() {}
+    /// Default options
+    public static let `default` = ApexOptions()
+    /// Convert to NSDictionary for Objective-C API
+    internal func toDictionary() -> [String: Any] {
+        var dict: [String: Any] = [:]
+        if pretty {
+            dict["pretty"] = true
+        }
+        if standalone {
+            dict["standalone"] = true
+        }
+        if let stylesheet = stylesheet {
+            dict["stylesheet"] = stylesheet
+        }
+        if let title = title {
+            dict["title"] = title
+        }
+        if hardBreaks {
+            dict["hardBreaks"] = true
+        }
+        if generateHeaderIDs {
+            dict["generateHeaderIDs"] = true
+        }
+        if unsafe {
+            dict["unsafe"] = true
+        }
+        if headerAnchors {
+            dict["headerAnchors"] = true
+        }
+        if obfuscateEmails {
+            dict["obfuscateEmails"] = true
+        }
+        if embedImages {
+            dict["embedImages"] = true
+        }
+        return dict
+    }
+}
+/// String extension for Apex Markdown conversion
+/// Provides idiomatic Swift API
+extension String {
+    /**
+     * Convert Markdown to HTML using Apex in unified mode
+     */
+    public func apexHTML() -> String {
+        return (self as NSString).apexHTML() as String
+    }
+    /**
+     * Convert Markdown to HTML using Apex with specific mode
+     */
+    public func apexHTML(mode: ApexMode) -> String {
+        return (self as NSString).apexHTML(withMode: mode.rawValue) as String
+    }
+    /**
+     * Convert Markdown to HTML using Apex with mode and options
+     */
+    public func apexHTML(mode: ApexMode = .unified, options: ApexOptions = .default) -> String {
+        let dict = options.toDictionary()
+        if dict.isEmpty {
+            // No options, use simple method
+            return (self as NSString).apexHTML(withMode: mode.rawValue)
+        } else {
+            // Use dictionary-based method
+            return NSString.convert(
+                withApex: self, mode: mode.rawValue, options: dict)
+        }
+    }
+    /**
+     * Convert Markdown to HTML using Apex with standalone document options
+     */
+    public func apexHTML(
+        mode: ApexMode = .unified, standalone: Bool, stylesheet: String? = nil, title: String? = nil
+    ) -> String {
+        return NSString.convert(
+            withApex: self,
+            mode: mode.rawValue,
+            standalone: standalone,
+            stylesheet: stylesheet,
+            title: title
+        )
+    }
+    /**
+     * Convert Markdown to HTML using Apex with pretty printing
+     * Convenience method for pretty-printing only
+     */
+    public func apexHTML(pretty: Bool, mode: ApexMode = .unified) -> String {
+        return NSString.convert(withApex: self, mode: mode.rawValue, pretty: pretty)
+    }
+    /**
+     * Convert Markdown to HTML using Apex with common options
+     */
+    public func apexHTML(
+        mode: ApexMode = .unified,
+        generateHeaderIDs: Bool,
+        hardBreaks: Bool,
+        pretty: Bool
+    ) -> String {
+        return NSString.convert(
+            withApex: self,
+            mode: mode.rawValue,
+            generateHeaderIDs: generateHeaderIDs,
+            hardBreaks: hardBreaks,
+            pretty: pretty
+        )
+    }
+}
+/// Static Apex converter
+/// Provides static methods for conversion
+public struct Apex {
+    /**
+     * Convert Markdown to HTML using Apex in unified mode
+     */
+    public static func convert(_ markdown: String) -> String {
+        return markdown.apexHTML()
+    }
+    /**
+     * Convert Markdown to HTML using Apex with specific mode
+     */
+    public static func convert(_ markdown: String, mode: ApexMode) -> String {
+        return markdown.apexHTML(mode: mode)
+    }
+    /**
+     * Convert Markdown to HTML using Apex with mode and options
+     */
+    public static func convert(
+        _ markdown: String, mode: ApexMode = .unified, options: ApexOptions = .default
+    ) -> String {
+        return markdown.apexHTML(mode: mode, options: options)
+    }
+    /**
+     * Convert Markdown to HTML using Apex with standalone document options
+     */
+    public static func convert(
+        _ markdown: String, mode: ApexMode = .unified, standalone: Bool, stylesheet: String? = nil,
+        title: String? = nil
+    ) -> String {
+        return markdown.apexHTML(
+            mode: mode, standalone: standalone, stylesheet: stylesheet, title: title)
+    }
+    /**
+     * Convert Markdown to HTML using Apex with pretty printing
+     */
+    public static func convert(_ markdown: String, pretty: Bool, mode: ApexMode = .unified)
+        -> String
+    {
+        return markdown.apexHTML(pretty: pretty, mode: mode)
+    }
+    /**
+     * Convert Markdown to HTML using Apex with common options
+     */
+    public static func convert(
+        _ markdown: String,
+        mode: ApexMode = .unified,
+        generateHeaderIDs: Bool,
+        hardBreaks: Bool,
+        pretty: Bool
+    ) -> String {
+        return markdown.apexHTML(
+            mode: mode, generateHeaderIDs: generateHeaderIDs, hardBreaks: hardBreaks, pretty: pretty
+        )
+    }
+}

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

@@ -0,0 +1,117 @@
+/**
+ * NSString+Apex.h
+ * Objective-C category for integrating Apex Markdown processor into Marked
+ */
+#import <Foundation/Foundation.h>
+NS_ASSUME_NONNULL_BEGIN
+/**
+ * Apex mode constants for use with convertWithApex:mode:
+ */
+extern NSString * const ApexModeCommonmark;
+extern NSString * const ApexModeGFM;
+extern NSString * const ApexModeMultiMarkdown;
+extern NSString * const ApexModeKramdown;
+extern NSString * const ApexModeUnified;
+@interface NSString (Apex)
+/**
+ * Convert Markdown to HTML using Apex processor in unified mode
+ * @param inputString The markdown text to convert
+ * @return HTML string
+ */
++ (NSString *)convertWithApex:(NSString *)inputString;
+/**
+ * Convert Markdown to HTML using Apex with specific processor mode
+ * @param inputString The markdown text to convert
+ * @param mode Processor mode: Use ApexMode* constants (ApexModeCommonmark, ApexModeGFM, ApexModeMultiMarkdown, ApexModeKramdown, or ApexModeUnified) or string values: "commonmark", "gfm", "multimarkdown", "kramdown", or "unified"
+ * @return HTML string
+ */
++ (NSString *)convertWithApex:(NSString *)inputString mode:(NSString *)mode;
+/**
+ * Convert Markdown to HTML using Apex with standalone document options
+ * @param inputString The markdown text to convert
+ * @param mode Processor mode: Use ApexMode* constants or string values
+ * @param standalone If YES, generates a complete HTML5 document
+ * @param stylesheetPath Optional path to CSS file to link in document head (nil for none)
+ * @param title Optional document title (nil for default)
+ * @return HTML string (complete document if standalone is YES)
+ */
++ (NSString *)convertWithApex:(NSString *)inputString
+                         mode:(NSString *)mode
+                   standalone:(BOOL)standalone
+                    stylesheet:(NSString * _Nullable)stylesheetPath
+                         title:(NSString * _Nullable)title;
+/**
+ * Convert Markdown to HTML using Apex with pretty printing option
+ * @param inputString The markdown text to convert
+ * @param mode Processor mode: Use ApexMode* constants or string values
+ * @param pretty If YES, pretty-prints HTML with indentation
+ * @return HTML string
+ */
++ (NSString *)convertWithApex:(NSString *)inputString
+                         mode:(NSString *)mode
+                        pretty:(BOOL)pretty;
+/**
+ * Convert Markdown to HTML using Apex with dictionary-based options
+ * @param inputString The markdown text to convert
+ * @param mode Processor mode: Use ApexMode* constants or string values
+ * @param options Dictionary of option keys and values. Supported keys:
+ *   - @"pretty": NSNumber (BOOL) - Pretty-print HTML
+ *   - @"standalone": NSNumber (BOOL) - Generate complete HTML document
+ *   - @"stylesheet": NSString - Path to CSS file
+ *   - @"title": NSString - Document title
+ *   - @"hardBreaks": NSNumber (BOOL) - Treat newlines as hard breaks
+ *   - @"generateHeaderIDs": NSNumber (BOOL) - Generate IDs for headers
+ *   - @"unsafe": NSNumber (BOOL) - Allow raw HTML
+ *   - @"headerAnchors": NSNumber (BOOL) - Generate anchor tags instead of IDs
+ *   - @"obfuscateEmails": NSNumber (BOOL) - Obfuscate email links
+ *   - @"embedImages": NSNumber (BOOL) - Embed images as base64 data URLs
+ * @return HTML string
+ */
++ (NSString *)convertWithApex:(NSString *)inputString
+                         mode:(NSString *)mode
+                    options:(NSDictionary<NSString *, id> * _Nullable)options;
+/**
+ * Convert Markdown to HTML using Apex with common options combined
+ * Swift-friendly method that combines frequently used options
+ * @param inputString The markdown text to convert
+ * @param mode Processor mode: Use ApexMode* constants or string values
+ * @param generateHeaderIDs If YES, generates IDs for headers
+ * @param hardBreaks If YES, treats newlines as hard breaks
+ * @param pretty If YES, pretty-prints HTML with indentation
+ * @return HTML string
+ */
++ (NSString *)convertWithApex:(NSString *)inputString
+                         mode:(NSString *)mode
+              generateHeaderIDs:(BOOL)generateHeaderIDs
+                    hardBreaks:(BOOL)hardBreaks
+                        pretty:(BOOL)pretty;
+/**
+ * Convert this string (as Markdown) to HTML using Apex in unified mode
+ * Instance method for convenient usage on NSString objects
+ * @return HTML string
+ */
+- (NSString *)apexHTML;
+/**
+ * Convert this string (as Markdown) to HTML using Apex with specific mode
+ * Instance method for convenient usage on NSString objects
+ * @param mode Processor mode: Use ApexMode* constants or string values
+ * @return HTML string
+ */
+- (NSString *)apexHTMLWithMode:(NSString *)mode;
+@end
+NS_ASSUME_NONNULL_END