@gmb/bitmark-parser-generator 5.35.0 → 5.36.0

package/dist/browser/cjs/index.cjs

@@ -1402,6 +1402,7 @@ var propertyKeys = {
   property_dateEnd: "@dateEnd",
   property_decimalPlaces: "@decimalPlaces",
   property_deeplink: "@deeplink",
+  property_displayName: "@displayName",
   property_diffContext: "@diffContext",
   property_diffOp: "@diffOp",
   property_diffRef: "@diffRef",
@@ -2551,9 +2552,30 @@ var CARDSETS = {
   [CardSetConfigKey.definitionList]: {
     jsonKey: "definitions",
     exportJsonKey: { definitions: "$" },
+    // PLAN-141 F1 (NISO import): each <def-item> is one card; the sides
+    // read <term>/<def>; the enclosing <legend>'s <title> lands on the
+    // term side's heading tag ([#Key] header card).
+    // PLAN-141 F3: a <tbx:langSet> is ALSO one card (a terminology entry —
+    // its enclosing <tbx:termEntry> is a transparent claim wrapper); its
+    // children compose the term/definition sides via the side rules below.
+    mappingKeys: {
+      "xml-niso-iec": [
+        { "@el": "def-item", "@children": "$" },
+        { "@el": "tbx:langSet", "@children": "$" }
+      ]
+    },
     sides: [
       {
         name: "term",
+        // F3: every <tbx:tig>'s <tbx:term> STACKS one-per-line onto the
+        // single term side (the "$\n" template's authored separator; the
+        // trailing one is trimmed) — the PDF's Maus/Mus/M/Müsli stack.
+        mappingKeys: {
+          "xml-niso-iec": [
+            { "@el": "term", "@text": "$" },
+            { "@el": "tbx:tig", "@children": { "@el": "tbx:term", "@text": "$\n" } }
+          ]
+        },
         variants: [
           {
             jsonKey: "term.text",
@@ -2569,7 +2591,8 @@ var CARDSETS = {
                 format: TagFormat.plainText,
                 nullable: true,
                 jsonKey: "^heading.forKeys",
-                exportJsonKey: { "@bit": { heading: { forKeys: "$" } } }
+                exportJsonKey: { "@bit": { heading: { forKeys: "$" } } },
+                mappingKeys: { "xml-niso-iec": { "@el": "title", "@text": "$" } }
               },
               {
                 key: ConfigKey.group_resourceIcon,
@@ -2595,6 +2618,24 @@ var CARDSETS = {
       },
       {
         name: "definition",
+        // F3: the definition side COMPOSES from the entry's fields in
+        // document order, with the ES-rendered locale affixes AUTHORED as
+        // value-position templates (never engine text): the subject field
+        // in ⟨⟩ glues (trailing space) onto the definition line; example /
+        // notes / source follow as blank-line-separated lines. The TBX
+        // grammar flags (normativeAuthorization, termType, partOfSpeech,
+        // grammaticalNumber) are unrendered machine-only data — dropped and
+        // recorded (catalog R-2, reviewed under D7 max-preservation).
+        mappingKeys: {
+          "xml-niso-iec": [
+            { "@el": "def", "@children": "$" },
+            { "@el": "tbx:subjectField", "@text": "\u27E8$\u27E9 " },
+            { "@el": "tbx:definition", "@children": "$" },
+            { "@el": "tbx:example", "@children": "BEISPIEL $" },
+            { "@el": "tbx:note", "@children": "Anmerkung zu Begriff: $" },
+            { "@el": "tbx:source", "@text": "[QUELLE: $]" }
+          ]
+        },
         variants: [
           {
             jsonKey: "definition.text",
@@ -3985,6 +4026,11 @@ var CARDSETS = {
           { table: { header: { rows: ["$"] } } }
         ],
         htmlKey: { "@el": "thead", "@children": { "@el": "tr", "@children": "$" } },
+        // PLAN-141 F2 (NISO import): the XHTML table model NISO uses — a
+        // <thead> SECTION whose <tr> rows are the header cards.
+        mappingKeys: {
+          "xml-niso-iec": { "@el": "thead", "@children": { "@el": "tr", "@children": "$" } }
+        },
         sideJsonKey: "cells[{s}]|set(title=true)",
         sideExportJsonKey: { cells: { $s: { title: true, $: "$" } } },
         // Header cells are `<th>`. The `width` attribute is contributed by the
@@ -3996,12 +4042,21 @@ var CARDSETS = {
         jsonKey: "table.body.rows",
         exportJsonKey: { table: { body: { rows: "$" } } },
         htmlKey: { "@el": "tbody", "@children": { "@el": "tr", "@children": "$" } },
+        // PLAN-141 F2 (NISO import): <tbody> rows are the (default) data cards.
+        mappingKeys: {
+          "xml-niso-iec": { "@el": "tbody", "@children": { "@el": "tr", "@children": "$" } }
+        },
         isDefault: true
       },
       "table-footer": {
         jsonKey: "table.footer.rows",
         exportJsonKey: { table: { footer: { rows: "$" } } },
         htmlKey: { "@el": "tfoot", "@children": { "@el": "tr", "@children": "$" } },
+        // PLAN-141 F2 (NISO import): NISO has no <tfoot> — the footer card's
+        // source is the <table-wrap-foot> block (CONTENT-shaped: no rows; its
+        // prose/notes flatten into one footer card — catalog table-wrap-foot
+        // row; a contained <def-list> promotes as a sibling legend bit).
+        mappingKeys: { "xml-niso-iec": { "@el": "table-wrap-foot", "@children": "$" } },
         sideJsonKey: "cells[{s}]|set(title=true)",
         sideExportJsonKey: { cells: { $s: { title: true, $: "$" } } },
         // Footer cells render as `<th>` (mirrors the header `title: true`
@@ -4018,6 +4073,8 @@ var CARDSETS = {
         // Default (body) cell → `<td>`; the header/footer sections override the
         // side to `<th>` via their sideHtmlKey (HTML.md §8).
         htmlKey: { "@el": "td", "@children": "$" },
+        // PLAN-141 F2 (NISO import): a <td> row child is a body cell side.
+        mappingKeys: { "xml-niso-iec": { "@el": "td", "@children": "$" } },
         variants: [
           {
             jsonKey: "content",
@@ -4035,7 +4092,11 @@ var CARDSETS = {
                 // cell with `title: true` automatically.
                 jsonKey: "content",
                 exportJsonKey: { content: "$" },
-                description: "Title text of the table cell (header rows)."
+                description: "Title text of the table cell (header rows).",
+                // PLAN-141 F2 (NISO import): a <th> row child is a TITLE cell —
+                // its content lands in the `[#…]` tag (an empty <th> keeps its
+                // slot as a bare `[#]`).
+                mappingKeys: { "xml-niso-iec": { "@el": "th", "@children": "$" } }
               },
               {
                 key: ConfigKey.property_tableCellType,
@@ -4054,6 +4115,9 @@ var CARDSETS = {
                 // HTML-C2: contribute a `rowspan` attribute onto the enclosing
                 // cell element (`<th>`/`<td>`).
                 htmlKey: { "@el": { "@attr": { rowspan: "$" } } },
+                // PLAN-141 F2 (NISO import): recover the source cell's own
+                // `rowspan` attribute (element-scope attr form).
+                mappingKeys: { "xml-niso-iec": { "@el": { "@attr": { rowspan: "$" } } } },
                 description: "Number of rows the cell spans.",
                 format: TagFormat.number
               },
@@ -4064,6 +4128,9 @@ var CARDSETS = {
                 // HTML-C2: contribute a `colspan` attribute onto the enclosing
                 // cell element (`<th>`/`<td>`).
                 htmlKey: { "@el": { "@attr": { colspan: "$" } } },
+                // PLAN-141 F2 (NISO import): recover the source cell's own
+                // `colspan` attribute (element-scope attr form).
+                mappingKeys: { "xml-niso-iec": { "@el": { "@attr": { colspan: "$" } } } },
                 description: "Number of columns the cell spans.",
                 format: TagFormat.number
               },
@@ -4085,6 +4152,13 @@ var CARDSETS = {
                 // HTML.md §8 + HTML-C2: contribute a `width` attribute onto the
                 // enclosing cell element (`<th>`/`<td>`).
                 htmlKey: { "@el": { "@attr": { width: "$" } } },
+                // PLAN-141 F2 (NISO import): NISO carries widths as PER-COLUMN
+                // <col width="…"> descriptors at container level, not on cells.
+                // The matched values distribute positionally onto the first
+                // (header) card's sides. Number format ⇒ only an integral
+                // percentage survives ("20.0000%" → 20); a fractional one
+                // (renderer-equalised "4.7619%") is dropped — catalog `col` row.
+                mappingKeys: { "xml-niso-iec": { "@el": "col", "@attr": { width: "$" } } },
                 description: "Width for the column.",
                 format: TagFormat.number
               }
@@ -4458,7 +4532,22 @@ var GROUPS = {
         key: ConfigKey.property_externalId,
         description: "The external identifier for the bit",
         format: TagFormat.plainText,
-        maxCount: Count.infinity
+        maxCount: Count.infinity,
+        // PLAN-140 refs family (NISO import): the machine identifier of a
+        // referenced standard. NESTED content slot — the tag reads (and
+        // consumes) ONLY the <std-id> inside a <std> child; the remaining
+        // designation/title text stays bit body. A <std> without <std-id>
+        // does not fire the key.
+        // PLAN-141 F5: on the [.book] bit, the DATED <std-ref> designation
+        // is the document's external id. Safe rule order: <std-ref> is a
+        // direct bit-element child only under <std-meta> (everywhere else
+        // it nests inside <std>, which the tag spine never reaches).
+        mappingKeys: {
+          "xml-niso-iec": [
+            { "@el": "std", "@children": { "@el": "std-id", "@text": "$" } },
+            { "@el": "std-ref", "@attr": { type: "dated" }, "@text": "$" }
+          ]
+        }
       },
       {
         key: ConfigKey.property_sourceRL,
@@ -4599,7 +4688,8 @@ var GROUPS = {
       {
         key: ConfigKey.property_diffTime,
         description: "The diff time for the bit",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_ageRange,
@@ -4610,7 +4700,18 @@ var GROUPS = {
       {
         key: ConfigKey.property_lang,
         description: "The language for the bit",
-        format: TagFormat.plainText
+        format: TagFormat.plainText,
+        // PLAN-141 F3 (NISO import): a term-sec's language rides
+        // <tbx:termEntry><tbx:langSet xml:lang> — a nested content slot
+        // whose leaf is a $-in-ATTR-position slot (the nested counterpart
+        // of the value-attr slot). Only termEntry elements match, so the
+        // shared tag is inert everywhere else.
+        mappingKeys: {
+          "xml-niso-iec": {
+            "@el": "tbx:termEntry",
+            "@children": { "@el": "tbx:langSet", "@attr": { "xml:lang": "$" } }
+          }
+        }
       },
       {
         key: ConfigKey.property_publisher,
@@ -4809,6 +4910,9 @@ var GROUPS = {
         key: ConfigKey.tag_item,
         jsonKey: "item",
         exportJsonKey: { item: "$" },
+        // PLAN-140 W3 (NISO import): the clause/note label of a mapped
+        // source element ([%1], [%ANMERKUNG 1]).
+        mappingKeys: { "xml-niso-iec": { "@el": "label", "@text": "$" } },
         description: "The item for the bit",
         chain: [
           {
@@ -5771,7 +5875,20 @@ var GROUPS = {
         key: ConfigKey.property_language,
         description: "The language of the book",
         format: TagFormat.plainText,
-        maxCount: Count.infinity
+        maxCount: Count.infinity,
+        // PLAN-141 F5 (NISO import): only the PRIMARY (first)
+        // <content-language> survives — the maxEmits cap realises the
+        // catalog's document-language rule (extras drop, R-4).
+        mappingKeys: {
+          "xml-niso-iec": [
+            { predicates: [], maxEmits: 1, rule: { "@el": "content-language", "@text": "$" } }
+          ]
+        }
+      },
+      {
+        key: ConfigKey.property_displayName,
+        description: "The display name of the book",
+        format: TagFormat.plainText
       },
       {
         key: ConfigKey.property_customerExternalId,
@@ -5847,7 +5964,18 @@ var GROUPS = {
         description: "The title of the book",
         maxCount: 2,
         jsonKey: "title|multi(count=2, key=subtitle)",
-        exportJsonKey: [{ "@level=1": { title: "$" } }, { "@level=2": { subtitle: "$" } }]
+        exportJsonKey: [{ "@level=1": { title: "$" } }, { "@level=2": { subtitle: "$" } }],
+        // PLAN-141 F5 (NISO import): the PRIMARY (first) <title-wrap>'s
+        // assembled <full> title → [#]; the per-language extras drop (R-4).
+        mappingKeys: {
+          "xml-niso-iec": [
+            {
+              predicates: [],
+              maxEmits: 1,
+              rule: { "@el": "title-wrap", "@children": { "@el": "full", "@text": "$" } }
+            }
+          ]
+        }
       },
       {
         key: ConfigKey.property_subtype,
@@ -6160,17 +6288,20 @@ var GROUPS = {
       {
         key: ConfigKey.property_platformMargin,
         description: "The platform margin",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_platformBorderRadius,
         description: "The platform border radius",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_platformSelectionBorderRadius,
         description: "The platform selection border radius",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_platformNeedsShadow,
@@ -6277,7 +6408,13 @@ var GROUPS = {
       {
         key: ConfigKey.property_caption,
         description: "The caption for the resource",
-        format: TagFormat.bitmarkText
+        format: TagFormat.bitmarkText,
+        // PLAN-141 F1 (NISO import): a figure's <caption><title> — the
+        // nested content slot reads the title text; the caption rides the
+        // resource chain ([&image:…][@caption:…], catalog D5).
+        mappingKeys: {
+          "xml-niso-iec": { "@el": "caption", "@children": { "@el": "title", "@text": "$" } }
+        }
       },
       {
         key: ConfigKey.property_showInIndex,
@@ -6551,6 +6688,10 @@ var GROUPS = {
       {
         key: ConfigKey.resource_image,
         exportJsonKey: { resource: { type: "image", image: { src: "$" } } },
+        // PLAN-141 F1 (NISO import): the image URL rides the `$`-in-attr
+        // value slot — a <graphic xlink:href> child of the mapped bit
+        // element roots the [&image:URL] chain.
+        mappingKeys: { "xml-niso-iec": { "@el": "graphic", "@attr": { "xlink:href": "$" } } },
         description: "The image resource",
         chain: [
           {
@@ -7425,6 +7566,8 @@ var BITS = {
         maxCount: 2,
         jsonKey: "title|multi(count=2, key=subtitle)",
         exportJsonKey: [{ "@level=1": { title: "$" } }, { "@level=2": { subtitle: "$" } }],
+        // PLAN-140 W3 (NISO import): the title of a mapped source element.
+        mappingKeys: { "xml-niso-iec": { "@el": "title", "@text": "$" } },
         key: ConfigKey.tag_title,
         description: "The title of the article"
       }
@@ -7466,12 +7609,56 @@ var BITS = {
   [BitType2.smartStandardArticleNormative]: {
     since: "1.28.0",
     baseBitType: BitType2.standardArticleNormative,
-    description: "Smart standard normative article bit"
+    description: "Smart standard normative article bit",
+    // PLAN-140 W3 (NISO import, tranche 1): one article bit per NISO
+    // paragraph (catalog D1). CONTENT keys (@children): the subtree is the
+    // bit's body; nothing inside it promotes. (Ancestor-context normativity
+    // is the non-normative sibling's @ancestor key — plan Q4, resolved.)
+    //
+    // Second rule (catalog D1 push-down): a NUMBERED-PARAGRAPH sec is an
+    // article, not a chapter — the sec-type literal outranks the chapter
+    // key's plain sec|app rule (most-specific-wins). Content key: the sec's
+    // label rides [%] via the label tag key, its inner <p> is the body, its
+    // id is the bit's customerId, and the anchor slot marks it
+    // anchor-bearing.
+    mappingKeys: {
+      "xml-niso-iec": [
+        { "@el": "p", "@attr": { id: "$customerId" }, "@children": "$" },
+        {
+          "@el": "sec",
+          "@attr": { "sec-type": "numbered-paragraph", id: "$customerId" },
+          "@children": "$",
+          "\u25BC": "$anchor"
+        }
+      ]
+    }
   },
   [BitType2.smartStandardArticleNonNormative]: {
     since: "1.28.0",
     baseBitType: BitType2.standardArticleNonNormative,
-    description: "Smart standard non-normative article bit"
+    description: "Smart standard non-normative article bit",
+    // PLAN-140 Q4 (normativity inheritance): a <p> is non-normative because
+    // of an ANCESTOR element — a foreword/intro sec or an informative annex.
+    // @ancestor is a reverse-match-only constraint (forward emission ignores
+    // it); the rules are alternatives, first-satisfied wins, and the
+    // @ancestor literals give this key higher specificity than the plain
+    // normative-article <p> key wherever the context applies.
+    mappingKeys: {
+      "xml-niso-iec": [
+        {
+          "@el": "p",
+          "@attr": { id: "$customerId" },
+          "@ancestor": { "@attr": { "sec-type": "foreword|intro" } },
+          "@children": "$"
+        },
+        {
+          "@el": "p",
+          "@attr": { id: "$customerId" },
+          "@ancestor": { "@attr": { "content-type": "informative" } },
+          "@children": "$"
+        }
+      ]
+    }
   },
   [BitType2.smartStandardArticleNormativeCollapsible]: {
     since: "1.28.0",
@@ -8102,7 +8289,8 @@ var BITS = {
       {
         key: ConfigKey.property_maxCreatedBits,
         description: "The maximum number of bits that can be created from this bit",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       }
     ],
     textFormatDefault: TextFormat2.plainText
@@ -8232,6 +8420,13 @@ var BITS = {
     since: "1.3.0",
     baseBitType: BitType2._standard,
     description: "Book bit, used to represent a book",
+    // PLAN-141 F5 (NISO import): the <std-meta> front-matter container is
+    // the [.book] bit (STRUCTURAL, first in document order): primary
+    // title-wrap → [#], primary content-language → [@language], dated
+    // std-ref → [@externalId] (tag keys with maxEmits caps — the NISO
+    // convention puts the document language first). std-meta has no id, so
+    // no anchor/customerId. Remaining leaves drop as recorded loss (R-4).
+    mappingKeys: { "xml-niso-iec": { "@el": "std-meta" } },
     tags: [
       {
         key: ConfigKey.group_bookCommon,
@@ -8518,12 +8713,14 @@ var BITS = {
       {
         key: ConfigKey.property_focusX,
         description: "The X coordinate for focusing the image in the browser",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_focusY,
         description: "The Y coordinate for focusing the image in the browser",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       }
     ]
   },
@@ -8554,6 +8751,15 @@ var BITS = {
     since: "1.3.0",
     baseBitType: BitType2._standard,
     description: "Chapter bit, used to define chapters in books or articles",
+    // PLAN-140 W3 (NISO import, tranche 1): recover a chapter from a NISO
+    // section or annex. STRUCTURAL key (no @children content slot): the
+    // element carries no body of its own — tag children (label/title) map
+    // via tag keys, every mapped descendant promotes to a following sibling
+    // bit, and the chapter level derives from nesting depth (catalog D1).
+    // The source id lands as [@customerId] (two-id model, D2).
+    mappingKeys: {
+      "xml-niso-iec": { "@el": "sec|app", "@attr": { id: "$customerId" }, "\u25BC": "$anchor" }
+    },
     tags: [
       {
         exportJsonKey: { anchor: "$" },
@@ -8565,7 +8771,10 @@ var BITS = {
         key: ConfigKey.tag_title,
         description: "The title of the chapter",
         jsonKey: "title|setMulti(level)",
-        exportJsonKey: { title: "$", level: "$level" }
+        exportJsonKey: { title: "$", level: "$level" },
+        // PLAN-140 W3 (NISO import): the section/annex title; the heading
+        // level rides the normalizer-derived nesting depth (plan Q2).
+        mappingKeys: { "xml-niso-iec": { "@el": "title", "@text": "$" } }
       },
       {
         key: ConfigKey.property_toc,
@@ -8771,11 +8980,28 @@ var BITS = {
     since: "1.3.0",
     baseBitType: BitType2._standard,
     description: "Code bit, used for code snippets in articles or documents",
+    // PLAN-141 F4 (NISO import): a <code> block is a CONTENT bit with a
+    // literal text body; @language recovers as [@computerLanguage] (absent
+    // attr → no tag). Anchor = the source id (D2 revised).
+    mappingKeys: {
+      "xml-niso-iec": {
+        "@el": "code",
+        "@attr": { id: "$customerId", language: "$computerLanguage" },
+        "\u25BC": "$anchor",
+        "@text": "$"
+      }
+    },
     tags: [
       {
         key: ConfigKey.property_computerLanguage,
         description: "The programming language of the code snippet",
-        format: TagFormat.plainText
+        format: TagFormat.plainText,
+        // PLAN-141 F4 (NISO import): the bit key's `language` sigil recovers
+        // a present attr; this `@absent` rule supplies the AUTHORED default
+        // when the source carries none (catalog code row — an untyped block
+        // is `[@computerLanguage:text]`). Fires only on foreign imports,
+        // never the carrier round-trip.
+        mappingKeys: { "xml-niso-iec": [{ "@absent": "text" }] }
       },
       {
         key: ConfigKey.property_codeLineNumbers,
@@ -8814,7 +9040,20 @@ var BITS = {
   [BitType2.smartStandardFormulaNormative]: {
     since: "3.11.0",
     baseBitType: BitType2.formula,
-    description: "Smart standard normative formula bit, used for mathematical formulas in smart standards that are normative"
+    description: "Smart standard normative formula bit, used for mathematical formulas in smart standards that are normative",
+    // PLAN-141 F4 (NISO import): a <disp-formula> is a CONTENT bit whose
+    // latex-format body carries the <mml:math> subtree VERBATIM (G1 — no
+    // MathML↔LaTeX transform; ids stripped); <label> → [%]; a contained
+    // <legend> PROMOTES as a sibling legend bit (cards cannot nest in a
+    // body). Anchor = the source id (D2 revised).
+    mappingKeys: {
+      "xml-niso-iec": {
+        "@el": "disp-formula",
+        "@attr": { id: "$customerId" },
+        "\u25BC": "$anchor",
+        "@children": "$"
+      }
+    }
   },
   [BitType2.smartStandardRemarkFormula]: {
     since: "3.11.0",
@@ -9341,7 +9580,8 @@ var BITS = {
       {
         key: ConfigKey.property_reasonableNumOfChars,
         description: "The reasonable number of characters for the essay",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_sampleSolution,
@@ -9774,7 +10014,14 @@ var BITS = {
   [BitType2.smartStandardList]: {
     since: "1.28.0",
     baseBitType: BitType2.standardList,
-    description: "Smart standard list bit, used to create smart standard lists in articles or books"
+    description: "Smart standard list bit, used to create smart standard lists in articles or books",
+    // PLAN-140 refs family (NISO import): a reference list is a STRUCTURAL
+    // bit (no @children — it takes a path ordinal anchor and its <ref>
+    // children promote to sibling list-item bits); its <title> rides [#]
+    // via the title tag key.
+    mappingKeys: {
+      "xml-niso-iec": { "@el": "ref-list", "@attr": { id: "$customerId" }, "\u25BC": "$anchor" }
+    }
   },
   [BitType2.smartStandardListCollapsible]: {
     since: "1.28.0",
@@ -9819,7 +10066,17 @@ var BITS = {
   [BitType2.smartStandardNoteNonNormative]: {
     since: "1.28.0",
     baseBitType: BitType2.standardNoteNonNormative,
-    description: "Smart standard non-normative note bit, used to provide non-normative notes in smart standards"
+    description: "Smart standard non-normative note bit, used to provide non-normative notes in smart standards",
+    // PLAN-140 W3 (NISO import, tranche 1). CONTENT key (@children): a
+    // note's inner paragraphs are note body, never separate bits.
+    mappingKeys: {
+      "xml-niso-iec": {
+        "@el": "non-normative-note",
+        "@attr": { id: "$customerId" },
+        "@children": "$",
+        "\u25BC": "$anchor"
+      }
+    }
   },
   [BitType2.smartStandardNoteNormativeCollapsible]: {
     since: "1.28.0",
@@ -9926,7 +10183,19 @@ var BITS = {
   [BitType2.smartStandardRemarkNonNormative]: {
     since: "1.28.0",
     baseBitType: BitType2.standardRemarkNonNormative,
-    description: "Smart standard non-normative remark bit, used to provide non-normative remarks in smart standards"
+    description: "Smart standard non-normative remark bit, used to provide non-normative remarks in smart standards",
+    // PLAN-140 Q4 rider: a warning/caution note routes to the remark bit —
+    // the same element as the note key, distinguished by the content-type
+    // attr literal (alias value: forward emits the first alternative,
+    // reverse accepts any). Most-specific-wins beats the plain note key.
+    mappingKeys: {
+      "xml-niso-iec": {
+        "@el": "non-normative-note",
+        "@attr": { "content-type": "warning|caution", id: "$customerId" },
+        "@children": "$",
+        "\u25BC": "$anchor"
+      }
+    }
   },
   [BitType2.smartStandardRemarkNormativeCollapsible]: {
     since: "1.28.0",
@@ -10382,7 +10651,8 @@ var BITS = {
       {
         key: ConfigKey.property_pageNo,
         description: "Page number for the block, used to indicate the page on which the block appears",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_x,
@@ -10399,17 +10669,20 @@ var BITS = {
       {
         key: ConfigKey.property_width,
         description: "Width of the block, used to define the size of the block on the page",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_height,
         description: "Height of the block, used to define the size of the block on the page",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_index,
         description: "Index of the block, used to order blocks within the extractor page",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_classification,
@@ -10719,7 +10992,20 @@ var BITS = {
   [BitType2.smartStandardLegendNormative]: {
     since: "3.12.0",
     baseBitType: BitType2.legend,
-    description: "Smart standard normative legend bit, used to provide normative smart standard legends in articles or books"
+    description: "Smart standard normative legend bit, used to provide normative smart standard legends in articles or books",
+    // PLAN-141 F2 (NISO import): a free-standing <legend> (a formula's) or
+    // bare <def-list> (a table footer's — no <legend> wrapper there) that is
+    // NOT the claimed card content of its enclosing bit is a legend bit:
+    // STRUCTURAL-shaped, its <title> and <def-item>s build the
+    // definition-list cards via the card set's authored keys. A <legend>
+    // inside a figure/table bit stays that bit's claimed card content and
+    // never reaches this key. Anchor = the source id (D2 revised).
+    mappingKeys: {
+      "xml-niso-iec": [
+        { "@el": "legend", "@attr": { id: "$customerId" }, "\u25BC": "$anchor" },
+        { "@el": "def-list", "@attr": { id: "$customerId" }, "\u25BC": "$anchor" }
+      ]
+    }
   },
   [BitType2.smartStandardRemarkLegend]: {
     since: "3.12.0",
@@ -10774,7 +11060,16 @@ var BITS = {
   [BitType2.smartStandardDefinitionListNormative]: {
     since: "5.24.0",
     baseBitType: BitType2.standardDefinitionListNormative,
-    description: "Smart standard normative definition list bit, used to create normative smart standard definition lists in articles or books"
+    description: "Smart standard normative definition list bit, used to create normative smart standard definition lists in articles or books",
+    // PLAN-141 F3 (NISO import): a terms-and-definitions clause. STRUCTURAL-
+    // shaped: <label> → [%], the tbx:termEntry/langSet subtree builds the
+    // definition-list card via the card set's authored keys (all tig terms
+    // stacked on the term side; definition/example/notes/source composed on
+    // the definition side with authored locale affixes), langSet @xml:lang →
+    // [@lang] (nested attr slot on the tag key). Anchor = the source id.
+    mappingKeys: {
+      "xml-niso-iec": { "@el": "term-sec", "@attr": { id: "$customerId" }, "\u25BC": "$anchor" }
+    }
   },
   [BitType2.smartStandardDefinitionListNonNormative]: {
     since: "5.24.0",
@@ -10843,12 +11138,14 @@ var BITS = {
       {
         key: ConfigKey.property_focusX,
         description: "X-coordinate for the focus point, used to define the focus area in the image",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_focusY,
         description: "Y-coordinate for the focus point, used to define the focus area in the image",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       }
     ]
   },
@@ -10955,7 +11252,15 @@ var BITS = {
   [BitType2.smartStandardImageFigureNormative]: {
     since: "1.28.0",
     baseBitType: BitType2.standardImageFigureNormative,
-    description: "Smart standard normative image figure bit, used to create smart standard normative image figures in articles or books"
+    description: "Smart standard normative image figure bit, used to create smart standard normative image figures in articles or books",
+    // PLAN-141 F1 (NISO import): a figure is STRUCTURAL-shaped (no
+    // @children — no body): <label> → [%], <caption>/<graphic> ride the
+    // [&image] resource chain, the <legend> def-list becomes the bit's
+    // definition-list cards, and an inner note PROMOTES as a sibling bit.
+    // Anchor = the source id (D2 revised).
+    mappingKeys: {
+      "xml-niso-iec": { "@el": "fig", "@attr": { id: "$customerId" }, "\u25BC": "$anchor" }
+    }
   },
   [BitType2.smartStandardImageFigureNonNormative]: {
     since: "1.28.0",
@@ -11683,7 +11988,19 @@ var BITS = {
   [BitType2.smartStandardListItem]: {
     since: "1.28.0",
     baseBitType: BitType2.standardListItem,
-    description: "Smart standard list item bit, used to create smart standard list items in articles or books"
+    description: "Smart standard list item bit, used to create smart standard list items in articles or books",
+    // PLAN-140 refs family (NISO import): one list-item bit per <ref> —
+    // CONTENT key (its citation subtree is the body), counter anchor scoped
+    // to the containing list, <label> → [%], nested <std-id> → [@externalId]
+    // (the externalId tag key's nested content slot).
+    mappingKeys: {
+      "xml-niso-iec": {
+        "@el": "ref",
+        "@attr": { id: "$customerId" },
+        "@children": "$",
+        "\u25BC": "$anchor"
+      }
+    }
   },
   [BitType2.smartStandardListItemCollapsible]: {
     since: "1.28.0",
@@ -12790,7 +13107,13 @@ var BITS = {
         // `<caption>` — placed inside the idiomatic `<table>` container as
         // its first child. Outside a table context it falls back to the
         // residual carrier.
-        htmlKey: { "@el": "caption", "@children": "$" }
+        htmlKey: { "@el": "caption", "@children": "$" },
+        // PLAN-141 F2 (NISO import): a table-wrap's <caption><title> — the
+        // nested content slot reads the title text (catalog D5: the caption
+        // is a TOP-LEVEL bit property on table bits).
+        mappingKeys: {
+          "xml-niso-iec": { "@el": "caption", "@children": { "@el": "title", "@text": "$" } }
+        }
       },
       {
         key: ConfigKey.property_tableFixedHeader,
@@ -12963,7 +13286,16 @@ var BITS = {
   [BitType2.smartStandardTableExtendedNormative]: {
     since: "1.28.0",
     baseBitType: BitType2.standardTableExtendedNormative,
-    description: "Smart standard normative extended table bit, used to create smart standard normative extended tables in articles or books"
+    description: "Smart standard normative extended table bit, used to create smart standard normative extended tables in articles or books",
+    // PLAN-141 F2 (NISO import): a table-wrap is STRUCTURAL-shaped (no
+    // @children — no body): <label> → [%], <caption><title> → the bit-level
+    // [@caption] (D5), the inner <table>/<table-wrap-foot> build the
+    // table-extended card grid via the card set's authored keys, and a
+    // footer <def-list> PROMOTES as a sibling legend bit. Anchor = the
+    // source id (D2 revised).
+    mappingKeys: {
+      "xml-niso-iec": { "@el": "table-wrap", "@attr": { id: "$customerId" }, "\u25BC": "$anchor" }
+    }
   },
   [BitType2.smartStandardTableExtendedNonNormative]: {
     since: "1.28.0",
@@ -13038,7 +13370,8 @@ var BITS = {
       {
         key: ConfigKey.property_maxDisplayLevel,
         description: "Maximum display level for the chapter in the table of contents",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       }
     ]
   },
@@ -13050,7 +13383,8 @@ var BITS = {
       {
         key: ConfigKey.property_maxTocChapterLevel,
         description: "Maximum chapter level for the inline table of contents",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       }
     ]
   },
@@ -13473,13 +13807,15 @@ var BITS = {
         key: ConfigKey.property_width,
         // Same as image
         description: "Width for the embedded content, used to define the width in pixels",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_height,
         // Same as image
         description: "Height for the embedded content, used to define the height in pixels",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       },
       {
         key: ConfigKey.property_vendorUrl,
@@ -13517,7 +13853,8 @@ var BITS = {
       {
         key: ConfigKey.property_jupyterExecutionCount,
         description: "Execution count for the Jupyter output, used to define the execution order",
-        format: TagFormat.number
+        format: TagFormat.number,
+        nullable: true
       }
     ],
     textFormatDefault: TextFormat2.plainText
@@ -14067,7 +14404,7 @@ var instance2 = new Config();
 // src/generated/package_info.ts
 var PACKAGE_INFO = {
   "name": "@gmb/bitmark-parser-generator",
-  "version": "5.35.0",
+  "version": "5.36.0",
   "author": "Get More Brain Ltd",
   "license": "ISC",
   "description": "A bitmark parser and generator using Peggy.js"
@@ -14596,6 +14933,8 @@ var NodeType = {
   definition: "definition",
   definitions: "definitions",
   definitionsValue: "definitionsValue",
+  displayName: "displayName",
+  displayNameValue: "displayNameValue",
   diffContext: "diffContext",
   diffContextValue: "diffContextValue",
   diffOp: "diffOp",
@@ -28518,6 +28857,12 @@ var Builder = class extends BaseBuilder {
         data.publisherName,
         options
       ),
+      displayName: this.toAstProperty(
+        bitType,
+        ConfigKey.property_displayName,
+        data.displayName,
+        options
+      ),
       theme: this.toAstProperty(bitType, ConfigKey.property_theme, data.theme, options),
       rtl: this.toAstProperty(bitType, ConfigKey.property_rtl, data.rtl, options),
       computerLanguage: this.toAstProperty(