@gmb/bitmark-parser-generator 5.22.0 → 5.23.0

package/dist/browser/esm/index.js

@@ -278,6 +278,7 @@ var BitType2 = {
   footNote: "foot-note",
   formFreeText: "form-free-text",
   formula: "formula",
+  formulaImage: "formula-image",
   gapText: "gap-text",
   gapTextInstructionGrouped: "gap-text-instruction-grouped",
   glossaryTerm: "glossary-term",
@@ -702,8 +703,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
@@ -788,7 +791,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;
@@ -797,6 +804,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;
   }
 };
@@ -806,7 +815,6 @@ var MarkupTagConfig = class extends AbstractTagConfig {
   constructor(params) {
     super({
       type: BitTagConfigKeyType.tag,
-      jsonKey: void 0,
       ...params
     });
     __publicField(this, "type", BitTagConfigKeyType.tag);
@@ -918,8 +926,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
@@ -929,11 +937,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);
@@ -957,14 +973,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) {
@@ -986,13 +1006,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;
   }
@@ -1287,6 +1311,7 @@ var propertyKeys = {
   property_formula: "@formula",
   property_fullName: "@fullName",
   property_groupTag: "@groupTag",
+  property_gUri: "@gUri",
   property_handInAcceptFileType: "@handInAcceptFileType",
   property_handInInstruction: "@handInInstruction",
   property_handInRequirement: "@handInRequirement",
@@ -1422,6 +1447,7 @@ var propertyKeys = {
   property_siteName: "@siteName",
   property_size: "@size",
   property_slug: "@slug",
+  property_sourceBB: "@sourceBB",
   property_sourceDocument: "@sourceDocument",
   property_sourceRL: "@sourceRL",
   property_spaceId: "@spaceId",
@@ -2175,25 +2201,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: "$" } } } }
               }
             ]
           }
@@ -2204,37 +2234,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
@@ -2248,12 +2286,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.definitionList]: {
     jsonKey: "definitions",
+    exportJsonKey: { definitions: "$" },
     sides: [
       {
         name: "term",
         variants: [
           {
             jsonKey: "term.text",
+            exportJsonKey: { term: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2263,13 +2303,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: "$" } } } }
               }
             ]
           }
@@ -2280,6 +2322,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "definition.text",
+            exportJsonKey: { definition: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2289,30 +2332,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
@@ -2326,12 +2376,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchPairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2341,22 +2393,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: "$" }
               }
             ]
           }
@@ -2368,6 +2427,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2377,10 +2437,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
               }
@@ -2396,12 +2461,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchAudioPairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2411,12 +2478,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: "$" }
               }
             ]
           }
@@ -2428,6 +2497,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2437,7 +2507,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,
@@ -2455,12 +2526,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchImagePairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2470,12 +2543,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: "$" }
               }
             ]
           }
@@ -2487,6 +2562,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2496,7 +2572,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,
@@ -2514,12 +2591,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchMatrix]: {
     jsonKey: "matrix",
+    exportJsonKey: { matrix: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2527,6 +2606,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
               },
@@ -2534,10 +2618,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
               }
@@ -2551,6 +2640,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "cells[{s}].values[]",
+            exportJsonKey: { cells: { $s: { values: ["$"] } } },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2558,6 +2648,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
               },
@@ -2565,10 +2667,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
               }
@@ -2584,23 +2691,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
               },
               {
@@ -2619,6 +2730,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.quiz]: {
     jsonKey: "quizzes",
+    exportJsonKey: { quizzes: "$" },
     sides: [
       {
         name: "choices",
@@ -2646,6 +2758,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.feedback]: {
     jsonKey: "feedbacks",
+    exportJsonKey: { feedbacks: "$" },
     sides: [
       {
         name: "choices",
@@ -2665,7 +2778,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
@@ -2677,6 +2791,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "reason.text",
+            exportJsonKey: { reason: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2684,11 +2799,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
               },
@@ -2696,7 +2820,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
@@ -2710,21 +2835,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,
@@ -2764,6 +2897,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "elements[]",
+            exportJsonKey: { elements: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2771,6 +2905,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
               }
@@ -2786,6 +2925,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.table]: {
     jsonKey: "table.data",
+    exportJsonKey: { table: { data: "$" } },
     sides: [
       {
         name: "cell",
@@ -2801,6 +2941,7 @@ var CARDSETS = {
               {
                 key: ConfigKey.tag_title,
                 jsonKey: "^table.columns[]",
+                exportJsonKey: { "@bit": { table: { columns: ["$"] } } },
                 description: "Title of the table."
               },
               {
@@ -2841,18 +2982,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,
@@ -2861,29 +3018,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
               },
@@ -2904,6 +3070,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.pronunciationTable]: {
     jsonKey: "pronunciationTable.data",
+    exportJsonKey: { pronunciationTable: { data: "$" } },
     sides: [
       {
         name: "cell",
@@ -2911,12 +3078,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."
               },
@@ -2937,12 +3106,15 @@ var CARDSETS = {
   //
   [CardSetConfigKey.botActionResponses]: {
     jsonKey: "responses",
+    exportJsonKey: { responses: "$" },
     sides: [
       {
         name: "response",
         variants: [
           {
             jsonKey: "feedback",
+            exportJsonKey: { feedback: "$" },
+            format: TextFormat2.plainText,
             tags: [
               {
                 key: ConfigKey.property_reaction,
@@ -2950,16 +3122,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
               }
@@ -2974,12 +3183,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.clozeList]: {
     jsonKey: "listItems",
+    exportJsonKey: { listItems: "$" },
     sides: [
       {
         name: "content",
         variants: [
           {
             jsonKey: "body",
+            exportJsonKey: { body: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -3000,18 +3211,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."
               }
@@ -3026,14 +3240,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."
               },
@@ -3041,6 +3258,7 @@ var CARDSETS = {
                 key: ConfigKey.tag_true,
                 description: "Checked state for the ingredient.",
                 jsonKey: "|set(checked=true)",
+                exportJsonKey: { checked: true, $: "$" },
                 maxCount: 1
                 // nullable: true,
               },
@@ -3048,6 +3266,7 @@ var CARDSETS = {
                 key: ConfigKey.tag_false,
                 description: "Unchecked state for the ingredient.",
                 jsonKey: "|set(checked=false)",
+                exportJsonKey: { checked: false, $: "$" },
                 maxCount: 1
                 // nullable: true,
               },
@@ -3059,9 +3278,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."
               },
@@ -3097,6 +3318,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.bookReferenceList]: {
     jsonKey: "bookReferences",
+    exportJsonKey: { bookReferences: "$" },
     sides: [
       {
         name: "reference",
@@ -3156,6 +3378,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",
@@ -3339,12 +3566,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
@@ -3375,6 +3604,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",
@@ -3412,6 +3647,7 @@ var GROUPS = {
         maxCount: Count.infinity
       },
       {
+        exportJsonKey: { anchor: "$" },
         key: ConfigKey.tag_anchor,
         name: "Anchor",
         format: TagFormat.plainText,
@@ -3449,23 +3685,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
                   }
@@ -3486,11 +3726,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"
@@ -3510,9 +3752,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
       }
     ]
   },
@@ -3523,6 +3773,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_imageSource,
         jsonKey: "imageSource.url",
+        exportJsonKey: { imageSource: { url: "$" } },
         description: "The source of an image",
         format: TagFormat.plainText,
         chain: [
@@ -3557,6 +3808,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_technicalTerm,
         jsonKey: "technicalTerm.technicalTerm",
+        exportJsonKey: { technicalTerm: { technicalTerm: "$" } },
         description: "The technical term",
         format: TagFormat.plainText,
         chain: [
@@ -3576,6 +3828,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_person,
         jsonKey: "partner.name",
+        exportJsonKey: { partner: { name: "$" } },
         description: "A person",
         format: TagFormat.plainText,
         chain: [
@@ -3587,6 +3840,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"
           }
         ]
@@ -3595,6 +3849,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: [
@@ -3606,6 +3861,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"
           }
         ]
@@ -3617,15 +3873,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,
@@ -3634,12 +3894,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"
@@ -3653,21 +3934,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,
@@ -3676,27 +3963,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,
@@ -3705,8 +4015,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
           }
         ]
       }
@@ -3719,6 +4046,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_mark,
         jsonKey: "marks.mark",
+        exportJsonKey: { marks: { mark: ["$"] } },
         description: "The mark configuration",
         format: TagFormat.plainText,
         maxCount: Count.infinity,
@@ -3742,9 +4070,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,
@@ -3755,8 +4085,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
           }
         ]
       }
@@ -3845,7 +4180,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,
@@ -3861,6 +4197,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: [
           {
@@ -3878,6 +4215,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: [
           {
@@ -4037,10 +4375,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
+              }
+            ]
           }
         ]
       }
@@ -4180,6 +4529,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: [
           {
@@ -4364,6 +4715,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_posterImage,
         jsonKey: "posterImage.src",
+        exportJsonKey: { posterImage: { src: "$" } },
         description: "The poster image for the video",
         format: TagFormat.plainText,
         chain: [
@@ -4420,6 +4772,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_image,
+        exportJsonKey: { resource: { type: "image", image: { src: "$" } } },
         description: "The image resource",
         chain: [
           {
@@ -4484,6 +4837,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_imageLink,
+        exportJsonKey: { resource: { type: "image-link", imageLink: { url: "$" } } },
         description: "The link to the image resource",
         chain: [
           {
@@ -4500,6 +4854,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audio,
+        exportJsonKey: { resource: { type: "audio", audio: { src: "$" } } },
         description: "The audio resource",
         chain: [
           {
@@ -4516,6 +4871,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audioEmbed,
+        exportJsonKey: { resource: { type: "audio-embed", audioEmbed: { src: "$" } } },
         description: "The embedded audio resource",
         chain: [
           {
@@ -4532,6 +4888,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audioLink,
+        exportJsonKey: { resource: { type: "audio-link", audioLink: { url: "$" } } },
         description: "The link to the audio resource",
         chain: [
           {
@@ -4548,6 +4905,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_video,
+        exportJsonKey: { resource: { type: "video", video: { src: "$" } } },
         description: "The video resource",
         chain: [
           {
@@ -4564,6 +4922,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_videoEmbed,
+        exportJsonKey: { resource: { type: "video-embed", videoEmbed: { url: "$" } } },
         description: "The embedded video resource",
         chain: [
           {
@@ -4580,6 +4939,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_videoLink,
+        exportJsonKey: { resource: { type: "video-link", videoLink: { url: "$" } } },
         description: "The link to the video resource",
         chain: [
           {
@@ -4596,6 +4956,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: [
           {
@@ -4612,6 +4975,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: [
           {
@@ -4676,6 +5042,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_document,
+        exportJsonKey: { resource: { type: "document", document: { url: "$" } } },
         description: "The document resource",
         chain: [
           {
@@ -4692,6 +5059,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentEmbed,
+        exportJsonKey: { resource: { type: "document-embed", documentEmbed: { url: "$" } } },
         description: "The embedded document resource",
         chain: [
           {
@@ -4708,6 +5076,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentLink,
+        exportJsonKey: { resource: { type: "document-link", documentLink: { url: "$" } } },
         description: "The link to the document resource",
         chain: [
           {
@@ -4724,6 +5093,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentDownload,
+        exportJsonKey: { resource: { type: "document-download", documentDownload: { url: "$" } } },
         description: "The downloadable document resource",
         chain: [
           {
@@ -4740,6 +5110,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_appLink,
+        exportJsonKey: { resource: { type: "app-link", appLink: { url: "$" } } },
         description: "The link to the app resource",
         chain: [
           {
@@ -4756,6 +5127,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_websiteLink,
+        exportJsonKey: { resource: { type: "website-link", websiteLink: { url: "$" } } },
         description: "The link to the website resource",
         chain: [
           {
@@ -4814,6 +5186,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: [
           {
@@ -4831,6 +5204,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: [
           {
@@ -4895,20 +5269,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 = Enum2(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No tag key found for config key '${configKey}'`);
     const tag = Enum2(Tag).fromValue(configKey);
@@ -4923,6 +5325,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 {
@@ -4941,7 +5346,8 @@ var ConfigHydrator = class {
       format,
       values,
       defaultValue,
-      jsonKey
+      jsonKey,
+      exportJsonKey
     } = _tag;
     const configKey = Enum2(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No property key found for config key '${configKey}'`);
@@ -4957,6 +5363,8 @@ var ConfigHydrator = class {
       minCount: minCount ?? MIN_COUNT_DEFAULT,
       chain,
       jsonKey,
+      exportJsonKey,
+      hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
       format,
       values,
       defaultValue,
@@ -4969,7 +5377,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 = Enum2(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No resource key found for config key '${configKey}'`);
     const tag = _configKey.substring(1);
@@ -4984,6 +5400,8 @@ var ConfigHydrator = class {
       minCount: minCount ?? MIN_COUNT_DEFAULT,
       chain,
       jsonKey,
+      exportJsonKey,
+      hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
       deprecated
     });
     return {
@@ -5015,14 +5433,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;
   }
@@ -5060,6 +5489,7 @@ var BITS = {
         description: "Common tags for quiz bits"
       },
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "The title of the flashcard quiz"
       },
@@ -5068,6 +5498,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
@@ -5149,6 +5593,7 @@ var BITS = {
     description: "Article bit, used for articles / paragraphs",
     tags: [
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "The title of the article"
       }
@@ -5256,7 +5701,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,
@@ -5266,6 +5712,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: [
           {
@@ -5393,6 +5840,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
@@ -5406,7 +5864,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,
@@ -5416,6 +5875,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: [
           {
@@ -5543,6 +6003,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
@@ -5556,7 +6027,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,
@@ -5682,6 +6154,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
@@ -5883,11 +6366,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"
@@ -6089,7 +6574,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,
@@ -6233,6 +6719,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"
@@ -6240,7 +6727,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,
@@ -6293,6 +6781,7 @@ var BITS = {
       },
       {
         key: ConfigKey.property_isCaseSensitive,
+        exportJsonKey: {},
         description: "If the cloze answers are case sensitive",
         format: TagFormat.boolean,
         defaultValue: "true"
@@ -6390,6 +6879,11 @@ var BITS = {
     description: "Formula bit, used for mathematical formulas in articles or documents",
     textFormatDefault: TextFormat2.latex
   },
+  [BitType2.formulaImage]: {
+    since: "5.23.0",
+    baseBitType: BitType2.formula,
+    description: "Formula image bit, used for mathematical formulas rendered as images"
+  },
   [BitType2.smartStandardFormula]: {
     since: "3.11.0",
     baseBitType: BitType2.formula,
@@ -6742,6 +7236,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: [
@@ -6767,6 +7262,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
@@ -6944,6 +7440,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
@@ -6964,8 +7471,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
@@ -7831,6 +8350,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
       }
@@ -7994,15 +8514,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"
@@ -8049,18 +8581,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,
@@ -8089,10 +8644,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
+              }
+            ]
           }
         ]
       },
@@ -8259,6 +8825,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: [
           {
@@ -8441,6 +9008,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: [
           {
@@ -8593,6 +9161,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
       }
@@ -8610,6 +9179,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"
@@ -8628,6 +9198,7 @@ var BITS = {
       },
       {
         key: ConfigKey.property_reasonableNumOfChars,
+        exportJsonKey: {},
         description: "Reasonable number of characters for the interview, used to limit input size",
         format: TagFormat.number
       }
@@ -9003,6 +9574,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"
@@ -9055,6 +9627,7 @@ var BITS = {
     tags: [
       {
         key: ConfigKey.property_reasonableNumOfChars,
+        exportJsonKey: {},
         description: "Reasonable number of characters for feedback, used to limit input size",
         format: TagFormat.number
       }
@@ -9196,6 +9769,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"
       },
@@ -9555,6 +10129,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: [
           {
@@ -9648,6 +10223,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"
       },
@@ -9666,6 +10242,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
@@ -9718,11 +10305,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"
@@ -9738,6 +10327,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,
@@ -9845,6 +10447,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: [
@@ -9858,6 +10461,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: [
@@ -10010,6 +10614,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: [
           {
@@ -10393,12 +10998,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
@@ -10981,6 +11608,8 @@ var Config = class {
               maxCount: 1,
               chain: tag.chain,
               jsonKey: tag.jsonKey,
+              exportJsonKey: tag.exportJsonKey,
+              hasExportJsonKey: tag.hasExportJsonKey,
               deprecated: tag.deprecated
             });
             finalResourceTags[k] = newTag;
@@ -11085,7 +11714,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"
@@ -11679,6 +12308,8 @@ var NodeType = {
   gmbExternalShopItems: "gmbExternalShopItems",
   groupTag: "groupTag",
   groupTagValue: "groupTagValue",
+  gUri: "gUri",
+  gUriValue: "gUriValue",
   handInAcceptFileType: "handInAcceptFileType",
   handInAcceptFileTypeValue: "handInAcceptFileTypeValue",
   handInInstruction: "handInInstruction",
@@ -12021,6 +12652,8 @@ var NodeType = {
   solution: "solution",
   solutions: "solutions",
   solutionsValue: "solutionsValue",
+  sourceBB: "sourceBB",
+  sourceBBValue: "sourceBBValue",
   sourceDocument: "sourceDocument",
   sourceDocumentValue: "sourceDocumentValue",
   sourceRL: "sourceRL",
@@ -24901,6 +25534,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,
@@ -25112,6 +25746,7 @@ var Builder = class extends BaseBuilder {
         data.extractorInternal,
         options
       ),
+      sourceBB: this.normaliseSourceBB(data.sourceBB),
       levelCEFRp: this.toAstProperty(
         bitType,
         ConfigKey.property_levelCEFRp,
@@ -26132,6 +26767,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
    *
@@ -28451,6 +29099,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);
@@ -30574,6 +31239,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;
@@ -35252,6 +35927,17 @@ function propertyContentProcessor(context, contentDepth, tagsConfig, content, ta
               format: TextFormat2.bitmarkText,
               location: TextLocation2.tag
             });
+          case TagFormat.coordinates:
+            const coordRaw = instance3.unbreakscape(v2, {
+              format: TextFormat2.plainText,
+              location: TextLocation2.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, {
@@ -35288,6 +35974,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,
@@ -35298,19 +35986,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: TextFormat2.bitmarkText,
-      location: TextLocation2.tag
-    });
-  } else {
-    target.reference = instance3.unbreakscape(trimmedStringValue, {
-      format: TextFormat2.bitmarkText,
-      location: TextLocation2.tag
-    });
+  target.reference = instance3.unbreakscape(trimmedStringValue, {
+    format: TextFormat2.bitmarkText,
+    location: TextLocation2.tag
+  });
+  if (Array.isArray(chain) && chain.length > 0) {
+    const sub = context.bitContentProcessor(ContentDepth.Chain, tagsConfig, chain);
+    if (sub.reference != null) {
+      target.referenceEnd = sub.reference;
+    }
   }
 }
 
@@ -35996,7 +36683,6 @@ var BitmarkPegParserProcessor = class {
     result.markConfig = [];
     result.extraProperties = {};
     result.internalComments = [];
-    let seenReference = false;
     let inFooter = false;
     const bodyParts = [];
     let bodyTextPart = instance3.EMPTY_STRING;
@@ -36032,15 +36718,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);
@@ -40420,6 +41098,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();
 export {
@@ -40432,6 +41221,7 @@ export {
   BitmarkStringGenerator,
   BitmarkVersion,
   BodyTextFormat,
+  BoundingBoxIndex,
   Builder,
   CardSetVersion,
   InfoFormat,