@tanstack/markdown 0.0.13 → 0.0.15

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));
 }
@@ -10,14 +11,14 @@ export function renderMarkdownReact(input, options = {}) {
 export function renderBlockReact(node, options = {}, key) {
     switch (node.type) {
         case 'heading':
-            return h(options, `h${node.depth}`, { key, ...(node.id ? { id: node.id } : {}), ...(node.framework ? { 'data-framework': node.framework } : {}) }, renderInlines(node.children, options), renderHeadingAnchorReact(node.id, options));
+            return h(options, `h${node.depth}`, { key, ...(node.id && { id: node.id }), ...(node.framework && { 'data-framework': node.framework }) }, renderInlines(node.children, options), renderHeadingAnchorReact(node.id, options));
         case 'paragraph':
             return h(options, 'p', { key }, renderInlines(node.children, options));
         case 'code':
             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,21 +54,23 @@ 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}`,
             }, node.number));
         case 'link':
-            return h(options, 'a', { key, href: node.href, ...(node.title ? { title: node.title } : {}) }, renderInlines(node.children, options));
+            return h(options, 'a', { key, href: node.href, ...(node.title && { title: node.title }) }, renderInlines(node.children, options));
         case 'image':
-            return h(options, 'img', { key, src: node.src, alt: node.alt, ...(node.title ? { title: node.title } : {}) });
+            return h(options, 'img', { key, src: node.src, alt: node.alt, ...(node.title && { title: node.title }) });
         case 'break':
             return h(options, 'br', { key });
         case 'inlineHtml':
             return options.allowHtml
                 ? h(options, 'span', { key, dangerouslySetInnerHTML: { __html: node.value } })
                 : node.value;
+        case 'inlineComponent':
+            return renderComponentReact(node, options, key);
     }
 }
 function renderInlines(nodes, options) {
@@ -76,14 +79,17 @@ function renderInlines(nodes, options) {
 function renderCodeBlockReact(node, options, key) {
     const lang = node.lang ?? 'plaintext';
     const highlighter = options.highlighter;
-    const codeProps = {
-        className: `language-${lang}`,
-    };
-    const content = highlighter ? undefined : node.value;
+    // Keep completed groups of lines in stable text nodes as code grows. Grouping
+    // bounds React's sibling work without relaying out the entire code block.
+    // Static rendering and custom code components retain string children.
+    const content = highlighter ? undefined : !options.components?.code && options.extensions?.some(extension => extension.name === 'streaming')
+        ? node.value.match(/(?:[^\n]*\n){1,4}|[^\n]+$/g)
+        : node.value;
     const highlighted = highlighter
         ? {
             dangerouslySetInnerHTML: {
                 __html: highlighter(node.value, lang, {
+                    ...(node.meta && { meta: node.meta }),
                     ...(node.highlightLines && { highlightLines: node.highlightLines }),
                     ...(options.codeLineNumbers !== undefined && { lineNumbers: options.codeLineNumbers }),
                 }),
@@ -91,19 +97,20 @@ function renderCodeBlockReact(node, options, key) {
         }
         : undefined;
     const pre = h(options, 'pre', {
+        key,
         className: `tm-code${options.codeLineNumbers ? ' tm-code--line-numbers' : ''}`,
         'data-lang': lang,
-        ...(node.title ? { 'data-code-title': node.title } : {}),
-        ...(node.file ? { 'data-filename': node.file } : {}),
-        ...(node.framework ? { 'data-framework': node.framework } : {}),
-    }, h(options, 'code', { ...codeProps, ...highlighted }, content));
+        ...(node.meta && { 'data-meta': node.meta }),
+        ...(node.title && { 'data-code-title': node.title }),
+        ...(node.file && { 'data-filename': node.file }),
+        ...(node.framework && { 'data-framework': node.framework }),
+    }, h(options, 'code', { className: `language-${lang}`, ...highlighted }, content));
     if (!node.title)
-        return h(options, Fragment, { key }, pre);
+        return pre;
     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,20 +122,21 @@ 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));
+    return h(options, tag, { key, ...(align && { style: { textAlign: align } }) }, renderInlines(cell.children, options));
 }
 function renderFootnotesReact(items, options, key) {
     return h(options, 'section', { key, 'data-footnotes': '', className: 'footnotes' }, h(options, 'h2', { id: 'footnote-label', className: 'sr-only' }, 'Footnotes', renderHeadingAnchorReact('footnote-label', options)), h(options, 'ol', null, items.map(item => h(options, 'li', { key: item.id, id: `user-content-fn-${item.id}` }, renderFootnoteItemReact(item, options)))));
@@ -136,19 +144,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,24 +169,23 @@ 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);
 }
 function renderComponentReact(node, options, key) {
-    const tag = node.tagName ?? 'md-comment-component';
+    const tag = node.tagName ?? (node.type === 'inlineComponent' ? 'span' : 'md-comment-component');
     const props = {
-        ...(node.properties ?? {}),
+        ...node.properties,
     };
     if (!node.tagName) {
         props['data-component'] = node.name;
         if (!props['data-attributes'])
             props['data-attributes'] = JSON.stringify(node.attributes);
     }
-    return h(options, tag, { key, ...props }, node.children.map((child, index) => renderBlockReact(child, options, `${key}:${index}`)));
+    return h(options, tag, { key, ...props }, node.type === 'inlineComponent'
+        ? renderInlines(node.children, options)
+        : node.children.map((child, index) => renderBlockReact(child, options, `${key}:${index}`)));
 }
 function renderHeadingAnchorReact(id, options) {
     if (!id || !options.headingAnchors)

package/dist/types.d.ts

@@ -84,7 +84,11 @@ export interface ComponentNode {
     tagName?: string;
     properties?: Record<string, string>;
 }
-export type InlineNode = TextNode | CodeSpanNode | StrongNode | EmphasisNode | StrikeNode | FootnoteReferenceNode | LinkNode | ImageNode | BreakNode | HtmlInlineNode;
+export interface InlineComponentNode extends Omit<ComponentNode, 'type' | 'children'> {
+    type: 'inlineComponent';
+    children: InlineNode[];
+}
+export type InlineNode = TextNode | CodeSpanNode | StrongNode | EmphasisNode | StrikeNode | FootnoteReferenceNode | LinkNode | ImageNode | BreakNode | HtmlInlineNode | InlineComponentNode;
 export interface TextNode {
     type: 'text';
     value: string;
@@ -158,6 +162,7 @@ export interface HtmlRenderContext {
 }
 export interface ParseOptions {
     allowHtml?: boolean;
+    urlTransform?: UrlTransform;
     frontmatter?: boolean;
     headingIds?: boolean | ((text: string, index: number) => string);
     extensions?: MarkdownExtension[];
@@ -166,6 +171,9 @@ export interface ParseOptions {
     footnoteOrder?: string[];
     footnoteCounts?: Record<string, number>;
 }
+export interface UrlTransform {
+    (url: string, kind: 'link' | 'image', defaultUrl: string): string | null;
+}
 export interface RenderOptions extends ParseOptions {
     highlighter?: CodeHighlighter;
     codeLineNumbers?: boolean;
@@ -175,6 +183,7 @@ export interface CodeHighlighter {
     (code: string, lang?: string, options?: CodeHighlightOptions): string;
 }
 export interface CodeHighlightOptions {
+    meta?: string;
     highlightLines?: number[];
     lineNumbers?: boolean;
 }

package/dist/types.d.ts.map

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

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;AAarE,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

@@ -4,15 +4,17 @@ const htmlEscapes = {
     '>': '>',
     '"': '"',
     "'": ''',
+    '`': '`',
 };
+const escapeCharacter = (char) => htmlEscapes[char];
 export function normalizeInput(value) {
     return value.replace(/^\uFEFF/, '').replace(/\r\n?/g, '\n');
 }
 export function escapeHtml(value) {
-    return value.replace(/[&<>"']/g, char => htmlEscapes[char]);
+    return value.replace(/[&<>"']/g, escapeCharacter);
 }
 export function escapeAttr(value) {
-    return escapeHtml(value).replace(/`/g, '&#96;');
+    return value.replace(/[&<>"'`]/g, escapeCharacter);
 }
 export function isBlank(value) {
     return /^\s*$/.test(value);
@@ -35,40 +37,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.13",
+  "version": "0.0.15",
   "type": "module",
   "description": "A tiny, fast, deterministic Markdown renderer for blogs and documentation.",
   "license": "MIT",
@@ -86,6 +86,7 @@
     }
   },
   "devDependencies": {
+    "@changesets/cli": "3.0.2",
     "@tanstack/highlight": "0.0.6",
     "@tanstack/intent": "^0.3.6",
     "@types/node": "^24.0.0",
@@ -99,11 +100,14 @@
     "marked": "^18.0.5",
     "micromark": "^4.0.2",
     "octane": "0.1.12",
+    "playwright": "1.63.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "rehype-stringify": "^10.0.1",
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
+    "streamdown": "2.6.0",
+    "streaming-markdown": "0.2.15",
     "tsx": "^4.20.0",
     "typescript": "^5.8.0",
     "unified": "^11.0.5",
@@ -116,6 +120,7 @@
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
+    "test:streaming-browser": "tsx scripts/verify-streaming-browser.ts",
     "test:corpus": "vitest run tests/corpus.test.tsx",
     "corpus:audit": "tsx scripts/audit-corpus.ts",
     "corpus:audit:tanstack": "tsx scripts/audit-tanstack-corpus.ts",
@@ -125,8 +130,13 @@
     "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",
+    "bench:streaming": "tsx scripts/bench-streaming-browser.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",

package/skills/custom-extensions/SKILL.md

@@ -2,12 +2,12 @@
 name: 'custom-extensions'
 description: >
   Implement MarkdownExtension block parsers, inline and document transforms,
-  HTML hooks, and portable ComponentNode output. Load when adding deterministic
+  HTML hooks, and portable block and inline component output. Load when adding deterministic
   custom syntax or rendering behavior across HTML, React, and Octane.
 metadata:
   type: core
   library: '@tanstack/markdown'
-  library_version: '0.0.13'
+  library_version: '0.0.15'
 requires:
   - 'render-markdown'
 sources:
@@ -111,6 +111,13 @@ console.log(html)
 
 Transforms receive built-in inline nodes and must return a deterministic replacement array.
 
+For custom inline UI, return an `InlineComponentNode` with `type: 'inlineComponent'`,
+`name`, `attributes`, inline `children`, and optional `tagName` and string `properties`.
+It uses the same emitted-tag component maps as a block `ComponentNode`, but defaults
+to `<span>` instead of `<md-comment-component>`. Keep tag and property names under
+extension control, use phrasing content, and recurse through inline `children` when
+transforming text nested inside links or emphasis. This does not require `allowHtml`.
+
 ### Derive document metadata after parsing
 
 ```ts
@@ -370,7 +377,7 @@ export function Article() {
 }
 ```
 
-`renderHtml` hooks do not run in React or Octane; a `ComponentNode` and emitted-tag component mapping is the portable path.
+`renderHtml` hooks do not run in React or Octane; a `ComponentNode` or `InlineComponentNode` and emitted-tag component mapping is the portable path.
 
 Source: `docs/guides/extensions.md`
 
@@ -425,7 +432,7 @@ Source: `docs/guides/extensions.md`
 
 ### HIGH Rich output versus untrusted-content safety
 
-Prefer `ComponentNode` plus application components for rich output. Treat `allowHtml`, extension HTML strings, and highlighter markup as explicit trusted boundaries; see `production-pipelines`.
+Prefer block or inline component nodes plus application components for rich output. Treat `allowHtml`, extension HTML strings, and highlighter markup as explicit trusted boundaries; see `production-pipelines`.
 
 ### MEDIUM Parse-ahead performance versus option timing
 

package/skills/docs-features/SKILL.md

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

package/skills/docs-features/references/docs-metadata.md

@@ -317,4 +317,4 @@ interface CodeBlockNode {
 - `{2,4-6}` and `lines=2,4-6` produce sorted, unique positive line numbers.
 - Invalid ranges are ignored, and each individual range expands to at most 1,000 lines.
 
-HTML code blocks expose `data-lang`, `data-code-title`, `data-filename`, and `data-framework` when the corresponding values exist. Highlight lines are passed to a configured highlighter; metadata alone does not create token or line markup.
+HTML, React, and Octane code blocks expose `data-lang`, `data-meta`, `data-code-title`, `data-filename`, and `data-framework` on `<pre>` when the corresponding values exist. Framework `pre` replacements can read `props['data-meta']`; highlighters receive the raw metadata in `options.meta` alongside highlight lines. Metadata alone does not create token or line markup.

package/skills/octane-rendering/SKILL.md

@@ -9,7 +9,7 @@ metadata:
   type: framework
   library: '@tanstack/markdown'
   framework: 'octane'
-  library_version: '0.0.13'
+  library_version: '0.0.15'
 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.13'
+  library_version: '0.0.15'
 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.13:${key}`
+  const cacheKey = `markdown-0.0.15:${key}`
   let document = cache.get(cacheKey)
   if (!document) {
     document = parseMarkdown(source, {
@@ -331,6 +331,14 @@ export function renderWithPolicy(
 
 Core escaping and protocol filtering do not enforce application-specific outbound-link, image, or final-HTML policy.
 
+For parsed Markdown destinations, `urlTransform(url, kind, defaultUrl)` can return
+the screened default, a trusted replacement, or `null` to remove the link or image
+while retaining its label content. Only allow data images after application validation
+of their content, MIME type, and size. Keep the default policy for other destinations.
+Callback results are not screened again, and the callback does not apply to raw HTML,
+extension-created URLs, or ASTs supplied directly to renderers. Do not enable raw HTML
+to allow images. Include URL-policy changes in persisted AST cache invalidation.
+
 Source: `docs/core-concepts/security.md`
 
 ### HIGH Assuming complete CommonMark behavior

package/skills/react-rendering/SKILL.md

@@ -9,7 +9,7 @@ metadata:
   type: framework
   library: '@tanstack/markdown'
   framework: 'react'
-  library_version: '0.0.13'
+  library_version: '0.0.15'
 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.13'
+  library_version: '0.0.15'
 sources:
   - 'TanStack/markdown:docs/quick-start.md'
   - 'TanStack/markdown:docs/core-concepts/document-model.md'

package/skills/render-markdown/references/ast-and-options.md

@@ -1,6 +1,6 @@
 # AST and Options Reference
 
-This reference targets `@tanstack/markdown@0.0.13`. Shared public types are
+This reference targets `@tanstack/markdown@0.0.15`. Shared public types are
 exported from `@tanstack/markdown`.
 
 ## Entry Points
@@ -190,10 +190,11 @@ Important rendering invariants:
 | `emphasis` | `EmphasisNode` | inline `children` |
 | `strike` | `StrikeNode` | inline `children` |
 | `footnoteReference` | `FootnoteReferenceNode` | normalized `id`, display `number`, optional `referenceIndex` |
-| `link` | `LinkNode` | sanitized `href`, optional `title`, inline `children` |
-| `image` | `ImageNode` | sanitized `src`, text `alt`, optional `title` |
+| `link` | `LinkNode` | policy-processed `href`, optional `title`, inline `children` |
+| `image` | `ImageNode` | policy-processed `src`, text `alt`, optional `title` |
 | `break` | `BreakNode` | no additional fields |
 | `inlineHtml` | `HtmlInlineNode` | raw `value` |
+| `inlineComponent` | `InlineComponentNode` | `name`, `attributes`, inline `children`, optional `tagName`, optional string `properties` |
 
 `HtmlInlineNode` is created only when parsing with `allowHtml: true`.
 Repeated footnote references use `referenceIndex` to produce unique source
@@ -206,10 +207,12 @@ import type {
   FootnoteDefinition,
   LinkReferenceDefinition,
   MarkdownExtension,
+  UrlTransform,
 } from '@tanstack/markdown'
 
 interface ParseOptions {
   allowHtml?: boolean
+  urlTransform?: UrlTransform
   frontmatter?: boolean
   headingIds?: boolean | ((text: string, index: number) => string)
   extensions?: MarkdownExtension[]
@@ -223,6 +226,7 @@ interface ParseOptions {
 | Option | Default | Contract |
 | --- | --- | --- |
 | `allowHtml` | `false` | Recognize raw block and inline HTML nodes. Rendering also requires this option to emit their raw values. |
+| `urlTransform` | built-in policy | Synchronous `(url, kind, defaultUrl) => string \| null`; return the screened default, a trusted replacement, or `null` to keep only label content. Applies to Markdown destinations, not raw HTML or supplied ASTs. |
 | `frontmatter` | `true` | Extract one leading `---` block into `document.frontmatter`. The library does not parse YAML. |
 | `headingIds` | `true` | Generate duplicate-safe IDs, disable IDs with `false`, or return an ID from `(text, normalizedLineIndex)`. |
 | `extensions` | `[]` | Run block parsers and inline/document transforms in array order. |
@@ -259,6 +263,7 @@ interface HeadingAnchorOptions {
 }
 
 interface CodeHighlightOptions {
+  meta?: string
   highlightLines?: number[]
   lineNumbers?: boolean
 }