@gmb/bitmark-parser-generator 5.22.0 → 5.23.0

package/dist/cli/main.js

@@ -278,6 +278,7 @@ var BitType = {
   footNote: "foot-note",
   formFreeText: "form-free-text",
   formula: "formula",
+  formulaImage: "formula-image",
   gapText: "gap-text",
   gapTextInstructionGrouped: "gap-text-instruction-grouped",
   glossaryTerm: "glossary-term",
@@ -688,8 +689,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)
 };
 var TextFormat = {
   // plain text
@@ -760,7 +763,11 @@ var AbstractTagConfig = class {
   // Default: 0
   chain;
   jsonKey;
-  // If the json key is different from the tag
+  // Legacy string-form jsonKey
+  exportJsonKey;
+  // New JSON-pattern jsonKey (export-only)
+  hasExportJsonKey;
+  // True iff exportJsonKey was explicitly set
   deprecated;
   // Deprecated version
   constructor(params) {
@@ -771,6 +778,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;
   }
 };
@@ -781,7 +790,6 @@ var MarkupTagConfig = class extends AbstractTagConfig {
   constructor(params) {
     super({
       type: BitTagConfigKeyType.tag,
-      jsonKey: void 0,
       ...params
     });
   }
@@ -901,13 +909,21 @@ var CardVariantConfig = class {
   // Default: 1
   // JSON mapping fields
   jsonKey;
-  // JSON path for body text
-  constructor(tags2, bodyAllowed, bodyRequired, repeatCount, jsonKey) {
+  // JSON path for body text (legacy)
+  exportJsonKey;
+  // New JSON-pattern jsonKey
+  hasExportJsonKey;
+  format;
+  // Body text format. Default: bitmark++
+  constructor(tags2, bodyAllowed, bodyRequired, repeatCount, jsonKey, exportJsonKey, hasExportJsonKey = false, 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);
@@ -934,11 +950,15 @@ var CardSideConfig = class {
   name;
   repeat;
   jsonKey;
+  exportJsonKey;
+  hasExportJsonKey;
   variants;
-  constructor(name, repeat, variants, jsonKey) {
+  constructor(name, repeat, variants, jsonKey, exportJsonKey, hasExportJsonKey = false) {
     this.name = name;
     this.repeat = repeat;
     this.jsonKey = jsonKey;
+    this.exportJsonKey = exportJsonKey;
+    this.hasExportJsonKey = hasExportJsonKey;
     this.variants = variants;
   }
   toString(options) {
@@ -962,6 +982,8 @@ var CardSideConfig = class {
 var CardSetConfig = class {
   configKey;
   jsonKey;
+  exportJsonKey;
+  hasExportJsonKey;
   sections;
   sides;
   // Legacy accessor — provides the same shape as the old `variants: CardVariantConfig[][]`
@@ -969,9 +991,11 @@ var CardSetConfig = class {
   get variants() {
     return this.sides.map((side) => side.variants);
   }
-  constructor(configKey, jsonKey, sections, sides) {
+  constructor(configKey, jsonKey, exportJsonKey, hasExportJsonKey, sections, sides) {
     this.configKey = configKey;
     this.jsonKey = jsonKey;
+    this.exportJsonKey = exportJsonKey;
+    this.hasExportJsonKey = hasExportJsonKey;
     this.sections = sections;
     this.sides = sides;
   }
@@ -1252,6 +1276,7 @@ var propertyKeys = {
   property_formula: "@formula",
   property_fullName: "@fullName",
   property_groupTag: "@groupTag",
+  property_gUri: "@gUri",
   property_handInAcceptFileType: "@handInAcceptFileType",
   property_handInInstruction: "@handInInstruction",
   property_handInRequirement: "@handInRequirement",
@@ -1387,6 +1412,7 @@ var propertyKeys = {
   property_siteName: "@siteName",
   property_size: "@size",
   property_slug: "@slug",
+  property_sourceBB: "@sourceBB",
   property_sourceDocument: "@sourceDocument",
   property_sourceRL: "@sourceRL",
   property_spaceId: "@spaceId",
@@ -2131,25 +2157,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: "$" } } } }
               }
             ]
           }
@@ -2160,37 +2190,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
@@ -2204,12 +2242,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.definitionList]: {
     jsonKey: "definitions",
+    exportJsonKey: { definitions: "$" },
     sides: [
       {
         name: "term",
         variants: [
           {
             jsonKey: "term.text",
+            exportJsonKey: { term: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2219,13 +2259,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: "$" } } } }
               }
             ]
           }
@@ -2236,6 +2278,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "definition.text",
+            exportJsonKey: { definition: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2245,30 +2288,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
@@ -2282,12 +2332,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchPairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2297,22 +2349,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: "$" }
               }
             ]
           }
@@ -2324,6 +2383,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2333,10 +2393,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
               }
@@ -2352,12 +2417,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchAudioPairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2367,12 +2434,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: "$" }
               }
             ]
           }
@@ -2384,6 +2453,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2393,7 +2463,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,
@@ -2411,12 +2482,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchImagePairs]: {
     jsonKey: "pairs",
+    exportJsonKey: { pairs: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2426,12 +2499,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: "$" }
               }
             ]
           }
@@ -2443,6 +2518,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "values[]",
+            exportJsonKey: { values: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2452,7 +2528,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,
@@ -2470,12 +2547,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.matchMatrix]: {
     jsonKey: "matrix",
+    exportJsonKey: { matrix: "$" },
     sides: [
       {
         name: "key",
         variants: [
           {
             jsonKey: "key",
+            exportJsonKey: { key: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2483,6 +2562,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
               },
@@ -2490,10 +2574,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
               }
@@ -2507,6 +2596,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "cells[{s}].values[]",
+            exportJsonKey: { cells: { $s: { values: ["$"] } } },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2514,6 +2604,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
               },
@@ -2521,10 +2623,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
               }
@@ -2540,23 +2647,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
               },
               {
@@ -2575,6 +2686,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.quiz]: {
     jsonKey: "quizzes",
+    exportJsonKey: { quizzes: "$" },
     sides: [
       {
         name: "choices",
@@ -2602,6 +2714,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.feedback]: {
     jsonKey: "feedbacks",
+    exportJsonKey: { feedbacks: "$" },
     sides: [
       {
         name: "choices",
@@ -2621,7 +2734,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
@@ -2633,6 +2747,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "reason.text",
+            exportJsonKey: { reason: { text: "$" } },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2640,11 +2755,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
               },
@@ -2652,7 +2776,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
@@ -2666,21 +2791,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,
@@ -2720,6 +2853,7 @@ var CARDSETS = {
         variants: [
           {
             jsonKey: "elements[]",
+            exportJsonKey: { elements: ["$"] },
             tags: [
               {
                 key: ConfigKey.group_standardItemLeadInstructionHint,
@@ -2727,6 +2861,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
               }
@@ -2742,6 +2881,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.table]: {
     jsonKey: "table.data",
+    exportJsonKey: { table: { data: "$" } },
     sides: [
       {
         name: "cell",
@@ -2757,6 +2897,7 @@ var CARDSETS = {
               {
                 key: ConfigKey.tag_title,
                 jsonKey: "^table.columns[]",
+                exportJsonKey: { "@bit": { table: { columns: ["$"] } } },
                 description: "Title of the table."
               },
               {
@@ -2797,18 +2938,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,
@@ -2817,29 +2974,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
               },
@@ -2860,6 +3026,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.pronunciationTable]: {
     jsonKey: "pronunciationTable.data",
+    exportJsonKey: { pronunciationTable: { data: "$" } },
     sides: [
       {
         name: "cell",
@@ -2867,12 +3034,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."
               },
@@ -2893,12 +3062,15 @@ var CARDSETS = {
   //
   [CardSetConfigKey.botActionResponses]: {
     jsonKey: "responses",
+    exportJsonKey: { responses: "$" },
     sides: [
       {
         name: "response",
         variants: [
           {
             jsonKey: "feedback",
+            exportJsonKey: { feedback: "$" },
+            format: TextFormat.plainText,
             tags: [
               {
                 key: ConfigKey.property_reaction,
@@ -2906,16 +3078,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
               }
@@ -2930,12 +3139,14 @@ var CARDSETS = {
   //
   [CardSetConfigKey.clozeList]: {
     jsonKey: "listItems",
+    exportJsonKey: { listItems: "$" },
     sides: [
       {
         name: "content",
         variants: [
           {
             jsonKey: "body",
+            exportJsonKey: { body: "$" },
             tags: [
               {
                 key: ConfigKey.group_standardTags,
@@ -2956,18 +3167,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."
               }
@@ -2982,14 +3196,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."
               },
@@ -2997,6 +3214,7 @@ var CARDSETS = {
                 key: ConfigKey.tag_true,
                 description: "Checked state for the ingredient.",
                 jsonKey: "|set(checked=true)",
+                exportJsonKey: { checked: true, $: "$" },
                 maxCount: 1
                 // nullable: true,
               },
@@ -3004,6 +3222,7 @@ var CARDSETS = {
                 key: ConfigKey.tag_false,
                 description: "Unchecked state for the ingredient.",
                 jsonKey: "|set(checked=false)",
+                exportJsonKey: { checked: false, $: "$" },
                 maxCount: 1
                 // nullable: true,
               },
@@ -3015,9 +3234,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."
               },
@@ -3053,6 +3274,7 @@ var CARDSETS = {
   //
   [CardSetConfigKey.bookReferenceList]: {
     jsonKey: "bookReferences",
+    exportJsonKey: { bookReferences: "$" },
     sides: [
       {
         name: "reference",
@@ -3112,6 +3334,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",
@@ -3295,12 +3522,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
@@ -3331,6 +3560,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",
@@ -3368,6 +3603,7 @@ var GROUPS = {
         maxCount: Count.infinity
       },
       {
+        exportJsonKey: { anchor: "$" },
         key: ConfigKey.tag_anchor,
         name: "Anchor",
         format: TagFormat.plainText,
@@ -3405,23 +3641,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
                   }
@@ -3442,11 +3682,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"
@@ -3466,9 +3708,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
       }
     ]
   },
@@ -3479,6 +3729,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_imageSource,
         jsonKey: "imageSource.url",
+        exportJsonKey: { imageSource: { url: "$" } },
         description: "The source of an image",
         format: TagFormat.plainText,
         chain: [
@@ -3513,6 +3764,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_technicalTerm,
         jsonKey: "technicalTerm.technicalTerm",
+        exportJsonKey: { technicalTerm: { technicalTerm: "$" } },
         description: "The technical term",
         format: TagFormat.plainText,
         chain: [
@@ -3532,6 +3784,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_person,
         jsonKey: "partner.name",
+        exportJsonKey: { partner: { name: "$" } },
         description: "A person",
         format: TagFormat.plainText,
         chain: [
@@ -3543,6 +3796,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"
           }
         ]
@@ -3551,6 +3805,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: [
@@ -3562,6 +3817,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"
           }
         ]
@@ -3573,15 +3829,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,
@@ -3590,12 +3850,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"
@@ -3609,21 +3890,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,
@@ -3632,27 +3919,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,
@@ -3661,8 +3971,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
           }
         ]
       }
@@ -3675,6 +4002,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_mark,
         jsonKey: "marks.mark",
+        exportJsonKey: { marks: { mark: ["$"] } },
         description: "The mark configuration",
         format: TagFormat.plainText,
         maxCount: Count.infinity,
@@ -3698,9 +4026,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,
@@ -3711,8 +4041,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
           }
         ]
       }
@@ -3801,7 +4136,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,
@@ -3817,6 +4153,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: [
           {
@@ -3834,6 +4171,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: [
           {
@@ -3993,10 +4331,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
+              }
+            ]
           }
         ]
       }
@@ -4136,6 +4485,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: [
           {
@@ -4320,6 +4671,7 @@ var GROUPS = {
       {
         key: ConfigKey.property_posterImage,
         jsonKey: "posterImage.src",
+        exportJsonKey: { posterImage: { src: "$" } },
         description: "The poster image for the video",
         format: TagFormat.plainText,
         chain: [
@@ -4376,6 +4728,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_image,
+        exportJsonKey: { resource: { type: "image", image: { src: "$" } } },
         description: "The image resource",
         chain: [
           {
@@ -4440,6 +4793,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_imageLink,
+        exportJsonKey: { resource: { type: "image-link", imageLink: { url: "$" } } },
         description: "The link to the image resource",
         chain: [
           {
@@ -4456,6 +4810,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audio,
+        exportJsonKey: { resource: { type: "audio", audio: { src: "$" } } },
         description: "The audio resource",
         chain: [
           {
@@ -4472,6 +4827,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audioEmbed,
+        exportJsonKey: { resource: { type: "audio-embed", audioEmbed: { src: "$" } } },
         description: "The embedded audio resource",
         chain: [
           {
@@ -4488,6 +4844,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_audioLink,
+        exportJsonKey: { resource: { type: "audio-link", audioLink: { url: "$" } } },
         description: "The link to the audio resource",
         chain: [
           {
@@ -4504,6 +4861,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_video,
+        exportJsonKey: { resource: { type: "video", video: { src: "$" } } },
         description: "The video resource",
         chain: [
           {
@@ -4520,6 +4878,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_videoEmbed,
+        exportJsonKey: { resource: { type: "video-embed", videoEmbed: { url: "$" } } },
         description: "The embedded video resource",
         chain: [
           {
@@ -4536,6 +4895,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_videoLink,
+        exportJsonKey: { resource: { type: "video-link", videoLink: { url: "$" } } },
         description: "The link to the video resource",
         chain: [
           {
@@ -4552,6 +4912,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: [
           {
@@ -4568,6 +4931,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: [
           {
@@ -4632,6 +4998,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_document,
+        exportJsonKey: { resource: { type: "document", document: { url: "$" } } },
         description: "The document resource",
         chain: [
           {
@@ -4648,6 +5015,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentEmbed,
+        exportJsonKey: { resource: { type: "document-embed", documentEmbed: { url: "$" } } },
         description: "The embedded document resource",
         chain: [
           {
@@ -4664,6 +5032,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentLink,
+        exportJsonKey: { resource: { type: "document-link", documentLink: { url: "$" } } },
         description: "The link to the document resource",
         chain: [
           {
@@ -4680,6 +5049,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_documentDownload,
+        exportJsonKey: { resource: { type: "document-download", documentDownload: { url: "$" } } },
         description: "The downloadable document resource",
         chain: [
           {
@@ -4696,6 +5066,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_appLink,
+        exportJsonKey: { resource: { type: "app-link", appLink: { url: "$" } } },
         description: "The link to the app resource",
         chain: [
           {
@@ -4712,6 +5083,7 @@ var GROUPS = {
     tags: [
       {
         key: ConfigKey.resource_websiteLink,
+        exportJsonKey: { resource: { type: "website-link", websiteLink: { url: "$" } } },
         description: "The link to the website resource",
         chain: [
           {
@@ -4770,6 +5142,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: [
           {
@@ -4787,6 +5160,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: [
           {
@@ -4851,20 +5225,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 = Enum(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No tag key found for config key '${configKey}'`);
     const tag = Enum(Tag).fromValue(configKey);
@@ -4879,6 +5281,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 {
@@ -4897,7 +5302,8 @@ var ConfigHydrator = class {
       format,
       values,
       defaultValue,
-      jsonKey
+      jsonKey,
+      exportJsonKey
     } = _tag;
     const configKey = Enum(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No property key found for config key '${configKey}'`);
@@ -4913,6 +5319,8 @@ var ConfigHydrator = class {
       minCount: minCount ?? MIN_COUNT_DEFAULT,
       chain,
       jsonKey,
+      exportJsonKey,
+      hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
       format,
       values,
       defaultValue,
@@ -4925,7 +5333,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 = Enum(ConfigKey).fromValue(_configKey) || ConfigKey._unknown;
     if (!configKey) throw new Error(`No resource key found for config key '${configKey}'`);
     const tag = _configKey.substring(1);
@@ -4940,6 +5356,8 @@ var ConfigHydrator = class {
       minCount: minCount ?? MIN_COUNT_DEFAULT,
       chain,
       jsonKey,
+      exportJsonKey,
+      hasExportJsonKey: Object.prototype.hasOwnProperty.call(_tag, "exportJsonKey"),
       deprecated
     });
     return {
@@ -4971,14 +5389,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;
   }
@@ -5016,6 +5445,7 @@ var BITS = {
         description: "Common tags for quiz bits"
       },
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "The title of the flashcard quiz"
       },
@@ -5024,6 +5454,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
@@ -5105,6 +5549,7 @@ var BITS = {
     description: "Article bit, used for articles / paragraphs",
     tags: [
       {
+        exportJsonKey: { title: "$" },
         key: ConfigKey.tag_title,
         description: "The title of the article"
       }
@@ -5212,7 +5657,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,
@@ -5222,6 +5668,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: [
           {
@@ -5349,6 +5796,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
@@ -5362,7 +5820,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,
@@ -5372,6 +5831,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: [
           {
@@ -5499,6 +5959,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
@@ -5512,7 +5983,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,
@@ -5638,6 +6110,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
@@ -5839,11 +6322,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"
@@ -6045,7 +6530,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,
@@ -6189,6 +6675,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"
@@ -6196,7 +6683,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,
@@ -6249,6 +6737,7 @@ var BITS = {
       },
       {
         key: ConfigKey.property_isCaseSensitive,
+        exportJsonKey: {},
         description: "If the cloze answers are case sensitive",
         format: TagFormat.boolean,
         defaultValue: "true"
@@ -6346,6 +6835,11 @@ var BITS = {
     description: "Formula bit, used for mathematical formulas in articles or documents",
     textFormatDefault: TextFormat.latex
   },
+  [BitType.formulaImage]: {
+    since: "5.23.0",
+    baseBitType: BitType.formula,
+    description: "Formula image bit, used for mathematical formulas rendered as images"
+  },
   [BitType.smartStandardFormula]: {
     since: "3.11.0",
     baseBitType: BitType.formula,
@@ -6698,6 +7192,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: [
@@ -6723,6 +7218,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
@@ -6900,6 +7396,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
@@ -6920,8 +7427,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
@@ -7787,6 +8306,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
       }
@@ -7950,15 +8470,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"
@@ -8005,18 +8537,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,
@@ -8045,10 +8600,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
+              }
+            ]
           }
         ]
       },
@@ -8215,6 +8781,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: [
           {
@@ -8397,6 +8964,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: [
           {
@@ -8549,6 +9117,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
       }
@@ -8566,6 +9135,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"
@@ -8584,6 +9154,7 @@ var BITS = {
       },
       {
         key: ConfigKey.property_reasonableNumOfChars,
+        exportJsonKey: {},
         description: "Reasonable number of characters for the interview, used to limit input size",
         format: TagFormat.number
       }
@@ -8959,6 +9530,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"
@@ -9011,6 +9583,7 @@ var BITS = {
     tags: [
       {
         key: ConfigKey.property_reasonableNumOfChars,
+        exportJsonKey: {},
         description: "Reasonable number of characters for feedback, used to limit input size",
         format: TagFormat.number
       }
@@ -9152,6 +9725,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"
       },
@@ -9511,6 +10085,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: [
           {
@@ -9604,6 +10179,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"
       },
@@ -9622,6 +10198,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
@@ -9674,11 +10261,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"
@@ -9694,6 +10283,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,
@@ -9801,6 +10403,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: [
@@ -9814,6 +10417,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: [
@@ -9966,6 +10570,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: [
           {
@@ -10349,12 +10954,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
@@ -10937,6 +11564,8 @@ var Config = class {
               maxCount: 1,
               chain: tag.chain,
               jsonKey: tag.jsonKey,
+              exportJsonKey: tag.exportJsonKey,
+              hasExportJsonKey: tag.hasExportJsonKey,
               deprecated: tag.deprecated
             });
             finalResourceTags[k] = newTag;
@@ -11041,7 +11670,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",
   "license": "ISC"};
 var Environment = {
   unknown: "",
@@ -11603,6 +12232,8 @@ var NodeType = {
   gmbExternalShopItems: "gmbExternalShopItems",
   groupTag: "groupTag",
   groupTagValue: "groupTagValue",
+  gUri: "gUri",
+  gUriValue: "gUriValue",
   handInAcceptFileType: "handInAcceptFileType",
   handInAcceptFileTypeValue: "handInAcceptFileTypeValue",
   handInInstruction: "handInInstruction",
@@ -11945,6 +12576,8 @@ var NodeType = {
   solution: "solution",
   solutions: "solutions",
   solutionsValue: "solutionsValue",
+  sourceBB: "sourceBB",
+  sourceBBValue: "sourceBBValue",
   sourceDocument: "sourceDocument",
   sourceDocumentValue: "sourceDocumentValue",
   sourceRL: "sourceRL",
@@ -24641,6 +25274,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,
@@ -24852,6 +25486,7 @@ var Builder = class extends BaseBuilder {
         data.extractorInternal,
         options
       ),
+      sourceBB: this.normaliseSourceBB(data.sourceBB),
       levelCEFRp: this.toAstProperty(
         bitType,
         ConfigKey.property_levelCEFRp,
@@ -25872,6 +26507,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
    *
@@ -28178,6 +28826,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);
@@ -30291,6 +30956,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;
@@ -34890,6 +35565,17 @@ function propertyContentProcessor(context, contentDepth, tagsConfig, content, ta
               format: TextFormat.bitmarkText,
               location: TextLocation.tag
             });
+          case TagFormat.coordinates:
+            const coordRaw = instance3.unbreakscape(v2, {
+              format: TextFormat.plainText,
+              location: TextLocation.tag
+            });
+            if (coordRaw == null) return void 0;
+            const coordParts = coordRaw.split(",").map((p) => instance6.asNumber(p.trim()));
+            if (coordParts.length !== 4 || coordParts.some((n) => n == null)) {
+              return void 0;
+            }
+            return coordParts;
         }
       }
       return instance3.unbreakscape(v2, {
@@ -34926,6 +35612,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,
@@ -34936,19 +35624,18 @@ function propertyContentProcessor(context, contentDepth, tagsConfig, content, ta
 }
 
 // src/parser/bitmark/peg/contentProcessors/ReferenceTagContentProcessor.ts
-function referenceTagContentProcessor(_context, _contentDepth, _tagsConfig, content, target, isReferenceEnd) {
-  const { value } = content;
+function referenceTagContentProcessor(context, _contentDepth, tagsConfig, content, target) {
+  const { value, chain } = content;
   const trimmedStringValue = stringUtils.trimmedString(value);
-  if (isReferenceEnd) {
-    target.referenceEnd = instance3.unbreakscape(trimmedStringValue, {
-      format: TextFormat.bitmarkText,
-      location: TextLocation.tag
-    });
-  } else {
-    target.reference = instance3.unbreakscape(trimmedStringValue, {
-      format: TextFormat.bitmarkText,
-      location: TextLocation.tag
-    });
+  target.reference = instance3.unbreakscape(trimmedStringValue, {
+    format: TextFormat.bitmarkText,
+    location: TextLocation.tag
+  });
+  if (Array.isArray(chain) && chain.length > 0) {
+    const sub = context.bitContentProcessor(ContentDepth.Chain, tagsConfig, chain);
+    if (sub.reference != null) {
+      target.referenceEnd = sub.reference;
+    }
   }
 }
 var resourceBuilder = new ResourceBuilder();
@@ -35629,7 +36316,6 @@ var BitmarkPegParserProcessor = class {
     result.markConfig = [];
     result.extraProperties = {};
     result.internalComments = [];
-    let seenReference = false;
     let inFooter = false;
     const bodyParts = [];
     let bodyTextPart = instance3.EMPTY_STRING;
@@ -35665,15 +36351,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);
@@ -39919,52 +40597,28 @@ var ConfigBuilder = class {
       BitTagConfigKeyType.group,
       BitTagConfigKeyType.unknown
     ];
+    const exportJsonKeyErrors = [];
     const resolveGroupReferences = (groupKey) => {
       if (squashedGroups.has(groupKey)) {
         const replacements = squashedGroups.get(groupKey);
-        return replacements.flatMap((r) => resolveGroupReferences(r));
+        return replacements.flatMap(
+          (r) => squashedGroups.has(r.key) ? resolveGroupReferences(r.key) : [r]
+        );
       }
-      return [groupKey];
+      return [{ key: groupKey }];
     };
-    const keyToJsonKey = (key, tagNameChain) => {
-      let jsonKey = key;
-      if (key === "%") {
-        jsonKey = "item";
-      } else if (key === "!") {
-        jsonKey = "instruction";
-      } else if (key === "?") {
-        jsonKey = "hint";
-      } else if (key === "#") {
-        jsonKey = "title";
-      } else if (key === "##") {
-        jsonKey = "subTitle";
-      } else if (key === "\u25BC") {
-        jsonKey = "anchor";
-      } else if (key === "\u25BA") {
-        jsonKey = "reference";
-      } else if (key === "$") {
-        jsonKey = "sampleSolution";
-      } else if (key === "+") {
-        jsonKey = "choices[]|set(isCorrect=true)";
-      } else if (key === "-") {
-        jsonKey = "choices[]|set(isCorrect=false)";
-      } else if (key === "_") {
-        jsonKey = "solutions[]";
-      } else if (key === "=") {
-        jsonKey = "solution";
-      } else if (key.startsWith("@")) {
-        jsonKey = key.substring(1);
-      } else if (key.startsWith("&")) {
-        jsonKey = key.substring(1);
-      }
-      const thisChain = [...tagNameChain, jsonKey];
-      jsonKey = thisChain.join(".");
-      return jsonKey;
+    const bareKeyForProperty = (key) => {
+      if (key.startsWith("@") || key.startsWith("&")) return key.substring(1);
+      return void 0;
     };
-    const processTagEntries = (tag, tagNameChain) => {
+    const legacyIsTrivialDefault = (tag) => {
+      const bare = bareKeyForProperty(tag.key);
+      if (bare == null) return false;
+      return tag.jsonKey == null || tag.jsonKey === bare;
+    };
+    const processTagEntries = (tag, pathStack) => {
       const tags2 = [];
       let tagName = tag.key;
-      const jsonKey = tag.jsonKey ?? keyToJsonKey(tagName, tagNameChain);
       const tagType = typeFromConfigKey(tag.key);
       let format = "";
       let chain = void 0;
@@ -39997,32 +40651,57 @@ var ConfigBuilder = class {
       } else if (tagType === BitTagConfigKeyType.group) {
         let k = tag.key;
         if (k.startsWith("group_")) k = k.substring(6);
-        k = /*'_' +*/
-        stringUtils.camelToKebab(k);
+        k = stringUtils.camelToKebab(k);
         const resolvedGroups = resolveGroupReferences(k);
-        for (const groupKey of resolvedGroups) {
+        const hasOuterExport = Object.prototype.hasOwnProperty.call(tag, "exportJsonKey");
+        if (!hasOuterExport && tag.jsonKey != null) {
+          const headingPath = [...pathStack, `tags.${tag.key}`].join(" / ");
+          exportJsonKeyErrors.push(
+            `Missing exportJsonKey for non-default jsonKey at ${headingPath} (legacy: \`${tag.jsonKey}\`)`
+          );
+        }
+        for (const ref of resolvedGroups) {
+          const exportJsonKeyChosen = hasOuterExport ? tag.exportJsonKey : ref.exportJsonKey;
+          const hasExportChosen = hasOuterExport || !!ref.hasExportJsonKey;
+          const min = tag.minCount != null ? tag.minCount : ref.min;
+          const max = tag.maxCount != null ? tag.maxCount : ref.max;
+          const description = tag.description ? tag.description : ref.description;
           tags2.push({
             type: "group",
-            key: groupKey,
-            ...tag.jsonKey ? { jsonKey: tag.jsonKey } : {},
-            ...tag.minCount != null ? { min: tag.minCount } : {},
-            ...tag.maxCount != null ? { max: tag.maxCount } : {},
-            ...tag.description ? { description: tag.description } : {}
+            key: ref.key,
+            ...hasExportChosen ? { jsonKey: exportJsonKeyChosen } : {},
+            ...min != null ? { min } : {},
+            ...max != null ? { max } : {},
+            ...description ? { description } : {}
           });
         }
         return tags2;
       }
       if (Array.isArray(tag.chain) && tag.chain.length > 0) {
         const chainTags = [];
-        for (const [_tagKey, chainTag] of tag.chain.entries()) {
-          chainTags.push(...processTagEntries(chainTag, []));
+        const childPathStack = [...pathStack, `tags.${tag.key}`];
+        for (const [, chainTag] of tag.chain.entries()) {
+          chainTags.push(...processTagEntries(chainTag, childPathStack));
         }
         chain = chainTags;
       }
+      const hasExport = Object.prototype.hasOwnProperty.call(tag, "exportJsonKey");
+      let exportJsonKeyField;
+      if (hasExport) {
+        exportJsonKeyField = { jsonKey: tag.exportJsonKey };
+      } else if (legacyIsTrivialDefault(tag)) {
+        exportJsonKeyField = {};
+      } else {
+        const headingPath = [...pathStack, `tags.${tag.key}`].join(" / ");
+        exportJsonKeyErrors.push(
+          `Missing exportJsonKey for non-default jsonKey at ${headingPath}` + (tag.jsonKey ? ` (legacy: \`${tag.jsonKey}\`)` : ` (symbol-mapped tag \`${tag.key}\`)`)
+        );
+        exportJsonKeyField = {};
+      }
       const t = {
         type: "tag",
         key: tagName,
-        jsonKey,
+        ...exportJsonKeyField,
         format,
         default: tag.defaultValue ?? null,
         ...tag.nullable ? { nullable: true } : {},
@@ -40030,19 +40709,30 @@ var ConfigBuilder = class {
         max: tag.maxCount == null ? 1 : tag.maxCount,
         description: tag.description ?? "",
         tags: chain
-        // raw: {
-        //   ...tag,
-        // },
       };
       tags2.push(t);
       return tags2;
     };
+    const cardJsonKeyField = (container, legacyKey, exportKey, pathHeading) => {
+      const c = container;
+      const hasExport = Object.prototype.hasOwnProperty.call(c, exportKey);
+      if (hasExport) return { jsonKey: c[exportKey] };
+      const legacy = c[legacyKey];
+      if (legacy == null) return {};
+      exportJsonKeyErrors.push(
+        `Missing exportJsonKey for non-default jsonKey at ${pathHeading} (legacy: \`${legacy}\`)`
+      );
+      return {};
+    };
     const serializeCardSet = (cardSetKey) => {
+      const variantBodyFormat = (variant) => variant.format ?? TextFormat.bitmarkText;
       const cardSetConfig = CARDSETS[cardSetKey];
       if (!cardSetConfig) return void 0;
       const normalizedKey = normalizeCardKey(cardSetKey);
-      const sides = cardSetConfig.sides.map((side) => {
-        const variants = side.variants.map((variant) => {
+      const sides = cardSetConfig.sides.map((side, sideIdx) => {
+        const sidePath = `cardSets.${normalizedKey} / sides.${side.name ?? `[${sideIdx}]`}`;
+        const variants = side.variants.map((variant, variantIdx) => {
+          const variantPath = `${sidePath} / variants.[${variantIdx}]`;
           const variantTags = [];
           const variantTagEntries = Object.entries(variant.tags ?? []).sort((a, b) => {
             const tagA = a[1];
@@ -40053,10 +40743,11 @@ var ConfigBuilder = class {
             return typeOrder;
           });
           for (const [, variantTag] of variantTagEntries) {
-            variantTags.push(...processTagEntries(variantTag, []));
+            variantTags.push(...processTagEntries(variantTag, [variantPath]));
           }
           return {
-            ...variant.jsonKey !== void 0 ? { jsonKey: variant.jsonKey } : {},
+            ...cardJsonKeyField(variant, "jsonKey", "exportJsonKey", variantPath),
+            format: variantBodyFormat(variant),
             tags: variantTags,
             repeatCount: variant.repeatCount ?? 1,
             ...variant.bodyRequired ? { bodyRequired: true } : {},
@@ -40066,41 +40757,41 @@ var ConfigBuilder = class {
         return {
           name: side.name,
           ...side.repeat ? { repeat: side.repeat } : {},
-          ...side.jsonKey != null ? { jsonKey: side.jsonKey } : {},
+          ...cardJsonKeyField(side, "jsonKey", "exportJsonKey", sidePath),
           variants
         };
       });
       if (cardSetConfig.sections) {
         const cards = Object.entries(cardSetConfig.sections).map(([sectionName, section]) => {
-          let cardSides = section.sideJsonKey ? sides.map((s) => ({ ...s, jsonKey: section.sideJsonKey })) : sides;
-          if (normalizedKey === "table-extended" && sectionName !== "table-header") {
-            cardSides = JSON.parse(JSON.stringify(cardSides));
-            for (const side of cardSides) {
-              for (const variant of side.variants) {
-                for (const tag of variant.tags) {
-                  if (tag.type === "tag" && tag.key === "#" && tag.jsonKey === ".") {
-                    tag.jsonKey = "^table.header.rows.cells[{s}].content";
-                  }
-                }
-              }
-            }
+          const sectionPath = `cardSets.${normalizedKey} / cards.${sectionName}`;
+          const hasSideExport = Object.prototype.hasOwnProperty.call(section, "sideExportJsonKey");
+          let cardSides = sides;
+          if (hasSideExport || section.sideJsonKey != null) {
+            const sideOverride = cardJsonKeyField(
+              section,
+              "sideJsonKey",
+              "sideExportJsonKey",
+              `${sectionPath} / sides.*`
+            );
+            cardSides = sides.map((s) => ({ ...s, ...sideOverride }));
           }
           return {
             name: sectionName,
             ...section.isDefault ? { isDefault: true } : {},
-            jsonKey: section.jsonKey,
+            ...cardJsonKeyField(section, "jsonKey", "exportJsonKey", sectionPath),
             sides: cardSides
           };
         });
         return { name: normalizedKey, cards };
       }
+      const cardSetPath = `cardSets.${normalizedKey} / cards.default`;
       return {
         name: normalizedKey,
         cards: [
           {
             name: "default",
             isDefault: true,
-            jsonKey: cardSetConfig.jsonKey,
+            ...cardJsonKeyField(cardSetConfig, "jsonKey", "exportJsonKey", cardSetPath),
             sides
           }
         ]
@@ -40127,10 +40818,20 @@ var ConfigBuilder = class {
       if (allAreGroups && processedTags.length > 0) {
         const replacements = [];
         if (b.baseBitType) {
-          replacements.push(`group-${b.baseBitType}`);
+          replacements.push({ key: `group-${b.baseBitType}` });
         }
         for (const t of processedTags) {
-          replacements.push(t.key);
+          const ref = {
+            key: t.key,
+            ...t.min != null ? { min: t.min } : {},
+            ...t.max != null ? { max: t.max } : {},
+            ...t.description ? { description: t.description } : {}
+          };
+          if (Object.prototype.hasOwnProperty.call(t, "jsonKey")) {
+            ref.exportJsonKey = t.jsonKey;
+            ref.hasExportJsonKey = true;
+          }
+          replacements.push(ref);
         }
         squashedGroups.set(groupKey, replacements);
       }
@@ -40149,19 +40850,27 @@ var ConfigBuilder = class {
       const isInheritedFrom = bitGroupConfigKeys.has(b.bitType);
       if (isInheritedFrom) {
         const resolvedGroups = resolveGroupReferences(`group-${b.bitType}`);
-        for (const groupKey of resolvedGroups) {
+        for (const ref of resolvedGroups) {
           tags2.push({
             type: "group",
-            key: groupKey
+            key: ref.key,
+            ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+            ...ref.min != null ? { min: ref.min } : {},
+            ...ref.max != null ? { max: ref.max } : {},
+            ...ref.description ? { description: ref.description } : {}
           });
         }
       } else {
         if (b.baseBitType) {
           const resolvedGroups = resolveGroupReferences(`group-${b.baseBitType}`);
-          for (const groupKey of resolvedGroups) {
+          for (const ref of resolvedGroups) {
             tags2.push({
               type: "group",
-              key: groupKey
+              key: ref.key,
+              ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+              ...ref.min != null ? { min: ref.min } : {},
+              ...ref.max != null ? { max: ref.max } : {},
+              ...ref.description ? { description: ref.description } : {}
             });
           }
         }
@@ -40281,10 +40990,14 @@ var ConfigBuilder = class {
         const tags2 = [];
         if (b.baseBitType) {
           const resolvedGroups = resolveGroupReferences(`group-${b.baseBitType}`);
-          for (const gk of resolvedGroups) {
+          for (const ref of resolvedGroups) {
             tags2.push({
               type: "group",
-              key: gk
+              key: ref.key,
+              ...ref.hasExportJsonKey ? { jsonKey: ref.exportJsonKey } : {},
+              ...ref.min != null ? { min: ref.min } : {},
+              ...ref.max != null ? { max: ref.max } : {},
+              ...ref.description ? { description: ref.description } : {}
             });
           }
         }
@@ -40319,6 +41032,13 @@ var ConfigBuilder = class {
     };
     writeBitsAsGroupConfigs(bitGroupConfigs);
     writeCardConfigs();
+    if (exportJsonKeyErrors.length > 0) {
+      console.error("\n\u26A0\uFE0F  exportJsonKey validation errors:");
+      for (const e of exportJsonKeyErrors) console.error(`  - ${e}`);
+      throw new Error(
+        `exportJsonKey validation failed: ${exportJsonKeyErrors.length} entr${exportJsonKeyErrors.length === 1 ? "y" : "ies"} with non-default jsonKey but no exportJsonKey companion.`
+      );
+    }
     Promise.all(fileWrites).then(() => {
       const validationErrors = this.validateConfigTree(outputFolder);
       if (validationErrors.length > 0) {