@c2-markdown-ui/mdui-lang 0.0.0-stage → 0.4.4

package/dist/serialize.d.ts

@@ -0,0 +1,7 @@
+/** 把 widget 对象转回 DSL 字符串 */
+export declare function serializeDSL(widget: any): string;
+/** 序列化单个字段：带 span/when 时附加尾部修饰符（类似 antd Col）。
+ *  多行字段（如 chart）时修饰符追加到首行尾部，保证 when/span 仍能被行尾正则提取。
+ *  多条件（when 数组）输出多个 when 修饰符（AND 语义）；单条件保持单个 when。
+ *  分组形态（FieldWhenGroup）输出 when:（all 且组）与 when-any:（any 或组）修饰符 */
+export declare function serializeFieldWithSpan(f: any): string;

package/dist/serialize.js

@@ -0,0 +1,633 @@
+/** 把 widget 对象转回 DSL 字符串 */
+export function serializeDSL(widget) {
+    if (!widget || !widget.type)
+        return '';
+    switch (widget.type) {
+        case 'text':
+            return serializeText(widget);
+        case 'text-input':
+            return serializeTextInput(widget);
+        case 'button-group':
+            return serializeButtonGroup(widget);
+        case 'button':
+            return serializeButton(widget);
+        case 'select':
+            return serializeSelect(widget);
+        case 'select-multi':
+            return serializeSelectMulti(widget);
+        case 'radio-group':
+            return serializeRadioGroup(widget);
+        case 'cascade':
+            return serializeCascade(widget);
+        case 'tree-select':
+            return serializeTreeSelect(widget);
+        case 'slider':
+            return serializeSlider(widget);
+        case 'switch':
+            return serializeSwitch(widget);
+        case 'date-picker':
+            return serializeDatePicker(widget);
+        case 'number-input':
+            return serializeNumberInput(widget);
+        case 'form':
+            return serializeForm(widget);
+        case 'row':
+            return serializeRow(widget);
+        case 'chart-line':
+        case 'chart-bar':
+        case 'chart-pie':
+        case 'chart-scatter':
+            return serializeChart(widget);
+        case 'multiple-choice-question':
+            return serializeMCQ(widget);
+        case 'short-answer-question':
+            return serializeSAQ(widget);
+        case 'quiz':
+            return serializeQuiz(widget);
+        case 'incomplete':
+            return serializeIncomplete(widget);
+        default:
+            return '';
+    }
+}
+function quote(s) {
+    if (!s)
+        return '""';
+    if (s.includes(' ') || s.includes('"') || s.includes("'") || s.includes('\n')) {
+        return `"${s.replace(/"/g, '\\"')}"`;
+    }
+    return s;
+}
+/** 对象树 JSON 串原样回填：单行紧凑输出（无外层引号、不 escape，
+ *  经 tokenize 的 scanDataArray 引号感知扫描后可无损往返为单 token） */
+function jsonArg(v) {
+    return JSON.stringify(v);
+}
+function arr(items) {
+    if (!items || items.length === 0)
+        return '[]';
+    return `[${items.map(i => quote(String(i))).join(' ')}]`;
+}
+function serializeText(w) {
+    const parts = ['text', w.id || 'id', quote(w.text || '')];
+    if (w.size)
+        parts.push(`size:${w.size}`);
+    if (w.color)
+        parts.push(`color:${w.color}`);
+    if (w.bold)
+        parts.push('bold');
+    if (w.align)
+        parts.push(`align:${w.align}`);
+    if (w.alert) {
+        parts.push('alert');
+        // 默认 info 不序列化（省略），warning/error 显式写出
+        if (w.alertStyle && w.alertStyle !== 'info')
+            parts.push(`alertStyle:${w.alertStyle}`);
+    }
+    return parts.join(' ');
+}
+function serializeTextInput(w) {
+    const parts = ['text-input', w.id || 'id'];
+    // label/placeholder/default 是位置参数：后位存在时前位必须占位（空串 ""），避免错位
+    const hasPlaceholder = !!w.placeholder;
+    const hasDefault = w.default !== undefined && w.default !== null && w.default !== '';
+    if (w.label || hasPlaceholder || hasDefault)
+        parts.push(w.label ? quote(w.label) : '""');
+    if (hasPlaceholder || hasDefault)
+        parts.push(w.placeholder ? quote(w.placeholder) : '""');
+    if (hasDefault)
+        parts.push(quote(w.default));
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    if (w.pattern)
+        parts.push(`pattern:${quote(w.pattern)}`);
+    if (w.message)
+        parts.push(`message:${quote(w.message)}`);
+    return parts.join(' ');
+}
+function serializeButtonGroup(w) {
+    const parts = ['button-group', w.id || 'id', arr(w.choices)];
+    if (w.default)
+        parts.push(quote(w.default));
+    if (w.label)
+        parts.push(`label:${quote(w.label)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    return parts.join(' ');
+}
+function serializeButton(w) {
+    const parts = ['button', w.id || 'id'];
+    if (w.label)
+        parts.push(quote(w.label));
+    if (w.color)
+        parts.push(`color:${w.color}`);
+    if (w.textColor)
+        parts.push(`textColor:${w.textColor}`);
+    if (w.size)
+        parts.push(`size:${w.size}`);
+    if (w.disabled)
+        parts.push('disabled');
+    return parts.join(' ');
+}
+function serializeSelect(w) {
+    const parts = ['select', w.id || 'id', arr(w.choices)];
+    if (w.default)
+        parts.push(quote(w.default));
+    if (w.label)
+        parts.push(`label:${quote(w.label)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    // 空串 url 也要写回（url:"" 表示远端模式但路径待填），否则 round-trip 后远端状态丢失
+    if (w.url !== undefined && w.url !== null)
+        parts.push(`url:${quote(w.url)}`);
+    if (w.searchable)
+        parts.push('searchable');
+    return parts.join(' ');
+}
+function serializeSelectMulti(w) {
+    // choices 为对象数组（[{value|key,label} ...]）时输出单行紧凑 JSON：
+    // tokenize 的数组模式引号/嵌套感知可整体接收，parser 的 parseObjectChoices 特判识别，保证 round-trip
+    const isObjectChoices = Array.isArray(w.choices) && w.choices.length > 0
+        && w.choices.every((c) => c && typeof c === 'object');
+    const parts = ['select-multi', w.id || 'id', isObjectChoices ? jsonArg(w.choices) : arr(w.choices)];
+    if (w.default !== undefined && w.default !== null) {
+        const d = Array.isArray(w.default) ? w.default : [w.default];
+        parts.push(arr(d));
+    }
+    if (w.label)
+        parts.push(`label:${quote(w.label)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    // 选项布局：columns 自定义列数优先；direction 仅写回 horizontal（vertical 为默认，省略保持 DSL 简洁）
+    if (w.columns)
+        parts.push(`columns:${w.columns}`);
+    else if (w.direction === 'horizontal')
+        parts.push('direction:horizontal');
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    if (w.message)
+        parts.push(`message:${quote(w.message)}`);
+    // 空串 url 也要写回（url:"" 表示远端模式但路径待填），否则 round-trip 后远端状态丢失
+    if (w.url !== undefined && w.url !== null)
+        parts.push(`url:${quote(w.url)}`);
+    return parts.join(' ');
+}
+function serializeRadioGroup(w) {
+    // choices 为对象数组时输出单行紧凑 JSON（与 select-multi 一致，保证 round-trip）
+    const isObjectChoices = Array.isArray(w.choices) && w.choices.length > 0
+        && w.choices.every((c) => c && typeof c === 'object');
+    const parts = ['radio-group', w.id || 'id', isObjectChoices ? jsonArg(w.choices) : arr(w.choices)];
+    if (w.default !== undefined && w.default !== null)
+        parts.push(quote(w.default));
+    if (w.label)
+        parts.push(`label:${quote(w.label)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    // 按钮样式标记（antd optionType:button）
+    if (w.button)
+        parts.push('button');
+    // 选项布局：columns 自定义列数优先；direction 仅写回 horizontal（vertical 为默认，省略）
+    if (w.columns)
+        parts.push(`columns:${w.columns}`);
+    else if (w.direction === 'horizontal')
+        parts.push('direction:horizontal');
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    if (w.message)
+        parts.push(`message:${quote(w.message)}`);
+    // 空串 url 也要写回（url:"" 表示远端模式但路径待填），否则 round-trip 后远端状态丢失
+    if (w.url !== undefined && w.url !== null)
+        parts.push(`url:${quote(w.url)}`);
+    return parts.join(' ');
+}
+function serializeCascade(w) {
+    const parts = ['cascade', w.id || 'id', arr(w.choices)];
+    if (w.default)
+        parts.push(quote(w.default));
+    // 嵌套对象树数据源（单行 JSON 串，可往返解析）；空数组也写回（保住编辑器"数据树"模式）
+    if (w.data !== undefined && w.data !== null)
+        parts.push(`data:${jsonArg(w.data)}`);
+    // 空串 url 也要写回（url:"" 表示远端模式但路径待填），否则 round-trip 后远端状态丢失
+    if (w.url !== undefined && w.url !== null)
+        parts.push(`url:${quote(w.url)}`);
+    // 懒加载模式（url 存在时生效）：首次只拉根级，点击父级后 url?parent=<value> 逐级请求子级
+    if (w.lazy)
+        parts.push('lazy');
+    if (w.label)
+        parts.push(`label:${quote(w.label)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    if (w.placeholder)
+        parts.push(`placeholder:${quote(w.placeholder)}`);
+    if (w.message)
+        parts.push(`message:${quote(w.message)}`);
+    return parts.join(' ');
+}
+function serializeTreeSelect(w) {
+    const parts = ['tree-select', w.id || 'id', arr(w.choices)];
+    // default：多选为数组，单选为单值（位置参数）
+    if (w.default !== undefined && w.default !== null && (!Array.isArray(w.default) || w.default.length > 0)) {
+        parts.push(Array.isArray(w.default) ? arr(w.default) : quote(w.default));
+    }
+    // 嵌套对象树数据源（单行 JSON 串，可往返解析）；空数组也写回（保住编辑器"数据树"模式）
+    if (w.data !== undefined && w.data !== null)
+        parts.push(`data:${jsonArg(w.data)}`);
+    // 空串 url 也要写回（url:"" 表示远端模式但路径待填）
+    if (w.url !== undefined && w.url !== null)
+        parts.push(`url:${quote(w.url)}`);
+    if (w.lazy)
+        parts.push('lazy');
+    if (w.multiple)
+        parts.push('multiple');
+    if (w.checkStrictly)
+        parts.push('checkStrictly');
+    if (w.showCheckedStrategy)
+        parts.push(`strategy:${w.showCheckedStrategy}`);
+    if (w.maxTagCount !== undefined && w.maxTagCount !== null)
+        parts.push(`maxTagCount:${w.maxTagCount}`);
+    if (w.treeLine)
+        parts.push('treeLine');
+    if (w.searchable)
+        parts.push('searchable');
+    if (w.label)
+        parts.push(`label:${quote(w.label)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    if (w.placeholder)
+        parts.push(`placeholder:${quote(w.placeholder)}`);
+    if (w.message)
+        parts.push(`message:${quote(w.message)}`);
+    return parts.join(' ');
+}
+function serializeSlider(w) {
+    const parts = ['slider', w.id || 'id', String(w.min ?? 0), String(w.max ?? 100), String(w.step ?? 1)];
+    if (w.default !== undefined)
+        parts.push(String(w.default));
+    if (w.label)
+        parts.push(`label:${quote(w.label)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    return parts.join(' ');
+}
+function serializeSwitch(w) {
+    const parts = ['switch', w.id || 'id'];
+    if (w.default !== undefined)
+        parts.push(w.default ? 'true' : 'false');
+    if (w.label)
+        parts.push(`label:${quote(w.label)}`);
+    if (w.checkedText)
+        parts.push(`checkedText:${quote(w.checkedText)}`);
+    if (w.unCheckedText)
+        parts.push(`unCheckedText:${quote(w.unCheckedText)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    return parts.join(' ');
+}
+function serializeDatePicker(w) {
+    const parts = ['date-picker', w.id || 'id'];
+    // label 作为位置参数（与 parser 约定一致：date-picker id "标签" ...）
+    if (w.label)
+        parts.push(quote(w.label));
+    // default：时间戳（数字）或格式化字符串；range 模式为 [start end] 数组
+    if (w.default !== undefined && w.default !== null && (!Array.isArray(w.default) || w.default.length > 0)) {
+        if (Array.isArray(w.default)) {
+            parts.push(arr(w.default));
+        }
+        else if (typeof w.default === 'number') {
+            parts.push(String(w.default));
+        }
+        else {
+            parts.push(quote(w.default));
+        }
+    }
+    if (w.picker && w.picker !== 'date')
+        parts.push(`picker:${w.picker}`);
+    if (w.range)
+        parts.push('range');
+    if (w.format)
+        parts.push(`format:${quote(w.format)}`);
+    if (w.disableBeforeNow)
+        parts.push('disableBeforeNow');
+    if (w.disableAfterNow)
+        parts.push('disableAfterNow');
+    if (w.placeholder)
+        parts.push(`placeholder:${quote(w.placeholder)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    if (w.message)
+        parts.push(`message:${quote(w.message)}`);
+    return parts.join(' ');
+}
+function serializeNumberInput(w) {
+    const parts = ['number-input', w.id || 'id'];
+    // label/default 是位置参数：default 存在时 label 必须占位（与 parser 约定一致）
+    const hasDefault = w.default !== undefined && w.default !== null;
+    if (w.label || hasDefault)
+        parts.push(w.label ? quote(w.label) : '""');
+    if (hasDefault)
+        parts.push(String(w.default));
+    if (w.min !== undefined)
+        parts.push(`min:${w.min}`);
+    if (w.max !== undefined)
+        parts.push(`max:${w.max}`);
+    if (w.step !== undefined)
+        parts.push(`step:${w.step}`);
+    if (w.precision !== undefined)
+        parts.push(`precision:${w.precision}`);
+    if (w.placeholder)
+        parts.push(`placeholder:${quote(w.placeholder)}`);
+    if (w.hint)
+        parts.push(`hint:${quote(w.hint)}`);
+    if (w.required)
+        parts.push('required');
+    if (w.disabled)
+        parts.push('disabled');
+    if (w.message)
+        parts.push(`message:${quote(w.message)}`);
+    return parts.join(' ');
+}
+/** when 条件值段序列化：op 为数值/时间戳比较时加运算符前缀（when:field:>18），eq 无前缀 */
+function whenOpPrefix(op) {
+    if (op === 'gt')
+        return '>';
+    if (op === 'gte')
+        return '>=';
+    if (op === 'lt')
+        return '<';
+    if (op === 'lte')
+        return '<=';
+    if (op === 'ne')
+        return '!=';
+    return '';
+}
+/** 序列化单个字段：带 span/when 时附加尾部修饰符（类似 antd Col）。
+ *  多行字段（如 chart）时修饰符追加到首行尾部，保证 when/span 仍能被行尾正则提取。
+ *  多条件（when 数组）输出多个 when 修饰符（AND 语义）；单条件保持单个 when。
+ *  分组形态（FieldWhenGroup）输出 when:（all 且组）与 when-any:（any 或组）修饰符 */
+export function serializeFieldWithSpan(f) {
+    const base = serializeDSL(f);
+    if (!base)
+        return '';
+    let suffix = '';
+    if (f.span)
+        suffix += ` span:${f.span}`;
+    const when = f.when;
+    if (when && typeof when === 'object' && !Array.isArray(when) && ('all' in when || 'any' in when)) {
+        // 分组形态：且组（when:）在前，或组（when-any:）在后
+        for (const w of when.all || []) {
+            if (w?.field && Array.isArray(w.values) && w.values.length > 0) {
+                suffix += ` when:${w.field}:${whenOpPrefix(w.op)}${w.values.join(',')}`;
+            }
+        }
+        for (const w of when.any || []) {
+            if (w?.field && Array.isArray(w.values) && w.values.length > 0) {
+                suffix += ` when-any:${w.field}:${whenOpPrefix(w.op)}${w.values.join(',')}`;
+            }
+        }
+    }
+    else {
+        const whenList = Array.isArray(when) ? when : (when ? [when] : []);
+        for (const w of whenList) {
+            if (w?.field && Array.isArray(w.values) && w.values.length > 0) {
+                suffix += ` when:${w.field}:${whenOpPrefix(w.op)}${w.values.join(',')}`;
+            }
+        }
+    }
+    if (!suffix)
+        return base;
+    const baseLines = base.split('\n');
+    baseLines[0] = baseLines[0] + suffix;
+    return baseLines.join('\n');
+}
+function serializeForm(w) {
+    const lines = [];
+    const first = ['form', w.id || 'id'];
+    if (w.submitLabel)
+        first.push(quote(w.submitLabel));
+    if (w.inline)
+        first.push('inline');
+    if (w.columns)
+        first.push(`columns:${w.columns}`);
+    if (w.cancelLabel)
+        first.push(`cancel:${w.cancelLabel.includes(' ') ? quote(w.cancelLabel) : w.cancelLabel}`);
+    if (w.resetLabel)
+        first.push(`reset:${w.resetLabel.includes(' ') ? quote(w.resetLabel) : w.resetLabel}`);
+    if (w.buttonsAlign)
+        first.push(`align:${w.buttonsAlign}`);
+    if (w.layout)
+        first.push(`layout:${w.layout}`);
+    if (w.labelWidth)
+        first.push(`labelWidth:${w.labelWidth}`);
+    if (w.contentWidth)
+        first.push(`contentWidth:${w.contentWidth}`);
+    if (w.disabled)
+        first.push('disabled');
+    lines.push(first.join(' '));
+    /** 字段 DSL 逐行加缩进：单行字段用浅缩进；多行字段（如 chart）首行用浅缩进、
+     *  其余行用深缩进（多 2 空格），保证 round-trip 时块内行仍归属该字段 */
+    const pushField = (fieldDsl, indent) => {
+        if (!fieldDsl)
+            return;
+        const ls = fieldDsl.split('\n');
+        for (let k = 0; k < ls.length; k++) {
+            const l = ls[k];
+            if (!l) {
+                lines.push(l);
+                continue;
+            }
+            lines.push(k === 0 ? indent + l : indent + '  ' + l);
+        }
+    };
+    if (w.rows && w.rows.length > 0) {
+        for (const row of w.rows) {
+            // 兼容旧数组形态的 row（纯字段数组）与新对象形态（{ gutter, fields }）
+            const fields = Array.isArray(row) ? row : (row.fields || []);
+            const gutter = Array.isArray(row) ? undefined : row.gutter;
+            lines.push(gutter !== undefined && gutter !== null ? `  row gutter:${gutter}` : '  row');
+            for (const f of fields) {
+                pushField(serializeFieldWithSpan(f), '    ');
+            }
+        }
+    }
+    else if (w.fields && w.fields.length > 0) {
+        for (const f of w.fields) {
+            pushField(serializeFieldWithSpan(f), '  ');
+        }
+    }
+    return lines.join('\n');
+}
+/** 序列化独立栅格组件 row */
+function serializeRow(w) {
+    const lines = [];
+    const first = ['row'];
+    if (w.id)
+        first.push(w.id);
+    if (w.gutter !== undefined && w.gutter !== null)
+        first.push(`gutter:${w.gutter}`);
+    if (w.justify)
+        first.push(`justify:${w.justify}`);
+    if (w.align)
+        first.push(`align:${w.align}`);
+    lines.push(first.join(' '));
+    for (const c of (w.cols || [])) {
+        const parts = ['col'];
+        if (c.span)
+            parts.push(`span:${c.span}`);
+        if (c.offset)
+            parts.push(`offset:${c.offset}`);
+        if (c.align)
+            parts.push(`align:${c.align}`);
+        lines.push('  ' + parts.join(' '));
+        if (c.widget) {
+            const sub = serializeDSL(c.widget);
+            if (sub) {
+                for (const l of sub.split('\n')) {
+                    lines.push('    ' + l);
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function serializeChart(w) {
+    const lines = [w.type];
+    if (w.id)
+        lines.push(`id: ${w.id}`);
+    if (w.title)
+        lines.push(`title: ${w.title}`);
+    if (w.height)
+        lines.push(`height: ${w.height}`);
+    // url 为空串也回写（编辑器"远端数据源"二态切换依赖空串占位）
+    if (w.url !== undefined && w.url !== null)
+        lines.push(`url: ${w.url}`);
+    if (w.legend !== undefined && w.legend !== null)
+        lines.push(`legend: ${w.legend ? 'true' : 'false'}`);
+    const ds = w.datasets || [];
+    const labels = w.labels || [];
+    // 有 url 且无本地数据时不输出空 CSV（数据由远端拉取）
+    if (w.url && labels.length === 0) {
+        return lines.join('\n');
+    }
+    // CSV header
+    const headerCols = [];
+    // 尝试推断第一列名称：如果 labels 都是数字就用 X，否则用 Category
+    const allNumeric = labels.length > 0 && labels.every((l) => !isNaN(parseFloat(l)));
+    headerCols.push(allNumeric ? 'X' : 'Category');
+    for (const d of ds)
+        headerCols.push(d.label || 'Series');
+    lines.push(headerCols.join(','));
+    // CSV data rows
+    const rowCount = labels.length;
+    for (let i = 0; i < rowCount; i++) {
+        const row = [String(labels[i])];
+        for (const d of ds) {
+            const data = d.data || [];
+            row.push(String(data[i] ?? 0));
+        }
+        lines.push(row.join(','));
+    }
+    return lines.join('\n');
+}
+function serializeMCQ(w) {
+    const parts = ['multiple-choice-question', w.id || 'id', quote(w.question || ''), arr(w.choices)];
+    if (w.correctAnswer)
+        parts.push(quote(w.correctAnswer));
+    if (w.showFeedback)
+        parts.push('showFeedback');
+    if (w.disabled)
+        parts.push('disabled');
+    return parts.join(' ');
+}
+function serializeSAQ(w) {
+    const parts = ['short-answer-question', w.id || 'id', quote(w.question || '')];
+    if (w.placeholder)
+        parts.push(quote(w.placeholder));
+    if (w.correctAnswers && w.correctAnswers.length > 0) {
+        parts.push(arr(w.correctAnswers));
+    }
+    else if (w.correctAnswer) {
+        parts.push(quote(w.correctAnswer));
+    }
+    if (w.showFeedback)
+        parts.push('showFeedback');
+    if (w.disabled)
+        parts.push('disabled');
+    return parts.join(' ');
+}
+function serializeQuiz(w) {
+    // 首行 join 成单行（quiz id "title"），配置行与题目行依次追加
+    const first = ['quiz', w.id || 'id', quote(w.title || '')].join(' ');
+    const lines = [first];
+    if (w.showScore !== undefined)
+        lines.push(`showScore: ${String(w.showScore)}`);
+    if (w.showProgress !== undefined)
+        lines.push(`showProgress: ${String(w.showProgress)}`);
+    if (w.passingScore !== undefined)
+        lines.push(`passingScore: ${w.passingScore}`);
+    if (w.disabled)
+        lines.push('disabled: true');
+    for (const q of (w.questions || [])) {
+        if (q.type === 'mcq') {
+            const mcq = [
+                'mcq', q.id, quote(q.question),
+                String(q.points ?? 0), arr(q.choices || [])
+            ];
+            if (q.correctAnswer)
+                mcq.push(quote(q.correctAnswer));
+            lines.push(mcq.join(' '));
+        }
+        else if (q.type === 'short-answer') {
+            const sa = ['short-answer', q.id, quote(q.question), String(q.points ?? 0)];
+            if (q.placeholder)
+                sa.push(quote(q.placeholder));
+            if (q.correctAnswers && q.correctAnswers.length > 0) {
+                sa.push(arr(q.correctAnswers));
+            }
+            else if (q.correctAnswer) {
+                sa.push(quote(q.correctAnswer));
+            }
+            lines.push(sa.join(' '));
+        }
+    }
+    return lines.join('\n');
+}
+function serializeIncomplete(w) {
+    const parts = ['incomplete', w.id || 'id', quote(w.text || w.sentence || ''), quote(w.answer || '')];
+    return parts.join(' ');
+}