@memberjunction/markdown-core 0.0.0 → 5.45.0

package/dist/engine/markdown-engine.d.ts

@@ -0,0 +1,109 @@
+import { TokensList } from 'marked';
+import { MarkdownConfig, ResolvedMarkdownConfig, HeadingInfo, HighlightFunction } from '../types/markdown.types';
+/**
+ * Options that tune a single {@link MarkdownEngine.configureMarked} call.
+ */
+export interface ConfigureMarkedOptions {
+    /**
+     * Syntax-highlight function used by the HTML output path. The engine itself
+     * carries no highlighter dependency — web callers pass a Prism-backed
+     * function; the token (AST) path ignores this entirely.
+     */
+    highlightFn?: HighlightFunction;
+}
+/**
+ * Framework-agnostic markdown engine.
+ *
+ * Owns the `marked` configuration and the MemberJunction custom extensions
+ * (SVG code blocks, collapsible headings, GitHub alerts, heading ids,
+ * smartypants). It produces either:
+ *
+ * - an **HTML string** via {@link parseToHtml} — consumed by the Angular
+ *   `ng-markdown` component (which then does its DOM post-processing), or
+ * - a **token tree (AST)** via {@link parseToTokens} — consumed by the React
+ *   Native renderer (and any other non-DOM target).
+ *
+ * The engine has no DOM, Prism, or Mermaid dependency. Highlighting is injected
+ * by the caller; Mermaid and copy-button wiring are the host's responsibility.
+ */
+export declare class MarkdownEngine {
+    private marked;
+    private currentConfig;
+    private headingList;
+    private highlightFn?;
+    constructor();
+    /**
+     * (Re)build the internal marked instance from the given configuration.
+     *
+     * Each call constructs a **fresh** `Marked` instance and re-applies the full
+     * extension chain in a fixed order (html-block-repair → svg → highlight →
+     * heading ids → alerts → collapsible headings → smartypants). Ordering matters:
+     * the SVG renderer must run before the highlighter so `svg` fences are not
+     * highlighted as code.
+     *
+     * The injected highlight function is **sticky**: it is only replaced when
+     * `options.highlightFn` is explicitly provided. This lets `parseToHtml`/
+     * `parseToTokens` apply per-call config overrides (which re-invoke this method
+     * *without* options) without dropping the highlighter the host wired up once.
+     *
+     * @param config Markdown configuration; merged over {@link DEFAULT_MARKDOWN_CONFIG}.
+     * @param options Engine options, e.g. an injected {@link HighlightFunction}.
+     */
+    configureMarked(config: MarkdownConfig, options?: ConfigureMarkedOptions): void;
+    /**
+     * Parse markdown to an HTML string.
+     *
+     * This is the web output path. Note it does NOT perform the DOM-based
+     * `unwrapMiscodedHtml` fixup that the Angular service applies afterward —
+     * that step requires a real DOM and stays in the host.
+     *
+     * @param markdown The markdown string to parse
+     * @param config Optional config overrides for this parse operation
+     * @returns The rendered HTML string
+     */
+    parseToHtml(markdown: string, config?: Partial<MarkdownConfig>): string;
+    /**
+     * Parse markdown to a token tree (AST).
+     *
+     * This is the framework-agnostic path consumed by non-DOM renderers (React
+     * Native, etc.). Custom block tokenizers (e.g. `svgCodeBlock`) are applied,
+     * but render-time hooks (highlight markup, collapsible HTML wrapping) are
+     * NOT — the renderer decides how to present each token.
+     *
+     * @param markdown The markdown string to tokenize
+     * @param config Optional config overrides for this parse operation
+     * @returns The marked token list
+     */
+    parseToTokens(markdown: string, config?: Partial<MarkdownConfig>): TokensList;
+    /**
+     * Get the list of headings from the last HTML parse.
+     * Useful for building a table of contents.
+     */
+    getHeadingList(): HeadingInfo[];
+    /**
+     * Get the current resolved configuration.
+     */
+    getConfig(): ResolvedMarkdownConfig;
+    /**
+     * Reset configuration to defaults (keeps any injected highlight function).
+     */
+    resetConfig(): void;
+    /**
+     * Normalize indentation in HTML blocks to prevent marked from treating
+     * indented HTML as code blocks (4 spaces = code block in markdown).
+     *
+     * This finds HTML blocks (starting with common block-level tags) and
+     * removes ALL leading whitespace from lines within those blocks to ensure
+     * marked doesn't interpret any nested content as code blocks.
+     */
+    private normalizeHtmlBlockIndentation;
+    /**
+     * Check if a line contains a self-closing tag or opens and closes the same tag
+     */
+    private isSelfClosingLine;
+    /**
+     * Update the tag stack based on opening/closing tags in the line
+     */
+    private updateTagStack;
+}
+//# sourceMappingURL=markdown-engine.d.ts.map

package/dist/engine/markdown-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-engine.d.ts","sourceRoot":"","sources":["../../src/engine/markdown-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,UAAU,EAAE,MAAM,QAAQ,CAAC;AAK5C,OAAO,EACL,cAAc,EAEd,sBAAsB,EACtB,WAAW,EACX,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAMjC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAA0D;IAC/E,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAoB;;IAOxC;;;;;;;;;;;;;;;;OAgBG;IACI,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI;IAkFtF;;;;;;;;;;OAUG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM;IA6B9E;;;;;;;;;;;OAWG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,UAAU;IAiBpF;;;OAGG;IACI,cAAc,IAAI,WAAW,EAAE;IAItC;;OAEG;IACI,SAAS,IAAI,sBAAsB;IAI1C;;OAEG;IACI,WAAW,IAAI,IAAI;IAI1B;;;;;;;OAOG;IACH,OAAO,CAAC,6BAA6B;IAsDrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,cAAc;CA+BvB"}

package/dist/engine/markdown-engine.js

@@ -0,0 +1,292 @@
+import { Marked } from 'marked';
+import { markedHighlight } from 'marked-highlight';
+import { gfmHeadingId, getHeadingList } from 'marked-gfm-heading-id';
+import markedAlert from 'marked-alert';
+import { markedSmartypants } from 'marked-smartypants';
+import { DEFAULT_MARKDOWN_CONFIG } from '../types/markdown.types';
+import { createCollapsibleHeadingsExtension } from '../extensions/collapsible-headings.extension';
+import { createSvgRendererExtension } from '../extensions/svg-renderer.extension';
+import { createHtmlBlockRepairExtension } from '../extensions/html-block-repair.extension';
+import { escapeHtml } from '../helpers/escape';
+/**
+ * Framework-agnostic markdown engine.
+ *
+ * Owns the `marked` configuration and the MemberJunction custom extensions
+ * (SVG code blocks, collapsible headings, GitHub alerts, heading ids,
+ * smartypants). It produces either:
+ *
+ * - an **HTML string** via {@link parseToHtml} — consumed by the Angular
+ *   `ng-markdown` component (which then does its DOM post-processing), or
+ * - a **token tree (AST)** via {@link parseToTokens} — consumed by the React
+ *   Native renderer (and any other non-DOM target).
+ *
+ * The engine has no DOM, Prism, or Mermaid dependency. Highlighting is injected
+ * by the caller; Mermaid and copy-button wiring are the host's responsibility.
+ */
+export class MarkdownEngine {
+    constructor() {
+        this.currentConfig = { ...DEFAULT_MARKDOWN_CONFIG };
+        this.headingList = [];
+        this.marked = new Marked();
+        this.configureMarked(this.currentConfig);
+    }
+    /**
+     * (Re)build the internal marked instance from the given configuration.
+     *
+     * Each call constructs a **fresh** `Marked` instance and re-applies the full
+     * extension chain in a fixed order (html-block-repair → svg → highlight →
+     * heading ids → alerts → collapsible headings → smartypants). Ordering matters:
+     * the SVG renderer must run before the highlighter so `svg` fences are not
+     * highlighted as code.
+     *
+     * The injected highlight function is **sticky**: it is only replaced when
+     * `options.highlightFn` is explicitly provided. This lets `parseToHtml`/
+     * `parseToTokens` apply per-call config overrides (which re-invoke this method
+     * *without* options) without dropping the highlighter the host wired up once.
+     *
+     * @param config Markdown configuration; merged over {@link DEFAULT_MARKDOWN_CONFIG}.
+     * @param options Engine options, e.g. an injected {@link HighlightFunction}.
+     */
+    configureMarked(config, options) {
+        this.currentConfig = { ...DEFAULT_MARKDOWN_CONFIG, ...config };
+        if (options && 'highlightFn' in options) {
+            this.highlightFn = options.highlightFn;
+        }
+        // Create a fresh Marked instance
+        this.marked = new Marked();
+        // Configure base options
+        this.marked.setOptions({
+            gfm: true,
+            breaks: true
+        });
+        const extensions = [];
+        // Repair HTML blocks split by a blank line (e.g. PRD mockups) so embedded
+        // raw HTML renders instead of showing as an escaped code block. Always on -
+        // precisely scoped to misparsed HTML, leaves prose and fenced code untouched.
+        extensions.push(createHtmlBlockRepairExtension());
+        // SVG code block renderer - MUST be before syntax highlighting
+        // so it can intercept svg blocks before the highlighter processes them.
+        if (this.currentConfig.enableSvgRenderer) {
+            extensions.push(createSvgRendererExtension());
+        }
+        // Syntax highlighting via an injected highlight function (e.g. Prism on web).
+        if (this.currentConfig.enableHighlight && this.highlightFn) {
+            const highlightFn = this.highlightFn;
+            const svgEnabled = this.currentConfig.enableSvgRenderer;
+            extensions.push(markedHighlight({
+                langPrefix: 'language-',
+                highlight: (code, lang) => {
+                    // Skip SVG blocks - they're handled by the SVG renderer
+                    if (lang === 'svg' && svgEnabled) {
+                        return code;
+                    }
+                    return highlightFn(code, lang);
+                }
+            }));
+        }
+        // GitHub-style heading IDs
+        if (this.currentConfig.enableHeadingIds) {
+            extensions.push(gfmHeadingId({
+                prefix: this.currentConfig.headingIdPrefix
+            }));
+        }
+        // GitHub-style alerts
+        if (this.currentConfig.enableAlerts) {
+            extensions.push(markedAlert());
+        }
+        // Collapsible headings (custom extension, HTML output path)
+        if (this.currentConfig.enableCollapsibleHeadings) {
+            extensions.push(createCollapsibleHeadingsExtension({
+                startLevel: this.currentConfig.collapsibleHeadingLevel,
+                defaultExpanded: this.currentConfig.collapsibleDefaultExpanded,
+                autoExpandLevels: this.currentConfig.autoExpandLevels
+            }));
+        }
+        // Smartypants for typography (curly quotes, em/en dashes, ellipses)
+        if (this.currentConfig.enableSmartypants) {
+            extensions.push(markedSmartypants());
+        }
+        // Apply all extensions
+        if (extensions.length > 0) {
+            this.marked.use(...extensions);
+        }
+    }
+    /**
+     * Parse markdown to an HTML string.
+     *
+     * This is the web output path. Note it does NOT perform the DOM-based
+     * `unwrapMiscodedHtml` fixup that the Angular service applies afterward —
+     * that step requires a real DOM and stays in the host.
+     *
+     * @param markdown The markdown string to parse
+     * @param config Optional config overrides for this parse operation
+     * @returns The rendered HTML string
+     */
+    parseToHtml(markdown, config) {
+        if (!markdown)
+            return '';
+        if (config) {
+            this.configureMarked({ ...this.currentConfig, ...config });
+        }
+        try {
+            // Preprocess markdown to fix indentation in HTML blocks so marked does
+            // not treat indented HTML as code blocks (pure string transform).
+            let processedMarkdown = markdown;
+            if (this.currentConfig.enableHtml) {
+                processedMarkdown = this.normalizeHtmlBlockIndentation(markdown);
+            }
+            const html = this.marked.parse(processedMarkdown);
+            // Capture heading list after parsing
+            if (this.currentConfig.enableHeadingIds) {
+                this.headingList = getHeadingList();
+            }
+            return html;
+        }
+        catch (error) {
+            console.error('Markdown parsing error:', error);
+            return `<pre class="markdown-error">${escapeHtml(markdown)}</pre>`;
+        }
+    }
+    /**
+     * Parse markdown to a token tree (AST).
+     *
+     * This is the framework-agnostic path consumed by non-DOM renderers (React
+     * Native, etc.). Custom block tokenizers (e.g. `svgCodeBlock`) are applied,
+     * but render-time hooks (highlight markup, collapsible HTML wrapping) are
+     * NOT — the renderer decides how to present each token.
+     *
+     * @param markdown The markdown string to tokenize
+     * @param config Optional config overrides for this parse operation
+     * @returns The marked token list
+     */
+    parseToTokens(markdown, config) {
+        if (config) {
+            this.configureMarked({ ...this.currentConfig, ...config });
+        }
+        if (!markdown) {
+            return this.marked.lexer('');
+        }
+        let processedMarkdown = markdown;
+        if (this.currentConfig.enableHtml) {
+            processedMarkdown = this.normalizeHtmlBlockIndentation(markdown);
+        }
+        return this.marked.lexer(processedMarkdown);
+    }
+    /**
+     * Get the list of headings from the last HTML parse.
+     * Useful for building a table of contents.
+     */
+    getHeadingList() {
+        return this.headingList;
+    }
+    /**
+     * Get the current resolved configuration.
+     */
+    getConfig() {
+        return { ...this.currentConfig };
+    }
+    /**
+     * Reset configuration to defaults (keeps any injected highlight function).
+     */
+    resetConfig() {
+        this.configureMarked(DEFAULT_MARKDOWN_CONFIG);
+    }
+    /**
+     * Normalize indentation in HTML blocks to prevent marked from treating
+     * indented HTML as code blocks (4 spaces = code block in markdown).
+     *
+     * This finds HTML blocks (starting with common block-level tags) and
+     * removes ALL leading whitespace from lines within those blocks to ensure
+     * marked doesn't interpret any nested content as code blocks.
+     */
+    normalizeHtmlBlockIndentation(markdown) {
+        // Match HTML blocks that start with common block-level tags
+        const htmlBlockTags = [
+            'div', 'table', 'thead', 'tbody', 'tr', 'td', 'th',
+            'ul', 'ol', 'li', 'p', 'section', 'article', 'header',
+            'footer', 'nav', 'main', 'aside', 'form', 'svg', 'figure'
+        ];
+        const tagPattern = htmlBlockTags.join('|');
+        // Match opening tag at start of line (possibly with leading whitespace)
+        const htmlBlockStartRegex = new RegExp(`^[ \\t]*<(${tagPattern})\\b`, 'i');
+        const lines = markdown.split('\n');
+        const result = [];
+        let inHtmlBlock = false;
+        const tagStack = [];
+        for (const line of lines) {
+            const trimmedLine = line.trimStart();
+            if (!inHtmlBlock) {
+                // Check if this line starts an HTML block
+                const match = trimmedLine.match(htmlBlockStartRegex);
+                if (match) {
+                    inHtmlBlock = true;
+                    const tag = match[1].toLowerCase();
+                    // Push to stack if it's not a self-closing tag on this line
+                    if (!this.isSelfClosingLine(trimmedLine, tag)) {
+                        tagStack.push(tag);
+                    }
+                    // Remove leading indentation
+                    result.push(trimmedLine);
+                    continue;
+                }
+                result.push(line);
+            }
+            else {
+                // We're inside an HTML block - remove ALL leading whitespace
+                // to prevent any nested content from being treated as code blocks.
+                this.updateTagStack(trimmedLine, tagStack, htmlBlockTags);
+                result.push(trimmedLine);
+                // Check if we've closed all HTML blocks
+                if (tagStack.length === 0) {
+                    inHtmlBlock = false;
+                }
+            }
+        }
+        return result.join('\n');
+    }
+    /**
+     * Check if a line contains a self-closing tag or opens and closes the same tag
+     */
+    isSelfClosingLine(line, tag) {
+        // Check for self-closing syntax: <tag ... />
+        if (new RegExp(`<${tag}[^>]*/>`, 'i').test(line)) {
+            return true;
+        }
+        // Check if tag opens and closes on same line: <tag>...</tag>
+        const openCount = (line.match(new RegExp(`<${tag}\\b`, 'gi')) || []).length;
+        const closeCount = (line.match(new RegExp(`</${tag}>`, 'gi')) || []).length;
+        return openCount > 0 && openCount === closeCount;
+    }
+    /**
+     * Update the tag stack based on opening/closing tags in the line
+     */
+    updateTagStack(line, tagStack, validTags) {
+        const openTagRegex = /<(\w+)\b[^>]*(?<!\/)>/gi;
+        const closeTagRegex = /<\/(\w+)>/gi;
+        let match;
+        // Process closing tags first (they might close tags opened earlier)
+        while ((match = closeTagRegex.exec(line)) !== null) {
+            const tag = match[1].toLowerCase();
+            const idx = tagStack.lastIndexOf(tag);
+            if (idx !== -1) {
+                tagStack.splice(idx, 1);
+            }
+        }
+        // Process opening tags
+        while ((match = openTagRegex.exec(line)) !== null) {
+            const tag = match[1].toLowerCase();
+            // Only track block-level tags we care about
+            if (validTags.includes(tag)) {
+                if (!this.isSelfClosingLine(line, tag)) {
+                    const closeRegex = new RegExp(`</${tag}>`, 'gi');
+                    const opens = (line.match(new RegExp(`<${tag}\\b`, 'gi')) || []).length;
+                    const closes = (line.match(closeRegex) || []).length;
+                    if (opens > closes) {
+                        tagStack.push(tag);
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=markdown-engine.js.map

package/dist/engine/markdown-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-engine.js","sourceRoot":"","sources":["../../src/engine/markdown-engine.ts"],"names":[],"mappings":"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"}

package/dist/extensions/collapsible-headings.extension.d.ts

@@ -0,0 +1,62 @@
+import { MarkedExtension } from 'marked';
+/**
+ * Options for the collapsible headings extension
+ */
+export interface CollapsibleHeadingsOptions {
+    /**
+     * The minimum heading level to make collapsible (1-6)
+     * Headings at this level and below will be collapsible
+     * @default 2
+     */
+    startLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * Whether sections should be expanded by default
+     * @default true
+     */
+    defaultExpanded?: boolean;
+    /**
+     * Specify which heading levels should start expanded.
+     * Takes precedence over defaultExpanded for specified levels.
+     * @default undefined (uses defaultExpanded for all levels)
+     */
+    autoExpandLevels?: number[];
+    /**
+     * CSS class prefix for generated elements
+     * @default 'collapsible'
+     */
+    classPrefix?: string;
+}
+/**
+ * Creates a marked extension that wraps heading sections in collapsible containers.
+ *
+ * This extension transforms headings into clickable toggles that can expand/collapse
+ * the content that follows them (until the next heading of equal or higher level).
+ *
+ * The key innovation is that child sections are properly NESTED inside parent sections,
+ * so collapsing a parent will hide all its children.
+ *
+ * NOTE: This extension targets the HTML output path. It produces the nested
+ * `<div class="collapsible-section">` structure that the web renderer styles and
+ * wires up. React Native does not use this extension — it derives collapsible
+ * structure from the heading tokens directly.
+ *
+ * The generated HTML structure (properly nested):
+ * ```html
+ * <div class="collapsible-section" data-level="2">
+ *   <div class="collapsible-heading-wrapper">
+ *     <h2 class="collapsible-heading" id="...">Parent Heading</h2>
+ *   </div>
+ *   <div class="collapsible-content">
+ *     <p>Content under parent...</p>
+ *     <div class="collapsible-section" data-level="3">
+ *       ...
+ *     </div>
+ *   </div>
+ * </div>
+ * ```
+ *
+ * Note: The toggle button is added dynamically by the host (e.g. the Angular
+ * component) after rendering to avoid issues with HTML sanitizers.
+ */
+export declare function createCollapsibleHeadingsExtension(options?: CollapsibleHeadingsOptions): MarkedExtension;
+//# sourceMappingURL=collapsible-headings.extension.d.ts.map

package/dist/extensions/collapsible-headings.extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapsible-headings.extension.d.ts","sourceRoot":"","sources":["../../src/extensions/collapsible-headings.extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAU,MAAM,QAAQ,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEnC;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,CAAC,EAAE,0BAA0B,GACnC,eAAe,CA8BjB"}

package/dist/extensions/collapsible-headings.extension.js

@@ -0,0 +1,174 @@
+const DEFAULT_OPTIONS = {
+    startLevel: 2,
+    defaultExpanded: true,
+    autoExpandLevels: undefined,
+    classPrefix: 'collapsible'
+};
+/**
+ * Creates a marked extension that wraps heading sections in collapsible containers.
+ *
+ * This extension transforms headings into clickable toggles that can expand/collapse
+ * the content that follows them (until the next heading of equal or higher level).
+ *
+ * The key innovation is that child sections are properly NESTED inside parent sections,
+ * so collapsing a parent will hide all its children.
+ *
+ * NOTE: This extension targets the HTML output path. It produces the nested
+ * `<div class="collapsible-section">` structure that the web renderer styles and
+ * wires up. React Native does not use this extension — it derives collapsible
+ * structure from the heading tokens directly.
+ *
+ * The generated HTML structure (properly nested):
+ * ```html
+ * <div class="collapsible-section" data-level="2">
+ *   <div class="collapsible-heading-wrapper">
+ *     <h2 class="collapsible-heading" id="...">Parent Heading</h2>
+ *   </div>
+ *   <div class="collapsible-content">
+ *     <p>Content under parent...</p>
+ *     <div class="collapsible-section" data-level="3">
+ *       ...
+ *     </div>
+ *   </div>
+ * </div>
+ * ```
+ *
+ * Note: The toggle button is added dynamically by the host (e.g. the Angular
+ * component) after rendering to avoid issues with HTML sanitizers.
+ */
+export function createCollapsibleHeadingsExtension(options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    return {
+        renderer: {
+            // Mark headings with a special marker that we'll process in postprocess
+            heading(token) {
+                const { depth, text } = token;
+                const escapedText = text.toLowerCase().replace(/[^\w]+/g, '-');
+                const id = `heading-${escapedText}`;
+                // Only make headings collapsible at or below the start level
+                if (depth >= opts.startLevel) {
+                    // Use a marker format that we'll parse in postprocess
+                    // Format: <!--COLLAPSIBLE_HEADING:level:id:text-->
+                    const marker = `<!--COLLAPSIBLE_HEADING:${depth}:${id}:${encodeURIComponent(text)}-->`;
+                    return `${marker}<h${depth} id="${id}">${text}</h${depth}>\n`;
+                }
+                // Regular heading rendering for levels above startLevel
+                return `<h${depth} id="${id}">${text}</h${depth}>\n`;
+            }
+        },
+        hooks: {
+            postprocess(html) {
+                return restructureToNestedSections(html, opts);
+            }
+        }
+    };
+}
+/**
+ * Restructures flat HTML with heading markers into properly nested collapsible sections.
+ * This is the key function that creates the hierarchical structure needed for
+ * parent collapse to affect children.
+ */
+function restructureToNestedSections(html, opts) {
+    // Parse the HTML to find all content chunks and headings
+    const markerRegex = /<!--COLLAPSIBLE_HEADING:(\d):([^:]+):([^>]+)-->/g;
+    // Split HTML by markers while capturing the markers
+    const parts = [];
+    let lastIndex = 0;
+    let match;
+    while ((match = markerRegex.exec(html)) !== null) {
+        // Add content before this marker
+        if (match.index > lastIndex) {
+            const content = html.slice(lastIndex, match.index);
+            if (content.trim()) {
+                parts.push({ type: 'content', content });
+            }
+        }
+        // Add the heading marker info
+        parts.push({
+            type: 'heading',
+            content: '', // Will be filled with the actual h tag
+            level: parseInt(match[1], 10),
+            id: match[2],
+            text: decodeURIComponent(match[3])
+        });
+        lastIndex = match.index + match[0].length;
+    }
+    // Add remaining content after last marker
+    if (lastIndex < html.length) {
+        const content = html.slice(lastIndex);
+        if (content.trim()) {
+            parts.push({ type: 'content', content });
+        }
+    }
+    // If no collapsible headings, return original HTML
+    if (!parts.some(p => p.type === 'heading')) {
+        return html;
+    }
+    // Now build the nested structure
+    return buildNestedStructure(parts, opts);
+}
+/**
+ * Determine if a heading level should start expanded based on options
+ */
+function shouldLevelBeExpanded(level, opts) {
+    // If autoExpandLevels is specified, use it
+    if (opts.autoExpandLevels !== undefined) {
+        return opts.autoExpandLevels.includes(level);
+    }
+    // Otherwise fall back to defaultExpanded
+    return opts.defaultExpanded;
+}
+/**
+ * Builds the nested HTML structure from the parsed parts.
+ */
+function buildNestedStructure(parts, opts) {
+    const result = [];
+    // Stack tracks open sections: { level }
+    const sectionStack = [];
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        if (part.type === 'content') {
+            // Regular content - just add it
+            result.push(part.content);
+        }
+        else if (part.type === 'heading' && part.level !== undefined) {
+            const level = part.level;
+            // Close any sections at same or higher level (lower number = higher level)
+            while (sectionStack.length > 0 && sectionStack[sectionStack.length - 1].level >= level) {
+                // Close the content div and section div
+                result.push('</div></div>');
+                sectionStack.pop();
+            }
+            // Determine expanded state for this specific level
+            const isExpanded = shouldLevelBeExpanded(level, opts);
+            const expandedClass = isExpanded ? '' : ' collapsed';
+            // Extract the actual h tag from the next content piece if it starts with it
+            let headingHtml = `<h${level} class="${opts.classPrefix}-heading" id="${part.id}">${part.text}</h${level}>`;
+            // Look ahead to find and remove the actual h tag from content
+            if (i + 1 < parts.length && parts[i + 1].type === 'content') {
+                const nextContent = parts[i + 1].content;
+                const hTagRegex = new RegExp(`<h${level}[^>]*id="${part.id}"[^>]*>[^<]*</h${level}>\\s*`);
+                const hTagMatch = nextContent.match(hTagRegex);
+                if (hTagMatch) {
+                    // Use the actual h tag and remove it from content
+                    headingHtml = hTagMatch[0].replace(`<h${level}`, `<h${level} class="${opts.classPrefix}-heading"`);
+                    parts[i + 1].content = nextContent.replace(hTagRegex, '');
+                }
+            }
+            // Open new section
+            result.push(`<div class="${opts.classPrefix}-section${expandedClass}" data-level="${level}">`);
+            result.push(`<div class="${opts.classPrefix}-heading-wrapper">`);
+            result.push(headingHtml);
+            result.push('</div>');
+            result.push(`<div class="${opts.classPrefix}-content">`);
+            sectionStack.push({ level });
+        }
+    }
+    // Close any remaining open sections
+    while (sectionStack.length > 0) {
+        result.push('</div></div>');
+        sectionStack.pop();
+    }
+    return result.join('');
+}
+//# sourceMappingURL=collapsible-headings.extension.js.map