@inshapardaz/likhari-converters 0.1.14-dev.115 → 0.1.15-dev.118

package/dist/html/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/html/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAiCjD,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIlD;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvD;AA6RD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,qBAAqB,CAMvF"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/html/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAiCjD,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIlD;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvD;AAoTD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,qBAAqB,CAMvF"}

package/dist/html/parse.js

@@ -92,6 +92,10 @@ function collectInline(node, state, out, preserveWs) {
         out.push({ type: 'linebreak', version: 1 });
         return;
     }
+    if (tag === 'sup' && el.hasAttribute('data-likhari-footnote-ref')) {
+        out.push({ type: 'footnote-reference', version: 1, footnoteId: el.getAttribute('data-likhari-footnote-ref') ?? '' });
+        return;
+    }
     if (tag === 'a') {
         const url = safeUrl(el.getAttribute('href') ?? '');
         const children = [];
@@ -247,6 +251,26 @@ function convertLayout(container) {
     const templateColumns = container.style.gridTemplateColumns || `repeat(${Math.max(items.length, 2)}, 1fr)`;
     return elementBase('layout-container', items.length > 0 ? items : [elementBase('layout-item', [paragraph()])], { templateColumns });
 }
+function convertFootnoteList(el) {
+    const items = [];
+    Array.from(el.children).forEach((child) => {
+        if (child.tagName.toLowerCase() !== 'li')
+            return;
+        const li = child;
+        const footnoteId = li.getAttribute('data-likhari-footnote-item') ?? (li.getAttribute('id') ?? '').replace(/^fn-/, '');
+        if (!footnoteId)
+            return;
+        // Drop the "↩" backlink our own serializer appends — it's a generated
+        // affordance, not part of the note's content.
+        const clone = li.cloneNode(true);
+        Array.from(clone.querySelectorAll('a'))
+            .filter((a) => a.getAttribute('href') === `#fnref-${footnoteId}`)
+            .forEach((a) => a.remove());
+        const children = flowBlocks(clone);
+        items.push(elementBase('footnote-item', children.length > 0 ? children : [paragraph()], { footnoteId }));
+    });
+    return elementBase('footnote-list', items);
+}
 function convertImage(img, caption) {
     const src = safeImageSrc(img.getAttribute('src') ?? '');
     if (!src)
@@ -292,7 +316,7 @@ function convertBlock(el) {
         }
         case 'ul':
         case 'ol':
-            return [convertList(el)];
+            return el.hasAttribute('data-likhari-footnote-list') ? [convertFootnoteList(el)] : [convertList(el)];
         case 'li':
             return convertListItem(el, false).length > 0 ? [elementBase('list', convertListItem(el, false), { listType: 'bullet', start: 1, tag: 'ul' })] : [];
         case 'table':

package/dist/html/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/html/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAE4E,KAAK,KAAK,EAC5F,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAyGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAyCtE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAE1F"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/html/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAEkG,KAAK,KAAK,EAClH,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAgID,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA6CtE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAI1F"}

package/dist/html/serialize.js

@@ -1,4 +1,4 @@
-import { FORMAT_BOLD, FORMAT_CODE, FORMAT_HIGHLIGHT, FORMAT_ITALIC, FORMAT_STRIKETHROUGH, FORMAT_SUBSCRIPT, FORMAT_SUPERSCRIPT, FORMAT_UNDERLINE, INDENT_PX, rootChildren, } from '../shared/serialized.js';
+import { FORMAT_BOLD, FORMAT_CODE, FORMAT_HIGHLIGHT, FORMAT_ITALIC, FORMAT_STRIKETHROUGH, FORMAT_SUBSCRIPT, FORMAT_SUPERSCRIPT, FORMAT_UNDERLINE, INDENT_PX, collectFootnoteOrder, rootChildren, } from '../shared/serialized.js';
 export function escapeHtml(value) {
     return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
 }
@@ -87,6 +87,26 @@ function tableToHtml(node, ctx) {
         .join('');
     return `<table><tbody>${rows}</tbody></table>`;
 }
+/** Set once per serializeHtml() call and read by the footnote cases below —
+ * avoids threading a numbering map through every recursive nodeToHtml call
+ * for what is otherwise a leaf concern of two node types. Safe because
+ * serialization is synchronous and this module is never re-entered mid-call. */
+let footnoteOrder = new Map();
+function footnoteReferenceToHtml(node) {
+    const id = String(node.footnoteId ?? '');
+    const n = footnoteOrder.get(id) ?? '?';
+    return `<sup data-likhari-footnote-ref="${escapeAttr(id)}"><a href="#fn-${escapeAttr(id)}" id="fnref-${escapeAttr(id)}">${n}</a></sup>`;
+}
+function footnoteListToHtml(node, ctx) {
+    const items = (node.children ?? [])
+        .map((item) => {
+        const id = String(item.footnoteId ?? '');
+        const body = (item.children ?? []).map((child) => nodeToHtml(child, ctx)).join('');
+        return `<li id="fn-${escapeAttr(id)}" data-likhari-footnote-item="${escapeAttr(id)}">${body} <a href="#fnref-${escapeAttr(id)}">↩</a></li>`;
+    })
+        .join('');
+    return `<ol data-likhari-footnote-list>${items}</ol>`;
+}
 function layoutToHtml(node, ctx) {
     const items = node.children ?? [];
     const templateColumns = typeof node.templateColumns === 'string' ? node.templateColumns : `repeat(${items.length}, 1fr)`;
@@ -143,11 +163,17 @@ export function nodeToHtml(node, ctx) {
             return tableToHtml(node, ctx);
         case 'layout-container':
             return layoutToHtml(node, ctx);
+        case 'footnote-reference':
+            return footnoteReferenceToHtml(node);
+        case 'footnote-list':
+            return footnoteListToHtml(node, ctx);
         default:
             // Unknown node (e.g. a future feature): keep its content, drop the wrapper.
             return inlineChildren(node, ctx);
     }
 }
 export function serializeHtml(state, ctx) {
-    return rootChildren(state).map((node) => nodeToHtml(node, ctx)).join('\n');
+    const blocks = rootChildren(state);
+    footnoteOrder = collectFootnoteOrder(blocks);
+    return blocks.map((node) => nodeToHtml(node, ctx)).join('\n');
 }

package/dist/markdown/mdast.d.ts

@@ -16,6 +16,11 @@ export interface MdNode {
     name?: string;
     attributes?: Record<string, string | null | undefined> | null;
     align?: Array<'left' | 'right' | 'center' | null> | null;
+    /** GFM footnotes (remark-gfm): `identifier` is normalized/lowercased by
+     * remark itself, `label` keeps the original casing. We only ever use
+     * plain numerals for both, so the distinction doesn't matter here. */
+    identifier?: string;
+    label?: string;
 }
 export type Attrs = Record<string, string>;
 export declare function directive(type: 'textDirective' | 'leafDirective' | 'containerDirective', name: string, attributes: Attrs, children?: MdNode[]): MdNode;

package/dist/markdown/mdast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdast.d.ts","sourceRoot":"","sources":["../../src/markdown/mdast.ts"],"names":[],"mappings":"AAAA;qFACqF;AACrF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,oBAAoB,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,MAAM,CAE1J"}
+{"version":3,"file":"mdast.d.ts","sourceRoot":"","sources":["../../src/markdown/mdast.ts"],"names":[],"mappings":"AAAA;qFACqF;AACrF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACzD;;0EAEsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,oBAAoB,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,MAAM,CAE1J"}

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

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/markdown/parse.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAiSjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,qBAAqB,CAI3F"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/markdown/parse.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAkTjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,qBAAqB,CAO3F"}

package/dist/markdown/parse.js

@@ -64,6 +64,9 @@ function inline(nodes, state, out) {
                     out.push(elementBase('link', children, { url, rel: null, target: null, title: node.title ?? null }));
                 break;
             }
+            case 'footnoteReference':
+                out.push({ type: 'footnote-reference', version: 1, footnoteId: node.identifier ?? '' });
+                break;
             case 'textDirective': {
                 const name = node.name ?? '';
                 if (name === 'span') {
@@ -290,8 +293,23 @@ function restoreUnknownDirectives(node, source) {
         return c;
     });
 }
+/** Footnote definitions are always top-level in CommonMark/GFM (never nested
+ * inside a list/quote/etc.), wherever in the source they appear — so unlike
+ * everything else `blocks()` handles, they're pulled out before the normal
+ * recursive walk and collected into the one footnote-list our editor model
+ * expects, instead of staying scattered where the source happened to put them. */
+function extractFootnoteList(topLevel) {
+    const defs = topLevel.filter((node) => node.type === 'footnoteDefinition');
+    if (defs.length === 0)
+        return null;
+    const items = defs.map((def) => elementBase('footnote-item', blocks(def.children ?? []), { footnoteId: def.identifier ?? '' }));
+    return elementBase('footnote-list', items);
+}
 export function parseMarkdown(input, _ctx) {
     const tree = processor.parse(input);
     restoreUnknownDirectives(tree, input);
-    return makeState(blocks(tree.children ?? []));
+    const topLevel = tree.children ?? [];
+    const footnoteList = extractFootnoteList(topLevel);
+    const body = blocks(topLevel.filter((node) => node.type !== 'footnoteDefinition'));
+    return makeState(footnoteList ? [...body, footnoteList] : body);
 }

package/dist/markdown/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/markdown/serialize.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAKjD,OAAO,EAAa,KAAK,KAAK,EAAe,MAAM,SAAS,CAAC;AAyC7D,2GAA2G;AAC3G,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAUjD;AAiHD,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAMhE;AAoHD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAI9F"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/markdown/serialize.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAKjD,OAAO,EAAa,KAAK,KAAK,EAAe,MAAM,SAAS,CAAC;AAyC7D,2GAA2G;AAC3G,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAUjD;AAqHD,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAMhE;AA2HD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAI9F"}

package/dist/markdown/serialize.js

@@ -152,6 +152,11 @@ function inlineNodes(children, ctx) {
             flush();
             out.push({ type: 'link', url: String(child.url ?? ''), title: child.title ? String(child.title) : null, children: inlineNodes(child.children ?? [], ctx) });
         }
+        else if (child.type === 'footnote-reference') {
+            flush();
+            const id = String(child.footnoteId ?? '');
+            out.push({ type: 'footnoteReference', identifier: id, label: id });
+        }
         else if (child.children) {
             flush();
             out.push(...inlineNodes(child.children, ctx));
@@ -284,6 +289,13 @@ function blockToMd(node, ctx) {
             return [tableToMd(node, ctx)];
         case 'layout-container':
             return [layoutToMd(node, ctx)];
+        case 'footnote-list':
+            return (node.children ?? []).map((item) => ({
+                type: 'footnoteDefinition',
+                identifier: String(item.footnoteId ?? ''),
+                label: String(item.footnoteId ?? ''),
+                children: (item.children ?? []).flatMap((child) => blockToMd(child, ctx)),
+            }));
         default:
             // Fallback rule (dialect spec §6): unknown blocks keep their text as paragraphs.
             return (node.children ?? []).flatMap((child) => blockToMd(child, ctx));

package/dist/plain-text/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plain-text/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAyDhD,eAAO,MAAM,kBAAkB,EAAE,eAkDhC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plain-text/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA6EhD,eAAO,MAAM,kBAAkB,EAAE,eAsDhC,CAAC"}

package/dist/plain-text/index.js

@@ -1,3 +1,4 @@
+import { collectFootnoteOrder } from '../shared/serialized.js';
 const LIST_ITEM_PREFIX = {
     bullet: () => '- ',
     number: (index) => `${index + 1}. `,
@@ -9,7 +10,7 @@ const LIST_ITEM_PREFIX = {
  * all formatting — this is a documented, exhaustive mapping per node type,
  * not an ad hoc `.textContent` walk.
  */
-function nodeToText(node, listItemIndex = 0) {
+function nodeToText(node, order, listItemIndex = 0) {
     const withChildren = node;
     if (node.type === 'text' || node.type === 'linebreak') {
         return node.text ?? (node.type === 'linebreak' ? '\n' : '');
@@ -20,28 +21,50 @@ function nodeToText(node, listItemIndex = 0) {
         const image = node;
         return image.altText || image.caption || '';
     }
+    // Inline marker only — its matching note is in the trailing list (below),
+    // never inline, per the fidelity matrix's "inline bracketed number".
+    if (node.type === 'footnote-reference') {
+        const id = String(node.footnoteId ?? '');
+        return `[${order.get(id) ?? '?'}]`;
+    }
     if (node.type === 'list' && withChildren.children) {
         const listType = node.listType ?? 'bullet';
         return withChildren.children
             .map((child, i) => {
             const prefix = LIST_ITEM_PREFIX[listType]?.(i) ?? '- ';
-            return prefix + nodeToText(child, i);
+            return prefix + nodeToText(child, order, i);
         })
             .join('\n');
     }
     if (withChildren.children) {
-        return withChildren.children.map((child) => nodeToText(child, listItemIndex)).join('');
+        return withChildren.children.map((child) => nodeToText(child, order, listItemIndex)).join('');
     }
     return '';
 }
-function blockToText(node) {
-    return nodeToText(node);
+function blockToText(node, order) {
+    return nodeToText(node, order);
+}
+/** `[n] note text` per footnote, in display-number order — the "trailing
+ * list" half of the fidelity matrix's plain-text footnote entry. */
+function footnoteListToText(node, order) {
+    const items = node.children ?? [];
+    return items
+        .map((item) => {
+        const id = String(item.footnoteId ?? '');
+        return `[${order.get(id) ?? '?'}] ${nodeToText(item, order)}`;
+    })
+        .join('\n');
 }
 export const plainTextConverter = {
     id: 'plain-text',
     serialize(editorState) {
         const root = editorState.root;
-        const blocks = (root.children ?? []).map(blockToText);
+        const children = root.children ?? [];
+        const order = collectFootnoteOrder(children);
+        const footnoteLists = children.filter((n) => n.type === 'footnote-list');
+        const blocks = children.filter((n) => n.type !== 'footnote-list').map((n) => blockToText(n, order));
+        if (footnoteLists.length > 0)
+            blocks.push(footnoteLists.map((n) => footnoteListToText(n, order)).join('\n'));
         return blocks.join('\n\n');
     },
     parse(input) {

package/dist/shared/serialized.d.ts

@@ -28,4 +28,9 @@ export declare function paragraph(children?: SNode[], extra?: Record<string, unk
 export declare function makeState(blocks: SNode[]): SerializedEditorState;
 /** Inline node types: everything else is a block. */
 export declare function isInlineNode(node: SNode): boolean;
+/** Footnote reference numbers (lexical-editor-spec.md §4.10) are never
+ * stored — they're each `footnote-reference` node's position, in document
+ * order, among all such nodes. Walks the whole tree once so every converter
+ * numbers references and their matching footnote-list entries identically. */
+export declare function collectFootnoteOrder(blocks: SNode[]): Map<string, number>;
 //# sourceMappingURL=serialized.d.ts.map

package/dist/shared/serialized.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialized.d.ts","sourceRoot":"","sources":["../../src/shared/serialized.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,6DAA6D;AAC7D,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;AAE7C,wBAAgB,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,KAAK,EAAE,CAElE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAK,GAAG,KAAK,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,KAAK,CAEvG;AAED,wBAAgB,SAAS,CAAC,QAAQ,GAAE,KAAK,EAAO,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,KAAK,CAE5F;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAKhE;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAEjD"}
+{"version":3,"file":"serialized.d.ts","sourceRoot":"","sources":["../../src/shared/serialized.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,6DAA6D;AAC7D,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;AAE7C,wBAAgB,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,KAAK,EAAE,CAElE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAK,GAAG,KAAK,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,KAAK,CAEvG;AAED,wBAAgB,SAAS,CAAC,QAAQ,GAAE,KAAK,EAAO,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,KAAK,CAE5F;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAKhE;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAEjD;AAED;;;8EAG8E;AAC9E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAUzE"}

package/dist/shared/serialized.js

@@ -30,3 +30,18 @@ export function makeState(blocks) {
 export function isInlineNode(node) {
     return node.type === 'text' || node.type === 'linebreak' || node.type === 'tab' || node.type === 'link' || node.type === 'autolink';
 }
+/** Footnote reference numbers (lexical-editor-spec.md §4.10) are never
+ * stored — they're each `footnote-reference` node's position, in document
+ * order, among all such nodes. Walks the whole tree once so every converter
+ * numbers references and their matching footnote-list entries identically. */
+export function collectFootnoteOrder(blocks) {
+    const order = new Map();
+    const visit = (node) => {
+        if (node.type === 'footnote-reference' && typeof node.footnoteId === 'string' && !order.has(node.footnoteId)) {
+            order.set(node.footnoteId, order.size + 1);
+        }
+        (node.children ?? []).forEach(visit);
+    };
+    blocks.forEach(visit);
+    return order;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inshapardaz/likhari-converters",
-  "version": "0.1.14-dev.115",
+  "version": "0.1.15-dev.118",
   "description": "Format transformers (Markdown/HTML/plain-text/Lexical JSON) against the canonical Lexical EditorState, isolated from UI.",
   "license": "MIT",
   "repository": {