@gmb/bitmark-parser 6.1.4 → 6.3.0

package/dist/legacy.d.cts

@@ -1,3 +1,4 @@
+/** @internal */
 type EnumType<T> = T[keyof T];
 /** Input type enumeration */
 declare const Input: {
@@ -76,21 +77,32 @@ interface FileOptions {
 }
 /** Options for bitmark generation */
 interface BitmarkOptions {
-    explicitTextFormat?: boolean;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    explicitTextFormat?: false;
     prettifyJson?: boolean | number;
-    cardSetVersion?: CardSetVersionType;
+    /** bitmark v3 only — card set version `1` throws `LegacyUnsupportedError` at runtime. */
+    cardSetVersion?: typeof CardSetVersion.v2;
     spacesAroundValues?: number | boolean;
-    debugGenerationInline?: boolean;
-    noBreakscaping?: boolean;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    debugGenerationInline?: false;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    noBreakscaping?: false;
 }
 /** Options for JSON generation */
 interface JsonOptions {
     enableWarnings?: boolean | number;
     prettify?: boolean | number;
     stringify?: boolean;
-    textAsPlainText?: boolean;
+    /** bitmark v3 only — `true` throws `LegacyUnsupportedError` at runtime. */
+    textAsPlainText?: false;
+    /**
+     * Exclude unknown properties from the JSON output (default: `false` —
+     * unknown properties are included, as bpg). The parser's warning text
+     * references the new API's inverse flag (`includeUnknownProperties`).
+     */
     excludeUnknownProperties?: boolean;
-    debugGenerationInline?: boolean;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    debugGenerationInline?: false;
 }
 /** Options for bitmark text JSON generation */
 interface TextJsonOptions {
@@ -105,7 +117,8 @@ interface InfoOptions {
 }
 /** Conversion options for bitmark / JSON conversion */
 interface ConvertOptions {
-    bitmarkVersion?: BitmarkVersionType;
+    /** bitmark v3 only — version `2` throws `LegacyUnsupportedError` at runtime. */
+    bitmarkVersion?: typeof BitmarkVersion.v3;
     bitmarkParserType?: BitmarkParserTypeType;
     inputFormat?: InputType;
     outputFormat?: OutputType;
@@ -116,7 +129,8 @@ interface ConvertOptions {
 }
 /** Prettify options for bitmark / JSON prettify / validate */
 interface UpgradeOptions {
-    bitmarkVersion?: BitmarkVersionType;
+    /** bitmark v3 only — version `2` throws `LegacyUnsupportedError` at runtime. */
+    bitmarkVersion?: typeof BitmarkVersion.v3;
     bitmarkParserType?: BitmarkParserTypeType;
     inputFormat?: InputType;
     outputFile?: string;
@@ -146,7 +160,8 @@ interface ConvertHtmlTableOptions {
     outputFormat?: OutputType | "html";
     tableFormat?: string;
     keepUnknownTags?: boolean;
-    noBreakscaping?: boolean;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    noBreakscaping?: false;
     outputFile?: string;
     fileOptions?: FileOptions;
     bitmarkOptions?: BitmarkOptions;
@@ -342,10 +357,14 @@ declare class Builder {
      * NOTE (documented divergences from bpg):
      * - the return value is bit JSON, not bpg's internal AST node model;
      * - `resourceType` (an inference hint in bpg) is not carried into the
-     *   JSON — the attached `resource` object is authoritative;
-     * - more than one entry in `resources` passes through under a
-     *   `resources` key (kept visible, not silently dropped) — the canonical
-     *   single attachment is `resource`.
+     *   JSON — the attached `resource` object is authoritative.
+     *
+     * `resources` follows bpg's JsonGenerator routing: on a bit whose config
+     * maps a repeatable resource tag group onto a collection key (e.g.
+     * `images` / `logos` — see the generated RESOURCE_COLLECTION_KEYS), the
+     * matching-type entries land under that key; on every other bit the first
+     * entry becomes the canonical single `resource` (as bpg: "if there is
+     * more than one resource, use the first one").
      */
     buildBit(data: Record<string, unknown>, _options?: BuildBitOptions): Record<string, unknown>;
     /**
@@ -1565,4 +1584,4 @@ interface BitWrapperJson {
     parser?: ParserJson;
 }
 
-export { type AppLinkResourceJson, type AppLinkResourceWrapperJson, type ArticleResourceJson, type ArticleResourceWrapperJson, Ast, type AudioEmbedResourceJson, type AudioEmbedResourceWrapperJson, type AudioLinkResourceJson, type AudioLinkResourceWrapperJson, type AudioResourceJson, type AudioResourceWrapperJson, type BaseBodyBitJson, type BaseResourceJson, type BitJson, BitType, type BitTypeType, type BitWrapperJson, BitmarkFileGenerator, BitmarkGenerator, type BitmarkOptions, BitmarkParser, BitmarkParserGenerator, BitmarkParserType, type BitmarkParserTypeType, BitmarkStringGenerator, BitmarkVersion, type BitmarkVersionType, type BodyBitJson, type BodyBitsJson, BodyTextFormat, type BodyTextFormatType, type BookJson, type BookReferenceJson, type BotResponseJson, BoundingBoxIndex, type BreakscapeOptions, type BuildBitOptions, Builder, 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 ExampleJson, type ExtRefMark, type ExtRefMarkAttibutes, type ExtractPlainTextOptions, type FeedbackChoiceJson, type FeedbackJson, type FeedbackReasonJson, type FileOptions, FileWriter, type FlashcardJson, type FootnoteAttibutes, type FootnoteMark, type GapJson, type GroupTagJson, type HeadingJson, type HeadingTextNode, type HeadingTextNodeAttributes, type HighlightJson, type HighlightTextJson, HtmlTableGenerator, HtmlTableParser, type ImageInlineTextNode, type ImageLinkResourceJson, type ImageLinkResourceWrapperJson, type ImageResourceJson, type ImageResourceWrapperJson, type ImageResponsiveResourceJson, type ImageResponsiveResourceWrapperJson, 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 JsonText, type LatexTextNode, type LatexTextNodeAttributes, type LegacyPseudoAst, LegacyUnsupportedError, type LinkMark, type LinkMarkAttibutes, type ListItemJson, type ListTextNode, type ListTextNodeAttributes, type MarkConfigJson, type MarkJson, type MatrixCellJson, type MatrixJson, type MediaAttributes, NodeType, Output, type OutputType, type PairJson, type ParserError, type ParserInfo, type ParserJson, type ParserLocation, type PersonJson, type PronunciationTableCellJson, type PronunciationTableJson, 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 SymbolMarkAttibutes, type TableCellJson, type TableExtendedJson, type TableJson, type TableRowJson, type TableSectionJson, type TaskItemTextNode, type TaskItemTextNodeAttributes, type TechnicalTermJson, type TextAndIconJson, type TextAst, type TextFormatType, type TextJsonOptions, TextLocation, type TextLocationType, 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 XRefMark, type XRefMarkAttibutes, bitmarkTextParse, isPseudoAst };
+export { type AppLinkResourceJson, type AppLinkResourceWrapperJson, type ArticleResourceJson, type ArticleResourceWrapperJson, Ast, type AudioEmbedResourceJson, type AudioEmbedResourceWrapperJson, type AudioLinkResourceJson, type AudioLinkResourceWrapperJson, type AudioResourceJson, type AudioResourceWrapperJson, type BaseBodyBitJson, type BaseResourceJson, type BitJson, BitType, type BitTypeType, type BitWrapperJson, BitmarkFileGenerator, BitmarkGenerator, type BitmarkOptions, BitmarkParser, BitmarkParserGenerator, BitmarkParserType, type BitmarkParserTypeType, BitmarkStringGenerator, BitmarkVersion, type BitmarkVersionType, type BodyBitJson, type BodyBitsJson, BodyTextFormat, type BodyTextFormatType, type BookJson, type BookReferenceJson, type BotResponseJson, BoundingBoxIndex, type BreakscapeOptions, type BuildBitOptions, Builder, 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 ExampleJson, type ExtRefMark, type ExtRefMarkAttibutes, type ExtractPlainTextOptions, type FeedbackChoiceJson, type FeedbackJson, type FeedbackReasonJson, type FileOptions, FileWriter, type FlashcardJson, type FootnoteAttibutes, type FootnoteMark, type GapJson, type GroupTagJson, type HeadingJson, type HeadingTextNode, type HeadingTextNodeAttributes, type HighlightJson, type HighlightTextJson, HtmlTableGenerator, HtmlTableParser, type ImageInlineTextNode, type ImageLinkResourceJson, type ImageLinkResourceWrapperJson, type ImageResourceJson, type ImageResourceWrapperJson, type ImageResponsiveResourceJson, type ImageResponsiveResourceWrapperJson, 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 JsonText, type LatexTextNode, type LatexTextNodeAttributes, type LegacyPseudoAst, LegacyUnsupportedError, type LinkMark, type LinkMarkAttibutes, type ListItemJson, type ListTextNode, type ListTextNodeAttributes, type MarkConfigJson, type MarkJson, type MatrixCellJson, type MatrixJson, type MediaAttributes, NodeType, Output, type OutputType, type PairJson, type ParserError, type ParserInfo, type ParserJson, type ParserLocation, type PersonJson, type PronunciationTableCellJson, type PronunciationTableJson, type QuestionJson, type QuizJson, type RatingLevelStartEndJson, type RefMark, type RefMarkAttibutes, ResourceBuilder, type ResourceDataJson, type ResourceJson, type ResourceMethod, 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 SymbolMarkAttibutes, 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 TextFormatType, type TextJsonOptions, TextLocation, type TextLocationType, 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 XRefMark, type XRefMarkAttibutes, bitmarkTextParse, isPseudoAst };

package/dist/legacy.d.ts

@@ -1,3 +1,4 @@
+/** @internal */
 type EnumType<T> = T[keyof T];
 /** Input type enumeration */
 declare const Input: {
@@ -76,21 +77,32 @@ interface FileOptions {
 }
 /** Options for bitmark generation */
 interface BitmarkOptions {
-    explicitTextFormat?: boolean;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    explicitTextFormat?: false;
     prettifyJson?: boolean | number;
-    cardSetVersion?: CardSetVersionType;
+    /** bitmark v3 only — card set version `1` throws `LegacyUnsupportedError` at runtime. */
+    cardSetVersion?: typeof CardSetVersion.v2;
     spacesAroundValues?: number | boolean;
-    debugGenerationInline?: boolean;
-    noBreakscaping?: boolean;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    debugGenerationInline?: false;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    noBreakscaping?: false;
 }
 /** Options for JSON generation */
 interface JsonOptions {
     enableWarnings?: boolean | number;
     prettify?: boolean | number;
     stringify?: boolean;
-    textAsPlainText?: boolean;
+    /** bitmark v3 only — `true` throws `LegacyUnsupportedError` at runtime. */
+    textAsPlainText?: false;
+    /**
+     * Exclude unknown properties from the JSON output (default: `false` —
+     * unknown properties are included, as bpg). The parser's warning text
+     * references the new API's inverse flag (`includeUnknownProperties`).
+     */
     excludeUnknownProperties?: boolean;
-    debugGenerationInline?: boolean;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    debugGenerationInline?: false;
 }
 /** Options for bitmark text JSON generation */
 interface TextJsonOptions {
@@ -105,7 +117,8 @@ interface InfoOptions {
 }
 /** Conversion options for bitmark / JSON conversion */
 interface ConvertOptions {
-    bitmarkVersion?: BitmarkVersionType;
+    /** bitmark v3 only — version `2` throws `LegacyUnsupportedError` at runtime. */
+    bitmarkVersion?: typeof BitmarkVersion.v3;
     bitmarkParserType?: BitmarkParserTypeType;
     inputFormat?: InputType;
     outputFormat?: OutputType;
@@ -116,7 +129,8 @@ interface ConvertOptions {
 }
 /** Prettify options for bitmark / JSON prettify / validate */
 interface UpgradeOptions {
-    bitmarkVersion?: BitmarkVersionType;
+    /** bitmark v3 only — version `2` throws `LegacyUnsupportedError` at runtime. */
+    bitmarkVersion?: typeof BitmarkVersion.v3;
     bitmarkParserType?: BitmarkParserTypeType;
     inputFormat?: InputType;
     outputFile?: string;
@@ -146,7 +160,8 @@ interface ConvertHtmlTableOptions {
     outputFormat?: OutputType | "html";
     tableFormat?: string;
     keepUnknownTags?: boolean;
-    noBreakscaping?: boolean;
+    /** Not supported — `true` throws `LegacyUnsupportedError` at runtime. */
+    noBreakscaping?: false;
     outputFile?: string;
     fileOptions?: FileOptions;
     bitmarkOptions?: BitmarkOptions;
@@ -342,10 +357,14 @@ declare class Builder {
      * NOTE (documented divergences from bpg):
      * - the return value is bit JSON, not bpg's internal AST node model;
      * - `resourceType` (an inference hint in bpg) is not carried into the
-     *   JSON — the attached `resource` object is authoritative;
-     * - more than one entry in `resources` passes through under a
-     *   `resources` key (kept visible, not silently dropped) — the canonical
-     *   single attachment is `resource`.
+     *   JSON — the attached `resource` object is authoritative.
+     *
+     * `resources` follows bpg's JsonGenerator routing: on a bit whose config
+     * maps a repeatable resource tag group onto a collection key (e.g.
+     * `images` / `logos` — see the generated RESOURCE_COLLECTION_KEYS), the
+     * matching-type entries land under that key; on every other bit the first
+     * entry becomes the canonical single `resource` (as bpg: "if there is
+     * more than one resource, use the first one").
      */
     buildBit(data: Record<string, unknown>, _options?: BuildBitOptions): Record<string, unknown>;
     /**
@@ -1565,4 +1584,4 @@ interface BitWrapperJson {
     parser?: ParserJson;
 }
 
-export { type AppLinkResourceJson, type AppLinkResourceWrapperJson, type ArticleResourceJson, type ArticleResourceWrapperJson, Ast, type AudioEmbedResourceJson, type AudioEmbedResourceWrapperJson, type AudioLinkResourceJson, type AudioLinkResourceWrapperJson, type AudioResourceJson, type AudioResourceWrapperJson, type BaseBodyBitJson, type BaseResourceJson, type BitJson, BitType, type BitTypeType, type BitWrapperJson, BitmarkFileGenerator, BitmarkGenerator, type BitmarkOptions, BitmarkParser, BitmarkParserGenerator, BitmarkParserType, type BitmarkParserTypeType, BitmarkStringGenerator, BitmarkVersion, type BitmarkVersionType, type BodyBitJson, type BodyBitsJson, BodyTextFormat, type BodyTextFormatType, type BookJson, type BookReferenceJson, type BotResponseJson, BoundingBoxIndex, type BreakscapeOptions, type BuildBitOptions, Builder, 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 ExampleJson, type ExtRefMark, type ExtRefMarkAttibutes, type ExtractPlainTextOptions, type FeedbackChoiceJson, type FeedbackJson, type FeedbackReasonJson, type FileOptions, FileWriter, type FlashcardJson, type FootnoteAttibutes, type FootnoteMark, type GapJson, type GroupTagJson, type HeadingJson, type HeadingTextNode, type HeadingTextNodeAttributes, type HighlightJson, type HighlightTextJson, HtmlTableGenerator, HtmlTableParser, type ImageInlineTextNode, type ImageLinkResourceJson, type ImageLinkResourceWrapperJson, type ImageResourceJson, type ImageResourceWrapperJson, type ImageResponsiveResourceJson, type ImageResponsiveResourceWrapperJson, 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 JsonText, type LatexTextNode, type LatexTextNodeAttributes, type LegacyPseudoAst, LegacyUnsupportedError, type LinkMark, type LinkMarkAttibutes, type ListItemJson, type ListTextNode, type ListTextNodeAttributes, type MarkConfigJson, type MarkJson, type MatrixCellJson, type MatrixJson, type MediaAttributes, NodeType, Output, type OutputType, type PairJson, type ParserError, type ParserInfo, type ParserJson, type ParserLocation, type PersonJson, type PronunciationTableCellJson, type PronunciationTableJson, 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 SymbolMarkAttibutes, type TableCellJson, type TableExtendedJson, type TableJson, type TableRowJson, type TableSectionJson, type TaskItemTextNode, type TaskItemTextNodeAttributes, type TechnicalTermJson, type TextAndIconJson, type TextAst, type TextFormatType, type TextJsonOptions, TextLocation, type TextLocationType, 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 XRefMark, type XRefMarkAttibutes, bitmarkTextParse, isPseudoAst };
+export { type AppLinkResourceJson, type AppLinkResourceWrapperJson, type ArticleResourceJson, type ArticleResourceWrapperJson, Ast, type AudioEmbedResourceJson, type AudioEmbedResourceWrapperJson, type AudioLinkResourceJson, type AudioLinkResourceWrapperJson, type AudioResourceJson, type AudioResourceWrapperJson, type BaseBodyBitJson, type BaseResourceJson, type BitJson, BitType, type BitTypeType, type BitWrapperJson, BitmarkFileGenerator, BitmarkGenerator, type BitmarkOptions, BitmarkParser, BitmarkParserGenerator, BitmarkParserType, type BitmarkParserTypeType, BitmarkStringGenerator, BitmarkVersion, type BitmarkVersionType, type BodyBitJson, type BodyBitsJson, BodyTextFormat, type BodyTextFormatType, type BookJson, type BookReferenceJson, type BotResponseJson, BoundingBoxIndex, type BreakscapeOptions, type BuildBitOptions, Builder, 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 ExampleJson, type ExtRefMark, type ExtRefMarkAttibutes, type ExtractPlainTextOptions, type FeedbackChoiceJson, type FeedbackJson, type FeedbackReasonJson, type FileOptions, FileWriter, type FlashcardJson, type FootnoteAttibutes, type FootnoteMark, type GapJson, type GroupTagJson, type HeadingJson, type HeadingTextNode, type HeadingTextNodeAttributes, type HighlightJson, type HighlightTextJson, HtmlTableGenerator, HtmlTableParser, type ImageInlineTextNode, type ImageLinkResourceJson, type ImageLinkResourceWrapperJson, type ImageResourceJson, type ImageResourceWrapperJson, type ImageResponsiveResourceJson, type ImageResponsiveResourceWrapperJson, 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 JsonText, type LatexTextNode, type LatexTextNodeAttributes, type LegacyPseudoAst, LegacyUnsupportedError, type LinkMark, type LinkMarkAttibutes, type ListItemJson, type ListTextNode, type ListTextNodeAttributes, type MarkConfigJson, type MarkJson, type MatrixCellJson, type MatrixJson, type MediaAttributes, NodeType, Output, type OutputType, type PairJson, type ParserError, type ParserInfo, type ParserJson, type ParserLocation, type PersonJson, type PronunciationTableCellJson, type PronunciationTableJson, type QuestionJson, type QuizJson, type RatingLevelStartEndJson, type RefMark, type RefMarkAttibutes, ResourceBuilder, type ResourceDataJson, type ResourceJson, type ResourceMethod, 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 SymbolMarkAttibutes, 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 TextFormatType, type TextJsonOptions, TextLocation, type TextLocationType, 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 XRefMark, type XRefMarkAttibutes, bitmarkTextParse, isPseudoAst };

package/dist/legacy.js

@@ -45,7 +45,7 @@ function initLegacyNode(wasm2) {
 // src/generated/package_info.ts
 var PACKAGE_INFO = {
   "name": "@gmb/bitmark-parser",
-  "version": "6.1.4",
+  "version": "6.3.0",
   "author": "Get More Brain Ltd <info@getmorebrain.com>",
   "license": "ISC",
   "description": "A parser for bitmark text, powered by WebAssembly."
@@ -76,16 +76,14 @@ function validateVersionOptions(opts) {
 }
 function validateBitmarkOptions(o) {
   if (o.explicitTextFormat) unsupportedOption("bitmarkOptions.explicitTextFormat");
-  if (o.prettifyJson !== void 0 && o.prettifyJson !== false) {
-    unsupportedOption("bitmarkOptions.prettifyJson", "embedded-JSON body prettification is not supported");
+  if (o.cardSetVersion === 1) {
+    unsupportedOption("bitmarkOptions.cardSetVersion: 1", V3_ONLY);
   }
-  if (o.cardSetVersion === 1) unsupportedOption("bitmarkOptions.cardSetVersion: 1", V3_ONLY);
   if (o.debugGenerationInline) unsupportedOption("bitmarkOptions.debugGenerationInline");
   if (o.noBreakscaping) unsupportedOption("bitmarkOptions.noBreakscaping");
 }
 function validateJsonOptions(o) {
   if (o.textAsPlainText) unsupportedOption("jsonOptions.textAsPlainText", V3_ONLY);
-  if (o.excludeUnknownProperties) unsupportedOption("jsonOptions.excludeUnknownProperties");
   if (o.debugGenerationInline) unsupportedOption("jsonOptions.debugGenerationInline");
 }
 function prettyIndent(prettify) {
@@ -121,6 +119,14 @@ function isPseudoAst(v) {
   return v !== null && typeof v === "object" && (PSEUDO_AST_MARKER in v || Array.isArray(v.bits));
 }
 
+// src/legacy/generated/resource-collection-keys.ts
+var RESOURCE_COLLECTION_KEYS = {
+  "extractor-image": { key: "images", resourceType: "image" },
+  "extractor-image-collapsible": { key: "images", resourceType: "image" },
+  "images-logo-grave": { key: "logos", resourceType: "image" },
+  "prototype-images": { key: "images", resourceType: "image" }
+};
+
 // src/legacy/builder.ts
 var BUILT_BIT_PARSER = /* @__PURE__ */ Symbol.for("@gmb/bitmark-parser/legacy-built-bit-parser");
 var DATA_KEY_TO_JSON_KEY = {
@@ -165,10 +171,14 @@ var Builder = class {
    * NOTE (documented divergences from bpg):
    * - the return value is bit JSON, not bpg's internal AST node model;
    * - `resourceType` (an inference hint in bpg) is not carried into the
-   *   JSON — the attached `resource` object is authoritative;
-   * - more than one entry in `resources` passes through under a
-   *   `resources` key (kept visible, not silently dropped) — the canonical
-   *   single attachment is `resource`.
+   *   JSON — the attached `resource` object is authoritative.
+   *
+   * `resources` follows bpg's JsonGenerator routing: on a bit whose config
+   * maps a repeatable resource tag group onto a collection key (e.g.
+   * `images` / `logos` — see the generated RESOURCE_COLLECTION_KEYS), the
+   * matching-type entries land under that key; on every other bit the first
+   * entry becomes the canonical single `resource` (as bpg: "if there is
+   * more than one resource, use the first one").
    */
   buildBit(data, _options) {
     const wasm2 = getLegacyWasm();
@@ -204,12 +214,15 @@ var Builder = class {
       delete src.__isDefaultExample;
     }
     const resources = src.resources;
-    if (resources !== void 0) {
-      if (Array.isArray(resources)) {
-        if (resources.length === 1) bit.resource = resources[0];
-        else if (resources.length > 1) bit.resources = resources;
-      } else {
-        bit.resource = resources;
+    if (resources !== void 0 && bitType !== void 0) {
+      const list = Array.isArray(resources) ? resources : [resources];
+      const collection = RESOURCE_COLLECTION_KEYS[bitType];
+      if (collection) {
+        bit[collection.key] = list.filter(
+          (r) => r !== null && typeof r === "object" && r.type === collection.resourceType
+        );
+      } else if (list.length >= 1) {
+        bit.resource = list[0];
       }
       delete src.resources;
     }
@@ -227,7 +240,7 @@ var Builder = class {
       }
     }
     this.parseStringTexts(bit);
-    const out = wasm2.convert(JSON.stringify([{ bit }]), "json", "json", "optimized", false, 2, 1);
+    const out = wasm2.convert(JSON.stringify([{ bit }]), "json", "json", "optimized", false, 2, 1, false);
     if (out.startsWith("error:")) {
       throw new Error(out.slice("error:".length).trim());
     }
@@ -351,8 +364,10 @@ var BitmarkParserGenerator = class {
     const outputFormat = opts.outputFormat ?? (isBitmark ? "json" : "bitmark");
     const coreFormat = outputFormat === "ast" ? "json" : outputFormat;
     const { pretty, indent } = prettyIndent(jsonOptions.prettify);
+    const emit = coreFormat === "bitmark" ? prettyIndent(bitmarkOptions.prettifyJson) : { pretty, indent };
     const spaces = spacesAround(bitmarkOptions.spacesAroundValues);
-    const out = wasm2.convert(source, isBitmark ? "bitmark" : "json", coreFormat, "optimized", pretty, indent, spaces);
+    const includeUnknown = !jsonOptions.excludeUnknownProperties;
+    const out = wasm2.convert(source, isBitmark ? "bitmark" : "json", coreFormat, "optimized", emit.pretty, emit.indent, spaces, includeUnknown);
     this.throwOnError(out);
     if (outputFormat === "bitmark" || outputFormat === "text") {
       return this.deliver(out, opts.outputFile, opts.fileOptions);
@@ -382,7 +397,9 @@ var BitmarkParserGenerator = class {
     this.checkBrowserFileWrite(opts.outputFile);
     const wasm2 = getLegacyWasm();
     const { source, isBitmark } = this.resolveInput(input, opts.inputFormat);
-    const { pretty, indent } = prettyIndent(jsonOptions.prettify);
+    const { pretty, indent } = prettyIndent(
+      isBitmark ? bitmarkOptions.prettifyJson : jsonOptions.prettify
+    );
     const spaces = spacesAround(bitmarkOptions.spacesAroundValues);
     const out = wasm2.canonicalize(source, isBitmark ? "bitmark" : "json", "optimized", pretty, indent, spaces);
     this.throwOnError(out);
@@ -434,7 +451,7 @@ var BitmarkParserGenerator = class {
     const isHtmlInput = opts.inputFormat === "html" || opts.inputFormat === void 0 && typeof input === "string" && /<table[\s>]/iu.test(inStr);
     if (!isHtmlInput) {
       const { source, isBitmark } = this.resolveInput(input, void 0);
-      const out2 = wasm2.convert(source, isBitmark ? "bitmark" : "json", "html", "optimized", false, 2, 1);
+      const out2 = wasm2.convert(source, isBitmark ? "bitmark" : "json", "html", "optimized", false, 2, 1, false);
       this.throwOnError(out2);
       return this.deliver(extractHtmlTables(out2).join("\n"), opts.outputFile, opts.fileOptions);
     }
@@ -444,12 +461,12 @@ var BitmarkParserGenerator = class {
     const { pretty, indent } = prettyIndent(jsonOptions.prettify);
     const spaces = spacesAround(bitmarkOptions.spacesAroundValues);
     if (outputFormat === "html") {
-      const out2 = wasm2.convert(wrapped, "html", "html", "optimized", false, 2, 1);
+      const out2 = wasm2.convert(wrapped, "html", "html", "optimized", false, 2, 1, false);
       this.throwOnError(out2);
       return this.deliver(extractHtmlTables(out2).join("\n"), opts.outputFile, opts.fileOptions);
     }
     const coreFormat = outputFormat === "ast" ? "json" : outputFormat;
-    const out = wasm2.convert(wrapped, "html", coreFormat, "optimized", pretty, indent, spaces);
+    const out = wasm2.convert(wrapped, "html", coreFormat, "optimized", pretty, indent, spaces, false);
     this.throwOnError(out);
     if (outputFormat === "bitmark" || outputFormat === "text") {
       return this.deliver(out, opts.outputFile, opts.fileOptions);
@@ -474,7 +491,7 @@ var BitmarkParserGenerator = class {
     const opts = Object.assign({}, options);
     const wasm2 = getLegacyWasm();
     const { source, isBitmark } = this.resolveInput(input, opts.inputFormat);
-    const out = wasm2.convert(source, isBitmark ? "bitmark" : "json", "json", "optimized", false, 2, 1);
+    const out = wasm2.convert(source, isBitmark ? "bitmark" : "json", "json", "optimized", false, 2, 1, true);
     this.throwOnError(out);
     return makePseudoAst(JSON.parse(out));
   }
@@ -581,7 +598,7 @@ var BitmarkParserGenerator = class {
       }
     }
     const { source, isBitmark } = this.resolveInput(input, void 0);
-    const out = wasm2.convert(source, isBitmark ? "bitmark" : "json", "text", "optimized", false, 2, 1);
+    const out = wasm2.convert(source, isBitmark ? "bitmark" : "json", "text", "optimized", false, 2, 1, false);
     this.throwOnError(out);
     return out;
   }