@gmb/bitmark-parser-generator 5.35.0 → 5.37.0

package/dist/index.cjs

@@ -1416,6 +1416,7 @@ var propertyKeys = {
   property_dateEnd: "@dateEnd",
   property_decimalPlaces: "@decimalPlaces",
   property_deeplink: "@deeplink",
+  property_displayName: "@displayName",
   property_diffContext: "@diffContext",
   property_diffOp: "@diffOp",
   property_diffRef: "@diffRef",
@@ -1628,6 +1629,8 @@ var propertyKeys = {
   property_trim: "@trim",
   property_unit: "@unit",
   property_unitAbbr: "@unitAbbr",
+  property_unitAbbrPlural: "@unitAbbrPlural",
+  property_unitPlural: "@unitPlural",
   property_vendorDashboardId: "@vendorDashboardId",
   property_vendorSurveyId: "@vendorSurveyId",
   property_vendorUrl: "@vendorUrl",
@@ -2565,9 +2568,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",
@@ -2583,7 +2607,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,
@@ -2609,6 +2634,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",
@@ -3999,6 +4042,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
@@ -4010,12 +4058,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`
@@ -4032,6 +4089,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",
@@ -4049,7 +4108,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,
@@ -4068,6 +4131,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
               },
@@ -4078,6 +4144,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
               },
@@ -4099,6 +4168,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
               }
@@ -4368,12 +4444,22 @@ var CARDSETS = {
               },
               {
                 key: ConfigKey.property_unit,
-                description: "Unit of measurement for the ingredient.",
+                description: "Unit of measurement for the ingredient (singular).",
+                format: TagFormat.plainText
+              },
+              {
+                key: ConfigKey.property_unitPlural,
+                description: "Unit of measurement for the ingredient (plural).",
                 format: TagFormat.plainText
               },
               {
                 key: ConfigKey.property_unitAbbr,
-                description: "Abbreviation for the unit of measurement.",
+                description: "Abbreviation for the unit of measurement (singular).",
+                format: TagFormat.plainText
+              },
+              {
+                key: ConfigKey.property_unitAbbrPlural,
+                description: "Abbreviation for the unit of measurement (plural).",
                 format: TagFormat.plainText
               },
               {
@@ -4472,7 +4558,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,
@@ -4534,6 +4635,11 @@ var GROUPS = {
         description: "Translation source reference",
         format: TagFormat.plainText
       },
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible",
+        format: TagFormat.boolean
+      },
       {
         key: ConfigKey.property_spansPageBreak,
         description: "If true, the bit spans a page break",
@@ -4613,7 +4719,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,
@@ -4624,7 +4731,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,
@@ -4823,6 +4941,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: [
           {
@@ -5785,7 +5906,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,
@@ -5861,7 +5995,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,
@@ -6174,17 +6319,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,
@@ -6291,7 +6439,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,
@@ -6565,6 +6719,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: [
           {
@@ -7439,6 +7597,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"
       }
@@ -7480,22 +7640,84 @@ var BITS = {
   [BitType.smartStandardArticleNormative]: {
     since: "1.28.0",
     baseBitType: BitType.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"
+        }
+      ]
+    }
   },
   [BitType.smartStandardArticleNonNormative]: {
     since: "1.28.0",
     baseBitType: BitType.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": "$"
+        }
+      ]
+    }
   },
   [BitType.smartStandardArticleNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardArticleNormative,
-    description: "Smart standard normative article bit that is collapsible"
+    description: "Smart standard normative article bit that is collapsible",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardArticleNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardArticleNonNormative,
-    description: "Smart standard non-normative article bit that is collapsible"
+    description: "Smart standard non-normative article bit that is collapsible",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.statement]: {
     since: "1.3.0",
@@ -8116,7 +8338,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: TextFormat.plainText
@@ -8246,6 +8469,13 @@ var BITS = {
     since: "1.3.0",
     baseBitType: BitType._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,
@@ -8532,12 +8762,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
       }
     ]
   },
@@ -8568,6 +8800,15 @@ var BITS = {
     since: "1.3.0",
     baseBitType: BitType._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: "$" },
@@ -8579,7 +8820,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,
@@ -8592,12 +8836,6 @@ var BITS = {
         description: "The progress of the chapter, used for tracking reading progress",
         format: TagFormat.boolean,
         defaultValue: "true"
-      },
-      {
-        key: ConfigKey.property_isCollapsible,
-        description: "If true, the chapter is collapsible",
-        format: TagFormat.boolean,
-        defaultValue: "false"
       }
     ]
   },
@@ -8785,11 +9023,28 @@ var BITS = {
     since: "1.3.0",
     baseBitType: BitType._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,
@@ -8828,7 +9083,20 @@ var BITS = {
   [BitType.smartStandardFormulaNormative]: {
     since: "3.11.0",
     baseBitType: BitType.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": "$"
+      }
+    }
   },
   [BitType.smartStandardRemarkFormula]: {
     since: "3.11.0",
@@ -9174,12 +9442,22 @@ var BITS = {
         chain: [
           {
             key: ConfigKey.property_unit,
-            description: "The unit of measurement for the ingredients",
+            description: "The unit of measurement for the ingredients (singular)",
+            format: TagFormat.plainText
+          },
+          {
+            key: ConfigKey.property_unitPlural,
+            description: "The unit of measurement for the ingredients (plural)",
             format: TagFormat.plainText
           },
           {
             key: ConfigKey.property_unitAbbr,
-            description: "The abbreviation for the unit of measurement",
+            description: "The abbreviation for the unit of measurement (singular)",
+            format: TagFormat.plainText
+          },
+          {
+            key: ConfigKey.property_unitAbbrPlural,
+            description: "The abbreviation for the unit of measurement (plural)",
             format: TagFormat.plainText
           },
           {
@@ -9355,7 +9633,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,
@@ -9457,13 +9736,31 @@ var BITS = {
   },
   [BitType.smartStandardExampleNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardExampleNormative,
-    description: "Smart standard normative example collapsible bit, used to provide normative examples in smart standards that can be collapsed"
+    description: "Smart standard normative example collapsible bit, used to provide normative examples in smart standards that can be collapsed",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardExampleNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardExampleNonNormative,
-    description: "Smart standard non-normative example collapsible bit, used to provide non-normative examples in smart standards that can be collapsed"
+    description: "Smart standard non-normative example collapsible bit, used to provide non-normative examples in smart standards that can be collapsed",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.authorContentBitGenerator]: {
     since: "4.2.0",
@@ -9788,12 +10085,28 @@ var BITS = {
   [BitType.smartStandardList]: {
     since: "1.28.0",
     baseBitType: BitType.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" }
+    }
   },
   [BitType.smartStandardListCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardList,
-    description: "Smart standard list collapsible bit, used to create collapsible smart standard lists in articles or books"
+    description: "Smart standard list collapsible bit, used to create collapsible smart standard lists in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.message]: {
     since: "1.3.0",
@@ -9833,17 +10146,45 @@ var BITS = {
   [BitType.smartStandardNoteNonNormative]: {
     since: "1.28.0",
     baseBitType: BitType.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"
+      }
+    }
   },
   [BitType.smartStandardNoteNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardNoteNormative,
-    description: "Smart standard normative note collapsible bit, used to provide normative notes in smart standards that can be collapsed"
+    description: "Smart standard normative note collapsible bit, used to provide normative notes in smart standards that can be collapsed",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardNoteNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardNoteNonNormative,
-    description: "Smart standard non-normative note collapsible bit, used to provide non-normative notes in smart standards that can be collapsed"
+    description: "Smart standard non-normative note collapsible bit, used to provide non-normative notes in smart standards that can be collapsed",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.noteAi]: {
     since: "1.3.0",
@@ -9940,17 +10281,47 @@ var BITS = {
   [BitType.smartStandardRemarkNonNormative]: {
     since: "1.28.0",
     baseBitType: BitType.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"
+      }
+    }
   },
   [BitType.smartStandardRemarkNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkNormative,
-    description: "Smart standard normative remark collapsible bit, used to provide normative remarks in smart standards that can be collapsed"
+    description: "Smart standard normative remark collapsible bit, used to provide normative remarks in smart standards that can be collapsed",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkNonNormative,
-    description: "Smart standard non-normative remark collapsible bit, used to provide non-normative remarks in smart standards that can be collapsed"
+    description: "Smart standard non-normative remark collapsible bit, used to provide non-normative remarks in smart standards that can be collapsed",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.selfAssessment]: {
     since: "1.3.0",
@@ -10021,53 +10392,143 @@ var BITS = {
   },
   [BitType.collapsible]: {
     since: "1.21.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.article,
-    description: "Collapsible bit, used to create collapsible sections in articles or books"
+    description: "Collapsible bit, used to create collapsible sections in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.sideNoteCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Side note collapsible bit, used to create collapsible side notes in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.sideNote,
+    description: "Side note collapsible bit, used to create collapsible side notes in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.infoCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Info collapsible bit, used to create collapsible informational sections in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.info,
+    description: "Info collapsible bit, used to create collapsible informational sections in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.remarkCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Remark collapsible bit, used to create collapsible remarks in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.remark,
+    description: "Remark collapsible bit, used to create collapsible remarks in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.warningCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Warning collapsible bit, used to create collapsible warnings in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.warning,
+    description: "Warning collapsible bit, used to create collapsible warnings in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.dangerCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Danger collapsible bit, used to create collapsible danger sections in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.danger,
+    description: "Danger collapsible bit, used to create collapsible danger sections in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.noteCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Note collapsible bit, used to create collapsible notes in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.note,
+    description: "Note collapsible bit, used to create collapsible notes in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.exampleCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Example collapsible bit, used to create collapsible examples in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.example,
+    description: "Example collapsible bit, used to create collapsible examples in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.hintCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Hint collapsible bit, used to create collapsible hints in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.hint,
+    description: "Hint collapsible bit, used to create collapsible hints in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.bugCollapsible]: {
     since: "1.21.0",
-    baseBitType: BitType.article,
-    description: "Bug collapsible bit, used to create collapsible bug reports in articles or books"
+    deprecated: "5.37.0",
+    baseBitType: BitType.bug,
+    description: "Bug collapsible bit, used to create collapsible bug reports in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.platformPath]: {
     since: "3.14.1",
@@ -10289,8 +10750,17 @@ var BITS = {
   },
   [BitType.extractorPageCollapsible]: {
     since: "1.30.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.extractorPage,
-    description: "Collapsible extractor page bit, used to extract pages from images with collapsible functionality"
+    description: "Collapsible extractor page bit, used to extract pages from images with collapsible functionality",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.extractorPageWithBlocks]: {
     since: "1.5.21",
@@ -10299,8 +10769,17 @@ var BITS = {
   },
   [BitType.extractorPageWithBlocksCollapsible]: {
     since: "1.30.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.extractorPageWithBlocks,
-    description: "Collapsible extractor page with blocks bit, used to extract pages with blocks from images with collapsible functionality"
+    description: "Collapsible extractor page with blocks bit, used to extract pages with blocks from images with collapsible functionality",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.extractorConfiguration]: {
     since: "1.7.1",
@@ -10340,8 +10819,17 @@ var BITS = {
   },
   [BitType.extractorImageCollapsible]: {
     since: "4.3.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.extractorImage,
-    description: "Collapsible extractor images bit, used for  images extracted from PDFs"
+    description: "Collapsible extractor images bit, used for  images extracted from PDFs",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.extractorBlueprint]: {
     since: "5.12.0",
@@ -10396,7 +10884,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,
@@ -10413,17 +10902,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,
@@ -10474,8 +10966,17 @@ var BITS = {
   },
   [BitType.extractorPageNumberCollapsible]: {
     since: "1.30.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.extractorPageNumber,
-    description: "Collapsible extractor page number bit, used to define page numbers in extractor pages with collapsible functionality"
+    description: "Collapsible extractor page number bit, used to define page numbers in extractor pages with collapsible functionality",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.extractorPageHeader]: {
     since: "1.5.21",
@@ -10484,8 +10985,17 @@ var BITS = {
   },
   [BitType.extractorPageHeaderCollapsible]: {
     since: "1.30.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.extractorPageHeader,
-    description: "Collapsible extractor page header bit, used to define headers in extractor pages with collapsible functionality"
+    description: "Collapsible extractor page header bit, used to define headers in extractor pages with collapsible functionality",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.extractorPageFooter]: {
     since: "1.5.21",
@@ -10494,8 +11004,17 @@ var BITS = {
   },
   [BitType.extractorPageFooterCollapsible]: {
     since: "1.30.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.extractorPageFooter,
-    description: "Collapsible extractor page footer bit, used to define footers in extractor pages with collapsible functionality"
+    description: "Collapsible extractor page footer bit, used to define footers in extractor pages with collapsible functionality",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.pageOpenBook]: {
     since: "1.5.10",
@@ -10733,7 +11252,20 @@ var BITS = {
   [BitType.smartStandardLegendNormative]: {
     since: "3.12.0",
     baseBitType: BitType.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" }
+      ]
+    }
   },
   [BitType.smartStandardRemarkLegend]: {
     since: "3.12.0",
@@ -10772,8 +11304,17 @@ var BITS = {
   },
   [BitType.definitionListCollapsible]: {
     since: "5.25.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.definitionList,
-    description: "Collapsible definition list bit, used to create collapsible lists of definitions in articles or books"
+    description: "Collapsible definition list bit, used to create collapsible lists of definitions in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.standardDefinitionListNormative]: {
     since: "5.24.0",
@@ -10788,7 +11329,16 @@ var BITS = {
   [BitType.smartStandardDefinitionListNormative]: {
     since: "5.24.0",
     baseBitType: BitType.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" }
+    }
   },
   [BitType.smartStandardDefinitionListNonNormative]: {
     since: "5.24.0",
@@ -10857,12 +11407,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
       }
     ]
   },
@@ -10969,7 +11521,15 @@ var BITS = {
   [BitType.smartStandardImageFigureNormative]: {
     since: "1.28.0",
     baseBitType: BitType.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" }
+    }
   },
   [BitType.smartStandardImageFigureNonNormative]: {
     since: "1.28.0",
@@ -10978,13 +11538,31 @@ var BITS = {
   },
   [BitType.smartStandardImageFigureNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardImageFigureNormative,
-    description: "Collapsible smart standard normative image figure bit, used to create collapsible smart standard normative image figures in articles or books"
+    description: "Collapsible smart standard normative image figure bit, used to create collapsible smart standard normative image figures in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardImageFigureNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardImageFigureNonNormative,
-    description: "Collapsible smart standard non-normative image figure bit, used to create collapsible smart standard non-normative image figures in articles or books"
+    description: "Collapsible smart standard non-normative image figure bit, used to create collapsible smart standard non-normative image figures in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.imageLandscape]: {
     since: "1.3.0",
@@ -11196,43 +11774,115 @@ var BITS = {
   },
   [BitType.smartStandardTableImageNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardTableImageNormative,
-    description: "Collapsible smart standard normative table image bit, used to create collapsible smart standard normative images in tables in articles or books"
+    description: "Collapsible smart standard normative table image bit, used to create collapsible smart standard normative images in tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardTableImageNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardTableImageNonNormative,
-    description: "Collapsible smart standard non-normative table image bit, used to create collapsible smart standard non-normative images in tables in articles or books"
+    description: "Collapsible smart standard non-normative table image bit, used to create collapsible smart standard non-normative images in tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkTableImageNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkTableImageNormative,
-    description: "Collapsible smart standard normative remark table image bit, used to create collapsible smart standard normative remark images in tables in articles or books"
+    description: "Collapsible smart standard normative remark table image bit, used to create collapsible smart standard normative remark images in tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkTableImageNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkTableImageNonNormative,
-    description: "Collapsible smart standard non-normative remark table image bit, used to create collapsible smart standard non-normative remark images in tables in articles or books"
+    description: "Collapsible smart standard non-normative remark table image bit, used to create collapsible smart standard non-normative remark images in tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardTableExtendedImageNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardTableExtendedImageNormative,
-    description: "Collapsible smart standard normative extended table image bit, used to create collapsible smart standard normative extended images in tables in articles or books"
+    description: "Collapsible smart standard normative extended table image bit, used to create collapsible smart standard normative extended images in tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardTableExtendedImageNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardTableExtendedImageNonNormative,
-    description: "Collapsible smart standard non-normative extended table image bit, used to create collapsible smart standard non-normative extended images in tables in articles or books"
+    description: "Collapsible smart standard non-normative extended table image bit, used to create collapsible smart standard non-normative extended images in tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkTableExtendedImageNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkTableExtendedImageNormative,
-    description: "Collapsible smart standard normative remark extended table image bit, used to create collapsible smart standard normative remark extended images in tables in articles or books"
+    description: "Collapsible smart standard normative remark extended table image bit, used to create collapsible smart standard normative remark extended images in tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkTableExtendedImageNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkTableExtendedImageNonNormative,
-    description: "Collapsible smart standard non-normative remark extended table image bit, used to create collapsible smart standard non-normative remark extended images in tables in articles or books"
+    description: "Collapsible smart standard non-normative remark extended table image bit, used to create collapsible smart standard non-normative remark extended images in tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.imageLink]: {
     since: "1.3.0",
@@ -11697,12 +12347,33 @@ var BITS = {
   [BitType.smartStandardListItem]: {
     since: "1.28.0",
     baseBitType: BitType.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"
+      }
+    }
   },
   [BitType.smartStandardListItemCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardListItem,
-    description: "Collapsible smart standard list item bit, used to create collapsible smart standard list items in articles or books"
+    description: "Collapsible smart standard list item bit, used to create collapsible smart standard list items in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.mark]: {
     since: "1.3.0",
@@ -12035,8 +12706,17 @@ var BITS = {
   },
   [BitType.pageCollapsible]: {
     since: "1.30.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.page,
-    description: "Collapsible page bit, used to create collapsible sections in pages"
+    description: "Collapsible page bit, used to create collapsible sections in pages",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.pageCoverImage]: {
     since: "1.22.0",
@@ -12804,7 +13484,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,
@@ -12977,7 +13663,16 @@ var BITS = {
   [BitType.smartStandardTableExtendedNormative]: {
     since: "1.28.0",
     baseBitType: BitType.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" }
+    }
   },
   [BitType.smartStandardTableExtendedNonNormative]: {
     since: "1.28.0",
@@ -12996,43 +13691,115 @@ var BITS = {
   },
   [BitType.smartStandardTableNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardTableNormative,
-    description: "Collapsible smart standard normative table bit, used to create collapsible smart standard normative tables in articles or books"
+    description: "Collapsible smart standard normative table bit, used to create collapsible smart standard normative tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardTableNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardTableNonNormative,
-    description: "Collapsible smart standard non-normative table bit, used to create collapsible smart standard non-normative tables in articles or books"
+    description: "Collapsible smart standard non-normative table bit, used to create collapsible smart standard non-normative tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkTableNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkTableNormative,
-    description: "Collapsible smart standard normative remark table bit, used to create collapsible smart standard normative remark tables in articles or books"
+    description: "Collapsible smart standard normative remark table bit, used to create collapsible smart standard normative remark tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkTableNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkTableNonNormative,
-    description: "Collapsible smart standard non-normative remark table bit, used to create collapsible smart standard non-normative remark tables in articles or books"
+    description: "Collapsible smart standard non-normative remark table bit, used to create collapsible smart standard non-normative remark tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardTableExtendedNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardTableExtendedNormative,
-    description: "Collapsible smart standard normative extended table bit, used to create collapsible smart standard normative extended tables in articles or books"
+    description: "Collapsible smart standard normative extended table bit, used to create collapsible smart standard normative extended tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardTableExtendedNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardTableExtendedNonNormative,
-    description: "Collapsible smart standard non-normative extended table bit, used to create collapsible smart standard non-normative extended tables in articles or books"
+    description: "Collapsible smart standard non-normative extended table bit, used to create collapsible smart standard non-normative extended tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkTableExtendedNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkTableExtendedNormative,
-    description: "Collapsible smart standard normative remark extended table bit, used to create collapsible smart standard normative remark extended tables in articles or books"
+    description: "Collapsible smart standard normative remark extended table bit, used to create collapsible smart standard normative remark extended tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.smartStandardRemarkTableExtendedNonNormativeCollapsible]: {
     since: "1.28.0",
+    deprecated: "5.37.0",
     baseBitType: BitType.smartStandardRemarkTableExtendedNonNormative,
-    description: "Collapsible smart standard non-normative remark extended table bit, used to create collapsible smart standard non-normative remark extended tables in articles or books"
+    description: "Collapsible smart standard non-normative remark extended table bit, used to create collapsible smart standard non-normative remark extended tables in articles or books",
+    tags: [
+      {
+        key: ConfigKey.property_isCollapsible,
+        description: "If true, the bit is collapsible (defaults true for this deprecated bit type)",
+        format: TagFormat.boolean,
+        defaultValue: "true"
+      }
+    ]
   },
   [BitType.parameters]: {
     since: "1.18.0",
@@ -13052,7 +13819,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
       }
     ]
   },
@@ -13064,7 +13832,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
       }
     ]
   },
@@ -13487,13 +14256,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,
@@ -13531,7 +14302,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: TextFormat.plainText
@@ -13739,11 +14511,13 @@ var BITS = {
 };
 
 // src/config/Config.ts
+var COLLAPSIBLE_BIT_TYPE_SUFFIX = "-collapsible";
 var Config = class {
   constructor() {
     __publicField(this, "bitLevelMin", 1);
     __publicField(this, "bitLevelMax", 7);
     __publicField(this, "bitCache", /* @__PURE__ */ new Map());
+    __publicField(this, "migratedBitCache", /* @__PURE__ */ new Map());
     __publicField(this, "allResourcesCache");
     __publicField(this, "comboResourcesCache", /* @__PURE__ */ new Map());
   }
@@ -13759,6 +14533,29 @@ var Config = class {
     if (bitType?.startsWith("|")) bitType = bitType.substring(1);
     return (0, import_superenum16.Enum)(BitType).fromValue(bitType) ?? BitType._error;
   }
+  /**
+   * PLAN-017: Return the migration target for a deprecated `*-collapsible` bit type.
+   *
+   * Every `*-collapsible` bit type declares its non-collapsible cousin as its `baseBitType`, so the
+   * target is read from the config rather than a hand-maintained table — a new `*-collapsible` bit
+   * type is covered automatically.
+   *
+   * `BitType.collapsible` is the one exclusion: it has no non-collapsible cousin (its `baseBitType`
+   * is `article`, which is not a migration target).
+   *
+   * @param bitType the bit type
+   * @returns the bit type to migrate to, or undefined if the bit type does not migrate
+   */
+  getMigratedBitType(bitType) {
+    const cached = this.migratedBitCache.get(bitType);
+    if (cached !== void 0 || this.migratedBitCache.has(bitType)) return cached;
+    let target;
+    if (bitType !== BitType.collapsible && bitType.endsWith(COLLAPSIBLE_BIT_TYPE_SUFFIX)) {
+      target = BITS[bitType]?.baseBitType;
+    }
+    this.migratedBitCache.set(bitType, target);
+    return target;
+  }
   /**
    * Check if a bit type is and instance of the given root bit type.
    *
@@ -14081,7 +14878,7 @@ var instance2 = new Config();
 // src/generated/package_info.ts
 var PACKAGE_INFO = {
   "name": "@gmb/bitmark-parser-generator",
-  "version": "5.35.0",
+  "version": "5.37.0",
   "author": "Get More Brain Ltd",
   "license": "ISC",
   "description": "A bitmark parser and generator using Peggy.js"
@@ -14610,6 +15407,8 @@ var NodeType = {
   definition: "definition",
   definitions: "definitions",
   definitionsValue: "definitionsValue",
+  displayName: "displayName",
+  displayNameValue: "displayNameValue",
   diffContext: "diffContext",
   diffContextValue: "diffContextValue",
   diffOp: "diffOp",
@@ -15138,6 +15937,8 @@ var NodeType = {
   type: "type",
   unit: "unit",
   unitAbbr: "unitAbbr",
+  unitAbbrPlural: "unitAbbrPlural",
+  unitPlural: "unitPlural",
   url: "url",
   validationDate: "validationDate",
   validationDateValue: "validationDateValue",
@@ -28313,8 +29114,14 @@ var Builder = class extends BaseBuilder {
    */
   buildBit(data, options) {
     data = structuredClone(data);
+    const migratedBitType = instance2.getMigratedBitType(data.bitType);
+    if (migratedBitType) {
+      data.bitType = migratedBitType;
+      data.isCollapsible = data.isCollapsible ?? true;
+    }
     const bitType = data.bitType;
     const bitConfig = instance2.getBitConfig(bitType);
+    const isCollapsibleDefaultsTrue = bitConfig.tags[ConfigKey.property_isCollapsible]?.defaultValue === "true";
     const deprecatedTextFormat = (0, import_superenum30.Enum)(DeprecatedTextFormat).fromValue(data.textFormat);
     let textFormat = (0, import_superenum30.Enum)(TextFormat).fromValue(data.textFormat) ?? bitConfig.textFormatDefault;
     if (deprecatedTextFormat === DeprecatedTextFormat.bitmarkMinusMinus) {
@@ -28532,6 +29339,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(
@@ -29441,7 +30254,7 @@ var Builder = class extends BaseBuilder {
       isCollapsible: this.toAstProperty(
         bitType,
         ConfigKey.property_isCollapsible,
-        data.isCollapsible,
+        data.isCollapsible ?? (isCollapsibleDefaultsTrue ? true : void 0),
         options
       ),
       anchor: data.anchor,
@@ -30210,7 +31023,9 @@ var Builder = class extends BaseBuilder {
       ingredient: this.handleJsonText(context, TextLocation.tag, data.ingredient),
       quantity: data.quantity ?? 0,
       unit: data.unit ?? "",
+      unitPlural: data.unitPlural ?? "",
       unitAbbr: data.unitAbbr ?? "",
+      unitAbbrPlural: data.unitAbbrPlural ?? "",
       decimalPlaces: data.decimalPlaces ?? 1,
       disableCalculation: data.disableCalculation ?? false,
       item: this.handleJsonText(context, TextLocation.tag, data.item),
@@ -30807,11 +31622,22 @@ var Builder = class extends BaseBuilder {
    */
   buildServings(_context, data) {
     if (!data) return void 0;
-    const { servings, unit, unitAbbr, decimalPlaces, disableCalculation, hint } = data;
+    const {
+      servings,
+      unit,
+      unitPlural,
+      unitAbbr,
+      unitAbbrPlural,
+      decimalPlaces,
+      disableCalculation,
+      hint
+    } = data;
     const node = {
       servings: servings ?? 0,
       unit: unit ?? "",
+      unitPlural: unitPlural ?? "",
       unitAbbr: unitAbbr ?? "",
+      unitAbbrPlural: unitAbbrPlural ?? "",
       decimalPlaces: decimalPlaces ?? 1,
       disableCalculation: disableCalculation ?? false,
       hint: hint ?? ""
@@ -31748,7 +32574,16 @@ var BitmarkGenerator = class extends AstWalkerGenerator {
     const nodeValue = node.value;
     const parent = this.getParentNode(route);
     if (parent?.key !== NodeType.bitsValue) return true;
-    const { servings, unit, unitAbbr, decimalPlaces, disableCalculation, hint } = nodeValue;
+    const {
+      servings,
+      unit,
+      unitPlural,
+      unitAbbr,
+      unitAbbrPlural,
+      decimalPlaces,
+      disableCalculation,
+      hint
+    } = nodeValue;
     this.writeProperty("servings", servings, route, {
       format: TagFormat.plainText
     });
@@ -31758,12 +32593,24 @@ var BitmarkGenerator = class extends AstWalkerGenerator {
         forceChain: true
       });
     }
+    if (unitPlural != null) {
+      this.writeProperty("unitPlural", unitPlural, route, {
+        format: TagFormat.plainText,
+        forceChain: true
+      });
+    }
     if (unitAbbr != null) {
       this.writeProperty("unitAbbr", unitAbbr, route, {
         format: TagFormat.plainText,
         forceChain: true
       });
     }
+    if (unitAbbrPlural != null) {
+      this.writeProperty("unitAbbrPlural", unitAbbrPlural, route, {
+        format: TagFormat.plainText,
+        forceChain: true
+      });
+    }
     if (decimalPlaces != null) {
       this.writeProperty("decimalPlaces", decimalPlaces, route, {
         format: TagFormat.plainText,
@@ -32610,10 +33457,18 @@ var BitmarkGenerator = class extends AstWalkerGenerator {
         this.writeProperty("unit", ingredient.unit, route, {
           format: TagFormat.plainText
         });
+      if (ingredient.unitPlural != null)
+        this.writeProperty("unitPlural", ingredient.unitPlural, route, {
+          format: TagFormat.plainText
+        });
       if (ingredient.unitAbbr != null)
         this.writeProperty("unitAbbr", ingredient.unitAbbr, route, {
           format: TagFormat.plainText
         });
+      if (ingredient.unitAbbrPlural != null)
+        this.writeProperty("unitAbbrPlural", ingredient.unitAbbrPlural, route, {
+          format: TagFormat.plainText
+        });
       if (ingredient.decimalPlaces != null)
         this.writeProperty("decimalPlaces", ingredient.decimalPlaces, route, {
           format: TagFormat.plainText
@@ -34392,6 +35247,25 @@ var JsonGenerator = class extends AstWalkerGenerator {
     }
     return false;
   }
+  // bitmarkAst -> bits -> bitsValue -> isCollapsible
+  /**
+   * PLAN-016: `isCollapsible` is emitted only when true. `false` is the implied
+   * default for every bit, so it is never written to the JSON — an absent key
+   * means the bit's configured default (`true` for the deprecated
+   * `*-collapsible` bit types, `false` everywhere else).
+   *
+   * Defining these handlers suppresses the generic property handlers that
+   * `generatePropertyHandlers()` would otherwise install for this tag.
+   */
+  leaf_isCollapsible(node, route) {
+    const parent = this.getParentNode(route);
+    if (parent?.key !== NodeType.bitsValue) return false;
+    if (node.value === true) this.bitJson.isCollapsible = true;
+    return false;
+  }
+  enter_isCollapsible(node, route) {
+    return this.leaf_isCollapsible(node, route);
+  }
   // bitmarkAst -> bits -> bitsValue -> markConfig
   enter_markConfig(_node, _route) {
     return true;
@@ -35265,7 +36139,6 @@ var JsonGenerator = class extends AstWalkerGenerator {
       if (instance2.isOfBitType(bitType, BitType.chapter)) {
         if (bitJson.toc == null) bitJson.toc = true;
         if (bitJson.progress == null) bitJson.progress = true;
-        if (bitJson.isCollapsible == null) bitJson.isCollapsible = false;
         if (bitJson.level == null) bitJson.level = 1;
         if (bitJson.body == null) bitJson.body = this.bodyDefault;
       }
@@ -38244,7 +39117,9 @@ function parseIngredients(_context, _bitType, cardSet) {
           title: titleArray,
           __instructionString,
           unit,
+          unitPlural,
           unitAbbr,
+          unitAbbrPlural,
           decimalPlaces,
           disableCalculation,
           cardBodyStr,
@@ -38274,7 +39149,9 @@ function parseIngredients(_context, _bitType, cardSet) {
           ingredient: cardBodyStr,
           quantity,
           unit: unit ?? instance3.EMPTY_STRING,
+          unitPlural,
           unitAbbr: unitAbbr ?? instance3.EMPTY_STRING,
+          unitAbbrPlural,
           decimalPlaces: decimalPlaces ?? 1,
           disableCalculation,
           ...tags2
@@ -38945,12 +39822,22 @@ function servingsChainContentProcessor(context, _contentDepth, tagsConfig, conte
   if (context.DEBUG_CHAIN_CONTENT) context.debugPrint("servings content", content);
   const tags2 = context.bitContentProcessor(ContentDepth.Chain, tagsConfig, content.chain);
   if (context.DEBUG_CHAIN_TAGS) context.debugPrint("servings TAGS", tags2);
-  const { unit, unitAbbr, decimalPlaces, disableCalculation, __hintString } = tags2;
+  const {
+    unit,
+    unitPlural,
+    unitAbbr,
+    unitAbbrPlural,
+    decimalPlaces,
+    disableCalculation,
+    __hintString
+  } = tags2;
   const servings = instance6.asNumber(content.value) ?? 1;
   const node = {
     servings,
     unit,
+    unitPlural,
     unitAbbr,
+    unitAbbrPlural,
     decimalPlaces: decimalPlaces ?? 1,
     disableCalculation,
     hint: __hintString
@@ -44694,7 +45581,7 @@ var ConfigBuilder = class {
     }
     const outputFolder = opts.outputDir ?? "assets/config";
     const outputFolderBits = import_node_path3.default.join(outputFolder, "bits");
-    const outputFolderGroups = import_node_path3.default.join(outputFolder, "partials");
+    const outputFolderGroups = import_node_path3.default.join(outputFolder, "groups");
     const outputFolderCards = import_node_path3.default.join(outputFolder, "cards");
     import_fs_extra3.default.ensureDirSync(outputFolderBits);
     import_fs_extra3.default.ensureDirSync(outputFolderGroups);
@@ -44729,6 +45616,15 @@ var ConfigBuilder = class {
       }
       return [{ key: groupKey }];
     };
+    const mappingKeysField = (base, json, html) => {
+      const record = {};
+      for (const [id, value] of Object.entries(base ?? {})) {
+        if (value != null) record[id] = value;
+      }
+      if (json.present && json.value != null) record.json = json.value;
+      if (html.present && html.value != null) record.html = html.value;
+      return Object.keys(record).length > 0 ? { mappingKeys: record } : {};
+    };
     const bareKeyForProperty = (key) => {
       if (key.startsWith("@") || key.startsWith("&")) return key.substring(1);
       return void 0;
@@ -44749,22 +45645,20 @@ var ConfigBuilder = class {
         if (tag.format === TagFormat.plainText) {
           format = "string";
         } else if (tag.format === TagFormat.boolean) {
-          format = "bool";
-        } else if (tag.format === TagFormat.bitmarkText) {
-          format = "bitmark";
+          format = "boolean";
         } else if (tag.format === TagFormat.number) {
           format = "number";
         } else {
-          format = "bitmark--";
+          format = "bitmark+";
         }
       } else if (tagType === BitTagConfigKeyType.property) {
         tagName = tag.key;
         if (tag.format === TagFormat.plainText) {
           format = "string";
         } else if (tag.format === TagFormat.boolean) {
-          format = "bool";
+          format = "boolean";
         } else if (tag.format === TagFormat.bitmarkText) {
-          format = "bitmark";
+          format = "bitmark+";
         } else if (tag.format === TagFormat.number) {
           format = "number";
         } else if (tag.format === TagFormat.coordinates) {
@@ -44796,8 +45690,11 @@ var ConfigBuilder = class {
           tags2.push({
             type: "group",
             key: ref.key,
-            ...hasExportChosen ? { jsonKey: exportJsonKeyChosen } : {},
-            ...hasHtmlChosen ? { htmlKey: htmlKeyChosen } : {},
+            ...mappingKeysField(
+              { ...ref.extraKeys ?? {}, ...tag.mappingKeys ?? {} },
+              { value: exportJsonKeyChosen, present: hasExportChosen },
+              { value: htmlKeyChosen, present: hasHtmlChosen }
+            ),
             ...min != null ? { min } : {},
             ...max != null ? { max } : {},
             ...description ? { description } : {}
@@ -44814,53 +45711,48 @@ var ConfigBuilder = class {
         chain = chainTags;
       }
       const hasExport = Object.prototype.hasOwnProperty.call(tag, "exportJsonKey");
-      let exportJsonKeyField;
-      if (hasExport) {
-        exportJsonKeyField = { jsonKey: tag.exportJsonKey };
-      } else if (legacyIsTrivialDefault(tag)) {
-        exportJsonKeyField = {};
-      } else {
+      if (!hasExport && !legacyIsTrivialDefault(tag)) {
         const headingPath = [...pathStack, `tags.${tag.key}`].join(" / ");
         exportJsonKeyErrors.push(
           `Missing exportJsonKey for non-default jsonKey at ${headingPath}` + (tag.jsonKey ? ` (legacy: \`${tag.jsonKey}\`)` : ` (symbol-mapped tag \`${tag.key}\`)`)
         );
-        exportJsonKeyField = {};
       }
       const hasHtml = Object.prototype.hasOwnProperty.call(tag, "htmlKey");
-      const htmlKeyField = hasHtml ? { htmlKey: tag.htmlKey } : {};
       const t = {
         type: "tag",
         key: tagName,
-        ...exportJsonKeyField,
-        ...htmlKeyField,
-        format,
-        default: tag.defaultValue ?? null,
+        ...mappingKeysField(
+          tag.mappingKeys,
+          { value: tag.exportJsonKey, present: hasExport },
+          { value: tag.htmlKey, present: hasHtml }
+        ),
+        ...format && format !== "string" ? { format } : {},
+        ...tag.defaultValue != null ? { default: tag.defaultValue } : {},
         ...tag.nullable ? { nullable: true } : {},
-        min: tag.minCount == null ? 0 : tag.minCount,
-        max: tag.maxCount == null ? 1 : tag.maxCount,
+        ...tag.minCount != null && tag.minCount !== 0 ? { min: tag.minCount } : {},
+        ...tag.maxCount != null && tag.maxCount !== 1 ? { max: tag.maxCount } : {},
         description: tag.description ?? "",
         tags: chain
       };
       tags2.push(t);
       return tags2;
     };
-    const cardJsonKeyField = (container, legacyKey, exportKey, pathHeading) => {
+    const cardMappingKeysField = (container, base, legacyKey, exportKey, htmlExportKey, pathHeading) => {
       const c = container;
       const hasExport = Object.prototype.hasOwnProperty.call(c, exportKey);
-      if (hasExport) return { jsonKey: c[exportKey] };
-      const legacy = c[legacyKey];
-      if (legacy == null) return {};
-      exportJsonKeyErrors.push(
-        `Missing exportJsonKey for non-default jsonKey at ${pathHeading} (legacy: \`${legacy}\`)`
-      );
-      return {};
-    };
-    const cardHtmlKeyField = (container, htmlExportKey) => {
-      const c = container;
-      if (Object.prototype.hasOwnProperty.call(c, htmlExportKey)) {
-        return { htmlKey: c[htmlExportKey] };
+      if (!hasExport && c[legacyKey] != null) {
+        exportJsonKeyErrors.push(
+          `Missing exportJsonKey for non-default jsonKey at ${pathHeading} (legacy: \`${c[legacyKey]}\`)`
+        );
       }
-      return {};
+      return mappingKeysField(
+        base,
+        { value: c[exportKey], present: hasExport },
+        {
+          value: c[htmlExportKey],
+          present: Object.prototype.hasOwnProperty.call(c, htmlExportKey)
+        }
+      );
     };
     const serializeCardSet = (cardSetKey) => {
       const variantBodyFormat = (variant) => variant.format ?? TextFormat.bitmarkText;
@@ -44891,11 +45783,17 @@ var ConfigBuilder = class {
             variantTags.push(...processTagEntries(variantTag, [variantPath]));
           }
           return {
-            ...cardJsonKeyField(variant, "jsonKey", "exportJsonKey", variantPath),
-            ...cardHtmlKeyField(variant, "htmlKey"),
-            format: variantBodyFormat(variant),
+            ...cardMappingKeysField(
+              variant,
+              void 0,
+              "jsonKey",
+              "exportJsonKey",
+              "htmlKey",
+              variantPath
+            ),
+            bodyFormat: variantBodyFormat(variant),
             tags: variantTags,
-            repeatCount: variant.repeatCount ?? 1,
+            ...variant.repeatCount != null && variant.repeatCount !== 1 ? { repeatCount: variant.repeatCount } : {},
             ...variant.bodyRequired ? { bodyRequired: true } : {},
             ...variant.bodyAllowed === false ? { bodyForbidden: true } : {}
           };
@@ -44903,8 +45801,14 @@ var ConfigBuilder = class {
         return {
           name: side.name,
           ...side.repeat ? { repeat: side.repeat } : {},
-          ...cardJsonKeyField(side, "jsonKey", "exportJsonKey", sidePath),
-          ...cardHtmlKeyField(side, "htmlKey"),
+          ...cardMappingKeysField(
+            side,
+            side.mappingKeys,
+            "jsonKey",
+            "exportJsonKey",
+            "htmlKey",
+            sidePath
+          ),
           variants
         };
       });
@@ -44915,20 +45819,40 @@ var ConfigBuilder = class {
           const hasSideHtml = Object.prototype.hasOwnProperty.call(section, "sideHtmlKey");
           let cardSides = sides;
           if (hasSideExport || section.sideJsonKey != null || hasSideHtml) {
-            const sideOverride = cardJsonKeyField(
-              section,
-              "sideJsonKey",
-              "sideExportJsonKey",
-              `${sectionPath} / sides.*`
-            );
-            const sideHtmlOverride = cardHtmlKeyField(section, "sideHtmlKey");
-            cardSides = sides.map((s) => ({ ...s, ...sideOverride, ...sideHtmlOverride }));
+            if (!hasSideExport && section.sideJsonKey != null) {
+              exportJsonKeyErrors.push(
+                `Missing exportJsonKey for non-default jsonKey at ${sectionPath} / sides.* (legacy: \`${section.sideJsonKey}\`)`
+              );
+            }
+            cardSides = sides.map((s) => {
+              const record = { ...s.mappingKeys ?? {} };
+              if (hasSideExport) {
+                if (section.sideExportJsonKey != null) record.json = section.sideExportJsonKey;
+                else delete record.json;
+              }
+              if (hasSideHtml) {
+                if (section.sideHtmlKey != null) record.html = section.sideHtmlKey;
+                else delete record.html;
+              }
+              return {
+                name: s.name,
+                ...s.repeat ? { repeat: s.repeat } : {},
+                ...Object.keys(record).length > 0 ? { mappingKeys: record } : {},
+                variants: s.variants
+              };
+            });
           }
           return {
             name: sectionName,
             ...section.isDefault ? { isDefault: true } : {},
-            ...cardJsonKeyField(section, "jsonKey", "exportJsonKey", sectionPath),
-            ...cardHtmlKeyField(section, "htmlKey"),
+            ...cardMappingKeysField(
+              section,
+              section.mappingKeys,
+              "jsonKey",
+              "exportJsonKey",
+              "htmlKey",
+              sectionPath
+            ),
             // PLAN-085: per-section cardinality. Emit only when non-default
             // (treat `0` / undefined as "unbounded — omit").
             ...section.minCount != null && section.minCount !== 0 ? { min: section.minCount } : {},
@@ -44936,7 +45860,18 @@ var ConfigBuilder = class {
             sides: cardSides
           };
         });
-        return { name: normalizedKey, ...cardHtmlKeyField(cardSetConfig, "htmlKey"), cards };
+        return {
+          name: normalizedKey,
+          ...mappingKeysField(
+            void 0,
+            { present: false },
+            {
+              value: cardSetConfig.htmlKey,
+              present: Object.prototype.hasOwnProperty.call(cardSetConfig, "htmlKey")
+            }
+          ),
+          cards
+        };
       }
       const cardSetPath = `cardSets.${normalizedKey} / cards.default`;
       return {
@@ -44945,8 +45880,14 @@ var ConfigBuilder = class {
           {
             name: "default",
             isDefault: true,
-            ...cardJsonKeyField(cardSetConfig, "jsonKey", "exportJsonKey", cardSetPath),
-            ...cardHtmlKeyField(cardSetConfig, "htmlKey"),
+            ...cardMappingKeysField(
+              cardSetConfig,
+              cardSetConfig.mappingKeys,
+              "jsonKey",
+              "exportJsonKey",
+              "htmlKey",
+              cardSetPath
+            ),
             sides
           }
         ]
@@ -44982,14 +45923,19 @@ var ConfigBuilder = class {
             ...t.max != null ? { max: t.max } : {},
             ...t.description ? { description: t.description } : {}
           };
-          if (Object.prototype.hasOwnProperty.call(t, "jsonKey")) {
-            ref.exportJsonKey = t.jsonKey;
+          const record = t.mappingKeys ?? {};
+          if (Object.prototype.hasOwnProperty.call(record, "json")) {
+            ref.exportJsonKey = record.json;
             ref.hasExportJsonKey = true;
           }
-          if (Object.prototype.hasOwnProperty.call(t, "htmlKey")) {
-            ref.htmlKey = t.htmlKey;
+          if (Object.prototype.hasOwnProperty.call(record, "html")) {
+            ref.htmlKey = record.html;
             ref.hasHtmlKey = true;
           }
+          const extras = Object.fromEntries(
+            Object.entries(record).filter(([id]) => id !== "json" && id !== "html")
+          );
+          if (Object.keys(extras).length > 0) ref.extraKeys = extras;
           replacements.push(ref);
         }
         squashedGroups.set(groupKey, replacements);
@@ -45023,8 +45969,11 @@ var ConfigBuilder = class {
           pushOrReplace({
             type: "group",
             key: ref.key,
-            ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
-            ...ref.hasHtmlKey ? { htmlKey: ref.htmlKey } : {},
+            ...mappingKeysField(
+              ref.extraKeys,
+              { value: ref.exportJsonKey, present: !!ref.hasExportJsonKey },
+              { value: ref.htmlKey, present: !!ref.hasHtmlKey }
+            ),
             ...ref.min != null ? { min: ref.min } : {},
             ...ref.max != null ? { max: ref.max } : {},
             ...ref.description ? { description: ref.description } : {}
@@ -45037,8 +45986,11 @@ var ConfigBuilder = class {
             pushOrReplace({
               type: "group",
               key: ref.key,
-              ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
-              ...ref.hasHtmlKey ? { htmlKey: ref.htmlKey } : {},
+              ...mappingKeysField(
+                ref.extraKeys,
+                { value: ref.exportJsonKey, present: !!ref.hasExportJsonKey },
+                { value: ref.htmlKey, present: !!ref.hasHtmlKey }
+              ),
               ...ref.min != null ? { min: ref.min } : {},
               ...ref.max != null ? { max: ref.max } : {},
               ...ref.description ? { description: ref.description } : {}
@@ -45065,20 +46017,17 @@ var ConfigBuilder = class {
         description: b.description ?? "",
         since: resolvedBitConfig.since,
         deprecated: resolvedBitConfig.deprecated,
-        history: [
-          {
-            version: resolvedBitConfig.since,
-            changes: ["Initial version"]
-          }
-        ],
-        format: resolvedBitConfig.textFormatDefault ?? "bitmark--",
-        bodyRequired: resolvedBitConfig.bodyRequired ?? false,
-        bodyForbidden: !(resolvedBitConfig.bodyAllowed ?? true),
-        footerRequired: resolvedBitConfig.footerRequired ?? false,
-        footerForbidden: !(resolvedBitConfig.footerAllowed ?? true),
-        resourceAttachmentAllowed: resolvedBitConfig.resourceAttachmentAllowed ?? true,
+        bodyFormat: resolvedBitConfig.textFormatDefault ?? "bitmark--",
+        ...resolvedBitConfig.bodyRequired ? { bodyRequired: true } : {},
+        ...resolvedBitConfig.bodyAllowed === false ? { bodyForbidden: true } : {},
+        ...resolvedBitConfig.footerRequired ? { footerRequired: true } : {},
+        ...resolvedBitConfig.footerAllowed === false ? { footerForbidden: true } : {},
+        ...resolvedBitConfig.resourceAttachmentAllowed === false ? { resourceAttachmentAllowed: false } : {},
+        // Bit-level named key mappings (element keys for markup import),
+        // carried verbatim from the raw config.
+        ...mappingKeysField(b.mappingKeys, { present: false }, { present: false }),
         tags: tags2,
-        ...cardRef ? { card: cardRef } : {}
+        ...cardRef ? { cardSet: cardRef } : {}
       };
       const output = import_node_path3.default.join(outputFolderBits, `${b.bitType}.jsonc`);
       const str = JSON.stringify(bitJson, null, 2);
@@ -45106,14 +46055,7 @@ var ConfigBuilder = class {
         const bitJson = {
           name: groupKey,
           description: g.description ?? "",
-          since: "UNKNOWN",
           deprecated: g.deprecated,
-          history: [
-            {
-              version: "UNKNOWN",
-              changes: ["Initial version"]
-            }
-          ],
           tags: tags2
           // cards: [
           //   {
@@ -45167,8 +46109,11 @@ var ConfigBuilder = class {
             tags2.push({
               type: "group",
               key: ref.key,
-              ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
-              ...ref.hasHtmlKey ? { htmlKey: ref.htmlKey } : {},
+              ...mappingKeysField(
+                ref.extraKeys,
+                { value: ref.exportJsonKey, present: !!ref.hasExportJsonKey },
+                { value: ref.htmlKey, present: !!ref.hasHtmlKey }
+              ),
               ...ref.min != null ? { min: ref.min } : {},
               ...ref.max != null ? { max: ref.max } : {},
               ...ref.description ? { description: ref.description } : {}
@@ -45189,14 +46134,7 @@ var ConfigBuilder = class {
         const bitJson = {
           name: groupKey,
           description: b.description ?? "",
-          since: "UNKNOWN",
           deprecated: b.deprecated,
-          history: [
-            {
-              version: "UNKNOWN",
-              changes: ["Initial version"]
-            }
-          ],
           tags: tags2
         };
         const output = import_node_path3.default.join(outputFolderGroups, `${groupKey}.jsonc`);
@@ -45237,7 +46175,7 @@ var ConfigBuilder = class {
   validateConfigTree(outputFolder) {
     const errors = [];
     const outputFolderBits = import_node_path3.default.join(outputFolder, "bits");
-    const outputFolderGroups = import_node_path3.default.join(outputFolder, "partials");
+    const outputFolderGroups = import_node_path3.default.join(outputFolder, "groups");
     const outputFolderCards = import_node_path3.default.join(outputFolder, "cards");
     const availableGroups = /* @__PURE__ */ new Set();
     if (import_fs_extra3.default.existsSync(outputFolderGroups)) {
@@ -45311,7 +46249,7 @@ var ConfigBuilder = class {
           const content = import_fs_extra3.default.readFileSync(filePath, "utf-8");
           const config = JSON.parse(content);
           if (config.tags && Array.isArray(config.tags)) {
-            checkTags(config.tags, `partials/${file}`, 15);
+            checkTags(config.tags, `groups/${file}`, 15);
           }
         } catch (err) {
           errors.push(`Failed to parse ${file}: ${err}`);