@openuji/speculator 0.7.4 → 0.8.0

package/dist/parse/markdown/HeadingsMarkdownParser.js

@@ -13,37 +13,12 @@ export const HeadingsMarkdownParser = {
     handleBlock(node, ctx) {
         const headingNode = node;
         const sourcePos = ctx.createSourcePos(node);
-        // Detect attribute block { .unnumbered #id data-cop-concept="..." }
-        let unnumbered = false;
-        let explicitId;
-        let dataCopConcept;
-        const children = headingNode.children;
-        if (children.length > 0) {
-            const lastChild = children[children.length - 1];
-            if (lastChild.type === 'text') {
-                const attrRegex = /\s*\{([^}]+)\}\s*$/;
-                const match = attrRegex.exec(lastChild.value);
-                if (match) {
-                    const attrContent = match[1];
-                    // Parse .unnumbered
-                    if (/\.unnumbered\b/.test(attrContent)) {
-                        unnumbered = true;
-                    }
-                    // Parse #id
-                    const idMatch = /#([^\s}]+)/.exec(attrContent);
-                    if (idMatch) {
-                        explicitId = idMatch[1];
-                    }
-                    // Parse data-cop-concept
-                    const dataCopMatch = /data-cop-concept=(?:"([^"]+)"|'([^']+)'|([^\s}]+))/.exec(attrContent);
-                    if (dataCopMatch) {
-                        dataCopConcept = dataCopMatch[1] || dataCopMatch[2] || dataCopMatch[3];
-                    }
-                    // Remove the attribute block from text
-                    lastChild.value = lastChild.value.replace(attrRegex, '');
-                }
-            }
-        }
+        // Read attributes from data (populated by remarkHeadingAttrBlocks)
+        const props = headingNode.data?.hProperties ?? {};
+        const noToc = props['data-no-toc'] !== undefined && props['data-no-toc'] !== 'false' && props['data-no-toc'] !== false;
+        const noTocCount = props['data-no-toc-count'] !== undefined && props['data-no-toc-count'] !== 'false' && props['data-no-toc-count'] !== false;
+        const explicitId = props.id;
+        const dataCopConcept = props['data-cop-concept'];
         const result = {
             type: 'heading',
             depth: headingNode.depth,
@@ -51,8 +26,10 @@ export const HeadingsMarkdownParser = {
             children: ctx.transformInlineChildren(headingNode.children),
             dataCopConcept,
         };
-        if (unnumbered)
-            result.unnumbered = true;
+        if (noToc)
+            result.noToc = true;
+        if (noTocCount)
+            result.noTocCount = true;
         if (sourcePos)
             result.sourcePos = sourcePos;
         return result;

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

@@ -1 +1 @@
-{"version":3,"file":"HeadingsMarkdownParser.js","sourceRoot":"","sources":["../../../src/parse/markdown/HeadingsMarkdownParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAyB;IACxD,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,KAAK,EAAE,EAAE;IAET,WAAW,CAAC,IAAsB,EAAE,GAAiB;QACjD,MAAM,WAAW,GAAG,IAAe,CAAC;QACpC,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE5C,oEAAoE;QACpE,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,UAA8B,CAAC;QACnC,IAAI,cAAkC,CAAC;QAEvC,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;QACtC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAChD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,oBAAoB,CAAC;gBACvC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC9C,IAAI,KAAK,EAAE,CAAC;oBACR,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBAE7B,oBAAoB;oBACpB,IAAI,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;wBACrC,UAAU,GAAG,IAAI,CAAC;oBACtB,CAAC;oBAED,YAAY;oBACZ,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBAC/C,IAAI,OAAO,EAAE,CAAC;wBACV,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBAC5B,CAAC;oBAED,yBAAyB;oBACzB,MAAM,YAAY,GAAG,oDAAoD,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBAC5F,IAAI,YAAY,EAAE,CAAC;wBACf,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;oBAC3E,CAAC;oBAED,uCAAuC;oBACvC,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAC7D,CAAC;YACL,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAiB;YACzB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,EAAE,EAAE,UAAU;YACd,QAAQ,EAAE,GAAG,CAAC,uBAAuB,CAAC,WAAW,CAAC,QAAQ,CAAC;YAC3D,cAAc;SACjB,CAAC;QAEF,IAAI,UAAU;YAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;QACzC,IAAI,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAE5C,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ,CAAC"}
+{"version":3,"file":"HeadingsMarkdownParser.js","sourceRoot":"","sources":["../../../src/parse/markdown/HeadingsMarkdownParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAyB;IACxD,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,KAAK,EAAE,EAAE;IAET,WAAW,CAAC,IAAsB,EAAE,GAAiB;QACjD,MAAM,WAAW,GAAG,IAAuB,CAAC;QAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE5C,mEAAmE;QACnE,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC;QAElD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,KAAK,CAAC;QACvH,MAAM,UAAU,GAAG,KAAK,CAAC,mBAAmB,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,mBAAmB,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC,mBAAmB,CAAC,KAAK,KAAK,CAAC;QAC9I,MAAM,UAAU,GAAG,KAAK,CAAC,EAAwB,CAAC;QAClD,MAAM,cAAc,GAAG,KAAK,CAAC,kBAAkB,CAAuB,CAAC;QAEvE,MAAM,MAAM,GAAiB;YACzB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,EAAE,EAAE,UAAU;YACd,QAAQ,EAAE,GAAG,CAAC,uBAAuB,CAAC,WAAW,CAAC,QAAQ,CAAC;YAC3D,cAAc;SACjB,CAAC;QAEF,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;QAC/B,IAAI,UAAU;YAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;QACzC,IAAI,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAE5C,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * MDX JSX Markdown Parser
+ *
+ * Bridges MDX custom elements to the HTML handler registry.
+ */
+import { type MarkdownParserModule } from '#src/parse/registry';
+export declare const MdxJsxMarkdownParser: MarkdownParserModule;
+//# sourceMappingURL=MdxJsxMarkdownParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MdxJsxMarkdownParser.d.ts","sourceRoot":"","sources":["../../../src/parse/markdown/MdxJsxMarkdownParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,KAAK,oBAAoB,EAAmG,MAAM,qBAAqB,CAAC;AAUjK,eAAO,MAAM,oBAAoB,EAAE,oBAclC,CAAC"}

package/dist/parse/markdown/MdxJsxMarkdownParser.js

@@ -0,0 +1,61 @@
+/**
+ * MDX JSX Markdown Parser
+ *
+ * Bridges MDX custom elements to the HTML handler registry.
+ */
+export const MdxJsxMarkdownParser = {
+    name: 'MdxJsxMarkdownParser',
+    handles: ['mdxJsxFlowElement', 'mdxJsxTextElement'],
+    order: 4, // Run early
+    handleBlock(node, ctx) {
+        if (node.type !== 'mdxJsxFlowElement')
+            return null;
+        return handleMdxNode(node, ctx, true);
+    },
+    handleInline(node, ctx) {
+        if (node.type !== 'mdxJsxTextElement')
+            return null;
+        return handleMdxNode(node, ctx, false);
+    }
+};
+function handleMdxNode(node, ctx, isBlock) {
+    // If it's a fragment or null name, just process children.
+    if (!node.name) {
+        if (isBlock)
+            return ctx.transformBlockChildren(node.children);
+        return ctx.transformInlineChildren(node.children);
+    }
+    const tagName = node.name.toLowerCase();
+    // Convert attributes to HAST properties
+    const properties = {};
+    for (const attr of node.attributes) {
+        if (attr.type === 'mdxJsxAttribute') {
+            properties[attr.name] = attr.value === null ? true : attr.value;
+        }
+    }
+    // Create a simulated HAST Element to satisfy HtmlParserModule signatures
+    const simulatedHastElement = {
+        type: 'element',
+        tagName,
+        properties,
+        children: node.children, // The ctx handlers can accept MDAST nodes too!
+        position: node.position
+    };
+    if (isBlock) {
+        const handler = ctx.registry.getHtmlBlockHandler(tagName);
+        if (handler?.handleBlock) {
+            return handler.handleBlock(simulatedHastElement, ctx);
+        }
+        // Fallback: Just return children blocks
+        return ctx.transformBlockChildren(node.children);
+    }
+    else {
+        const handler = ctx.registry.getHtmlInlineHandler(tagName);
+        if (handler?.handleInline) {
+            return handler.handleInline(simulatedHastElement, ctx);
+        }
+        // Fallback: Just return children inlines
+        return ctx.transformInlineChildren(node.children);
+    }
+}
+//# sourceMappingURL=MdxJsxMarkdownParser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MdxJsxMarkdownParser.js","sourceRoot":"","sources":["../../../src/parse/markdown/MdxJsxMarkdownParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACtD,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IACnD,KAAK,EAAE,CAAC,EAAE,YAAY;IAEtB,WAAW,CAAC,IAAsB,EAAE,GAAiB;QACjD,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB;YAAE,OAAO,IAAI,CAAC;QACnD,OAAO,aAAa,CAAC,IAA6B,EAAE,GAAG,EAAE,IAAI,CAAuB,CAAC;IACzF,CAAC;IAED,YAAY,CAAC,IAAsB,EAAE,GAAiB;QAClD,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB;YAAE,OAAO,IAAI,CAAC;QACnD,OAAO,aAAa,CAAC,IAA6B,EAAE,GAAG,EAAE,KAAK,CAAwB,CAAC;IAC3F,CAAC;CACJ,CAAC;AAEF,SAAS,aAAa,CAAC,IAAgB,EAAE,GAAiB,EAAE,OAAgB;IACxE,0DAA0D;IAC1D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,OAAO;YAAE,OAAO,GAAG,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAgC,CAAC,CAAC;QACtF,OAAO,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAgC,CAAQ,CAAC;IACrF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAExC,wCAAwC;IACxC,MAAM,UAAU,GAAe,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAClC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,CAAC;IACL,CAAC;IAED,yEAAyE;IACzE,MAAM,oBAAoB,GAAG;QACzB,IAAI,EAAE,SAAS;QACf,OAAO;QACP,UAAU;QACV,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,+CAA+C;QACxE,QAAQ,EAAG,IAAY,CAAC,QAAQ;KACb,CAAC;IAExB,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;QACD,wCAAwC;QACxC,OAAO,GAAG,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAgC,CAAC,CAAC;IAC7E,CAAC;SAAM,CAAC;QACJ,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC3D,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC,YAAY,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;QACD,yCAAyC;QACzC,OAAO,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAgC,CAAQ,CAAC;IACrF,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * 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 type { MarkdownParserModule } from '#src/parse/registry';
+/**
+ * Markdown parser module for MDX nodes.
+ */
+export declare const MdxMarkdownParser: MarkdownParserModule;
+//# sourceMappingURL=MdxMarkdownParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MdxMarkdownParser.d.ts","sourceRoot":"","sources":["../../../src/parse/markdown/MdxMarkdownParser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAyD,MAAM,qBAAqB,CAAC;AAyVvH;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,oBAwD/B,CAAC"}

package/dist/parse/markdown/MdxMarkdownParser.js

@@ -0,0 +1,351 @@
+/**
+ * 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 ((candidate.type === 'mdxTextExpression' || candidate.type === 'mdxFlowExpression')
+        && typeof candidate.value === 'string') {
+        return `{${candidate.value}}`;
+    }
+    if (Array.isArray(candidate.children)) {
+        return candidate.children.map(collectMdxText).join('');
+    }
+    return '';
+}
+function createMdxContext(ctx) {
+    return {
+        ...ctx,
+        transformInlineChildren: (children) => {
+            const flattened = [];
+            for (const child of children) {
+                if (child
+                    && typeof child === 'object'
+                    && child.type === 'paragraph'
+                    && Array.isArray(child.children)) {
+                    flattened.push(...child.children);
+                    continue;
+                }
+                flattened.push(child);
+            }
+            return ctx.transformInlineChildren(flattened);
+        },
+        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.getHtmlBlockHandlers(tagName).some(h => h.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 handlers = ctx.registry.getHtmlBlockHandlers(tagName);
+    for (const handler of handlers) {
+        if (handler.handleBlock) {
+            const result = handler.handleBlock(toMdxVirtualElement(node, 'block'), wrapperCtx);
+            if (result !== null)
+                return result;
+        }
+    }
+    const inlineHandlers = ctx.registry.getHtmlInlineHandlers(tagName);
+    for (const inlineHandler of inlineHandlers) {
+        if (inlineHandler.handleInline) {
+            const inlineResult = inlineHandler.handleInline(toMdxVirtualElement(node, 'inline'), wrapperCtx);
+            if (inlineResult !== null) {
+                return inlineResultToParagraph(inlineResult, ctx.createSourcePos(node));
+            }
+        }
+    }
+    // If handlers existed but all returned null, don't fall back to children
+    if (handlers.length > 0 || inlineHandlers.length > 0) {
+        return [];
+    }
+    return fallbackBlockFromChildren(node, ctx);
+}
+function handleMdxInline(node, ctx) {
+    const tagName = (node.name ?? '').toLowerCase();
+    if (!tagName)
+        return fallbackInlineFromChildren(node, ctx);
+    const wrapperCtx = createMdxContext(ctx);
+    const handlers = ctx.registry.getHtmlInlineHandlers(tagName);
+    if (handlers.length > 0) {
+        for (const handler of handlers) {
+            if (handler.handleInline) {
+                const result = handler.handleInline(toMdxVirtualElement(node, 'inline'), wrapperCtx);
+                if (result !== null)
+                    return result;
+            }
+        }
+        // All tried handlers returned null
+        return null;
+    }
+    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();
+                if (!tagName)
+                    return null;
+                const handlers = ctx.registry.getHtmlBlockHandlers(tagName);
+                const hasBlockHandler = handlers.some(h => h.handleBlock);
+                if (!hasBlockHandler && !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":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"ShorthandsMarkdownParser.d.ts","sourceRoot":"","sources":["../../../src/parse/markdown/ShorthandsMarkdownParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAuB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACrH,OAAO,KAAK,EAAE,MAAM,EAAiJ,MAAM,0BAA0B,CAAC;AAEtM;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,CAAC;IAClD,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,KAAK,MAAM,CAAC;CAC1F;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,EAqInD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBAqEtC,CAAC"}
+{"version":3,"file":"ShorthandsMarkdownParser.d.ts","sourceRoot":"","sources":["../../../src/parse/markdown/ShorthandsMarkdownParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAuB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACrH,OAAO,KAAK,EAAE,MAAM,EAAiJ,MAAM,0BAA0B,CAAC;AAEtM;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,CAAC;IAClD,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,KAAK,MAAM,CAAC;CAC1F;AA0CD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,EA2JnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBAqEtC,CAAC"}

package/dist/parse/markdown/ShorthandsMarkdownParser.js

@@ -3,6 +3,38 @@
  *
  * Detects ReSpec-like shorthands in text nodes and transforms them to Speculator AST nodes.
  */
+/**
+ * Parse shorthand citation target syntax:
+ * - REF
+ * - REF/path
+ * - REF#fragment
+ * - REF/path#fragment
+ *
+ * Unlike data-cite parsing, this keeps key casing as-authored so it
+ * remains compatible with localBiblio keys.
+ */
+function parseShorthandCitationTarget(rawTarget) {
+    const target = rawTarget.trim();
+    let base = target;
+    let fragment;
+    const hashIdx = base.indexOf('#');
+    if (hashIdx !== -1) {
+        const parsedFragment = base.slice(hashIdx + 1).trim();
+        if (parsedFragment)
+            fragment = parsedFragment;
+        base = base.slice(0, hashIdx);
+    }
+    let key = base.trim();
+    let path;
+    const slashIdx = base.indexOf('/');
+    if (slashIdx !== -1) {
+        key = base.slice(0, slashIdx).trim();
+        const parsedPath = base.slice(slashIdx + 1).trim();
+        if (parsedPath)
+            path = parsedPath;
+    }
+    return { key: key || target, path, fragment };
+}
 /**
  * Registry of supported shorthands.
  * This satisfies the requirement to track what shorthands are implemented.
@@ -35,15 +67,38 @@ export const SHORTHAND_REGISTRY = [
         status: 'implemented',
         handler: (match, ctx, node) => {
             const forced = match[1];
-            const key = match[2];
+            const rawTarget = match[2].trim();
+            const target = parseShorthandCitationTarget(match[2]);
+            const alias = match[3]?.trim();
+            // ReSpec-style section links: [[#section-id]]
+            if (rawTarget.startsWith('#')) {
+                const result = {
+                    type: 'sectionReference',
+                    targetId: rawTarget.slice(1),
+                };
+                if (alias) {
+                    result.children = [{ type: 'text', value: alias }];
+                }
+                const sourcePos = ctx.createSourcePos(node);
+                if (sourcePos)
+                    result.sourcePos = sourcePos;
+                return result;
+            }
             const result = {
                 type: 'cite',
-                key: key,
+                key: target.key,
             };
             if (forced === '!')
                 result.forcedNormative = true;
             if (forced === '?')
                 result.forcedInformative = true;
+            if (target.path)
+                result.path = target.path;
+            if (target.fragment)
+                result.fragment = target.fragment;
+            if (alias) {
+                result.children = [{ type: 'text', value: alias }];
+            }
             const sourcePos = ctx.createSourcePos(node);
             if (sourcePos)
                 result.sourcePos = sourcePos;