@openuji/speculator 0.7.3 → 0.7.5

package/dist/parse/markdown/MdxMarkdownParser.js

@@ -0,0 +1,310 @@
+/**
+ * MDX Markdown Parser
+ *
+ * Handles mdast MDX JSX nodes and delegates by tag name to HTML handlers.
+ * This lets tags like <dfn>, <a>, <aside>, <spec-statement>, etc. share
+ * the same parsing logic across HTML and Markdown inputs.
+ */
+import { isHtmlBlockTag } from '#src/parse/utils/markdown-utils';
+import { createBlockHtmlElement, createInlineHtmlElement } from '#src/parse/utils/html-element-utils';
+function isMdxJsxNode(node) {
+    return node?.type === 'mdxJsxFlowElement' || node?.type === 'mdxJsxTextElement';
+}
+function isMdxTextExpression(node) {
+    return node?.type === 'mdxTextExpression';
+}
+function toCamelCase(name) {
+    return name.replace(/-([a-z0-9])/g, (_, char) => char.toUpperCase());
+}
+function toKebabCase(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+}
+function normalizeAttrValue(attrValue) {
+    if (attrValue === null || attrValue === undefined)
+        return true;
+    if (typeof attrValue === 'string' || typeof attrValue === 'number' || typeof attrValue === 'boolean') {
+        return attrValue;
+    }
+    return undefined;
+}
+function setAttrAliases(properties, name, value) {
+    properties[name] = value;
+    const camelName = toCamelCase(name);
+    if (camelName !== name)
+        properties[camelName] = value;
+    const kebabName = toKebabCase(name);
+    if (kebabName !== name)
+        properties[kebabName] = value;
+    if (name === 'class')
+        properties.className = value;
+    if (name === 'className')
+        properties.class = value;
+}
+function toMdxProperties(node) {
+    const properties = {};
+    for (const attr of node.attributes ?? []) {
+        if (!attr || attr.type === 'mdxJsxExpressionAttribute')
+            continue;
+        if (typeof attr.name !== 'string' || attr.name.length === 0)
+            continue;
+        const attrValue = normalizeAttrValue(attr.value);
+        if (attrValue === undefined)
+            continue;
+        setAttrAliases(properties, attr.name, attrValue);
+    }
+    return properties;
+}
+function toMdxVirtualElement(node, mode) {
+    const mdxChildren = node.children ?? [];
+    const childrenForMode = mode === 'block' && node.type === 'mdxJsxTextElement'
+        ? [{
+                type: 'paragraph',
+                children: mdxChildren,
+                position: node.position,
+            }]
+        : mdxChildren;
+    return {
+        type: 'element',
+        tagName: node.name ?? '',
+        properties: toMdxProperties(node),
+        children: childrenForMode,
+        position: node.position,
+        __mdxSource: node,
+    };
+}
+function isMdxVirtualElement(element) {
+    return '__mdxSource' in element;
+}
+function attrValueToString(value, attrName) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number')
+        return String(value);
+    if (Array.isArray(value))
+        return value.map((part) => String(part)).join(' ');
+    if (typeof value === 'boolean' && value)
+        return attrName;
+    return undefined;
+}
+function getMdxAttr(element, name) {
+    const properties = element.properties;
+    if (!properties)
+        return undefined;
+    const candidates = [name, toCamelCase(name), toKebabCase(name)];
+    for (const candidate of candidates) {
+        const normalized = attrValueToString(properties[candidate], name);
+        if (normalized !== undefined)
+            return normalized;
+    }
+    return undefined;
+}
+function collectMdxText(node) {
+    if (Array.isArray(node)) {
+        return node.map(collectMdxText).join('');
+    }
+    if (!node || typeof node !== 'object')
+        return '';
+    const candidate = node;
+    if ((candidate.type === 'text' || candidate.type === 'inlineCode' || candidate.type === 'code')
+        && typeof candidate.value === 'string') {
+        return candidate.value;
+    }
+    if (Array.isArray(candidate.children)) {
+        return candidate.children.map(collectMdxText).join('');
+    }
+    return '';
+}
+function createMdxContext(ctx) {
+    return {
+        ...ctx,
+        getAttr: (element, name) => {
+            if (isMdxVirtualElement(element)) {
+                const value = getMdxAttr(element, name);
+                if (value !== undefined)
+                    return value;
+            }
+            return ctx.getAttr(element, name);
+        },
+        getTextContent: (element) => {
+            if (isMdxVirtualElement(element)) {
+                return collectMdxText(element.children);
+            }
+            return ctx.getTextContent(element);
+        },
+    };
+}
+function inlineResultToParagraph(result, sourcePos) {
+    if (result === null)
+        return null;
+    const inlines = Array.isArray(result) ? result : [result];
+    if (inlines.length === 0)
+        return null;
+    const paragraph = {
+        type: 'paragraph',
+        children: inlines,
+    };
+    if (sourcePos)
+        paragraph.sourcePos = sourcePos;
+    return paragraph;
+}
+function appendBlockResult(target, result) {
+    if (result === null)
+        return;
+    if (Array.isArray(result)) {
+        target.push(...result);
+        return;
+    }
+    target.push(result);
+}
+function isBlockLikeMdxTag(node, ctx) {
+    const tagName = (node.name ?? '').toLowerCase();
+    if (!tagName)
+        return false;
+    if (ctx.registry.getHtmlBlockHandler(tagName)?.handleBlock)
+        return true;
+    if (isHtmlBlockTag(tagName))
+        return true;
+    if (tagName.includes('-'))
+        return true;
+    return false;
+}
+function fallbackBlockFromChildren(node, ctx) {
+    if (node.name) {
+        const virtualElement = toMdxVirtualElement(node, 'block');
+        let children = ctx.transformBlockChildren(node.children ?? []);
+        if (children.length === 0) {
+            const inlines = ctx.transformInlineChildren(node.children ?? []);
+            if (inlines.length > 0) {
+                const paragraph = {
+                    type: 'paragraph',
+                    children: inlines,
+                };
+                const sourcePos = ctx.createSourcePos(node);
+                if (sourcePos)
+                    paragraph.sourcePos = sourcePos;
+                children = [paragraph];
+            }
+        }
+        return createBlockHtmlElement(virtualElement, ctx, children);
+    }
+    const blocks = ctx.transformBlockChildren(node.children ?? []);
+    if (blocks.length > 0)
+        return blocks;
+    const inlines = ctx.transformInlineChildren(node.children ?? []);
+    if (inlines.length === 0)
+        return null;
+    const paragraph = {
+        type: 'paragraph',
+        children: inlines,
+    };
+    const sourcePos = ctx.createSourcePos(node);
+    if (sourcePos)
+        paragraph.sourcePos = sourcePos;
+    return paragraph;
+}
+function fallbackInlineFromChildren(node, ctx) {
+    if (node.name) {
+        const virtualElement = toMdxVirtualElement(node, 'inline');
+        return createInlineHtmlElement(virtualElement, ctx, ctx.transformInlineChildren(node.children ?? []));
+    }
+    const inlines = ctx.transformInlineChildren(node.children ?? []);
+    if (inlines.length === 0)
+        return null;
+    return inlines.length === 1 ? inlines[0] : inlines;
+}
+function handleMdxBlock(node, ctx) {
+    const tagName = (node.name ?? '').toLowerCase();
+    if (!tagName)
+        return fallbackBlockFromChildren(node, ctx);
+    const wrapperCtx = createMdxContext(ctx);
+    const blockHandler = ctx.registry.getHtmlBlockHandler(tagName);
+    if (blockHandler?.handleBlock) {
+        return blockHandler.handleBlock(toMdxVirtualElement(node, 'block'), wrapperCtx);
+    }
+    const inlineHandler = ctx.registry.getHtmlInlineHandler(tagName);
+    if (inlineHandler?.handleInline) {
+        const inlineResult = inlineHandler.handleInline(toMdxVirtualElement(node, 'inline'), wrapperCtx);
+        return inlineResultToParagraph(inlineResult, ctx.createSourcePos(node));
+    }
+    return fallbackBlockFromChildren(node, ctx);
+}
+function handleMdxInline(node, ctx) {
+    const tagName = (node.name ?? '').toLowerCase();
+    if (!tagName)
+        return fallbackInlineFromChildren(node, ctx);
+    const wrapperCtx = createMdxContext(ctx);
+    const inlineHandler = ctx.registry.getHtmlInlineHandler(tagName);
+    if (inlineHandler?.handleInline) {
+        return inlineHandler.handleInline(toMdxVirtualElement(node, 'inline'), wrapperCtx);
+    }
+    return fallbackInlineFromChildren(node, ctx);
+}
+function handleMdxExpressionInline(node, ctx) {
+    const rawValue = typeof node.value === 'string' ? node.value : '';
+    if (!rawValue)
+        return null;
+    // Recreate original source text so shorthand parser can still detect patterns
+    // like {{Interface}} that MDX tokenizes as mdxTextExpression.
+    const syntheticText = {
+        type: 'text',
+        value: `{${rawValue}}`,
+        position: node.position,
+    };
+    const inlines = ctx.transformInlineChildren([syntheticText]);
+    if (inlines.length === 0)
+        return null;
+    return inlines.length === 1 ? inlines[0] : inlines;
+}
+/**
+ * Markdown parser module for MDX nodes.
+ */
+export const MdxMarkdownParser = {
+    name: 'MdxMarkdownParser',
+    handles: ['mdxJsxFlowElement', 'mdxJsxTextElement', 'mdxTextExpression', 'paragraph'],
+    order: 5,
+    handleBlock(node, ctx) {
+        // When a single MDX tag sits inside a paragraph, allow block handlers
+        // (e.g. <spec-statement>) to claim it before Paragraph parser runs.
+        if (node.type === 'paragraph') {
+            const paragraph = node;
+            if (paragraph.children.length === 1) {
+                const onlyChild = paragraph.children[0];
+                if (!isMdxJsxNode(onlyChild))
+                    return null;
+                const tagName = (onlyChild.name ?? '').toLowerCase();
+                const blockHandler = tagName ? ctx.registry.getHtmlBlockHandler(tagName) : undefined;
+                if (!blockHandler?.handleBlock && !isHtmlBlockTag(tagName) && !tagName.includes('-'))
+                    return null;
+                return handleMdxBlock(onlyChild, ctx);
+            }
+            const blocks = [];
+            let sawBlockLikeTag = false;
+            for (const child of paragraph.children) {
+                if (isMdxJsxNode(child) && isBlockLikeMdxTag(child, ctx)) {
+                    sawBlockLikeTag = true;
+                    appendBlockResult(blocks, handleMdxBlock(child, ctx));
+                    continue;
+                }
+                if (child.type === 'text' && child.value.trim().length === 0) {
+                    continue;
+                }
+                // Mixed content paragraph (normal inline text + MDX tags): let
+                // ParagraphsMarkdownParser handle this as an inline paragraph.
+                return null;
+            }
+            return sawBlockLikeTag ? blocks : null;
+        }
+        if (!isMdxJsxNode(node))
+            return null;
+        return handleMdxBlock(node, ctx);
+    },
+    handleInline(node, ctx) {
+        if (isMdxTextExpression(node)) {
+            return handleMdxExpressionInline(node, ctx);
+        }
+        if (!isMdxJsxNode(node))
+            return null;
+        return handleMdxInline(node, ctx);
+    },
+};
+//# sourceMappingURL=MdxMarkdownParser.js.map

package/dist/parse/markdown/MdxMarkdownParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdxMarkdownParser.js","sourceRoot":"","sources":["../../../src/parse/markdown/MdxMarkdownParser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAwBtG,SAAS,YAAY,CAAC,IAAyC;IAC3D,OAAO,IAAI,EAAE,IAAI,KAAK,mBAAmB,IAAI,IAAI,EAAE,IAAI,KAAK,mBAAmB,CAAC;AACpF,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAyC;IAClE,OAAO,IAAI,EAAE,IAAI,KAAK,mBAAmB,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAkB;IAC1C,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;QACnG,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,UAA6C,EAAE,IAAY,EAAE,KAAwB;IACzG,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAEzB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,SAAS,KAAK,IAAI;QAAE,UAAU,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAEtD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,SAAS,KAAK,IAAI;QAAE,UAAU,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;IAEtD,IAAI,IAAI,KAAK,OAAO;QAAE,UAAU,CAAC,SAAS,GAAG,KAAK,CAAC;IACnD,IAAI,IAAI,KAAK,WAAW;QAAE,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC;AACvD,CAAC;AAED,SAAS,eAAe,CAAC,IAAgB;IACrC,MAAM,UAAU,GAAsC,EAAE,CAAC;IAEzD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,2BAA2B;YAAE,SAAS;QACjE,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEtE,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS;QAEtC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAgB,EAAE,IAAwB;IACnE,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IAExC,MAAM,eAAe,GAAuB,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB;QAC7F,CAAC,CAAC,CAAC;gBACC,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,WAA+C;gBACzD,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACK,CAAC;QACjC,CAAC,CAAC,WAAW,CAAC;IAElB,OAAO;QACH,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACxB,UAAU,EAAE,eAAe,CAAC,IAAI,CAAC;QACjC,QAAQ,EAAE,eAAiD;QAC3D,QAAQ,EAAE,IAAI,CAAC,QAA+B;QAC9C,WAAW,EAAE,IAAI;KACpB,CAAC;AACN,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAgB;IACzC,OAAO,aAAa,IAAI,OAAO,CAAC;AACpC,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,QAAgB;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7E,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK;QAAE,OAAO,QAAQ,CAAC;IACzD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,UAAU,CAAC,OAA0B,EAAE,IAAY;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAiD,CAAC;IAC7E,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QAClE,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO,UAAU,CAAC;IACpD,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,cAAc,CAAC,IAAa;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEjD,MAAM,SAAS,GAAG,IAAgE,CAAC;IAEnF,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC;WACxF,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO,SAAS,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAiB;IACvC,OAAO;QACH,GAAG,GAAG;QACN,OAAO,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;YACvB,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACxC,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,KAAK,CAAC;YAC1C,CAAC;YACD,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE;YACxB,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,OAAO,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;KACJ,CAAC;AACN,CAAC;AAED,SAAS,uBAAuB,CAAC,MAA2B,EAAE,SAAsD;IAChH,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,OAAO,GAAa,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,SAAS,GAAmB;QAC9B,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,OAAO;KACpB,CAAC;IACF,IAAI,SAAS;QAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/C,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA2B,EAAE,MAA0B;IAC9E,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACvB,OAAO;IACX,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAgB,EAAE,GAAiB;IAC1D,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,WAAW;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,cAAc,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAgB,EAAE,GAAiB;IAClE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,QAAQ,GAAG,GAAG,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAE/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,SAAS,GAAmB;oBAC9B,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,OAAO;iBACpB,CAAC;gBACF,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;gBAC5C,IAAI,SAAS;oBAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC/C,QAAQ,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;QAED,OAAO,sBAAsB,CAAC,cAAc,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAErC,MAAM,OAAO,GAAG,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,SAAS,GAAmB;QAC9B,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,OAAO;KACpB,CAAC;IAEF,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,SAAS;QAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC;IAE/C,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,0BAA0B,CAAC,IAAgB,EAAE,GAAiB;IACnE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3D,OAAO,uBAAuB,CAC1B,cAAc,EACd,GAAG,EACH,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CACnD,CAAC;IACN,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CAAC,IAAgB,EAAE,GAAiB;IACvD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,yBAAyB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE1D,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,YAAY,EAAE,WAAW,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC,WAAW,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACjE,IAAI,aAAa,EAAE,YAAY,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;QACjG,OAAO,uBAAuB,CAAC,YAAY,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,yBAAyB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,eAAe,CAAC,IAAgB,EAAE,GAAiB;IACxD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE3D,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACjE,IAAI,aAAa,EAAE,YAAY,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,yBAAyB,CAAC,IAA2B,EAAE,GAAiB;IAC7E,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,8EAA8E;IAC9E,8DAA8D;IAC9D,MAAM,aAAa,GAAG;QAClB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,IAAI,QAAQ,GAAG;QACtB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACN,CAAC;IAEtB,MAAM,OAAO,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAyB;IACnD,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,CAAC;IACrF,KAAK,EAAE,CAAC;IAER,WAAW,CAAC,IAAsB,EAAE,GAAiB;QACjD,sEAAsE;QACtE,oEAAoE;QACpE,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAiB,CAAC;YACpC,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAqB,CAAC;gBAC5D,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAE1C,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;gBACrD,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACrF,IAAI,CAAC,YAAY,EAAE,WAAW,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAElG,OAAO,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,MAAM,GAAwB,EAAE,CAAC;YACvC,IAAI,eAAe,GAAG,KAAK,CAAC;YAC5B,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,QAA8B,EAAE,CAAC;gBAC3D,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;oBACvD,eAAe,GAAG,IAAI,CAAC;oBACvB,iBAAiB,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;oBACtD,SAAS;gBACb,CAAC;gBAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3D,SAAS;gBACb,CAAC;gBAED,+DAA+D;gBAC/D,+DAA+D;gBAC/D,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,OAAO,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,YAAY,CAAC,IAAsB,EAAE,GAAiB;QAClD,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,yBAAyB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;CACJ,CAAC"}

package/dist/parse/markdown/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/parse/markdown/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACR,OAAO,EACP,KAAK,EAGR,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,oBAAoB,EAIvB,MAAM,qBAAqB,CAAC;AAqC7B;;GAEG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACjD,QAAQ,CAAC,MAAM,EAAG,UAAU,CAAU;IAEtC,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,QAAQ,GAAE,oBAAsC;IAI5D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE;IAkB5C;;OAEG;IACH,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAgBlC"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/parse/markdown/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACR,OAAO,EACP,KAAK,EAGR,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,oBAAoB,EAIvB,MAAM,qBAAqB,CAAC;AAqD7B;;GAEG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACjD,QAAQ,CAAC,MAAM,EAAG,UAAU,CAAU;IAEtC,OAAO,CAAC,SAAS,CAIiB;IAElC,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,QAAQ,GAAE,oBAAsC;IAI5D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE;IA8C5C;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAgBlC"}

package/dist/parse/markdown/parser.js

@@ -7,8 +7,9 @@
 import { unified } from 'unified';
 import remarkParse from 'remark-parse';
 import remarkGfm from 'remark-gfm';
+import { remarkMdxAgnostic, remarkHeadingAttrBlocks } from './plugins.js';
 import { defaultRegistry, } from '#src/parse/registry';
-import { escapeShorthandPipesInTables } from '../utils/markdown-utils.js';
+import { escapeShorthandPipesInTables, normalizeMdxTags } from '../utils/markdown-utils.js';
 /**
  * Create source position from mdast node position
  */
@@ -38,12 +39,31 @@ function createSourcePos(unit, node) {
     }
     return result;
 }
+function adjustErrorLineNumbers(error, startLine) {
+    if (!(error instanceof Error) || startLine <= 1)
+        return;
+    const startOff = startLine - 1;
+    // Match (L:C), (L:C-L:C), or even just L:C if MDX format changes
+    const posRegex = /(\(?|)(\d+):(\d+)(?:-(\d+):(\d+))?(\)?|)/g;
+    error.message = error.message.replace(posRegex, (_match, openParen = '', l1, c1, l2, c2, closeParen = '') => {
+        const nl1 = parseInt(l1) + startOff;
+        if (l2 && c2) {
+            const nl2 = parseInt(l2) + startOff;
+            return `${openParen}${nl1}:${c1}-${nl2}:${c2}${closeParen}`;
+        }
+        return `${openParen}${nl1}:${c1}${closeParen}`;
+    });
+}
 /**
  * Markdown unit parser implementation using handler registry
  */
 export class MarkdownUnitParser {
     format = 'markdown';
-    processor = unified().use(remarkParse).use(remarkGfm);
+    processor = unified()
+        .use(remarkParse)
+        .use(remarkGfm)
+        .use(remarkMdxAgnostic)
+        .use(remarkHeadingAttrBlocks);
     registry;
     constructor(registry = defaultRegistry) {
         this.registry = registry;
@@ -52,13 +72,41 @@ export class MarkdownUnitParser {
      * Parse markdown unit to AST blocks
      */
     parse(unit) {
-        // Escape shorthand pipes in table lines before GFM splits them into cells
-        const content = escapeShorthandPipesInTables(unit.content);
-        const tree = this.processor.parse(content);
+        let content = unit.content;
+        // Refined pre-processing for MDX:
+        // 1. Escape shorthand pipes in tables (GFM compat)
+        content = escapeShorthandPipesInTables(content);
+        // Parse to mdast tree
+        let tree;
+        try {
+            tree = this.processor.parse(content);
+        }
+        catch (initialError) {
+            // Retry once after normalizing MDX block-like tags. This rescues cases
+            // where custom tags begin inline and then cross block boundaries.
+            const normalizedContent = normalizeMdxTags(content);
+            if (normalizedContent !== content) {
+                try {
+                    content = normalizedContent;
+                    tree = this.processor.parse(content);
+                }
+                catch (normalizedError) {
+                    adjustErrorLineNumbers(normalizedError, unit.startLine);
+                    throw normalizedError;
+                }
+            }
+            else {
+                adjustErrorLineNumbers(initialError, unit.startLine);
+                throw initialError;
+            }
+        }
+        // Run transformers (like remarkHeadingAttrBlocks)
+        // We use runSync because our plugins are currently synchronous
+        const transformedTree = this.processor.runSync(tree);
         // Create context for handlers
         const ctx = this.createContext(unit);
         const blocks = [];
-        for (const child of tree.children) {
+        for (const child of transformedTree.children) {
             const blocksResult = this.transformBlock(child, ctx);
             blocks.push(...blocksResult);
         }
@@ -68,17 +116,15 @@ export class MarkdownUnitParser {
      * Create parse context for handlers
      */
     createContext(unit) {
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        const self = this;
         return {
             unit,
             createSourcePos: (node) => createSourcePos(unit, node),
-            transformInlineChildren: (children) => self.transformInlineChildren(children, unit),
+            transformInlineChildren: (children) => this.transformInlineChildren(children, unit),
             transformBlockChildren: (children) => {
                 const results = [];
-                const ctx = self.createContext(unit);
+                const ctx = this.createContext(unit);
                 for (const child of children) {
-                    const blocksResult = self.transformBlock(child, ctx);
+                    const blocksResult = this.transformBlock(child, ctx);
                     results.push(...blocksResult);
                 }
                 return results;
@@ -91,7 +137,7 @@ export class MarkdownUnitParser {
                         text += child.value;
                     }
                     else if (child.type === 'element') {
-                        text += self.createContext(unit).getTextContent(child);
+                        text += this.createContext(unit).getTextContent(child);
                     }
                 }
                 return text;
@@ -104,7 +150,7 @@ export class MarkdownUnitParser {
                     return val.join(' ');
                 return undefined;
             },
-            registry: self.registry,
+            registry: this.registry,
         };
     }
     /**

package/dist/parse/markdown/parser.js.map

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

package/dist/parse/markdown/plugins.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Markdown Plugins
+ *
+ * Custom remark plugins for MDX and attribute blocks.
+ */
+import type { Processor } from 'unified';
+import type { Root } from 'mdast';
+type HeadingAttributeValue = string | boolean;
+type HeadingAttributeMap = Record<string, HeadingAttributeValue>;
+/**
+ * Enables MDX (JSX/expressions) without full JS validation.
+ * This turns <spec-statement> into MDast MDX nodes instead of raw HTML nodes.
+ */
+export declare function remarkMdxAgnostic(this: Processor): void;
+/**
+ * Parses attribute text into a property object.
+ * Handles #id and key="value" or key='value' or key=value.
+ */
+export declare function parseAttrText(text: string): HeadingAttributeMap;
+/**
+ * Plugin to process heading attribute blocks { #id data-cop-concept="..." }
+ * when they appear as an mdxTextExpression at the end of a heading.
+ */
+export declare function remarkHeadingAttrBlocks(): (tree: Root) => void;
+export {};
+//# sourceMappingURL=plugins.d.ts.map

package/dist/parse/markdown/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../src/parse/markdown/plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAIlC,KAAK,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC;AAC9C,KAAK,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AASjE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,QAmBhD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,uBAsBzC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,KAC7B,MAAM,IAAI,UA2BnB"}

package/dist/parse/markdown/plugins.js

@@ -0,0 +1,83 @@
+/**
+ * Markdown Plugins
+ *
+ * Custom remark plugins for MDX and attribute blocks.
+ */
+import { mdx } from "micromark-extension-mdx";
+import { mdxFromMarkdown, mdxToMarkdown } from "mdast-util-mdx";
+import { visit } from "unist-util-visit";
+/**
+ * Enables MDX (JSX/expressions) without full JS validation.
+ * This turns <spec-statement> into MDast MDX nodes instead of raw HTML nodes.
+ */
+export function remarkMdxAgnostic() {
+    const data = this.data();
+    const micromarkExtensions = data.micromarkExtensions ?? [];
+    const fromMarkdownExtensions = data.fromMarkdownExtensions ?? [];
+    const toMarkdownExtensions = data.toMarkdownExtensions ?? [];
+    micromarkExtensions.push(mdx());
+    fromMarkdownExtensions.push(mdxFromMarkdown());
+    // optional: only if you also use remark-stringify later
+    toMarkdownExtensions.push(mdxToMarkdown());
+    data.micromarkExtensions = micromarkExtensions;
+    data.fromMarkdownExtensions = fromMarkdownExtensions;
+    data.toMarkdownExtensions = toMarkdownExtensions;
+}
+/**
+ * Parses attribute text into a property object.
+ * Handles #id and key="value" or key='value' or key=value.
+ */
+export function parseAttrText(text) {
+    // text is the inside of `{...}` (no braces), e.g. '#node data-cop-concept="node"'
+    const parts = text.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g) ?? [];
+    const props = {};
+    for (const p of parts) {
+        if (p.startsWith("#")) {
+            props.id = p.slice(1);
+            continue;
+        }
+        if (p.startsWith(".")) {
+            props[p.slice(1)] = true;
+            continue;
+        }
+        if (p.includes("=")) {
+            const [k, ...rest] = p.split("=");
+            let v = rest.join("=");
+            v = v.replace(/^['"]|['"]$/g, "");
+            props[k] = v;
+        }
+    }
+    return props;
+}
+/**
+ * Plugin to process heading attribute blocks { #id data-cop-concept="..." }
+ * when they appear as an mdxTextExpression at the end of a heading.
+ */
+export function remarkHeadingAttrBlocks() {
+    return (tree) => {
+        if (!tree)
+            return;
+        visit(tree, "heading", (node) => {
+            const heading = node;
+            const last = heading.children?.[heading.children.length - 1];
+            if (!last)
+                return;
+            if (last.type !== "mdxTextExpression" && last.type !== "text")
+                return;
+            const raw = String(last.value ?? "").trim();
+            if (!raw.startsWith("{") && !raw.startsWith("#") && !raw.startsWith(".") && !raw.includes("="))
+                return;
+            const props = parseAttrText(raw);
+            // Remove the attribute expression from children
+            heading.children?.pop();
+            // Trim trailing whitespace from the new last child if it's text
+            const newLast = heading.children?.[heading.children.length - 1];
+            if (newLast && newLast.type === 'text' && typeof newLast.value === 'string') {
+                newLast.value = newLast.value.replace(/\s+$/, '');
+            }
+            heading.data ??= {};
+            heading.data.hProperties = { ...(heading.data.hProperties || {}), ...props };
+        });
+    };
+}
+//# sourceMappingURL=plugins.js.map

package/dist/parse/markdown/plugins.js.map

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

package/dist/parse/markdown/remark-mdx-jsx-only.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A custom remark plugin to ONLY enable MDX JSX (HTML-like tags)
+ * without enabling JS expressions, ESM imports/exports, etc.
+ *
+ * This enables us to natively parse complex HTML trees in Markdown
+ * using the remark ecosystem, without breaking on normal `{ }`
+ * characters that appear in specs (such as IDL blocks).
+ */
+export default function remarkMdxJsxOnly(this: any): void;
+//# sourceMappingURL=remark-mdx-jsx-only.d.ts.map

package/dist/parse/markdown/remark-mdx-jsx-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-mdx-jsx-only.d.ts","sourceRoot":"","sources":["../../../src/parse/markdown/remark-mdx-jsx-only.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,IAAI,EAAE,GAAG,QAcjD"}

package/dist/parse/markdown/remark-mdx-jsx-only.js

@@ -0,0 +1,26 @@
+import { mdxJsx } from 'micromark-extension-mdx-jsx';
+import { mdxJsxFromMarkdown, mdxJsxToMarkdown } from 'mdast-util-mdx-jsx';
+import * as acorn from 'acorn';
+/**
+ * A custom remark plugin to ONLY enable MDX JSX (HTML-like tags)
+ * without enabling JS expressions, ESM imports/exports, etc.
+ *
+ * This enables us to natively parse complex HTML trees in Markdown
+ * using the remark ecosystem, without breaking on normal `{ }`
+ * characters that appear in specs (such as IDL blocks).
+ */
+export default function remarkMdxJsxOnly() {
+    const data = this.data();
+    function add(field, value) {
+        if (data[field]) {
+            data[field].push(value);
+        }
+        else {
+            data[field] = [value];
+        }
+    }
+    add('micromarkExtensions', mdxJsx({ acorn, addResult: true }));
+    add('fromMarkdownExtensions', mdxJsxFromMarkdown());
+    add('toMarkdownExtensions', mdxJsxToMarkdown());
+}
+//# sourceMappingURL=remark-mdx-jsx-only.js.map

package/dist/parse/markdown/remark-mdx-jsx-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-mdx-jsx-only.js","sourceRoot":"","sources":["../../../src/parse/markdown/remark-mdx-jsx-only.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAEzB,SAAS,GAAG,CAAC,KAAa,EAAE,KAAU;QAClC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACd,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,GAAG,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,GAAG,CAAC,wBAAwB,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACpD,GAAG,CAAC,sBAAsB,EAAE,gBAAgB,EAAE,CAAC,CAAC;AACpD,CAAC"}