quikdown 1.0.3 → 1.0.5

package/dist/quikdown_bd.umd.js

@@ -0,0 +1,987 @@
+/**
+ * quikdown_bd - Bidirectional Markdown Parser
+ * @version 1.0.5
+ * @license BSD-2-Clause
+ * @copyright DeftIO 2025
+ */
+(function (global, factory) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
+    typeof define === 'function' && define.amd ? define(factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.quikdown_bd = factory());
+})(this, (function () { 'use strict';
+
+    /**
+     * quikdown - A minimal markdown parser optimized for chat/LLM output
+     * Supports tables, code blocks, lists, and common formatting
+     * @param {string} markdown - The markdown source text
+     * @param {Object} options - Optional configuration object
+     * @param {Function} options.fence_plugin - Custom renderer for fenced code blocks
+     *                   (content, fence_string) => html string
+     * @param {boolean} options.inline_styles - If true, uses inline styles instead of classes
+     * @param {boolean} options.bidirectional - If true, adds data-qd attributes for source tracking
+     * @param {boolean} options.lazy_linefeeds - If true, single newlines become <br> tags
+     * @returns {string} - The rendered HTML
+     */
+
+    // Version will be injected at build time  
+    const quikdownVersion = '1.0.5';
+
+    // Constants for reuse
+    const CLASS_PREFIX = 'quikdown-';
+    const PLACEHOLDER_CB = '§CB';
+    const PLACEHOLDER_IC = '§IC';
+
+    // Escape map at module level
+    const ESC_MAP = {'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'};
+
+    // Single source of truth for all style definitions - optimized
+    const QUIKDOWN_STYLES = {
+        h1: 'font-size:2em;font-weight:600;margin:.67em 0;text-align:left',
+        h2: 'font-size:1.5em;font-weight:600;margin:.83em 0',
+        h3: 'font-size:1.25em;font-weight:600;margin:1em 0',
+        h4: 'font-size:1em;font-weight:600;margin:1.33em 0',
+        h5: 'font-size:.875em;font-weight:600;margin:1.67em 0',
+        h6: 'font-size:.85em;font-weight:600;margin:2em 0',
+        pre: 'background:#f4f4f4;padding:10px;border-radius:4px;overflow-x:auto;margin:1em 0',
+        code: 'background:#f0f0f0;padding:2px 4px;border-radius:3px;font-family:monospace',
+        blockquote: 'border-left:4px solid #ddd;margin-left:0;padding-left:1em',
+        table: 'border-collapse:collapse;width:100%;margin:1em 0',
+        th: 'border:1px solid #ddd;padding:8px;background-color:#f2f2f2;font-weight:bold;text-align:left',
+        td: 'border:1px solid #ddd;padding:8px;text-align:left',
+        hr: 'border:none;border-top:1px solid #ddd;margin:1em 0',
+        img: 'max-width:100%;height:auto',
+        a: 'color:#06c;text-decoration:underline',
+        strong: 'font-weight:bold',
+        em: 'font-style:italic',
+        del: 'text-decoration:line-through',
+        ul: 'margin:.5em 0;padding-left:2em',
+        ol: 'margin:.5em 0;padding-left:2em',
+        li: 'margin:.25em 0',
+        // Task list specific styles
+        'task-item': 'list-style:none',
+        'task-checkbox': 'margin-right:.5em'
+    };
+
+    // Factory function to create getAttr for a given context
+    function createGetAttr(inline_styles, styles) {
+        return function(tag, additionalStyle = '') {
+            if (inline_styles) {
+                let style = styles[tag];
+                if (!style && !additionalStyle) return '';
+                
+                // Remove default text-align if we're adding a different alignment
+                if (additionalStyle && additionalStyle.includes('text-align') && style && style.includes('text-align')) {
+                    style = style.replace(/text-align:[^;]+;?/, '').trim();
+                    if (style && !style.endsWith(';')) style += ';';
+                }
+                
+                /* istanbul ignore next - defensive: additionalStyle without style doesn't occur with current tags */
+                const fullStyle = additionalStyle ? (style ? `${style}${additionalStyle}` : additionalStyle) : style;
+                return ` style="${fullStyle}"`;
+            } else {
+                const classAttr = ` class="${CLASS_PREFIX}${tag}"`;
+                // Apply inline styles for alignment even when using CSS classes
+                if (additionalStyle) {
+                    return `${classAttr} style="${additionalStyle}"`;
+                }
+                return classAttr;
+            }
+        };
+    }
+
+    function quikdown(markdown, options = {}) {
+        if (!markdown || typeof markdown !== 'string') {
+            return '';
+        }
+        
+        const { fence_plugin, inline_styles = false, bidirectional = false, lazy_linefeeds = false } = options;
+        const styles = QUIKDOWN_STYLES; // Use module-level styles
+        const getAttr = createGetAttr(inline_styles, styles); // Create getAttr once
+
+        // Escape HTML entities to prevent XSS
+        function escapeHtml(text) {
+            return text.replace(/[&<>"']/g, m => ESC_MAP[m]);
+        }
+        
+        // Helper to add data-qd attributes for bidirectional support
+        const dataQd = bidirectional ? (marker) => ` data-qd="${escapeHtml(marker)}"` : () => '';
+        
+        // Sanitize URLs to prevent XSS attacks
+        function sanitizeUrl(url, allowUnsafe = false) {
+            /* istanbul ignore next - defensive programming, regex ensures url is never empty */
+            if (!url) return '';
+            
+            // If unsafe URLs are explicitly allowed, return as-is
+            if (allowUnsafe) return url;
+            
+            const trimmedUrl = url.trim();
+            const lowerUrl = trimmedUrl.toLowerCase();
+            
+            // Block dangerous protocols
+            const dangerousProtocols = ['javascript:', 'vbscript:', 'data:'];
+            
+            for (const protocol of dangerousProtocols) {
+                if (lowerUrl.startsWith(protocol)) {
+                    // Exception: Allow data:image/* for images
+                    if (protocol === 'data:' && lowerUrl.startsWith('data:image/')) {
+                        return trimmedUrl;
+                    }
+                    // Return safe empty link for dangerous protocols
+                    return '#';
+                }
+            }
+            
+            return trimmedUrl;
+        }
+
+        // Process the markdown in phases
+        let html = markdown;
+        
+        // Phase 1: Extract and protect code blocks and inline code
+        const codeBlocks = [];
+        const inlineCodes = [];
+        
+        // Extract fenced code blocks first (supports both ``` and ~~~)
+        // Match paired fences - ``` with ``` and ~~~ with ~~~
+        // Fence must be at start of line
+        html = html.replace(/^(```|~~~)([^\n]*)\n([\s\S]*?)^\1$/gm, (match, fence, lang, code) => {
+            const placeholder = `${PLACEHOLDER_CB}${codeBlocks.length}§`;
+            
+            // Trim the language specification
+            const langTrimmed = lang ? lang.trim() : '';
+            
+            // If custom fence plugin is provided, use it
+            if (fence_plugin && typeof fence_plugin === 'function') {
+                codeBlocks.push({
+                    lang: langTrimmed,
+                    code: code.trimEnd(),
+                    custom: true,
+                    fence: fence
+                });
+            } else {
+                codeBlocks.push({
+                    lang: langTrimmed,
+                    code: escapeHtml(code.trimEnd()),
+                    custom: false,
+                    fence: fence
+                });
+            }
+            return placeholder;
+        });
+        
+        // Extract inline code
+        html = html.replace(/`([^`]+)`/g, (match, code) => {
+            const placeholder = `${PLACEHOLDER_IC}${inlineCodes.length}§`;
+            inlineCodes.push(escapeHtml(code));
+            return placeholder;
+        });
+        
+        // Now escape HTML in the rest of the content
+        html = escapeHtml(html);
+        
+        // Phase 2: Process block elements
+        
+        // Process tables
+        html = processTable(html, getAttr);
+        
+        // Process headings (supports optional trailing #'s)
+        html = html.replace(/^(#{1,6})\s+(.+?)\s*#*$/gm, (match, hashes, content) => {
+            const level = hashes.length;
+            return `<h${level}${getAttr('h' + level)}${dataQd(hashes)}>${content}</h${level}>`;
+        });
+        
+        // Process blockquotes (must handle escaped > since we already escaped HTML)
+        html = html.replace(/^&gt;\s+(.+)$/gm, `<blockquote${getAttr('blockquote')}>$1</blockquote>`);
+        // Merge consecutive blockquotes
+        html = html.replace(/<\/blockquote>\n<blockquote>/g, '\n');
+        
+        // Process horizontal rules
+        html = html.replace(/^---+$/gm, `<hr${getAttr('hr')}>`);
+        
+        // Process lists
+        html = processLists(html, getAttr, inline_styles, bidirectional);
+        
+        // Phase 3: Process inline elements
+        
+        // Images (must come before links, with URL sanitization)
+        html = html.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, (match, alt, src) => {
+            const sanitizedSrc = sanitizeUrl(src, options.allow_unsafe_urls);
+            const altAttr = bidirectional && alt ? ` data-qd-alt="${escapeHtml(alt)}"` : '';
+            const srcAttr = bidirectional ? ` data-qd-src="${escapeHtml(src)}"` : '';
+            return `<img${getAttr('img')} src="${sanitizedSrc}" alt="${alt}"${altAttr}${srcAttr}${dataQd('!')}>`;
+        });
+        
+        // Links (with URL sanitization)
+        html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (match, text, href) => {
+            // Sanitize URL to prevent XSS
+            const sanitizedHref = sanitizeUrl(href, options.allow_unsafe_urls);
+            const isExternal = /^https?:\/\//i.test(sanitizedHref);
+            const rel = isExternal ? ' rel="noopener noreferrer"' : '';
+            const textAttr = bidirectional ? ` data-qd-text="${escapeHtml(text)}"` : '';
+            return `<a${getAttr('a')} href="${sanitizedHref}"${rel}${textAttr}${dataQd('[')}>${text}</a>`;
+        });
+        
+        // Autolinks - convert bare URLs to clickable links
+        html = html.replace(/(^|\s)(https?:\/\/[^\s<]+)/g, (match, prefix, url) => {
+            const sanitizedUrl = sanitizeUrl(url, options.allow_unsafe_urls);
+            return `${prefix}<a${getAttr('a')} href="${sanitizedUrl}" rel="noopener noreferrer">${url}</a>`;
+        });
+        
+        // Process inline formatting (bold, italic, strikethrough)
+        const inlinePatterns = [
+            [/\*\*(.+?)\*\*/g, 'strong', '**'],
+            [/__(.+?)__/g, 'strong', '__'],
+            [/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/g, 'em', '*'],
+            [/(?<!_)_(?!_)(.+?)(?<!_)_(?!_)/g, 'em', '_'],
+            [/~~(.+?)~~/g, 'del', '~~']
+        ];
+        
+        inlinePatterns.forEach(([pattern, tag, marker]) => {
+            html = html.replace(pattern, `<${tag}${getAttr(tag)}${dataQd(marker)}>$1</${tag}>`);
+        });
+        
+        // Line breaks
+        if (lazy_linefeeds) {
+            // Lazy linefeeds: single newline becomes <br> (except between paragraphs and after/before block elements)
+            const blocks = [];
+            let bi = 0;
+            
+            // Protect tables and lists  
+            html = html.replace(/<(table|[uo]l)[^>]*>[\s\S]*?<\/\1>/g, m => {
+                blocks[bi] = m;
+                return `§B${bi++}§`;
+            });
+            
+            // Handle paragraphs and block elements
+            html = html.replace(/\n\n+/g, '§P§')
+                // After block elements
+                .replace(/(<\/(?:h[1-6]|blockquote|pre)>)\n/g, '$1§N§')
+                .replace(/(<(?:h[1-6]|blockquote|pre|hr)[^>]*>)\n/g, '$1§N§')
+                // Before block elements  
+                .replace(/\n(<(?:h[1-6]|blockquote|pre|hr)[^>]*>)/g, '§N§$1')
+                .replace(/\n(§B\d+§)/g, '§N§$1')
+                .replace(/(§B\d+§)\n/g, '$1§N§')
+                // Convert remaining newlines
+                .replace(/\n/g, `<br${getAttr('br')}>`)
+                // Restore
+                .replace(/§N§/g, '\n')
+                .replace(/§P§/g, '</p><p>');
+            
+            // Restore protected blocks
+            blocks.forEach((b, i) => html = html.replace(`§B${i}§`, b));
+            
+            html = '<p>' + html + '</p>';
+        } else {
+            // Standard: two spaces at end of line for line breaks
+            html = html.replace(/  $/gm, `<br${getAttr('br')}>`);
+            
+            // Paragraphs (double newlines)
+            html = html.replace(/\n\n+/g, '</p><p>');
+            html = '<p>' + html + '</p>';
+        }
+        
+        // Clean up empty paragraphs and unwrap block elements
+        const cleanupPatterns = [
+            [/<p><\/p>/g, ''],
+            [/<p>(<h[1-6][^>]*>)/g, '$1'],
+            [/(<\/h[1-6]>)<\/p>/g, '$1'],
+            [/<p>(<blockquote[^>]*>)/g, '$1'],
+            [/(<\/blockquote>)<\/p>/g, '$1'],
+            [/<p>(<ul[^>]*>|<ol[^>]*>)/g, '$1'],
+            [/(<\/ul>|<\/ol>)<\/p>/g, '$1'],
+            [/<p>(<hr[^>]*>)<\/p>/g, '$1'],
+            [/<p>(<table[^>]*>)/g, '$1'],
+            [/(<\/table>)<\/p>/g, '$1'],
+            [/<p>(<pre[^>]*>)/g, '$1'],
+            [/(<\/pre>)<\/p>/g, '$1'],
+            [new RegExp(`<p>(${PLACEHOLDER_CB}\\d+§)<\/p>`, 'g'), '$1']
+        ];
+        
+        cleanupPatterns.forEach(([pattern, replacement]) => {
+            html = html.replace(pattern, replacement);
+        });
+        
+        // Phase 4: Restore code blocks and inline code
+        
+        // Restore code blocks
+        codeBlocks.forEach((block, i) => {
+            let replacement;
+            
+            if (block.custom && fence_plugin) {
+                // Use custom fence plugin
+                replacement = fence_plugin(block.code, block.lang);
+                // If plugin returns undefined, fall back to default rendering
+                if (replacement === undefined) {
+                    const langClass = !inline_styles && block.lang ? ` class="language-${block.lang}"` : '';
+                    const codeAttr = inline_styles ? getAttr('code') : langClass;
+                    const langAttr = bidirectional && block.lang ? ` data-qd-lang="${escapeHtml(block.lang)}"` : '';
+                    const fenceAttr = bidirectional ? ` data-qd-fence="${escapeHtml(block.fence)}"` : '';
+                    replacement = `<pre${getAttr('pre')}${fenceAttr}${langAttr}><code${codeAttr}>${escapeHtml(block.code)}</code></pre>`;
+                }
+            } else {
+                // Default rendering
+                const langClass = !inline_styles && block.lang ? ` class="language-${block.lang}"` : '';
+                const codeAttr = inline_styles ? getAttr('code') : langClass;
+                const langAttr = bidirectional && block.lang ? ` data-qd-lang="${escapeHtml(block.lang)}"` : '';
+                const fenceAttr = bidirectional ? ` data-qd-fence="${escapeHtml(block.fence)}"` : '';
+                replacement = `<pre${getAttr('pre')}${fenceAttr}${langAttr}><code${codeAttr}>${block.code}</code></pre>`;
+            }
+            
+            const placeholder = `${PLACEHOLDER_CB}${i}§`;
+            html = html.replace(placeholder, replacement);
+        });
+        
+        // Restore inline code
+        inlineCodes.forEach((code, i) => {
+            const placeholder = `${PLACEHOLDER_IC}${i}§`;
+            html = html.replace(placeholder, `<code${getAttr('code')}${dataQd('`')}>${code}</code>`);
+        });
+        
+        return html.trim();
+    }
+
+    /**
+     * Process inline markdown formatting
+     */
+    function processInlineMarkdown(text, getAttr) {
+        
+        // Process inline formatting patterns
+        const patterns = [
+            [/\*\*(.+?)\*\*/g, 'strong'],
+            [/__(.+?)__/g, 'strong'],
+            [/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/g, 'em'],
+            [/(?<!_)_(?!_)(.+?)(?<!_)_(?!_)/g, 'em'],
+            [/~~(.+?)~~/g, 'del'],
+            [/`([^`]+)`/g, 'code']
+        ];
+        
+        patterns.forEach(([pattern, tag]) => {
+            text = text.replace(pattern, `<${tag}${getAttr(tag)}>$1</${tag}>`);
+        });
+        
+        return text;
+    }
+
+    /**
+     * Process markdown tables
+     */
+    function processTable(text, getAttr) {
+        const lines = text.split('\n');
+        const result = [];
+        let inTable = false;
+        let tableLines = [];
+        
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            
+            // Check if this line looks like a table row (with or without trailing |)
+            if (line.includes('|') && (line.startsWith('|') || /[^\\|]/.test(line))) {
+                if (!inTable) {
+                    inTable = true;
+                    tableLines = [];
+                }
+                tableLines.push(line);
+            } else {
+                // Not a table line
+                if (inTable) {
+                    // Process the accumulated table
+                    const tableHtml = buildTable(tableLines, getAttr);
+                    if (tableHtml) {
+                        result.push(tableHtml);
+                    } else {
+                        // Not a valid table, restore original lines
+                        result.push(...tableLines);
+                    }
+                    inTable = false;
+                    tableLines = [];
+                }
+                result.push(lines[i]);
+            }
+        }
+        
+        // Handle table at end of text
+        if (inTable && tableLines.length > 0) {
+            const tableHtml = buildTable(tableLines, getAttr);
+            if (tableHtml) {
+                result.push(tableHtml);
+            } else {
+                result.push(...tableLines);
+            }
+        }
+        
+        return result.join('\n');
+    }
+
+    /**
+     * Build an HTML table from markdown table lines
+     */
+    function buildTable(lines, getAttr) {
+        
+        if (lines.length < 2) return null;
+        
+        // Check for separator line (second line should be the separator)
+        let separatorIndex = -1;
+        for (let i = 1; i < lines.length; i++) {
+            // Support separator with or without leading/trailing pipes
+            if (/^\|?[\s\-:|]+\|?$/.test(lines[i]) && lines[i].includes('-')) {
+                separatorIndex = i;
+                break;
+            }
+        }
+        
+        if (separatorIndex === -1) return null;
+        
+        const headerLines = lines.slice(0, separatorIndex);
+        const bodyLines = lines.slice(separatorIndex + 1);
+        
+        // Parse alignment from separator
+        const separator = lines[separatorIndex];
+        // Handle pipes at start/end or not
+        const separatorCells = separator.trim().replace(/^\|/, '').replace(/\|$/, '').split('|');
+        const alignments = separatorCells.map(cell => {
+            const trimmed = cell.trim();
+            if (trimmed.startsWith(':') && trimmed.endsWith(':')) return 'center';
+            if (trimmed.endsWith(':')) return 'right';
+            return 'left';
+        });
+        
+        let html = `<table${getAttr('table')}>\n`;
+        
+        // Build header
+        // Note: headerLines will always have length > 0 since separatorIndex starts from 1
+        html += `<thead${getAttr('thead')}>\n`;
+        headerLines.forEach(line => {
+                html += `<tr${getAttr('tr')}>\n`;
+                // Handle pipes at start/end or not
+                const cells = line.trim().replace(/^\|/, '').replace(/\|$/, '').split('|');
+                cells.forEach((cell, i) => {
+                    const alignStyle = alignments[i] && alignments[i] !== 'left' ? `text-align:${alignments[i]}` : '';
+                    const processedCell = processInlineMarkdown(cell.trim(), getAttr);
+                    html += `<th${getAttr('th', alignStyle)}>${processedCell}</th>\n`;
+                });
+                html += '</tr>\n';
+        });
+        html += '</thead>\n';
+        
+        // Build body
+        if (bodyLines.length > 0) {
+            html += `<tbody${getAttr('tbody')}>\n`;
+            bodyLines.forEach(line => {
+                html += `<tr${getAttr('tr')}>\n`;
+                // Handle pipes at start/end or not
+                const cells = line.trim().replace(/^\|/, '').replace(/\|$/, '').split('|');
+                cells.forEach((cell, i) => {
+                    const alignStyle = alignments[i] && alignments[i] !== 'left' ? `text-align:${alignments[i]}` : '';
+                    const processedCell = processInlineMarkdown(cell.trim(), getAttr);
+                    html += `<td${getAttr('td', alignStyle)}>${processedCell}</td>\n`;
+                });
+                html += '</tr>\n';
+            });
+            html += '</tbody>\n';
+        }
+        
+        html += '</table>';
+        return html;
+    }
+
+    /**
+     * Process markdown lists (ordered and unordered)
+     */
+    function processLists(text, getAttr, inline_styles, bidirectional) {
+        
+        const lines = text.split('\n');
+        const result = [];
+        let listStack = []; // Track nested lists
+        
+        // Helper to escape HTML for data-qd attributes
+        const escapeHtml = (text) => text.replace(/[&<>"']/g, m => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'})[m]);
+        const dataQd = bidirectional ? (marker) => ` data-qd="${escapeHtml(marker)}"` : () => '';
+        
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const match = line.match(/^(\s*)([*\-+]|\d+\.)\s+(.+)$/);
+            
+            if (match) {
+                const [, indent, marker, content] = match;
+                const level = Math.floor(indent.length / 2);
+                const isOrdered = /^\d+\./.test(marker);
+                const listType = isOrdered ? 'ol' : 'ul';
+                
+                // Check for task list items
+                let listItemContent = content;
+                let taskListClass = '';
+                const taskMatch = content.match(/^\[([x ])\]\s+(.*)$/i);
+                if (taskMatch && !isOrdered) {
+                    const [, checked, taskContent] = taskMatch;
+                    const isChecked = checked.toLowerCase() === 'x';
+                    const checkboxAttr = inline_styles 
+                        ? ' style="margin-right:.5em"' 
+                        : ` class="${CLASS_PREFIX}task-checkbox"`;
+                    listItemContent = `<input type="checkbox"${checkboxAttr}${isChecked ? ' checked' : ''} disabled> ${taskContent}`;
+                    taskListClass = inline_styles ? ' style="list-style:none"' : ` class="${CLASS_PREFIX}task-item"`;
+                }
+                
+                // Close deeper levels
+                while (listStack.length > level + 1) {
+                    const list = listStack.pop();
+                    result.push(`</${list.type}>`);
+                }
+                
+                // Open new level if needed
+                if (listStack.length === level) {
+                    // Need to open a new list
+                    listStack.push({ type: listType, level });
+                    result.push(`<${listType}${getAttr(listType)}>`);
+                } else if (listStack.length === level + 1) {
+                    // Check if we need to switch list type
+                    const currentList = listStack[listStack.length - 1];
+                    if (currentList.type !== listType) {
+                        result.push(`</${currentList.type}>`);
+                        listStack.pop();
+                        listStack.push({ type: listType, level });
+                        result.push(`<${listType}${getAttr(listType)}>`);
+                    }
+                }
+                
+                const liAttr = taskListClass || getAttr('li');
+                result.push(`<li${liAttr}${dataQd(marker)}>${listItemContent}</li>`);
+            } else {
+                // Not a list item, close all lists
+                while (listStack.length > 0) {
+                    const list = listStack.pop();
+                    result.push(`</${list.type}>`);
+                }
+                result.push(line);
+            }
+        }
+        
+        // Close any remaining lists
+        while (listStack.length > 0) {
+            const list = listStack.pop();
+            result.push(`</${list.type}>`);
+        }
+        
+        return result.join('\n');
+    }
+
+    /**
+     * Emit CSS styles for quikdown elements
+     * @param {string} prefix - Optional class prefix (default: 'quikdown-')
+     * @param {string} theme - Optional theme: 'light' (default) or 'dark'
+     * @returns {string} CSS string with quikdown styles
+     */
+    quikdown.emitStyles = function(prefix = 'quikdown-', theme = 'light') {
+        const styles = QUIKDOWN_STYLES;
+        
+        // Define theme color overrides
+        const themeOverrides = {
+            dark: {
+                '#f4f4f4': '#2a2a2a', // pre background
+                '#f0f0f0': '#2a2a2a', // code background
+                '#f2f2f2': '#2a2a2a', // th background
+                '#ddd': '#3a3a3a',    // borders
+                '#06c': '#6db3f2',    // links
+                _textColor: '#e0e0e0'
+            },
+            light: {
+                _textColor: '#333'    // Explicit text color for light theme
+            }
+        };
+        
+        let css = '';
+        for (const [tag, style] of Object.entries(styles)) {
+            let themedStyle = style;
+                
+                // Apply theme overrides if dark theme
+                if (theme === 'dark' && themeOverrides.dark) {
+                    // Replace colors
+                    for (const [oldColor, newColor] of Object.entries(themeOverrides.dark)) {
+                        if (!oldColor.startsWith('_')) {
+                            themedStyle = themedStyle.replace(new RegExp(oldColor, 'g'), newColor);
+                        }
+                    }
+                    
+                    // Add text color for certain elements in dark theme
+                    const needsTextColor = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'td', 'li', 'blockquote'];
+                    if (needsTextColor.includes(tag)) {
+                        themedStyle += `;color:${themeOverrides.dark._textColor}`;
+                    }
+                } else if (theme === 'light' && themeOverrides.light) {
+                    // Add explicit text color for light theme elements too
+                    const needsTextColor = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'td', 'li', 'blockquote'];
+                    if (needsTextColor.includes(tag)) {
+                        themedStyle += `;color:${themeOverrides.light._textColor}`;
+                    }
+                }
+            
+            css += `.${prefix}${tag} { ${themedStyle} }\n`;
+        }
+        
+        return css;
+    };
+
+    /**
+     * Configure quikdown with options and return a function
+     * @param {Object} options - Configuration options
+     * @returns {Function} Configured quikdown function
+     */
+    quikdown.configure = function(options) {
+        return function(markdown) {
+            return quikdown(markdown, options);
+        };
+    };
+
+    /**
+     * Version information
+     */
+    quikdown.version = quikdownVersion;
+
+    // Export for both CommonJS and ES6
+    /* istanbul ignore next */
+    if (typeof module !== 'undefined' && module.exports) {
+        module.exports = quikdown;
+    }
+
+    // For browser global
+    /* istanbul ignore next */
+    if (typeof window !== 'undefined') {
+        window.quikdown = quikdown;
+    }
+
+    /**
+     * quikdown_bd - Bidirectional markdown/HTML converter
+     * Extends core quikdown with HTML→Markdown conversion
+     * 
+     * Uses data-qd attributes to preserve original markdown syntax
+     * Enables HTML→Markdown conversion for quikdown-generated HTML
+     */
+
+
+    /**
+     * Create bidirectional version by extending quikdown
+     * This wraps quikdown and adds the toMarkdown method
+     */
+    function quikdown_bd(markdown, options = {}) {
+        // Use core quikdown with bidirectional flag to add data-qd attributes
+        return quikdown(markdown, { ...options, bidirectional: true });
+    }
+
+    // Copy all properties and methods from quikdown (including version)
+    Object.keys(quikdown).forEach(key => {
+        quikdown_bd[key] = quikdown[key];
+    });
+
+    // Add the toMarkdown method for HTML→Markdown conversion
+    quikdown_bd.toMarkdown = function(htmlOrElement) {
+        // Accept either HTML string or DOM element
+        let container;
+        if (typeof htmlOrElement === 'string') {
+            container = document.createElement('div');
+            container.innerHTML = htmlOrElement;
+        } else if (htmlOrElement instanceof Element) {
+            /* istanbul ignore next - browser-only code path, not testable in jsdom */
+            container = htmlOrElement;
+        } else {
+            return '';
+        }
+        
+        // Walk the DOM tree and reconstruct markdown
+        function walkNode(node, parentContext = {}) {
+            if (node.nodeType === Node.TEXT_NODE) {
+                // Return text content, preserving whitespace where needed
+                return node.textContent;
+            }
+            
+            if (node.nodeType !== Node.ELEMENT_NODE) {
+                return '';
+            }
+            
+            const tag = node.tagName.toLowerCase();
+            const dataQd = node.getAttribute('data-qd');
+            
+            // Process children with context
+            let childContent = '';
+            for (let child of node.childNodes) {
+                childContent += walkNode(child, { parentTag: tag, ...parentContext });
+            }
+            
+            // Determine markdown based on element and attributes
+            switch (tag) {
+                case 'h1':
+                case 'h2':
+                case 'h3':
+                case 'h4':
+                case 'h5':
+                case 'h6':
+                    const level = parseInt(tag[1]);
+                    const prefix = dataQd || '#'.repeat(level);
+                    return `${prefix} ${childContent.trim()}\n\n`;
+                    
+                case 'strong':
+                case 'b':
+                    if (!childContent) return ''; // Don't add markers for empty content
+                    const boldMarker = dataQd || '**';
+                    return `${boldMarker}${childContent}${boldMarker}`;
+                    
+                case 'em':
+                case 'i':
+                    if (!childContent) return ''; // Don't add markers for empty content
+                    const emMarker = dataQd || '*';
+                    return `${emMarker}${childContent}${emMarker}`;
+                    
+                case 'del':
+                case 's':
+                case 'strike':
+                    if (!childContent) return ''; // Don't add markers for empty content
+                    const delMarker = dataQd || '~~';
+                    return `${delMarker}${childContent}${delMarker}`;
+                    
+                case 'code':
+                    // Note: code inside pre is handled directly by the pre case using querySelector
+                    if (!childContent) return ''; // Don't add markers for empty content
+                    const codeMarker = dataQd || '`';
+                    return `${codeMarker}${childContent}${codeMarker}`;
+                    
+                case 'pre':
+                    const fence = node.getAttribute('data-qd-fence') || dataQd || '```';
+                    const lang = node.getAttribute('data-qd-lang') || '';
+                    // Look for code element child
+                    const codeEl = node.querySelector('code');
+                    const codeContent = codeEl ? codeEl.textContent : childContent;
+                    return `${fence}${lang}\n${codeContent.trimEnd()}\n${fence}\n\n`;
+                    
+                case 'blockquote':
+                    const quoteMarker = dataQd || '>';
+                    const lines = childContent.trim().split('\n');
+                    return lines.map(line => `${quoteMarker} ${line}`).join('\n') + '\n\n';
+                    
+                case 'hr':
+                    const hrMarker = dataQd || '---';
+                    return `${hrMarker}\n\n`;
+                    
+                case 'br':
+                    const brMarker = dataQd || '  ';
+                    return `${brMarker}\n`;
+                    
+                case 'a':
+                    const linkText = node.getAttribute('data-qd-text') || childContent.trim();
+                    const href = node.getAttribute('href') || '';
+                    // Check for autolinks
+                    if (linkText === href && !dataQd) {
+                        return `<${href}>`;
+                    }
+                    return `[${linkText}](${href})`;
+                    
+                case 'img':
+                    const alt = node.getAttribute('data-qd-alt') || node.getAttribute('alt') || '';
+                    const src = node.getAttribute('data-qd-src') || node.getAttribute('src') || '';
+                    const imgMarker = dataQd || '!';
+                    return `${imgMarker}[${alt}](${src})`;
+                    
+                case 'ul':
+                case 'ol':
+                    return walkList(node, tag === 'ol') + '\n';
+                    
+                case 'li':
+                    // Handled by list processor
+                    return childContent;
+                    
+                case 'table':
+                    return walkTable(node) + '\n\n';
+                    
+                case 'p':
+                    // Check if it's actually a paragraph or just a wrapper
+                    if (childContent.trim()) {
+                        return childContent.trim() + '\n\n';
+                    }
+                    return '';
+                    
+                case 'div':
+                    // Check if it's a mermaid container
+                    if (node.classList && node.classList.contains('mermaid-container')) {
+                        const fence = node.getAttribute('data-qd-fence') || '```';
+                        const lang = node.getAttribute('data-qd-lang') || 'mermaid';
+                        
+                        // First check for data-qd-source attribute on the container
+                        const source = node.getAttribute('data-qd-source');
+                        if (source) {
+                            // Decode HTML entities from the attribute (mainly &quot;)
+                            const temp = document.createElement('textarea');
+                            temp.innerHTML = source;
+                            const code = temp.value;
+                            return `${fence}${lang}\n${code}\n${fence}\n\n`;
+                        }
+                        
+                        // Check for source on the pre.mermaid element
+                        const mermaidPre = node.querySelector('pre.mermaid');
+                        if (mermaidPre) {
+                            const preSource = mermaidPre.getAttribute('data-qd-source');
+                            if (preSource) {
+                                const temp = document.createElement('textarea');
+                                temp.innerHTML = preSource;
+                                const code = temp.value;
+                                return `${fence}${lang}\n${code}\n${fence}\n\n`;
+                            }
+                        }
+                        
+                        // Fallback: Look for the legacy .mermaid-source element
+                        const sourceElement = node.querySelector('.mermaid-source');
+                        if (sourceElement) {
+                            // Decode HTML entities
+                            const temp = document.createElement('div');
+                            temp.innerHTML = sourceElement.innerHTML;
+                            const code = temp.textContent;
+                            return `${fence}${lang}\n${code}\n${fence}\n\n`;
+                        }
+                        
+                        // Final fallback: try to extract from the mermaid element (unreliable after rendering)
+                        const mermaidElement = node.querySelector('.mermaid');
+                        if (mermaidElement && mermaidElement.textContent.includes('graph')) {
+                            return `${fence}${lang}\n${mermaidElement.textContent.trim()}\n${fence}\n\n`;
+                        }
+                    }
+                    // Check if it's a standalone mermaid diagram (legacy)
+                    if (node.classList && node.classList.contains('mermaid')) {
+                        const fence = node.getAttribute('data-qd-fence') || '```';
+                        const lang = node.getAttribute('data-qd-lang') || 'mermaid';
+                        const code = node.textContent.trim();
+                        return `${fence}${lang}\n${code}\n${fence}\n\n`;
+                    }
+                    // Pass through other divs
+                    return childContent;
+                
+                case 'span':
+                    // Pass through container elements
+                    return childContent;
+                    
+                default:
+                    return childContent;
+            }
+        }
+        
+        // Walk list elements
+        function walkList(listNode, isOrdered, depth = 0) {
+            let result = '';
+            let index = 1;
+            const indent = '  '.repeat(depth);
+            
+            for (let child of listNode.children) {
+                if (child.tagName !== 'LI') continue;
+                
+                const dataQd = child.getAttribute('data-qd');
+                let marker = dataQd || (isOrdered ? `${index}.` : '-');
+                
+                // Check for task list checkbox
+                const checkbox = child.querySelector('input[type="checkbox"]');
+                if (checkbox) {
+                    const checked = checkbox.checked ? 'x' : ' ';
+                    marker = '-';
+                    // Get text without the checkbox
+                    let text = '';
+                    for (let node of child.childNodes) {
+                        if (node.nodeType === Node.TEXT_NODE) {
+                            text += node.textContent;
+                        } else if (node.tagName && node.tagName !== 'INPUT') {
+                            text += walkNode(node);
+                        }
+                    }
+                    result += `${indent}${marker} [${checked}] ${text.trim()}\n`;
+                } else {
+                    let itemContent = '';
+                    
+                    for (let node of child.childNodes) {
+                        if (node.tagName === 'UL' || node.tagName === 'OL') {
+                            itemContent += walkList(node, node.tagName === 'OL', depth + 1);
+                        } else {
+                            itemContent += walkNode(node);
+                        }
+                    }
+                    
+                    result += `${indent}${marker} ${itemContent.trim()}\n`;
+                }
+                
+                index++;
+            }
+            
+            return result;
+        }
+        
+        // Walk table elements
+        function walkTable(table) {
+            let result = '';
+            const alignData = table.getAttribute('data-qd-align');
+            const alignments = alignData ? alignData.split(',') : [];
+            
+            // Process header
+            const thead = table.querySelector('thead');
+            if (thead) {
+                const headerRow = thead.querySelector('tr');
+                if (headerRow) {
+                    const headers = [];
+                    for (let th of headerRow.querySelectorAll('th')) {
+                        headers.push(th.textContent.trim());
+                    }
+                    result += '| ' + headers.join(' | ') + ' |\n';
+                    
+                    // Add separator with alignment
+                    const separators = headers.map((_, i) => {
+                        const align = alignments[i] || 'left';
+                        if (align === 'center') return ':---:';
+                        if (align === 'right') return '---:';
+                        return '---';
+                    });
+                    result += '| ' + separators.join(' | ') + ' |\n';
+                }
+            }
+            
+            // Process body
+            const tbody = table.querySelector('tbody');
+            if (tbody) {
+                for (let row of tbody.querySelectorAll('tr')) {
+                    const cells = [];
+                    for (let td of row.querySelectorAll('td')) {
+                        cells.push(td.textContent.trim());
+                    }
+                    if (cells.length > 0) {
+                        result += '| ' + cells.join(' | ') + ' |\n';
+                    }
+                }
+            }
+            
+            return result.trim();
+        }
+        
+        // Process the DOM tree
+        let markdown = walkNode(container);
+        
+        // Clean up
+        markdown = markdown.replace(/\n{3,}/g, '\n\n'); // Remove excessive newlines
+        markdown = markdown.trim();
+        
+        return markdown;
+    };
+
+    // Override the configure method to return a bidirectional version
+    quikdown_bd.configure = function(options) {
+        return function(markdown) {
+            return quikdown_bd(markdown, options);
+        };
+    };
+
+    // Set version
+    // Version is already copied from quikdown via Object.keys loop
+
+    // Export for both module and browser
+    /* istanbul ignore next */
+    if (typeof module !== 'undefined' && module.exports) {
+        module.exports = quikdown_bd;
+    }
+
+    /* istanbul ignore next */
+    if (typeof window !== 'undefined') {
+        window.quikdown_bd = quikdown_bd;
+    }
+
+    return quikdown_bd;
+
+}));