remark-docx 0.1.7 → 0.1.8

package/README.md

@@ -23,7 +23,7 @@ If you have some feature requests or improvements, please create a [issue](https
 - [ ] code
 - [ ] yaml
 - [ ] toml
-- [ ] definition
+- [x] definition
 - [x] footnoteDefinition
 - [x] text
 - [x] emphasis
@@ -33,8 +33,8 @@ If you have some feature requests or improvements, please create a [issue](https
 - [x] break
 - [x] link
 - [x] image
-- [ ] linkReference
-- [ ] imageReference
+- [x] linkReference
+- [x] imageReference
 - [x] footnote
 - [x] footnoteReference
 - [x] LaTeX support with math and inlineMath ([remark-math](https://github.com/remarkjs/remark-math) is required)

package/lib/index.js

@@ -427,13 +427,44 @@ const DEFAULT_NUMBERINGS = [
         },
     },
 ];
+const createFootnoteRegistry = () => {
+    const idToInternalId = new Map();
+    const defs = new Map();
+    const getId = (id) => {
+        let internalId = idToInternalId.get(id);
+        if (internalId == null) {
+            idToInternalId.set(id, (internalId = idToInternalId.size + 1));
+        }
+        return internalId;
+    };
+    return {
+        ref: (id) => {
+            return getId(id);
+        },
+        def: (id, def) => {
+            const internalId = getId(id);
+            defs.set(internalId, def);
+        },
+        footnotes: () => {
+            return defs.entries().reduce((acc, [key, def]) => {
+                acc[key] = def;
+                return acc;
+            }, {});
+        },
+    };
+};
 const mdastToDocx = async (node, { output = "buffer", title, subject, creator, keywords, description, lastModifiedBy, revision, styles, background, }, images) => {
-    const footnoteRegistry = {};
-    const { nodes, footnotes } = convertNodes(node.children, {
+    const definition = {};
+    unistUtilVisit.visit(node, "definition", (node) => {
+        definition[node.identifier] = node.url;
+    });
+    const footnote = createFootnoteRegistry();
+    const nodes = convertNodes(node.children, {
         deco: {},
         images,
         indent: 0,
-        footnoteRegistry,
+        def: definition,
+        footnote,
     });
     const doc = new docx.Document({
         title,
@@ -445,7 +476,7 @@ const mdastToDocx = async (node, { output = "buffer", title, subject, creator, k
         revision,
         styles,
         background,
-        footnotes,
+        footnotes: footnote.footnotes(),
         sections: [{ children: nodes }],
         numbering: {
             config: [
@@ -467,42 +498,27 @@ const mdastToDocx = async (node, { output = "buffer", title, subject, creator, k
             return docx.Packer.toBlob(doc);
     }
 };
-const getOrCreateFootnoteId = (identifier, registry) => {
-    if (!(identifier in registry)) {
-        registry[identifier] = Object.keys(registry).length + 1;
-    }
-    return registry[identifier];
-};
 const convertNodes = (nodes, ctx) => {
     const results = [];
-    let footnotes = {};
     for (const node of nodes) {
         switch (node.type) {
             case "paragraph": {
-                const { paragraph, footnotes: nestedFootnotes } = buildParagraph(node, ctx);
-                results.push(paragraph);
-                footnotes = { ...footnotes, ...nestedFootnotes };
+                results.push(buildParagraph(node, ctx));
                 break;
             }
             case "heading": {
-                const { heading, footnotes: nestedFootnotes } = buildHeading(node, ctx);
-                results.push(heading);
-                footnotes = { ...footnotes, ...nestedFootnotes };
+                results.push(buildHeading(node, ctx));
                 break;
             }
             case "thematicBreak":
                 results.push(buildThematicBreak());
                 break;
             case "blockquote": {
-                const { nodes: blockquoteNodes, footnotes: nestedFootnotes } = buildBlockquote(node, ctx);
-                results.push(...blockquoteNodes);
-                footnotes = { ...footnotes, ...nestedFootnotes };
+                results.push(...buildBlockquote(node, ctx));
                 break;
             }
             case "list": {
-                const { nodes: listNodes, footnotes: nestedFootnotes } = buildList(node, ctx);
-                results.push(...listNodes);
-                footnotes = { ...footnotes, ...nestedFootnotes };
+                results.push(...buildList(node, ctx));
                 break;
             }
             case "listItem":
@@ -527,11 +543,10 @@ const convertNodes = (nodes, ctx) => {
                 // FIXME: unimplemented
                 break;
             case "definition":
-                // FIXME: unimplemented
+                // noop
                 break;
             case "footnoteDefinition": {
-                const footnoteId = getOrCreateFootnoteId(node.identifier, ctx.footnoteRegistry || {});
-                footnotes[footnoteId] = buildFootnoteDefinition(node, ctx);
+                registerFootnoteDefinition(node, ctx);
                 break;
             }
             case "text":
@@ -541,12 +556,11 @@ const convertNodes = (nodes, ctx) => {
             case "strong":
             case "delete": {
                 const { type, children } = node;
-                const { nodes, footnotes: nestedFootnotes } = convertNodes(children, {
+                const nodes = convertNodes(children, {
                     ...ctx,
                     deco: { ...ctx.deco, [type]: true },
                 });
                 results.push(...nodes);
-                footnotes = { ...footnotes, ...nestedFootnotes };
                 break;
             }
             case "inlineCode":
@@ -557,24 +571,24 @@ const convertNodes = (nodes, ctx) => {
                 results.push(buildBreak());
                 break;
             case "link": {
-                const { link, footnotes: nestedFootnotes } = buildLink(node, ctx);
-                results.push(link);
-                footnotes = { ...footnotes, ...nestedFootnotes };
+                results.push(buildLink(node, ctx));
                 break;
             }
             case "image":
                 results.push(buildImage(node, ctx.images));
                 break;
             case "linkReference":
-                // FIXME: unimplemented
+                results.push(...buildLinkReference(node, ctx));
                 break;
-            case "imageReference":
-                // FIXME: unimplemented
+            case "imageReference": {
+                const image = buildImageReference(node, ctx);
+                if (image) {
+                    results.push(image);
+                }
                 break;
+            }
             case "footnote": {
-                const { footnoteRef, footnoteData } = buildFootnote(node, ctx);
-                results.push(footnoteRef);
-                footnotes = { ...footnotes, ...footnoteData };
+                // inline footnote was removed in mdast v5
                 break;
             }
             case "footnoteReference":
@@ -591,14 +605,11 @@ const convertNodes = (nodes, ctx) => {
                 break;
         }
     }
-    return {
-        nodes: results,
-        footnotes,
-    };
+    return results;
 };
 const buildParagraph = ({ children }, ctx) => {
     const list = ctx.list;
-    const { nodes, footnotes: nestedFootnotes } = convertNodes(children, ctx);
+    const nodes = convertNodes(children, ctx);
     if (list && list.checked != null) {
         nodes.unshift(new docx.CheckBox({
             checked: list.checked,
@@ -606,30 +617,27 @@ const buildParagraph = ({ children }, ctx) => {
             uncheckedState: { value: "2610" },
         }));
     }
-    return {
-        paragraph: new docx.Paragraph({
-            children: nodes,
-            indent: ctx.indent > 0
+    return new docx.Paragraph({
+        children: nodes,
+        indent: ctx.indent > 0
+            ? {
+                start: docx.convertInchesToTwip(INDENT * ctx.indent),
+            }
+            : undefined,
+        ...(list &&
+            (list.ordered
                 ? {
-                    start: docx.convertInchesToTwip(INDENT * ctx.indent),
+                    numbering: {
+                        reference: ORDERED_LIST_REF,
+                        level: list.level,
+                    },
                 }
-                : undefined,
-            ...(list &&
-                (list.ordered
-                    ? {
-                        numbering: {
-                            reference: ORDERED_LIST_REF,
-                            level: list.level,
-                        },
-                    }
-                    : {
-                        bullet: {
-                            level: list.level,
-                        },
-                    })),
-        }),
-        footnotes: nestedFootnotes,
-    };
+                : {
+                    bullet: {
+                        level: list.level,
+                    },
+                })),
+    });
 };
 const buildHeading = ({ children, depth }, ctx) => {
     let headingLevel;
@@ -653,14 +661,11 @@ const buildHeading = ({ children, depth }, ctx) => {
             headingLevel = docx.HeadingLevel.HEADING_5;
             break;
     }
-    const { nodes, footnotes: nestedFootnotes } = convertNodes(children, ctx);
-    return {
-        heading: new docx.Paragraph({
-            heading: headingLevel,
-            children: nodes,
-        }),
-        footnotes: nestedFootnotes,
-    };
+    const nodes = convertNodes(children, ctx);
+    return new docx.Paragraph({
+        heading: headingLevel,
+        children: nodes,
+    });
 };
 const buildThematicBreak = (_) => {
     return new docx.Paragraph({
@@ -668,31 +673,28 @@ const buildThematicBreak = (_) => {
     });
 };
 const buildBlockquote = ({ children }, ctx) => {
-    const { nodes, footnotes: nestedFootnotes } = convertNodes(children, { ...ctx, indent: ctx.indent + 1 });
-    return { nodes, footnotes: nestedFootnotes };
+    return convertNodes(children, {
+        ...ctx,
+        indent: ctx.indent + 1,
+    });
 };
 const buildList = ({ children, ordered, start: _start, spread: _spread }, ctx) => {
     const list = {
         level: ctx.list ? ctx.list.level + 1 : 0,
         ordered: !!ordered,
     };
-    let allFootnotes = {};
-    const allNodes = children.flatMap((item) => {
-        const { nodes, footnotes: itemFootnotes } = buildListItem(item, {
+    return children.flatMap((item) => {
+        return buildListItem(item, {
             ...ctx,
             list,
         });
-        allFootnotes = { ...allFootnotes, ...itemFootnotes };
-        return nodes;
     });
-    return { nodes: allNodes, footnotes: allFootnotes };
 };
 const buildListItem = ({ children, checked, spread: _spread }, ctx) => {
-    const { nodes, footnotes: nestedFootnotes } = convertNodes(children, {
+    return convertNodes(children, {
         ...ctx,
         ...(ctx.list && { list: { ...ctx.list, checked: checked !== null && checked !== void 0 ? checked : undefined } }),
     });
-    return { nodes, footnotes: nestedFootnotes };
 };
 const buildTable = ({ children, align }, ctx) => {
     const cellAligns = align === null || align === void 0 ? void 0 : align.map((a) => {
@@ -721,7 +723,7 @@ const buildTableRow = ({ children }, ctx, cellAligns) => {
     });
 };
 const buildTableCell = ({ children }, ctx, align) => {
-    const { nodes } = convertNodes(children, ctx);
+    const nodes = convertNodes(children, ctx);
     return new docx.TableCell({
         children: [
             new docx.Paragraph({
@@ -737,7 +739,7 @@ const buildHtml = ({ value }) => {
         children: [buildText(value, {})],
     });
 };
-const buildCode = ({ value, lang: _lang, meta: _meta }) => {
+const buildCode = ({ value, lang: _lang, meta: _meta, }) => {
     // FIXME: transform to text for now
     return new docx.Paragraph({
         children: [buildText(value, {})],
@@ -768,17 +770,14 @@ const buildText = (text, deco) => {
 const buildBreak = (_) => {
     return new docx.TextRun({ text: "", break: 1 });
 };
-const buildLink = ({ children, url, title: _title }, ctx) => {
-    const { nodes, footnotes: nestedFootnotes } = convertNodes(children, ctx);
-    return {
-        link: new docx.ExternalHyperlink({
-            link: url,
-            children: nodes,
-        }),
-        footnotes: nestedFootnotes,
-    };
+const buildLink = ({ children, url }, ctx) => {
+    const nodes = convertNodes(children, ctx);
+    return new docx.ExternalHyperlink({
+        link: url,
+        children: nodes,
+    });
 };
-const buildImage = ({ url, title: _title, alt: _alt }, images) => {
+const buildImage = ({ url }, images) => {
     const img = images[url];
     invariant(img, `Fetch image was failed: ${url}`);
     const { image, width, height } = img;
@@ -790,32 +789,25 @@ const buildImage = ({ url, title: _title, alt: _alt }, images) => {
         },
     });
 };
-const buildFootnote = ({ children }, ctx) => {
-    // Generate auto ID based on current registry size to ensure uniqueness
-    const registry = ctx.footnoteRegistry || {};
-    const autoId = `inline-${Object.keys(registry).length + 1}`;
-    const footnoteId = getOrCreateFootnoteId(autoId, registry);
-    const footnoteContent = children.map((node) => {
-        // Convert each node and extract the first result as a paragraph
-        const { nodes } = convertNodes([node], ctx);
-        if (nodes[0] instanceof docx.Paragraph) {
-            return nodes[0];
-        }
-        // For non-paragraph content, wrap in a paragraph
-        return new docx.Paragraph({ children: nodes });
-    });
-    return {
-        footnoteRef: new docx.FootnoteReferenceRun(footnoteId),
-        footnoteData: {
-            [footnoteId]: { children: footnoteContent },
-        },
-    };
+const buildLinkReference = ({ children, identifier }, ctx) => {
+    const def = ctx.def[identifier];
+    if (def == null) {
+        return convertNodes(children, ctx);
+    }
+    return [buildLink({ children, url: def }, ctx)];
 };
-const buildFootnoteDefinition = ({ children }, ctx) => {
-    return {
+const buildImageReference = ({ identifier }, ctx) => {
+    const def = ctx.def[identifier];
+    if (def == null) {
+        return;
+    }
+    return buildImage({ url: def }, ctx.images);
+};
+const registerFootnoteDefinition = ({ children, identifier }, ctx) => {
+    const definition = {
         children: children.map((node) => {
             // Convert each node and extract the first result as a paragraph
-            const { nodes } = convertNodes([node], ctx);
+            const nodes = convertNodes([node], ctx);
             if (nodes[0] instanceof docx.Paragraph) {
                 return nodes[0];
             }
@@ -823,10 +815,10 @@ const buildFootnoteDefinition = ({ children }, ctx) => {
             return new docx.Paragraph({ children: nodes });
         }),
     };
+    ctx.footnote.def(identifier, definition);
 };
 const buildFootnoteReference = ({ identifier }, ctx) => {
-    const footnoteId = getOrCreateFootnoteId(identifier, ctx.footnoteRegistry || {});
-    return new docx.FootnoteReferenceRun(footnoteId);
+    return new docx.FootnoteReferenceRun(ctx.footnote.ref(identifier));
 };
 
 const plugin = function (opts = {}) {
@@ -839,14 +831,34 @@ const plugin = function (opts = {}) {
         unistUtilVisit.visit(node, "image", (node) => {
             imageList.push(node);
         });
+        const defs = new Map();
+        unistUtilVisit.visit(node, "definition", (node) => {
+            defs.set(node.identifier, node);
+        });
+        unistUtilVisit.visit(node, "imageReference", (node) => {
+            const maybeImage = defs.get(node.identifier);
+            if (maybeImage) {
+                imageList.push(maybeImage);
+            }
+        });
         if (imageList.length === 0) {
             return node;
         }
         const imageResolver = opts.imageResolver;
         invariant(imageResolver, "options.imageResolver is not defined.");
-        const imageDatas = await Promise.all(imageList.map(({ url }) => imageResolver(url)));
-        images = imageList.reduce((acc, img, i) => {
-            acc[img.url] = imageDatas[i];
+        const resolved = new Set();
+        const promises = [];
+        imageList.forEach(({ url }) => {
+            if (!resolved.has(url)) {
+                resolved.add(url);
+                promises.push((async () => {
+                    const img = await imageResolver(url);
+                    return { img, url };
+                })());
+            }
+        });
+        images = (await Promise.all(promises)).reduce((acc, { img, url }) => {
+            acc[url] = img;
             return acc;
         }, {});
         return node;