@amermathsoc/texml-to-html 20.2.0 → 21.0.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [21.0.0](https://github.com/AmerMathSoc/texml-to-html/compare/v20.2.0...v21.0.0) (2026-03-16)
+
+
+### ⚠ BREAKING CHANGES
+
+* Changes sec-meta output & expects new texml book markup (#495)
+
+### Features
+
+* adjust to texml changes around book-part ([6f7fe2c](https://github.com/AmerMathSoc/texml-to-html/commit/6f7fe2c718be1db0da41615738e6174a732868fa)), closes [#495](https://github.com/AmerMathSoc/texml-to-html/issues/495)
+* **sec.js:** adjust to changes for texml-generated `sec`. ([e88d926](https://github.com/AmerMathSoc/texml-to-html/commit/e88d926dd6aad67d814e925864dd7cfa10a5373e)), closes [#505](https://github.com/AmerMathSoc/texml-to-html/issues/505)
+* **sec.js:** support new appendix markup ([3a91959](https://github.com/AmerMathSoc/texml-to-html/commit/3a91959591d96b10a806b46203576f8d07977197)), closes [#501](https://github.com/AmerMathSoc/texml-to-html/issues/501)
+* support foreword element ([22279d8](https://github.com/AmerMathSoc/texml-to-html/commit/22279d8520a3628e280f16e1bb65cd776c774da1)), closes [#507](https://github.com/AmerMathSoc/texml-to-html/issues/507)
+
+
+### Bug Fixes
+
+* **package:** update linkedom to v0.18.12 ([dbf2af1](https://github.com/AmerMathSoc/texml-to-html/commit/dbf2af155308a3ce4ee6b382e8b8cf80b159f43e))
+
 ## [20.2.0](https://github.com/AmerMathSoc/texml-to-html/compare/v20.1.1...v20.2.0) (2026-02-19)
 
 

package/README.md

@@ -141,7 +141,7 @@ Beyond HTML element and attributes, texml-to-html stores data in custom `data-*`
   - fn-return [added in ams-html output]
   - `toc-entry@specific-use` [expected: section, chapter, etc.]
 - data-ams-doc-level
-  - [0-9]
+  - [0-9] (used for heading level calculation)
 - data-ams-content-type
   - {@content-type }
   - { @notes-type } (for notes elements, cf. AmerMathSoc/texml-to-html#329)
@@ -251,7 +251,6 @@ The following provide a list from the reverse point of view.
 - toc-entry@style => data-ams-style
 - attrib => data-ams-doc="attribution"
 - attributes
-  - @disp-level => data-ams-doc-level [data-ams-doc-level is also added to some elements that lack disp-level]
   - @content-type => data-ams-content-type
   - @style => data-ams-style [e.g., statement, sec]
   - @specific-use => data-ams-specific-use [sometimes mapped to other attributes, e.g., style]

package/lib/elements/abstract.js

@@ -23,7 +23,7 @@ import getParentLevel from '../helpers/getParentLevel.js';
  * @param {Element} xmlnode 
  */
 export default function (htmlParentNode, xmlnode) {
-  const level = getParentLevel(htmlParentNode) || '1'; // NOTE in articles, we don't have a disp-level in the XML; also NOTE that this is a change from xslt which erroneously had hardcoded 1 but abstract/title still got an h2
+  const level = getParentLevel(htmlParentNode) || '1'; // NOTE fallback for when abstract doesn't have a section-like parent (e.g. article metadata)
   const section = this.createNode('section', '', {
     'data-ams-doc-level': level,
     role: 'doc-abstract'

package/lib/elements/sec-meta.js

@@ -22,11 +22,13 @@ import { generateByline } from "../helpers/generateByline.js";
  */
 export default function (htmlParentNode, xmlnode) {
   const contributors = this.extractContribGroups(xmlnode);
-  const secmetaSection = this.createNode('section', '', {
+  const secmetaSection = this.createNode('div', '', {
     'data-ams-doc': 'sec-meta',
-    'data-ams-contributors': JSON.stringify(contributors),
-    'data-ams-byline': generateByline(contributors),
   });
+  if (Object.keys(contributors).length > 0) {
+    secmetaSection.setAttribute('data-ams-contributors', JSON.stringify(contributors));
+    secmetaSection.setAttribute('data-ams-byline', generateByline(contributors));
+  }
   htmlParentNode.appendChild(secmetaSection);
 
   // NOTE: use cases for content within sec-meta so far: MCL1/14 has abstract; noti2382 has notes.

package/lib/elements/sec.js

@@ -17,6 +17,7 @@
 const sectioningDictionary = {
   part: 0,
   chapter: 0,
+  appendix: 0,
   section: 1,
   refhead: 1, // NOTE NOTI only
   subsection: 2,
@@ -32,7 +33,8 @@ const sectioningDictionary = {
  */
 export default function (htmlParentNode, xmlnode) {
   const tagName = xmlnode.tagName;
-  const specificUse = xmlnode.getAttribute('specific-use');
+  let specificUse = xmlnode.getAttribute('specific-use');
+  if (specificUse === 'section untagged') specificUse = 'section';
   const articleWithPartIncrement =
     !this.isBook && xmlnode.getRootNode().querySelector('sec[specific-use="part"]')
       ? 1
@@ -82,10 +84,9 @@ export default function (htmlParentNode, xmlnode) {
   if (tagName === 'book-app-group') {
     section.setAttribute('data-ams-doc', 'app-group');
   }
-  if (tagName === 'book-app' && !xmlnode.parentNode.closest('book-app')) {
-    section.setAttribute('role', 'doc-appendix'); // TODO: revisit after AmerMathSoc/texml#223
-    // section.setAttribute('data-ams-doc-level', '0')
-    }
+  if (tagName === 'book-app' && !xmlnode.parentNode.closest('book-app')) section.setAttribute('role', 'doc-appendix'); // TODO: revisit after AmerMathSoc/texml#223
+
+  if (tagName === 'foreword') section.setAttribute('role', 'doc-foreword');
 
   this.createHeading(section, xmlnode);
   this.passThrough(section, xmlnode);

package/lib/transformer.js

@@ -106,7 +106,7 @@ export class Transformer {
         const mapTag = (func, newtag) => (this[newtag] = func);
 
         // sec-like elements
-        ['ack', 'front-matter-part', 'dedication', 'book-app-group', 'book-app'].forEach(
+        ['ack', 'front-matter-part', 'dedication', 'book-app-group', 'book-app', 'book-part', 'foreword'].forEach(
             mapTag.bind(null, this['sec'])
         );
         // fig-like elements
@@ -131,9 +131,7 @@ export class Transformer {
             'front-matter',
             'book-body',
             'book-back',
-            'book-part',
             'named-book-part-body',
-            'book-part-meta',
             'body',
             'description',
             'custom-meta-group',
@@ -287,6 +285,7 @@ export class Transformer {
     statement = Statement.bind(this)
     secheading = SecHeading.bind(this)
     'sec-meta' = SecMeta.bind(this)
+    'book-part-meta' = SecMeta.bind(this)
     graphic = Graphic.bind(this)
     img = Img.bind(this)
     fig = Fig.bind(this)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amermathsoc/texml-to-html",
-  "version": "20.2.0",
+  "version": "21.0.0",
   "type": "module",
   "description": "A NodeJS library for converting AMS-style JATS XML to HTML",
   "scripts": {
@@ -31,11 +31,11 @@
   },
   "homepage": "https://github.com/AmerMathSoc/texml-to-html#readme",
   "devDependencies": {
-    "c8": "10.1.3",
-    "commit-and-tag-version": "12.5.1",
+    "c8": "11.0.0",
+    "commit-and-tag-version": "12.6.1",
     "tape": "5.9.0"
   },
   "dependencies": {
-    "linkedom": "0.18.10"
+    "linkedom": "0.18.12"
   }
 }

package/test/article--alttitle.xml

@@ -103,13 +103,13 @@
       <notes notes-type="article"/>
   </front>
   <body>
-    <sec id="sec" disp-level="1" specific-use="part">
-        <sec id="seclabeltitle" disp-level="2"  specific-use="section">
+    <sec id="sec" specific-use="part">
+        <sec id="seclabeltitle" specific-use="section">
             <label>Label</label>
             <title>Title</title>
         </sec>
     </sec>
-    <sec disp-level="1" id="secmeta" specific-use="section">
+    <sec id="secmeta" specific-use="section">
       <sec-meta>
         <contrib-group content-type="authors">
           <contrib contrib-type="author">

package/test/article--nometa.xml

@@ -30,8 +30,8 @@
     </article-meta>
   </front>
   <body>
-    <sec id="sec" disp-level="1" specific-use="part">
-        <sec id="seclabeltitle" disp-level="2"  specific-use="section">
+    <sec id="sec" specific-use="part">
+        <sec id="seclabeltitle" specific-use="section">
             <label>Label</label>
             <title>Title</title>
         </sec>

package/test/article.xml

@@ -157,7 +157,9 @@
         <notes notes-type="dedication"/>
     </front>
     <body>
-        <sec id="sec" disp-level="1" specific-use="section">
+        <sec id="untagged" specific-use="section untagged">
+        </sec>
+        <sec id="sec" specific-use="section">
             <styled-content style-type="type"/>
             <italic/>
             <italic toggle="yes"/>
@@ -257,36 +259,36 @@
             <title>Introduction</title>
             <attrib specific-use="aufm">The Author</attrib>
         </front-matter-part>
-        <sec id="ack3" disp-level="1"  specific-use="section">
+        <sec id="ack3" specific-use="section">
             <title>Acknowledg</title>
         </sec>
-        <sec id="intro2" disp-level="1"  specific-use="section">
+        <sec id="intro2" specific-use="section">
             <title>Introduction</title>
         </sec>
         <front-matter>
             <dedication id="ded"/>
         </front-matter>
 
-        <sec id="subsec" disp-level="2" specific-use="subsection">
+        <sec id="subsec" specific-use="subsection">
         <label>Subsection</label>
         </sec>
-        <sec id="seclabeltitle" disp-level="1"  specific-use="section">
+        <sec id="seclabeltitle" specific-use="section">
             <label>Label</label>
             <title>Title</title>
         </sec>
-        <sec id="seclabel" disp-level="1"  specific-use="section">
+        <sec id="seclabel" specific-use="section">
             <label>Label</label>
             <subtitle>Subtitle</subtitle>
         </sec>
-        <sec id="sectitle" disp-level="1"  specific-use="section">
+        <sec id="sectitle" specific-use="section">
             <title>Title</title>
             <subtitle>Subtitle</subtitle>
         </sec>
-        <sec id="refhead" disp-level="1"  specific-use="refhead">
+        <sec id="refhead" specific-use="refhead">
             <title>Refhead</title>
         </sec>
         <!-- statement -->
-        <sec disp-level="1" id="statements" specific-use="section">
+        <sec id="statements" specific-use="section">
             <statement content-type="content type" id="statement1" style="style">
                 <label>Label 1</label>
                 <title>Title 1</title>
@@ -306,19 +308,19 @@
             </statement>
             <statement content-type="proof proof" has-qed-box="true" id="statement4">
                 <title>Proof</title>
-                <secheading id="statement4secheading" disp-level="3" specific-use="subsection">
+                <secheading id="statement4secheading" specific-use="subsection">
                     <title>secheading</title>
                 </secheading>
             </statement>
             <statement content-type="proof proof" has-qed-box="true" id="statement5">
                 <label>Label 5</label>
                 <title>Proof</title>
-                <secheading id="statement5secheading" disp-level="3" specific-use="subsection">
+                <secheading id="statement5secheading" specific-use="subsection">
                     <label>secheading</label>
                 </secheading>
             </statement>
             <statement content-type="proof proof" has-qed-box="true" id="statement6">
-                <secheading id="statement6secheading" disp-level="3" specific-use="subsection">
+                <secheading id="statement6secheading" specific-use="subsection">
                     <label>Label 6<x>.</x></label>
                     <title>secheading</title>
                 </secheading>
@@ -342,7 +344,7 @@
             </def-list>
         </sec>
         <!-- fig, fig-group, caption, label -->
-        <sec disp-level="1" id="figures" specific-use="section">
+        <sec id="figures" specific-use="section">
             <fig position="anchor" id="position">
                 <label>Label 1<x>.</x></label>
                 <caption>Caption 1</caption>
@@ -366,7 +368,7 @@
             </fig-group>
         </sec>
         <!-- graphic, inline-graphic, img -->
-        <sec disp-level="1" id="graphics" specific-use="section">
+        <sec id="graphics" specific-use="section">
             <fig>
                 <graphic height="100pt" mimetype="mime" width="100" xlink:href="file" specific-use="use"><alt-text>text</alt-text></graphic>
             </fig>
@@ -374,7 +376,7 @@
             <img src="file" alt="text"></img>
         </sec>
         <!-- inline-formula, disp-formula, tex-math -->
-        <sec disp-level="1" id="equations" specific-use="section">
+        <sec id="equations" specific-use="section">
             <p>
                 <inline-formula has-qed-box="true">
                 <!-- NOTE thinspace in text element to test preservation of unicode spacing characters -->
@@ -428,20 +430,20 @@
             </disp-formula>
         </sec>
         <!-- citegroup, cite-detail-->
-        <sec disp-level="1" id="citegroup" specific-use="section">
+        <sec id="citegroup" specific-use="section">
          <p>
          <cite-group><x>[</x><xref ref-type="bibr" rid="bibr-AEG0" specific-use="cite">AEG08<cite-detail><x>, </x>Section 5</cite-detail></xref><x>; </x><xref ref-type="bibr" rid="bibr-AEG0" specific-use="cite">AEG08</xref><x>]</x></cite-group>
          </p>
         </sec>
 
         <!-- alt-title -->
-        <sec disp-level="1" id="alttitle" specific-use="section">
+        <sec id="alttitle" specific-use="section">
             <title>Title</title>
             <alt-title>Alt title</alt-title>
         </sec>
 
         <!-- styled content with color -->
-        <sec disp-level="1" id="styled_color" specific-use="section">
+        <sec id="styled_color" specific-use="section">
             <title>Color</title>
             <styled-content background-color="rgb(0.000%, 0.000%, 1.000%)" border-color="rgb(0, 140, 10)" border-width="thin" border-style="solid" text-color="Teal">Styled content with color</styled-content>
         </sec>
@@ -450,7 +452,7 @@
             <xref ref-type="fn" rid="fnid3">4</xref><fn id="fnid3"><label>3</label><p>Footnote 3</p></fn>
             <xref ref-type="fn" rid="fnid4">4</xref><fn id="fnid4"><label>4</label><p>Footnote 4</p></fn>
         </p>
-        <sec disp-level="1" id="alg:algorithm" specific-use="section">
+        <sec id="alg:algorithm" specific-use="section">
             <title>Algorithm sample</title>
             <alg:algorithm linenodelimiter=":">
                 <alg:line>
@@ -528,7 +530,7 @@
         <sec disp-level="1">
         <p>Email <email>email</email> in content, not metadata.</p>
         </sec>
-        <sec disp-level="1" id="contentModel">
+        <sec id="contentModel">
             <sec  id="contentModel-1">
                 <!-- DLs will be moved after p (but text node remains) -->
                 <p>
@@ -570,20 +572,20 @@
             <ack id="ack1" disp-level="1">
                 <title/>
             </ack>
-            <app id="applabeltitle" disp-level="1"  specific-use="section">
+            <app id="applabeltitle" specific-use="section">
                 <label>Label</label>
                 <title>Title</title>
             </app>
-            <app id="applabel" disp-level="1"  specific-use="section">
+            <app id="applabel" specific-use="section">
                 <label>Label</label>
                 <subtitle>Subtitle</subtitle>
             </app>
-            <app id="apptitle" disp-level="1"  specific-use="section">
+            <app id="apptitle" specific-use="section">
                 <title>Title</title>
                 <subtitle>Subtitle</subtitle>
             </app>
             <!-- NOTE sec-meta special treatment (see notes in code and tests)-->
-            <app id="secmeta" disp-level="1" specific-use="section">
+            <app id="secmeta" specific-use="section">
                 <label>Appendix 1</label>
                 <title>A criterion for kitchen representations</title>
                 <sec-meta>
@@ -597,7 +599,7 @@
                     </contrib-group>
                 </sec-meta>
             </app>
-            <app id="appack" disp-level="1"  specific-use="section">
+            <app id="appack" specific-use="section">
                 <title>Acknowledg</title>
             </app>
         </app-group>

package/test/book--metadata.xml

@@ -133,12 +133,13 @@
         </toc>
     </front-matter>
     <book-body>
-        <book-part>
-            <body>
-                <sec disp-level="1" id="chapter2" specific-use="chapter">
+        <book-part id="chapter2" specific-use="chapter">
+            <book-part-meta>
+                <title-group>
                     <title>Title</title>
-                </sec>
-            </body>
+                </title-group>
+            </book-part-meta>
+            <body/>
         </book-part>
     </book-body>
 </book>