@gmb/bitmark-parser-generator 5.26.0 → 5.27.0

package/dist/cli/main.js

@@ -545,6 +545,14 @@ var BitType = {
   smartStandardRemarkNonNormativeCollapsible: "smart-standard-remark-non-normative-collapsible",
   smartStandardRemarkNormative: "smart-standard-remark-normative",
   smartStandardRemarkNormativeCollapsible: "smart-standard-remark-normative-collapsible",
+  smartStandardRemarkTableExtendedImageNonNormative: "smart-standard-remark-table-extended-image-non-normative",
+  smartStandardRemarkTableExtendedImageNonNormativeCollapsible: "smart-standard-remark-table-extended-image-non-normative-collapsible",
+  smartStandardRemarkTableExtendedImageNormative: "smart-standard-remark-table-extended-image-normative",
+  smartStandardRemarkTableExtendedImageNormativeCollapsible: "smart-standard-remark-table-extended-image-normative-collapsible",
+  smartStandardRemarkTableExtendedNonNormative: "smart-standard-remark-table-extended-non-normative",
+  smartStandardRemarkTableExtendedNonNormativeCollapsible: "smart-standard-remark-table-extended-non-normative-collapsible",
+  smartStandardRemarkTableExtendedNormative: "smart-standard-remark-table-extended-normative",
+  smartStandardRemarkTableExtendedNormativeCollapsible: "smart-standard-remark-table-extended-normative-collapsible",
   smartStandardRemarkTableImageNonNormative: "smart-standard-remark-table-image-non-normative",
   smartStandardRemarkTableImageNonNormativeCollapsible: "smart-standard-remark-table-image-non-normative-collapsible",
   smartStandardRemarkTableImageNormative: "smart-standard-remark-table-image-normative",
@@ -553,6 +561,14 @@ var BitType = {
   smartStandardRemarkTableNonNormativeCollapsible: "smart-standard-remark-table-non-normative-collapsible",
   smartStandardRemarkTableNormative: "smart-standard-remark-table-normative",
   smartStandardRemarkTableNormativeCollapsible: "smart-standard-remark-table-normative-collapsible",
+  smartStandardTableExtendedImageNonNormative: "smart-standard-table-extended-image-non-normative",
+  smartStandardTableExtendedImageNonNormativeCollapsible: "smart-standard-table-extended-image-non-normative-collapsible",
+  smartStandardTableExtendedImageNormative: "smart-standard-table-extended-image-normative",
+  smartStandardTableExtendedImageNormativeCollapsible: "smart-standard-table-extended-image-normative-collapsible",
+  smartStandardTableExtendedNonNormative: "smart-standard-table-extended-non-normative",
+  smartStandardTableExtendedNonNormativeCollapsible: "smart-standard-table-extended-non-normative-collapsible",
+  smartStandardTableExtendedNormative: "smart-standard-table-extended-normative",
+  smartStandardTableExtendedNormativeCollapsible: "smart-standard-table-extended-normative-collapsible",
   smartStandardTableImageNonNormative: "smart-standard-table-image-non-normative",
   smartStandardTableImageNonNormativeCollapsible: "smart-standard-table-image-non-normative-collapsible",
   smartStandardTableImageNormative: "smart-standard-table-image-normative",
@@ -575,10 +591,18 @@ var BitType = {
   standardNoteNormative: "standard-note-normative",
   standardRemarkNonNormative: "standard-remark-non-normative",
   standardRemarkNormative: "standard-remark-normative",
+  standardRemarkTableExtendedImageNonNormative: "standard-remark-table-extended-image-non-normative",
+  standardRemarkTableExtendedImageNormative: "standard-remark-table-extended-image-normative",
+  standardRemarkTableExtendedNonNormative: "standard-remark-table-extended-non-normative",
+  standardRemarkTableExtendedNormative: "standard-remark-table-extended-normative",
   standardRemarkTableImageNonNormative: "standard-remark-table-image-non-normative",
   standardRemarkTableImageNormative: "standard-remark-table-image-normative",
   standardRemarkTableNonNormative: "standard-remark-table-non-normative",
   standardRemarkTableNormative: "standard-remark-table-normative",
+  standardTableExtendedImageNonNormative: "standard-table-extended-image-non-normative",
+  standardTableExtendedImageNormative: "standard-table-extended-image-normative",
+  standardTableExtendedNonNormative: "standard-table-extended-non-normative",
+  standardTableExtendedNormative: "standard-table-extended-normative",
   standardTableImageNonNormative: "standard-table-image-non-normative",
   standardTableImageNormative: "standard-table-image-normative",
   standardTableNonNormative: "standard-table-non-normative",
@@ -777,6 +801,10 @@ var AbstractTagConfig = class {
   // New JSON-pattern jsonKey (export-only)
   hasExportJsonKey;
   // True iff exportJsonKey was explicitly set
+  htmlKey;
+  // HTML key-pattern (export-only)
+  hasHtmlKey;
+  // True iff htmlKey was explicitly set
   deprecated;
   // Deprecated version
   constructor(params) {
@@ -789,6 +817,8 @@ var AbstractTagConfig = class {
     this.jsonKey = params.jsonKey;
     this.exportJsonKey = params.exportJsonKey;
     this.hasExportJsonKey = params.hasExportJsonKey;
+    this.htmlKey = params.htmlKey;
+    this.hasHtmlKey = params.hasHtmlKey;
     this.deprecated = params.deprecated;
   }
 };
@@ -922,9 +952,12 @@ var CardVariantConfig = class {
   exportJsonKey;
   // New JSON-pattern jsonKey
   hasExportJsonKey;
+  htmlKey;
+  // HTML key-pattern
+  hasHtmlKey;
   format;
   // Body text format. Default: bitmark++
-  constructor(tags2, bodyAllowed, bodyRequired, repeatCount, jsonKey, exportJsonKey, hasExportJsonKey = false, format) {
+  constructor(tags2, bodyAllowed, bodyRequired, repeatCount, jsonKey, exportJsonKey, hasExportJsonKey = false, format, htmlKey, hasHtmlKey = false) {
     this.tags = tags2;
     this.bodyAllowed = bodyAllowed == null ? true : bodyAllowed;
     this.bodyRequired = bodyRequired;
@@ -932,6 +965,8 @@ var CardVariantConfig = class {
     this.jsonKey = jsonKey;
     this.exportJsonKey = exportJsonKey;
     this.hasExportJsonKey = hasExportJsonKey;
+    this.htmlKey = htmlKey;
+    this.hasHtmlKey = hasHtmlKey;
     this.format = format;
   }
   toString(options) {
@@ -961,13 +996,17 @@ var CardSideConfig = class {
   jsonKey;
   exportJsonKey;
   hasExportJsonKey;
+  htmlKey;
+  hasHtmlKey;
   variants;
-  constructor(name, repeat, variants, jsonKey, exportJsonKey, hasExportJsonKey = false) {
+  constructor(name, repeat, variants, jsonKey, exportJsonKey, hasExportJsonKey = false, htmlKey, hasHtmlKey = false) {
     this.name = name;
     this.repeat = repeat;
     this.jsonKey = jsonKey;
     this.exportJsonKey = exportJsonKey;
     this.hasExportJsonKey = hasExportJsonKey;
+    this.htmlKey = htmlKey;
+    this.hasHtmlKey = hasHtmlKey;
     this.variants = variants;
   }
   toString(options) {
@@ -993,6 +1032,8 @@ var CardSetConfig = class {
   jsonKey;
   exportJsonKey;
   hasExportJsonKey;
+  htmlKey;
+  hasHtmlKey;
   sections;
   sides;
   // Legacy accessor — provides the same shape as the old `variants: CardVariantConfig[][]`
@@ -1000,11 +1041,13 @@ var CardSetConfig = class {
   get variants() {
     return this.sides.map((side) => side.variants);
   }
-  constructor(configKey, jsonKey, exportJsonKey, hasExportJsonKey, sections, sides) {
+  constructor(configKey, jsonKey, exportJsonKey, hasExportJsonKey, sections, sides, htmlKey = void 0, hasHtmlKey = false) {
     this.configKey = configKey;
     this.jsonKey = jsonKey;
     this.exportJsonKey = exportJsonKey;
     this.hasExportJsonKey = hasExportJsonKey;
+    this.htmlKey = htmlKey;
+    this.hasHtmlKey = hasHtmlKey;
     this.sections = sections;
     this.sides = sides;
   }
@@ -3661,6 +3704,16 @@ var CARDSETS = {
   [CardSetConfigKey.table]: {
     jsonKey: null,
     exportJsonKey: null,
+    // PLAN-109 / HTML.md §8 — idiomatic HTML mapping. The classic (non-extended)
+    // table produces the same `<table>`/`<thead>`/`<tbody>`/`<tfoot>` structure as
+    // table-extended, so the structural htmlKeys mirror that cardSet. NOTE: the
+    // JSON side routes the FIRST header card → `columns` (header) and SUBSEQUENT
+    // header cards → `data` (body); HTML uses a uniform `<thead>` for the whole
+    // `table-header` section, so a multi-card header (e.g. a second header card
+    // that JSON sends to `data`) renders as additional `<thead>` rows rather than
+    // moving to `<tbody>`. Per-card header/body splitting needs engine-level
+    // routing not yet expressible in the pattern vocabulary — see PLAN-109.
+    htmlKey: { "@el": "table", "@children": "$" },
     sections: {
       "table-header": {
         // First header card's row of cells → `columns`. Subsequent header
@@ -3679,25 +3732,36 @@ var CARDSETS = {
           },
           { "@cardIndex=0": { "@bit": { table: { columns: "$" } } } },
           { "@bit": { table: { data: ["$"] } } }
-        ]
+        ],
+        // Header section → `<thead>` rows of `<th>`; `@tableColWidth` bubbles a
+        // `width` attr onto the enclosing `<th>` (HTML-C2).
+        htmlKey: { "@el": "thead", "@children": { "@el": "tr", "@children": "$" } },
+        sideHtmlKey: { "@el": "th", "@children": "$" }
       },
       "table-body": {
         // Batched emission: `$` is the entire 2D array of body card rows.
         // This is the default section (no qualifier → cards land here).
         jsonKey: "table.data",
         exportJsonKey: { "@bit": { table: { data: "$" } } },
+        htmlKey: { "@el": "tbody", "@children": { "@el": "tr", "@children": "$" } },
         isDefault: true
       },
       "table-footer": {
         // Batched emission: `$` is the entire 2D array of footer rows.
         jsonKey: "table.data",
-        exportJsonKey: { "@bit": { table: { data: "$" } } }
+        exportJsonKey: { "@bit": { table: { data: "$" } } },
+        // Footer cells route to `data` (not `columns`), so they are `<td>` (no
+        // sideHtmlKey override — the cell side default applies).
+        htmlKey: { "@el": "tfoot", "@children": { "@el": "tr", "@children": "$" } }
       }
     },
     sides: [
       {
         name: "cell",
         repeat: true,
+        // Default (body/footer) cell → `<td>`; the header section overrides to
+        // `<th>` via its sideHtmlKey (HTML.md §8).
+        htmlKey: { "@el": "td", "@children": "$" },
         variants: [
           {
             jsonKey: null,
@@ -3714,6 +3778,8 @@ var CARDSETS = {
               },
               {
                 key: ConfigKey.property_tableCellType,
+                // HTML.md §8: first-match predicate selecting `<th>` vs `<td>`.
+                htmlKey: [{ "@value=th": { "@el": "th" } }, { "@absent": { "@el": "td" } }],
                 description: "Table cell type (th/td).",
                 format: TagFormat.plainText
               },
@@ -3736,6 +3802,9 @@ var CARDSETS = {
                 key: ConfigKey.property_tableColWidth,
                 jsonKey: "^table.columnWidths[{s}]",
                 exportJsonKey: { "@bit": { table: { columnWidths: { $s: "$" } } } },
+                // HTML.md §8 + HTML-C2: contribute a `width` attribute onto the
+                // enclosing cell element (`<th>`/`<td>`).
+                htmlKey: { "@el": { "@attr": { width: "$" } } },
                 description: "Width for the column.",
                 format: TagFormat.number
               }
@@ -3751,6 +3820,12 @@ var CARDSETS = {
   //
   [CardSetConfigKey.tableExtended]: {
     jsonKey: null,
+    // PLAN-109 / HTML.md §8 — idiomatic HTML mapping for the extended table.
+    // The card-set container is the `<table>` element; each section is a
+    // table section element (`<thead>`/`<tbody>`/`<tfoot>`) whose children are
+    // `<tr>` rows, and each cell side is a `<td>` (body) or `<th>` (header /
+    // footer, via the section sideHtmlKey override).
+    htmlKey: { "@el": "table", "@children": "$" },
     sections: {
       "table-header": {
         jsonKey: "table.header.rows",
@@ -3770,19 +3845,29 @@ var CARDSETS = {
           },
           { table: { header: { rows: ["$"] } } }
         ],
+        htmlKey: { "@el": "thead", "@children": { "@el": "tr", "@children": "$" } },
         sideJsonKey: "cells[{s}]|set(title=true)",
-        sideExportJsonKey: { cells: { $s: { title: true, $: "$" } } }
+        sideExportJsonKey: { cells: { $s: { title: true, $: "$" } } },
+        // Header cells are `<th>`. The `width` attribute is contributed by the
+        // `@tableColWidth` tag, which bubbles it onto the enclosing `<th>`
+        // (HTML-C2) — so it is not repeated here.
+        sideHtmlKey: { "@el": "th", "@children": "$" }
       },
       "table-body": {
         jsonKey: "table.body.rows",
         exportJsonKey: { table: { body: { rows: "$" } } },
+        htmlKey: { "@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": "$" } },
         sideJsonKey: "cells[{s}]|set(title=true)",
-        sideExportJsonKey: { cells: { $s: { title: true, $: "$" } } }
+        sideExportJsonKey: { cells: { $s: { title: true, $: "$" } } },
+        // Footer cells render as `<th>` (mirrors the header `title: true`
+        // mapping); §8 lists only the header side, so this parallels it.
+        sideHtmlKey: { "@el": "th", "@children": "$" }
       }
     },
     sides: [
@@ -3791,6 +3876,9 @@ var CARDSETS = {
         repeat: true,
         jsonKey: "cells[{s}]",
         exportJsonKey: { cells: { $s: "$" } },
+        // Default (body) cell → `<td>`; the header/footer sections override the
+        // side to `<th>` via their sideHtmlKey (HTML.md §8).
+        htmlKey: { "@el": "td", "@children": "$" },
         variants: [
           {
             jsonKey: "content",
@@ -3814,6 +3902,9 @@ var CARDSETS = {
                 key: ConfigKey.property_tableCellType,
                 jsonKey: "title|bool(th)",
                 exportJsonKey: [{ "@value=th": { title: true } }],
+                // HTML.md §8: same first-match predicate machinery selecting
+                // `<th>` vs `<td>` instead of `title:true` vs nothing.
+                htmlKey: [{ "@value=th": { "@el": "th" } }, { "@absent": { "@el": "td" } }],
                 description: "Table cell type (th/td).",
                 format: TagFormat.plainText
               },
@@ -3843,6 +3934,9 @@ var CARDSETS = {
                 // PLAN-080: write to the cell's `colwidth` field.
                 jsonKey: "colwidth",
                 exportJsonKey: { colwidth: "$" },
+                // HTML.md §8 + HTML-C2: contribute a `width` attribute onto the
+                // enclosing cell element (`<th>`/`<td>`).
+                htmlKey: { "@el": { "@attr": { width: "$" } } },
                 description: "Width for the column.",
                 format: TagFormat.number
               }
@@ -6771,7 +6865,9 @@ var ConfigHydrator = class {
         variantsOfSide,
         _side.jsonKey,
         _side.exportJsonKey,
-        Object.prototype.hasOwnProperty.call(_side, "exportJsonKey")
+        Object.prototype.hasOwnProperty.call(_side, "exportJsonKey"),
+        _side.htmlKey,
+        Object.prototype.hasOwnProperty.call(_side, "htmlKey")
       );
       sides.push(sideConfig);
     }
@@ -6781,7 +6877,9 @@ var ConfigHydrator = class {
       _cardSetConfig.exportJsonKey,
       Object.prototype.hasOwnProperty.call(_cardSetConfig, "exportJsonKey"),
       this.hydrateCardSections(_cardSetConfig.sections),
-      sides
+      sides,
+      _cardSetConfig.htmlKey,
+      Object.prototype.hasOwnProperty.call(_cardSetConfig, "htmlKey")
     );
     return cardSetConfig;
   }
@@ -6793,10 +6891,14 @@ var ConfigHydrator = class {
         jsonKey: v.jsonKey,
         exportJsonKey: v.exportJsonKey,
         hasExportJsonKey: Object.prototype.hasOwnProperty.call(v, "exportJsonKey"),
+        htmlKey: v.htmlKey,
+        hasHtmlKey: Object.prototype.hasOwnProperty.call(v, "htmlKey"),
         isDefault: v.isDefault,
         sideJsonKey: v.sideJsonKey,
         sideExportJsonKey: v.sideExportJsonKey,
         hasSideExportJsonKey: Object.prototype.hasOwnProperty.call(v, "sideExportJsonKey"),
+        sideHtmlKey: v.sideHtmlKey,
+        hasSideHtmlKey: Object.prototype.hasOwnProperty.call(v, "sideHtmlKey"),
         // PLAN-085: cardinality fields pass through; defaults applied
         // downstream by the config consumer (Rust treats `0` / undefined
         // as unbounded).
@@ -6814,7 +6916,8 @@ var ConfigHydrator = class {
       chain: _chain,
       deprecated,
       jsonKey,
-      exportJsonKey
+      exportJsonKey,
+      htmlKey
     } = _tag;
     const configKey = Enum(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No tag key found for config key '${configKey}'`);
@@ -6833,6 +6936,8 @@ var ConfigHydrator = class {
       jsonKey,
       exportJsonKey,
       hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
+      htmlKey,
+      hasHtmlKey: Object.prototype.hasOwnProperty.call(_tag, "htmlKey"),
       deprecated
     });
     return {
@@ -6852,7 +6957,8 @@ var ConfigHydrator = class {
       values,
       defaultValue,
       jsonKey,
-      exportJsonKey
+      exportJsonKey,
+      htmlKey
     } = _tag;
     const configKey = Enum(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No property key found for config key '${configKey}'`);
@@ -6870,6 +6976,8 @@ var ConfigHydrator = class {
       jsonKey,
       exportJsonKey,
       hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
+      htmlKey,
+      hasHtmlKey: Object.prototype.hasOwnProperty.call(_tag, "htmlKey"),
       format,
       values,
       defaultValue,
@@ -6889,7 +6997,8 @@ var ConfigHydrator = class {
       chain: _chain,
       deprecated,
       jsonKey,
-      exportJsonKey
+      exportJsonKey,
+      htmlKey
     } = _tag;
     const configKey = Enum(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No resource key found for config key '${configKey}'`);
@@ -6907,6 +7016,8 @@ var ConfigHydrator = class {
       jsonKey,
       exportJsonKey,
       hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
+      htmlKey,
+      hasHtmlKey: Object.prototype.hasOwnProperty.call(_tag, "htmlKey"),
       deprecated
     });
     return {
@@ -6945,6 +7056,7 @@ var ConfigHydrator = class {
       repeatCount,
       jsonKey,
       exportJsonKey,
+      htmlKey,
       format
     } = _variant;
     const tags2 = this.hydrateTagsConfig(_tags);
@@ -6956,7 +7068,9 @@ var ConfigHydrator = class {
       jsonKey,
       exportJsonKey,
       Object.prototype.hasOwnProperty.call(_variant, "exportJsonKey"),
-      format
+      format,
+      htmlKey,
+      Object.prototype.hasOwnProperty.call(_variant, "htmlKey")
     );
     return cardSetConfig;
   }
@@ -10089,11 +10203,6 @@ var BITS = {
     baseBitType: BitType._standard,
     description: "Extractor rule bit, used to define extraction rules with reference images and instructions",
     tags: [
-      {
-        exportJsonKey: { title: "$" },
-        key: ConfigKey.tag_title,
-        description: "The name of the extraction rule"
-      },
       {
         key: ConfigKey.group_resourceBitTags,
         description: "Resource bit tags for extraction rule images"
@@ -10772,6 +10881,26 @@ var BITS = {
     baseBitType: BitType.tableImage,
     description: "Standard non-normative remark table image bit, used to create non-normative remark images in tables in articles or books"
   },
+  [BitType.standardTableExtendedImageNormative]: {
+    since: "1.16.0",
+    baseBitType: BitType.tableExtendedImage,
+    description: "Standard normative extended table image bit, used to create normative extended images in tables in articles or books"
+  },
+  [BitType.standardTableExtendedImageNonNormative]: {
+    since: "1.16.0",
+    baseBitType: BitType.tableExtendedImage,
+    description: "Standard non-normative extended table image bit, used to create non-normative extended images in tables in articles or books"
+  },
+  [BitType.standardRemarkTableExtendedImageNormative]: {
+    since: "1.17.0",
+    baseBitType: BitType.tableExtendedImage,
+    description: "Standard normative remark extended table image bit, used to create normative remark extended images in tables in articles or books"
+  },
+  [BitType.standardRemarkTableExtendedImageNonNormative]: {
+    since: "1.17.0",
+    baseBitType: BitType.tableExtendedImage,
+    description: "Standard non-normative remark extended table image bit, used to create non-normative remark extended images in tables in articles or books"
+  },
   [BitType.smartStandardTableImageNormative]: {
     since: "1.28.0",
     baseBitType: BitType.standardTableImageNormative,
@@ -10792,6 +10921,26 @@ var BITS = {
     baseBitType: BitType.standardRemarkTableImageNonNormative,
     description: "Smart standard non-normative remark table image bit, used to create smart standard non-normative remark images in tables in articles or books"
   },
+  [BitType.smartStandardTableExtendedImageNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType.standardTableExtendedImageNormative,
+    description: "Smart standard normative extended table image bit, used to create smart standard normative extended images in tables in articles or books"
+  },
+  [BitType.smartStandardTableExtendedImageNonNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType.standardTableExtendedImageNonNormative,
+    description: "Smart standard non-normative extended table image bit, used to create smart standard non-normative extended images in tables in articles or books"
+  },
+  [BitType.smartStandardRemarkTableExtendedImageNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType.standardRemarkTableExtendedImageNormative,
+    description: "Smart standard normative remark extended table image bit, used to create smart standard normative remark extended images in tables in articles or books"
+  },
+  [BitType.smartStandardRemarkTableExtendedImageNonNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType.standardRemarkTableExtendedImageNonNormative,
+    description: "Smart standard non-normative remark extended table image bit, used to create smart standard non-normative remark extended images in tables in articles or books"
+  },
   [BitType.smartStandardTableImageNormativeCollapsible]: {
     since: "1.28.0",
     baseBitType: BitType.smartStandardTableImageNormative,
@@ -10812,6 +10961,26 @@ var BITS = {
     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"
   },
+  [BitType.smartStandardTableExtendedImageNormativeCollapsible]: {
+    since: "1.28.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"
+  },
+  [BitType.smartStandardTableExtendedImageNonNormativeCollapsible]: {
+    since: "1.28.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"
+  },
+  [BitType.smartStandardRemarkTableExtendedImageNormativeCollapsible]: {
+    since: "1.28.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"
+  },
+  [BitType.smartStandardRemarkTableExtendedImageNonNormativeCollapsible]: {
+    since: "1.28.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"
+  },
   [BitType.imageLink]: {
     since: "1.3.0",
     baseBitType: BitType._standard,
@@ -12488,6 +12657,26 @@ var BITS = {
     baseBitType: BitType.table,
     description: "Standard non-normative remark table bit, used to create standard non-normative remark tables in articles or books"
   },
+  [BitType.standardTableExtendedNormative]: {
+    since: "1.16.0",
+    baseBitType: BitType.tableExtended,
+    description: "Standard normative extended table bit, used to create standard normative extended tables in articles or books"
+  },
+  [BitType.standardTableExtendedNonNormative]: {
+    since: "1.16.0",
+    baseBitType: BitType.tableExtended,
+    description: "Standard non-normative extended table bit, used to create standard non-normative extended tables in articles or books"
+  },
+  [BitType.standardRemarkTableExtendedNormative]: {
+    since: "1.17.0",
+    baseBitType: BitType.tableExtended,
+    description: "Standard normative remark extended table bit, used to create standard normative remark extended tables in articles or books"
+  },
+  [BitType.standardRemarkTableExtendedNonNormative]: {
+    since: "1.17.0",
+    baseBitType: BitType.tableExtended,
+    description: "Standard non-normative remark extended table bit, used to create standard non-normative remark extended tables in articles or books"
+  },
   [BitType.smartStandardTableNormative]: {
     since: "1.28.0",
     baseBitType: BitType.standardTableNormative,
@@ -12508,6 +12697,26 @@ var BITS = {
     baseBitType: BitType.standardRemarkTableNonNormative,
     description: "Smart standard non-normative remark table bit, used to create smart standard non-normative remark tables in articles or books"
   },
+  [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"
+  },
+  [BitType.smartStandardTableExtendedNonNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType.standardTableExtendedNonNormative,
+    description: "Smart standard non-normative extended table bit, used to create smart standard non-normative extended tables in articles or books"
+  },
+  [BitType.smartStandardRemarkTableExtendedNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType.standardRemarkTableExtendedNormative,
+    description: "Smart standard normative remark extended table bit, used to create smart standard normative remark extended tables in articles or books"
+  },
+  [BitType.smartStandardRemarkTableExtendedNonNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType.standardRemarkTableExtendedNonNormative,
+    description: "Smart standard non-normative remark extended table bit, used to create smart standard non-normative remark extended tables in articles or books"
+  },
   [BitType.smartStandardTableNormativeCollapsible]: {
     since: "1.28.0",
     baseBitType: BitType.smartStandardTableNormative,
@@ -12528,6 +12737,26 @@ var BITS = {
     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"
   },
+  [BitType.smartStandardTableExtendedNormativeCollapsible]: {
+    since: "1.28.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"
+  },
+  [BitType.smartStandardTableExtendedNonNormativeCollapsible]: {
+    since: "1.28.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"
+  },
+  [BitType.smartStandardRemarkTableExtendedNormativeCollapsible]: {
+    since: "1.28.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"
+  },
+  [BitType.smartStandardRemarkTableExtendedNonNormativeCollapsible]: {
+    since: "1.28.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"
+  },
   [BitType.parameters]: {
     since: "1.18.0",
     baseBitType: BitType.table,
@@ -13469,6 +13698,8 @@ var Config = class {
               jsonKey: tag.jsonKey,
               exportJsonKey: tag.exportJsonKey,
               hasExportJsonKey: tag.hasExportJsonKey,
+              htmlKey: tag.htmlKey,
+              hasHtmlKey: tag.hasHtmlKey,
               deprecated: tag.deprecated
             });
             finalResourceTags[k] = newTag;
@@ -13573,7 +13804,7 @@ var instance2 = new Config();
 // src/generated/package_info.ts
 var PACKAGE_INFO = {
   "name": "@gmb/bitmark-parser-generator",
-  "version": "5.26.0",
+  "version": "5.27.0",
   "license": "ISC"};
 var Environment = {
   unknown: "",
@@ -32692,6 +32923,233 @@ var BitmarkStringGenerator = class {
     return this.writer.getString();
   }
 };
+
+// src/generator/html/HtmlTableGenerator.ts
+var MARK_TO_TAG = {
+  bold: "b",
+  italic: "i",
+  superscript: "sup",
+  subscript: "sub",
+  strike: "s",
+  del: "del",
+  ins: "ins",
+  underline: "u",
+  highlight: "mark",
+  code: "code"
+};
+var HtmlTableGenerator = class {
+  indentUnit = "  ";
+  /**
+   * Generate HTML table fragments from a string or JSON value.
+   * @returns the concatenated `<table>` fragments, blank-line separated (empty string if none).
+   */
+  generate(input) {
+    let data = input;
+    if (typeof data === "string") {
+      try {
+        data = JSON.parse(data);
+      } catch {
+        return "";
+      }
+    }
+    const bits = this.collectBits(data);
+    const fragments = [];
+    for (const bit of bits) {
+      const html = this.renderTableBit(bit);
+      if (html) fragments.push(html);
+    }
+    return fragments.join("\n\n");
+  }
+  // --- bit collection -------------------------------------------------------
+  collectBits(data) {
+    const out = [];
+    const visit = (value) => {
+      if (value == null || typeof value !== "object") return;
+      if (Array.isArray(value)) {
+        value.forEach(visit);
+        return;
+      }
+      const obj = value;
+      if ("bit" in obj && obj.bit && typeof obj.bit === "object") {
+        out.push(obj.bit);
+      } else if ("type" in obj) {
+        out.push(obj);
+      }
+    };
+    visit(data);
+    return out;
+  }
+  // --- table rendering ------------------------------------------------------
+  renderTableBit(bit) {
+    const table = bit.table;
+    if (!table) return "";
+    if (bit.type !== "table" && bit.type !== "table-extended") return "";
+    const extended = this.toExtended(table);
+    const lines = [];
+    lines.push("<table>");
+    if (bit.caption != null) {
+      const caption = this.cellContentToHtml(this.asTextAst(bit.caption));
+      if (caption) lines.push(`${this.indentUnit}<caption>${caption}</caption>`);
+    }
+    this.renderSection(lines, "thead", extended.header, "header");
+    this.renderSection(lines, "tbody", extended.body, "body");
+    this.renderSection(lines, "tfoot", extended.footer, "footer");
+    lines.push("</table>");
+    return lines.join("\n");
+  }
+  toExtended(table) {
+    const t = table;
+    if (t.header || t.body || t.footer) return table;
+    return convertBasicToExtendedTableFormat(table);
+  }
+  renderSection(lines, tag, section, key) {
+    if (!section || !section.rows || section.rows.length === 0) return;
+    lines.push(`${this.indentUnit}<${tag}>`);
+    for (const row of section.rows) {
+      lines.push(`${this.indentUnit.repeat(2)}<tr>`);
+      for (const cell of row.cells ?? []) {
+        lines.push(`${this.indentUnit.repeat(3)}${this.renderCell(cell, key)}`);
+      }
+      lines.push(`${this.indentUnit.repeat(2)}</tr>`);
+    }
+    lines.push(`${this.indentUnit}</${tag}>`);
+  }
+  renderCell(cell, _key) {
+    const tag = cell.title === true ? "th" : "td";
+    const attrs = [];
+    if (cell.rowspan && cell.rowspan > 1) attrs.push(`rowspan="${cell.rowspan}"`);
+    if (cell.colspan && cell.colspan > 1) attrs.push(`colspan="${cell.colspan}"`);
+    if (cell.scope) attrs.push(`scope="${cell.scope}"`);
+    if (cell.colwidth && cell.colwidth > 0) attrs.push(`width="${cell.colwidth}"`);
+    const open = attrs.length > 0 ? `<${tag} ${attrs.join(" ")}>` : `<${tag}>`;
+    return `${open}${this.cellContentToHtml(this.asTextAst(cell.content))}</${tag}>`;
+  }
+  // --- cell content (TextAst -> HTML) ---------------------------------------
+  asTextAst(content) {
+    if (content == null) return [];
+    if (typeof content === "string") return [{ type: "text", text: content }];
+    return content;
+  }
+  cellContentToHtml(blocks) {
+    if (blocks.length === 0) return "";
+    if (blocks.length === 1 && blocks[0].type === "paragraph") {
+      return this.inlineToHtml(blocks[0].content ?? []);
+    }
+    return blocks.map((b) => this.blockToHtml(b)).join("");
+  }
+  blockToHtml(node) {
+    switch (node.type) {
+      case "paragraph":
+        return `<p>${this.inlineToHtml(node.content ?? [])}</p>`;
+      case "bulletList":
+      case "noBulletList":
+      case "orderedList":
+      case "orderedListRoman":
+      case "orderedListRomanLower":
+      case "letteredList":
+      case "letteredListLower":
+      case "taskList":
+        return this.listToHtml(node);
+      case "image":
+      case "imageInline":
+        return this.imageToHtml(node);
+      default:
+        return this.inlineToHtml([node]);
+    }
+  }
+  inlineToHtml(nodes) {
+    return nodes.map((n) => this.inlineNodeToHtml(n)).join("");
+  }
+  inlineNodeToHtml(node) {
+    if (node.type === "hardBreak") return "<br>";
+    if (node.type === "image" || node.type === "imageInline") return this.imageToHtml(node);
+    if (node.type === "text") {
+      return this.wrapMarks(this.escapeText(node.text ?? ""), node.marks);
+    }
+    if (node.content) return this.inlineToHtml(node.content);
+    return this.escapeText(node.text ?? "");
+  }
+  wrapMarks(text, marks) {
+    if (!marks || marks.length === 0) return text;
+    let open = "";
+    let close = "";
+    for (const mark of marks) {
+      if (mark.type === "link") {
+        const href = mark.attrs?.href ?? "";
+        open += `<a href="${this.escapeAttr(href)}">`;
+        close = `</a>${close}`;
+      } else {
+        const tag = MARK_TO_TAG[mark.type];
+        if (tag) {
+          open += `<${tag}>`;
+          close = `</${tag}>${close}`;
+        }
+      }
+    }
+    return `${open}${text}${close}`;
+  }
+  // --- lists ----------------------------------------------------------------
+  listToHtml(node) {
+    const { tag, attrs } = this.listTag(node);
+    const items = (node.content ?? []).map((item) => this.listItemToHtml(item, node.type === "taskList")).join("");
+    return `<${tag}${attrs}>${items}</${tag}>`;
+  }
+  listTag(node) {
+    const start = node.attrs?.start;
+    const startAttr = typeof start === "number" && start !== 1 ? ` start="${start}"` : "";
+    switch (node.type) {
+      case "orderedList":
+        return { tag: "ol", attrs: startAttr };
+      case "orderedListRoman":
+        return { tag: "ol", attrs: ` type="I"${startAttr}` };
+      case "orderedListRomanLower":
+        return { tag: "ol", attrs: ` type="i"${startAttr}` };
+      case "letteredList":
+        return { tag: "ol", attrs: ` type="A"${startAttr}` };
+      case "letteredListLower":
+        return { tag: "ol", attrs: ` type="a"${startAttr}` };
+      case "noBulletList":
+        return { tag: "ul", attrs: ' style="list-style:none"' };
+      case "taskList":
+      case "bulletList":
+      default:
+        return { tag: "ul", attrs: "" };
+    }
+  }
+  listItemToHtml(item, task) {
+    const inner = (item.content ?? []).map((b) => {
+      if (b.type === "paragraph") return this.inlineToHtml(b.content ?? []);
+      return this.blockToHtml(b);
+    }).join("");
+    if (task) {
+      const checked = item.attrs?.checked ? " checked" : "";
+      return `<li><input type="checkbox"${checked}>${inner}</li>`;
+    }
+    return `<li>${inner}</li>`;
+  }
+  // --- images ---------------------------------------------------------------
+  imageToHtml(node) {
+    const attrs = node.attrs ?? {};
+    const parts = [];
+    const src = attrs.src;
+    parts.push(`src="${this.escapeAttr(typeof src === "string" ? src : "")}"`);
+    if (typeof attrs.alt === "string") parts.push(`alt="${this.escapeAttr(attrs.alt)}"`);
+    if (typeof attrs.title === "string") parts.push(`title="${this.escapeAttr(attrs.title)}"`);
+    if (attrs.width != null) parts.push(`width="${attrs.width}"`);
+    if (attrs.height != null) parts.push(`height="${attrs.height}"`);
+    if (typeof attrs.class === "string" && attrs.class) {
+      parts.push(`class="${this.escapeAttr(attrs.class)}"`);
+    }
+    return `<img ${parts.join(" ")}>`;
+  }
+  // --- escaping -------------------------------------------------------------
+  escapeText(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  }
+  escapeAttr(text) {
+    return this.escapeText(text).replace(/"/g, "&quot;");
+  }
+};
 var MOVE_BODY_RECURSION_LIMIT = 5e3;
 var DEFAULT_OPTIONS3 = {
   // debugGenerationInline: true,
@@ -37538,6 +37996,8 @@ function propertyContentProcessor(context, contentDepth, tagsConfig, content, ta
         jsonKey: void 0,
         exportJsonKey: void 0,
         hasExportJsonKey: false,
+        htmlKey: void 0,
+        hasHtmlKey: false,
         format: TagFormat.bitmarkText,
         values: void 0,
         defaultValue: void 0,
@@ -41892,6 +42352,497 @@ var BitmarkParser = class {
     return parse2(bitmark);
   }
 };
+
+// src/parser/html/HtmlDom.ts
+var VOID_ELEMENTS = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+]);
+var IMPLIED_CLOSE = {
+  li: /* @__PURE__ */ new Set(["li"]),
+  td: /* @__PURE__ */ new Set(["td", "th"]),
+  th: /* @__PURE__ */ new Set(["td", "th"]),
+  tr: /* @__PURE__ */ new Set(["td", "th", "tr"]),
+  thead: /* @__PURE__ */ new Set(["td", "th", "tr", "thead", "tbody", "tfoot"]),
+  tbody: /* @__PURE__ */ new Set(["td", "th", "tr", "thead", "tbody", "tfoot"]),
+  tfoot: /* @__PURE__ */ new Set(["td", "th", "tr", "thead", "tbody", "tfoot"]),
+  p: /* @__PURE__ */ new Set(["p"]),
+  option: /* @__PURE__ */ new Set(["option"])
+};
+var TAG_RE = /<(\/)?([a-zA-Z][a-zA-Z0-9-]*)((?:\s+(?:"[^"]*"|'[^']*'|[^<>"'])*)?)(\/)?>/g;
+var ATTR_RE = /([a-zA-Z_:][a-zA-Z0-9:._-]*)(?:\s*=\s*("[^"]*"|'[^']*'|[^\s"'>]+))?/g;
+function parseAttrs(raw) {
+  const attrs = {};
+  if (!raw) return attrs;
+  ATTR_RE.lastIndex = 0;
+  let m;
+  while ((m = ATTR_RE.exec(raw)) !== null) {
+    const name = m[1].toLowerCase();
+    let value = m[2] ?? "";
+    if (value.length >= 2 && (value[0] === '"' || value[0] === "'")) {
+      value = value.slice(1, -1);
+    }
+    attrs[name] = value;
+  }
+  return attrs;
+}
+function stripNonContent(html) {
+  return html.replace(/<!--[\s\S]*?-->/g, "").replace(/<!\[CDATA\[[\s\S]*?\]\]>/g, "").replace(/<!doctype[^>]*>/gi, "").replace(/<script\b[\s\S]*?<\/script>/gi, "").replace(/<style\b[\s\S]*?<\/style>/gi, "");
+}
+function tokenize(html) {
+  const tokens = [];
+  const clean = stripNonContent(html);
+  TAG_RE.lastIndex = 0;
+  let lastIndex = 0;
+  let m;
+  while ((m = TAG_RE.exec(clean)) !== null) {
+    if (m.index > lastIndex) {
+      tokens.push({ kind: "text", text: clean.slice(lastIndex, m.index) });
+    }
+    lastIndex = TAG_RE.lastIndex;
+    const isClose = m[1] === "/";
+    const name = m[2].toLowerCase();
+    if (isClose) {
+      tokens.push({ kind: "close", name });
+    } else {
+      tokens.push({
+        kind: "open",
+        name,
+        attrs: parseAttrs(m[3]),
+        selfClose: m[4] === "/"
+      });
+    }
+  }
+  if (lastIndex < clean.length) {
+    tokens.push({ kind: "text", text: clean.slice(lastIndex) });
+  }
+  return tokens;
+}
+function parseHtml(html) {
+  const root = { type: "element", name: "#root", attrs: {}, children: [] };
+  const stack = [root];
+  const top = () => stack[stack.length - 1];
+  for (const token of tokenize(html)) {
+    if (token.kind === "text") {
+      if (token.text) top().children.push({ type: "text", value: token.text });
+      continue;
+    }
+    if (token.kind === "open") {
+      const name = token.name;
+      const closes = IMPLIED_CLOSE[name];
+      if (closes) {
+        while (stack.length > 1 && closes.has(top().name)) stack.pop();
+      }
+      const el = {
+        type: "element",
+        name,
+        attrs: token.attrs ?? {},
+        children: []
+      };
+      top().children.push(el);
+      if (!token.selfClose && !VOID_ELEMENTS.has(name)) {
+        stack.push(el);
+      }
+      continue;
+    }
+    for (let i = stack.length - 1; i > 0; i--) {
+      if (stack[i].name === token.name) {
+        stack.length = i;
+        break;
+      }
+    }
+  }
+  return root.children;
+}
+function childElements(el, names) {
+  return el.children.filter((c) => c.type === "element" && names.has(c.name));
+}
+
+// src/parser/html/HtmlTableParser.ts
+var MARK_TAGS = {
+  b: "bold",
+  strong: "bold",
+  i: "italic",
+  em: "italic",
+  sup: "superscript",
+  sub: "subscript",
+  s: "strike",
+  strike: "strike",
+  del: "del",
+  ins: "ins",
+  u: "underline",
+  mark: "highlight",
+  code: "code"
+};
+var SECTION_TAGS = /* @__PURE__ */ new Set(["thead", "tbody", "tfoot"]);
+var ROW_TAGS = /* @__PURE__ */ new Set(["tr"]);
+var CELL_TAGS = /* @__PURE__ */ new Set(["td", "th"]);
+var LI_TAGS = /* @__PURE__ */ new Set(["li"]);
+var VALID_SCOPES = /* @__PURE__ */ new Set(["row", "col", "rowgroup", "colgroup"]);
+var NAMED_ENTITIES = {
+  amp: "&",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'",
+  nbsp: "\xA0"
+};
+function decodeEntities(text) {
+  return text.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z][a-zA-Z0-9]*);/g, (whole, body) => {
+    if (body[0] === "#") {
+      const code = body[1] === "x" || body[1] === "X" ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);
+      if (Number.isFinite(code) && code >= 0 && code <= 1114111) {
+        try {
+          return String.fromCodePoint(code);
+        } catch {
+          return whole;
+        }
+      }
+      return whole;
+    }
+    return NAMED_ENTITIES[body] ?? whole;
+  });
+}
+function intAttr(value) {
+  if (value == null) return void 0;
+  const n = Number.parseInt(value, 10);
+  return Number.isInteger(n) ? n : void 0;
+}
+function isElement(node) {
+  return node.type === "element";
+}
+var HtmlTableParser = class {
+  keepUnknownTags = false;
+  /**
+   * Parse an HTML string and return one table bit per top-level `<table>`.
+   */
+  parse(html, options) {
+    this.keepUnknownTags = options?.keepUnknownTags ?? false;
+    const tableFormat = options?.tableFormat ?? "table-extended";
+    const onWarning = options?.onWarning;
+    const tables = this.collectTopLevelTables(parseHtml(html));
+    const bits = [];
+    for (const table of tables) {
+      const bit = this.tableToBit(table, tableFormat, onWarning);
+      if (bit) bits.push(bit);
+    }
+    return bits;
+  }
+  // --- table extraction -----------------------------------------------------
+  /** Collect every `<table>` element, NOT descending into nested tables. */
+  collectTopLevelTables(nodes) {
+    const tables = [];
+    const visit = (node) => {
+      if (!isElement(node)) return;
+      if (node.name === "table") {
+        tables.push(node);
+        return;
+      }
+      node.children.forEach(visit);
+    };
+    nodes.forEach(visit);
+    return tables;
+  }
+  tableToBit(table, tableFormat, onWarning) {
+    const header = [];
+    const body = [];
+    const footer = [];
+    let caption;
+    for (const child of table.children) {
+      if (!isElement(child)) continue;
+      if (child.name === "caption") {
+        const capContent = this.inlineNodes(child.children, []);
+        const trimmed = this.trimInline(capContent);
+        if (trimmed.length > 0) caption = trimmed;
+      } else if (SECTION_TAGS.has(child.name)) {
+        const target = child.name === "thead" ? header : child.name === "tfoot" ? footer : body;
+        for (const tr of childElements(child, ROW_TAGS)) {
+          target.push(this.rowToCells(tr));
+        }
+      } else if (ROW_TAGS.has(child.name)) {
+        body.push(this.rowToCells(child));
+      }
+    }
+    if (header.length === 0 && body.length === 0 && footer.length === 0) {
+      return void 0;
+    }
+    const tableExtended = {};
+    if (header.length > 0) tableExtended.header = { rows: header };
+    if (body.length > 0) tableExtended.body = { rows: body };
+    if (footer.length > 0) tableExtended.footer = { rows: footer };
+    let tableData = tableExtended;
+    if (tableFormat === "table") {
+      if (this.isLossyAsBasic(tableExtended)) {
+        onWarning?.(
+          "Converting an HTML table to [.table] loses rowspan/colspan/scope and multi-section structure; use --tableFormat table-extended to preserve them."
+        );
+      }
+      tableData = convertExtendedToBasicTableFormat(tableExtended);
+    }
+    const bit = {
+      type: tableFormat,
+      format: "bitmark++",
+      table: tableData
+    };
+    if (caption) bit.caption = caption;
+    return bit;
+  }
+  rowToCells(tr) {
+    const cells = [];
+    for (const cell of childElements(tr, CELL_TAGS)) {
+      cells.push(this.cellToJson(cell));
+    }
+    return { cells };
+  }
+  cellToJson(cell) {
+    const json = {
+      content: this.blockNodes(cell.children)
+    };
+    if (cell.name === "th") json.title = true;
+    const rowspan = intAttr(cell.attrs.rowspan);
+    if (rowspan != null && rowspan >= 2) json.rowspan = rowspan;
+    const colspan = intAttr(cell.attrs.colspan);
+    if (colspan != null && colspan >= 2) json.colspan = colspan;
+    const scope = cell.attrs.scope?.toLowerCase();
+    if (scope && VALID_SCOPES.has(scope)) {
+      json.scope = scope;
+    }
+    const width = this.widthFromCell(cell);
+    if (width != null) json.colwidth = width;
+    return json;
+  }
+  widthFromCell(cell) {
+    const attrWidth = intAttr(cell.attrs.width);
+    if (attrWidth != null && attrWidth > 0) return attrWidth;
+    const style = cell.attrs.style;
+    if (style) {
+      const m = style.match(/width\s*:\s*(\d+)\s*px/i);
+      if (m) {
+        const n = Number.parseInt(m[1], 10);
+        if (Number.isInteger(n) && n > 0) return n;
+      }
+    }
+    return void 0;
+  }
+  isLossyAsBasic(table) {
+    if (table.footer) return true;
+    if (table.header && table.header.rows.length > 1) return true;
+    const sections = [table.header, table.body, table.footer];
+    for (const section of sections) {
+      if (!section) continue;
+      for (const row of section.rows) {
+        for (const cell of row.cells) {
+          if (cell.rowspan || cell.colspan || cell.scope) return true;
+        }
+      }
+    }
+    return false;
+  }
+  // --- content conversion (HTML -> TextAst) ---------------------------------
+  /**
+   * Convert a cell/li's child nodes into block-level TextAst nodes (paragraphs, lists, images).
+   */
+  blockNodes(nodes) {
+    const blocks = [];
+    let inline = [];
+    const flush = () => {
+      const trimmed = this.trimInline(inline);
+      inline = [];
+      if (trimmed.length === 0) return;
+      if (trimmed.length === 1 && trimmed[0].type === "imageInline") {
+        blocks.push({ ...trimmed[0], type: "image" });
+      } else {
+        blocks.push({ type: "paragraph", content: trimmed, attrs: {} });
+      }
+    };
+    for (const node of nodes) {
+      if (!isElement(node)) {
+        inline.push(...this.inlineText(node.value, []));
+        continue;
+      }
+      const name = node.name;
+      if (name === "p") {
+        flush();
+        const content = this.trimInline(this.inlineNodes(node.children, []));
+        if (content.length > 0) {
+          blocks.push({ type: "paragraph", content, attrs: {} });
+        }
+      } else if (this.isListTag(name)) {
+        flush();
+        const list = this.listNode(node);
+        if (list) blocks.push(list);
+      } else {
+        inline.push(...this.inlineFromElement(node, []));
+      }
+    }
+    flush();
+    return blocks;
+  }
+  /** Convert child nodes to a flat list of inline TextNodes, applying the given marks. */
+  inlineNodes(nodes, marks) {
+    const out = [];
+    for (const node of nodes) {
+      if (!isElement(node)) {
+        out.push(...this.inlineText(node.value, marks));
+      } else {
+        out.push(...this.inlineFromElement(node, marks));
+      }
+    }
+    return out;
+  }
+  inlineFromElement(el, marks) {
+    const name = el.name;
+    if (name === "br") {
+      return [{ type: "hardBreak" }];
+    }
+    if (name === "img") {
+      return [this.imageNode(el, true)];
+    }
+    const markType = MARK_TAGS[name];
+    if (markType) {
+      return this.inlineNodes(el.children, [...marks, { type: markType }]);
+    }
+    if (name === "a") {
+      const linkMark = {
+        type: "link",
+        attrs: {
+          href: el.attrs.href ?? "",
+          ...el.attrs.target ? { target: el.attrs.target } : {}
+        }
+      };
+      return this.inlineNodes(el.children, [...marks, linkMark]);
+    }
+    if (this.keepUnknownTags) {
+      const open = this.serializeOpenTag(el);
+      const close = `</${name}>`;
+      return [
+        ...this.inlineText(open, marks),
+        ...this.inlineNodes(el.children, marks),
+        ...this.inlineText(close, marks)
+      ];
+    }
+    return this.inlineNodes(el.children, marks);
+  }
+  inlineText(raw, marks) {
+    const text = decodeEntities(raw).replace(/\s+/g, " ");
+    if (text === "") return [];
+    const node = { text, type: "text" };
+    if (marks.length > 0) node.marks = marks.map((m) => ({ ...m }));
+    return [node];
+  }
+  serializeOpenTag(el) {
+    const attrs = Object.entries(el.attrs).map(([k, v]) => v === "" ? ` ${k}` : ` ${k}="${v}"`).join("");
+    return `<${el.name}${attrs}>`;
+  }
+  // --- lists ----------------------------------------------------------------
+  isListTag(name) {
+    return name === "ul" || name === "ol";
+  }
+  listNode(el) {
+    const items = childElements(el, LI_TAGS);
+    if (items.length === 0) return void 0;
+    const isTask = el.name === "ul" && items.some((li) => {
+      const firstEl = li.children.find(isElement);
+      return firstEl?.name === "input" && firstEl.attrs.type?.toLowerCase() === "checkbox";
+    });
+    if (isTask) {
+      return {
+        type: "taskList",
+        content: items.map((li) => this.taskItemNode(li))
+      };
+    }
+    const type = this.listType(el);
+    const node = {
+      type,
+      content: items.map((li) => this.listItemNode(li))
+    };
+    if (el.name === "ol") {
+      const start = intAttr(el.attrs.start);
+      if (start != null) {
+        node.attrs = { start };
+      }
+    }
+    return node;
+  }
+  listType(el) {
+    if (el.name === "ol") {
+      switch (el.attrs.type) {
+        case "i":
+          return "orderedListRomanLower";
+        case "I":
+          return "orderedListRoman";
+        case "a":
+          return "letteredListLower";
+        case "A":
+          return "letteredList";
+        default:
+          return "orderedList";
+      }
+    }
+    const style = el.attrs.style ?? "";
+    if (/list-style(-type)?\s*:\s*none/i.test(style)) return "noBulletList";
+    return "bulletList";
+  }
+  listItemNode(li) {
+    let content = this.blockNodes(li.children);
+    if (content.length === 0) {
+      content = [{ type: "paragraph", content: [], attrs: {} }];
+    }
+    return { type: "listItem", content };
+  }
+  taskItemNode(li) {
+    const checkbox = li.children.find(
+      (c) => isElement(c) && c.name === "input" && c.attrs.type?.toLowerCase() === "checkbox"
+    );
+    const checked = checkbox ? "checked" in checkbox.attrs : false;
+    const rest = li.children.filter((c) => c !== checkbox);
+    let content = this.blockNodes(rest);
+    if (content.length === 0) {
+      content = [{ type: "paragraph", content: [], attrs: {} }];
+    }
+    return { type: "taskItem", attrs: { checked }, content };
+  }
+  // --- images ---------------------------------------------------------------
+  imageNode(el, inline) {
+    const attrs = { src: el.attrs.src ?? "" };
+    attrs.alt = el.attrs.alt ?? null;
+    attrs.title = el.attrs.title ?? null;
+    const width = intAttr(el.attrs.width);
+    if (width != null) attrs.width = width;
+    const height = intAttr(el.attrs.height);
+    if (height != null) attrs.height = height;
+    if (el.attrs.class) attrs.class = el.attrs.class;
+    return { type: inline ? "imageInline" : "image", attrs };
+  }
+  // --- whitespace -----------------------------------------------------------
+  /** Trim leading/trailing whitespace from inline content (edges only). */
+  trimInline(nodes) {
+    const out = nodes.slice();
+    const isWs = (n) => n.type === "text" && /^\s*$/.test(n.text ?? "");
+    while (out.length > 0 && isWs(out[0])) out.shift();
+    if (out.length > 0 && out[0].type === "text") {
+      out[0] = { ...out[0], text: (out[0].text ?? "").replace(/^\s+/, "") };
+    }
+    while (out.length > 0 && isWs(out[out.length - 1])) out.pop();
+    if (out.length > 0 && out[out.length - 1].type === "text") {
+      const last = out.length - 1;
+      out[last] = { ...out[last], text: (out[last].text ?? "").replace(/\s+$/, "") };
+    }
+    return out.filter((n) => !(n.type === "text" && n.text === ""));
+  }
+};
 var StreamWriter = class {
   _stream;
   endOfLineString = os.EOL;
@@ -42145,248 +43096,21 @@ var BitmarkFileGenerator = class {
   /**
    * Generate bitmark markup from bitmark AST as a file
    *
-   * @param ast bitmark AST
-   */
-  async generate(ast) {
-    return this.generator.generate(ast);
-  }
-  /**
-   * Generate bitmark markup from bitmark AST as a file synchronously
-   *
-   * @param ast bitmark AST
-   */
-  generateSync(_ast) {
-    if (this.async) {
-      throw new Error("Sync operation not supported");
-    }
-    this.generator.generateSync(_ast);
-  }
-};
-
-// src/generator/html/HtmlTableGenerator.ts
-var MARK_TO_TAG = {
-  bold: "b",
-  italic: "i",
-  superscript: "sup",
-  subscript: "sub",
-  strike: "s",
-  del: "del",
-  ins: "ins",
-  underline: "u",
-  highlight: "mark",
-  code: "code"
-};
-var HtmlTableGenerator = class {
-  indentUnit = "  ";
-  /**
-   * Generate HTML table fragments from a string or JSON value.
-   * @returns the concatenated `<table>` fragments, blank-line separated (empty string if none).
-   */
-  generate(input) {
-    let data = input;
-    if (typeof data === "string") {
-      try {
-        data = JSON.parse(data);
-      } catch {
-        return "";
-      }
-    }
-    const bits = this.collectBits(data);
-    const fragments = [];
-    for (const bit of bits) {
-      const html = this.renderTableBit(bit);
-      if (html) fragments.push(html);
-    }
-    return fragments.join("\n\n");
-  }
-  // --- bit collection -------------------------------------------------------
-  collectBits(data) {
-    const out = [];
-    const visit = (value) => {
-      if (value == null || typeof value !== "object") return;
-      if (Array.isArray(value)) {
-        value.forEach(visit);
-        return;
-      }
-      const obj = value;
-      if ("bit" in obj && obj.bit && typeof obj.bit === "object") {
-        out.push(obj.bit);
-      } else if ("type" in obj) {
-        out.push(obj);
-      }
-    };
-    visit(data);
-    return out;
-  }
-  // --- table rendering ------------------------------------------------------
-  renderTableBit(bit) {
-    const table = bit.table;
-    if (!table) return "";
-    if (bit.type !== "table" && bit.type !== "table-extended") return "";
-    const extended = this.toExtended(table);
-    const lines = [];
-    lines.push("<table>");
-    if (bit.caption != null) {
-      const caption = this.cellContentToHtml(this.asTextAst(bit.caption));
-      if (caption) lines.push(`${this.indentUnit}<caption>${caption}</caption>`);
-    }
-    this.renderSection(lines, "thead", extended.header, "header");
-    this.renderSection(lines, "tbody", extended.body, "body");
-    this.renderSection(lines, "tfoot", extended.footer, "footer");
-    lines.push("</table>");
-    return lines.join("\n");
-  }
-  toExtended(table) {
-    const t = table;
-    if (t.header || t.body || t.footer) return table;
-    return convertBasicToExtendedTableFormat(table);
-  }
-  renderSection(lines, tag, section, key) {
-    if (!section || !section.rows || section.rows.length === 0) return;
-    lines.push(`${this.indentUnit}<${tag}>`);
-    for (const row of section.rows) {
-      lines.push(`${this.indentUnit.repeat(2)}<tr>`);
-      for (const cell of row.cells ?? []) {
-        lines.push(`${this.indentUnit.repeat(3)}${this.renderCell(cell, key)}`);
-      }
-      lines.push(`${this.indentUnit.repeat(2)}</tr>`);
-    }
-    lines.push(`${this.indentUnit}</${tag}>`);
-  }
-  renderCell(cell, _key) {
-    const tag = cell.title === true ? "th" : "td";
-    const attrs = [];
-    if (cell.rowspan && cell.rowspan > 1) attrs.push(`rowspan="${cell.rowspan}"`);
-    if (cell.colspan && cell.colspan > 1) attrs.push(`colspan="${cell.colspan}"`);
-    if (cell.scope) attrs.push(`scope="${cell.scope}"`);
-    if (cell.colwidth && cell.colwidth > 0) attrs.push(`width="${cell.colwidth}"`);
-    const open = attrs.length > 0 ? `<${tag} ${attrs.join(" ")}>` : `<${tag}>`;
-    return `${open}${this.cellContentToHtml(this.asTextAst(cell.content))}</${tag}>`;
-  }
-  // --- cell content (TextAst -> HTML) ---------------------------------------
-  asTextAst(content) {
-    if (content == null) return [];
-    if (typeof content === "string") return [{ type: "text", text: content }];
-    return content;
-  }
-  cellContentToHtml(blocks) {
-    if (blocks.length === 0) return "";
-    if (blocks.length === 1 && blocks[0].type === "paragraph") {
-      return this.inlineToHtml(blocks[0].content ?? []);
-    }
-    return blocks.map((b) => this.blockToHtml(b)).join("");
-  }
-  blockToHtml(node) {
-    switch (node.type) {
-      case "paragraph":
-        return `<p>${this.inlineToHtml(node.content ?? [])}</p>`;
-      case "bulletList":
-      case "noBulletList":
-      case "orderedList":
-      case "orderedListRoman":
-      case "orderedListRomanLower":
-      case "letteredList":
-      case "letteredListLower":
-      case "taskList":
-        return this.listToHtml(node);
-      case "image":
-      case "imageInline":
-        return this.imageToHtml(node);
-      default:
-        return this.inlineToHtml([node]);
-    }
-  }
-  inlineToHtml(nodes) {
-    return nodes.map((n) => this.inlineNodeToHtml(n)).join("");
-  }
-  inlineNodeToHtml(node) {
-    if (node.type === "hardBreak") return "<br>";
-    if (node.type === "image" || node.type === "imageInline") return this.imageToHtml(node);
-    if (node.type === "text") {
-      return this.wrapMarks(this.escapeText(node.text ?? ""), node.marks);
-    }
-    if (node.content) return this.inlineToHtml(node.content);
-    return this.escapeText(node.text ?? "");
-  }
-  wrapMarks(text, marks) {
-    if (!marks || marks.length === 0) return text;
-    let open = "";
-    let close = "";
-    for (const mark of marks) {
-      if (mark.type === "link") {
-        const href = mark.attrs?.href ?? "";
-        open += `<a href="${this.escapeAttr(href)}">`;
-        close = `</a>${close}`;
-      } else {
-        const tag = MARK_TO_TAG[mark.type];
-        if (tag) {
-          open += `<${tag}>`;
-          close = `</${tag}>${close}`;
-        }
-      }
-    }
-    return `${open}${text}${close}`;
-  }
-  // --- lists ----------------------------------------------------------------
-  listToHtml(node) {
-    const { tag, attrs } = this.listTag(node);
-    const items = (node.content ?? []).map((item) => this.listItemToHtml(item, node.type === "taskList")).join("");
-    return `<${tag}${attrs}>${items}</${tag}>`;
-  }
-  listTag(node) {
-    const start = node.attrs?.start;
-    const startAttr = typeof start === "number" && start !== 1 ? ` start="${start}"` : "";
-    switch (node.type) {
-      case "orderedList":
-        return { tag: "ol", attrs: startAttr };
-      case "orderedListRoman":
-        return { tag: "ol", attrs: ` type="I"${startAttr}` };
-      case "orderedListRomanLower":
-        return { tag: "ol", attrs: ` type="i"${startAttr}` };
-      case "letteredList":
-        return { tag: "ol", attrs: ` type="A"${startAttr}` };
-      case "letteredListLower":
-        return { tag: "ol", attrs: ` type="a"${startAttr}` };
-      case "noBulletList":
-        return { tag: "ul", attrs: ' style="list-style:none"' };
-      case "taskList":
-      case "bulletList":
-      default:
-        return { tag: "ul", attrs: "" };
-    }
-  }
-  listItemToHtml(item, task) {
-    const inner = (item.content ?? []).map((b) => {
-      if (b.type === "paragraph") return this.inlineToHtml(b.content ?? []);
-      return this.blockToHtml(b);
-    }).join("");
-    if (task) {
-      const checked = item.attrs?.checked ? " checked" : "";
-      return `<li><input type="checkbox"${checked}>${inner}</li>`;
-    }
-    return `<li>${inner}</li>`;
-  }
-  // --- images ---------------------------------------------------------------
-  imageToHtml(node) {
-    const attrs = node.attrs ?? {};
-    const parts = [];
-    const src = attrs.src;
-    parts.push(`src="${this.escapeAttr(typeof src === "string" ? src : "")}"`);
-    if (typeof attrs.alt === "string") parts.push(`alt="${this.escapeAttr(attrs.alt)}"`);
-    if (typeof attrs.title === "string") parts.push(`title="${this.escapeAttr(attrs.title)}"`);
-    if (attrs.width != null) parts.push(`width="${attrs.width}"`);
-    if (attrs.height != null) parts.push(`height="${attrs.height}"`);
-    if (typeof attrs.class === "string" && attrs.class) {
-      parts.push(`class="${this.escapeAttr(attrs.class)}"`);
-    }
-    return `<img ${parts.join(" ")}>`;
-  }
-  // --- escaping -------------------------------------------------------------
-  escapeText(text) {
-    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+   * @param ast bitmark AST
+   */
+  async generate(ast) {
+    return this.generator.generate(ast);
   }
-  escapeAttr(text) {
-    return this.escapeText(text).replace(/"/g, "&quot;");
+  /**
+   * Generate bitmark markup from bitmark AST as a file synchronously
+   *
+   * @param ast bitmark AST
+   */
+  generateSync(_ast) {
+    if (this.async) {
+      throw new Error("Sync operation not supported");
+    }
+    this.generator.generateSync(_ast);
   }
 };
 var JsonFileGenerator = class {
@@ -42805,6 +43529,7 @@ var ConfigBuilder = class {
         k = stringUtils.camelToKebab(k);
         const resolvedGroups = resolveGroupReferences(k);
         const hasOuterExport = Object.prototype.hasOwnProperty.call(tag, "exportJsonKey");
+        const hasOuterHtml = Object.prototype.hasOwnProperty.call(tag, "htmlKey");
         if (!hasOuterExport && tag.jsonKey != null) {
           const headingPath = [...pathStack, `tags.${tag.key}`].join(" / ");
           exportJsonKeyErrors.push(
@@ -42814,6 +43539,8 @@ var ConfigBuilder = class {
         for (const ref of resolvedGroups) {
           const exportJsonKeyChosen = hasOuterExport ? tag.exportJsonKey : ref.exportJsonKey;
           const hasExportChosen = hasOuterExport || !!ref.hasExportJsonKey;
+          const htmlKeyChosen = hasOuterHtml ? tag.htmlKey : ref.htmlKey;
+          const hasHtmlChosen = hasOuterHtml || !!ref.hasHtmlKey;
           const min = tag.minCount != null ? tag.minCount : ref.min;
           const max = tag.maxCount != null ? tag.maxCount : ref.max;
           const description = tag.description ? tag.description : ref.description;
@@ -42821,6 +43548,7 @@ var ConfigBuilder = class {
             type: "group",
             key: ref.key,
             ...hasExportChosen ? { jsonKey: exportJsonKeyChosen } : {},
+            ...hasHtmlChosen ? { htmlKey: htmlKeyChosen } : {},
             ...min != null ? { min } : {},
             ...max != null ? { max } : {},
             ...description ? { description } : {}
@@ -42849,10 +43577,13 @@ var ConfigBuilder = class {
         );
         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,
         ...tag.nullable ? { nullable: true } : {},
@@ -42875,6 +43606,13 @@ var ConfigBuilder = class {
       );
       return {};
     };
+    const cardHtmlKeyField = (container, htmlExportKey) => {
+      const c = container;
+      if (Object.prototype.hasOwnProperty.call(c, htmlExportKey)) {
+        return { htmlKey: c[htmlExportKey] };
+      }
+      return {};
+    };
     const serializeCardSet = (cardSetKey) => {
       const variantBodyFormat = (variant) => variant.format ?? TextFormat.bitmarkText;
       const cardSetConfig = CARDSETS[cardSetKey];
@@ -42905,6 +43643,7 @@ var ConfigBuilder = class {
           }
           return {
             ...cardJsonKeyField(variant, "jsonKey", "exportJsonKey", variantPath),
+            ...cardHtmlKeyField(variant, "htmlKey"),
             format: variantBodyFormat(variant),
             tags: variantTags,
             repeatCount: variant.repeatCount ?? 1,
@@ -42916,6 +43655,7 @@ var ConfigBuilder = class {
           name: side.name,
           ...side.repeat ? { repeat: side.repeat } : {},
           ...cardJsonKeyField(side, "jsonKey", "exportJsonKey", sidePath),
+          ...cardHtmlKeyField(side, "htmlKey"),
           variants
         };
       });
@@ -42923,20 +43663,23 @@ var ConfigBuilder = class {
         const cards = Object.entries(cardSetConfig.sections).map(([sectionName, section]) => {
           const sectionPath = `cardSets.${normalizedKey} / cards.${sectionName}`;
           const hasSideExport = Object.prototype.hasOwnProperty.call(section, "sideExportJsonKey");
+          const hasSideHtml = Object.prototype.hasOwnProperty.call(section, "sideHtmlKey");
           let cardSides = sides;
-          if (hasSideExport || section.sideJsonKey != null) {
+          if (hasSideExport || section.sideJsonKey != null || hasSideHtml) {
             const sideOverride = cardJsonKeyField(
               section,
               "sideJsonKey",
               "sideExportJsonKey",
               `${sectionPath} / sides.*`
             );
-            cardSides = sides.map((s) => ({ ...s, ...sideOverride }));
+            const sideHtmlOverride = cardHtmlKeyField(section, "sideHtmlKey");
+            cardSides = sides.map((s) => ({ ...s, ...sideOverride, ...sideHtmlOverride }));
           }
           return {
             name: sectionName,
             ...section.isDefault ? { isDefault: true } : {},
             ...cardJsonKeyField(section, "jsonKey", "exportJsonKey", sectionPath),
+            ...cardHtmlKeyField(section, "htmlKey"),
             // 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 } : {},
@@ -42944,7 +43687,7 @@ var ConfigBuilder = class {
             sides: cardSides
           };
         });
-        return { name: normalizedKey, cards };
+        return { name: normalizedKey, ...cardHtmlKeyField(cardSetConfig, "htmlKey"), cards };
       }
       const cardSetPath = `cardSets.${normalizedKey} / cards.default`;
       return {
@@ -42954,6 +43697,7 @@ var ConfigBuilder = class {
             name: "default",
             isDefault: true,
             ...cardJsonKeyField(cardSetConfig, "jsonKey", "exportJsonKey", cardSetPath),
+            ...cardHtmlKeyField(cardSetConfig, "htmlKey"),
             sides
           }
         ]
@@ -42993,6 +43737,10 @@ var ConfigBuilder = class {
             ref.exportJsonKey = t.jsonKey;
             ref.hasExportJsonKey = true;
           }
+          if (Object.prototype.hasOwnProperty.call(t, "htmlKey")) {
+            ref.htmlKey = t.htmlKey;
+            ref.hasHtmlKey = true;
+          }
           replacements.push(ref);
         }
         squashedGroups.set(groupKey, replacements);
@@ -43027,6 +43775,7 @@ var ConfigBuilder = class {
             type: "group",
             key: ref.key,
             ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+            ...ref.hasHtmlKey ? { htmlKey: ref.htmlKey } : {},
             ...ref.min != null ? { min: ref.min } : {},
             ...ref.max != null ? { max: ref.max } : {},
             ...ref.description ? { description: ref.description } : {}
@@ -43040,6 +43789,7 @@ var ConfigBuilder = class {
               type: "group",
               key: ref.key,
               ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+              ...ref.hasHtmlKey ? { htmlKey: ref.htmlKey } : {},
               ...ref.min != null ? { min: ref.min } : {},
               ...ref.max != null ? { max: ref.max } : {},
               ...ref.description ? { description: ref.description } : {}
@@ -43169,6 +43919,7 @@ var ConfigBuilder = class {
               type: "group",
               key: ref.key,
               ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+              ...ref.hasHtmlKey ? { htmlKey: ref.htmlKey } : {},
               ...ref.min != null ? { min: ref.min } : {},
               ...ref.max != null ? { max: ref.max } : {},
               ...ref.description ? { description: ref.description } : {}
@@ -43358,497 +44109,6 @@ var ConfigBuilder = class {
   }
 };
 
-// src/parser/html/HtmlDom.ts
-var VOID_ELEMENTS = /* @__PURE__ */ new Set([
-  "area",
-  "base",
-  "br",
-  "col",
-  "embed",
-  "hr",
-  "img",
-  "input",
-  "link",
-  "meta",
-  "param",
-  "source",
-  "track",
-  "wbr"
-]);
-var IMPLIED_CLOSE = {
-  li: /* @__PURE__ */ new Set(["li"]),
-  td: /* @__PURE__ */ new Set(["td", "th"]),
-  th: /* @__PURE__ */ new Set(["td", "th"]),
-  tr: /* @__PURE__ */ new Set(["td", "th", "tr"]),
-  thead: /* @__PURE__ */ new Set(["td", "th", "tr", "thead", "tbody", "tfoot"]),
-  tbody: /* @__PURE__ */ new Set(["td", "th", "tr", "thead", "tbody", "tfoot"]),
-  tfoot: /* @__PURE__ */ new Set(["td", "th", "tr", "thead", "tbody", "tfoot"]),
-  p: /* @__PURE__ */ new Set(["p"]),
-  option: /* @__PURE__ */ new Set(["option"])
-};
-var TAG_RE = /<(\/)?([a-zA-Z][a-zA-Z0-9-]*)((?:\s+(?:"[^"]*"|'[^']*'|[^<>"'])*)?)(\/)?>/g;
-var ATTR_RE = /([a-zA-Z_:][a-zA-Z0-9:._-]*)(?:\s*=\s*("[^"]*"|'[^']*'|[^\s"'>]+))?/g;
-function parseAttrs(raw) {
-  const attrs = {};
-  if (!raw) return attrs;
-  ATTR_RE.lastIndex = 0;
-  let m;
-  while ((m = ATTR_RE.exec(raw)) !== null) {
-    const name = m[1].toLowerCase();
-    let value = m[2] ?? "";
-    if (value.length >= 2 && (value[0] === '"' || value[0] === "'")) {
-      value = value.slice(1, -1);
-    }
-    attrs[name] = value;
-  }
-  return attrs;
-}
-function stripNonContent(html) {
-  return html.replace(/<!--[\s\S]*?-->/g, "").replace(/<!\[CDATA\[[\s\S]*?\]\]>/g, "").replace(/<!doctype[^>]*>/gi, "").replace(/<script\b[\s\S]*?<\/script>/gi, "").replace(/<style\b[\s\S]*?<\/style>/gi, "");
-}
-function tokenize(html) {
-  const tokens = [];
-  const clean = stripNonContent(html);
-  TAG_RE.lastIndex = 0;
-  let lastIndex = 0;
-  let m;
-  while ((m = TAG_RE.exec(clean)) !== null) {
-    if (m.index > lastIndex) {
-      tokens.push({ kind: "text", text: clean.slice(lastIndex, m.index) });
-    }
-    lastIndex = TAG_RE.lastIndex;
-    const isClose = m[1] === "/";
-    const name = m[2].toLowerCase();
-    if (isClose) {
-      tokens.push({ kind: "close", name });
-    } else {
-      tokens.push({
-        kind: "open",
-        name,
-        attrs: parseAttrs(m[3]),
-        selfClose: m[4] === "/"
-      });
-    }
-  }
-  if (lastIndex < clean.length) {
-    tokens.push({ kind: "text", text: clean.slice(lastIndex) });
-  }
-  return tokens;
-}
-function parseHtml(html) {
-  const root = { type: "element", name: "#root", attrs: {}, children: [] };
-  const stack = [root];
-  const top = () => stack[stack.length - 1];
-  for (const token of tokenize(html)) {
-    if (token.kind === "text") {
-      if (token.text) top().children.push({ type: "text", value: token.text });
-      continue;
-    }
-    if (token.kind === "open") {
-      const name = token.name;
-      const closes = IMPLIED_CLOSE[name];
-      if (closes) {
-        while (stack.length > 1 && closes.has(top().name)) stack.pop();
-      }
-      const el = {
-        type: "element",
-        name,
-        attrs: token.attrs ?? {},
-        children: []
-      };
-      top().children.push(el);
-      if (!token.selfClose && !VOID_ELEMENTS.has(name)) {
-        stack.push(el);
-      }
-      continue;
-    }
-    for (let i = stack.length - 1; i > 0; i--) {
-      if (stack[i].name === token.name) {
-        stack.length = i;
-        break;
-      }
-    }
-  }
-  return root.children;
-}
-function childElements(el, names) {
-  return el.children.filter((c) => c.type === "element" && names.has(c.name));
-}
-
-// src/parser/html/HtmlTableParser.ts
-var MARK_TAGS = {
-  b: "bold",
-  strong: "bold",
-  i: "italic",
-  em: "italic",
-  sup: "superscript",
-  sub: "subscript",
-  s: "strike",
-  strike: "strike",
-  del: "del",
-  ins: "ins",
-  u: "underline",
-  mark: "highlight",
-  code: "code"
-};
-var SECTION_TAGS = /* @__PURE__ */ new Set(["thead", "tbody", "tfoot"]);
-var ROW_TAGS = /* @__PURE__ */ new Set(["tr"]);
-var CELL_TAGS = /* @__PURE__ */ new Set(["td", "th"]);
-var LI_TAGS = /* @__PURE__ */ new Set(["li"]);
-var VALID_SCOPES = /* @__PURE__ */ new Set(["row", "col", "rowgroup", "colgroup"]);
-var NAMED_ENTITIES = {
-  amp: "&",
-  lt: "<",
-  gt: ">",
-  quot: '"',
-  apos: "'",
-  nbsp: "\xA0"
-};
-function decodeEntities(text) {
-  return text.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z][a-zA-Z0-9]*);/g, (whole, body) => {
-    if (body[0] === "#") {
-      const code = body[1] === "x" || body[1] === "X" ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);
-      if (Number.isFinite(code) && code >= 0 && code <= 1114111) {
-        try {
-          return String.fromCodePoint(code);
-        } catch {
-          return whole;
-        }
-      }
-      return whole;
-    }
-    return NAMED_ENTITIES[body] ?? whole;
-  });
-}
-function intAttr(value) {
-  if (value == null) return void 0;
-  const n = Number.parseInt(value, 10);
-  return Number.isInteger(n) ? n : void 0;
-}
-function isElement(node) {
-  return node.type === "element";
-}
-var HtmlTableParser = class {
-  keepUnknownTags = false;
-  /**
-   * Parse an HTML string and return one table bit per top-level `<table>`.
-   */
-  parse(html, options) {
-    this.keepUnknownTags = options?.keepUnknownTags ?? false;
-    const tableFormat = options?.tableFormat ?? "table-extended";
-    const onWarning = options?.onWarning;
-    const tables = this.collectTopLevelTables(parseHtml(html));
-    const bits = [];
-    for (const table of tables) {
-      const bit = this.tableToBit(table, tableFormat, onWarning);
-      if (bit) bits.push(bit);
-    }
-    return bits;
-  }
-  // --- table extraction -----------------------------------------------------
-  /** Collect every `<table>` element, NOT descending into nested tables. */
-  collectTopLevelTables(nodes) {
-    const tables = [];
-    const visit = (node) => {
-      if (!isElement(node)) return;
-      if (node.name === "table") {
-        tables.push(node);
-        return;
-      }
-      node.children.forEach(visit);
-    };
-    nodes.forEach(visit);
-    return tables;
-  }
-  tableToBit(table, tableFormat, onWarning) {
-    const header = [];
-    const body = [];
-    const footer = [];
-    let caption;
-    for (const child of table.children) {
-      if (!isElement(child)) continue;
-      if (child.name === "caption") {
-        const capContent = this.inlineNodes(child.children, []);
-        const trimmed = this.trimInline(capContent);
-        if (trimmed.length > 0) caption = trimmed;
-      } else if (SECTION_TAGS.has(child.name)) {
-        const target = child.name === "thead" ? header : child.name === "tfoot" ? footer : body;
-        for (const tr of childElements(child, ROW_TAGS)) {
-          target.push(this.rowToCells(tr));
-        }
-      } else if (ROW_TAGS.has(child.name)) {
-        body.push(this.rowToCells(child));
-      }
-    }
-    if (header.length === 0 && body.length === 0 && footer.length === 0) {
-      return void 0;
-    }
-    const tableExtended = {};
-    if (header.length > 0) tableExtended.header = { rows: header };
-    if (body.length > 0) tableExtended.body = { rows: body };
-    if (footer.length > 0) tableExtended.footer = { rows: footer };
-    let tableData = tableExtended;
-    if (tableFormat === "table") {
-      if (this.isLossyAsBasic(tableExtended)) {
-        onWarning?.(
-          "Converting an HTML table to [.table] loses rowspan/colspan/scope and multi-section structure; use --tableFormat table-extended to preserve them."
-        );
-      }
-      tableData = convertExtendedToBasicTableFormat(tableExtended);
-    }
-    const bit = {
-      type: tableFormat,
-      format: "bitmark++",
-      table: tableData
-    };
-    if (caption) bit.caption = caption;
-    return bit;
-  }
-  rowToCells(tr) {
-    const cells = [];
-    for (const cell of childElements(tr, CELL_TAGS)) {
-      cells.push(this.cellToJson(cell));
-    }
-    return { cells };
-  }
-  cellToJson(cell) {
-    const json = {
-      content: this.blockNodes(cell.children)
-    };
-    if (cell.name === "th") json.title = true;
-    const rowspan = intAttr(cell.attrs.rowspan);
-    if (rowspan != null && rowspan >= 2) json.rowspan = rowspan;
-    const colspan = intAttr(cell.attrs.colspan);
-    if (colspan != null && colspan >= 2) json.colspan = colspan;
-    const scope = cell.attrs.scope?.toLowerCase();
-    if (scope && VALID_SCOPES.has(scope)) {
-      json.scope = scope;
-    }
-    const width = this.widthFromCell(cell);
-    if (width != null) json.colwidth = width;
-    return json;
-  }
-  widthFromCell(cell) {
-    const attrWidth = intAttr(cell.attrs.width);
-    if (attrWidth != null && attrWidth > 0) return attrWidth;
-    const style = cell.attrs.style;
-    if (style) {
-      const m = style.match(/width\s*:\s*(\d+)\s*px/i);
-      if (m) {
-        const n = Number.parseInt(m[1], 10);
-        if (Number.isInteger(n) && n > 0) return n;
-      }
-    }
-    return void 0;
-  }
-  isLossyAsBasic(table) {
-    if (table.footer) return true;
-    if (table.header && table.header.rows.length > 1) return true;
-    const sections = [table.header, table.body, table.footer];
-    for (const section of sections) {
-      if (!section) continue;
-      for (const row of section.rows) {
-        for (const cell of row.cells) {
-          if (cell.rowspan || cell.colspan || cell.scope) return true;
-        }
-      }
-    }
-    return false;
-  }
-  // --- content conversion (HTML -> TextAst) ---------------------------------
-  /**
-   * Convert a cell/li's child nodes into block-level TextAst nodes (paragraphs, lists, images).
-   */
-  blockNodes(nodes) {
-    const blocks = [];
-    let inline = [];
-    const flush = () => {
-      const trimmed = this.trimInline(inline);
-      inline = [];
-      if (trimmed.length === 0) return;
-      if (trimmed.length === 1 && trimmed[0].type === "imageInline") {
-        blocks.push({ ...trimmed[0], type: "image" });
-      } else {
-        blocks.push({ type: "paragraph", content: trimmed, attrs: {} });
-      }
-    };
-    for (const node of nodes) {
-      if (!isElement(node)) {
-        inline.push(...this.inlineText(node.value, []));
-        continue;
-      }
-      const name = node.name;
-      if (name === "p") {
-        flush();
-        const content = this.trimInline(this.inlineNodes(node.children, []));
-        if (content.length > 0) {
-          blocks.push({ type: "paragraph", content, attrs: {} });
-        }
-      } else if (this.isListTag(name)) {
-        flush();
-        const list = this.listNode(node);
-        if (list) blocks.push(list);
-      } else {
-        inline.push(...this.inlineFromElement(node, []));
-      }
-    }
-    flush();
-    return blocks;
-  }
-  /** Convert child nodes to a flat list of inline TextNodes, applying the given marks. */
-  inlineNodes(nodes, marks) {
-    const out = [];
-    for (const node of nodes) {
-      if (!isElement(node)) {
-        out.push(...this.inlineText(node.value, marks));
-      } else {
-        out.push(...this.inlineFromElement(node, marks));
-      }
-    }
-    return out;
-  }
-  inlineFromElement(el, marks) {
-    const name = el.name;
-    if (name === "br") {
-      return [{ type: "hardBreak" }];
-    }
-    if (name === "img") {
-      return [this.imageNode(el, true)];
-    }
-    const markType = MARK_TAGS[name];
-    if (markType) {
-      return this.inlineNodes(el.children, [...marks, { type: markType }]);
-    }
-    if (name === "a") {
-      const linkMark = {
-        type: "link",
-        attrs: {
-          href: el.attrs.href ?? "",
-          ...el.attrs.target ? { target: el.attrs.target } : {}
-        }
-      };
-      return this.inlineNodes(el.children, [...marks, linkMark]);
-    }
-    if (this.keepUnknownTags) {
-      const open = this.serializeOpenTag(el);
-      const close = `</${name}>`;
-      return [
-        ...this.inlineText(open, marks),
-        ...this.inlineNodes(el.children, marks),
-        ...this.inlineText(close, marks)
-      ];
-    }
-    return this.inlineNodes(el.children, marks);
-  }
-  inlineText(raw, marks) {
-    const text = decodeEntities(raw).replace(/\s+/g, " ");
-    if (text === "") return [];
-    const node = { text, type: "text" };
-    if (marks.length > 0) node.marks = marks.map((m) => ({ ...m }));
-    return [node];
-  }
-  serializeOpenTag(el) {
-    const attrs = Object.entries(el.attrs).map(([k, v]) => v === "" ? ` ${k}` : ` ${k}="${v}"`).join("");
-    return `<${el.name}${attrs}>`;
-  }
-  // --- lists ----------------------------------------------------------------
-  isListTag(name) {
-    return name === "ul" || name === "ol";
-  }
-  listNode(el) {
-    const items = childElements(el, LI_TAGS);
-    if (items.length === 0) return void 0;
-    const isTask = el.name === "ul" && items.some((li) => {
-      const firstEl = li.children.find(isElement);
-      return firstEl?.name === "input" && firstEl.attrs.type?.toLowerCase() === "checkbox";
-    });
-    if (isTask) {
-      return {
-        type: "taskList",
-        content: items.map((li) => this.taskItemNode(li))
-      };
-    }
-    const type = this.listType(el);
-    const node = {
-      type,
-      content: items.map((li) => this.listItemNode(li))
-    };
-    if (el.name === "ol") {
-      const start = intAttr(el.attrs.start);
-      if (start != null) {
-        node.attrs = { start };
-      }
-    }
-    return node;
-  }
-  listType(el) {
-    if (el.name === "ol") {
-      switch (el.attrs.type) {
-        case "i":
-          return "orderedListRomanLower";
-        case "I":
-          return "orderedListRoman";
-        case "a":
-          return "letteredListLower";
-        case "A":
-          return "letteredList";
-        default:
-          return "orderedList";
-      }
-    }
-    const style = el.attrs.style ?? "";
-    if (/list-style(-type)?\s*:\s*none/i.test(style)) return "noBulletList";
-    return "bulletList";
-  }
-  listItemNode(li) {
-    let content = this.blockNodes(li.children);
-    if (content.length === 0) {
-      content = [{ type: "paragraph", content: [], attrs: {} }];
-    }
-    return { type: "listItem", content };
-  }
-  taskItemNode(li) {
-    const checkbox = li.children.find(
-      (c) => isElement(c) && c.name === "input" && c.attrs.type?.toLowerCase() === "checkbox"
-    );
-    const checked = checkbox ? "checked" in checkbox.attrs : false;
-    const rest = li.children.filter((c) => c !== checkbox);
-    let content = this.blockNodes(rest);
-    if (content.length === 0) {
-      content = [{ type: "paragraph", content: [], attrs: {} }];
-    }
-    return { type: "taskItem", attrs: { checked }, content };
-  }
-  // --- images ---------------------------------------------------------------
-  imageNode(el, inline) {
-    const attrs = { src: el.attrs.src ?? "" };
-    attrs.alt = el.attrs.alt ?? null;
-    attrs.title = el.attrs.title ?? null;
-    const width = intAttr(el.attrs.width);
-    if (width != null) attrs.width = width;
-    const height = intAttr(el.attrs.height);
-    if (height != null) attrs.height = height;
-    if (el.attrs.class) attrs.class = el.attrs.class;
-    return { type: inline ? "imageInline" : "image", attrs };
-  }
-  // --- whitespace -----------------------------------------------------------
-  /** Trim leading/trailing whitespace from inline content (edges only). */
-  trimInline(nodes) {
-    const out = nodes.slice();
-    const isWs = (n) => n.type === "text" && /^\s*$/.test(n.text ?? "");
-    while (out.length > 0 && isWs(out[0])) out.shift();
-    if (out.length > 0 && out[0].type === "text") {
-      out[0] = { ...out[0], text: (out[0].text ?? "").replace(/^\s+/, "") };
-    }
-    while (out.length > 0 && isWs(out[out.length - 1])) out.pop();
-    if (out.length > 0 && out[out.length - 1].type === "text") {
-      const last = out.length - 1;
-      out[last] = { ...out[last], text: (out[last].text ?? "").replace(/\s+$/, "") };
-    }
-    return out.filter((n) => !(n.type === "text" && n.text === ""));
-  }
-};
-
 // src/BitmarkParserGenerator.ts
 var Input = {
   /**