@amermathsoc/texml-to-html 15.0.0

package/lib/elements/tag.js

@@ -0,0 +1,50 @@
+/*!
+ *  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';
+
+/**
+ * tag element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+    // usually, tag appears inside tex-math
+    if (xmlnode.closest('tex-math')) {
+        // rewrite to macro
+        const macroName = (xmlnode.getAttribute('parens') === 'yes') ? 'tag' : 'tag*';
+        node2macro.apply(this, [htmlParentNode, xmlnode, macroName]);
+
+        // tag extraction
+        // if some tag in the equation is linked, we store all tags as part of a JSON array in the data-ams-tag attribute on the HTML parent
+        if (!xmlnode.closest('disp-formula').querySelector('target tag')) return;
+        const tagArray = htmlParentNode.hasAttribute('data-ams-tags') ? JSON.parse(htmlParentNode.getAttribute('data-ams-tags')) : [];
+        tagArray.push(this.passthroughIntoHTMLString(xmlnode)); // NOTE we only need passThroughIntoHTMLString here, i.e., we don't need to escape active TeX characters, because node2macro already ran and modified xmlnode
+        htmlParentNode.setAttribute('data-ams-tags', JSON.stringify(tagArray));
+    }
+    // rarely, it appears in "text equations" (cf. formula.js, target.js)
+    else if (xmlnode.closest('disp-formula[content-type="text"]')) {
+        const span = this.createNode('span', '', { 'data-ams-doc': 'label', id: xmlnode.parentNode.id }); // NOTE: tag should always have a <target> parent with an ID.
+        if (xmlnode.getAttribute('parens') === 'yes') span.insertAdjacentText('afterbegin', '(')
+        this.passThrough(span, xmlnode);
+        if (xmlnode.getAttribute('parens') === 'yes') span.insertAdjacentText('beforeend', ')')
+        htmlParentNode.prepend(span);
+    }
+    // tag extraction 
+    // if some tag in the equation is linked, we store all tags in a special element in the HTML parent
+    const tagsElement = htmlParentNode.closest('[data-ams-doc~="math"]').firstElementChild;
+    if (tagsElement?.getAttribute('data-ams-doc') === 'tags') tagsElement.insertAdjacentHTML('beforeend', `<span>${this.passthroughIntoHTMLString(xmlnode.cloneNode(true))}</span>`);
+};

package/lib/elements/target.js

@@ -0,0 +1,39 @@
+/*!
+ *  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 { node2macro } from '../helpers/helpers-tex.js';
+
+/**
+ * target element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  if (xmlnode.closest('tex-math')) {
+    node2macro.apply(this, [htmlParentNode, xmlnode, `cssId{${xmlnode.id}}`, false]);
+    return;
+  }
+  // NOTE: inside a "text equation" we pass it through; the tag child will pick up the ID.
+  if (xmlnode.parentNode.tagName === 'disp-formula' && xmlnode.parentNode.getAttribute('content-type') === 'text') {
+    this.passThrough(htmlParentNode, xmlnode);
+    return;
+  }
+  const span = this.createNode('span');
+  htmlParentNode.appendChild(span);
+  mapAttributes(span, xmlnode);
+  this.passThrough(span, xmlnode);
+};

package/lib/elements/term.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';
+
+/**
+ * term element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const dt = this.createNode('dt');
+  mapAttributes(dt, xmlnode);
+  // NOTE DT gets id from def-item; cf. def-item.js
+  dt.setAttribute('id', xmlnode.parentNode.id);
+  htmlParentNode.appendChild(dt);
+  this.passThrough(dt, xmlnode);
+};

package/lib/elements/tex-math.js

@@ -0,0 +1,34 @@
+/*!
+ *  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.
+ */
+
+/**
+ * tex-math element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  // nested tex-math: unwrapped but with $...$
+  if (xmlnode.parentNode.closest('tex-math')) {
+    htmlParentNode.insertAdjacentText('beforeend', '$');
+    this.passThrough(htmlParentNode, xmlnode);
+    htmlParentNode.insertAdjacentText('beforeend', '$');
+    return; // NOTE should only occur in implicit text mode (\tag{} // <tag /> etc) or within <text> elements (which are not JATS/BITS and thus occur nowhere else)
+}
+  // Otherwise we copy and pass-through
+  const element = this.createNode('tex-math');
+  htmlParentNode.appendChild(element);
+  this.passThrough(element, xmlnode);
+};

package/lib/elements/text.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 { node2macro } from '../helpers/helpers-tex.js';
+
+/**
+ * text element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  // NOTE currently no else as <text> only appears in <tex-math>
+  if (xmlnode.closest('tex-math')) {
+    node2macro.apply(this, [htmlParentNode, xmlnode, 'text', true]);
+  }
+};

package/lib/elements/toc-entry.js

@@ -0,0 +1,63 @@
+/*!
+ *  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.
+ */
+
+/**
+ * toc-entry element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const li = this.createNode('li');
+  htmlParentNode.appendChild(li);
+  const anchor = this.createNode('a', '', {
+    href: `#${xmlnode.querySelector('nav-pointer').getAttribute('rid')}`,
+  });
+  li.appendChild(anchor);
+  // NOTE unify label/title processing with label() - requires some form of new wrapper around content in lieu of heading (or have it add the anchor but then the nav-pointer will be odd to pull in). See #398
+  // NOTE [...].find() HACK for bug with ':scope > ...', jsdom/jsdom#2998
+  const label = xmlnode.querySelector(':scope>label');
+  const title = xmlnode.querySelector(':scope>title');
+  const altTitle = xmlnode.querySelector(':scope>alt-title');
+  if (label && label.innerHTML.trim() !== '') {
+    this.passThrough(anchor, label);
+    anchor.insertAdjacentText('beforeend', '. ');
+  }
+  if (altTitle) {
+    const altTitleContent = altTitle.textContent;
+    anchor.setAttribute(
+      'data-ams-doc-alttitle',
+      anchor.textContent + altTitleContent
+    );
+  }
+  if (title) this.passThrough(anchor, title);
+  // NOTE we expect very simple markup: one contrib group, string-names only
+  const contribGroup = xmlnode.querySelector(':scope>contrib-group');
+  if (contribGroup) {
+    const names = [...contribGroup.querySelectorAll('string-name')];
+    if (names.length > 0) li.insertAdjacentHTML('beforeend', '<br>');
+    li.insertAdjacentHTML(
+      'beforeend',
+      names.map((node) => `<em>${node.textContent}</em>`).join(', ')
+    );
+  }
+  if (!xmlnode.querySelector('toc-entry')) return;
+  // nested toc-entries means we have a sub-toc
+  const ol = this.createNode('ol');
+  li.appendChild(ol);
+  [...xmlnode.childNodes]
+    .filter((node) => node.tagName === 'toc-entry')
+    .forEach(this.recurseTheDom.bind(null, ol));
+};

package/lib/elements/toc.js

@@ -0,0 +1,35 @@
+/*!
+ *  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.
+ */
+
+/**
+ * toc element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const nav = this.createNode('nav', '', {
+    role: 'doc-toc',
+    'data-ams-doc-level': '0',
+    id: xmlnode.id,
+  });
+  htmlParentNode.appendChild(nav);
+  this.recurseTheDom(nav, xmlnode.querySelector('title-group'));
+  const ol = this.createNode('ol');
+  nav.appendChild(ol);
+  [...xmlnode.childNodes]
+    .filter((node) => node.tagName === 'toc-entry')
+    .forEach(this.recurseTheDom.bind(null, ol));
+};

package/lib/elements/underline.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.
+ */
+
+/**
+ * underline element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const node = this.createNode('u');
+  htmlParentNode.appendChild(node);
+  this.passThrough(node, xmlnode);
+};

package/lib/elements/x.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.
+ */
+
+/**
+ * x element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  // ignore if not xref/x or isBook
+  if ('xref' !== xmlnode.parentNode.tagName && xmlnode.closest('article'))
+    return;
+  this.passThrough(htmlParentNode, xmlnode);
+};

package/lib/elements/xref-group.js

@@ -0,0 +1,36 @@
+/*!
+ *  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.
+ */
+
+/**
+ * xref-group element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+    const refType = xmlnode.getAttribute('ref-type');
+    const refrange = xmlnode.getAttribute('middle');
+    if (xmlnode.parentNode.closest('tex-math')) {
+        // NOTE: no use case so far; cf. #428 for code example
+        return;
+    }
+    const span = this.createNode('span', '', {
+        'data-ams-doc': 'refgroup',
+        'data-ams-ref': refType,
+        'data-ams-refrange': refrange
+    });
+    htmlParentNode.appendChild(span);
+    this.passThrough(span, xmlnode);
+};

package/lib/elements/xref.js

@@ -0,0 +1,89 @@
+/*!
+ *  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 { replaceTeXCharactersInNodes } from '../helpers/helpers-tex.js';
+
+/**
+ * xref element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  // case toc-entry//xref
+  const tocEntryAncestor = xmlnode.closest('toc-entry');
+  if (tocEntryAncestor) {
+    this.passThrough(htmlParentNode, xmlnode);
+    return;
+  }
+  const refType = xmlnode.getAttribute('ref-type');
+  const isFootnoteRef = refType === 'fn';
+  // case tex-math/xref, tex-math/text/xref (with a check for footnotes in tex-math)
+  const texmathAncestor = xmlnode.closest('tex-math');
+  const foonoteAncestor = xmlnode.closest('fn');
+  if (
+    texmathAncestor &&
+    !(
+      foonoteAncestor &&
+      [...texmathAncestor.querySelectorAll('*')].includes(foonoteAncestor)
+    )
+  ) {
+    const rid = xmlnode.getAttribute('rid');
+    htmlParentNode.insertAdjacentText(
+      'beforeend',
+      `\\xhref[${refType}]{#${rid}}{`
+    );
+    if (isFootnoteRef) htmlParentNode.insertAdjacentText('beforeend', `{}^{`);
+    replaceTeXCharactersInNodes(xmlnode);
+    this.passThrough(htmlParentNode, xmlnode);
+    if (isFootnoteRef) htmlParentNode.insertAdjacentText('beforeend', `}`);
+    htmlParentNode.insertAdjacentText('beforeend', `}`);
+    return;
+  }
+  const rid = xmlnode.getAttribute('rid');
+  if (!rid) {
+    const span = this.createNode('span', '', {
+      'data-ams-ref': 'notrid'
+    });
+    htmlParentNode.appendChild(span);
+    this.passThrough(span, xmlnode);
+    return;
+  }
+  const anchor = this.createNode('a', '', {
+    href: `#${rid}`,
+    'data-ams-ref': refType
+  });
+  const typeToRole = {
+    fn: 'doc-noteref',
+    bibr: 'doc-biblioref'
+  };
+  if (typeToRole[refType]) anchor.setAttribute('role', typeToRole[refType]);
+  if (refType === 'bibr') {
+    const cite = this.createNode('cite');
+    cite.appendChild(anchor);
+    htmlParentNode.appendChild(cite);
+  } else {
+    htmlParentNode.appendChild(anchor);
+  }
+  // handle nested xref 
+  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);
+  // footonote ref gets wrapped in <sup>
+  if (isFootnoteRef) {
+    anchor.innerHTML = `<sup>${anchor.innerHTML}</sup>`;
+  }
+};

package/lib/hacks.js

@@ -0,0 +1,43 @@
+/*!
+ *  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.
+ */
+
+// From https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#phrasing_content
+// Note: 'a', 'del', 'ins', 'link', 'map', 'meta' have additional constraints that we ignore since they shouldn't occur in our content
+const phrasingContentTags = ['abbr', 'audio', 'b', 'bdo', 'br', 'button', 'canvas', 'cite', 'code', 'data', 'datalist', 'dfn', 'em', 'embed', 'i', 'iframe', 'img', 'input', 'kbd', 'label', 'mark', 'math', 'meter', 'noscript', 'object', 'output', 'picture', 'progress', 'q', 'ruby', 'samp', 'script', 'select', 'small', 'span', 'strong', 'sub', 'sup', 'svg', 'textarea', 'time', 'u', 'var', 'video', 'wbr', 'a', 'del', 'ins', 'link', 'map', 'meta']
+/**
+ * Moves non-phrasing content out of paragraph node. Works around texml#104 
+ * @param {HTMLElement} node 
+ */
+const sanitizeParagraph = node => {
+    const childrenArray = [...node.children];
+    const maybeBadChild = childrenArray.find(child => !phrasingContentTags.includes(child.tagName.toLowerCase()));
+    if (!maybeBadChild) return;
+    console.log(`Info: texml-to-html: fixing non-phrasing in paragraph, cf. texml#104, near ID ${node.closest('[id]')?.getAttribute('id')}`)
+    const remainingChildren = childrenArray.slice(childrenArray.indexOf(maybeBadChild)).reverse();
+    remainingChildren.forEach(child => node.insertAdjacentElement('afterend', child));
+    if (node.innerHTML.trim() === '') {
+        node.remove();
+    }
+}
+
+/**
+ * Wrapper around hacks
+ * @param {Document} document 
+ */
+export const applyHacks = document => {
+    // workaround texml#104
+    document.querySelectorAll('p').forEach(sanitizeParagraph);
+}

package/lib/head.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.
+ */
+
+/**
+ * Populates the HTML document head.
+ * @param {Document} xmldoc - the XML document
+ * @param {Document} htmldoc - the HTML document
+ */
+export const setHead = (xmldoc, htmldoc) => {  
+    // add charset and viewport meta tag
+    htmldoc.head.insertAdjacentHTML('afterbegin', `<meta charset="utf-8"><meta content="width=device-width, initial-scale=1" name="viewport">`);
+    // set title
+    const xmlTitle =
+      xmldoc.querySelector('front>article-meta>title-group>alt-title') ||
+      xmldoc.querySelector(
+        'book-meta>book-title-group>book-title, front>article-meta>title-group>article-title'
+      );
+    htmldoc.title = xmlTitle ? xmlTitle.textContent : 'AMS Publication';
+  
+    const root = xmldoc.querySelector('article, book');
+    const lang = root.getAttribute('xml:lang') || 'en';
+    htmldoc.querySelector('html').setAttribute('lang', lang);
+    htmldoc.querySelector('html').setAttribute('dir', 'ltr');
+  };
+  

package/lib/helpers/copyElement.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';
+
+/**
+ * Creates a (limited) copy of the element
+ * @param {HTMLElement} htmlParentNode 
+ * @param {Element} xmlnode 
+ */
+export default function (htmlParentNode, xmlnode) {
+  const copy = this.createNode(xmlnode.tagName);
+  htmlParentNode.appendChild(copy);
+  mapAttributes(copy, xmlnode);
+  this.passThrough(copy, xmlnode);
+};