@amermathsoc/texml-to-html 15.0.0

package/lib/elements/attrib.js

@@ -0,0 +1,41 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * attrib element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  let actualParent = htmlParentNode;
+  if (xmlnode.parentNode.tagName === 'disp-quote') {
+    const footer = this.createNode('footer');
+    htmlParentNode.appendChild(footer);
+    actualParent = footer;
+  }
+  if (
+    xmlnode.parentNode.tagName === 'fig' ||
+    xmlnode.parentNode.tagName === 'fig-group'
+  ) {
+    // NOTE there should be a figcaption element (cf. caption())
+    // NOTE so far this only occurs in mbk103, clrm067 to attribute graphics in figures
+    actualParent = htmlParentNode.querySelector(':scope>figcaption');
+  }
+  const span = this.createNode('span');
+  actualParent.insertAdjacentText('beforeend', ' '); // NOTE needed inside fig-caption
+  actualParent.appendChild(span);
+  this.passThrough(span, xmlnode);
+};

package/lib/elements/bold.js

@@ -0,0 +1,32 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import { node2macro } from '../helpers/helpers-tex.js';
+
+/**
+ * bold element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  if (xmlnode.closest('tex-math')) {
+    node2macro.apply(this, [htmlParentNode, xmlnode, 'textbf', true]);
+    return;
+  }
+  const node = this.createNode('strong');
+  htmlParentNode.appendChild(node);
+  this.passThrough(node, xmlnode);
+};

package/lib/elements/book-meta-json.js

@@ -0,0 +1,134 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+const bookMetaJson =
+{
+    book: {
+        identifiers: {
+            AMS: { // book-id
+                publKey: '',
+                volumeId: '',
+                volumeNr: '', // book-volume-number
+            },
+            crossref: { // book-id
+                doi: ''
+            },
+            issn: {
+                // print: '',
+            },
+            isbn: {
+                // electronic: '',
+                // google: '',
+                // print: '',
+                // softcover: '',
+            }
+        },
+        title: '', // NOTE might contain math (but no use case yet)
+        // alttitle: '', // NOTE once we have math mode, we should have alttitle
+        // subtitle: '',
+        // history: '', // html output drops history, too
+    },
+    publishers:
+        [
+            // {
+            //     name: '',
+            //     location: ''
+            // },
+        ]
+    ,
+    contributors: {
+        // contributor groups (editors, translators, illustrators)
+        // NOTE should have at least have 1 author or 1 editor
+        // e.g.
+        // authors: [
+        //     {
+        //         // name: '',
+        //         // affiliations: [],
+        //         // email: [],
+        //         // homepage: [],
+
+        //     }
+        // ],
+        // ...
+    },
+    permissions: {
+        // NOTE we only use the statement downstream
+        // copyrightYear: '',
+        // copyrightHolder: ''
+        copyrightStatement: '',
+
+    },
+    // collection: {
+    //     title: '',
+    //     subseries: '',
+    // },
+}
+/**
+ * NOTE: `this` bound via call
+ * @param {Node} bookMetaNode book-meta XML element node
+ * @returns {String} JSON string with metadata
+ */
+export function generateBookJson(bookMetaNode) {
+
+    // identifiers
+    bookMetaJson.book.identifiers.AMS.publKey = bookMetaNode.querySelector('book-id[assigning-authority="AMS"][book-id-type="publisher"]')?.textContent;
+    bookMetaJson.book.identifiers.AMS.volumeId = bookMetaNode.querySelector('book-id[assigning-authority="AMS"][book-id-type="volume_id"]')?.textContent;
+    bookMetaJson.book.identifiers.crossref.doi = bookMetaNode.querySelector('book-id[assigning-authority="crossref"][book-id-type="doi"]')?.textContent;
+
+    // Volume number
+    bookMetaJson.book.identifiers.AMS.volumeNr = bookMetaNode.querySelector('book-volume-number')?.textContent;
+
+    // basename
+    bookMetaJson.book.identifiers.basename = bookMetaJson.book.identifiers.AMS.publKey + bookMetaJson.book.identifiers.AMS.volumeNr
+
+    bookMetaJson.contributors = this.extractContribGroups(bookMetaNode);
+
+    bookMetaNode.querySelectorAll('publisher').forEach(publisher => {
+        const publisherData = { name: publisher.querySelector('publisher-name').textContent };
+        if (publisher.querySelector('publisher-loc')) publisherData.location = publisher.querySelector('publisher-loc').textContent;
+        bookMetaJson.publishers.push(publisherData);
+    })
+
+    bookMetaJson.permissions.copyrightStatement = bookMetaNode.querySelector('copyright-statement')?.textContent;
+    bookMetaNode.querySelectorAll('isbn').forEach(isbn => {
+        bookMetaJson.book.identifiers.isbn[isbn.getAttribute('publication-format')] = isbn.textContent;
+    })
+    bookMetaNode.querySelectorAll('issn').forEach(issn => {
+        bookMetaJson.book.identifiers.issn[issn.getAttribute('publication-format')] = issn.textContent;
+    })
+
+    // book-title-group
+    const title = bookMetaNode.querySelector('book-title-group > book-title'); // NOTE title might contain math-mode (no use case yet)
+    const subtitle = bookMetaNode.querySelector('book-title-group > subtitle'); // NOTE subtitle might contain math-mode (no use case yet)
+    const alttitle = bookMetaNode.querySelector('book-title-group > alt-title') || title;
+    bookMetaJson.book.title = this.passthroughIntoHTMLString(title);
+    if (subtitle) bookMetaJson.book.subtitle = this.passthroughIntoHTMLString(subtitle);
+    if (alttitle) bookMetaJson.book.alttitle = alttitle.textContent;
+
+    // collection-meta
+    const collectionMeta = bookMetaNode.ownerDocument.querySelector('collection-meta');
+    if (collectionMeta) {
+        bookMetaJson.collection = {};
+        bookMetaJson.collection.title = collectionMeta.querySelector('title-group > title').textContent;
+        collectionMeta.querySelectorAll('custom-meta').forEach(customMeta => {
+            // NOTE custom-meta should have exactly two children - meta-name and meta-value
+            bookMetaJson.collection[customMeta.querySelector('meta-name').textContent] = customMeta.querySelector('meta-value').textContent;
+        });
+    }
+
+    return JSON.stringify(bookMetaJson);
+};
+

package/lib/elements/book-meta.js

@@ -0,0 +1,33 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import { generateBookJson } from './book-meta-json.js';
+
+/**
+ * book-meta element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const titlepage = this.createNode('section', '', {
+    'data-ams-doc': 'titlepage'
+  });
+  htmlParentNode.appendChild(titlepage);
+
+  const script = this.createNode('script', '', { type: "application/json" });
+  titlepage.append(script);
+  script.textContent = generateBookJson.call(this, xmlnode);
+};

package/lib/elements/book-title.js

@@ -0,0 +1,26 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * book-title element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const heading = this.createNode('h1');
+  htmlParentNode.appendChild(heading);
+  this.passThrough(heading, xmlnode);
+};

package/lib/elements/boxed-text.js

@@ -0,0 +1,31 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import mapAttributes from '../helpers/mapAttributes.js';
+import { mapColorAttributes } from '../helpers/mapColorAttributes.js';
+
+/**
+ * boxed-text element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const node = this.createNode('div', '', { 'data-ams-style': 'boxed' });
+  htmlParentNode.appendChild(node);
+  mapAttributes(node, xmlnode);
+  mapColorAttributes(node, xmlnode);
+  this.passThrough(node, xmlnode);
+};

package/lib/elements/break.js

@@ -0,0 +1,25 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * break element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+ export default function (htmlParentNode) {
+  const br = this.createNode('br');
+  htmlParentNode.appendChild(br);
+};

package/lib/elements/caption.js

@@ -0,0 +1,52 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * caption element; also used for label element (when inside fig, table etc. - cf. label.js)
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+ export default function (htmlParentNode, xmlnode) {
+  const isLabel = xmlnode.tagName === 'label';
+  if (
+    isLabel &&
+    xmlnode.nextElementSibling &&
+    xmlnode.nextElementSibling.tagName === 'caption'
+  ) {
+    return;
+  }
+  const isSubfigure =
+    (xmlnode.parentNode.tagName === 'fig' &&
+    xmlnode.parentNode.parentNode.tagName === 'fig-group') ||
+    (xmlnode.parentNode.tagName === 'table-wrap' &&
+    xmlnode.parentNode.parentNode.tagName === 'table-wrap-group') ;
+  const previousSibling = xmlnode.previousElementSibling;
+  const hasLabel = previousSibling && previousSibling.tagName === 'label';
+
+  const figcaption = this.createNode('figcaption');
+  htmlParentNode.appendChild(figcaption);
+
+  if (isLabel || hasLabel) {
+    const label = isLabel ? xmlnode : previousSibling;
+    const strong = this.createNode('strong');
+    figcaption.appendChild(strong);
+    if (isSubfigure) strong.insertAdjacentText('afterbegin', '(');
+    this.passThrough(strong, label);
+    strong.insertAdjacentText('beforeend', isSubfigure ? ') ' : '. ');
+  }
+  if (isLabel) return;
+  this.passThrough(figcaption, xmlnode);
+};

package/lib/elements/compound-kwd.js

@@ -0,0 +1,27 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * compound-kwd element
+ * NOTE: left in document because compound-kwd-part[content-type="text"] can contain tex-math
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const li = this.createNode('li', '', { 'data-msc-role': xmlnode.getAttribute('content-type'), 'data-msc-key': xmlnode.querySelector('compound-kwd-part[content-type="code"]').textContent });
+  htmlParentNode.appendChild(li);
+  this.passThrough(li, xmlnode.querySelector('compound-kwd-part[content-type="text"]'));
+};

package/lib/elements/def-item.js

@@ -0,0 +1,26 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * def-item element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const div = this.createNode('div');
+  htmlParentNode.appendChild(div);
+  this.passThrough(div, xmlnode);
+};

package/lib/elements/def-list.js

@@ -0,0 +1,30 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import mapAttributes from '../helpers/mapAttributes.js';
+
+/**
+ * def-list element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const dl = this.createNode('dl');
+  mapAttributes(dl, xmlnode);
+  // NOTE DOM let's us insert DL in p, which is invalid
+  htmlParentNode.appendChild(dl);
+  this.passThrough(dl, xmlnode);
+};

package/lib/elements/def.js

@@ -0,0 +1,29 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import mapAttributes from '../helpers/mapAttributes.js';
+
+/**
+ * def element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const dd = this.createNode('dd');
+  mapAttributes(dd, xmlnode);
+  htmlParentNode.appendChild(dd);
+  this.passThrough(dd, xmlnode);
+};

package/lib/elements/disp-formula-group.js

@@ -0,0 +1,30 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * disp-formula-group element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const figure = this.createNode('figure', '', {
+    'data-ams-doc': 'statement',
+    'data-ams-content-type': 'disp-formula-group',
+    id: xmlnode.id,
+  });
+  htmlParentNode.appendChild(figure);
+  this.passThrough(figure, xmlnode);
+};

package/lib/elements/disp-quote.js

@@ -0,0 +1,33 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * disp-quote element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const specificUse = xmlnode.getAttribute('specific-use');
+  const contentType = xmlnode.getAttribute('content-type');
+  const blockquote = this.createNode('blockquote');
+  if (contentType === 'epigraph')
+    blockquote.setAttribute('role', 'doc-epigraph');
+  else blockquote.setAttribute('data-ams-style', specificUse);
+  if (htmlParentNode.tagName === 'P')
+    htmlParentNode.insertAdjacentElement('afterend', blockquote);
+  else htmlParentNode.appendChild(blockquote);
+  this.passThrough(blockquote, xmlnode);
+};

package/lib/elements/email.js

@@ -0,0 +1,28 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+/**
+ * email element 
+ * NOTE: only for email within content; within metadata see the json generation.
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const text = xmlnode.textContent;
+  htmlParentNode.appendChild(
+    this.createNode('a', text, { href: `mailto://${text}` })
+  );
+};

package/lib/elements/ext-link.js

@@ -0,0 +1,38 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import { unnestLinks } from '../helpers/unnest.js';
+import { node2macro } from '../helpers/helpers-tex.js';
+
+/**
+ * ext-link element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  if (xmlnode.closest('tex-math')) {
+    node2macro.apply(this, [htmlParentNode, xmlnode, `href{${xmlnode.getAttribute('xlink:href')}}`, true]); // NOTE href works in both math and text mode; `\href`'s first argument does not need escaping
+    return;
+  }
+  const anchor = this.createNode('a', '', {
+    href: xmlnode.getAttribute('xlink:href')
+  });
+  htmlParentNode.appendChild(anchor);
+  // handle nested links
+  const linkChild = xmlnode.childNodes.find(node => node.tagName === 'xref' || node.tagName === 'ext-link');
+  if (linkChild) unnestLinks(this.recurseTheDom, this.createNode, xmlnode, anchor, linkChild)
+  else this.passThrough(anchor, xmlnode);
+};

package/lib/elements/fig.js

@@ -0,0 +1,32 @@
+/*!
+ *  Copyright (c) 2023 American Mathematical Society
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import mapAttributes from '../helpers/mapAttributes.js';
+
+/**
+ * fig element, also used for fig-group, verse-group, table-wrap, table-wrap-group
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const figure = this.createNode('figure', '', {
+    'data-ams-doc': xmlnode.tagName
+  });
+  if (xmlnode.getAttribute('position')) figure.setAttribute('data-ams-position', xmlnode.getAttribute('position'));
+  mapAttributes(figure, xmlnode);
+  htmlParentNode.appendChild(figure);
+  this.passThrough(figure, xmlnode);
+};