@gmb/bitmark-parser-generator 1.0.16 → 1.1.0

package/dist/cjs/generator/json/JsonGenerator.js

@@ -26,11 +26,13 @@ const NodeType_1 = require("../../model/ast/NodeType");
 const BitType_1 = require("../../model/enum/BitType");
 const BitmarkVersion_1 = require("../../model/enum/BitmarkVersion");
 const BodyBitType_1 = require("../../model/enum/BodyBitType");
+const ExampleType_1 = require("../../model/enum/ExampleType");
 const PropertyKey_1 = require("../../model/enum/PropertyKey");
 const ResourceType_1 = require("../../model/enum/ResourceType");
 const TextFormat_1 = require("../../model/enum/TextFormat");
 const TextParser_1 = require("../../parser/text/TextParser");
 const ArrayUtils_1 = require("../../utils/ArrayUtils");
+const BooleanUtils_1 = require("../../utils/BooleanUtils");
 const StringUtils_1 = require("../../utils/StringUtils");
 const UrlUtils_1 = require("../../utils/UrlUtils");
 const DEFAULT_OPTIONS = {
@@ -190,6 +192,7 @@ class JsonGenerator {
     // bitmarkAst -> bits
     // bitmarkAst -> bits -> bitsValue
     enter_bitsValue(node, _parent, _route) {
+        var _a, _b, _c;
         const bit = node.value;
         // Reset
         this.bitWrapperJson = {
@@ -198,6 +201,39 @@ class JsonGenerator {
         this.json.push(this.bitWrapperJson);
         this.bitJson = this.createBitJson(bit);
         this.bitWrapperJson.bit = this.bitJson;
+        // Handle example at the root level - this is bit dependent; configuration is in the bit metadata
+        // There is same logic here to select the correct default value of the example is the default is
+        // required, and this is bit depenedent.
+        // This is ugly, but it is even uglier if the defaults at set in the AST.
+        const meta = BitType_1.BitType.getMetadata(bit.bitType);
+        const hasRootExample = !!(meta === null || meta === void 0 ? void 0 : meta.rootExampleType);
+        const isBoolean = (meta === null || meta === void 0 ? void 0 : meta.rootExampleType) === ExampleType_1.ExampleType.boolean;
+        if (hasRootExample) {
+            // Calculate the value of the default example
+            let defaultExample;
+            if (isBoolean) {
+                // Boolean example
+                defaultExample = true;
+                if (bit.bitType === BitType_1.BitType.trueFalse1) {
+                    if (((_b = (_a = bit.cardNode) === null || _a === void 0 ? void 0 : _a.statement) === null || _b === void 0 ? void 0 : _b.isCorrect) !== undefined) {
+                        defaultExample = bit.cardNode.statement.isCorrect;
+                    }
+                }
+            }
+            else {
+                // String example
+                defaultExample = (_c = ArrayUtils_1.ArrayUtils.asSingle(bit.sampleSolution)) !== null && _c !== void 0 ? _c : '';
+            }
+            const exampleRes = this.toExample(bit, {
+                defaultExample,
+                isBoolean,
+            });
+            this.bitJson.isExample = exampleRes.isExample;
+            this.bitJson.example = exampleRes.example;
+        }
+        else if (bit.isExample) {
+            this.bitJson.isExample = true;
+        }
     }
     exit_bitsValue(_node, _parent, _route) {
         // Clean up the bit JSON, removing any unwanted values
@@ -363,8 +399,8 @@ class JsonGenerator {
     enter_statement(node, parent, _route) {
         var _a, _b;
         const statement = node.value;
-        // Ignore statement that is not at the bit level as it is handled elsewhere
-        if ((parent === null || parent === void 0 ? void 0 : parent.key) !== NodeType_1.NodeType.bitsValue)
+        // Ignore statement that is not at the cardNode level as it is handled elsewhere
+        if ((parent === null || parent === void 0 ? void 0 : parent.key) !== NodeType_1.NodeType.cardNode)
             return;
         if (statement) {
             this.bitJson.statement = (_a = statement.text) !== null && _a !== void 0 ? _a : '';
@@ -373,7 +409,7 @@ class JsonGenerator {
     }
     // bitmarkAst -> bits -> bitsValue -> cardNode -> statements -> statementsValue
     enter_statements(node, parent, _route) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c;
         const statements = node.value;
         // Ignore statements that are not at the card node level as they are handled elsewhere
         if ((parent === null || parent === void 0 ? void 0 : parent.key) !== NodeType_1.NodeType.cardNode)
@@ -382,18 +418,19 @@ class JsonGenerator {
         if (statements) {
             for (const s of statements) {
                 // Create the statement
-                const statementJson = Object.assign(Object.assign({ statement: (_a = s.text) !== null && _a !== void 0 ? _a : '', isCorrect: (_b = s.isCorrect) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(s)), this.toExampleAndIsExample(s.example));
+                const statementJson = Object.assign(Object.assign({ statement: (_a = s.text) !== null && _a !== void 0 ? _a : '', isCorrect: !!s.isCorrect }, this.toItemLeadHintInstruction(s)), this.toExample(s, {
+                    defaultExample: !!s.isCorrect,
+                    isBoolean: true,
+                }));
                 // Delete unwanted properties
-                if (((_c = s.itemLead) === null || _c === void 0 ? void 0 : _c.item) == null)
+                if (((_b = s.itemLead) === null || _b === void 0 ? void 0 : _b.item) == null)
                     delete statementJson.item;
-                if (((_d = s.itemLead) === null || _d === void 0 ? void 0 : _d.lead) == null)
+                if (((_c = s.itemLead) === null || _c === void 0 ? void 0 : _c.lead) == null)
                     delete statementJson.lead;
                 if ((s === null || s === void 0 ? void 0 : s.hint) == null)
                     delete statementJson.hint;
                 if ((s === null || s === void 0 ? void 0 : s.instruction) == null)
                     delete statementJson.instruction;
-                if ((s === null || s === void 0 ? void 0 : s.example) == null)
-                    delete statementJson.example;
                 statementsJson.push(statementJson);
             }
         }
@@ -407,13 +444,16 @@ class JsonGenerator {
         var _a, _b, _c;
         const choices = node.value;
         // Ignore choices that are not at the bit level as they are handled elsewhere as quizzes
-        if ((parent === null || parent === void 0 ? void 0 : parent.key) !== NodeType_1.NodeType.bitsValue)
+        if ((parent === null || parent === void 0 ? void 0 : parent.key) !== NodeType_1.NodeType.cardNode)
             return;
         const choicesJson = [];
         if (choices) {
             for (const c of choices) {
                 // Create the choice
-                const choiceJson = Object.assign({ choice: (_a = c.text) !== null && _a !== void 0 ? _a : '', isCorrect: (_b = c.isCorrect) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(c));
+                const choiceJson = Object.assign(Object.assign({ choice: (_a = c.text) !== null && _a !== void 0 ? _a : '', isCorrect: (_b = c.isCorrect) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(c)), this.toExample(c, {
+                    defaultExample: !!c.isCorrect,
+                    isBoolean: true,
+                }));
                 // Delete unwanted properties
                 if (((_c = c.itemLead) === null || _c === void 0 ? void 0 : _c.lead) == null)
                     delete choiceJson.lead;
@@ -429,14 +469,17 @@ class JsonGenerator {
     enter_responses(node, parent, _route) {
         var _a, _b, _c;
         const responses = node.value;
-        // Ignore responses that are not at the bit level as they are handled elsewhere as quizzes
-        if ((parent === null || parent === void 0 ? void 0 : parent.key) !== NodeType_1.NodeType.bitsValue)
+        // Ignore responses that are not at the correct level as they are handled elsewhere as quizzes
+        if ((parent === null || parent === void 0 ? void 0 : parent.key) !== NodeType_1.NodeType.cardNode)
             return;
         const responsesJson = [];
         if (responses) {
             for (const r of responses) {
                 // Create the response
-                const responseJson = Object.assign({ response: (_a = r.text) !== null && _a !== void 0 ? _a : '', isCorrect: (_b = r.isCorrect) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(r));
+                const responseJson = Object.assign(Object.assign({ response: (_a = r.text) !== null && _a !== void 0 ? _a : '', isCorrect: (_b = r.isCorrect) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(r)), this.toExample(r, {
+                    defaultExample: !!r.isCorrect,
+                    isBoolean: true,
+                }));
                 // Delete unwanted properties
                 if (((_c = r.itemLead) === null || _c === void 0 ? void 0 : _c.lead) == null)
                     delete responseJson.lead;
@@ -449,7 +492,7 @@ class JsonGenerator {
     }
     // bitmarkAst -> bits -> bitsValue -> cardNode -> quizzes
     enter_quizzes(node, _parent, _route) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         const quizzes = node.value;
         const quizzesJson = [];
         if (quizzes) {
@@ -459,7 +502,10 @@ class JsonGenerator {
                 if (q.choices) {
                     for (const c of q.choices) {
                         // Create the choice
-                        const choiceJson = Object.assign({ choice: (_a = c.text) !== null && _a !== void 0 ? _a : '', isCorrect: (_b = c.isCorrect) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(c));
+                        const choiceJson = Object.assign(Object.assign({ choice: (_a = c.text) !== null && _a !== void 0 ? _a : '', isCorrect: (_b = c.isCorrect) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(c)), this.toExample(c, {
+                            defaultExample: !!c.isCorrect,
+                            isBoolean: true,
+                        }));
                         // Delete unwanted properties
                         if (((_c = q.itemLead) === null || _c === void 0 ? void 0 : _c.lead) == null)
                             delete choiceJson.lead;
@@ -469,9 +515,12 @@ class JsonGenerator {
                 // Responses
                 const responsesJson = [];
                 if (q.responses) {
-                    for (const c of q.responses) {
+                    for (const r of q.responses) {
                         // Create the choice
-                        const responseJson = Object.assign({ response: (_d = c.text) !== null && _d !== void 0 ? _d : '', isCorrect: (_e = c.isCorrect) !== null && _e !== void 0 ? _e : false }, this.toItemLeadHintInstruction(c));
+                        const responseJson = Object.assign(Object.assign({ response: (_d = r.text) !== null && _d !== void 0 ? _d : '', isCorrect: (_e = r.isCorrect) !== null && _e !== void 0 ? _e : false }, this.toItemLeadHintInstruction(r)), this.toExample(r, {
+                            defaultExample: !!r.isCorrect,
+                            isBoolean: true,
+                        }));
                         // Delete unwanted properties
                         if (((_f = q.itemLead) === null || _f === void 0 ? void 0 : _f.lead) == null)
                             delete responseJson.lead;
@@ -479,9 +528,9 @@ class JsonGenerator {
                     }
                 }
                 // Create the quiz
-                const quizJson = Object.assign(Object.assign(Object.assign({}, this.toItemLeadHintInstruction(q)), this.toExampleAndIsExample(q.example)), { choices: q.choices ? choicesJson : undefined, responses: q.responses ? responsesJson : undefined });
+                const quizJson = Object.assign(Object.assign({}, this.toItemLeadHintInstruction(q)), { isExample: (_g = q.isExample) !== null && _g !== void 0 ? _g : false, choices: q.choices ? choicesJson : undefined, responses: q.responses ? responsesJson : undefined });
                 // Delete unwanted properties
-                if (((_g = q.itemLead) === null || _g === void 0 ? void 0 : _g.lead) == null)
+                if (((_h = q.itemLead) === null || _h === void 0 ? void 0 : _h.lead) == null)
                     delete quizJson.lead;
                 quizzesJson.push(quizJson);
             }
@@ -530,7 +579,10 @@ class JsonGenerator {
         if (pairs) {
             for (const p of pairs) {
                 // Create the question
-                const pairJson = Object.assign(Object.assign(Object.assign({ key: (_a = p.key) !== null && _a !== void 0 ? _a : '', keyAudio: p.keyAudio ? this.addAudioResource(p.keyAudio) : undefined, keyImage: p.keyImage ? this.addImageResource(p.keyImage) : undefined, values: (_b = p.values) !== null && _b !== void 0 ? _b : [] }, this.toItemLeadHintInstruction(p)), this.toExampleAndIsExample(p.example)), { isCaseSensitive: (_c = p.isCaseSensitive) !== null && _c !== void 0 ? _c : true, isLongAnswer: (_d = !p.isShortAnswer) !== null && _d !== void 0 ? _d : false });
+                const pairJson = Object.assign(Object.assign(Object.assign({ key: (_a = p.key) !== null && _a !== void 0 ? _a : '', keyAudio: p.keyAudio ? this.addAudioResource(p.keyAudio) : undefined, keyImage: p.keyImage ? this.addImageResource(p.keyImage) : undefined, values: (_b = p.values) !== null && _b !== void 0 ? _b : [] }, this.toItemLeadHintInstruction(p)), { isCaseSensitive: (_c = p.isCaseSensitive) !== null && _c !== void 0 ? _c : true, isLongAnswer: (_d = !p.isShortAnswer) !== null && _d !== void 0 ? _d : false }), this.toExample(p, {
+                    defaultExample: true,
+                    isBoolean: true,
+                }));
                 // Delete unwanted properties
                 if (((_e = p.itemLead) === null || _e === void 0 ? void 0 : _e.lead) == null)
                     delete pairJson.lead;
@@ -555,7 +607,7 @@ class JsonGenerator {
     }
     // bitmarkAst -> bits -> bitsValue -> cardNode -> matrix
     enter_matrix(node, _parent, _route) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g;
         const matrix = node.value;
         const matrixJsonArray = [];
         if (matrix) {
@@ -565,23 +617,24 @@ class JsonGenerator {
                 if (m.cells) {
                     for (const c of m.cells) {
                         // Create the choice
-                        const matrixCellJson = Object.assign(Object.assign({ values: (_a = c.values) !== null && _a !== void 0 ? _a : [] }, this.toItemLeadHintInstruction(c)), this.toExampleAndIsExample(c.example));
+                        const matrixCellJson = Object.assign(Object.assign({ values: (_a = c.values) !== null && _a !== void 0 ? _a : [] }, this.toItemLeadHintInstruction(c)), this.toExample(c, {
+                            defaultExample: true,
+                            isBoolean: true,
+                        }));
                         // Delete unwanted properties
                         if (((_b = c.itemLead) === null || _b === void 0 ? void 0 : _b.lead) == null)
                             delete matrixCellJson.lead;
                         if (c.hint == null)
                             delete matrixCellJson.hint;
-                        if (c.example == null)
-                            delete matrixCellJson.isExample;
-                        if (c.example == null)
-                            delete matrixCellJson.example;
                         matrixCellsJson.push(matrixCellJson);
                     }
                 }
                 // Create the matrix
-                const matrixJson = Object.assign(Object.assign(Object.assign({ key: (_c = m.key) !== null && _c !== void 0 ? _c : '', cells: matrixCellsJson !== null && matrixCellsJson !== void 0 ? matrixCellsJson : [] }, this.toItemLeadHintInstruction(m)), this.toExampleAndIsExample(m.example)), { isCaseSensitive: (_d = m.isCaseSensitive) !== null && _d !== void 0 ? _d : true, isLongAnswer: (_e = !m.isShortAnswer) !== null && _e !== void 0 ? _e : false });
+                const matrixJson = Object.assign(Object.assign({ key: (_c = m.key) !== null && _c !== void 0 ? _c : '', cells: matrixCellsJson !== null && matrixCellsJson !== void 0 ? matrixCellsJson : [] }, this.toItemLeadHintInstruction(m)), { 
+                    // ...this.toExample(m.example, m.isExample),
+                    isCaseSensitive: (_d = m.isCaseSensitive) !== null && _d !== void 0 ? _d : true, isLongAnswer: (_e = !m.isShortAnswer) !== null && _e !== void 0 ? _e : false, isExample: (_f = m.isExample) !== null && _f !== void 0 ? _f : false });
                 // Delete unwanted properties
-                if (((_f = m.itemLead) === null || _f === void 0 ? void 0 : _f.lead) == null)
+                if (((_g = m.itemLead) === null || _g === void 0 ? void 0 : _g.lead) == null)
                     delete matrixJson.lead;
                 if (m.instruction == null)
                     delete matrixJson.instruction;
@@ -600,9 +653,12 @@ class JsonGenerator {
         if (questions) {
             for (const q of questions) {
                 // Create the question
-                const questionJson = Object.assign(Object.assign(Object.assign({ question: (_a = q.question) !== null && _a !== void 0 ? _a : '', partialAnswer: (_b = ArrayUtils_1.ArrayUtils.asSingle(q.partialAnswer)) !== null && _b !== void 0 ? _b : '', sampleSolution: (_c = q.sampleSolution) !== null && _c !== void 0 ? _c : '' }, this.toItemLeadHintInstruction(q)), this.toExampleAndIsExample(q.example)), { 
+                const questionJson = Object.assign(Object.assign(Object.assign({ question: (_a = q.question) !== null && _a !== void 0 ? _a : '', partialAnswer: (_b = ArrayUtils_1.ArrayUtils.asSingle(q.partialAnswer)) !== null && _b !== void 0 ? _b : '', sampleSolution: (_c = q.sampleSolution) !== null && _c !== void 0 ? _c : '' }, this.toItemLeadHintInstruction(q)), { 
                     // isCaseSensitive: q.isCaseSensitive ?? true,
-                    isShortAnswer: (_d = q.isShortAnswer) !== null && _d !== void 0 ? _d : true });
+                    isShortAnswer: (_d = q.isShortAnswer) !== null && _d !== void 0 ? _d : true }), this.toExample(q, {
+                    defaultExample: q.sampleSolution || '',
+                    isBoolean: false,
+                }));
                 // Delete unwanted properties
                 if (((_e = q.itemLead) === null || _e === void 0 ? void 0 : _e.lead) == null)
                     delete questionJson.lead;
@@ -698,16 +754,6 @@ class JsonGenerator {
             return;
         this.bitJson.instruction = this.toTextAstOrString(instruction);
     }
-    // bitmarkAst -> bits -> bitsValue -> example
-    leaf_example(node, parent, _route) {
-        const example = node.value;
-        // Ignore example that is not at the bit level as it are handled elsewhere
-        if ((parent === null || parent === void 0 ? void 0 : parent.key) !== NodeType_1.NodeType.bitsValue)
-            return;
-        const res = this.toExampleAndIsExample(example);
-        this.bitJson.isExample = res.isExample;
-        this.bitJson.example = res.example;
-    }
     // bitmarkAst -> bits -> footer -> footerText
     leaf_footerText(node, _parent, _route) {
         const footer = node.value;
@@ -813,20 +859,27 @@ class JsonGenerator {
     createGapJson(gap) {
         var _a;
         const data = gap.data;
+        const defaultExample = data.solutions && data.solutions.length > 0 ? data.solutions[0] : '';
         // Create the gap
-        const gapJson = Object.assign(Object.assign(Object.assign({ type: 'gap', solutions: data.solutions }, this.toItemLeadHintInstruction(data)), this.toExampleAndIsExample(data.example)), { isCaseSensitive: (_a = data.isCaseSensitive) !== null && _a !== void 0 ? _a : true });
+        const gapJson = Object.assign(Object.assign(Object.assign(Object.assign({ type: 'gap' }, this.toItemLeadHintInstruction(data)), { isCaseSensitive: (_a = data.isCaseSensitive) !== null && _a !== void 0 ? _a : true }), this.toExample(data, {
+            defaultExample,
+            isBoolean: false,
+        })), { solutions: data.solutions });
         // Remove unwanted properties
         if (!gapJson.lead)
             delete gapJson.lead;
         return gapJson;
     }
     createSelectJson(select) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         const data = select.data;
         // Create the select options
         const options = [];
         for (const option of data.options) {
-            const optionJson = Object.assign(Object.assign({ text: option.text, isCorrect: (_a = option.isCorrect) !== null && _a !== void 0 ? _a : false }, this.toItemLeadHintInstruction(option)), this.toExampleAndIsExample(option.example));
+            const optionJson = Object.assign(Object.assign({ text: option.text, isCorrect: (_a = option.isCorrect) !== null && _a !== void 0 ? _a : false }, this.toItemLeadHintInstruction(option)), this.toExample(option, {
+                defaultExample: !!option.isCorrect,
+                isBoolean: true,
+            }));
             // Remove unwanted properties
             if (!optionJson.item)
                 delete optionJson.item;
@@ -834,28 +887,27 @@ class JsonGenerator {
                 delete optionJson.lead;
             if (!optionJson.instruction)
                 delete optionJson.instruction;
-            if (!optionJson.example)
-                delete optionJson.example;
-            if (!optionJson.isExample)
-                delete optionJson.isExample;
             if (!optionJson.isCaseSensitive)
                 delete optionJson.isCaseSensitive;
             options.push(optionJson);
         }
         // Create the select
-        const selectJson = Object.assign(Object.assign({ type: 'select', prefix: (_b = data.prefix) !== null && _b !== void 0 ? _b : '', options, postfix: (_c = data.postfix) !== null && _c !== void 0 ? _c : '' }, this.toItemLeadHintInstruction(data)), this.toExampleAndIsExample(data.example));
+        const selectJson = Object.assign(Object.assign({ type: 'select', prefix: (_b = data.prefix) !== null && _b !== void 0 ? _b : '', postfix: (_c = data.postfix) !== null && _c !== void 0 ? _c : '' }, this.toItemLeadHintInstruction(data)), { isExample: (_d = data.isExample) !== null && _d !== void 0 ? _d : false, options });
         // Remove unwanted properties
         if (!selectJson.lead)
             delete selectJson.lead;
         return selectJson;
     }
     createHighlightJson(highlight) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         const data = highlight.data;
         // Create the highlight options
         const texts = [];
         for (const text of data.texts) {
-            const textJson = Object.assign(Object.assign({ text: text.text, isCorrect: (_a = text.isCorrect) !== null && _a !== void 0 ? _a : false, isHighlighted: (_b = text.isHighlighted) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(text)), this.toExampleAndIsExample(text.example));
+            const textJson = Object.assign(Object.assign({ text: text.text, isCorrect: (_a = text.isCorrect) !== null && _a !== void 0 ? _a : false, isHighlighted: (_b = text.isHighlighted) !== null && _b !== void 0 ? _b : false }, this.toItemLeadHintInstruction(text)), this.toExample(text, {
+                defaultExample: !!text.isCorrect,
+                isBoolean: true,
+            }));
             // Remove unwanted properties
             if (!textJson.item)
                 delete textJson.item;
@@ -863,16 +915,12 @@ class JsonGenerator {
                 delete textJson.lead;
             if (!textJson.hint)
                 delete textJson.hint;
-            if (!textJson.example)
-                delete textJson.example;
-            if (!textJson.isExample)
-                delete textJson.isExample;
             if (!textJson.isCaseSensitive)
                 delete textJson.isCaseSensitive;
             texts.push(textJson);
         }
         // Create the select
-        const highlightJson = Object.assign(Object.assign({ type: 'highlight', prefix: (_c = data.prefix) !== null && _c !== void 0 ? _c : '', texts, postfix: (_d = data.postfix) !== null && _d !== void 0 ? _d : '' }, this.toItemLeadHintInstruction(data)), this.toExampleAndIsExample(data.example));
+        const highlightJson = Object.assign(Object.assign({ type: 'highlight', prefix: (_c = data.prefix) !== null && _c !== void 0 ? _c : '', postfix: (_d = data.postfix) !== null && _d !== void 0 ? _d : '' }, this.toItemLeadHintInstruction(data)), { isExample: (_e = data.isExample) !== null && _e !== void 0 ? _e : false, texts });
         // Remove unwanted properties
         if (!highlightJson.lead)
             delete highlightJson.lead;
@@ -1410,19 +1458,27 @@ class JsonGenerator {
             instruction: this.toTextAstOrString((_f = item.instruction) !== null && _f !== void 0 ? _f : ''),
         };
     }
-    toExampleAndIsExample(exampleIn) {
-        let isExample = false;
-        let example = this.textDefault;
-        if (exampleIn === true) {
-            isExample = true;
+    toExample(node, options) {
+        const { isExample, example, isDefaultExample } = node;
+        const { defaultExample, isBoolean } = options;
+        if (!isExample) {
+            return {
+                isExample: false,
+                example: null,
+            };
+        }
+        let exampleValue;
+        if (isDefaultExample) {
+            exampleValue = isBoolean
+                ? BooleanUtils_1.BooleanUtils.toBoolean(defaultExample)
+                : this.toTextAstOrString(defaultExample);
         }
-        else if (exampleIn) {
-            isExample = true;
-            example = this.toTextAstOrString(exampleIn);
+        else {
+            exampleValue = isBoolean ? BooleanUtils_1.BooleanUtils.toBoolean(example) : this.toTextAstOrString(example);
         }
         return {
-            isExample,
-            example,
+            isExample: true,
+            example: exampleValue,
         };
     }
     addProperty(
@@ -1608,8 +1664,8 @@ class JsonGenerator {
             hint: undefined,
             instruction: undefined,
             // Example
-            example: undefined,
             isExample: undefined,
+            example: undefined,
             // Partner .conversion-xxx only
             partner: undefined,
             // Extra Properties
@@ -1668,7 +1724,6 @@ class JsonGenerator {
             case BitType_1.BitType._error:
                 break;
             case BitType_1.BitType.article:
-            case BitType_1.BitType.highlightText:
             case BitType_1.BitType.message:
             case BitType_1.BitType.sampleSolution:
             case BitType_1.BitType.page:
@@ -1684,12 +1739,19 @@ class JsonGenerator {
                 if (bitJson.isExample == null)
                     bitJson.isExample = false;
                 if (bitJson.example == null)
-                    bitJson.example = this.textDefault;
+                    bitJson.example = null;
                 if (bitJson.body == null)
                     bitJson.body = this.bodyDefault;
                 break;
+            // Default, but with no 'example' at the bit level.
+            case BitType_1.BitType.cloze:
+            case BitType_1.BitType.clozeInstructionGrouped:
+            case BitType_1.BitType.clozeSolutionGrouped:
             case BitType_1.BitType.multipleChoice1:
             case BitType_1.BitType.multipleResponse1:
+            case BitType_1.BitType.multipleChoiceText:
+            case BitType_1.BitType.highlightText:
+            case BitType_1.BitType.clozeAndMultipleChoiceText:
             case BitType_1.BitType.sequence:
                 if (bitJson.item == null)
                     bitJson.item = this.textDefault;
@@ -1699,11 +1761,25 @@ class JsonGenerator {
                     bitJson.instruction = this.textDefault;
                 if (bitJson.isExample == null)
                     bitJson.isExample = false;
-                if (bitJson.example == null)
-                    bitJson.example = this.textDefault;
                 if (bitJson.body == null)
                     bitJson.body = this.bodyDefault;
                 break;
+            // Default with a card (and hence a footer possibility)
+            case BitType_1.BitType.multipleChoice:
+            case BitType_1.BitType.multipleResponse:
+                if (bitJson.item == null)
+                    bitJson.item = this.textDefault;
+                if (bitJson.hint == null)
+                    bitJson.hint = this.textDefault;
+                if (bitJson.instruction == null)
+                    bitJson.instruction = this.textDefault;
+                if (bitJson.isExample == null)
+                    bitJson.isExample = false;
+                if (bitJson.body == null)
+                    bitJson.body = this.bodyDefault;
+                if (bitJson.footer == null)
+                    bitJson.footer = this.textDefault;
+                break;
             case BitType_1.BitType.essay:
                 if (bitJson.item == null)
                     bitJson.item = this.textDefault;
@@ -1714,7 +1790,7 @@ class JsonGenerator {
                 if (bitJson.isExample == null)
                     bitJson.isExample = false;
                 if (bitJson.example == null)
-                    bitJson.example = this.textDefault;
+                    bitJson.example = null;
                 if (bitJson.body == null)
                     bitJson.body = this.bodyDefault;
                 if (bitJson.partialAnswer == null)
@@ -1732,6 +1808,8 @@ class JsonGenerator {
                     bitJson.instruction = this.textDefault;
                 if (bitJson.isExample == null)
                     bitJson.isExample = false;
+                if (bitJson.example == null)
+                    bitJson.example = null;
                 if (bitJson.isCorrect == null)
                     bitJson.isCorrect = false;
                 if (bitJson.body == null)
@@ -1746,6 +1824,8 @@ class JsonGenerator {
                     bitJson.hint = this.textDefault;
                 if (bitJson.instruction == null)
                     bitJson.instruction = this.textDefault;
+                if (bitJson.isExample == null)
+                    bitJson.isExample = false;
                 if (bitJson.labelFalse == null)
                     bitJson.labelFalse = '';
                 if (bitJson.labelTrue == null)
@@ -1761,7 +1841,7 @@ class JsonGenerator {
                 if (bitJson.isExample == null)
                     bitJson.isExample = false;
                 if (bitJson.example == null)
-                    bitJson.example = this.textDefault;
+                    bitJson.example = null;
                 if (bitJson.toc == null)
                     bitJson.toc = true; // Always set on chapter bits?
                 if (bitJson.progress == null)
@@ -1771,19 +1851,6 @@ class JsonGenerator {
                 if (bitJson.body == null)
                     bitJson.body = this.bodyDefault;
                 break;
-            case BitType_1.BitType.multipleChoice:
-            case BitType_1.BitType.multipleResponse:
-                if (bitJson.item == null)
-                    bitJson.item = this.textDefault;
-                if (bitJson.hint == null)
-                    bitJson.hint = this.textDefault;
-                if (bitJson.instruction == null)
-                    bitJson.instruction = this.textDefault;
-                if (bitJson.body == null)
-                    bitJson.body = this.bodyDefault;
-                if (bitJson.footer == null)
-                    bitJson.footer = this.textDefault;
-                break;
             case BitType_1.BitType.interview:
             case BitType_1.BitType.interviewInstructionGrouped:
                 if (bitJson.item == null)
@@ -1792,6 +1859,8 @@ class JsonGenerator {
                     bitJson.hint = this.textDefault;
                 if (bitJson.instruction == null)
                     bitJson.instruction = this.textDefault;
+                if (bitJson.isExample == null)
+                    bitJson.isExample = false;
                 if (bitJson.body == null)
                     bitJson.body = this.bodyDefault;
                 if (bitJson.footer == null)
@@ -1836,7 +1905,7 @@ class JsonGenerator {
                 if (bitJson.isExample == null)
                     bitJson.isExample = false;
                 if (bitJson.example == null)
-                    bitJson.example = this.textDefault;
+                    bitJson.example = null;
                 if (bitJson.isTracked == null)
                     bitJson.isTracked = true;
                 if (bitJson.isInfoOnly == null)
@@ -1856,7 +1925,7 @@ class JsonGenerator {
                 if (bitJson.isExample == null)
                     bitJson.isExample = false;
                 if (bitJson.example == null)
-                    bitJson.example = this.textDefault;
+                    bitJson.example = null;
                 if (bitJson.body == null)
                     bitJson.body = this.bodyDefault;
                 break;
@@ -1958,7 +2027,7 @@ class JsonGenerator {
         if (bitJson.instruction == null)
             delete bitJson.instruction;
         // Example
-        if (bitJson.example == null)
+        if (bitJson.example === undefined)
             delete bitJson.example;
         if (bitJson.isExample == null)
             delete bitJson.isExample;