@gmb/bitmark-parser-generator 5.24.0 → 5.26.0

package/dist/index.d.cts

@@ -221,6 +221,7 @@ declare const BitType: {
     readonly dangerAlt: "danger-alt";
     readonly dangerCollapsible: "danger-collapsible";
     readonly definitionList: "definition-list";
+    readonly definitionListCollapsible: "definition-list-collapsible";
     readonly definitionTerm: "definition-term";
     readonly deleted: "deleted";
     readonly details: "details";
@@ -501,6 +502,8 @@ declare const BitType: {
     readonly smartStandardArticleNonNormativeCollapsible: "smart-standard-article-non-normative-collapsible";
     readonly smartStandardArticleNormative: "smart-standard-article-normative";
     readonly smartStandardArticleNormativeCollapsible: "smart-standard-article-normative-collapsible";
+    readonly smartStandardDefinitionListNonNormative: "smart-standard-definition-list-non-normative";
+    readonly smartStandardDefinitionListNormative: "smart-standard-definition-list-normative";
     readonly smartStandardExampleNonNormative: "smart-standard-example-non-normative";
     readonly smartStandardExampleNonNormativeCollapsible: "smart-standard-example-non-normative-collapsible";
     readonly smartStandardExampleNormative: "smart-standard-example-normative";
@@ -551,6 +554,8 @@ declare const BitType: {
     readonly smartStandardTableNormativeCollapsible: "smart-standard-table-normative-collapsible";
     readonly standardArticleNonNormative: "standard-article-non-normative";
     readonly standardArticleNormative: "standard-article-normative";
+    readonly standardDefinitionListNonNormative: "standard-definition-list-non-normative";
+    readonly standardDefinitionListNormative: "standard-definition-list-normative";
     readonly standardExampleNonNormative: "standard-example-non-normative";
     readonly standardExampleNormative: "standard-example-normative";
     readonly standardImageFigureNonNormative: "standard-image-figure-non-normative";
@@ -849,6 +854,7 @@ declare const ConfigKey: {
     readonly property_enforceUpdateOverUserInput: "@enforceUpdateOverUserInput";
     readonly property_extractorExtractionTimestamp: "@extractorExtractionTimestamp";
     readonly property_isCaseSensitive: "@isCaseSensitive";
+    readonly property_isCollapsible: "@isCollapsible";
     readonly property_isInfoOnly: "@isInfoOnly";
     readonly property_isPublic: "@isPublic";
     readonly property_isTemplate: "@isTemplate";
@@ -1901,6 +1907,7 @@ interface BitJson {
     level: number;
     toc: boolean;
     progress: boolean;
+    isCollapsible: boolean;
     anchor: string;
     reference: string | string[];
     referenceEnd: string;
@@ -2537,6 +2544,7 @@ interface Bit {
     level?: number;
     toc?: Property;
     progress?: Property;
+    isCollapsible?: Property;
     anchor?: string;
     reference?: string;
     referenceEnd?: string;
@@ -2911,6 +2919,8 @@ declare const NodeType: {
     readonly internalPrintPdf: "internalPrintPdf";
     readonly internalPrintPdfValue: "internalPrintPdfValue";
     readonly isCaseSensitive: "isCaseSensitive";
+    readonly isCollapsible: "isCollapsible";
+    readonly isCollapsibleValue: "isCollapsibleValue";
     readonly isCommented: "isCommented";
     readonly isCorrect: "isCorrect";
     readonly isEditable: "isEditable";
@@ -3830,6 +3840,7 @@ declare const CardSetConfigKey: {
     readonly flashcard: "flashcard";
     readonly flashcard1: "flashcard1";
     readonly definitionList: "definitionList";
+    readonly definitionListPlain: "definitionListPlain";
     readonly elements: "elements";
     readonly statements: "statements";
     readonly quiz: "quiz";
@@ -4461,6 +4472,7 @@ declare class Builder extends BaseBuilder {
         level?: number | string;
         toc?: boolean;
         progress?: boolean;
+        isCollapsible?: boolean;
         anchor?: string;
         reference?: string;
         referenceEnd?: string;
@@ -6425,6 +6437,65 @@ declare class FileWriter extends StreamWriter {
     close(): Promise<void>;
 }
 
+/**
+ * Extract HTML tables and convert them into bitmark table bit-JSON.
+ *
+ * Produces an array of bare `BitJson`-shaped objects (`type` = `table-extended` or `table`) that
+ * can be fed directly into the existing JSON → AST → output pipeline. Cell content is built as
+ * `TextAst` (rich text nodes) directly; the downstream generators handle serialisation and
+ * breakscaping.
+ *
+ * See PLAN-013 for the full specification.
+ */
+
+type HtmlTableFormat = 'table' | 'table-extended';
+interface HtmlTableParseOptions {
+    /** Output bit type. Default `table-extended` (lossless). `table` is lossy. */
+    tableFormat?: HtmlTableFormat;
+    /** Keep unmappable tags as literal text instead of unwrapping them. Default false. */
+    keepUnknownTags?: boolean;
+    /** Called with a human-readable message when information is lost (e.g. lossy `table` output). */
+    onWarning?: (message: string) => void;
+}
+/** Loosely-typed table bit JSON (matches a subset of BitJson). */
+interface TableBitJson {
+    type: HtmlTableFormat;
+    format: 'bitmark++';
+    caption?: TextAst;
+    table: TableJson | TableExtendedJson;
+}
+declare class HtmlTableParser {
+    private keepUnknownTags;
+    /**
+     * Parse an HTML string and return one table bit per top-level `<table>`.
+     */
+    parse(html: string, options?: HtmlTableParseOptions): TableBitJson[];
+    /** Collect every `<table>` element, NOT descending into nested tables. */
+    private collectTopLevelTables;
+    private tableToBit;
+    private rowToCells;
+    private cellToJson;
+    private widthFromCell;
+    private isLossyAsBasic;
+    /**
+     * Convert a cell/li's child nodes into block-level TextAst nodes (paragraphs, lists, images).
+     */
+    private blockNodes;
+    /** Convert child nodes to a flat list of inline TextNodes, applying the given marks. */
+    private inlineNodes;
+    private inlineFromElement;
+    private inlineText;
+    private serializeOpenTag;
+    private isListTag;
+    private listNode;
+    private listType;
+    private listItemNode;
+    private taskItemNode;
+    private imageNode;
+    /** Trim leading/trailing whitespace from inline content (edges only). */
+    private trimInline;
+}
+
 /**
  * Info options for the parser
  */
@@ -6600,6 +6671,48 @@ interface ExtractPlainTextOptions {
      */
     inputFormat?: InputFormatType;
 }
+/**
+ * Options for {@link BitmarkParserGenerator.convertHtmlTable}
+ */
+interface ConvertHtmlTableOptions {
+    /**
+     * Force the input format, overriding auto-detection.
+     * - `html`: input is HTML; extract tables and output bitmark/JSON/AST
+     * - any other value: input is bitmark/JSON/AST; output HTML
+     */
+    inputFormat?: InputFormatType;
+    /**
+     * Output format.
+     * - HTML input: `bitmark` (default) | `json` | `ast` | `html` (re-emit / normalise)
+     * - bitmark/JSON/AST input: `html` (default, and only valid value)
+     */
+    outputFormat?: OutputType | 'html';
+    /**
+     * Bit type to emit when converting HTML to bits.
+     * `table-extended` (default, lossless) or `table` (lossy: drops spans/scope/sections).
+     */
+    tableFormat?: HtmlTableFormat;
+    /**
+     * Keep unmappable HTML tags as literal text instead of unwrapping them (HTML -> bits only).
+     */
+    keepUnknownTags?: boolean;
+    /**
+     * Specify a file to write the output to
+     */
+    outputFile?: string;
+    /**
+     * Options for the output file
+     */
+    fileOptions?: FileOptions;
+    /**
+     * Options for bitmark generation (HTML -> bitmark)
+     */
+    bitmarkOptions?: BitmarkOptions;
+    /**
+     * Options for JSON generation (HTML -> json)
+     */
+    jsonOptions?: JsonOptions;
+}
 /**
  * Breakscape options
  */
@@ -6704,6 +6817,10 @@ declare const InputFormat: {
      * Input is plain text
      */
     readonly plainText: "plainText";
+    /**
+     * Input is HTML (used by convertHtmlTable)
+     */
+    readonly html: "html";
 };
 type InputFormatType = EnumType<typeof InputFormat>;
 /**
@@ -6852,6 +6969,28 @@ declare class BitmarkParserGenerator {
      */
     convertText(input: string | unknown, options?: ConvertTextOptions): string | unknown | void;
     extractPlainText(input: string | unknown, options?: ExtractPlainTextOptions): string;
+    /**
+     * Convert between HTML tables and bitmark tables.
+     *
+     * Direction is auto-detected (override with `options.inputFormat`):
+     * - HTML input: every `<table>` is extracted and emitted as a `[.table-extended]` (or `[.table]`)
+     *   bit; output as bitmark (default), JSON, AST, or HTML (re-emit).
+     * - bitmark / JSON / AST input: each `table` / `table-extended` bit is rendered as an HTML
+     *   `<table>` fragment.
+     *
+     * Cell content is reproduced verbatim except inline conversion to bitmark marks (bold, italic,
+     * superscript, etc.), with lists and images mapped to their bitmark equivalents.
+     *
+     * @param input - HTML, bitmark, JSON or AST string; or a parsed JSON/AST value; or a file path.
+     * @param options - the conversion options
+     * @returns the converted output as a string (or object for JSON/AST), or void when writing a file
+     * @throws Error if any error occurs
+     */
+    convertHtmlTable(input: string | unknown, options?: ConvertHtmlTableOptions): string | unknown | void;
+    /**
+     * Write an HTML string to the configured output file, or return it.
+     */
+    private outputHtml;
     /**
      * Breakscape bitmark text.
      *
@@ -7114,4 +7253,39 @@ declare class JsonFileGenerator implements Generator<BitmarkAst> {
     generateSync(_ast: BitmarkAst): void;
 }
 
-export { type AppLinkResourceJson, type AppLinkResourceWrapperJson, type ArticleResourceJson, type ArticleResourceWrapperJson, Ast, type AstWalkCallbacks, type AudioEmbedResourceJson, type AudioEmbedResourceWrapperJson, type AudioLinkResourceJson, type AudioLinkResourceWrapperJson, type AudioResourceJson, type AudioResourceWrapperJson, type Bbox, type Bit, type BitJson, BitType, type BitTypeType, type BitWrapperJson, type BitmarkAst, BitmarkFileGenerator, BitmarkGenerator, type BitmarkOptions, BitmarkParser, BitmarkParserGenerator, BitmarkParserType, type BitmarkParserTypeType, BitmarkStringGenerator, BitmarkVersion, type BitmarkVersionType, type Body, type BodyBitJson, type BodyBitsJson, type BodyPart, BodyTextFormat, type BodyTextFormatType, type BookJson, type BookReferenceJson, type BotResponseJson, type BoundingBoxEntry, BoundingBoxIndex, type BreakscapeOptions, type BreakscapedString, Builder, type CardBit, type CardNode, CardSetVersion, type CardSetVersionType, type ChoiceJson, type CodeBlockTextNode, type CodeBlockTextNodeAttributes, type CommentMark, type ConvertOptions, type ConvertTextOptions, type CreateAstOptions, type DefinitionListItemJson, type DocumentDownloadResourceJson, type DocumentDownloadResourceWrapperJson, type DocumentEmbedResourceJson, type DocumentEmbedResourceWrapperJson, type DocumentLinkResourceJson, type DocumentLinkResourceWrapperJson, type DocumentResourceJson, type DocumentResourceWrapperJson, type Example, type ExampleJson, type ExtRefMark, type ExtRefMarkAttibutes, type ExtraProperties, type FeedbackChoiceJson, type FeedbackJson, type FeedbackReasonJson, type FileOptions, FileWriter, type FlashcardJson, type Footer, type FootnoteAttibutes, type FootnoteMark, type FromBitsOptions, type GapJson, type Generator, type GroupTagJson, type HeadingJson, type HeadingTextNode, type HeadingTextNodeAttributes, type HighlightJson, type HighlightTextJson, type ImageInlineTextNode, type ImageLinkResourceJson, type ImageLinkResourceWrapperJson, type ImageResourceJson, type ImageResourceWrapperJson, type ImageSourceJson, type ImageTextNode, type ImageTextNodeAttributes, InfoFormat, type InfoFormatType, type InfoOptions, InfoType, type InfoTypeType, type IngredientJson, Input, InputFormat, type InputFormatType, type InputType, JsonFileGenerator, JsonGenerator, type JsonOptions, JsonParser, JsonStringGenerator, type LatexTextNode, type LatexTextNodeAttributes, type LinkMark, type LinkMarkAttibutes, type ListItemJson, type ListTextNode, type ListTextNodeAttributes, type MarkConfigJson, type MarkJson, type MatrixCellJson, type MatrixJson, type MediaAttributes, type Node, type NodeInfo, NodeType, type NodeTypeType, Output, type OutputType, type PairJson, type ParserJson, type PersonJson, type UpgradeOptions as PrettifyOptions, type PronunciationTableCellJson, type PronunciationTableJson, type Property, type QuestionJson, type QuizJson, type RatingLevelStartEndJson, type RefMark, type RefMarkAttibutes, ResourceBuilder, type ResourceDataJson, type ResourceJson, type ResourceTypeType, type ResourceWrapperJson, type ResponseJson, type SectionTextNode, type SelectJson, type SelectOptionJson, type ServingsJson, type StatementJson, type StillImageFilmEmbedResourceJson, type StillImageFilmEmbedResourceWrapperJson, type StillImageFilmLinkResourceJson, type StillImageFilmLinkResourceWrapperJson, type StillImageFilmResourceJson, type StillImageFilmResourceWrapperJson, StreamWriter, StringWriter, type SymbolMark, type TableCellJson, type TableExtendedJson, type TableJson, type TableRowJson, type TableSectionJson, type TaskItemTextNode, type TaskItemTextNodeAttributes, type TechnicalTermJson, type JsonText as Text, type TextAndIconJson, type TextAst, type TextJsonOptions, type TextMark, type TextMarkAttibutes, TextMarkType, type TextMarkTypeType, type TextNode, type TextNodeAttibutes, TextNodeType, type TextNodeTypeType, type UnbreakscapeOptions, type UpgradeOptions, type VideoEmbedResourceJson, type VideoEmbedResourceWrapperJson, type VideoLinkResourceJson, type VideoLinkResourceWrapperJson, type VideoResourceJson, type VideoResourceWrapperJson, type WebsiteLinkResourceJson, type WebsiteLinkResourceWrapperJson, type Writer, type XRefMark, type XRefMarkAttibutes, parse as bitmarkTextParse };
+/**
+ * Generate HTML `<table>` fragments from bitmark table bit-JSON.
+ *
+ * Consumes the JSON bit array (a string or parsed value), like {@link PlainTextGenerator}, and
+ * renders each `table` / `table-extended` bit as a pretty-printed HTML `<table>` fragment. Cell
+ * content (TextAst) is rendered back to inline/block HTML, mapping bitmark marks to inline tags.
+ *
+ * See PLAN-013 for the full specification.
+ */
+declare class HtmlTableGenerator {
+    private readonly 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: string | unknown): string;
+    private collectBits;
+    private renderTableBit;
+    private toExtended;
+    private renderSection;
+    private renderCell;
+    private asTextAst;
+    private cellContentToHtml;
+    private blockToHtml;
+    private inlineToHtml;
+    private inlineNodeToHtml;
+    private wrapMarks;
+    private listToHtml;
+    private listTag;
+    private listItemToHtml;
+    private imageToHtml;
+    private escapeText;
+    private escapeAttr;
+}
+
+export { type AppLinkResourceJson, type AppLinkResourceWrapperJson, type ArticleResourceJson, type ArticleResourceWrapperJson, Ast, type AstWalkCallbacks, type AudioEmbedResourceJson, type AudioEmbedResourceWrapperJson, type AudioLinkResourceJson, type AudioLinkResourceWrapperJson, type AudioResourceJson, type AudioResourceWrapperJson, type Bbox, type Bit, type BitJson, BitType, type BitTypeType, type BitWrapperJson, type BitmarkAst, BitmarkFileGenerator, BitmarkGenerator, type BitmarkOptions, BitmarkParser, BitmarkParserGenerator, BitmarkParserType, type BitmarkParserTypeType, BitmarkStringGenerator, BitmarkVersion, type BitmarkVersionType, type Body, type BodyBitJson, type BodyBitsJson, type BodyPart, BodyTextFormat, type BodyTextFormatType, type BookJson, type BookReferenceJson, type BotResponseJson, type BoundingBoxEntry, BoundingBoxIndex, type BreakscapeOptions, type BreakscapedString, Builder, type CardBit, type CardNode, CardSetVersion, type CardSetVersionType, type ChoiceJson, type CodeBlockTextNode, type CodeBlockTextNodeAttributes, type CommentMark, type ConvertHtmlTableOptions, type ConvertOptions, type ConvertTextOptions, type CreateAstOptions, type DefinitionListItemJson, type DocumentDownloadResourceJson, type DocumentDownloadResourceWrapperJson, type DocumentEmbedResourceJson, type DocumentEmbedResourceWrapperJson, type DocumentLinkResourceJson, type DocumentLinkResourceWrapperJson, type DocumentResourceJson, type DocumentResourceWrapperJson, type Example, type ExampleJson, type ExtRefMark, type ExtRefMarkAttibutes, type ExtraProperties, type FeedbackChoiceJson, type FeedbackJson, type FeedbackReasonJson, type FileOptions, FileWriter, type FlashcardJson, type Footer, type FootnoteAttibutes, type FootnoteMark, type FromBitsOptions, type GapJson, type Generator, type GroupTagJson, type HeadingJson, type HeadingTextNode, type HeadingTextNodeAttributes, type HighlightJson, type HighlightTextJson, type HtmlTableFormat, HtmlTableGenerator, type HtmlTableParseOptions, HtmlTableParser, type ImageInlineTextNode, type ImageLinkResourceJson, type ImageLinkResourceWrapperJson, type ImageResourceJson, type ImageResourceWrapperJson, type ImageSourceJson, type ImageTextNode, type ImageTextNodeAttributes, InfoFormat, type InfoFormatType, type InfoOptions, InfoType, type InfoTypeType, type IngredientJson, Input, InputFormat, type InputFormatType, type InputType, JsonFileGenerator, JsonGenerator, type JsonOptions, JsonParser, JsonStringGenerator, type LatexTextNode, type LatexTextNodeAttributes, type LinkMark, type LinkMarkAttibutes, type ListItemJson, type ListTextNode, type ListTextNodeAttributes, type MarkConfigJson, type MarkJson, type MatrixCellJson, type MatrixJson, type MediaAttributes, type Node, type NodeInfo, NodeType, type NodeTypeType, Output, type OutputType, type PairJson, type ParserJson, type PersonJson, type UpgradeOptions as PrettifyOptions, type PronunciationTableCellJson, type PronunciationTableJson, type Property, type QuestionJson, type QuizJson, type RatingLevelStartEndJson, type RefMark, type RefMarkAttibutes, ResourceBuilder, type ResourceDataJson, type ResourceJson, type ResourceTypeType, type ResourceWrapperJson, type ResponseJson, type SectionTextNode, type SelectJson, type SelectOptionJson, type ServingsJson, type StatementJson, type StillImageFilmEmbedResourceJson, type StillImageFilmEmbedResourceWrapperJson, type StillImageFilmLinkResourceJson, type StillImageFilmLinkResourceWrapperJson, type StillImageFilmResourceJson, type StillImageFilmResourceWrapperJson, StreamWriter, StringWriter, type SymbolMark, type TableCellJson, type TableExtendedJson, type TableJson, type TableRowJson, type TableSectionJson, type TaskItemTextNode, type TaskItemTextNodeAttributes, type TechnicalTermJson, type JsonText as Text, type TextAndIconJson, type TextAst, type TextJsonOptions, type TextMark, type TextMarkAttibutes, TextMarkType, type TextMarkTypeType, type TextNode, type TextNodeAttibutes, TextNodeType, type TextNodeTypeType, type UnbreakscapeOptions, type UpgradeOptions, type VideoEmbedResourceJson, type VideoEmbedResourceWrapperJson, type VideoLinkResourceJson, type VideoLinkResourceWrapperJson, type VideoResourceJson, type VideoResourceWrapperJson, type WebsiteLinkResourceJson, type WebsiteLinkResourceWrapperJson, type Writer, type XRefMark, type XRefMarkAttibutes, parse as bitmarkTextParse };

package/dist/index.d.ts

@@ -221,6 +221,7 @@ declare const BitType: {
     readonly dangerAlt: "danger-alt";
     readonly dangerCollapsible: "danger-collapsible";
     readonly definitionList: "definition-list";
+    readonly definitionListCollapsible: "definition-list-collapsible";
     readonly definitionTerm: "definition-term";
     readonly deleted: "deleted";
     readonly details: "details";
@@ -501,6 +502,8 @@ declare const BitType: {
     readonly smartStandardArticleNonNormativeCollapsible: "smart-standard-article-non-normative-collapsible";
     readonly smartStandardArticleNormative: "smart-standard-article-normative";
     readonly smartStandardArticleNormativeCollapsible: "smart-standard-article-normative-collapsible";
+    readonly smartStandardDefinitionListNonNormative: "smart-standard-definition-list-non-normative";
+    readonly smartStandardDefinitionListNormative: "smart-standard-definition-list-normative";
     readonly smartStandardExampleNonNormative: "smart-standard-example-non-normative";
     readonly smartStandardExampleNonNormativeCollapsible: "smart-standard-example-non-normative-collapsible";
     readonly smartStandardExampleNormative: "smart-standard-example-normative";
@@ -551,6 +554,8 @@ declare const BitType: {
     readonly smartStandardTableNormativeCollapsible: "smart-standard-table-normative-collapsible";
     readonly standardArticleNonNormative: "standard-article-non-normative";
     readonly standardArticleNormative: "standard-article-normative";
+    readonly standardDefinitionListNonNormative: "standard-definition-list-non-normative";
+    readonly standardDefinitionListNormative: "standard-definition-list-normative";
     readonly standardExampleNonNormative: "standard-example-non-normative";
     readonly standardExampleNormative: "standard-example-normative";
     readonly standardImageFigureNonNormative: "standard-image-figure-non-normative";
@@ -849,6 +854,7 @@ declare const ConfigKey: {
     readonly property_enforceUpdateOverUserInput: "@enforceUpdateOverUserInput";
     readonly property_extractorExtractionTimestamp: "@extractorExtractionTimestamp";
     readonly property_isCaseSensitive: "@isCaseSensitive";
+    readonly property_isCollapsible: "@isCollapsible";
     readonly property_isInfoOnly: "@isInfoOnly";
     readonly property_isPublic: "@isPublic";
     readonly property_isTemplate: "@isTemplate";
@@ -1901,6 +1907,7 @@ interface BitJson {
     level: number;
     toc: boolean;
     progress: boolean;
+    isCollapsible: boolean;
     anchor: string;
     reference: string | string[];
     referenceEnd: string;
@@ -2537,6 +2544,7 @@ interface Bit {
     level?: number;
     toc?: Property;
     progress?: Property;
+    isCollapsible?: Property;
     anchor?: string;
     reference?: string;
     referenceEnd?: string;
@@ -2911,6 +2919,8 @@ declare const NodeType: {
     readonly internalPrintPdf: "internalPrintPdf";
     readonly internalPrintPdfValue: "internalPrintPdfValue";
     readonly isCaseSensitive: "isCaseSensitive";
+    readonly isCollapsible: "isCollapsible";
+    readonly isCollapsibleValue: "isCollapsibleValue";
     readonly isCommented: "isCommented";
     readonly isCorrect: "isCorrect";
     readonly isEditable: "isEditable";
@@ -3830,6 +3840,7 @@ declare const CardSetConfigKey: {
     readonly flashcard: "flashcard";
     readonly flashcard1: "flashcard1";
     readonly definitionList: "definitionList";
+    readonly definitionListPlain: "definitionListPlain";
     readonly elements: "elements";
     readonly statements: "statements";
     readonly quiz: "quiz";
@@ -4461,6 +4472,7 @@ declare class Builder extends BaseBuilder {
         level?: number | string;
         toc?: boolean;
         progress?: boolean;
+        isCollapsible?: boolean;
         anchor?: string;
         reference?: string;
         referenceEnd?: string;
@@ -6425,6 +6437,65 @@ declare class FileWriter extends StreamWriter {
     close(): Promise<void>;
 }
 
+/**
+ * Extract HTML tables and convert them into bitmark table bit-JSON.
+ *
+ * Produces an array of bare `BitJson`-shaped objects (`type` = `table-extended` or `table`) that
+ * can be fed directly into the existing JSON → AST → output pipeline. Cell content is built as
+ * `TextAst` (rich text nodes) directly; the downstream generators handle serialisation and
+ * breakscaping.
+ *
+ * See PLAN-013 for the full specification.
+ */
+
+type HtmlTableFormat = 'table' | 'table-extended';
+interface HtmlTableParseOptions {
+    /** Output bit type. Default `table-extended` (lossless). `table` is lossy. */
+    tableFormat?: HtmlTableFormat;
+    /** Keep unmappable tags as literal text instead of unwrapping them. Default false. */
+    keepUnknownTags?: boolean;
+    /** Called with a human-readable message when information is lost (e.g. lossy `table` output). */
+    onWarning?: (message: string) => void;
+}
+/** Loosely-typed table bit JSON (matches a subset of BitJson). */
+interface TableBitJson {
+    type: HtmlTableFormat;
+    format: 'bitmark++';
+    caption?: TextAst;
+    table: TableJson | TableExtendedJson;
+}
+declare class HtmlTableParser {
+    private keepUnknownTags;
+    /**
+     * Parse an HTML string and return one table bit per top-level `<table>`.
+     */
+    parse(html: string, options?: HtmlTableParseOptions): TableBitJson[];
+    /** Collect every `<table>` element, NOT descending into nested tables. */
+    private collectTopLevelTables;
+    private tableToBit;
+    private rowToCells;
+    private cellToJson;
+    private widthFromCell;
+    private isLossyAsBasic;
+    /**
+     * Convert a cell/li's child nodes into block-level TextAst nodes (paragraphs, lists, images).
+     */
+    private blockNodes;
+    /** Convert child nodes to a flat list of inline TextNodes, applying the given marks. */
+    private inlineNodes;
+    private inlineFromElement;
+    private inlineText;
+    private serializeOpenTag;
+    private isListTag;
+    private listNode;
+    private listType;
+    private listItemNode;
+    private taskItemNode;
+    private imageNode;
+    /** Trim leading/trailing whitespace from inline content (edges only). */
+    private trimInline;
+}
+
 /**
  * Info options for the parser
  */
@@ -6600,6 +6671,48 @@ interface ExtractPlainTextOptions {
      */
     inputFormat?: InputFormatType;
 }
+/**
+ * Options for {@link BitmarkParserGenerator.convertHtmlTable}
+ */
+interface ConvertHtmlTableOptions {
+    /**
+     * Force the input format, overriding auto-detection.
+     * - `html`: input is HTML; extract tables and output bitmark/JSON/AST
+     * - any other value: input is bitmark/JSON/AST; output HTML
+     */
+    inputFormat?: InputFormatType;
+    /**
+     * Output format.
+     * - HTML input: `bitmark` (default) | `json` | `ast` | `html` (re-emit / normalise)
+     * - bitmark/JSON/AST input: `html` (default, and only valid value)
+     */
+    outputFormat?: OutputType | 'html';
+    /**
+     * Bit type to emit when converting HTML to bits.
+     * `table-extended` (default, lossless) or `table` (lossy: drops spans/scope/sections).
+     */
+    tableFormat?: HtmlTableFormat;
+    /**
+     * Keep unmappable HTML tags as literal text instead of unwrapping them (HTML -> bits only).
+     */
+    keepUnknownTags?: boolean;
+    /**
+     * Specify a file to write the output to
+     */
+    outputFile?: string;
+    /**
+     * Options for the output file
+     */
+    fileOptions?: FileOptions;
+    /**
+     * Options for bitmark generation (HTML -> bitmark)
+     */
+    bitmarkOptions?: BitmarkOptions;
+    /**
+     * Options for JSON generation (HTML -> json)
+     */
+    jsonOptions?: JsonOptions;
+}
 /**
  * Breakscape options
  */
@@ -6704,6 +6817,10 @@ declare const InputFormat: {
      * Input is plain text
      */
     readonly plainText: "plainText";
+    /**
+     * Input is HTML (used by convertHtmlTable)
+     */
+    readonly html: "html";
 };
 type InputFormatType = EnumType<typeof InputFormat>;
 /**
@@ -6852,6 +6969,28 @@ declare class BitmarkParserGenerator {
      */
     convertText(input: string | unknown, options?: ConvertTextOptions): string | unknown | void;
     extractPlainText(input: string | unknown, options?: ExtractPlainTextOptions): string;
+    /**
+     * Convert between HTML tables and bitmark tables.
+     *
+     * Direction is auto-detected (override with `options.inputFormat`):
+     * - HTML input: every `<table>` is extracted and emitted as a `[.table-extended]` (or `[.table]`)
+     *   bit; output as bitmark (default), JSON, AST, or HTML (re-emit).
+     * - bitmark / JSON / AST input: each `table` / `table-extended` bit is rendered as an HTML
+     *   `<table>` fragment.
+     *
+     * Cell content is reproduced verbatim except inline conversion to bitmark marks (bold, italic,
+     * superscript, etc.), with lists and images mapped to their bitmark equivalents.
+     *
+     * @param input - HTML, bitmark, JSON or AST string; or a parsed JSON/AST value; or a file path.
+     * @param options - the conversion options
+     * @returns the converted output as a string (or object for JSON/AST), or void when writing a file
+     * @throws Error if any error occurs
+     */
+    convertHtmlTable(input: string | unknown, options?: ConvertHtmlTableOptions): string | unknown | void;
+    /**
+     * Write an HTML string to the configured output file, or return it.
+     */
+    private outputHtml;
     /**
      * Breakscape bitmark text.
      *
@@ -7114,4 +7253,39 @@ declare class JsonFileGenerator implements Generator<BitmarkAst> {
     generateSync(_ast: BitmarkAst): void;
 }
 
-export { type AppLinkResourceJson, type AppLinkResourceWrapperJson, type ArticleResourceJson, type ArticleResourceWrapperJson, Ast, type AstWalkCallbacks, type AudioEmbedResourceJson, type AudioEmbedResourceWrapperJson, type AudioLinkResourceJson, type AudioLinkResourceWrapperJson, type AudioResourceJson, type AudioResourceWrapperJson, type Bbox, type Bit, type BitJson, BitType, type BitTypeType, type BitWrapperJson, type BitmarkAst, BitmarkFileGenerator, BitmarkGenerator, type BitmarkOptions, BitmarkParser, BitmarkParserGenerator, BitmarkParserType, type BitmarkParserTypeType, BitmarkStringGenerator, BitmarkVersion, type BitmarkVersionType, type Body, type BodyBitJson, type BodyBitsJson, type BodyPart, BodyTextFormat, type BodyTextFormatType, type BookJson, type BookReferenceJson, type BotResponseJson, type BoundingBoxEntry, BoundingBoxIndex, type BreakscapeOptions, type BreakscapedString, Builder, type CardBit, type CardNode, CardSetVersion, type CardSetVersionType, type ChoiceJson, type CodeBlockTextNode, type CodeBlockTextNodeAttributes, type CommentMark, type ConvertOptions, type ConvertTextOptions, type CreateAstOptions, type DefinitionListItemJson, type DocumentDownloadResourceJson, type DocumentDownloadResourceWrapperJson, type DocumentEmbedResourceJson, type DocumentEmbedResourceWrapperJson, type DocumentLinkResourceJson, type DocumentLinkResourceWrapperJson, type DocumentResourceJson, type DocumentResourceWrapperJson, type Example, type ExampleJson, type ExtRefMark, type ExtRefMarkAttibutes, type ExtraProperties, type FeedbackChoiceJson, type FeedbackJson, type FeedbackReasonJson, type FileOptions, FileWriter, type FlashcardJson, type Footer, type FootnoteAttibutes, type FootnoteMark, type FromBitsOptions, type GapJson, type Generator, type GroupTagJson, type HeadingJson, type HeadingTextNode, type HeadingTextNodeAttributes, type HighlightJson, type HighlightTextJson, type ImageInlineTextNode, type ImageLinkResourceJson, type ImageLinkResourceWrapperJson, type ImageResourceJson, type ImageResourceWrapperJson, type ImageSourceJson, type ImageTextNode, type ImageTextNodeAttributes, InfoFormat, type InfoFormatType, type InfoOptions, InfoType, type InfoTypeType, type IngredientJson, Input, InputFormat, type InputFormatType, type InputType, JsonFileGenerator, JsonGenerator, type JsonOptions, JsonParser, JsonStringGenerator, type LatexTextNode, type LatexTextNodeAttributes, type LinkMark, type LinkMarkAttibutes, type ListItemJson, type ListTextNode, type ListTextNodeAttributes, type MarkConfigJson, type MarkJson, type MatrixCellJson, type MatrixJson, type MediaAttributes, type Node, type NodeInfo, NodeType, type NodeTypeType, Output, type OutputType, type PairJson, type ParserJson, type PersonJson, type UpgradeOptions as PrettifyOptions, type PronunciationTableCellJson, type PronunciationTableJson, type Property, type QuestionJson, type QuizJson, type RatingLevelStartEndJson, type RefMark, type RefMarkAttibutes, ResourceBuilder, type ResourceDataJson, type ResourceJson, type ResourceTypeType, type ResourceWrapperJson, type ResponseJson, type SectionTextNode, type SelectJson, type SelectOptionJson, type ServingsJson, type StatementJson, type StillImageFilmEmbedResourceJson, type StillImageFilmEmbedResourceWrapperJson, type StillImageFilmLinkResourceJson, type StillImageFilmLinkResourceWrapperJson, type StillImageFilmResourceJson, type StillImageFilmResourceWrapperJson, StreamWriter, StringWriter, type SymbolMark, type TableCellJson, type TableExtendedJson, type TableJson, type TableRowJson, type TableSectionJson, type TaskItemTextNode, type TaskItemTextNodeAttributes, type TechnicalTermJson, type JsonText as Text, type TextAndIconJson, type TextAst, type TextJsonOptions, type TextMark, type TextMarkAttibutes, TextMarkType, type TextMarkTypeType, type TextNode, type TextNodeAttibutes, TextNodeType, type TextNodeTypeType, type UnbreakscapeOptions, type UpgradeOptions, type VideoEmbedResourceJson, type VideoEmbedResourceWrapperJson, type VideoLinkResourceJson, type VideoLinkResourceWrapperJson, type VideoResourceJson, type VideoResourceWrapperJson, type WebsiteLinkResourceJson, type WebsiteLinkResourceWrapperJson, type Writer, type XRefMark, type XRefMarkAttibutes, parse as bitmarkTextParse };
+/**
+ * Generate HTML `<table>` fragments from bitmark table bit-JSON.
+ *
+ * Consumes the JSON bit array (a string or parsed value), like {@link PlainTextGenerator}, and
+ * renders each `table` / `table-extended` bit as a pretty-printed HTML `<table>` fragment. Cell
+ * content (TextAst) is rendered back to inline/block HTML, mapping bitmark marks to inline tags.
+ *
+ * See PLAN-013 for the full specification.
+ */
+declare class HtmlTableGenerator {
+    private readonly 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: string | unknown): string;
+    private collectBits;
+    private renderTableBit;
+    private toExtended;
+    private renderSection;
+    private renderCell;
+    private asTextAst;
+    private cellContentToHtml;
+    private blockToHtml;
+    private inlineToHtml;
+    private inlineNodeToHtml;
+    private wrapMarks;
+    private listToHtml;
+    private listTag;
+    private listItemToHtml;
+    private imageToHtml;
+    private escapeText;
+    private escapeAttr;
+}
+
+export { type AppLinkResourceJson, type AppLinkResourceWrapperJson, type ArticleResourceJson, type ArticleResourceWrapperJson, Ast, type AstWalkCallbacks, type AudioEmbedResourceJson, type AudioEmbedResourceWrapperJson, type AudioLinkResourceJson, type AudioLinkResourceWrapperJson, type AudioResourceJson, type AudioResourceWrapperJson, type Bbox, type Bit, type BitJson, BitType, type BitTypeType, type BitWrapperJson, type BitmarkAst, BitmarkFileGenerator, BitmarkGenerator, type BitmarkOptions, BitmarkParser, BitmarkParserGenerator, BitmarkParserType, type BitmarkParserTypeType, BitmarkStringGenerator, BitmarkVersion, type BitmarkVersionType, type Body, type BodyBitJson, type BodyBitsJson, type BodyPart, BodyTextFormat, type BodyTextFormatType, type BookJson, type BookReferenceJson, type BotResponseJson, type BoundingBoxEntry, BoundingBoxIndex, type BreakscapeOptions, type BreakscapedString, Builder, type CardBit, type CardNode, CardSetVersion, type CardSetVersionType, type ChoiceJson, type CodeBlockTextNode, type CodeBlockTextNodeAttributes, type CommentMark, type ConvertHtmlTableOptions, type ConvertOptions, type ConvertTextOptions, type CreateAstOptions, type DefinitionListItemJson, type DocumentDownloadResourceJson, type DocumentDownloadResourceWrapperJson, type DocumentEmbedResourceJson, type DocumentEmbedResourceWrapperJson, type DocumentLinkResourceJson, type DocumentLinkResourceWrapperJson, type DocumentResourceJson, type DocumentResourceWrapperJson, type Example, type ExampleJson, type ExtRefMark, type ExtRefMarkAttibutes, type ExtraProperties, type FeedbackChoiceJson, type FeedbackJson, type FeedbackReasonJson, type FileOptions, FileWriter, type FlashcardJson, type Footer, type FootnoteAttibutes, type FootnoteMark, type FromBitsOptions, type GapJson, type Generator, type GroupTagJson, type HeadingJson, type HeadingTextNode, type HeadingTextNodeAttributes, type HighlightJson, type HighlightTextJson, type HtmlTableFormat, HtmlTableGenerator, type HtmlTableParseOptions, HtmlTableParser, type ImageInlineTextNode, type ImageLinkResourceJson, type ImageLinkResourceWrapperJson, type ImageResourceJson, type ImageResourceWrapperJson, type ImageSourceJson, type ImageTextNode, type ImageTextNodeAttributes, InfoFormat, type InfoFormatType, type InfoOptions, InfoType, type InfoTypeType, type IngredientJson, Input, InputFormat, type InputFormatType, type InputType, JsonFileGenerator, JsonGenerator, type JsonOptions, JsonParser, JsonStringGenerator, type LatexTextNode, type LatexTextNodeAttributes, type LinkMark, type LinkMarkAttibutes, type ListItemJson, type ListTextNode, type ListTextNodeAttributes, type MarkConfigJson, type MarkJson, type MatrixCellJson, type MatrixJson, type MediaAttributes, type Node, type NodeInfo, NodeType, type NodeTypeType, Output, type OutputType, type PairJson, type ParserJson, type PersonJson, type UpgradeOptions as PrettifyOptions, type PronunciationTableCellJson, type PronunciationTableJson, type Property, type QuestionJson, type QuizJson, type RatingLevelStartEndJson, type RefMark, type RefMarkAttibutes, ResourceBuilder, type ResourceDataJson, type ResourceJson, type ResourceTypeType, type ResourceWrapperJson, type ResponseJson, type SectionTextNode, type SelectJson, type SelectOptionJson, type ServingsJson, type StatementJson, type StillImageFilmEmbedResourceJson, type StillImageFilmEmbedResourceWrapperJson, type StillImageFilmLinkResourceJson, type StillImageFilmLinkResourceWrapperJson, type StillImageFilmResourceJson, type StillImageFilmResourceWrapperJson, StreamWriter, StringWriter, type SymbolMark, type TableCellJson, type TableExtendedJson, type TableJson, type TableRowJson, type TableSectionJson, type TaskItemTextNode, type TaskItemTextNodeAttributes, type TechnicalTermJson, type JsonText as Text, type TextAndIconJson, type TextAst, type TextJsonOptions, type TextMark, type TextMarkAttibutes, TextMarkType, type TextMarkTypeType, type TextNode, type TextNodeAttibutes, TextNodeType, type TextNodeTypeType, type UnbreakscapeOptions, type UpgradeOptions, type VideoEmbedResourceJson, type VideoEmbedResourceWrapperJson, type VideoLinkResourceJson, type VideoLinkResourceWrapperJson, type VideoResourceJson, type VideoResourceWrapperJson, type WebsiteLinkResourceJson, type WebsiteLinkResourceWrapperJson, type Writer, type XRefMark, type XRefMarkAttibutes, parse as bitmarkTextParse };