@gmb/bitmark-parser-generator 5.22.0 → 5.23.0

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   BitmarkStringGenerator: () => BitmarkStringGenerator,
   BitmarkVersion: () => BitmarkVersion,
   BodyTextFormat: () => BodyTextFormat,
+  BoundingBoxIndex: () => BoundingBoxIndex,
   Builder: () => Builder,
   CardSetVersion: () => CardSetVersion,
   FileWriter: () => FileWriter,
@@ -340,6 +341,7 @@ var BitType = {
   footNote: "foot-note",
   formFreeText: "form-free-text",
   formula: "formula",
+  formulaImage: "formula-image",
   gapText: "gap-text",
   gapTextInstructionGrouped: "gap-text-instruction-grouped",
   glossaryTerm: "glossary-term",
@@ -764,8 +766,10 @@ var TagFormat = {
   // If the value is treated as a boolean
   invertedBoolean: "invertedBoolean",
   // If the value is treated as a boolean with the value inverted (e.g. isLongAnswer ==> isShortAnswer = false)
-  enumeration: "enumeration"
+  enumeration: "enumeration",
   // If the value is treated as an enumeration (the value is a string that must be one of a predefined set of values)
+  coordinates: "coordinates"
+  // Comma-separated list of 4 numbers (e.g. bounding-box x, y, x1, y1)
 };
 
 // src/model/enum/TextFormat.ts
@@ -850,7 +854,11 @@ var AbstractTagConfig = class {
     // Default: 0
     __publicField(this, "chain");
     __publicField(this, "jsonKey");
-    // If the json key is different from the tag
+    // Legacy string-form jsonKey
+    __publicField(this, "exportJsonKey");
+    // New JSON-pattern jsonKey (export-only)
+    __publicField(this, "hasExportJsonKey");
+    // True iff exportJsonKey was explicitly set
     __publicField(this, "deprecated");
     this.type = params.type;
     this.configKey = params.configKey;
@@ -859,6 +867,8 @@ var AbstractTagConfig = class {
     this.minCount = params.minCount;
     this.chain = params.chain;
     this.jsonKey = params.jsonKey;
+    this.exportJsonKey = params.exportJsonKey;
+    this.hasExportJsonKey = params.hasExportJsonKey;
     this.deprecated = params.deprecated;
   }
 };
@@ -868,7 +878,6 @@ var MarkupTagConfig = class extends AbstractTagConfig {
   constructor(params) {
     super({
       type: BitTagConfigKeyType.tag,
-      jsonKey: void 0,
       ...params
     });
     __publicField(this, "type", BitTagConfigKeyType.tag);
@@ -980,8 +989,8 @@ var ResourceTagConfig = class extends AbstractTagConfig {
 
 // src/model/config/CardVariantConfig.ts
 var CardVariantConfig = class {
-  // JSON path for body text
-  constructor(tags2, bodyAllowed, bodyRequired, repeatCount, jsonKey) {
+  // Body text format. Default: bitmark++
+  constructor(tags2, bodyAllowed, bodyRequired, repeatCount, jsonKey, exportJsonKey, hasExportJsonKey = false, format) {
     __publicField(this, "tags");
     __publicField(this, "bodyAllowed");
     // Default: true
@@ -991,11 +1000,19 @@ var CardVariantConfig = class {
     // Default: 1
     // JSON mapping fields
     __publicField(this, "jsonKey");
+    // JSON path for body text (legacy)
+    __publicField(this, "exportJsonKey");
+    // New JSON-pattern jsonKey
+    __publicField(this, "hasExportJsonKey");
+    __publicField(this, "format");
     this.tags = tags2;
     this.bodyAllowed = bodyAllowed == null ? true : bodyAllowed;
     this.bodyRequired = bodyRequired;
     this.repeatCount = repeatCount;
     this.jsonKey = jsonKey;
+    this.exportJsonKey = exportJsonKey;
+    this.hasExportJsonKey = hasExportJsonKey;
+    this.format = format;
   }
   toString(options) {
     const opts = Object.assign({}, options);
@@ -1019,14 +1036,18 @@ ${tag.toString(opts)}`;
 
 // src/model/config/CardSideConfig.ts
 var CardSideConfig = class {
-  constructor(name, repeat, variants, jsonKey) {
+  constructor(name, repeat, variants, jsonKey, exportJsonKey, hasExportJsonKey = false) {
     __publicField(this, "name");
     __publicField(this, "repeat");
     __publicField(this, "jsonKey");
+    __publicField(this, "exportJsonKey");
+    __publicField(this, "hasExportJsonKey");
     __publicField(this, "variants");
     this.name = name;
     this.repeat = repeat;
     this.jsonKey = jsonKey;
+    this.exportJsonKey = exportJsonKey;
+    this.hasExportJsonKey = hasExportJsonKey;
     this.variants = variants;
   }
   toString(options) {
@@ -1048,13 +1069,17 @@ var CardSideConfig = class {
 
 // src/model/config/CardSetConfig.ts
 var CardSetConfig = class {
-  constructor(configKey, jsonKey, sections, sides) {
+  constructor(configKey, jsonKey, exportJsonKey, hasExportJsonKey, sections, sides) {
     __publicField(this, "configKey");
     __publicField(this, "jsonKey");
+    __publicField(this, "exportJsonKey");
+    __publicField(this, "hasExportJsonKey");
     __publicField(this, "sections");
     __publicField(this, "sides");
     this.configKey = configKey;
     this.jsonKey = jsonKey;
+    this.exportJsonKey = exportJsonKey;
+    this.hasExportJsonKey = hasExportJsonKey;
     this.sections = sections;
     this.sides = sides;
   }
@@ -1349,6 +1374,7 @@ var propertyKeys = {
   property_formula: "@formula",
   property_fullName: "@fullName",
   property_groupTag: "@groupTag",
+  property_gUri: "@gUri",
   property_handInAcceptFileType: "@handInAcceptFileType",
   property_handInInstruction: "@handInInstruction",
   property_handInRequirement: "@handInRequirement",
@@ -1484,6 +1510,7 @@ var propertyKeys = {
   property_siteName: "@siteName",
   property_size: "@size",
   property_slug: "@slug",
+  property_sourceBB: "@sourceBB",
   property_sourceDocument: "@sourceDocument",
   property_sourceRL: "@sourceRL",
   property_spaceId: "@spaceId",
@@ -2237,25 +2264,29 @@ var CARDSETS = {
   //
   [CardSetConfigKey.flashcard]: {
     jsonKey: "cards",
+    exportJsonKey: { cards: "$" },
     sides: [
       {
         name: "question",
         variants: [
           {
             jsonKey: "question.text",
+            exportJsonKey: { question: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
                 description: "Standard tags for the flashcard."
               },
               {
+                exportJsonKey: { title: "$" },
                 key: ConfigKey.tag_title,
                 description: "Title of the flashcard."
               },
               {
                 key: ConfigKey.group_resourceIcon,
                 description: "Icon resource for the flashcard.",
-                jsonKey: "question.icon|resource(type=image, key=image)"
+                jsonKey: "question.icon|resource(type=image, key=image)",
+                exportJsonKey: { question: { icon: { type: "image", image: { src: "$" } } } }
               }
             ]
           }
@@ -2266,37 +2297,45 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "answer.text",
+            exportJsonKey: { answer: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
                 description: "Standard tags for the flashcard."
               },
               {
+                exportJsonKey: { title: "$" },
                 key: ConfigKey.tag_title,
                 description: "Title of the flashcard."
               },
               {
                 key: ConfigKey.group_resourceIcon,
                 description: "Icon resource for the flashcard.",
-                jsonKey: "answer.icon|resource(type=image, key=image)"
+                jsonKey: "answer.icon|resource(type=image, key=image)",
+                exportJsonKey: { answer: { icon: { type: "image", image: { src: "$" } } } }
               }
             ]
           },
           {
             jsonKey: "alternativeAnswers[].text",
+            exportJsonKey: { alternativeAnswers: [{ text: "$" }] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
                 description: "Standard tags for the flashcard."
               },
               {
+                exportJsonKey: { title: "$" },
                 key: ConfigKey.tag_title,
                 description: "Title of the flashcard."
               },
               {
                 key: ConfigKey.group_resourceIcon,
                 description: "Icon resource for the flashcard.",
-                jsonKey: "alternativeAnswers[].icon|resource(type=image, key=image)"
+                jsonKey: "alternativeAnswers[].icon|resource(type=image, key=image)",
+                exportJsonKey: {
+                  alternativeAnswers: [{ icon: { type: "image", image: { src: "$" } } }]
+                }
               }
             ],
             repeatCount: Count.infinity
@@ -2310,12 +2349,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.definitionList]: {
     jsonKey: "definitions",
+    exportJsonKey: { definitions: "$" },
     sides: [
       {
         name: "term",
         variants: [
           {
             jsonKey: "term.text",
+            exportJsonKey: { term: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2325,13 +2366,15 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the definition.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forKeys"
+                jsonKey: "^heading.forKeys",
+                exportJsonKey: { "@bit": { heading: { forKeys: "$" } } }
               },
               {
                 key: ConfigKey.group_resourceIcon,
                 description: "Icon resource for the definition.",
                 format: TagFormat.plainText,
-                jsonKey: "term.icon|resource(type=image, key=image)"
+                jsonKey: "term.icon|resource(type=image, key=image)",
+                exportJsonKey: { term: { icon: { type: "image", image: { src: "$" } } } }
               }
             ]
           }
@@ -2342,6 +2385,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "definition.text",
+            exportJsonKey: { definition: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2351,30 +2395,37 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the definition.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forValues"
+                jsonKey: "^heading.forValues",
+                exportJsonKey: { "@bit": { heading: { forValues: "$" } } }
               },
               {
                 key: ConfigKey.group_resourceIcon,
                 description: "Icon resource for the definition.",
-                jsonKey: "definition.icon|resource(type=image, key=image)"
+                jsonKey: "definition.icon|resource(type=image, key=image)",
+                exportJsonKey: { definition: { icon: { type: "image", image: { src: "$" } } } }
               }
             ]
           },
           {
             jsonKey: "alternativeDefinitions[].text",
+            exportJsonKey: { alternativeDefinitions: [{ text: "$" }] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
                 description: "Standard tags for the definition."
               },
               {
+                exportJsonKey: { title: "$" },
                 key: ConfigKey.tag_title,
                 description: "Title of the definition."
               },
               {
                 key: ConfigKey.group_resourceIcon,
                 description: "Icon resource for the definition.",
-                jsonKey: "alternativeDefinitions[].icon|resource(type=image, key=image)"
+                jsonKey: "alternativeDefinitions[].icon|resource(type=image, key=image)",
+                exportJsonKey: {
+                  alternativeDefinitions: [{ icon: { type: "image", image: { src: "$" } } }]
+                }
               }
             ],
             repeatCount: Count.infinity
@@ -2388,12 +2439,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchPairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2403,22 +2456,29 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the match pair.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forKeys"
+                jsonKey: "^heading.forKeys",
+                exportJsonKey: { "@bit": { heading: { forKeys: "$" } } }
               },
               {
                 key: ConfigKey.property_isCaseSensitive,
+                exportJsonKey: [
+                  { "@absent": { isCaseSensitive: "$ancestor" } },
+                  { isCaseSensitive: "$" }
+                ],
                 description: "Property to indicate if the match is case sensitive.",
                 format: TagFormat.boolean
               },
               {
                 key: ConfigKey.resource_audio,
                 description: "Audio resource for the match pair.",
-                jsonKey: "keyAudio"
+                jsonKey: "keyAudio",
+                exportJsonKey: { keyAudio: "$" }
               },
               {
                 key: ConfigKey.resource_image,
                 description: "Image resource for the match pair.",
-                jsonKey: "keyImage"
+                jsonKey: "keyImage",
+                exportJsonKey: { keyImage: "$" }
               }
             ]
           }
@@ -2430,6 +2490,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2439,10 +2500,15 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the match pair.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forValues"
+                jsonKey: "^heading.forValues",
+                exportJsonKey: { "@bit": { heading: { forValues: "$" } } }
               },
               {
                 key: ConfigKey.property_isCaseSensitive,
+                exportJsonKey: [
+                  { "@absent": { isCaseSensitive: "$ancestor" } },
+                  { isCaseSensitive: "$" }
+                ],
                 description: "Property to indicate if the match is case sensitive.",
                 format: TagFormat.boolean
               }
@@ -2458,12 +2524,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchAudioPairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2473,12 +2541,14 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the audio match pair.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forKeys"
+                jsonKey: "^heading.forKeys",
+                exportJsonKey: { "@bit": { heading: { forKeys: "$" } } }
               },
               {
                 key: ConfigKey.resource_audio,
                 description: "Audio resource for the match pair.",
-                jsonKey: "keyAudio"
+                jsonKey: "keyAudio",
+                exportJsonKey: { keyAudio: "$" }
               }
             ]
           }
@@ -2490,6 +2560,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2499,7 +2570,8 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the audio match pair.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forValues"
+                jsonKey: "^heading.forValues",
+                exportJsonKey: { "@bit": { heading: { forValues: "$" } } }
               },
               {
                 key: ConfigKey.resource_audio,
@@ -2517,12 +2589,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchImagePairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2532,12 +2606,14 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the image match pair.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forKeys"
+                jsonKey: "^heading.forKeys",
+                exportJsonKey: { "@bit": { heading: { forKeys: "$" } } }
               },
               {
                 key: ConfigKey.resource_image,
                 description: "Image resource for the match pair.",
-                jsonKey: "keyImage"
+                jsonKey: "keyImage",
+                exportJsonKey: { keyImage: "$" }
               }
             ]
           }
@@ -2549,6 +2625,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2558,7 +2635,8 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the image match pair.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forValues"
+                jsonKey: "^heading.forValues",
+                exportJsonKey: { "@bit": { heading: { forValues: "$" } } }
               },
               {
                 key: ConfigKey.resource_image,
@@ -2576,12 +2654,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchMatrix]: {
     jsonKey: "matrix",
+    exportJsonKey: { matrix: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2589,6 +2669,11 @@ var CARDSETS = {
               },
               {
                 key: ConfigKey.property_example,
+                exportJsonKey: [
+                  { "@keyonly": { isExample: true, "@bit": { isExample: true } } },
+                  { "@absent": { isExample: true, "@bit": { isExample: true } } },
+                  { isExample: true, example: "$", "@bit": { isExample: true } }
+                ],
                 description: "Example text for the match matrix.",
                 format: TagFormat.plainText
               },
@@ -2596,10 +2681,15 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the match matrix.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forKeys"
+                jsonKey: "^heading.forKeys",
+                exportJsonKey: { "@bit": { heading: { forKeys: "$" } } }
               },
               {
                 key: ConfigKey.property_isCaseSensitive,
+                exportJsonKey: [
+                  { "@absent": { isCaseSensitive: "$ancestor" } },
+                  { isCaseSensitive: "$" }
+                ],
                 description: "Property to indicate if the match is case sensitive.",
                 format: TagFormat.boolean
               }
@@ -2613,6 +2703,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "cells[{s}].values[]",
+            exportJsonKey: { cells: { $s: { values: ["$"] } } },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2620,6 +2711,18 @@ var CARDSETS = {
               },
               {
                 key: ConfigKey.property_example,
+                exportJsonKey: [
+                  {
+                    "@keyonly": {
+                      cells: { $s: { isExample: true, example: "$parent.values[0]" } },
+                      "@bit": { isExample: true }
+                    }
+                  },
+                  {
+                    "@absent": { cells: { $s: { isExample: true, example: "$parent.values[0]" } } }
+                  },
+                  { cells: { $s: { isExample: true, example: "$" } }, "@bit": { isExample: true } }
+                ],
                 description: "Example text for the match matrix.",
                 format: TagFormat.plainText
               },
@@ -2627,10 +2730,15 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the match matrix.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forValues"
+                jsonKey: "^heading.forValues",
+                exportJsonKey: { "@bit": { heading: { forValues: "$" } } }
               },
               {
                 key: ConfigKey.property_isCaseSensitive,
+                exportJsonKey: [
+                  { "@absent": { isCaseSensitive: "$ancestor" } },
+                  { isCaseSensitive: "$" }
+                ],
                 description: "Property to indicate if the match is case sensitive.",
                 format: TagFormat.boolean
               }
@@ -2646,23 +2754,27 @@ var CARDSETS = {
   //
   [CardSetConfigKey.statements]: {
     jsonKey: "statements",
+    exportJsonKey: { statements: "$" },
     sides: [
       {
         name: "statement",
         variants: [
           {
             jsonKey: "statement",
+            exportJsonKey: { statement: "$" },
             tags: [
               {
                 key: ConfigKey.tag_true,
                 description: "Tag for true statements.",
                 jsonKey: "statement|set(isCorrect=true)",
+                exportJsonKey: { statement: "$", isCorrect: true },
                 maxCount: 1
               },
               {
                 key: ConfigKey.tag_false,
                 description: "Tag for false statements.",
                 jsonKey: "statement|set(isCorrect=false)",
+                exportJsonKey: { statement: "$", isCorrect: false },
                 maxCount: 1
               },
               {
@@ -2681,6 +2793,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.quiz]: {
     jsonKey: "quizzes",
+    exportJsonKey: { quizzes: "$" },
     sides: [
       {
         name: "choices",
@@ -2708,6 +2821,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.feedback]: {
     jsonKey: "feedbacks",
+    exportJsonKey: { feedbacks: "$" },
     sides: [
       {
         name: "choices",
@@ -2727,7 +2841,8 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the feedback.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forKeys"
+                jsonKey: "^heading.forKeys",
+                exportJsonKey: { "@bit": { heading: { forKeys: "$" } } }
               }
             ],
             bodyAllowed: false
@@ -2739,6 +2854,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "reason.text",
+            exportJsonKey: { reason: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2746,11 +2862,20 @@ var CARDSETS = {
               },
               {
                 key: ConfigKey.property_reasonableNumOfChars,
+                exportJsonKey: [
+                  { "@absent": { reasonableNumOfChars: "$ancestor" } },
+                  { reasonableNumOfChars: "$" }
+                ],
                 description: "Property for reasonable number of characters.",
                 format: TagFormat.number
               },
               {
                 key: ConfigKey.property_example,
+                exportJsonKey: [
+                  { "@keyonly": { isExample: true, example: true, "@bit": { isExample: true } } },
+                  { "@absent": { isExample: true, example: true, "@bit": { isExample: true } } },
+                  { isExample: true, example: "$", "@bit": { isExample: true } }
+                ],
                 description: "Example text for the feedback.",
                 format: TagFormat.plainText
               },
@@ -2758,7 +2883,8 @@ var CARDSETS = {
                 key: ConfigKey.tag_title,
                 description: "Title of the feedback.",
                 format: TagFormat.plainText,
-                jsonKey: "^heading.forValues"
+                jsonKey: "^heading.forValues",
+                exportJsonKey: { "@bit": { heading: { forValues: "$" } } }
               }
             ],
             bodyAllowed: true
@@ -2772,21 +2898,29 @@ var CARDSETS = {
   //
   [CardSetConfigKey.questions]: {
     jsonKey: "questions",
+    exportJsonKey: { questions: "$" },
     sides: [
       {
         name: "question",
         variants: [
           {
             jsonKey: "question",
+            exportJsonKey: { question: "$" },
             tags: [
               {
                 key: ConfigKey.property_reasonableNumOfChars,
+                exportJsonKey: [
+                  { "@absent": { reasonableNumOfChars: "$ancestor" } },
+                  { reasonableNumOfChars: "$" }
+                ],
                 description: "Property for reasonable number of characters.",
                 format: TagFormat.number
               },
               {
+                exportJsonKey: { sampleSolution: "$" },
                 key: ConfigKey.tag_sampleSolution,
-                description: "Sample solution for the question."
+                description: "Sample solution for the question.",
+                format: TagFormat.plainText
               },
               {
                 key: ConfigKey.property_sampleSolution,
@@ -2826,6 +2960,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "elements[]",
+            exportJsonKey: { elements: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2833,6 +2968,11 @@ var CARDSETS = {
               },
               {
                 key: ConfigKey.property_example,
+                exportJsonKey: [
+                  { "@keyonly": { isExample: true, example: true, "@bit": { isExample: true } } },
+                  { "@absent": { isExample: true, example: true, "@bit": { isExample: true } } },
+                  { isExample: true, example: "$", "@bit": { isExample: true } }
+                ],
                 description: "Example text for the element.",
                 format: TagFormat.plainText
               }
@@ -2848,6 +2988,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.table]: {
     jsonKey: "table.data",
+    exportJsonKey: { table: { data: "$" } },
     sides: [
       {
         name: "cell",
@@ -2863,6 +3004,7 @@ var CARDSETS = {
               {
                 key: ConfigKey.tag_title,
                 jsonKey: "^table.columns[]",
+                exportJsonKey: { "@bit": { table: { columns: ["$"] } } },
                 description: "Title of the table."
               },
               {
@@ -2903,18 +3045,34 @@ var CARDSETS = {
   [CardSetConfigKey.tableExtended]: {
     jsonKey: null,
     sections: {
-      "table-header": { jsonKey: "table.header.rows", sideJsonKey: "cells[{s}]|set(title=true)" },
-      "table-body": { jsonKey: "table.body.rows", isDefault: true },
-      "table-footer": { jsonKey: "table.footer.rows", sideJsonKey: "cells[{s}]|set(title=true)" }
+      "table-header": {
+        jsonKey: "table.header.rows",
+        exportJsonKey: { table: { header: { rows: "$" } } },
+        sideJsonKey: "cells[{s}]|set(title=true)",
+        sideExportJsonKey: { cells: { $s: { title: true, $: "$" } } }
+      },
+      "table-body": {
+        jsonKey: "table.body.rows",
+        exportJsonKey: { table: { body: { rows: "$" } } },
+        isDefault: true
+      },
+      "table-footer": {
+        jsonKey: "table.footer.rows",
+        exportJsonKey: { table: { footer: { rows: "$" } } },
+        sideJsonKey: "cells[{s}]|set(title=true)",
+        sideExportJsonKey: { cells: { $s: { title: true, $: "$" } } }
+      }
     },
     sides: [
       {
         name: "cell",
         repeat: true,
         jsonKey: "cells[{s}]",
+        exportJsonKey: { cells: { $s: "$" } },
         variants: [
           {
             jsonKey: "content",
+            exportJsonKey: { content: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2923,29 +3081,38 @@ var CARDSETS = {
               {
                 key: ConfigKey.tag_title,
                 jsonKey: ".",
+                exportJsonKey: {
+                  "@bit": {
+                    table: { header: { rows: { cells: { cells: { $s: { content: "$" } } } } } }
+                  }
+                },
                 description: "Title of the table cell."
               },
               {
                 key: ConfigKey.property_tableCellType,
                 jsonKey: "title|bool(th)",
+                exportJsonKey: [{ "@value=th": { title: true } }],
                 description: "Table cell type (th/td).",
                 format: TagFormat.plainText
               },
               {
                 key: ConfigKey.property_tableRowSpan,
                 jsonKey: "rowspan",
+                exportJsonKey: { rowspan: "$" },
                 description: "Number of rows the cell spans.",
                 format: TagFormat.number
               },
               {
                 key: ConfigKey.property_tableColSpan,
                 jsonKey: "colspan",
+                exportJsonKey: { colspan: "$" },
                 description: "Number of columns the cell spans.",
                 format: TagFormat.number
               },
               {
                 key: ConfigKey.property_tableScope,
                 jsonKey: "scope",
+                exportJsonKey: { scope: "$" },
                 description: "Scope attribute for header cells.",
                 format: TagFormat.plainText
               },
@@ -2966,6 +3133,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.pronunciationTable]: {
     jsonKey: "pronunciationTable.data",
+    exportJsonKey: { pronunciationTable: { data: "$" } },
     sides: [
       {
         name: "cell",
@@ -2973,12 +3141,14 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "body",
+            exportJsonKey: { body: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
                 description: "Standard tags for lead, instruction, and hint."
               },
               {
+                exportJsonKey: { title: "$" },
                 key: ConfigKey.tag_title,
                 description: "Title of the pronunciation table."
               },
@@ -2999,12 +3169,15 @@ var CARDSETS = {
   //
   [CardSetConfigKey.botActionResponses]: {
     jsonKey: "responses",
+    exportJsonKey: { responses: "$" },
     sides: [
       {
         name: "response",
         variants: [
           {
             jsonKey: "feedback",
+            exportJsonKey: { feedback: "$" },
+            format: TextFormat.plainText,
             tags: [
               {
                 key: ConfigKey.property_reaction,
@@ -3012,16 +3185,53 @@ var CARDSETS = {
                 format: TagFormat.plainText
               },
               {
-                key: ConfigKey.group_standardItemLead,
-                description: "Item, lead, page number, and margin number for the bot action response."
+                key: ConfigKey.tag_item,
+                jsonKey: "item",
+                exportJsonKey: { item: "$" },
+                format: TagFormat.plainText,
+                description: "The item for the bit",
+                chain: [
+                  {
+                    key: ConfigKey.tag_item,
+                    jsonKey: "lead",
+                    exportJsonKey: { lead: "$" },
+                    description: "The lead for the bit",
+                    maxCount: 1,
+                    chain: [
+                      {
+                        key: ConfigKey.tag_item,
+                        jsonKey: "pageNumber",
+                        exportJsonKey: { pageNumber: "$" },
+                        description: "The page number for the bit",
+                        maxCount: 1,
+                        chain: [
+                          {
+                            key: ConfigKey.tag_item,
+                            jsonKey: "marginNumber",
+                            exportJsonKey: { marginNumber: "$" },
+                            description: "The margin number for the bit",
+                            maxCount: 1
+                          }
+                        ]
+                      }
+                    ]
+                  }
+                ]
               },
               {
                 key: ConfigKey.tag_instruction,
                 description: "The response label for the bot action.",
-                jsonKey: "response"
+                jsonKey: "response",
+                exportJsonKey: { response: "$" },
+                format: TagFormat.plainText
               },
               {
                 key: ConfigKey.property_example,
+                exportJsonKey: [
+                  { "@keyonly": { isExample: true, example: true, "@bit": { isExample: true } } },
+                  { "@absent": { isExample: true, example: true, "@bit": { isExample: true } } },
+                  { isExample: true, example: "$", "@bit": { isExample: true } }
+                ],
                 description: "Example text for the bot action response.",
                 format: TagFormat.plainText
               }
@@ -3036,12 +3246,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.clozeList]: {
     jsonKey: "listItems",
+    exportJsonKey: { listItems: "$" },
     sides: [
       {
         name: "content",
         variants: [
           {
             jsonKey: "body",
+            exportJsonKey: { body: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -3062,18 +3274,21 @@ var CARDSETS = {
   //
   [CardSetConfigKey.exampleBitList]: {
     jsonKey: "listItems",
+    exportJsonKey: { listItems: "$" },
     sides: [
       {
         name: "item",
         variants: [
           {
             jsonKey: "body",
+            exportJsonKey: { body: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
                 description: "Standard tags for example bits."
               },
               {
+                exportJsonKey: { title: "$" },
                 key: ConfigKey.tag_title,
                 description: "Title of the example bit."
               }
@@ -3088,14 +3303,17 @@ var CARDSETS = {
   //
   [CardSetConfigKey.ingredients]: {
     jsonKey: "ingredients",
+    exportJsonKey: { ingredients: "$" },
     sides: [
       {
         name: "ingredient",
         variants: [
           {
             jsonKey: "ingredient",
+            exportJsonKey: { ingredient: "$" },
             tags: [
               {
+                exportJsonKey: { title: "$" },
                 key: ConfigKey.tag_title,
                 description: "Title of the ingredient."
               },
@@ -3103,6 +3321,7 @@ var CARDSETS = {
                 key: ConfigKey.tag_true,
                 description: "Checked state for the ingredient.",
                 jsonKey: "|set(checked=true)",
+                exportJsonKey: { checked: true, $: "$" },
                 maxCount: 1
                 // nullable: true,
               },
@@ -3110,6 +3329,7 @@ var CARDSETS = {
                 key: ConfigKey.tag_false,
                 description: "Unchecked state for the ingredient.",
                 jsonKey: "|set(checked=false)",
+                exportJsonKey: { checked: false, $: "$" },
                 maxCount: 1
                 // nullable: true,
               },
@@ -3121,9 +3341,11 @@ var CARDSETS = {
                 key: ConfigKey.tag_instruction,
                 description: "The quantity of the ingredient.",
                 jsonKey: "quantity",
+                exportJsonKey: { quantity: "$" },
                 format: TagFormat.number
               },
               {
+                exportJsonKey: { hint: "$" },
                 key: ConfigKey.tag_hint,
                 description: "The hint for the ingredient."
               },
@@ -3159,6 +3381,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.bookReferenceList]: {
     jsonKey: "bookReferences",
+    exportJsonKey: { bookReferences: "$" },
     sides: [
       {
         name: "reference",
@@ -3218,6 +3441,11 @@ var GROUPS = {
         format: TagFormat.plainText,
         maxCount: Count.infinity
       },
+      {
+        key: ConfigKey.property_gUri,
+        description: "Global URI for the bit",
+        format: TagFormat.plainText
+      },
       {
         key: ConfigKey.property_customerId,
         description: "The customer-specific identifier for the bit",
@@ -3401,12 +3629,14 @@ var GROUPS = {
       {
         key: ConfigKey.property_groupTag,
         jsonKey: "groupTag.name",
+        exportJsonKey: { groupTag: { name: "$" } },
         description: "The group tag(s) for the bit",
         format: TagFormat.plainText,
         maxCount: Count.infinity,
         chain: [
           {
             key: ConfigKey.property_tag,
+            exportJsonKey: { tags: ["$"] },
             description: "The tag(s) for the group",
             format: TagFormat.plainText,
             maxCount: Count.infinity
@@ -3437,6 +3667,12 @@ var GROUPS = {
         format: TagFormat.plainText,
         maxCount: Count.infinity
       },
+      {
+        key: ConfigKey.property_sourceBB,
+        description: "The source bounding box(es) for the bit (x, y, x1, y1)",
+        format: TagFormat.coordinates,
+        maxCount: Count.infinity
+      },
       {
         key: ConfigKey.property_levelCEFRp,
         description: "The CEFRp level for the bit",
@@ -3474,6 +3710,7 @@ var GROUPS = {
         maxCount: Count.infinity
       },
       {
+        exportJsonKey: { anchor: "$" },
         key: ConfigKey.tag_anchor,
         name: "Anchor",
         format: TagFormat.plainText,
@@ -3511,23 +3748,27 @@ var GROUPS = {
       {
         key: ConfigKey.tag_item,
         jsonKey: "item",
+        exportJsonKey: { item: "$" },
         description: "The item for the bit",
         chain: [
           {
             key: ConfigKey.tag_item,
             jsonKey: "lead",
+            exportJsonKey: { lead: "$" },
             description: "The lead for the bit",
             maxCount: 1,
             chain: [
               {
                 key: ConfigKey.tag_item,
                 jsonKey: "pageNumber",
+                exportJsonKey: { pageNumber: "$" },
                 description: "The page number for the bit",
                 maxCount: 1,
                 chain: [
                   {
                     key: ConfigKey.tag_item,
                     jsonKey: "marginNumber",
+                    exportJsonKey: { marginNumber: "$" },
                     description: "The margin number for the bit",
                     maxCount: 1
                   }
@@ -3548,11 +3789,13 @@ var GROUPS = {
         description: "Item, lead, page number, and margin number tags"
       },
       {
+        exportJsonKey: { instruction: "$" },
         key: ConfigKey.tag_instruction,
         name: "Instruction",
         description: "The instruction for the bit"
       },
       {
+        exportJsonKey: { hint: "$" },
         key: ConfigKey.tag_hint,
         name: "Hint",
         description: "The hint for the bit"
@@ -3572,9 +3815,17 @@ var GROUPS = {
         description: "Item, lead, page number, margin number, instruction and hint tags"
       },
       {
+        // Bit-level example tag: bare/synthesized records the marker only;
+        // valued [@example:text] emits `isExample: true` and `example` as
+        // PM-rendered rich text (bitmark+ format).
         key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true } },
+          { "@absent": { isExample: true } },
+          { isExample: true, example: "$" }
+        ],
         description: "The example(s) for the bit",
-        format: TagFormat.plainText
+        format: TagFormat.bitmarkText
       }
     ]
   },
@@ -3585,6 +3836,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_imageSource,
         jsonKey: "imageSource.url",
+        exportJsonKey: { imageSource: { url: "$" } },
         description: "The source of an image",
         format: TagFormat.plainText,
         chain: [
@@ -3619,6 +3871,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_technicalTerm,
         jsonKey: "technicalTerm.technicalTerm",
+        exportJsonKey: { technicalTerm: { technicalTerm: "$" } },
         description: "The technical term",
         format: TagFormat.plainText,
         chain: [
@@ -3638,6 +3891,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_person,
         jsonKey: "partner.name",
+        exportJsonKey: { partner: { name: "$" } },
         description: "A person",
         format: TagFormat.plainText,
         chain: [
@@ -3649,6 +3903,7 @@ var GROUPS = {
           {
             key: ConfigKey.group_resourceImage,
             jsonKey: "avatarImage|resource(type=image, key=image)",
+            exportJsonKey: { avatarImage: { type: "image", image: { src: "$" } } },
             description: "The image of the person"
           }
         ]
@@ -3657,6 +3912,7 @@ var GROUPS = {
         // Deprecated (parter renamed to person)
         key: ConfigKey.property_partner,
         jsonKey: "partner.name",
+        exportJsonKey: { partner: { name: "$" } },
         description: "A partner",
         format: TagFormat.plainText,
         chain: [
@@ -3668,6 +3924,7 @@ var GROUPS = {
           {
             key: ConfigKey.group_resourceImage,
             jsonKey: "avatarImage|resource(type=image, key=image)",
+            exportJsonKey: { avatarImage: { type: "image", image: { src: "$" } } },
             description: "The image of the partner"
           }
         ]
@@ -3679,15 +3936,19 @@ var GROUPS = {
     description: "Gap chain",
     tags: [
       {
+        exportJsonKey: { solutions: [["$"]] },
         key: ConfigKey.tag_gap,
         description: "The value of a gap in the content",
         maxCount: Count.infinity,
+        format: TagFormat.plainText,
         chain: [
           {
             key: ConfigKey.tag_gap,
             jsonKey: "solutions[]",
+            exportJsonKey: { solutions: ["$"] },
             description: "Alternative values for the gaps in the content",
-            maxCount: Count.infinity
+            maxCount: Count.infinity,
+            format: TagFormat.plainText
           },
           {
             key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -3696,12 +3957,33 @@ var GROUPS = {
           {
             key: ConfigKey.property_example,
             jsonKey: "example",
+            exportJsonKey: [
+              {
+                "@keyonly": {
+                  isExample: true,
+                  example: "$parent.solutions[0]",
+                  "@bit": { isExample: true }
+                }
+              },
+              {
+                "@absent": {
+                  isExample: true,
+                  example: "$parent.solutions[0]",
+                  "@bit": { isExample: true }
+                }
+              },
+              { isExample: true, example: "$", "@bit": { isExample: true } }
+            ],
             description: "An example for the gap",
-            format: TagFormat.plainText
+            format: TagFormat.bitmarkText
           },
           {
             key: ConfigKey.property_isCaseSensitive,
             jsonKey: "isCaseSensitive",
+            exportJsonKey: [
+              { "@absent": { isCaseSensitive: "$ancestor" } },
+              { isCaseSensitive: "$" }
+            ],
             description: "If true, the gap text is case sensitive",
             format: TagFormat.boolean,
             defaultValue: "true"
@@ -3715,21 +3997,27 @@ var GROUPS = {
     description: "True/False chain",
     tags: [
       {
+        exportJsonKey: { choices: [{ choice: "$", isCorrect: true }] },
         key: ConfigKey.tag_true,
         description: "True value for a true/false statement/question",
         maxCount: Count.infinity,
+        format: TagFormat.plainText,
         chain: [
           {
             key: ConfigKey.tag_true,
             jsonKey: "choices[]|set(isCorrect=true)",
+            exportJsonKey: { choices: [{ choice: "$", isCorrect: true }] },
             description: "True values for a true/false statement/question",
-            maxCount: Count.infinity
+            maxCount: Count.infinity,
+            format: TagFormat.plainText
           },
           {
             key: ConfigKey.tag_false,
             jsonKey: "choices[]|set(isCorrect=false)",
+            exportJsonKey: { choices: [{ choice: "$", isCorrect: false }] },
             description: "False values for a true/false statement/question",
-            maxCount: Count.infinity
+            maxCount: Count.infinity,
+            format: TagFormat.plainText
           },
           {
             key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -3738,27 +4026,50 @@ var GROUPS = {
           {
             key: ConfigKey.property_example,
             jsonKey: "example",
+            exportJsonKey: [
+              {
+                "@keyonly": {
+                  isExample: true,
+                  example: "$parent.isCorrect",
+                  "@bit": { isExample: true }
+                }
+              },
+              {
+                "@absent": {
+                  isExample: true,
+                  example: "$parent.isCorrect",
+                  "@bit": { isExample: true }
+                }
+              },
+              { isExample: true, example: "$", "@bit": { isExample: true } }
+            ],
             description: "An example for the true/false statement/question",
-            format: TagFormat.plainText
+            format: TagFormat.bitmarkText
           }
         ]
       },
       {
+        exportJsonKey: { choices: [{ choice: "$", isCorrect: false }] },
         key: ConfigKey.tag_false,
         description: "False value for a true/false statement/question",
         maxCount: Count.infinity,
+        format: TagFormat.plainText,
         chain: [
           {
             key: ConfigKey.tag_true,
             jsonKey: "choices[]|set(isCorrect=true)",
+            exportJsonKey: { choices: [{ choice: "$", isCorrect: true }] },
             description: "True values for a true/false statement/question",
-            maxCount: Count.infinity
+            maxCount: Count.infinity,
+            format: TagFormat.plainText
           },
           {
             key: ConfigKey.tag_false,
             jsonKey: "choices[]|set(isCorrect=false)",
+            exportJsonKey: { choices: [{ choice: "$", isCorrect: false }] },
             description: "False values for a true/false statement/question",
-            maxCount: Count.infinity
+            maxCount: Count.infinity,
+            format: TagFormat.plainText
           },
           {
             key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -3767,8 +4078,25 @@ var GROUPS = {
           {
             key: ConfigKey.property_example,
             jsonKey: "example",
+            exportJsonKey: [
+              {
+                "@keyonly": {
+                  isExample: true,
+                  example: "$parent.isCorrect",
+                  "@bit": { isExample: true }
+                }
+              },
+              {
+                "@absent": {
+                  isExample: true,
+                  example: "$parent.isCorrect",
+                  "@bit": { isExample: true }
+                }
+              },
+              { isExample: true, example: "$", "@bit": { isExample: true } }
+            ],
             description: "An example for the true/false statement/question",
-            format: TagFormat.plainText
+            format: TagFormat.bitmarkText
           }
         ]
       }
@@ -3781,6 +4109,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_mark,
         jsonKey: "marks.mark",
+        exportJsonKey: { marks: { mark: ["$"] } },
         description: "The mark configuration",
         format: TagFormat.plainText,
         maxCount: Count.infinity,
@@ -3804,9 +4133,11 @@ var GROUPS = {
     description: "Mark chain",
     tags: [
       {
+        exportJsonKey: { solution: ["$"] },
         key: ConfigKey.tag_mark,
         description: "The marked content",
         maxCount: Count.infinity,
+        format: TagFormat.plainText,
         chain: [
           {
             key: ConfigKey.property_mark,
@@ -3817,8 +4148,13 @@ var GROUPS = {
           {
             key: ConfigKey.property_example,
             jsonKey: "example",
+            exportJsonKey: [
+              { "@keyonly": { isExample: true, example: true, "@bit": { isExample: true } } },
+              { "@absent": { isExample: true, example: true, "@bit": { isExample: true } } },
+              { isExample: true, example: "$", "@bit": { isExample: true } }
+            ],
             description: "An example for the marked content",
-            format: TagFormat.plainText
+            format: TagFormat.bitmarkText
           }
         ]
       }
@@ -3907,7 +4243,8 @@ var GROUPS = {
         name: "Title",
         description: "The title of the book",
         maxCount: 2,
-        jsonKey: "title|multi(count=2, key=subtitle)"
+        jsonKey: "title|multi(count=2, key=subtitle)",
+        exportJsonKey: [{ "@level=1": { title: "$" } }, { "@level=2": { subtitle: "$" } }]
       },
       {
         key: ConfigKey.property_subtype,
@@ -3923,6 +4260,7 @@ var GROUPS = {
       {
         key: ConfigKey.resource_coverImage,
         jsonKey: "coverImage|resource(type=image, key=image)",
+        exportJsonKey: { coverImage: { type: "image", image: { src: "$" } } },
         description: "The cover image of the book",
         chain: [
           {
@@ -3940,6 +4278,7 @@ var GROUPS = {
       {
         key: ConfigKey.resource_backgroundImage,
         jsonKey: "backgroundImage|resource(type=image, key=image)",
+        exportJsonKey: { backgroundImage: { type: "image", image: { src: "$" } } },
         description: "The background image of the book",
         chain: [
           {
@@ -4099,10 +4438,21 @@ var GROUPS = {
         format: TagFormat.plainText,
         chain: [
           {
+            exportJsonKey: { reference: "$" },
             key: ConfigKey.tag_reference,
             format: TagFormat.plainText,
-            description: "The reference(s) for the book(s) in the learning path",
-            maxCount: 2
+            description: "The reference for the book(s) in the learning path",
+            maxCount: 1,
+            chain: [
+              {
+                key: ConfigKey.tag_reference,
+                jsonKey: "referenceEnd",
+                exportJsonKey: { referenceEnd: "$" },
+                format: TagFormat.plainText,
+                description: "The referenceEnd for the book(s) in the learning path",
+                maxCount: 1
+              }
+            ]
           }
         ]
       }
@@ -4242,6 +4592,8 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_imagePlaceholder,
+        jsonKey: "imagePlaceholder|resource(type=image, key=image)",
+        exportJsonKey: { imagePlaceholder: { type: "image", image: { src: "$" } } },
         description: "Placeholder image for the resource",
         chain: [
           {
@@ -4426,6 +4778,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_posterImage,
         jsonKey: "posterImage.src",
+        exportJsonKey: { posterImage: { src: "$" } },
         description: "The poster image for the video",
         format: TagFormat.plainText,
         chain: [
@@ -4482,6 +4835,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_image,
+        exportJsonKey: { resource: { type: "image", image: { src: "$" } } },
         description: "The image resource",
         chain: [
           {
@@ -4546,6 +4900,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_imageLink,
+        exportJsonKey: { resource: { type: "image-link", imageLink: { url: "$" } } },
         description: "The link to the image resource",
         chain: [
           {
@@ -4562,6 +4917,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audio,
+        exportJsonKey: { resource: { type: "audio", audio: { src: "$" } } },
         description: "The audio resource",
         chain: [
           {
@@ -4578,6 +4934,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audioEmbed,
+        exportJsonKey: { resource: { type: "audio-embed", audioEmbed: { src: "$" } } },
         description: "The embedded audio resource",
         chain: [
           {
@@ -4594,6 +4951,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audioLink,
+        exportJsonKey: { resource: { type: "audio-link", audioLink: { url: "$" } } },
         description: "The link to the audio resource",
         chain: [
           {
@@ -4610,6 +4968,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_video,
+        exportJsonKey: { resource: { type: "video", video: { src: "$" } } },
         description: "The video resource",
         chain: [
           {
@@ -4626,6 +4985,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_videoEmbed,
+        exportJsonKey: { resource: { type: "video-embed", videoEmbed: { url: "$" } } },
         description: "The embedded video resource",
         chain: [
           {
@@ -4642,6 +5002,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_videoLink,
+        exportJsonKey: { resource: { type: "video-link", videoLink: { url: "$" } } },
         description: "The link to the video resource",
         chain: [
           {
@@ -4658,6 +5019,9 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_stillImageFilmEmbed,
+        exportJsonKey: {
+          resource: { type: "still-image-film-embed", stillImageFilmEmbed: { url: "$" } }
+        },
         description: "The embedded still image film resource",
         chain: [
           {
@@ -4674,6 +5038,9 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_stillImageFilmLink,
+        exportJsonKey: {
+          resource: { type: "still-image-film-link", stillImageFilmLink: { url: "$" } }
+        },
         description: "The link to the still image film resource",
         chain: [
           {
@@ -4738,6 +5105,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_document,
+        exportJsonKey: { resource: { type: "document", document: { url: "$" } } },
         description: "The document resource",
         chain: [
           {
@@ -4754,6 +5122,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentEmbed,
+        exportJsonKey: { resource: { type: "document-embed", documentEmbed: { url: "$" } } },
         description: "The embedded document resource",
         chain: [
           {
@@ -4770,6 +5139,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentLink,
+        exportJsonKey: { resource: { type: "document-link", documentLink: { url: "$" } } },
         description: "The link to the document resource",
         chain: [
           {
@@ -4786,6 +5156,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentDownload,
+        exportJsonKey: { resource: { type: "document-download", documentDownload: { url: "$" } } },
         description: "The downloadable document resource",
         chain: [
           {
@@ -4802,6 +5173,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_appLink,
+        exportJsonKey: { resource: { type: "app-link", appLink: { url: "$" } } },
         description: "The link to the app resource",
         chain: [
           {
@@ -4818,6 +5190,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_websiteLink,
+        exportJsonKey: { resource: { type: "website-link", websiteLink: { url: "$" } } },
         description: "The link to the website resource",
         chain: [
           {
@@ -4876,6 +5249,7 @@ var GROUPS = {
       {
         key: ConfigKey.resource_previewImage,
         jsonKey: "previewImage|resource(type=image, key=image)",
+        exportJsonKey: { previewImage: { type: "image", image: { src: "$" } } },
         description: "The preview image resource",
         chain: [
           {
@@ -4893,6 +5267,7 @@ var GROUPS = {
       {
         key: ConfigKey.resource_previewVideo,
         jsonKey: "previewVideo|resource(type=video, key=video)",
+        exportJsonKey: { previewVideo: { type: "video", video: { src: "$" } } },
         description: "The preview video resource",
         chain: [
           {
@@ -4957,20 +5332,48 @@ var ConfigHydrator = class {
         _side.name,
         _side.repeat ?? false,
         variantsOfSide,
-        _side.jsonKey
+        _side.jsonKey,
+        _side.exportJsonKey,
+        Object.prototype.hasOwnProperty.call(_side, "exportJsonKey")
       );
       sides.push(sideConfig);
     }
     const cardSetConfig = new CardSetConfig(
       _cardSet,
       _cardSetConfig.jsonKey,
-      _cardSetConfig.sections,
+      _cardSetConfig.exportJsonKey,
+      Object.prototype.hasOwnProperty.call(_cardSetConfig, "exportJsonKey"),
+      this.hydrateCardSections(_cardSetConfig.sections),
       sides
     );
     return cardSetConfig;
   }
+  hydrateCardSections(sections) {
+    if (!sections) return void 0;
+    const out = {};
+    for (const [k, v] of Object.entries(sections)) {
+      out[k] = {
+        jsonKey: v.jsonKey,
+        exportJsonKey: v.exportJsonKey,
+        hasExportJsonKey: Object.prototype.hasOwnProperty.call(v, "exportJsonKey"),
+        isDefault: v.isDefault,
+        sideJsonKey: v.sideJsonKey,
+        sideExportJsonKey: v.sideExportJsonKey,
+        hasSideExportJsonKey: Object.prototype.hasOwnProperty.call(v, "sideExportJsonKey")
+      };
+    }
+    return out;
+  }
   hydrateTagConfig(_tag) {
-    const { key: _configKey, maxCount, minCount, chain: _chain, deprecated } = _tag;
+    const {
+      key: _configKey,
+      maxCount,
+      minCount,
+      chain: _chain,
+      deprecated,
+      jsonKey,
+      exportJsonKey
+    } = _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}'`);
     const tag = (0, import_superenum15.Enum)(Tag).fromValue(configKey);
@@ -4985,6 +5388,9 @@ var ConfigHydrator = class {
       maxCount: maxCount ?? MAX_COUNT_DEFAULT,
       minCount: minCount ?? MIN_COUNT_DEFAULT,
       chain,
+      jsonKey,
+      exportJsonKey,
+      hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
       deprecated
     });
     return {
@@ -5003,7 +5409,8 @@ var ConfigHydrator = class {
       format,
       values,
       defaultValue,
-      jsonKey
+      jsonKey,
+      exportJsonKey
     } = _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}'`);
@@ -5019,6 +5426,8 @@ var ConfigHydrator = class {
       minCount: minCount ?? MIN_COUNT_DEFAULT,
       chain,
       jsonKey,
+      exportJsonKey,
+      hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
       format,
       values,
       defaultValue,
@@ -5031,7 +5440,15 @@ var ConfigHydrator = class {
     };
   }
   hydrateResourceTagConfig(_tag) {
-    const { key: _configKey, maxCount, minCount, chain: _chain, deprecated, jsonKey } = _tag;
+    const {
+      key: _configKey,
+      maxCount,
+      minCount,
+      chain: _chain,
+      deprecated,
+      jsonKey,
+      exportJsonKey
+    } = _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}'`);
     const tag = _configKey.substring(1);
@@ -5046,6 +5463,8 @@ var ConfigHydrator = class {
       minCount: minCount ?? MIN_COUNT_DEFAULT,
       chain,
       jsonKey,
+      exportJsonKey,
+      hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
       deprecated
     });
     return {
@@ -5077,14 +5496,25 @@ var ConfigHydrator = class {
     };
   }
   hydrateCardVariantConfig(_variant) {
-    const { tags: _tags, bodyAllowed, bodyRequired, repeatCount, jsonKey } = _variant;
+    const {
+      tags: _tags,
+      bodyAllowed,
+      bodyRequired,
+      repeatCount,
+      jsonKey,
+      exportJsonKey,
+      format
+    } = _variant;
     const tags2 = this.hydrateTagsConfig(_tags);
     const cardSetConfig = new CardVariantConfig(
       tags2.tags,
       bodyAllowed,
       bodyRequired,
       repeatCount,
-      jsonKey
+      jsonKey,
+      exportJsonKey,
+      Object.prototype.hasOwnProperty.call(_variant, "exportJsonKey"),
+      format
     );
     return cardSetConfig;
   }
@@ -5122,6 +5552,7 @@ var BITS = {
         description: "Common tags for quiz bits"
       },
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "The title of the flashcard quiz"
       },
@@ -5130,6 +5561,20 @@ var BITS = {
         description: "The flashcard set to use for the app flashcards",
         format: TagFormat.plainText,
         maxCount: Count.infinity
+      },
+      {
+        // Override inherited @example from group_standardTags: string root
+        // example. Bare/synthesized emits `example: "true"` (a text literal
+        // that field-coerces to a paragraph "true" in bitmark+ contexts);
+        // valued [@example:text] emits the user's text via `$`.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: "true" } },
+          { "@absent": { isExample: true, example: "true" } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example text for the bit",
+        format: TagFormat.plainText
       }
     ],
     rootExampleType: ExampleType.string
@@ -5211,6 +5656,7 @@ var BITS = {
     description: "Article bit, used for articles / paragraphs",
     tags: [
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "The title of the article"
       }
@@ -5318,7 +5764,8 @@ var BITS = {
         key: ConfigKey.tag_title,
         description: "Title and subtitle of the catalog item",
         maxCount: 2,
-        jsonKey: "title|multi(count=2, key=subtitle)"
+        jsonKey: "title|multi(count=2, key=subtitle)",
+        exportJsonKey: [{ "@level=1": { title: "$" } }, { "@level=2": { subtitle: "$" } }]
       },
       {
         key: ConfigKey.property_coverImage,
@@ -5328,6 +5775,7 @@ var BITS = {
       {
         key: ConfigKey.resource_coverImage,
         jsonKey: "coverImage|resource(type=image, key=image)",
+        exportJsonKey: { coverImage: { type: "image", image: { src: "$" } } },
         description: "Cover image of the catalog item",
         chain: [
           {
@@ -5455,6 +5903,17 @@ var BITS = {
         key: ConfigKey.group_previewVideos,
         description: "Array of preview videos for the catalog item",
         maxCount: Count.infinity
+      },
+      {
+        // Override inherited @example from group_standardTags: string root example.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: "true" } },
+          { "@absent": { isExample: true, example: "true" } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example text for the bit",
+        format: TagFormat.plainText
       }
     ],
     rootExampleType: ExampleType.string
@@ -5468,7 +5927,8 @@ var BITS = {
         key: ConfigKey.tag_title,
         description: "Title and subtitle of the catalog item",
         maxCount: 2,
-        jsonKey: "title|multi(count=2, key=subtitle)"
+        jsonKey: "title|multi(count=2, key=subtitle)",
+        exportJsonKey: [{ "@level=1": { title: "$" } }, { "@level=2": { subtitle: "$" } }]
       },
       {
         key: ConfigKey.property_coverImage,
@@ -5478,6 +5938,7 @@ var BITS = {
       {
         key: ConfigKey.resource_coverImage,
         jsonKey: "coverImage|resource(type=image, key=image)",
+        exportJsonKey: { coverImage: { type: "image", image: { src: "$" } } },
         description: "Cover image of the catalog item",
         chain: [
           {
@@ -5605,6 +6066,17 @@ var BITS = {
         key: ConfigKey.group_previewVideos,
         description: "Array of preview videos for the catalog item",
         maxCount: Count.infinity
+      },
+      {
+        // Override inherited @example from group_standardTags: string root example.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: "true" } },
+          { "@absent": { isExample: true, example: "true" } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example text for the bit",
+        format: TagFormat.plainText
       }
     ],
     rootExampleType: ExampleType.string
@@ -5618,7 +6090,8 @@ var BITS = {
         key: ConfigKey.tag_title,
         description: "Title and subtitle of the catalog item",
         maxCount: 2,
-        jsonKey: "title|multi(count=2, key=subtitle)"
+        jsonKey: "title|multi(count=2, key=subtitle)",
+        exportJsonKey: [{ "@level=1": { title: "$" } }, { "@level=2": { subtitle: "$" } }]
       },
       {
         key: ConfigKey.property_coverImage,
@@ -5744,6 +6217,17 @@ var BITS = {
         key: ConfigKey.group_previewVideos,
         description: "Array of preview videos for the catalog item",
         maxCount: Count.infinity
+      },
+      {
+        // Override inherited @example from group_standardTags: string root example.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: "true" } },
+          { "@absent": { isExample: true, example: "true" } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example text for the bit",
+        format: TagFormat.plainText
       }
     ],
     rootExampleType: ExampleType.string
@@ -5945,11 +6429,13 @@ var BITS = {
     description: "Bit alias, used to create an alias for a bit",
     tags: [
       {
+        exportJsonKey: { reference: "$" },
         key: ConfigKey.tag_reference,
         format: TagFormat.plainText,
         description: "The reference to the bit that this alias points to"
       },
       {
+        exportJsonKey: { anchor: "$" },
         key: ConfigKey.tag_anchor,
         format: TagFormat.plainText,
         description: "The anchor for the bit alias, used for linking"
@@ -6151,7 +6637,8 @@ var BITS = {
         description: "The title of the book cover",
         maxCount: 2,
         // title & subtitle
-        jsonKey: "title|multi(count=2, key=subtitle)"
+        jsonKey: "title|multi(count=2, key=subtitle)",
+        exportJsonKey: [{ "@level=1": { title: "$" } }, { "@level=2": { subtitle: "$" } }]
       },
       {
         key: ConfigKey.property_coverColor,
@@ -6295,6 +6782,7 @@ var BITS = {
     description: "Chapter bit, used to define chapters in books or articles",
     tags: [
       {
+        exportJsonKey: { anchor: "$" },
         key: ConfigKey.tag_anchor,
         format: TagFormat.plainText,
         description: "The anchor for the chapter, used for linking"
@@ -6302,7 +6790,8 @@ var BITS = {
       {
         key: ConfigKey.tag_title,
         description: "The title of the chapter",
-        jsonKey: "title|setMulti(level)"
+        jsonKey: "title|setMulti(level)",
+        exportJsonKey: { title: "$", level: "$level" }
       },
       {
         key: ConfigKey.property_toc,
@@ -6355,6 +6844,7 @@ var BITS = {
       },
       {
         key: ConfigKey.property_isCaseSensitive,
+        exportJsonKey: {},
         description: "If the cloze answers are case sensitive",
         format: TagFormat.boolean,
         defaultValue: "true"
@@ -6452,6 +6942,11 @@ var BITS = {
     description: "Formula bit, used for mathematical formulas in articles or documents",
     textFormatDefault: TextFormat.latex
   },
+  [BitType.formulaImage]: {
+    since: "5.23.0",
+    baseBitType: BitType.formula,
+    description: "Formula image bit, used for mathematical formulas rendered as images"
+  },
   [BitType.smartStandardFormula]: {
     since: "3.11.0",
     baseBitType: BitType.formula,
@@ -6804,6 +7299,7 @@ var BITS = {
       {
         key: ConfigKey.property_servings,
         jsonKey: "servings.servings",
+        exportJsonKey: { servings: { servings: "$" } },
         description: "The number of servings for the ingredients",
         format: TagFormat.number,
         chain: [
@@ -6829,6 +7325,7 @@ var BITS = {
             format: TagFormat.boolean
           },
           {
+            exportJsonKey: { hint: "$" },
             key: ConfigKey.tag_hint,
             description: "Hint for the ingredient, used to provide additional information",
             format: TagFormat.plainText
@@ -7006,6 +7503,17 @@ var BITS = {
         description: "Reference for the essay, used to link to external resources",
         format: TagFormat.plainText,
         maxCount: Count.infinity
+      },
+      {
+        // Override inherited @example from group_standardTags: string root example.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: "true" } },
+          { "@absent": { isExample: true, example: "true" } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example text for the essay bit",
+        format: TagFormat.plainText
       }
     ],
     rootExampleType: ExampleType.string
@@ -7026,8 +7534,20 @@ var BITS = {
     description: "Example bit, used to provide examples in articles or books",
     tags: [
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "The title of the example"
+      },
+      {
+        // Override inherited @example from group_standardTags: string root example.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: "true" } },
+          { "@absent": { isExample: true, example: "true" } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example text for the example bit",
+        format: TagFormat.plainText
       }
     ],
     rootExampleType: ExampleType.string
@@ -7893,6 +8413,7 @@ var BITS = {
         // Image resource
         key: ConfigKey.group_resourceImage,
         description: "Resource image tags for logo grave images, used to attach images",
+        exportJsonKey: { images: "$" },
         minCount: 1,
         maxCount: Count.infinity
       }
@@ -8056,15 +8577,27 @@ var BITS = {
         format: TagFormat.plainText,
         chain: [
           {
+            exportJsonKey: { reference: "$" },
             key: ConfigKey.tag_reference,
             format: TagFormat.plainText,
             description: "Reference tag for the book, used to link to the book in the system",
-            maxCount: 2
+            maxCount: 1,
+            chain: [
+              {
+                key: ConfigKey.tag_reference,
+                jsonKey: "referenceEnd",
+                exportJsonKey: { referenceEnd: "$" },
+                format: TagFormat.plainText,
+                description: "End reference tag for the book, used to specify a range",
+                maxCount: 1
+              }
+            ]
           }
         ]
       },
       {
         /* Allow incorrectly chained reference tag */
+        exportJsonKey: { reference: "$" },
         key: ConfigKey.tag_reference,
         format: TagFormat.plainText,
         description: "Reference tag for the book, used to link to the book in the system"
@@ -8111,18 +8644,41 @@ var BITS = {
         format: TagFormat.plainText,
         chain: [
           {
+            exportJsonKey: { reference: "$" },
             key: ConfigKey.tag_reference,
             format: TagFormat.plainText,
             description: "Reference tag for the book, used to link to the book in the system",
-            maxCount: 2
+            maxCount: 1,
+            chain: [
+              {
+                key: ConfigKey.tag_reference,
+                jsonKey: "referenceEnd",
+                exportJsonKey: { referenceEnd: "$" },
+                format: TagFormat.plainText,
+                description: "End reference tag for the book, used to specify a range",
+                maxCount: 1
+              }
+            ]
           }
         ]
       },
       {
         /* Allow incorrectly chained reference tag */
+        exportJsonKey: { reference: "$" },
         key: ConfigKey.tag_reference,
         format: TagFormat.plainText,
-        description: "Reference tag for the book, used to link to the book in the system"
+        description: "Reference tag for the book, used to link to the book in the system",
+        maxCount: 1,
+        chain: [
+          {
+            key: ConfigKey.tag_reference,
+            jsonKey: "referenceEnd",
+            exportJsonKey: { referenceEnd: "$" },
+            format: TagFormat.plainText,
+            description: "End reference tag for the book, used to specify a range",
+            maxCount: 1
+          }
+        ]
       },
       {
         key: ConfigKey.property_buttonCaption,
@@ -8151,10 +8707,21 @@ var BITS = {
         maxCount: Count.infinity,
         chain: [
           {
+            exportJsonKey: { reference: "$" },
             key: ConfigKey.tag_reference,
             format: TagFormat.plainText,
             description: "Reference tag for the book, used to link to the book in the system",
-            maxCount: 2
+            maxCount: 1,
+            chain: [
+              {
+                key: ConfigKey.tag_reference,
+                jsonKey: "referenceEnd",
+                exportJsonKey: { referenceEnd: "$" },
+                format: TagFormat.plainText,
+                description: "End reference tag for the book, used to specify a range",
+                maxCount: 1
+              }
+            ]
           }
         ]
       },
@@ -8321,6 +8888,7 @@ var BITS = {
     tags: [
       {
         key: ConfigKey.resource_backgroundWallpaper,
+        exportJsonKey: { backgroundWallpaper: { type: "image", image: { src: "$" } } },
         description: "Background wallpaper for the image, used to set a background for the image",
         chain: [
           {
@@ -8503,6 +9071,7 @@ var BITS = {
       },
       {
         key: ConfigKey.resource_backgroundWallpaper,
+        exportJsonKey: { backgroundWallpaper: { type: "image", image: { src: "$" } } },
         description: "Background wallpaper for the image, used to set a background for the image",
         chain: [
           {
@@ -8655,6 +9224,7 @@ var BITS = {
         // Image resource
         key: ConfigKey.group_resourceImage,
         description: "Resource image tags for logo grave images, used to attach images",
+        exportJsonKey: { logos: "$" },
         minCount: 1,
         maxCount: Count.infinity
       }
@@ -8672,6 +9242,7 @@ var BITS = {
     description: "Internal link bit, used to create links to other bits in articles or books",
     tags: [
       {
+        exportJsonKey: { reference: "$" },
         key: ConfigKey.tag_reference,
         format: TagFormat.plainText,
         description: "Reference tag for the internal link, used to link to the target bit"
@@ -8690,6 +9261,7 @@ var BITS = {
       },
       {
         key: ConfigKey.property_reasonableNumOfChars,
+        exportJsonKey: {},
         description: "Reasonable number of characters for the interview, used to limit input size",
         format: TagFormat.number
       }
@@ -9065,6 +9637,7 @@ var BITS = {
       },
       {
         key: ConfigKey.property_isCaseSensitive,
+        exportJsonKey: {},
         description: "Case sensitivity for matching pairs, used to define if matches are case-sensitive",
         format: TagFormat.boolean,
         defaultValue: "true"
@@ -9117,6 +9690,7 @@ var BITS = {
     tags: [
       {
         key: ConfigKey.property_reasonableNumOfChars,
+        exportJsonKey: {},
         description: "Reasonable number of characters for feedback, used to limit input size",
         format: TagFormat.number
       }
@@ -9258,6 +9832,7 @@ var BITS = {
     description: "Page bit, used to create pages in articles or books",
     tags: [
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "Title of the page, used to display the page title"
       },
@@ -9617,6 +10192,7 @@ var BITS = {
       {
         key: ConfigKey.resource_platformBackgroundImage,
         jsonKey: "platformBackgroundImage|resource(type=image, key=image)",
+        exportJsonKey: { platformBackgroundImage: { type: "image", image: { src: "$" } } },
         description: "The platform section chat background image",
         chain: [
           {
@@ -9710,6 +10286,7 @@ var BITS = {
     description: "Review note bit, used to create review notes in articles or books",
     tags: [
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "Title of the review note, used to display the note title"
       },
@@ -9728,6 +10305,17 @@ var BITS = {
         key: ConfigKey.property_resolvedBy,
         description: "Resolved by for the review note, used to define who resolved the note",
         format: TagFormat.plainText
+      },
+      {
+        // Override inherited @example from group_standardTags: string root example.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: "true" } },
+          { "@absent": { isExample: true, example: "true" } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example text for the review note bit",
+        format: TagFormat.plainText
       }
     ],
     rootExampleType: ExampleType.string
@@ -9780,11 +10368,13 @@ var BITS = {
     tags: [
       // Not sure if these are actually valid here, but include them as they are in the test bit.
       {
+        exportJsonKey: { anchor: "$" },
         key: ConfigKey.tag_anchor,
         format: TagFormat.plainText,
         description: "Anchor for the sample solution, used to link to the solution"
       },
       {
+        exportJsonKey: { reference: "$" },
         key: ConfigKey.tag_reference,
         format: TagFormat.plainText,
         description: "Reference for the sample solution, used to link to the source of the solution"
@@ -9800,6 +10390,19 @@ var BITS = {
       {
         key: ConfigKey.group_quizCommon,
         description: "Common quiz tags for sequences"
+      },
+      {
+        // Override inherited @example from group_standardTags: this bit has
+        // a boolean root example (rootExampleType: boolean), so bit-level
+        // [@example] writes `example: true` in addition to `isExample: true`.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: true } },
+          { "@absent": { isExample: true, example: true } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example flag for the bit (boolean)",
+        format: TagFormat.plainText
       }
     ],
     cardSet: CardSetConfigKey.elements,
@@ -9907,6 +10510,7 @@ var BITS = {
       {
         key: ConfigKey.property_ratingLevelStart,
         jsonKey: "ratingLevelStart.level",
+        exportJsonKey: { ratingLevelStart: { level: "$" } },
         description: "Start level for the rating survey, used to define the lowest rating",
         format: TagFormat.number,
         chain: [
@@ -9920,6 +10524,7 @@ var BITS = {
       {
         key: ConfigKey.property_ratingLevelEnd,
         jsonKey: "ratingLevelEnd.level",
+        exportJsonKey: { ratingLevelEnd: { level: "$" } },
         description: "End level for the rating survey, used to define the highest rating",
         format: TagFormat.number,
         chain: [
@@ -10072,6 +10677,7 @@ var BITS = {
       },
       {
         key: ConfigKey.resource_backgroundWallpaper,
+        exportJsonKey: { backgroundWallpaper: { type: "image", image: { src: "$" } } },
         description: "Background wallpaper for the image, used to set a background for the image",
         chain: [
           {
@@ -10455,12 +11061,34 @@ var BITS = {
         format: TagFormat.plainText
       },
       {
+        exportJsonKey: { choices: [{ choice: "$", isCorrect: true }] },
         key: ConfigKey.tag_true,
-        description: "Tag for the true option in the true/false question"
+        description: "Tag for the true option in the true/false question",
+        format: TagFormat.plainText
       },
       {
+        exportJsonKey: { choices: [{ choice: "$", isCorrect: false }] },
         key: ConfigKey.tag_false,
-        description: "Tag for the false option in the true/false question"
+        description: "Tag for the false option in the true/false question",
+        format: TagFormat.plainText
+      },
+      {
+        // Override inherited @example from group_standardTags: boolean root
+        // example. Note: the legacy reference parser ties the bare-form
+        // example value to `statement.isCorrect`, but the statement is not
+        // yet emitted when this tag fires at bit-header. The pattern below
+        // emits a literal `true` for bare/synthesized and `$` for valued —
+        // sufficient for `[+...]` (correct) statements which dominate the
+        // fixtures; `[-...]` (incorrect) bits with bare `[@example]` would
+        // need either a runtime extension or an explicit `[@example:false]`.
+        key: ConfigKey.property_example,
+        exportJsonKey: [
+          { "@keyonly": { isExample: true, example: true } },
+          { "@absent": { isExample: true, example: true } },
+          { isExample: true, example: "$" }
+        ],
+        description: "The example flag for the bit (boolean)",
+        format: TagFormat.plainText
       }
     ],
     rootExampleType: ExampleType.boolean
@@ -11043,6 +11671,8 @@ var Config = class {
               maxCount: 1,
               chain: tag.chain,
               jsonKey: tag.jsonKey,
+              exportJsonKey: tag.exportJsonKey,
+              hasExportJsonKey: tag.hasExportJsonKey,
               deprecated: tag.deprecated
             });
             finalResourceTags[k] = newTag;
@@ -11147,7 +11777,7 @@ var instance2 = new Config();
 // src/generated/package_info.ts
 var PACKAGE_INFO = {
   "name": "@gmb/bitmark-parser-generator",
-  "version": "5.22.0",
+  "version": "5.23.0",
   "author": "Get More Brain Ltd",
   "license": "ISC",
   "description": "A bitmark parser and generator using Peggy.js"
@@ -11741,6 +12371,8 @@ var NodeType = {
   gmbExternalShopItems: "gmbExternalShopItems",
   groupTag: "groupTag",
   groupTagValue: "groupTagValue",
+  gUri: "gUri",
+  gUriValue: "gUriValue",
   handInAcceptFileType: "handInAcceptFileType",
   handInAcceptFileTypeValue: "handInAcceptFileTypeValue",
   handInInstruction: "handInInstruction",
@@ -12083,6 +12715,8 @@ var NodeType = {
   solution: "solution",
   solutions: "solutions",
   solutionsValue: "solutionsValue",
+  sourceBB: "sourceBB",
+  sourceBBValue: "sourceBBValue",
   sourceDocument: "sourceDocument",
   sourceDocumentValue: "sourceDocumentValue",
   sourceRL: "sourceRL",
@@ -24963,6 +25597,7 @@ var Builder = class extends BaseBuilder {
       isCommented: data.isCommented,
       // Properties
       id: this.toAstProperty(bitType, ConfigKey.property_id, data.id, options),
+      gUri: this.toAstProperty(bitType, ConfigKey.property_gUri, data.gUri, options),
       internalComment: this.toAstProperty(
         bitType,
         ConfigKey.property_internalComment,
@@ -25174,6 +25809,7 @@ var Builder = class extends BaseBuilder {
         data.extractorInternal,
         options
       ),
+      sourceBB: this.normaliseSourceBB(data.sourceBB),
       levelCEFRp: this.toAstProperty(
         bitType,
         ConfigKey.property_levelCEFRp,
@@ -26194,6 +26830,19 @@ var Builder = class extends BaseBuilder {
     nodes = Object.values(combinedNodes);
     return nodes.length > 0 ? nodes : void 0;
   }
+  /**
+   * Normalise a sourceBB input into the AST shape (always number[][]).
+   * Accepts a single 4-number tuple or an array of tuples; returns undefined when empty.
+   */
+  normaliseSourceBB(data) {
+    if (data == null) return void 0;
+    if (!Array.isArray(data) || data.length === 0) return void 0;
+    const isNested = data.some(Array.isArray);
+    const tuples = (isNested ? data : [data]).filter(
+      (t) => Array.isArray(t) && t.length === 4 && t.every((n) => typeof n === "number")
+    );
+    return tuples.length > 0 ? tuples : void 0;
+  }
   /**
    * Build groupTag node
    *
@@ -28513,6 +29162,23 @@ var BitmarkGenerator = class extends AstWalkerGenerator {
       format: TagFormat.plainText
     });
   }
+  // bitmarkAst -> bits -> bitsValue -> sourceBB
+  enter_sourceBB(node, route) {
+    const parent = this.getParentNode(route);
+    if (parent?.key !== NodeType.bitsValue) return false;
+    const tuples = node.value;
+    if (!Array.isArray(tuples) || tuples.length === 0) return false;
+    this.writeProperty(
+      "sourceBB",
+      tuples.map((t) => t.join(", ")),
+      route,
+      {
+        format: TagFormat.plainText,
+        array: true
+      }
+    );
+    return false;
+  }
   // bitmarkAst -> bits -> bitsValue -> questions -> questionsValue -> additionalSolutions -> additionalSolutionsValue
   leaf_additionalSolutionsValue(node, route) {
     const parent = this.getParentNode(route, 2);
@@ -30636,6 +31302,16 @@ var JsonGenerator = class extends AstWalkerGenerator {
   enter_ratingLevelEnd(node, route) {
     return this.standardHandler(node, route, NodeType.bitsValue, { array: false });
   }
+  // bitmarkAst -> bits -> bitsValue -> sourceBB
+  enter_sourceBB(node, route) {
+    const tuples = node.value;
+    const parent = this.getParentNode(route);
+    if (parent?.key !== NodeType.bitsValue) return false;
+    if (tuples && tuples.length > 0) {
+      this.bitJson.sourceBB = tuples.length === 1 ? tuples[0] : tuples;
+    }
+    return false;
+  }
   // bitmarkAst -> bits -> bitsValue -> productId
   enter_productId(node, route) {
     const productIds = node.value;
@@ -35332,6 +36008,17 @@ function propertyContentProcessor(context, contentDepth, tagsConfig, content, ta
               format: TextFormat.bitmarkText,
               location: TextLocation.tag
             });
+          case TagFormat.coordinates:
+            const coordRaw = instance3.unbreakscape(v2, {
+              format: TextFormat.plainText,
+              location: TextLocation.tag
+            });
+            if (coordRaw == null) return void 0;
+            const coordParts = coordRaw.split(",").map((p) => instance6.asNumber(p.trim()));
+            if (coordParts.length !== 4 || coordParts.some((n) => n == null)) {
+              return void 0;
+            }
+            return coordParts;
         }
       }
       return instance3.unbreakscape(v2, {
@@ -35368,6 +36055,8 @@ function propertyContentProcessor(context, contentDepth, tagsConfig, content, ta
         minCount: 1,
         chain: void 0,
         jsonKey: void 0,
+        exportJsonKey: void 0,
+        hasExportJsonKey: false,
         format: TagFormat.bitmarkText,
         values: void 0,
         defaultValue: void 0,
@@ -35378,19 +36067,18 @@ function propertyContentProcessor(context, contentDepth, tagsConfig, content, ta
 }
 
 // src/parser/bitmark/peg/contentProcessors/ReferenceTagContentProcessor.ts
-function referenceTagContentProcessor(_context, _contentDepth, _tagsConfig, content, target, isReferenceEnd) {
-  const { value } = content;
+function referenceTagContentProcessor(context, _contentDepth, tagsConfig, content, target) {
+  const { value, chain } = content;
   const trimmedStringValue = stringUtils.trimmedString(value);
-  if (isReferenceEnd) {
-    target.referenceEnd = instance3.unbreakscape(trimmedStringValue, {
-      format: TextFormat.bitmarkText,
-      location: TextLocation.tag
-    });
-  } else {
-    target.reference = instance3.unbreakscape(trimmedStringValue, {
-      format: TextFormat.bitmarkText,
-      location: TextLocation.tag
-    });
+  target.reference = instance3.unbreakscape(trimmedStringValue, {
+    format: TextFormat.bitmarkText,
+    location: TextLocation.tag
+  });
+  if (Array.isArray(chain) && chain.length > 0) {
+    const sub = context.bitContentProcessor(ContentDepth.Chain, tagsConfig, chain);
+    if (sub.reference != null) {
+      target.referenceEnd = sub.reference;
+    }
   }
 }
 
@@ -36080,7 +36768,6 @@ var BitmarkPegParserProcessor = class {
     result.markConfig = [];
     result.extraProperties = {};
     result.internalComments = [];
-    let seenReference = false;
     let inFooter = false;
     const bodyParts = [];
     let bodyTextPart = instance3.EMPTY_STRING;
@@ -36116,15 +36803,7 @@ var BitmarkPegParserProcessor = class {
           defaultTagContentProcessor(this.context, contentDepth, tagsConfig, content, result);
           break;
         case TypeKey.Reference:
-          referenceTagContentProcessor(
-            this.context,
-            contentDepth,
-            tagsConfig,
-            content,
-            result,
-            seenReference
-          );
-          seenReference = true;
+          referenceTagContentProcessor(this.context, contentDepth, tagsConfig, content, result);
           break;
         case TypeKey.Title:
           titleTagContentProcessor(this.context, contentDepth, tagsConfig, content, result);
@@ -40434,52 +41113,28 @@ var ConfigBuilder = class {
       BitTagConfigKeyType.group,
       BitTagConfigKeyType.unknown
     ];
+    const exportJsonKeyErrors = [];
     const resolveGroupReferences = (groupKey) => {
       if (squashedGroups.has(groupKey)) {
         const replacements = squashedGroups.get(groupKey);
-        return replacements.flatMap((r) => resolveGroupReferences(r));
+        return replacements.flatMap(
+          (r) => squashedGroups.has(r.key) ? resolveGroupReferences(r.key) : [r]
+        );
       }
-      return [groupKey];
+      return [{ key: groupKey }];
     };
-    const keyToJsonKey = (key, tagNameChain) => {
-      let jsonKey = key;
-      if (key === "%") {
-        jsonKey = "item";
-      } else if (key === "!") {
-        jsonKey = "instruction";
-      } else if (key === "?") {
-        jsonKey = "hint";
-      } else if (key === "#") {
-        jsonKey = "title";
-      } else if (key === "##") {
-        jsonKey = "subTitle";
-      } else if (key === "\u25BC") {
-        jsonKey = "anchor";
-      } else if (key === "\u25BA") {
-        jsonKey = "reference";
-      } else if (key === "$") {
-        jsonKey = "sampleSolution";
-      } else if (key === "+") {
-        jsonKey = "choices[]|set(isCorrect=true)";
-      } else if (key === "-") {
-        jsonKey = "choices[]|set(isCorrect=false)";
-      } else if (key === "_") {
-        jsonKey = "solutions[]";
-      } else if (key === "=") {
-        jsonKey = "solution";
-      } else if (key.startsWith("@")) {
-        jsonKey = key.substring(1);
-      } else if (key.startsWith("&")) {
-        jsonKey = key.substring(1);
-      }
-      const thisChain = [...tagNameChain, jsonKey];
-      jsonKey = thisChain.join(".");
-      return jsonKey;
+    const bareKeyForProperty = (key) => {
+      if (key.startsWith("@") || key.startsWith("&")) return key.substring(1);
+      return void 0;
     };
-    const processTagEntries = (tag, tagNameChain) => {
+    const legacyIsTrivialDefault = (tag) => {
+      const bare = bareKeyForProperty(tag.key);
+      if (bare == null) return false;
+      return tag.jsonKey == null || tag.jsonKey === bare;
+    };
+    const processTagEntries = (tag, pathStack) => {
       const tags2 = [];
       let tagName = tag.key;
-      const jsonKey = tag.jsonKey ?? keyToJsonKey(tagName, tagNameChain);
       const tagType = typeFromConfigKey(tag.key);
       let format = "";
       let chain = void 0;
@@ -40512,32 +41167,57 @@ var ConfigBuilder = class {
       } else if (tagType === BitTagConfigKeyType.group) {
         let k = tag.key;
         if (k.startsWith("group_")) k = k.substring(6);
-        k = /*'_' +*/
-        stringUtils.camelToKebab(k);
+        k = stringUtils.camelToKebab(k);
         const resolvedGroups = resolveGroupReferences(k);
-        for (const groupKey of resolvedGroups) {
+        const hasOuterExport = Object.prototype.hasOwnProperty.call(tag, "exportJsonKey");
+        if (!hasOuterExport && tag.jsonKey != null) {
+          const headingPath = [...pathStack, `tags.${tag.key}`].join(" / ");
+          exportJsonKeyErrors.push(
+            `Missing exportJsonKey for non-default jsonKey at ${headingPath} (legacy: \`${tag.jsonKey}\`)`
+          );
+        }
+        for (const ref of resolvedGroups) {
+          const exportJsonKeyChosen = hasOuterExport ? tag.exportJsonKey : ref.exportJsonKey;
+          const hasExportChosen = hasOuterExport || !!ref.hasExportJsonKey;
+          const min = tag.minCount != null ? tag.minCount : ref.min;
+          const max = tag.maxCount != null ? tag.maxCount : ref.max;
+          const description = tag.description ? tag.description : ref.description;
           tags2.push({
             type: "group",
-            key: groupKey,
-            ...tag.jsonKey ? { jsonKey: tag.jsonKey } : {},
-            ...tag.minCount != null ? { min: tag.minCount } : {},
-            ...tag.maxCount != null ? { max: tag.maxCount } : {},
-            ...tag.description ? { description: tag.description } : {}
+            key: ref.key,
+            ...hasExportChosen ? { jsonKey: exportJsonKeyChosen } : {},
+            ...min != null ? { min } : {},
+            ...max != null ? { max } : {},
+            ...description ? { description } : {}
           });
         }
         return tags2;
       }
       if (Array.isArray(tag.chain) && tag.chain.length > 0) {
         const chainTags = [];
-        for (const [_tagKey, chainTag] of tag.chain.entries()) {
-          chainTags.push(...processTagEntries(chainTag, []));
+        const childPathStack = [...pathStack, `tags.${tag.key}`];
+        for (const [, chainTag] of tag.chain.entries()) {
+          chainTags.push(...processTagEntries(chainTag, childPathStack));
         }
         chain = chainTags;
       }
+      const hasExport = Object.prototype.hasOwnProperty.call(tag, "exportJsonKey");
+      let exportJsonKeyField;
+      if (hasExport) {
+        exportJsonKeyField = { jsonKey: tag.exportJsonKey };
+      } else if (legacyIsTrivialDefault(tag)) {
+        exportJsonKeyField = {};
+      } else {
+        const headingPath = [...pathStack, `tags.${tag.key}`].join(" / ");
+        exportJsonKeyErrors.push(
+          `Missing exportJsonKey for non-default jsonKey at ${headingPath}` + (tag.jsonKey ? ` (legacy: \`${tag.jsonKey}\`)` : ` (symbol-mapped tag \`${tag.key}\`)`)
+        );
+        exportJsonKeyField = {};
+      }
       const t = {
         type: "tag",
         key: tagName,
-        jsonKey,
+        ...exportJsonKeyField,
         format,
         default: tag.defaultValue ?? null,
         ...tag.nullable ? { nullable: true } : {},
@@ -40545,19 +41225,30 @@ var ConfigBuilder = class {
         max: tag.maxCount == null ? 1 : tag.maxCount,
         description: tag.description ?? "",
         tags: chain
-        // raw: {
-        //   ...tag,
-        // },
       };
       tags2.push(t);
       return tags2;
     };
+    const cardJsonKeyField = (container, legacyKey, exportKey, pathHeading) => {
+      const c = container;
+      const hasExport = Object.prototype.hasOwnProperty.call(c, exportKey);
+      if (hasExport) return { jsonKey: c[exportKey] };
+      const legacy = c[legacyKey];
+      if (legacy == null) return {};
+      exportJsonKeyErrors.push(
+        `Missing exportJsonKey for non-default jsonKey at ${pathHeading} (legacy: \`${legacy}\`)`
+      );
+      return {};
+    };
     const serializeCardSet = (cardSetKey) => {
+      const variantBodyFormat = (variant) => variant.format ?? TextFormat.bitmarkText;
       const cardSetConfig = CARDSETS[cardSetKey];
       if (!cardSetConfig) return void 0;
       const normalizedKey = normalizeCardKey(cardSetKey);
-      const sides = cardSetConfig.sides.map((side) => {
-        const variants = side.variants.map((variant) => {
+      const sides = cardSetConfig.sides.map((side, sideIdx) => {
+        const sidePath = `cardSets.${normalizedKey} / sides.${side.name ?? `[${sideIdx}]`}`;
+        const variants = side.variants.map((variant, variantIdx) => {
+          const variantPath = `${sidePath} / variants.[${variantIdx}]`;
           const variantTags = [];
           const variantTagEntries = Object.entries(variant.tags ?? []).sort((a, b) => {
             const tagA = a[1];
@@ -40568,10 +41259,11 @@ var ConfigBuilder = class {
             return typeOrder;
           });
           for (const [, variantTag] of variantTagEntries) {
-            variantTags.push(...processTagEntries(variantTag, []));
+            variantTags.push(...processTagEntries(variantTag, [variantPath]));
           }
           return {
-            ...variant.jsonKey !== void 0 ? { jsonKey: variant.jsonKey } : {},
+            ...cardJsonKeyField(variant, "jsonKey", "exportJsonKey", variantPath),
+            format: variantBodyFormat(variant),
             tags: variantTags,
             repeatCount: variant.repeatCount ?? 1,
             ...variant.bodyRequired ? { bodyRequired: true } : {},
@@ -40581,41 +41273,41 @@ var ConfigBuilder = class {
         return {
           name: side.name,
           ...side.repeat ? { repeat: side.repeat } : {},
-          ...side.jsonKey != null ? { jsonKey: side.jsonKey } : {},
+          ...cardJsonKeyField(side, "jsonKey", "exportJsonKey", sidePath),
           variants
         };
       });
       if (cardSetConfig.sections) {
         const cards = Object.entries(cardSetConfig.sections).map(([sectionName, section]) => {
-          let cardSides = section.sideJsonKey ? sides.map((s) => ({ ...s, jsonKey: section.sideJsonKey })) : sides;
-          if (normalizedKey === "table-extended" && sectionName !== "table-header") {
-            cardSides = JSON.parse(JSON.stringify(cardSides));
-            for (const side of cardSides) {
-              for (const variant of side.variants) {
-                for (const tag of variant.tags) {
-                  if (tag.type === "tag" && tag.key === "#" && tag.jsonKey === ".") {
-                    tag.jsonKey = "^table.header.rows.cells[{s}].content";
-                  }
-                }
-              }
-            }
+          const sectionPath = `cardSets.${normalizedKey} / cards.${sectionName}`;
+          const hasSideExport = Object.prototype.hasOwnProperty.call(section, "sideExportJsonKey");
+          let cardSides = sides;
+          if (hasSideExport || section.sideJsonKey != null) {
+            const sideOverride = cardJsonKeyField(
+              section,
+              "sideJsonKey",
+              "sideExportJsonKey",
+              `${sectionPath} / sides.*`
+            );
+            cardSides = sides.map((s) => ({ ...s, ...sideOverride }));
           }
           return {
             name: sectionName,
             ...section.isDefault ? { isDefault: true } : {},
-            jsonKey: section.jsonKey,
+            ...cardJsonKeyField(section, "jsonKey", "exportJsonKey", sectionPath),
             sides: cardSides
           };
         });
         return { name: normalizedKey, cards };
       }
+      const cardSetPath = `cardSets.${normalizedKey} / cards.default`;
       return {
         name: normalizedKey,
         cards: [
           {
             name: "default",
             isDefault: true,
-            jsonKey: cardSetConfig.jsonKey,
+            ...cardJsonKeyField(cardSetConfig, "jsonKey", "exportJsonKey", cardSetPath),
             sides
           }
         ]
@@ -40642,10 +41334,20 @@ var ConfigBuilder = class {
       if (allAreGroups && processedTags.length > 0) {
         const replacements = [];
         if (b.baseBitType) {
-          replacements.push(`group-${b.baseBitType}`);
+          replacements.push({ key: `group-${b.baseBitType}` });
         }
         for (const t of processedTags) {
-          replacements.push(t.key);
+          const ref = {
+            key: t.key,
+            ...t.min != null ? { min: t.min } : {},
+            ...t.max != null ? { max: t.max } : {},
+            ...t.description ? { description: t.description } : {}
+          };
+          if (Object.prototype.hasOwnProperty.call(t, "jsonKey")) {
+            ref.exportJsonKey = t.jsonKey;
+            ref.hasExportJsonKey = true;
+          }
+          replacements.push(ref);
         }
         squashedGroups.set(groupKey, replacements);
       }
@@ -40664,19 +41366,27 @@ var ConfigBuilder = class {
       const isInheritedFrom = bitGroupConfigKeys.has(b.bitType);
       if (isInheritedFrom) {
         const resolvedGroups = resolveGroupReferences(`group-${b.bitType}`);
-        for (const groupKey of resolvedGroups) {
+        for (const ref of resolvedGroups) {
           tags2.push({
             type: "group",
-            key: groupKey
+            key: ref.key,
+            ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+            ...ref.min != null ? { min: ref.min } : {},
+            ...ref.max != null ? { max: ref.max } : {},
+            ...ref.description ? { description: ref.description } : {}
           });
         }
       } else {
         if (b.baseBitType) {
           const resolvedGroups = resolveGroupReferences(`group-${b.baseBitType}`);
-          for (const groupKey of resolvedGroups) {
+          for (const ref of resolvedGroups) {
             tags2.push({
               type: "group",
-              key: groupKey
+              key: ref.key,
+              ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+              ...ref.min != null ? { min: ref.min } : {},
+              ...ref.max != null ? { max: ref.max } : {},
+              ...ref.description ? { description: ref.description } : {}
             });
           }
         }
@@ -40796,10 +41506,14 @@ var ConfigBuilder = class {
         const tags2 = [];
         if (b.baseBitType) {
           const resolvedGroups = resolveGroupReferences(`group-${b.baseBitType}`);
-          for (const gk of resolvedGroups) {
+          for (const ref of resolvedGroups) {
             tags2.push({
               type: "group",
-              key: gk
+              key: ref.key,
+              ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+              ...ref.min != null ? { min: ref.min } : {},
+              ...ref.max != null ? { max: ref.max } : {},
+              ...ref.description ? { description: ref.description } : {}
             });
           }
         }
@@ -40834,6 +41548,13 @@ var ConfigBuilder = class {
     };
     writeBitsAsGroupConfigs(bitGroupConfigs);
     writeCardConfigs();
+    if (exportJsonKeyErrors.length > 0) {
+      console.error("\n\u26A0\uFE0F  exportJsonKey validation errors:");
+      for (const e of exportJsonKeyErrors) console.error(`  - ${e}`);
+      throw new Error(
+        `exportJsonKey validation failed: ${exportJsonKeyErrors.length} entr${exportJsonKeyErrors.length === 1 ? "y" : "ies"} with non-default jsonKey but no exportJsonKey companion.`
+      );
+    }
     Promise.all(fileWrites).then(() => {
       const validationErrors = this.validateConfigTree(outputFolder);
       if (validationErrors.length > 0) {
@@ -41722,6 +42443,117 @@ var JsonStringGenerator = class {
   }
 };
 
+// src/utils/BoundingBox.ts
+function toBbox(arr) {
+  if (!Array.isArray(arr) || arr.length !== 4) return null;
+  if (!arr.every(Number.isFinite)) return null;
+  return [arr[0], arr[1], arr[2], arr[3]];
+}
+function parseSourceBB(sourceBB) {
+  if (sourceBB == null) return [];
+  if (!Array.isArray(sourceBB) || sourceBB.length === 0) return [];
+  const isNested = sourceBB.some(Array.isArray);
+  const candidates = isNested ? sourceBB : [sourceBB];
+  const out = [];
+  for (const candidate of candidates) {
+    const box = toBbox(candidate);
+    if (box) out.push(box);
+  }
+  return out;
+}
+function boundingBoxIntersects(a, b) {
+  return a[0] < b[2] && a[2] > b[0] && a[1] < b[3] && a[3] > b[1];
+}
+function boundingBoxUnion(boxes) {
+  if (boxes.length === 0) return null;
+  let [x0, y0, x1, y1] = boxes[0];
+  for (let i = 1; i < boxes.length; i++) {
+    const b = boxes[i];
+    if (b[0] < x0) x0 = b[0];
+    if (b[1] < y0) y0 = b[1];
+    if (b[2] > x1) x1 = b[2];
+    if (b[3] > y1) y1 = b[3];
+  }
+  return [x0, y0, x1, y1];
+}
+var BoundingBoxIndex = class _BoundingBoxIndex {
+  constructor(entries) {
+    __publicField(this, "_entries");
+    __publicField(this, "bitmarkParser", new BitmarkParserGenerator());
+    this._entries = entries;
+  }
+  /**
+   * Build an index from already-parsed bits. Bits without a parseable
+   * `sourceBB` are dropped. Order of the input is preserved.
+   *
+   * Pass `options.sourceRL` to scope the index to a single source page —
+   * bits whose `sourceRL` doesn't match (or is absent) are excluded.
+   */
+  static fromBits(wrappers, options) {
+    const filterSourceRL = options?.sourceRL;
+    const entries = [];
+    for (const wrapper of wrappers) {
+      if (!wrapper?.bit) continue;
+      if (filterSourceRL !== void 0 && wrapper.bit.sourceRL !== filterSourceRL) {
+        continue;
+      }
+      const boxes = parseSourceBB(wrapper.bit.sourceBB);
+      if (boxes.length === 0) continue;
+      entries.push({ bit: wrapper.bit, wrapper, boxes });
+    }
+    return new _BoundingBoxIndex(entries);
+  }
+  /** All bits with at least one valid `sourceBB`, in input order. */
+  get entries() {
+    return this._entries;
+  }
+  /**
+   * Bits whose ANY `sourceBB` box intersects `query` (strict overlap —
+   * touching-only edges do NOT count as an intersection).
+   */
+  intersecting(query) {
+    const matches = [];
+    for (const entry of this._entries) {
+      if (entry.boxes.some((box) => boundingBoxIntersects(query, box))) {
+        matches.push(entry);
+      }
+    }
+    return matches;
+  }
+  /**
+   * Flat list of every individual `sourceBB` box that intersects `query`.
+   * For a multi-box bit, only the boxes that themselves intersected are
+   * returned.
+   */
+  intersectingBoxes(query) {
+    const matches = [];
+    for (const entry of this._entries) {
+      for (const box of entry.boxes) {
+        if (boundingBoxIntersects(query, box)) matches.push(box);
+      }
+    }
+    return matches;
+  }
+  /**
+   * Smallest axis-aligned box that fully encloses every individual `sourceBB`
+   * box that intersected the query. For a multi-box bit, only the boxes that
+   * themselves intersected contribute to the union — non-intersecting boxes
+   * from the same bit are ignored. Returns `null` if no box matches.
+   */
+  enclosingBoundingBox(query) {
+    return boundingBoxUnion(this.intersectingBoxes(query));
+  }
+  /** Render selected bits back to bitmark text. Empty input returns `''`. */
+  toBitmark(entries) {
+    if (entries.length === 0) return "";
+    const wrappers = entries.map((e) => e.wrapper);
+    return this.bitmarkParser.convert(wrappers, {
+      outputFormat: Output.bitmark,
+      bitmarkOptions: { prettifyJson: true }
+    });
+  }
+};
+
 // src/index.ts
 init();
 // Annotate the CommonJS export names for ESM import in node:
@@ -41736,6 +42568,7 @@ init();
   BitmarkStringGenerator,
   BitmarkVersion,
   BodyTextFormat,
+  BoundingBoxIndex,
   Builder,
   CardSetVersion,
   FileWriter,