@tanstack/markdown 0.0.12 → 0.0.14

package/dist/parser.js

@@ -1,5 +1,5 @@
 import { parseInline } from './inline.js';
-import { createSlugger, footnoteId, isBlank, normalizeInput, normalizeReferenceLabel, plainText, stripIndent } from './utils.js';
+import { createSlugger, footnoteId, isBlank, normalizeInput, normalizeReferenceLabel, parseDestination, plainText, stripIndent } from './utils.js';
 const maxBlockDepth = 64;
 export function parseMarkdown(markdown, options = {}) {
     const normalized = normalizeInput(markdown);
@@ -26,10 +26,11 @@ export function parseMarkdown(markdown, options = {}) {
             ...(hasFootnotes ? { footnotes: definitions.footnotes, footnoteOrder, footnoteCounts } : {}),
         }
         : options;
-    const parser = new BlockParser(lines, parseOptions, createSlugger());
+    const slugger = createSlugger();
+    const parser = new BlockParser(lines, parseOptions, slugger);
     const children = parser.parse();
     if (hasFootnotes && footnoteOrder.length > 0) {
-        children.push(createFootnotesBlock(definitions.footnotes, footnoteOrder, parseOptions));
+        children.push(createFootnotesBlock(definitions.footnotes, footnoteOrder, parseOptions, slugger));
     }
     let document = frontmatter === undefined ? { type: 'root', children } : { type: 'root', frontmatter, children };
     for (const extension of parseOptions.extensions ?? []) {
@@ -43,6 +44,7 @@ class BlockParser {
     slugger;
     budget;
     index = 0;
+    loose = false;
     constructor(lines, options, slugger, budget = { depth: 0 }) {
         this.lines = lines;
         this.options = options;
@@ -59,6 +61,8 @@ class BlockParser {
         const nodes = [];
         while (this.index < this.lines.length) {
             if (isBlank(this.current())) {
+                if (nodes.length)
+                    this.loose = true;
                 this.index++;
                 continue;
             }
@@ -101,23 +105,21 @@ class BlockParser {
         return undefined;
     }
     parseFence() {
-        const match = this.current().match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
+        const match = this.current().match(/^( {0,3})(`{3,}|~{3,})(.*)$/);
         if (!match)
             return undefined;
-        const fence = match[1];
-        const marker = fence[0];
-        const fenceSize = fence.length;
-        const info = match[2].trim();
+        const fence = match[2];
+        const info = match[3].trim();
         const code = [];
         this.index++;
         while (this.index < this.lines.length) {
             const line = this.current();
             const close = line.match(/^ {0,3}(`{3,}|~{3,})\s*$/);
-            if (close && close[1][0] === marker && close[1].length >= fenceSize) {
+            if (close?.[1].startsWith(fence)) {
                 this.index++;
                 break;
             }
-            code.push(line);
+            code.push(stripIndent(line, match[1].length));
             this.index++;
         }
         return {
@@ -150,15 +152,13 @@ class BlockParser {
         const quoted = [];
         while (this.index < this.lines.length) {
             const line = this.current();
-            if (isBlank(line)) {
-                quoted.push('');
-                this.index++;
-                continue;
-            }
             const match = line.match(/^ {0,3}>\s?(.*)$/);
-            if (!match)
-                break;
-            quoted.push(match[1]);
+            if (!match) {
+                if (!isBlank(line))
+                    break;
+                this.loose = true;
+            }
+            quoted.push(match?.[1] ?? '');
             this.index++;
         }
         return {
@@ -173,11 +173,10 @@ class BlockParser {
         const items = [];
         const ordered = first.ordered;
         const baseIndent = first.indent;
-        const start = ordered ? first.number : undefined;
         let loose = false;
         while (this.index < this.lines.length) {
             const marker = listMarker(this.current());
-            if (!marker || !sameListType(marker, first) || marker.indent !== baseIndent)
+            if (!marker || marker.marker !== first.marker || marker.indent !== baseIndent)
                 break;
             let firstLine = marker.content;
             const task = firstLine.match(/^\[([ xX])\]\s+(.*)$/);
@@ -200,7 +199,7 @@ class BlockParser {
                         break;
                     const followingMarker = listMarker(following);
                     if (followingMarker?.indent === baseIndent) {
-                        if (!sameListType(followingMarker, first))
+                        if (followingMarker.marker !== first.marker)
                             break;
                         loose = true;
                         this.index = nextIndex;
@@ -208,9 +207,8 @@ class BlockParser {
                     }
                     if (leadingSpaces(following) < marker.contentIndent)
                         break;
-                    loose = true;
-                    itemLines.push('');
-                    this.index = nextIndex;
+                    while (this.index < nextIndex)
+                        itemLines.push(stripIndent(this.lines[this.index++], marker.contentIndent));
                     continue;
                 }
                 if (leadingSpaces(line) >= marker.contentIndent) {
@@ -223,7 +221,9 @@ class BlockParser {
                 itemLines.push(line.trimStart());
                 this.index++;
             }
-            const children = new BlockParser(itemLines, this.options, this.slugger, this.budget).parse();
+            const parser = new BlockParser(itemLines, this.options, this.slugger, this.budget);
+            const children = parser.parse();
+            loose ||= parser.loose;
             const item = { type: 'listItem', children };
             if (checked !== undefined)
                 item.checked = checked;
@@ -232,7 +232,7 @@ class BlockParser {
         return {
             type: 'list',
             ordered,
-            ...(ordered && start !== undefined ? { start } : {}),
+            ...(ordered && { start: first.number }),
             ...(loose && { loose: true }),
             items,
         };
@@ -322,7 +322,7 @@ function parseCodeInfo(info) {
     const titleMatch = meta.match(/(?:^|\s)(?:title|file)=(?:"([^"]+)"|'([^']+)'|([^\s}]+))/);
     const frameworkMatch = meta.match(/(?:^|\s)framework=(?:"([^"]+)"|'([^']+)'|([^\s}]+))/);
     const rangeMatch = meta.match(/\{([^}]+)\}|(?:^|\s)lines=([^\s]+)/);
-    const highlightLines = parseLineRanges(rangeMatch?.[1] ?? rangeMatch?.[2] ?? '');
+    const highlightLines = rangeMatch ? parseLineRanges(rangeMatch[1] ?? rangeMatch[2]) : [];
     const title = titleMatch ? titleMatch[1] ?? titleMatch[2] ?? titleMatch[3] : undefined;
     const framework = frameworkMatch ? frameworkMatch[1] ?? frameworkMatch[2] ?? frameworkMatch[3] : undefined;
     return {
@@ -336,29 +336,20 @@ function parseCodeInfo(info) {
 function extractDefinitions(lines) {
     const references = Object.create(null);
     const footnotes = Object.create(null);
-    const footnoteIds = new Map();
+    const footnoteIds = createSlugger(footnoteId);
     const remaining = [];
-    let fenceMarker;
-    let fenceSize = 0;
+    let activeFence = '';
     let index = 0;
     while (index < lines.length) {
         const line = lines[index];
-        const fence = line.match(/^ {0,3}(`{3,}|~{3,})/);
+        const fence = line.match(/^ {0,3}(`{3,}|~{3,})(.*)$/);
         if (fence) {
-            const marker = fence[1][0];
-            if (!fenceMarker) {
-                fenceMarker = marker;
-                fenceSize = fence[1].length;
-            }
-            else if (marker === fenceMarker && fence[1].length >= fenceSize) {
-                fenceMarker = undefined;
-                fenceSize = 0;
-            }
-            remaining.push(line);
-            index++;
-            continue;
+            if (!activeFence)
+                activeFence = fence[1];
+            else if (fence[1].startsWith(activeFence) && isBlank(fence[2]))
+                activeFence = '';
         }
-        if (!fenceMarker) {
+        else if (!activeFence) {
             const footnote = line.match(/^ {0,3}\[\^([^\]\n]+)\]:[ \t]*(.*)$/);
             if (footnote) {
                 const label = footnote[1];
@@ -373,20 +364,14 @@ function extractDefinitions(lines) {
                 }
                 const key = normalizeReferenceLabel(label);
                 if (!footnotes[key]) {
-                    const baseId = footnoteId(label) || 'footnote';
-                    const count = (footnoteIds.get(baseId) ?? 0) + 1;
-                    footnoteIds.set(baseId, count);
-                    footnotes[key] = { label, content: content.join('\n'), id: count === 1 ? baseId : `${baseId}-${count}` };
+                    footnotes[key] = { label, content: content.join('\n'), id: footnoteIds(label) };
                 }
                 continue;
             }
-            const definition = line.match(/^ {0,3}\[([^\]\n]+)\]:[ \t]*(\S+)(?:[ \t]+(?:"([^"]*)"|'([^']*)'|\(([^)]*)\)))?[ \t]*$/);
-            if (definition) {
-                const title = definition[3] ?? definition[4] ?? definition[5];
-                references[normalizeReferenceLabel(definition[1])] = {
-                    href: definition[2].replace(/^<|>$/g, ''),
-                    ...(title !== undefined ? { title } : {}),
-                };
+            const definition = line.match(/^ {0,3}\[([^\]\n]+)\]:[ \t]*(\S.*)$/);
+            const destination = definition && parseDestination(definition[2].trimEnd());
+            if (destination) {
+                references[normalizeReferenceLabel(definition[1])] ??= destination;
                 index++;
                 continue;
             }
@@ -396,7 +381,7 @@ function extractDefinitions(lines) {
     }
     return { lines: remaining, references, footnotes };
 }
-function createFootnotesBlock(footnotes, footnoteOrder, options) {
+function createFootnotesBlock(footnotes, footnoteOrder, options, slugger) {
     const items = [];
     for (let index = 0; index < footnoteOrder.length; index++) {
         const key = footnoteOrder[index];
@@ -404,9 +389,9 @@ function createFootnotesBlock(footnotes, footnoteOrder, options) {
         if (!definition)
             continue;
         items.push({
-            id: definition.id ?? (footnoteId(definition.label) || 'footnote'),
+            id: definition.id ?? footnoteId(definition.label),
             number: index + 1,
-            children: new BlockParser(normalizeInput(definition.content).split('\n'), options, createSlugger()).parse(),
+            children: new BlockParser(normalizeInput(definition.content).split('\n'), options, slugger).parse(),
         });
     }
     for (const item of items) {
@@ -424,6 +409,9 @@ function parseLineRanges(value) {
             continue;
         const start = Number(match[1]);
         const end = Number(match[2] ?? match[1]);
+        // Larger integers can stop line++ from making progress.
+        if (end > Number.MAX_SAFE_INTEGER)
+            continue;
         for (let line = start; line <= end && line < start + 1000; line++)
             lines.add(line);
     }
@@ -444,18 +432,12 @@ function listMarker(line) {
         content: match[4] ?? '',
     };
 }
-function sameListType(left, right) {
-    return left.ordered === right.ordered && left.marker === right.marker;
-}
 function leadingSpaces(line) {
     return line.match(/^ */)?.[0].length ?? 0;
 }
 function isBlockStart(line, next) {
     const marker = listMarker(line);
-    return (/^ {0,3}(`{3,}|~{3,})/.test(line) ||
-        /^ {0,3}#{1,6}(?:\s+|$)/.test(line) ||
-        /^ {0,3}([-*_])(?:\s*\1){2,}\s*$/.test(line) ||
-        /^ {0,3}>\s?/.test(line) ||
+    return (/^ {0,3}(?:`{3,}|~{3,}|#{1,6}(?:\s|$)|([-*_])(?:\s*\1){2,}\s*$|>)/.test(line) ||
         (marker !== undefined && (!marker.ordered || marker.number === 1)) ||
         (!!next && looksLikeTableHeader(line, next)));
 }
@@ -466,14 +448,10 @@ function looksLikeTableHeader(header, delimiter) {
     return cells.length === splitTableRow(header).length && cells.every(cell => /^:?-+:?$/.test(cell.trim()));
 }
 function splitTableRow(value) {
-    let row = value.trim();
-    if (row.startsWith('|'))
-        row = row.slice(1);
-    if (row.endsWith('|'))
-        row = row.slice(0, -1);
+    const row = value.trim();
     const cells = [];
     let current = '';
-    for (let index = 0; index < row.length; index++) {
+    for (let index = row.startsWith('|') ? 1 : 0; index < row.length; index++) {
         const char = row[index];
         if (char === '\\' && row[index + 1] === '|') {
             current += '|';
@@ -487,7 +465,8 @@ function splitTableRow(value) {
         }
         current += char;
     }
-    cells.push(current.trim());
+    if (current || !row.endsWith('|') || !cells.length)
+        cells.push(current.trim());
     return cells;
 }
 function parseAlign(value) {

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAElG,OAAO,KAAK,EAAE,SAAS,EAAmC,UAAU,EAAE,aAAa,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAA;AAErI,KAAK,oBAAoB,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAA;AACvD,KAAK,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAExE,MAAM,MAAM,sBAAsB,CAAC,OAAO,SAAS,oBAAoB,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAA;AAE5G,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC;KACtC,OAAO,IAAI,oBAAoB,GAAG,oBAAoB,GAAG,aAAa,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;CACzG,CAAC,GACA,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;AAEzD,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,UAAU,CAAC,EAAE,YAAY,CAAA;CAC1B;AAED,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,QAAQ,EAAE,aAAa,CAAA;CACxB;AAED,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,aAAa,GAAG,YAAY,CAE9E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,oBAAyB,GAAG,SAAS,CAGvG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CA+DhH;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,oBAAyB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAwC/G"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGlG,OAAO,KAAK,EAAE,SAAS,EAAmC,UAAU,EAAE,aAAa,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAA;AAErI,KAAK,oBAAoB,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAA;AACvD,KAAK,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAExE,MAAM,MAAM,sBAAsB,CAAC,OAAO,SAAS,oBAAoB,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAA;AAE5G,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC;KACtC,OAAO,IAAI,oBAAoB,GAAG,oBAAoB,GAAG,aAAa,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;CACzG,CAAC,GACA,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;AAEzD,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,UAAU,CAAC,EAAE,YAAY,CAAA;CAC1B;AAED,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,QAAQ,EAAE,aAAa,CAAA;CACxB;AAED,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,aAAa,GAAG,YAAY,CAE9E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,oBAAyB,GAAG,SAAS,CAGvG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CA+DhH;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,oBAAyB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAwC/G"}

package/dist/react.js

@@ -1,5 +1,6 @@
 import { Fragment, createElement } from 'react';
 import { parseMarkdown } from './parser.js';
+import { footnoteReferenceId } from './utils.js';
 export function Markdown({ children, ...options }) {
     return createElement(Fragment, null, renderMarkdownReact(children, options));
 }
@@ -17,7 +18,7 @@ export function renderBlockReact(node, options = {}, key) {
             return renderCodeBlockReact(node, options, key);
         case 'list': {
             const tag = node.ordered ? 'ol' : 'ul';
-            return h(options, tag, { key, ...(node.ordered && node.start && node.start !== 1 ? { start: node.start } : {}) }, node.items.map((item, index) => h(options, 'li', { key: index }, renderListItemChildrenReact(item.children, item.checked, node.loose, options, `${index}`))));
+            return h(options, tag, { key, ...(node.ordered && node.start !== undefined && node.start !== 1 ? { start: node.start } : {}) }, node.items.map((item, index) => h(options, 'li', { key: index }, renderListItemChildrenReact(item.children, item.checked, node.loose, options, `${index}`))));
         }
         case 'blockquote':
             return h(options, 'blockquote', { key }, node.children.map((child, index) => renderBlockReact(child, options, `${key}:${index}`)));
@@ -53,7 +54,7 @@ export function renderInlineReact(node, options = {}, key) {
             return h(options, 'del', { key }, renderInlines(node.children, options));
         case 'footnoteReference':
             return h(options, 'sup', { key }, h(options, 'a', {
-                id: `user-content-fnref-${footnoteReferenceId(node)}`,
+                id: `user-content-fnref-${footnoteReferenceId(node.id, node.referenceIndex)}`,
                 'data-footnote-ref': '',
                 'aria-describedby': 'footnote-label',
                 href: `#user-content-fn-${node.id}`,
@@ -102,8 +103,7 @@ function renderCodeBlockReact(node, options, key) {
     return h(options, 'figure', { key, className: 'tm-code-frame', 'data-lang': lang }, h(options, 'figcaption', null, node.title), pre);
 }
 function renderListItemChildrenReact(children, checked, loose, options, key) {
-    const [first, ...rest] = children;
-    const task = checked === undefined
+    let result = checked === undefined
         ? []
         : [
             h(options, 'input', {
@@ -115,17 +115,18 @@ function renderListItemChildrenReact(children, checked, loose, options, key) {
             }),
             ' ',
         ];
-    if (first?.type === 'paragraph') {
-        const content = [...task, ...renderInlines(first.children, options)];
-        return [
-            ...(loose ? [h(options, 'p', { key: `${key}:paragraph` }, content)] : content),
-            ...rest.flatMap((child, childIndex) => renderListChildReact(child, loose, options, `${key}:${childIndex + 1}`)),
-        ];
+    for (let index = 0; index < children.length; index++) {
+        const child = children[index];
+        if (child.type === 'paragraph' && (!loose || index === 0)) {
+            for (const inline of renderInlines(child.children, options))
+                result.push(inline);
+            if (loose)
+                result = [h(options, 'p', { key: `${key}:paragraph` }, result)];
+        }
+        else
+            result.push(renderBlockReact(child, options, `${key}:${index}`));
     }
-    return [...task, ...children.flatMap((child, childIndex) => renderListChildReact(child, loose, options, `${key}:${childIndex}`))];
-}
-function renderListChildReact(child, loose, options, key) {
-    return !loose && child.type === 'paragraph' ? renderInlines(child.children, options) : [renderBlockReact(child, options, key)];
+    return result;
 }
 function renderTableCellReact(tag, cell, align, options, key) {
     return h(options, tag, { key, ...(align ? { style: { textAlign: align } } : {}) }, renderInlines(cell.children, options));
@@ -136,19 +137,20 @@ function renderFootnotesReact(items, options, key) {
 function renderFootnoteItemReact(item, options) {
     const lastIndex = item.children.length - 1;
     const backrefs = renderFootnoteBackrefsReact(item, options);
-    if (lastIndex < 0)
-        return [h(options, 'p', { key: 'backref-wrapper' }, backrefs.slice(1))];
-    return item.children.map((child, index) => {
+    const result = item.children.map((child, index) => {
         if (index === lastIndex && child.type === 'paragraph') {
             return h(options, 'p', { key: index }, renderInlines(child.children, options), backrefs);
         }
         return renderBlockReact(child, options, `${index}`);
     });
+    if (item.children[lastIndex]?.type !== 'paragraph')
+        result.push(h(options, 'p', { key: 'backref-wrapper' }, backrefs.slice(1)));
+    return result;
 }
 function renderFootnoteBackrefsReact(item, options) {
     const result = [];
     for (let index = 1; index <= (item.referenceCount ?? 1); index++) {
-        const referenceId = index === 1 ? item.id : `${item.id}-${index}`;
+        const referenceId = footnoteReferenceId(item.id, index);
         const label = index === 1 ? `${item.number}` : `${item.number}-${index}`;
         result.push(' ', h(options, 'a', {
             key: index,
@@ -160,9 +162,6 @@ function renderFootnoteBackrefsReact(item, options) {
     }
     return result;
 }
-function footnoteReferenceId(node) {
-    return node.referenceIndex && node.referenceIndex > 1 ? `${node.id}-${node.referenceIndex}` : node.id;
-}
 function h(options, tag, props, ...children) {
     const component = typeof tag === 'string' ? options.components?.[tag] ?? tag : tag;
     return createElement(component, props, ...children);

package/dist/utils.d.ts

@@ -1,13 +1,17 @@
-import type { InlineNode } from './types.js';
+import type { InlineNode, LinkReferenceDefinition } from './types.js';
 export declare function normalizeInput(value: string): string;
 export declare function escapeHtml(value: string): string;
 export declare function escapeAttr(value: string): string;
 export declare function isBlank(value: string): boolean;
 export declare function stripIndent(value: string, size: number): string;
 export declare function plainText(nodes: InlineNode[]): string;
-export declare function createSlugger(): (value: string) => string;
+export declare function createSlugger(normalize?: typeof headingSlug): (value: string) => string;
+declare function headingSlug(value: string): string;
 export declare function sanitizeUrl(value: string): string;
+export declare function parseDestination(value: string): LinkReferenceDefinition | undefined;
 export declare function normalizeReferenceLabel(value: string): string;
 export declare function footnoteId(label: string): string;
+export declare function footnoteReferenceId(id: string, index?: number): string;
 export declare function splitLines(value: string): string[];
+export {};
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAU5C,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAQrD;AAED,wBAAgB,aAAa,KAGnB,OAAO,MAAM,YActB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAIlD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAUrE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAQrD;AAED,wBAAgB,aAAa,CAAC,SAAS,qBAAc,IAG3C,OAAO,MAAM,YAStB;AAED,iBAAS,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ1C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAMnF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAEjE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAIlD"}

package/dist/utils.js

@@ -35,40 +35,50 @@ export function plainText(nodes) {
     }
     return value;
 }
-export function createSlugger() {
+export function createSlugger(normalize = headingSlug) {
     const seen = new Map();
     return (value) => {
-        const base = value
-            .toLowerCase()
-            .normalize('NFKD')
-            .replace(/[\u0300-\u036f]/g, '')
-            .replace(/&[a-z0-9#]+;/gi, '')
-            .replace(/[^a-z0-9]+/g, '-')
-            .replace(/^-+|-+$/g, '') || 'section';
-        const count = seen.get(base) ?? 0;
-        seen.set(base, count + 1);
-        return count === 0 ? base : `${base}-${count + 1}`;
+        const base = normalize(value);
+        let count = seen.get(base) ?? 1;
+        let id = base;
+        while (seen.has(id))
+            id = `${base}-${++count}`;
+        seen.set(base, count);
+        seen.set(id, 1);
+        return id;
     };
 }
+function headingSlug(value) {
+    return value
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/&[a-z0-9#]+;/gi, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'section';
+}
 export function sanitizeUrl(value) {
-    const trimmed = value.trim().replace(/[\u0000-\u001F\u007F\s]+/g, '');
-    if (!trimmed)
-        return '';
-    if (/^(#|\/|\.\/|\.\.\/)/.test(trimmed))
-        return trimmed;
-    if (/^(https?:|mailto:|tel:)/i.test(trimmed))
-        return trimmed;
-    if (/^[a-z][a-z0-9+.-]*:/i.test(trimmed))
-        return '';
-    return trimmed;
+    const trimmed = value.replace(/[\u0000-\u001F\u007F\s]+/g, '');
+    return /^(?!https?:|mailto:|tel:)[a-z][a-z0-9+.-]*:/i.test(trimmed) ? '' : trimmed;
+}
+export function parseDestination(value) {
+    const match = value.match(/^(?:<([^<>\n]*)>|([^<>\s]*?))(?:\s+(?:"([^"]*)"|'([^']*)'|\(([^)]*)\)))?$/);
+    if (!match)
+        return undefined;
+    const href = match[1] ?? match[2];
+    const title = match[3] ?? match[4] ?? match[5];
+    return { href: href.replace(/\\([!-/:-@\[-`{-~])/g, '$1'), ...(title ? { title } : {}) };
 }
 export function normalizeReferenceLabel(value) {
-    return value.trim().toLowerCase();
+    return value.trim().replace(/\s+/g, ' ').toLowerCase();
 }
 export function footnoteId(label) {
     return normalizeReferenceLabel(label)
         .replace(/[^a-z0-9_-]+/g, '-')
-        .replace(/^-+|-+$/g, '');
+        .replace(/^-+|-+$/g, '') || 'footnote';
+}
+export function footnoteReferenceId(id, index = 1) {
+    return index > 1 ? `${id}-${index}` : id;
 }
 export function splitLines(value) {
     const lines = value.split('\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/markdown",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "type": "module",
   "description": "A tiny, fast, deterministic Markdown renderer for blogs and documentation.",
   "license": "MIT",
@@ -12,7 +12,6 @@
   "bugs": {
     "url": "https://github.com/TanStack/markdown/issues"
   },
-  "packageManager": "pnpm@11.4.0",
   "sideEffects": false,
   "files": [
     "dist",
@@ -71,27 +70,6 @@
       "import": "./dist/extensions/tabs.js"
     }
   },
-  "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:corpus": "vitest run tests/corpus.test.tsx",
-    "corpus:audit": "tsx scripts/audit-corpus.ts",
-    "corpus:audit:tanstack": "tsx scripts/audit-tanstack-corpus.ts",
-    "corpus:audit:external": "tsx scripts/audit-external-corpus.ts",
-    "docs:verify": "node scripts/verify-docs.mjs",
-    "test:skills": "intent validate skills --check && pnpm run skills:check-version",
-    "skills:check-version": "node scripts/sync-skill-version.mjs --check",
-    "skills:sync-version": "node scripts/sync-skill-version.mjs",
-    "skills:stale": "intent stale",
-    "conformance": "tsx scripts/conformance.ts",
-    "bench": "tsx scripts/bench.ts",
-    "size": "tsx scripts/measure-size.ts",
-    "research": "pnpm run conformance && pnpm run size && pnpm run bench",
-    "verify": "pnpm test && pnpm run typecheck && pnpm run build && pnpm run docs:verify && pnpm run test:skills && pnpm run research && pnpm pack --dry-run",
-    "prepublishOnly": "pnpm run verify",
-    "version": "pnpm run skills:sync-version"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -108,6 +86,7 @@
     }
   },
   "devDependencies": {
+    "@changesets/cli": "3.0.2",
     "@tanstack/highlight": "0.0.6",
     "@tanstack/intent": "^0.3.6",
     "@types/node": "^24.0.0",
@@ -133,5 +112,29 @@
   },
   "keywords": [
     "tanstack-intent"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:corpus": "vitest run tests/corpus.test.tsx",
+    "corpus:audit": "tsx scripts/audit-corpus.ts",
+    "corpus:audit:tanstack": "tsx scripts/audit-tanstack-corpus.ts",
+    "corpus:audit:external": "tsx scripts/audit-external-corpus.ts",
+    "docs:verify": "node scripts/verify-docs.mjs",
+    "test:skills": "intent validate skills --check && pnpm run skills:check-version",
+    "skills:check-version": "node scripts/sync-skill-version.mjs --check",
+    "skills:sync-version": "node scripts/sync-skill-version.mjs",
+    "skills:stale": "intent stale",
+    "changeset": "changeset",
+    "changeset:status": "changeset status",
+    "release:version": "changeset version && pnpm run skills:sync-version",
+    "release:publish": "pnpm run verify && changeset publish",
+    "conformance": "tsx scripts/conformance.ts",
+    "bench": "tsx scripts/bench.ts",
+    "size": "tsx scripts/measure-size.ts",
+    "research": "pnpm run conformance && pnpm run size && pnpm run bench",
+    "verify": "pnpm test && pnpm run typecheck && pnpm run build && pnpm run docs:verify && pnpm run test:skills && pnpm run research && pnpm pack --dry-run",
+    "version": "pnpm run skills:sync-version"
+  }
+}

package/skills/custom-extensions/SKILL.md

@@ -7,7 +7,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/markdown'
-  library_version: '0.0.12'
+  library_version: '0.0.14'
 requires:
   - 'render-markdown'
 sources:

package/skills/docs-features/SKILL.md

@@ -9,7 +9,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/markdown'
-  library_version: '0.0.12'
+  library_version: '0.0.14'
 requires:
   - 'render-markdown'
 sources:

package/skills/octane-rendering/SKILL.md

@@ -9,7 +9,7 @@ metadata:
   type: framework
   library: '@tanstack/markdown'
   framework: 'octane'
-  library_version: '0.0.12'
+  library_version: '0.0.14'
 requires:
   - 'render-markdown'
 sources:

package/skills/production-pipelines/SKILL.md

@@ -8,7 +8,7 @@ description: >
 metadata:
   type: lifecycle
   library: '@tanstack/markdown'
-  library_version: '0.0.12'
+  library_version: '0.0.14'
 requires:
   - 'render-markdown'
 sources:
@@ -127,7 +127,7 @@ import { parseMarkdown } from '@tanstack/markdown/parser'
 const cache = new Map<string, MarkdownDocument>()
 
 export function renderCachedArticle(key: string, source: string): string {
-  const cacheKey = `markdown-0.0.12:${key}`
+  const cacheKey = `markdown-0.0.14:${key}`
   let document = cache.get(cacheKey)
   if (!document) {
     document = parseMarkdown(source, {

package/skills/react-rendering/SKILL.md

@@ -9,7 +9,7 @@ metadata:
   type: framework
   library: '@tanstack/markdown'
   framework: 'react'
-  library_version: '0.0.12'
+  library_version: '0.0.14'
 requires:
   - 'render-markdown'
 sources:

package/skills/render-markdown/SKILL.md

@@ -9,7 +9,7 @@ description: >
 metadata:
   type: core
   library: '@tanstack/markdown'
-  library_version: '0.0.12'
+  library_version: '0.0.14'
 sources:
   - 'TanStack/markdown:docs/quick-start.md'
   - 'TanStack/markdown:docs/core-concepts/document-model.md'