apex-ruby 1.0.6

data/ext/apex_ext/apex_src/tests/fixtures/metadata_options.yml

@@ -0,0 +1,11 @@
+---
+indices: false
+wikilinks: true
+pretty: true
+standalone: true
+title: Test Document from File
+csl: test.csl
+id-format: kramdown
+link-citations: true
+suppress-bibliography: false
+---

data/ext/apex_ext/apex_src/tests/fixtures/output/gfm_header_id_test.md

@@ -0,0 +1,96 @@
+# Basic Heading
+
+## Heading with Spaces
+
+### Multiple   Spaces   Here
+
+#### Heading-with-dash
+
+##### Heading_with_underscore
+
+###### Heading.with.dots
+
+# Leading Space Test
+
+## Trailing Space Test
+
+### Mixed Case Heading
+
+#### ALL CAPS HEADING
+
+# Punctuation Test, Here!
+
+## More Punctuation: Colons; Semicolons?
+
+### Special Characters @#$%^&*
+
+#### Parentheses (and brackets) [test]
+
+##### Quotes "double" and 'single'
+
+###### Backticks `code` in heading
+
+# Em Dash — Test
+
+## En Dash – Test
+
+### Mixed Dashes — and – here
+
+# Diacritics Émoji Support
+
+## More Diacritics: Café, naïve, résumé
+
+### Accented Characters: àáâãäå
+
+#### Cyrillic: Привет
+
+##### Chinese: 你好
+
+###### Japanese: こんにちは
+
+# Numbers 123 in Heading
+
+## Math Symbols: 2+2=4
+
+### Currency: $100, €50, £25
+
+# Leading Dash -Test
+
+## Trailing Dash Test-
+
+### Multiple Dashes -- Here
+
+#### Triple Dash --- Test
+
+# Empty After Processing
+
+## !@#$%^&*()
+
+### Only Special Characters
+
+# Very Long Heading That Should Still Generate a Valid ID Even When It Contains Many Words and Characters
+
+## Heading with URL: https://example.com/path
+
+### Email in heading: user@example.com
+
+# Heading with Markdown *bold* and _italic_
+
+## Heading with `code` span
+
+### Heading with [link](url)
+
+#### Heading with ![image](img.png)
+
+# Heading with HTML <tag>
+
+## Mixed: Heading—with—dashes and spaces
+
+### Complex: Hello, World! (Test) [2024]
+
+#### Edge Case:   Multiple   Spaces   Everywhere
+
+##### Another: Test---Multiple---Dashes
+
+###### Final: Special@#$%Chars
+

data/ext/apex_ext/apex_src/tests/fixtures/output/test_citations.md

@@ -0,0 +1,43 @@
+---
+title: Test Document with Citations
+bibliography: test_refs.bib
+---
+
+# Test Document with Citations
+
+This is a test document with various citation styles.
+
+## Pandoc Citations
+
+Blah blah [@doe99; @smith2000; @smith2004].
+
+See @doe99, pp. 33-35 and *passim*.
+
+Smith says blah [-@smith04].
+
+@smith04 says blah.
+
+@smith04 [p. 33] says blah.
+
+## MultiMarkdown Citations
+
+This is a statement that should be attributed to its
+source[p. 23][#Doe:2006].
+
+This is a statement that should be attributed to its
+source[][#Doe:2006].
+
+As per Doe.[#John Doe. *A Totally Fake Book 1*. Vanity
+Press, 2006.]
+
+## mmark Citations
+
+This references [@RFC2535] and [@!RFC1034] (normative).
+
+Multiple citations: [@RFC1034;@RFC1035].
+
+Combined reference: [@RFC1034@STD3].
+
+## References Section
+
+<!-- REFERENCES -->

data/ext/apex_ext/apex_src/tests/fixtures/output/test_def_list_links.md

@@ -0,0 +1,12 @@
+Term with [inline link](https://example.com)
+: Definition with inline link
+
+Term with [reference link][ref]
+: Definition with reference link
+
+[ref]: https://example.com "Reference title"
+
+Term with [shortcut reference][]
+: Definition with shortcut reference
+
+[shortcut reference]: https://example.org

data/ext/apex_ext/apex_src/tests/fixtures/output/test_index_mmark.md

@@ -0,0 +1,53 @@
+# Test Document with mmark Index Syntax
+
+This is a test document to demonstrate mmark index syntax.
+
+## Introduction
+
+This document contains various topics that will be indexed.
+We have protocols (!Protocol) and implementations
+(!Implementation).
+
+## Section on HTTP
+
+HTTP (!HTTP) is a protocol (!Protocol) used for web
+communication. The HTTP protocol (!Protocol) has several
+versions.
+
+### HTTP/1.1
+
+HTTP/1.1 (!HTTP, HTTP/1.1) is a common version of the
+protocol (!Protocol).
+
+### HTTP/2
+
+HTTP/2 (!HTTP, HTTP/2) introduced multiplexing.
+
+## Section on Security
+
+Security (!Security) is important. We discuss encryption
+(!Encryption) and authentication (!Authentication).
+
+### Encryption Methods
+
+Symmetric encryption (!Encryption, Symmetric) uses the same
+key for encryption and decryption.
+
+Asymmetric encryption (!Encryption, Asymmetric) uses
+different keys.
+
+## Primary Index Entry
+
+This section discusses the primary topic (!!Primary Topic,
+Sub Topic).
+
+## Section-Level Index
+
+(!Section Index Entry)
+
+This entire section should be indexed as "Section Index
+Entry".
+
+## Conclusion
+
+This concludes our test of index syntax.

data/ext/apex_ext/apex_src/tests/fixtures/output/test_index_textindex.md

@@ -0,0 +1,37 @@
+# Test Document with TextIndex Syntax
+
+This is a test document to demonstrate TextIndex syntax.
+
+## Introduction
+
+Most mechanical keyboard firmware{^} supports the use of
+[key combinations]{^}.
+
+## Protocols
+
+HTTP{^} is a protocol{^} used for web communication. The
+HTTP protocol{^} has several versions.
+
+### HTTP/1.1
+
+HTTP/1.1{^} is a common version of the protocol{^}.
+
+### HTTP/2
+
+HTTP/2{^} introduced multiplexing.
+
+## Security
+
+Security{^} is important. We discuss encryption{^} and
+authentication{^}.
+
+### Encryption Methods
+
+Symmetric encryption{^} uses the same key for encryption and
+decryption.
+
+Asymmetric encryption{^} uses different keys.
+
+## Conclusion
+
+This concludes our test of TextIndex syntax.

data/ext/apex_ext/apex_src/tests/fixtures/tables/advanced_tables_test.md

@@ -0,0 +1,93 @@
+This table uses Pandoc captions and attributes
+
+| Key | Value |
+| --- | :---: |
+| one |   1   |
+| two |   2   |
+
+: Key value table {:.testing}
+
+
+
+This table combines both rowspan and colspan features:
+
+[Employee Performance Q4 2025]
+| Department  | Employee | Q1-Q2 Average | Q3     | Q4  | Overall |
+| ----------- | -------- | ------------- | ------ | --- | ------- |
+| Engineering | Alice    | 93.5          | 94     | 96  | 94.25   |
+| ^^          | Bob      | 89.0          | 87     | 91  | 89.00   |
+| Marketing   | Charlie  | 92.0          | Absent |     | 92.00   |
+| Sales       | Diana    | 87.5          | 88     | 90  | 88.50   |
+| ^^          | Eve      | 93.0          | 95     | 93  | 93.50   |
+{: .performance-table #q4-results}
+
+More colspan testing:
+
+|       | This    | Has   | Colspans       |
+| ----: | ------- | ----- | -------------- |
+| row 1 |         | blank | cell           |
+| row 2 | colspan |||
+| row 3 | cell    || ← colspan |
+| row 4 | forced colspan | << | &larr; colspan |
+| row 5 | raw \<< | \<< | No colspan |
+
+: Just some colspan testing
+
+---
+
+Use `^^` to merge cells vertically (rowspan):
+
+| Name  | Department  | Project  | Status |
+| ----- | ----------- | -------- | ------ |
+| Frank | Malarkey    | Alpha    | Active |
+| ^^    | ^^          | Beta     | ^^     |
+| ^^    | ^^          | Gamma    | ^^     |
+| Ron   | Advertising | Campaign | Active |
+| Chuck | Hooliganism | Q4       | Active |
+
+---
+
+
+| Department  | Employee | Q1-Q2 Average | Q3      | Q4      | Overall   |
+| ----------- | -------- | ------------- | ------- | ------- | --------- |
+| Engineering | Alice    | 93.5          | 94      | 96      | 94.25     |
+| Foogling    | Jake     | 60.3          | 20      | 20      | 30.1      |
+| boggling    | 24       |               |         |         |           |
+| =====       | =======  | =========     | =====   | ======= | ========= |
+| footer      | row      | with          | colspan |         |           |
+
+[colspans]
+| header |      |      |
+| ------ | ---- | ---- |
+| data   | data | data |
+| data   | data | data |
+| ====   | ===  | ===  |
+| footer |      |      |
+
+
+| h1  |  h2   | h3  |
+| --- | :---: | --- |
+| d1  |  d2   | d3  |
+| d1  |  d2   | d3  |
+| === |  ===  | === |
+| d-4 |  d-5  | d-6 |
+[table with footer]
+
+| h1  | h2 asdfasdf asdf | h3  |
+| --- | :--------------: | --- |
+| d1  |       : d2       | d3  |
+| d1  |       d2 :       | d3  |
+
+Table: Table with Pandoc caption
+
+
+| ----: | :-----: | :----- |
+| aa | bb | cc |
+| 1     | 2       | 3      |
+
+Table: Table without header row
+
+[Relaxed table]
+| a      | b      | c      |
+| 1d | 2b | 3c |
+| data 1 | data 2 | data 3 |

data/ext/apex_ext/apex_src/tests/fixtures/tables/inline_tables_test.md

@@ -0,0 +1,38 @@
+# Inline Tables Test
+
+Regular paragraph before.
+
+```table
+header 1,header 2,header 3
+data 1,data 2,data 3
+,,data 2c
+
+```
+
+Paragraph between.
+
+```table
+col1\tcol2\tcol3
+val1\tval2\tval3
+
+```
+
+```table
+this is not,actually a table header
+but has no delimiter on second line
+
+```
+
+<!--TABLE-->
+one,two,three
+four,five,six
+
+<!--TABLE-->
+alpha\tbeta\tgamma
+delta\tepsilon\tzeta
+
+<!--TABLE-->
+
+No data here; should be unchanged.
+
+

data/ext/apex_ext/apex_src/tests/fixtures/tables/relaxed-table.md

@@ -0,0 +1,12 @@
+| one | two |
+| 1 | 2 |
+
+
+one | two | three
+1 | 2 | 3
+
+A paragraph containing just one | symbol.
+
+| one | two |
+|-----|----:|
+| 1 | 2 |

data/ext/apex_ext/apex_src/tests/fixtures/tables/table_cr_line_endings.md

@@ -0,0 +1,15 @@
+# Tables
+
+Test this table.
+| Col1 | Col2 |
+|------|------|
+| A    | B    |
+
+: My Table {#table-id .highlight}
+
+Test this table.
+| Col1 | Col2 |
+|------|------|
+| A    | B    |
+
+Table: My Table {#table-id2 .highlight}

data/ext/apex_ext/apex_src/tests/fixtures/tables/table_no_trailing_newline.md

@@ -0,0 +1,15 @@
+# Tables
+
+Test this table.
+| Col1 | Col2 |
+|------|------|
+| A    | B    |
+
+: My Table {#table-id .highlight}
+
+Test this table.
+| Col1 | Col2 |
+|------|------|
+| A    | B    |
+
+Table: My Table {#table-id2 .highlight}

data/ext/apex_ext/apex_src/tests/generate_gfm_ids.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+# Generate GFM-compliant header IDs using available tools
+# This script tries multiple tools to generate header IDs for comparison
+
+TEST_FILE="tests/gfm_header_id_test.md"
+
+echo "=== Generating Header IDs with Available Tools ==="
+echo ""
+
+# Extract headings from test file
+grep -E '^#+ ' "$TEST_FILE" | sed 's/^#* //' > /tmp/headings.txt
+
+# Try pandoc
+if command -v pandoc &> /dev/null; then
+    echo "Using Pandoc:"
+    cat "$TEST_FILE" | pandoc -f gfm -t html 2>&1 | grep -E '<h[1-6] id=' | sed 's/.*id="\([^"]*\)".*/\1/' > /tmp/pandoc_ids.txt
+    echo "Generated $(wc -l < /tmp/pandoc_ids.txt) IDs"
+    echo ""
+fi
+
+# Try comrak
+if command -v comrak &> /dev/null; then
+    echo "Using Comrak:"
+    # Comrak uses anchor tags with IDs: <a ... id="header-id"></a>
+    cat "$TEST_FILE" | comrak --gfm --header-ids "" 2>&1 | grep -E 'id="[^"]*"' | sed 's/.*id="\([^"]*\)".*/\1/' > /tmp/comrak_ids.txt
+    if [ -f /tmp/comrak_ids.txt ] && [ -s /tmp/comrak_ids.txt ]; then
+        echo "Generated $(wc -l < /tmp/comrak_ids.txt) IDs"
+    else
+        echo "Generated 0 IDs (comrak may not generate IDs in this format)"
+    fi
+    echo ""
+fi
+
+# Our implementation
+echo "Using Apex:"
+cat "$TEST_FILE" | ./build/apex --mode gfm 2>&1 | grep -E '<h[1-6] id=' | sed 's/.*id="\([^"]*\)".*/\1/' > /tmp/apex_ids.txt
+echo "Generated $(wc -l < /tmp/apex_ids.txt) IDs"
+echo ""
+
+# Show comparison if we have multiple tools
+echo "=== Comparison ==="
+HEADERS="Heading"
+COLS="/tmp/headings.txt"
+
+if [ -f /tmp/pandoc_ids.txt ] && [ -s /tmp/pandoc_ids.txt ]; then
+    HEADERS="$HEADERS|Pandoc"
+    COLS="$COLS /tmp/pandoc_ids.txt"
+fi
+
+if [ -f /tmp/comrak_ids.txt ] && [ -s /tmp/comrak_ids.txt ]; then
+    HEADERS="$HEADERS|Comrak"
+    COLS="$COLS /tmp/comrak_ids.txt"
+fi
+
+if [ -f /tmp/marked_ids.txt ] && [ -s /tmp/marked_ids.txt ]; then
+    HEADERS="$HEADERS|Marked"
+    COLS="$COLS /tmp/marked_ids.txt"
+fi
+
+HEADERS="$HEADERS|Apex"
+COLS="$COLS /tmp/apex_ids.txt"
+
+echo "$HEADERS"
+echo "$(echo "$HEADERS" | sed 's/[^|]/-/g')"
+paste -d '|' $COLS | head -50
+echo ""
+
+# Try marked (JavaScript) with gfm-heading-id plugin if available
+if command -v node &> /dev/null && npm list -g marked-gfm-heading-id &> /dev/null; then
+    echo "Using Marked (JavaScript) with GFM Heading ID plugin:"
+    # Find the global node_modules path
+    NODE_PATH=$(npm root -g)
+    node -e "
+        const fs = require('fs');
+        const path = require('path');
+        const { marked } = require('$NODE_PATH/marked');
+        const { gfmHeadingId } = require('$NODE_PATH/marked-gfm-heading-id');
+        marked.use(gfmHeadingId());
+        const text = fs.readFileSync('$TEST_FILE', 'utf8');
+        const html = marked(text);
+        const ids = html.match(/<h[1-6] id=\"([^\"]+)\"/g) || [];
+        ids.forEach(id => {
+            const match = id.match(/id=\"([^\"]+)\"/);
+            if (match) console.log(match[1]);
+        });
+    " > /tmp/marked_ids.txt 2>/dev/null
+    if [ -f /tmp/marked_ids.txt ] && [ -s /tmp/marked_ids.txt ]; then
+        echo "Generated $(wc -l < /tmp/marked_ids.txt) IDs"
+        echo ""
+    else
+        echo "Generated 0 IDs"
+        echo ""
+    fi
+fi
+
+echo ""
+echo "=== Summary ==="
+echo "Available tools tested:"
+[ -f /tmp/pandoc_ids.txt ] && [ -s /tmp/pandoc_ids.txt ] && echo "  ✓ Pandoc"
+[ -f /tmp/comrak_ids.txt ] && [ -s /tmp/comrak_ids.txt ] && echo "  ✓ Comrak"
+[ -f /tmp/marked_ids.txt ] && [ -s /tmp/marked_ids.txt ] && echo "  ✓ Marked (JavaScript)"
+echo "  ✓ Apex (our implementation)"
+echo ""
+echo "Note: GitHub's API doesn't return header IDs."
+

data/ext/apex_ext/apex_src/tests/generate_ial_demo.sh

@@ -0,0 +1,143 @@
+#!/bin/sh
+# Generate ial_demo.html from ial_demo.md
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+APEX_BIN="$SCRIPT_DIR/../build/apex"
+MD_FILE="$SCRIPT_DIR/ial_demo.md"
+HTML_FILE="$SCRIPT_DIR/ial_demo.html"
+
+# Check if apex binary exists
+if [ ! -f "$APEX_BIN" ]; then
+    echo "Error: apex binary not found at $APEX_BIN" >&2
+    echo "Please build apex first with: make -C build" >&2
+    exit 1
+fi
+
+# Generate HTML content
+HTML_CONTENT=$("$APEX_BIN" "$MD_FILE" 2>&1)
+if [ $? -ne 0 ]; then
+    echo "Error: Failed to generate HTML from markdown" >&2
+    exit 1
+fi
+
+# Create the complete HTML file
+cat > "$HTML_FILE" << 'EOF'
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>IAL Demo - Attribute Inspector</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+            line-height: 1.6;
+            max-width: 900px;
+            margin: 0 auto;
+            padding: 20px;
+            background-color: #f5f5f5;
+        }
+
+        .content {
+            background: white;
+            padding: 30px;
+            border-radius: 8px;
+            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+        }
+
+        /* Style for elements with attributes - add visual indicator */
+        [class]:hover,
+        [id]:hover {
+            outline: 2px solid #4CAF50;
+            outline-offset: 2px;
+            background-color: rgba(76, 175, 80, 0.1);
+            transition: background-color 0.2s;
+        }
+    </style>
+    <script>
+        // Add tooltips showing all attributes on hover
+        document.addEventListener('DOMContentLoaded', function() {
+            // Create tooltip element
+            const tooltip = document.createElement('div');
+            tooltip.id = 'attribute-tooltip';
+            tooltip.style.cssText = 'position: absolute; background: #333; color: white; padding: 8px 12px; border-radius: 4px; font-size: 12px; font-family: "Courier New", monospace; z-index: 10000; pointer-events: none; opacity: 0; transition: opacity 0.2s; box-shadow: 0 2px 8px rgba(0,0,0,0.3); max-width: 400px; word-wrap: break-word; white-space: normal; line-height: 1.4;';
+            document.body.appendChild(tooltip);
+
+            // Function to get all attributes as a formatted string
+            function getAttributesString(el) {
+                const attrs = [];
+                if (el.id) attrs.push('id="' + el.id + '"');
+                if (el.className) attrs.push('class="' + el.className + '"');
+                for (let i = 0; i < el.attributes.length; i++) {
+                    const attr = el.attributes[i];
+                    if (attr.name !== 'id' && attr.name !== 'class' && !attr.name.startsWith('data-apex-')) {
+                        attrs.push(attr.name + '="' + attr.value + '"');
+                    }
+                }
+                return attrs.length > 0 ? attrs.join(' ') : 'No attributes';
+            }
+
+            // Add hover handlers to all elements with attributes
+            const elementsWithAttrs = document.querySelectorAll('[class], [id]');
+            elementsWithAttrs.forEach(el => {
+                // Skip the tooltip itself and elements inside code blocks
+                if (el.id === 'attribute-tooltip' || el.closest('code') || el.closest('pre')) {
+                    return;
+                }
+
+                el.addEventListener('mouseenter', function(e) {
+                    const attrs = getAttributesString(this);
+                    const tagName = this.tagName.toLowerCase();
+                    tooltip.innerHTML = '<strong>&lt;' + tagName + '</strong> ' +
+                                      (attrs !== 'No attributes' ? attrs : '<em>' + attrs + '</em>') +
+                                      '<strong>&gt;</strong>';
+                    tooltip.style.opacity = '1';
+
+                    const rect = this.getBoundingClientRect();
+                    let left = rect.left + window.scrollX;
+                    let top = rect.top + window.scrollY - tooltip.offsetHeight - 8;
+
+                    // Position tooltip
+                    tooltip.style.left = left + 'px';
+                    tooltip.style.top = top + 'px';
+
+                    // Adjust if tooltip goes off screen
+                    setTimeout(() => {
+                        const tooltipRect = tooltip.getBoundingClientRect();
+                        if (tooltipRect.left < 0) {
+                            tooltip.style.left = '10px';
+                        }
+                        if (tooltipRect.top < 0) {
+                            tooltip.style.top = (rect.bottom + window.scrollY + 8) + 'px';
+                        }
+                        if (tooltipRect.right > window.innerWidth) {
+                            tooltip.style.left = (window.innerWidth - tooltipRect.width - 10) + 'px';
+                        }
+                    }, 0);
+                });
+
+                el.addEventListener('mouseleave', function() {
+                    tooltip.style.opacity = '0';
+                });
+            });
+
+            console.log('Attribute inspector loaded. Hover over elements with attributes to see them.');
+        });
+    </script>
+</head>
+<body>
+    <div class="content">
+EOF
+
+# Append the generated HTML content
+echo "$HTML_CONTENT" >> "$HTML_FILE"
+
+# Close the HTML
+cat >> "$HTML_FILE" << 'EOF'
+    </div>
+</body>
+</html>
+EOF
+
+echo "Generated $HTML_FILE"
+