@gmb/bitmark-parser-generator 5.26.0 → 5.28.0

package/dist/browser/cjs/index.cjs

@@ -34,8 +34,8 @@ __export(index_exports, {
   BoundingBoxIndex: () => BoundingBoxIndex,
   Builder: () => Builder,
   CardSetVersion: () => CardSetVersion,
-  HtmlTableGenerator: () => HtmlTableGenerator2,
-  HtmlTableParser: () => HtmlTableParser2,
+  HtmlTableGenerator: () => HtmlTableGenerator,
+  HtmlTableParser: () => HtmlTableParser,
   InfoFormat: () => InfoFormat,
   InfoType: () => InfoType,
   Input: () => Input,
@@ -596,6 +596,14 @@ var BitType2 = {
   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",
@@ -604,6 +612,14 @@ var BitType2 = {
   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",
@@ -626,10 +642,18 @@ var BitType2 = {
   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",
@@ -856,6 +880,10 @@ var AbstractTagConfig = class {
     // New JSON-pattern jsonKey (export-only)
     __publicField(this, "hasExportJsonKey");
     // True iff exportJsonKey was explicitly set
+    __publicField(this, "htmlKey");
+    // HTML key-pattern (export-only)
+    __publicField(this, "hasHtmlKey");
+    // True iff htmlKey was explicitly set
     __publicField(this, "deprecated");
     this.type = params.type;
     this.configKey = params.configKey;
@@ -866,6 +894,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;
   }
 };
@@ -987,7 +1017,7 @@ var ResourceTagConfig = class extends AbstractTagConfig {
 // src/model/config/CardVariantConfig.ts
 var CardVariantConfig = class {
   // 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) {
     __publicField(this, "tags");
     __publicField(this, "bodyAllowed");
     // Default: true
@@ -1001,6 +1031,9 @@ var CardVariantConfig = class {
     __publicField(this, "exportJsonKey");
     // New JSON-pattern jsonKey
     __publicField(this, "hasExportJsonKey");
+    __publicField(this, "htmlKey");
+    // HTML key-pattern
+    __publicField(this, "hasHtmlKey");
     __publicField(this, "format");
     this.tags = tags2;
     this.bodyAllowed = bodyAllowed == null ? true : bodyAllowed;
@@ -1009,6 +1042,8 @@ var CardVariantConfig = class {
     this.jsonKey = jsonKey;
     this.exportJsonKey = exportJsonKey;
     this.hasExportJsonKey = hasExportJsonKey;
+    this.htmlKey = htmlKey;
+    this.hasHtmlKey = hasHtmlKey;
     this.format = format;
   }
   toString(options) {
@@ -1033,18 +1068,22 @@ ${tag.toString(opts)}`;
 
 // src/model/config/CardSideConfig.ts
 var CardSideConfig = class {
-  constructor(name, repeat, variants, jsonKey, exportJsonKey, hasExportJsonKey = false) {
+  constructor(name, repeat, variants, jsonKey, exportJsonKey, hasExportJsonKey = false, htmlKey, hasHtmlKey = false) {
     __publicField(this, "name");
     __publicField(this, "repeat");
     __publicField(this, "jsonKey");
     __publicField(this, "exportJsonKey");
     __publicField(this, "hasExportJsonKey");
+    __publicField(this, "htmlKey");
+    __publicField(this, "hasHtmlKey");
     __publicField(this, "variants");
     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) {
@@ -1066,17 +1105,21 @@ var CardSideConfig = class {
 
 // src/model/config/CardSetConfig.ts
 var CardSetConfig = class {
-  constructor(configKey, jsonKey, exportJsonKey, hasExportJsonKey, sections, sides) {
+  constructor(configKey, jsonKey, exportJsonKey, hasExportJsonKey, sections, sides, htmlKey = void 0, hasHtmlKey = false) {
     __publicField(this, "configKey");
     __publicField(this, "jsonKey");
     __publicField(this, "exportJsonKey");
     __publicField(this, "hasExportJsonKey");
+    __publicField(this, "htmlKey");
+    __publicField(this, "hasHtmlKey");
     __publicField(this, "sections");
     __publicField(this, "sides");
     this.configKey = configKey;
     this.jsonKey = jsonKey;
     this.exportJsonKey = exportJsonKey;
     this.hasExportJsonKey = hasExportJsonKey;
+    this.htmlKey = htmlKey;
+    this.hasHtmlKey = hasHtmlKey;
     this.sections = sections;
     this.sides = sides;
   }
@@ -1373,6 +1416,8 @@ var propertyKeys = {
   property_externalLinkText: "@externalLinkText",
   property_feedbackEngine: "@feedbackEngine",
   property_feedbackType: "@feedbackType",
+  property_userFeedbackTranslationUrl: "@userFeedbackTranslationUrl",
+  property_userFeedbackContentUrl: "@userFeedbackContentUrl",
   property_flashcardSet: "@flashcardSet",
   property_focusX: "@focusX",
   property_focusY: "@focusY",
@@ -3756,6 +3801,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
@@ -3774,25 +3829,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,
@@ -3809,21 +3875,32 @@ 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
               },
               {
                 key: ConfigKey.property_tableRowSpan,
+                // HTML-C2: contribute a `rowspan` attribute onto the enclosing
+                // cell element (`<th>`/`<td>`).
+                htmlKey: { "@el": { "@attr": { rowspan: "$" } } },
                 description: "Number of rows the cell spans.",
                 format: TagFormat.number
               },
               {
                 key: ConfigKey.property_tableColSpan,
+                // HTML-C2: contribute a `colspan` attribute onto the enclosing
+                // cell element (`<th>`/`<td>`).
+                htmlKey: { "@el": { "@attr": { colspan: "$" } } },
                 description: "Number of columns the cell spans.",
                 format: TagFormat.number
               },
               {
                 key: ConfigKey.property_tableScope,
+                // HTML-C2: contribute a `scope` attribute onto the enclosing
+                // cell element (`<th>`/`<td>`).
+                htmlKey: { "@el": { "@attr": { scope: "$" } } },
                 description: "Scope attribute for header cells.",
                 format: TagFormat.plainText
               },
@@ -3831,6 +3908,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
               }
@@ -3846,6 +3926,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",
@@ -3865,19 +3951,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: [
@@ -3886,6 +3982,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",
@@ -3909,6 +4008,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
               },
@@ -3916,6 +4018,9 @@ var CARDSETS = {
                 key: ConfigKey.property_tableRowSpan,
                 jsonKey: "rowspan",
                 exportJsonKey: { rowspan: "$" },
+                // HTML-C2: contribute a `rowspan` attribute onto the enclosing
+                // cell element (`<th>`/`<td>`).
+                htmlKey: { "@el": { "@attr": { rowspan: "$" } } },
                 description: "Number of rows the cell spans.",
                 format: TagFormat.number
               },
@@ -3923,6 +4028,9 @@ var CARDSETS = {
                 key: ConfigKey.property_tableColSpan,
                 jsonKey: "colspan",
                 exportJsonKey: { colspan: "$" },
+                // HTML-C2: contribute a `colspan` attribute onto the enclosing
+                // cell element (`<th>`/`<td>`).
+                htmlKey: { "@el": { "@attr": { colspan: "$" } } },
                 description: "Number of columns the cell spans.",
                 format: TagFormat.number
               },
@@ -3930,6 +4038,9 @@ var CARDSETS = {
                 key: ConfigKey.property_tableScope,
                 jsonKey: "scope",
                 exportJsonKey: { scope: "$" },
+                // HTML-C2: contribute a `scope` attribute onto the enclosing
+                // cell element (`<th>`/`<td>`).
+                htmlKey: { "@el": { "@attr": { scope: "$" } } },
                 description: "Scope attribute for header cells.",
                 format: TagFormat.plainText
               },
@@ -3938,6 +4049,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
               }
@@ -5737,6 +5851,16 @@ var GROUPS = {
         description: "External Id of the translated book",
         format: TagFormat.plainText
       },
+      {
+        key: ConfigKey.property_userFeedbackTranslationUrl,
+        description: "URL to an external feedback form for book translation feedback",
+        format: TagFormat.plainText
+      },
+      {
+        key: ConfigKey.property_userFeedbackContentUrl,
+        description: "URL to an external feedback form for book content feedback",
+        format: TagFormat.plainText
+      },
       {
         key: ConfigKey.property_duration,
         description: "The duration of the book",
@@ -6866,7 +6990,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);
     }
@@ -6876,7 +7002,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;
   }
@@ -6888,10 +7016,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).
@@ -6909,7 +7041,8 @@ var ConfigHydrator = class {
       chain: _chain,
       deprecated,
       jsonKey,
-      exportJsonKey
+      exportJsonKey,
+      htmlKey
     } = _tag;
     const configKey = (0, import_superenum15.Enum)(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No tag key found for config key '${configKey}'`);
@@ -6928,6 +7061,8 @@ var ConfigHydrator = class {
       jsonKey,
       exportJsonKey,
       hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
+      htmlKey,
+      hasHtmlKey: Object.prototype.hasOwnProperty.call(_tag, "htmlKey"),
       deprecated
     });
     return {
@@ -6947,7 +7082,8 @@ var ConfigHydrator = class {
       values,
       defaultValue,
       jsonKey,
-      exportJsonKey
+      exportJsonKey,
+      htmlKey
     } = _tag;
     const configKey = (0, import_superenum15.Enum)(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No property key found for config key '${configKey}'`);
@@ -6965,6 +7101,8 @@ var ConfigHydrator = class {
       jsonKey,
       exportJsonKey,
       hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
+      htmlKey,
+      hasHtmlKey: Object.prototype.hasOwnProperty.call(_tag, "htmlKey"),
       format,
       values,
       defaultValue,
@@ -6984,7 +7122,8 @@ var ConfigHydrator = class {
       chain: _chain,
       deprecated,
       jsonKey,
-      exportJsonKey
+      exportJsonKey,
+      htmlKey
     } = _tag;
     const configKey = (0, import_superenum15.Enum)(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No resource key found for config key '${configKey}'`);
@@ -7002,6 +7141,8 @@ var ConfigHydrator = class {
       jsonKey,
       exportJsonKey,
       hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
+      htmlKey,
+      hasHtmlKey: Object.prototype.hasOwnProperty.call(_tag, "htmlKey"),
       deprecated
     });
     return {
@@ -7040,6 +7181,7 @@ var ConfigHydrator = class {
       repeatCount,
       jsonKey,
       exportJsonKey,
+      htmlKey,
       format
     } = _variant;
     const tags2 = this.hydrateTagsConfig(_tags);
@@ -7051,7 +7193,9 @@ var ConfigHydrator = class {
       jsonKey,
       exportJsonKey,
       Object.prototype.hasOwnProperty.call(_variant, "exportJsonKey"),
-      format
+      format,
+      htmlKey,
+      Object.prototype.hasOwnProperty.call(_variant, "htmlKey")
     );
     return cardSetConfig;
   }
@@ -10184,11 +10328,6 @@ var BITS = {
     baseBitType: BitType2._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"
@@ -10824,7 +10963,9 @@ var BITS = {
       {
         key: ConfigKey.property_caption,
         description: "Caption for the table image, used to provide a description for the image",
-        format: TagFormat.bitmarkText
+        format: TagFormat.bitmarkText,
+        // HTML-10 / HTML-C2: render as the table's `<caption>` (see table bit).
+        htmlKey: { "@el": "caption", "@children": "$" }
       },
       {
         key: ConfigKey.group_backgroundWallpaper,
@@ -10867,6 +11008,26 @@ var BITS = {
     baseBitType: BitType2.tableImage,
     description: "Standard non-normative remark table image bit, used to create non-normative remark images in tables in articles or books"
   },
+  [BitType2.standardTableExtendedImageNormative]: {
+    since: "1.16.0",
+    baseBitType: BitType2.tableExtendedImage,
+    description: "Standard normative extended table image bit, used to create normative extended images in tables in articles or books"
+  },
+  [BitType2.standardTableExtendedImageNonNormative]: {
+    since: "1.16.0",
+    baseBitType: BitType2.tableExtendedImage,
+    description: "Standard non-normative extended table image bit, used to create non-normative extended images in tables in articles or books"
+  },
+  [BitType2.standardRemarkTableExtendedImageNormative]: {
+    since: "1.17.0",
+    baseBitType: BitType2.tableExtendedImage,
+    description: "Standard normative remark extended table image bit, used to create normative remark extended images in tables in articles or books"
+  },
+  [BitType2.standardRemarkTableExtendedImageNonNormative]: {
+    since: "1.17.0",
+    baseBitType: BitType2.tableExtendedImage,
+    description: "Standard non-normative remark extended table image bit, used to create non-normative remark extended images in tables in articles or books"
+  },
   [BitType2.smartStandardTableImageNormative]: {
     since: "1.28.0",
     baseBitType: BitType2.standardTableImageNormative,
@@ -10887,6 +11048,26 @@ var BITS = {
     baseBitType: BitType2.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"
   },
+  [BitType2.smartStandardTableExtendedImageNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType2.standardTableExtendedImageNormative,
+    description: "Smart standard normative extended table image bit, used to create smart standard normative extended images in tables in articles or books"
+  },
+  [BitType2.smartStandardTableExtendedImageNonNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType2.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"
+  },
+  [BitType2.smartStandardRemarkTableExtendedImageNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType2.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"
+  },
+  [BitType2.smartStandardRemarkTableExtendedImageNonNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType2.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"
+  },
   [BitType2.smartStandardTableImageNormativeCollapsible]: {
     since: "1.28.0",
     baseBitType: BitType2.smartStandardTableImageNormative,
@@ -10907,6 +11088,26 @@ var BITS = {
     baseBitType: BitType2.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"
   },
+  [BitType2.smartStandardTableExtendedImageNormativeCollapsible]: {
+    since: "1.28.0",
+    baseBitType: BitType2.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"
+  },
+  [BitType2.smartStandardTableExtendedImageNonNormativeCollapsible]: {
+    since: "1.28.0",
+    baseBitType: BitType2.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"
+  },
+  [BitType2.smartStandardRemarkTableExtendedImageNormativeCollapsible]: {
+    since: "1.28.0",
+    baseBitType: BitType2.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"
+  },
+  [BitType2.smartStandardRemarkTableExtendedImageNonNormativeCollapsible]: {
+    since: "1.28.0",
+    baseBitType: BitType2.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"
+  },
   [BitType2.imageLink]: {
     since: "1.3.0",
     baseBitType: BitType2._standard,
@@ -12455,7 +12656,12 @@ var BITS = {
       {
         key: ConfigKey.property_caption,
         description: "Caption for the table, used to define the title of the table",
-        format: TagFormat.bitmarkText
+        format: TagFormat.bitmarkText,
+        // HTML-10 / HTML-C2: a bit-level caption renders as the table's
+        // `<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": "$" }
       },
       {
         key: ConfigKey.property_tableFixedHeader,
@@ -12540,7 +12746,9 @@ var BITS = {
       {
         key: ConfigKey.property_caption,
         description: "Caption for the table image, used to provide a description for the image",
-        format: TagFormat.bitmarkText
+        format: TagFormat.bitmarkText,
+        // HTML-10 / HTML-C2: render as the table's `<caption>` (see table bit).
+        htmlKey: { "@el": "caption", "@children": "$" }
       },
       {
         key: ConfigKey.group_backgroundWallpaper,
@@ -12583,6 +12791,26 @@ var BITS = {
     baseBitType: BitType2.table,
     description: "Standard non-normative remark table bit, used to create standard non-normative remark tables in articles or books"
   },
+  [BitType2.standardTableExtendedNormative]: {
+    since: "1.16.0",
+    baseBitType: BitType2.tableExtended,
+    description: "Standard normative extended table bit, used to create standard normative extended tables in articles or books"
+  },
+  [BitType2.standardTableExtendedNonNormative]: {
+    since: "1.16.0",
+    baseBitType: BitType2.tableExtended,
+    description: "Standard non-normative extended table bit, used to create standard non-normative extended tables in articles or books"
+  },
+  [BitType2.standardRemarkTableExtendedNormative]: {
+    since: "1.17.0",
+    baseBitType: BitType2.tableExtended,
+    description: "Standard normative remark extended table bit, used to create standard normative remark extended tables in articles or books"
+  },
+  [BitType2.standardRemarkTableExtendedNonNormative]: {
+    since: "1.17.0",
+    baseBitType: BitType2.tableExtended,
+    description: "Standard non-normative remark extended table bit, used to create standard non-normative remark extended tables in articles or books"
+  },
   [BitType2.smartStandardTableNormative]: {
     since: "1.28.0",
     baseBitType: BitType2.standardTableNormative,
@@ -12603,6 +12831,26 @@ var BITS = {
     baseBitType: BitType2.standardRemarkTableNonNormative,
     description: "Smart standard non-normative remark table bit, used to create smart standard non-normative remark tables in articles or books"
   },
+  [BitType2.smartStandardTableExtendedNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType2.standardTableExtendedNormative,
+    description: "Smart standard normative extended table bit, used to create smart standard normative extended tables in articles or books"
+  },
+  [BitType2.smartStandardTableExtendedNonNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType2.standardTableExtendedNonNormative,
+    description: "Smart standard non-normative extended table bit, used to create smart standard non-normative extended tables in articles or books"
+  },
+  [BitType2.smartStandardRemarkTableExtendedNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType2.standardRemarkTableExtendedNormative,
+    description: "Smart standard normative remark extended table bit, used to create smart standard normative remark extended tables in articles or books"
+  },
+  [BitType2.smartStandardRemarkTableExtendedNonNormative]: {
+    since: "1.28.0",
+    baseBitType: BitType2.standardRemarkTableExtendedNonNormative,
+    description: "Smart standard non-normative remark extended table bit, used to create smart standard non-normative remark extended tables in articles or books"
+  },
   [BitType2.smartStandardTableNormativeCollapsible]: {
     since: "1.28.0",
     baseBitType: BitType2.smartStandardTableNormative,
@@ -12623,6 +12871,26 @@ var BITS = {
     baseBitType: BitType2.smartStandardRemarkTableNonNormative,
     description: "Collapsible smart standard non-normative remark table bit, used to create collapsible smart standard non-normative remark tables in articles or books"
   },
+  [BitType2.smartStandardTableExtendedNormativeCollapsible]: {
+    since: "1.28.0",
+    baseBitType: BitType2.smartStandardTableExtendedNormative,
+    description: "Collapsible smart standard normative extended table bit, used to create collapsible smart standard normative extended tables in articles or books"
+  },
+  [BitType2.smartStandardTableExtendedNonNormativeCollapsible]: {
+    since: "1.28.0",
+    baseBitType: BitType2.smartStandardTableExtendedNonNormative,
+    description: "Collapsible smart standard non-normative extended table bit, used to create collapsible smart standard non-normative extended tables in articles or books"
+  },
+  [BitType2.smartStandardRemarkTableExtendedNormativeCollapsible]: {
+    since: "1.28.0",
+    baseBitType: BitType2.smartStandardRemarkTableExtendedNormative,
+    description: "Collapsible smart standard normative remark extended table bit, used to create collapsible smart standard normative remark extended tables in articles or books"
+  },
+  [BitType2.smartStandardRemarkTableExtendedNonNormativeCollapsible]: {
+    since: "1.28.0",
+    baseBitType: BitType2.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"
+  },
   [BitType2.parameters]: {
     since: "1.18.0",
     baseBitType: BitType2.table,
@@ -13564,6 +13832,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;
@@ -13668,7 +13938,7 @@ var instance2 = new Config();
 // src/generated/package_info.ts
 var PACKAGE_INFO = {
   "name": "@gmb/bitmark-parser-generator",
-  "version": "5.26.0",
+  "version": "5.28.0",
   "author": "Get More Brain Ltd",
   "license": "ISC",
   "description": "A bitmark parser and generator using Peggy.js"
@@ -14558,6 +14828,10 @@ var NodeType = {
   relatedBookValue: "relatedBookValue",
   translationOfBook: "translationOfBook",
   translationOfBookValue: "translationOfBookValue",
+  userFeedbackTranslationUrl: "userFeedbackTranslationUrl",
+  userFeedbackTranslationUrlValue: "userFeedbackTranslationUrlValue",
+  userFeedbackContentUrl: "userFeedbackContentUrl",
+  userFeedbackContentUrlValue: "userFeedbackContentUrlValue",
   releaseDate: "releaseDate",
   releaseDateValue: "releaseDateValue",
   releaseKind: "releaseKind",
@@ -27767,6 +28041,18 @@ var Builder = class extends BaseBuilder {
         data.translationOfBook,
         options
       ),
+      userFeedbackTranslationUrl: this.toAstProperty(
+        bitType,
+        ConfigKey.property_userFeedbackTranslationUrl,
+        data.userFeedbackTranslationUrl,
+        options
+      ),
+      userFeedbackContentUrl: this.toAstProperty(
+        bitType,
+        ConfigKey.property_userFeedbackContentUrl,
+        data.userFeedbackContentUrl,
+        options
+      ),
       author: this.toAstProperty(bitType, ConfigKey.property_author, data.author, options),
       subject: this.toAstProperty(bitType, ConfigKey.property_subject, data.subject, options),
       date: this.toAstProperty(bitType, ConfigKey.property_date, data.date, options),
@@ -31558,7 +31844,8 @@ var BitmarkGenerator = class extends AstWalkerGenerator {
       this.writeNL();
     }
     const content = cell.content ?? instance3.EMPTY_STRING;
-    this.writeTextOrValue(content, this.textFormat, TextLocation2.body);
+    const options = this.options.noBreakscaping ? { noBreakscaping: true } : void 0;
+    this.writeTextOrValue(content, this.textFormat, TextLocation2.body, options);
   }
   writeTableCellProperty(name, value) {
     this.writeOPA();
@@ -33024,6 +33311,278 @@ var BitmarkStringGenerator = class {
   }
 };
 
+// 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 INLINE_IMAGE_RE = /==([^=]*(?:=(?!=)[^=]*)*)==\|imageInline:([^|\s]+)((?:\|(?:@?[A-Za-z][A-Za-z0-9_-]*:[^|\s]+|#[^|\s]*))*)\|?/g;
+var MAX_IMAGE_DIMENSION = 9999;
+var HtmlTableGenerator = class {
+  constructor() {
+    __publicField(this, "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);
+      case "latex":
+        return this.latexToHtml(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 === "latex") return this.latexToHtml(node);
+    if (node.type === "text") {
+      return this.wrapMarks(this.textToHtml(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(" ")}>`;
+  }
+  textToHtml(text) {
+    let html = "";
+    let lastIndex = 0;
+    for (const match of text.matchAll(INLINE_IMAGE_RE)) {
+      const index = match.index ?? 0;
+      html += this.escapeText(text.slice(lastIndex, index));
+      html += this.inlineImageTokenToHtml(match);
+      lastIndex = index + match[0].length;
+    }
+    html += this.escapeText(text.slice(lastIndex));
+    return html;
+  }
+  inlineImageTokenToHtml(match) {
+    const attrs = {
+      alt: match[1],
+      src: match[2]
+    };
+    const rawAttrs = match[3] ?? "";
+    for (const attr of rawAttrs.split("|")) {
+      if (!attr || attr.startsWith("#")) continue;
+      const colon = attr.indexOf(":");
+      if (colon < 1) continue;
+      const key = attr.slice(0, colon).replace(/^@/, "");
+      const value = attr.slice(colon + 1);
+      if (key === "width" || key === "height") {
+        const n = Number.parseInt(value, 10);
+        if (!Number.isNaN(n) && n > 0 && n <= MAX_IMAGE_DIMENSION) attrs[key] = n;
+      } else if (key === "class" || key === "title") {
+        attrs[key] = value;
+      }
+    }
+    return this.imageToHtml({ type: "imageInline", attrs });
+  }
+  // --- formulas -------------------------------------------------------------
+  latexToHtml(node) {
+    const formula = node.attrs?.formula ?? "";
+    return `<math alttext="${this.escapeAttr(formula)}"></math>`;
+  }
+  // --- escaping -------------------------------------------------------------
+  escapeText(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  }
+  escapeAttr(text) {
+    return this.escapeText(text).replace(/"/g, "&quot;");
+  }
+};
+
 // src/generator/json/JsonGenerator.ts
 var import_superenum33 = require("@ncoderz/superenum");
 var MOVE_BODY_RECURSION_LIMIT = 5e3;
@@ -33326,6 +33885,7 @@ var JsonGenerator = class extends AstWalkerGenerator {
         this.addProperty(this.bitJson, k, values, { array: true });
       }
     }
+    return false;
   }
   // bitmarkAst -> bits -> bitsValue -> cardNode -> cardBits -> cardBitsValue
   enter_cardBitsValue(node, route) {
@@ -37951,6 +38511,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,
@@ -42330,6 +42892,539 @@ var BitmarkParser = 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 {
+  constructor() {
+    __publicField(this, "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)];
+    }
+    if (this.isMathTag(name)) {
+      return [this.latexNode(el)];
+    }
+    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 };
+  }
+  // --- formulas -------------------------------------------------------------
+  isMathTag(name) {
+    return this.localName(name) === "math";
+  }
+  latexNode(el) {
+    return {
+      type: "latex",
+      attrs: {
+        formula: this.latexFromMath(el)
+      }
+    };
+  }
+  latexFromMath(el) {
+    const alt = el.attrs.alttext ?? el.attrs.alt ?? el.attrs.title;
+    if (alt != null) return decodeEntities(alt);
+    const annotation = this.findLatexAnnotation(el);
+    if (annotation) return this.textContent(annotation).trim();
+    return this.textContent(el).trim();
+  }
+  findLatexAnnotation(el) {
+    for (const child of el.children) {
+      if (!isElement(child)) continue;
+      const lowerEncoding = (child.attrs.encoding ?? "").toLowerCase();
+      if (this.localName(child.name) === "annotation" && (/\btex\b/.test(lowerEncoding) || /\blatex\b/.test(lowerEncoding))) {
+        return child;
+      }
+      const nested = this.findLatexAnnotation(child);
+      if (nested) return nested;
+    }
+    return void 0;
+  }
+  textContent(el) {
+    return el.children.map((child) => isElement(child) ? this.textContent(child) : decodeEntities(child.value)).join("").replace(/\s+/g, " ");
+  }
+  localName(name) {
+    return name.includes(":") ? name.slice(name.indexOf(":") + 1) : name;
+  }
+  // --- 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 = {
   /**
@@ -42966,7 +44061,10 @@ var BitmarkParserGenerator = class {
         outputFile: opts.outputFile,
         fileOptions: opts.fileOptions,
         jsonOptions: opts.jsonOptions,
-        bitmarkOptions: opts.bitmarkOptions
+        bitmarkOptions: {
+          ...opts.bitmarkOptions,
+          ...opts.noBreakscaping ? { noBreakscaping: true } : {}
+        }
       });
     }
     const outputFormat = opts.outputFormat ?? "html";
@@ -43269,728 +44367,6 @@ var BoundingBoxIndex = class _BoundingBoxIndex {
   }
 };
 
-// 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 HtmlTableGenerator2 = class {
-  constructor() {
-    __publicField(this, "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;");
-  }
-};
-
-// 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 HtmlTableParser2 = class {
-  constructor() {
-    __publicField(this, "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/index.ts
 init();
 // Annotate the CommonJS export names for ESM import in node: