@case-framework/survey-core 0.2.0 → 0.4.0

package/build/index.mjs

@@ -1,7 +1,6 @@
-import { A as ValueReference, C as ContextVariableType, D as FunctionExpressionNames, E as FunctionExpression, F as structuredCloneMethod, M as generateCodingKey, N as generateId, O as ResponseVariableExpression, P as shuffleIndices, S as ContextVariableExpression, T as ExpressionType, _ as deserializeTemplateValue, a as createFullRegistry, b as serializeTemplateValues, c as toItemTypeDefinitionRegistry, d as builtInItemCoreRegistry, f as isBuiltInItemType, g as TemplateDefTypes, h as SurveyItemCore, i as validateLocale, j as ValueReferenceMethod, k as ReferenceUsageType, l as GroupItemCore, m as ReservedSurveyItemTypes, n as SurveyItemTranslations, o as createItemCore, p as SurveyItemKey, r as SurveyTranslations, s as createItemTypeDefinitionRegistry, t as Survey, u as PageBreakItemCore, v as deserializeTemplateValues, w as Expression, x as ConstExpression, y as serializeTemplateValue } from "./survey-DQmpzihl.mjs";
+import { $ as generateId, A as DurationUnits, B as ConstExpression, C as ReservedSurveyItemTypes, D as deserializeSurveyItemPrefill, E as SurveyItemPrefillTargetType, F as TemplateDefTypes, G as FunctionExpression, H as ContextVariableType, I as deserializeTemplateValue, J as ReferenceUsageType, K as FunctionExpressionNames, L as deserializeTemplateValues, M as ValueType, N as assertResponseValue, O as prefillTargetsEqual, P as isResponseValue, Q as generateCodingKey, R as serializeTemplateValue, S as SurveyItemKey, T as SurveyItemPrefillApplyMode, U as Expression, V as ContextVariableExpression, W as ExpressionType, X as ValueReferenceMethod, Y as ValueReference, Z as createSeededRandom, _ as toItemTypeDefinitionRegistry, a as getContentPlainText, b as builtInItemCoreRegistry, c as hasRenderableRichTextContent, d as SurveyTranslations, et as shuffleArray, f as validateLocale, g as createItemTypeDefinitionRegistry, h as createItemCore, i as getAssetUsagesFromContent, j as NumberPrecision, k as serializeSurveyItemPrefill, l as isContentEmpty, m as createFullRegistry, n as ContentType, nt as structuredCloneMethod, o as getPlainTextFromRichTextContent, p as CURRENT_SURVEY_SCHEMA, q as ResponseVariableExpression, r as createRichTextContent, s as hasRenderableRichTextBlock, t as Survey, tt as shuffleIndices, u as SurveyItemTranslations, v as GroupItemCore, w as SurveyItemCore, x as isBuiltInItemType, y as PageBreakItemCore, z as serializeTemplateValues } from "./survey-yXdl8xkf.mjs";
 import { format } from "date-fns";
 import { enUS } from "date-fns/locale";
-
 //#region src/to_mirgrate/data_types/legacy-types.ts
 const isLegacyItemGroupComponent = (item) => {
 	const items = item.items;
@@ -11,7 +10,6 @@ const isLegacySurveyGroupItem = (item) => {
 	const items = item.items;
 	return items !== void 0 && items.length > 0;
 };
-
 //#endregion
 //#region src/survey/responses/item-response.ts
 /**
@@ -36,6 +34,9 @@ var SurveyItemResponse = class SurveyItemResponse {
 		};
 	}
 	static deserialize(json) {
+		if (!json || typeof json !== "object" || Array.isArray(json)) throw new Error("Invalid survey item response payload");
+		if (typeof json.itemId !== "string" || json.itemId.trim().length === 0) throw new Error("Survey item response is missing a valid itemId");
+		if (typeof json.itemType !== "string" || json.itemType.trim().length === 0) throw new Error("Survey item response is missing a valid itemType");
 		const newResponse = new SurveyItemResponse({
 			itemId: json.itemId,
 			itemType: json.itemType
@@ -57,16 +58,26 @@ var ResponseItem = class ResponseItem {
 		else this._slots.delete(slotId);
 	}
 	serialize() {
-		return { slotValues: Array.from(this._slots.entries()) };
+		if (this._slots.size === 0) return;
+		return { slots: Object.fromEntries(this._slots.entries()) };
+	}
+	isEmpty() {
+		return this._slots.size === 0;
 	}
 	clone() {
 		return new ResponseItem(Array.from(this._slots.entries()));
 	}
 	static deserialize(json) {
-		return new ResponseItem(json.slotValues);
+		if (!json || typeof json !== "object" || Array.isArray(json)) throw new Error("Invalid response item payload");
+		const { slots } = json;
+		if (!slots || typeof slots !== "object" || Array.isArray(slots)) throw new Error("Invalid response slots payload");
+		return new ResponseItem(Object.entries(slots).map(([slotId, slotResponse]) => {
+			if (slotId.trim().length === 0) throw new Error("Response slot id cannot be empty");
+			assertResponseValue(slotResponse, `response.slots.${slotId}`);
+			return [slotId, slotResponse];
+		}));
 	}
 };
-
 //#endregion
 //#region src/survey/responses/response-meta.ts
 const SurveyEventTypes = {
@@ -75,9 +86,9 @@ const SurveyEventTypes = {
 	responeChanged: "responeChanged",
 	languageChanged: "languageChanged"
 };
-
 //#endregion
 //#region src/survey/responses/survey-response.ts
+const SURVEY_RESPONSE_SCHEMA_VERSION = 1;
 /**
 * SurveyResponse to store the responses of a survey.
 */
@@ -98,58 +109,49 @@ var SurveyResponse = class SurveyResponse {
 		this.events = [];
 	}
 	serialize() {
+		const items = Object.fromEntries(Array.from(this.responses.entries()).flatMap(([itemId, response]) => {
+			const serialized = response.serialize();
+			if (!serialized.response && !serialized.meta) return [];
+			return [[itemId, serialized]];
+		}));
 		return {
+			schemaVersion: 1,
 			key: this.key,
 			participantId: this.participantId,
 			submittedAt: this.submittedAt,
 			versionId: this.versionId,
-			responses: Array.from(this.responses.values()).map((r) => r.serialize()),
+			items,
 			events: this.events,
 			context: this.context
 		};
 	}
 	static deserialize(json) {
+		if (!json || typeof json !== "object" || Array.isArray(json)) throw new Error("Invalid survey response payload");
+		if (json.schemaVersion !== 1) throw new Error(`Unsupported survey response schema version: ${String(json.schemaVersion)}`);
+		if (typeof json.key !== "string" || json.key.trim().length === 0) throw new Error("Survey response is missing a valid key");
+		if (typeof json.versionId !== "string" || json.versionId.trim().length === 0) throw new Error("Survey response is missing a valid versionId");
+		if (!json.items || typeof json.items !== "object" || Array.isArray(json.items)) throw new Error("Survey response is missing a valid items object");
 		const response = new SurveyResponse(json.key, json.versionId);
 		response.participantId = json.participantId;
 		response.submittedAt = json.submittedAt;
-		response.responses = new Map(json.responses.map((r) => [r.itemId, SurveyItemResponse.deserialize(r)]));
+		response.responses = new Map(Object.entries(json.items).map(([itemId, itemResponse]) => {
+			const deserialized = SurveyItemResponse.deserialize(itemResponse);
+			if (deserialized.itemId !== itemId) throw new Error(`Survey response item key mismatch for '${itemId}'`);
+			return [itemId, deserialized];
+		}));
 		response.events = json.events ?? [];
 		response.versionId = json.versionId;
 		response.key = json.key;
-		response.context = json.context;
+		if (json.context) {
+			if (typeof json.context !== "object" || Array.isArray(json.context)) throw new Error("Survey response context must be an object");
+			response.context = Object.fromEntries(Object.entries(json.context).map(([contextKey, value]) => {
+				assertResponseValue(value, `context.${contextKey}`);
+				return [contextKey, value];
+			}));
+		}
 		return response;
 	}
 };
-
-//#endregion
-//#region src/survey/responses/value-types.ts
-const ValueType = {
-	string: "string",
-	duration: "duration",
-	reference: "reference",
-	number: "number",
-	boolean: "boolean",
-	date: "date",
-	stringArray: "string[]",
-	durationArray: "duration[]",
-	referenceArray: "reference[]",
-	numberArray: "number[]",
-	dateArray: "date[]"
-};
-const DurationUnits = {
-	seconds: "seconds",
-	minutes: "minutes",
-	hours: "hours",
-	days: "days",
-	weeks: "weeks",
-	months: "months",
-	years: "years"
-};
-const NumberPrecision = {
-	int: "int",
-	float: "float"
-};
-
 //#endregion
 //#region src/survey/responses/utils.ts
 const initValueForType = (returnType) => {
@@ -203,7 +205,6 @@ const initValueForType = (returnType) => {
 		default: throw new Error("Invalid return type: " + returnType);
 	}
 };
-
 //#endregion
 //#region src/expressions/expression-evaluator.ts
 var ExpressionEvaluator = class {
@@ -230,8 +231,8 @@ var ExpressionEvaluator = class {
 	evaluateResponseVariable(expression) {
 		const varRef = expression.responseVariableRef;
 		switch (varRef.name) {
-			case ValueReferenceMethod.get: return this.context?.responses[varRef.itemId]?.response?.get(varRef.slotId);
-			case ValueReferenceMethod.isDefined: return {
+			case "get": return this.context?.responses[varRef.itemId]?.response?.get(varRef.slotId);
+			case "isDefined": return {
 				type: ValueType.boolean,
 				value: this.context?.responses[varRef.itemId]?.response?.get(varRef.slotId) !== void 0
 			};
@@ -240,20 +241,20 @@ var ExpressionEvaluator = class {
 	}
 	evaluateFunction(expression) {
 		switch (expression.functionName) {
-			case FunctionExpressionNames.and: return this.evaluateAnd(expression);
-			case FunctionExpressionNames.or: return this.evaluateOr(expression);
-			case FunctionExpressionNames.not: return this.evaluateNot(expression);
-			case FunctionExpressionNames.str_eq: return this.evaluateStrEq(expression);
-			case FunctionExpressionNames.eq: return this.evaluateEq(expression);
-			case FunctionExpressionNames.gt: return this.evaluateGt(expression);
-			case FunctionExpressionNames.gte: return this.evaluateGte(expression);
-			case FunctionExpressionNames.lt: return this.evaluateLt(expression);
-			case FunctionExpressionNames.lte: return this.evaluateLte(expression);
-			case FunctionExpressionNames.in_range: return this.evaluateInRange(expression);
-			case FunctionExpressionNames.sum: return this.evaluateSum(expression);
-			case FunctionExpressionNames.min: return this.evaluateMin(expression);
-			case FunctionExpressionNames.max: return this.evaluateMax(expression);
-			case FunctionExpressionNames.list_contains: return this.evaluateListContains(expression);
+			case "and": return this.evaluateAnd(expression);
+			case "or": return this.evaluateOr(expression);
+			case "not": return this.evaluateNot(expression);
+			case "str_eq": return this.evaluateStrEq(expression);
+			case "eq": return this.evaluateEq(expression);
+			case "gt": return this.evaluateGt(expression);
+			case "gte": return this.evaluateGte(expression);
+			case "lt": return this.evaluateLt(expression);
+			case "lte": return this.evaluateLte(expression);
+			case "in_range": return this.evaluateInRange(expression);
+			case "sum": return this.evaluateSum(expression);
+			case "min": return this.evaluateMin(expression);
+			case "max": return this.evaluateMax(expression);
+			case "list_contains": return this.evaluateListContains(expression);
 			default: throw new Error(`Unsupported function: ${expression.functionName}`);
 		}
 	}
@@ -533,7 +534,16 @@ var ExpressionEvaluator = class {
 		});
 	}
 };
-
+//#endregion
+//#region src/expressions/item-expression-registry.ts
+function getItemExpressionDefinition(definitions, expressionId) {
+	return definitions?.find((definition) => definition.id === expressionId);
+}
+function buildItemExpression(item, definitions, expressionId, params) {
+	const definition = getItemExpressionDefinition(definitions, expressionId);
+	if (!definition) throw new Error(`Unknown item expression: ${expressionId}`);
+	return definition.buildExpression(item, params);
+}
 //#endregion
 //#region src/expressions/editors/expression-editor.ts
 var ExpressionEditor = class {
@@ -809,7 +819,7 @@ var AndExpressionEditor = class extends GroupExpressionEditor {
 		super(args, editorConfig);
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.and, this.args.map((arg) => arg.getExpression()), this._editorConfig);
+		return new FunctionExpression("and", this.args.map((arg) => arg.getExpression()), this._editorConfig);
 	}
 };
 var OrExpressionEditor = class extends GroupExpressionEditor {
@@ -819,7 +829,7 @@ var OrExpressionEditor = class extends GroupExpressionEditor {
 		super(args, editorConfig);
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.or, this.args.map((arg) => arg.getExpression()), this._editorConfig);
+		return new FunctionExpression("or", this.args.map((arg) => arg.getExpression()), this._editorConfig);
 	}
 };
 var StrListContainsExpressionEditor = class extends ExpressionEditor {
@@ -847,7 +857,7 @@ var StrListContainsExpressionEditor = class extends ExpressionEditor {
 		this._item = item;
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.list_contains, [this._list?.getExpression(), this._item?.getExpression()], this._editorConfig);
+		return new FunctionExpression("list_contains", [this._list?.getExpression(), this._item?.getExpression()], this._editorConfig);
 	}
 };
 var StrEqExpressionEditor = class extends ExpressionEditor {
@@ -873,7 +883,7 @@ var StrEqExpressionEditor = class extends ExpressionEditor {
 		this._b = b;
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.str_eq, [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
+		return new FunctionExpression("str_eq", [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
 	}
 };
 var EqExpressionEditor = class extends ExpressionEditor {
@@ -899,7 +909,7 @@ var EqExpressionEditor = class extends ExpressionEditor {
 		this._b = b;
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.eq, [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
+		return new FunctionExpression("eq", [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
 	}
 };
 var GtExpressionEditor = class extends ExpressionEditor {
@@ -925,7 +935,7 @@ var GtExpressionEditor = class extends ExpressionEditor {
 		this._b = b;
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.gt, [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
+		return new FunctionExpression("gt", [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
 	}
 };
 var GteExpressionEditor = class extends ExpressionEditor {
@@ -951,7 +961,7 @@ var GteExpressionEditor = class extends ExpressionEditor {
 		this._b = b;
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.gte, [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
+		return new FunctionExpression("gte", [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
 	}
 };
 var LtExpressionEditor = class extends ExpressionEditor {
@@ -977,7 +987,7 @@ var LtExpressionEditor = class extends ExpressionEditor {
 		this._b = b;
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.lt, [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
+		return new FunctionExpression("lt", [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
 	}
 };
 var LteExpressionEditor = class extends ExpressionEditor {
@@ -1003,7 +1013,7 @@ var LteExpressionEditor = class extends ExpressionEditor {
 		this._a = a;
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.lte, [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
+		return new FunctionExpression("lte", [this._a?.getExpression(), this._b?.getExpression()], this._editorConfig);
 	}
 };
 var InRangeExpressionEditor = class extends ExpressionEditor {
@@ -1021,7 +1031,7 @@ var InRangeExpressionEditor = class extends ExpressionEditor {
 		this._editorConfig = editorConfig;
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.in_range, [
+		return new FunctionExpression("in_range", [
 			this.value?.getExpression(),
 			this.min?.getExpression(),
 			this.max?.getExpression(),
@@ -1035,7 +1045,7 @@ var SumExpressionEditor = class extends GroupExpressionEditor {
 		super(args, editorConfig);
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.sum, this.args.map((arg) => arg.getExpression()), this._editorConfig);
+		return new FunctionExpression("sum", this.args.map((arg) => arg.getExpression()), this._editorConfig);
 	}
 };
 var MinExpressionEditor = class extends GroupExpressionEditor {
@@ -1044,7 +1054,7 @@ var MinExpressionEditor = class extends GroupExpressionEditor {
 		super(args, editorConfig);
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.min, this.args.map((arg) => arg.getExpression()), this._editorConfig);
+		return new FunctionExpression("min", this.args.map((arg) => arg.getExpression()), this._editorConfig);
 	}
 };
 var MaxExpressionEditor = class extends GroupExpressionEditor {
@@ -1053,10 +1063,9 @@ var MaxExpressionEditor = class extends GroupExpressionEditor {
 		super(args, editorConfig);
 	}
 	getExpression() {
-		return new FunctionExpression(FunctionExpressionNames.max, this.args.map((arg) => arg.getExpression()), this._editorConfig);
+		return new FunctionExpression("max", this.args.map((arg) => arg.getExpression()), this._editorConfig);
 	}
 };
-
 //#endregion
 //#region src/expressions/editors/expression-editor-generators.ts
 const const_string_array = (...values) => {
@@ -1161,20 +1170,6 @@ const min = (...args) => {
 const max = (...args) => {
 	return new MaxExpressionEditor(args);
 };
-
-//#endregion
-//#region src/survey/utils/content.ts
-let ContentType = /* @__PURE__ */ function(ContentType) {
-	ContentType["CQM"] = "CQM";
-	ContentType["md"] = "md";
-	return ContentType;
-}({});
-let AttributionType = /* @__PURE__ */ function(AttributionType) {
-	AttributionType["style"] = "style";
-	AttributionType["template"] = "template";
-	return AttributionType;
-}({});
-
 //#endregion
 //#region src/engine/engine.ts
 var SurveyEngineCore = class {
@@ -1182,14 +1177,17 @@ var SurveyEngineCore = class {
 	renderedSurveyTree;
 	context;
 	locale;
+	sessionSeedValue;
 	responses;
 	prefills;
 	_events;
 	_openedAt;
 	dateLocales;
+	prefillEnvironment;
 	cache;
-	constructor(survey, context, prefills, dateLocales) {
+	constructor(survey, context, prefills, dateLocales, options) {
 		this._openedAt = this._getTimestamp();
+		this.sessionSeedValue = generateId();
 		this.surveyDef = survey;
 		this.context = context ? context : { locale: "en" };
 		this.locale = this.context.locale;
@@ -1197,12 +1195,14 @@ var SurveyEngineCore = class {
 			acc[p.itemId] = SurveyItemResponse.deserialize(p);
 			return acc;
 		}, {}) : void 0;
+		this.prefillEnvironment = options?.prefillEnvironment;
 		this.dateLocales = dateLocales || [{
 			code: "en",
 			locale: enUS
 		}];
 		this.responses = this.initResponseObject(this.surveyDef.surveyItems);
 		this.initCache();
+		this.applyConfiguredPrefills();
 		this.evalExpressions();
 		if (!survey.rootItem) throw new Error("constructor: root item not found");
 		this.renderedSurveyTree = this.renderGroup(survey.rootItem);
@@ -1253,6 +1253,9 @@ var SurveyEngineCore = class {
 	get openedAt() {
 		return this._openedAt;
 	}
+	get sessionSeed() {
+		return this.sessionSeedValue;
+	}
 	get survey() {
 		return this.surveyDef;
 	}
@@ -1262,7 +1265,7 @@ var SurveyEngineCore = class {
 		if (!size) size = "large";
 		let currentPage = [];
 		renderedSurvey.forEach((item) => {
-			if (item.type === ReservedSurveyItemTypes.PageBreak) {
+			if (item.type === "page-break") {
 				if (currentPage.length > 0) {
 					pages.push([...currentPage]);
 					currentPage = [];
@@ -1302,12 +1305,17 @@ var SurveyEngineCore = class {
 		return this._events.slice();
 	}
 	getResponses() {
-		const renderedSurvey = flattenTree(this.renderedSurveyTree).filter((item) => item.type !== ReservedSurveyItemTypes.PageBreak);
+		const renderedPositions = /* @__PURE__ */ new Map();
+		flattenTree(this.renderedSurveyTree).filter((item) => item.type !== "page-break").forEach((item, index) => {
+			if (this.responses[item.id]) renderedPositions.set(item.id, index);
+		});
 		const responses = [];
-		renderedSurvey.forEach((item, index) => {
-			const response = this.getResponseItem(item.id);
+		this.surveyDef.surveyItems.forEach((item, itemId) => {
+			if (!item.isInteractive()) return;
+			const response = this.getResponseItem(itemId);
 			if (!response) return;
-			response.meta = { position: index };
+			const position = renderedPositions.get(itemId);
+			response.meta = position === void 0 ? void 0 : { position };
 			responses.push(response);
 		});
 		return responses;
@@ -1410,6 +1418,67 @@ var SurveyEngineCore = class {
 		});
 		return respGroup;
 	}
+	applyConfiguredPrefills() {
+		const evalEngine = new ExpressionEvaluator({
+			responses: this.responses,
+			surveyContext: this.context
+		});
+		const maxPasses = Math.max(this.surveyDef.surveyItems.size, 1);
+		for (let pass = 0; pass < maxPasses; pass++) {
+			this.evalTemplateValues(evalEngine);
+			let changedInPass = false;
+			this.surveyDef.surveyItems.forEach((item) => {
+				if (!item.isInteractive()) return;
+				changedInPass = this.applyConfiguredPrefillsForItem(item, evalEngine) || changedInPass;
+			});
+			if (!changedInPass) break;
+		}
+		this.evalTemplateValues(evalEngine);
+	}
+	applyConfiguredPrefillsForItem(item, evalEngine) {
+		const responseItem = this.responses[item.id];
+		if (!responseItem) return false;
+		let changed = false;
+		for (const prefill of item.prefills ?? []) {
+			const targetSlot = item.resolvePrefillTarget(prefill.target);
+			if (!targetSlot) continue;
+			if ((prefill.apply ?? SurveyItemPrefillApplyMode.ifEmpty) === SurveyItemPrefillApplyMode.ifEmpty && responseItem.response?.get(targetSlot.slotId) !== void 0) continue;
+			if (!this.shouldApplyConfiguredPrefill(prefill, evalEngine)) continue;
+			const resolvedValue = this.resolveConfiguredPrefillValue(prefill, targetSlot, evalEngine);
+			if (!resolvedValue) continue;
+			const normalizedValue = item.normalizePrefillValue(prefill, targetSlot, resolvedValue);
+			if (!normalizedValue) continue;
+			const nextResponse = responseItem.response?.clone() ?? new ResponseItem();
+			nextResponse.setSlotValue(targetSlot.slotId, normalizedValue);
+			responseItem.response = nextResponse.isEmpty() ? void 0 : nextResponse;
+			changed = true;
+		}
+		return changed;
+	}
+	shouldApplyConfiguredPrefill(prefill, evalEngine) {
+		if (!prefill.when) return true;
+		const resolved = evalEngine.eval(prefill.when);
+		return resolved?.type === ValueType.boolean && resolved.value === true;
+	}
+	resolveConfiguredPrefillValue(prefill, _target, evalEngine) {
+		switch (prefill.source.type) {
+			case "static": return prefill.source.value;
+			case "expression": return evalEngine.eval(prefill.source.expression);
+			case "templateValue": return this.getTemplateValue(prefill.source.key);
+			case "previousResponse": {
+				if (!this.prefillEnvironment?.getPreviousResponse) return;
+				const refTarget = prefill.source.ref.target ?? prefill.target;
+				const resolved = this.prefillEnvironment.getPreviousResponse({
+					surveyKey: prefill.source.ref.surveyKey,
+					itemId: prefill.source.ref.itemId,
+					target: refTarget
+				});
+				if (!resolved) return;
+				return resolved;
+			}
+			default: return;
+		}
+	}
 	shouldRender(itemId, componentId) {
 		const displayConditionResult = this.getDisplayConditionValue(itemId, componentId);
 		if (displayConditionResult !== void 0) return displayConditionResult;
@@ -1424,7 +1493,7 @@ var SurveyEngineCore = class {
 				console.warn("sequentialRender: item not found: " + itemId);
 				continue;
 			}
-			if (itemDef.type === ReservedSurveyItemTypes.Group) {
+			if (itemDef.type === "group") {
 				newItems.push(this.renderGroup(itemDef));
 				continue;
 			}
@@ -1435,7 +1504,7 @@ var SurveyEngineCore = class {
 		}
 		return {
 			id: groupDef.id,
-			type: ReservedSurveyItemTypes.Group,
+			type: "group",
 			items: newItems
 		};
 	}
@@ -1452,7 +1521,7 @@ var SurveyEngineCore = class {
 				console.warn("randomizedItemRender: item not found: " + itemId);
 				continue;
 			}
-			if (itemDef.type === ReservedSurveyItemTypes.Group) {
+			if (itemDef.type === "group") {
 				newItems.push(this.renderGroup(itemDef, parent));
 				continue;
 			}
@@ -1463,14 +1532,14 @@ var SurveyEngineCore = class {
 		}
 		return {
 			id: groupDef.id,
-			type: ReservedSurveyItemTypes.Group,
+			type: "group",
 			items: newItems
 		};
 	}
 	renderGroup(groupDef, parent) {
 		if (!parent) parent = {
 			id: groupDef.id,
-			type: ReservedSurveyItemTypes.Group,
+			type: "group",
 			items: []
 		};
 		if (groupDef.config.shuffleItems) return this.randomizedItemRender(groupDef, parent);
@@ -1502,6 +1571,7 @@ var SurveyEngineCore = class {
 	evalTemplateValues(evalEngine) {
 		Object.keys(this.cache.templateValues).forEach((templateValueKey) => {
 			const templateValue = this.cache.templateValues[templateValueKey];
+			this.cache.templateValues[templateValueKey].value = void 0;
 			if (!templateValue.templateDef?.expression) {
 				console.warn("evalTemplateValues: template value expression not found: " + templateValueKey);
 				return;
@@ -1512,7 +1582,7 @@ var SurveyEngineCore = class {
 				return;
 			}
 			switch (templateValue.templateDef.type) {
-				case TemplateDefTypes.Date2String:
+				case "date2string":
 					if (evaluatedValue.type !== ValueType.date) {
 						console.warn("evalTemplateValues: template value expression returned non-date value: " + templateValueKey);
 						return;
@@ -1578,12 +1648,11 @@ var SurveyEngineCore = class {
 const flattenTree = (itemTree) => {
 	const flatTree = new Array();
 	itemTree.items?.forEach((item) => {
-		if (item.type === ReservedSurveyItemTypes.Group) flatTree.push(...flattenTree(item));
+		if (item.type === "group") flatTree.push(...flattenTree(item));
 		else flatTree.push({ ...item });
 	});
 	return flatTree;
 };
-
 //#endregion
 //#region src/response-exporter/types.ts
 /** Meta column keys in fixed order (common attributes first). */
@@ -1599,13 +1668,14 @@ const SlotTransformMode = {
 	mask: "mask",
 	dateFormat: "dateFormat"
 };
+/** Separator between item key path and slot coding path in default export headers. */
+const EXPORT_COLUMN_SLOT_SEPARATOR = "__";
 /** Source of an export column. */
 const ExportColumnSource = {
 	meta: "meta",
 	context: "context",
 	response: "response"
 };
-
 //#endregion
 //#region src/response-exporter/slot-formatter.ts
 /** Default transform config when no profile override. */
@@ -1672,7 +1742,6 @@ function valueToString(value) {
 		default: return String(value.value ?? "");
 	}
 }
-
 //#endregion
 //#region src/response-exporter/csv-serializer.ts
 const DEFAULT_OPTIONS = {
@@ -1699,32 +1768,28 @@ function serializeToCsv(columns, rows, options) {
 	};
 	const sep = opts.separator;
 	const lines = [];
-	const keys = columns.map((c) => c.key);
-	if (opts.includeHeader) lines.push(keys.map((k) => escapeCsvCell(k, sep)).join(sep));
+	const headers = columns.map((c) => c.header);
+	if (opts.includeHeader) lines.push(headers.map((header) => escapeCsvCell(header, sep)).join(sep));
 	for (const row of rows) {
-		const cells = keys.map((k) => escapeCsvCell(row[k] ?? "", sep));
+		const cells = headers.map((header) => escapeCsvCell(row[header] ?? "", sep));
 		lines.push(cells.join(sep));
 	}
 	return lines.join(opts.lineEnding);
 }
-
 //#endregion
 //#region src/response-exporter/exporter.ts
-const VALUE_REF_SEP$1 = "...";
-function parseValueRef(ref) {
-	const parts = ref.split(VALUE_REF_SEP$1);
-	if (parts.length !== 3 || parts[1] !== ValueReferenceMethod.get) return {
-		itemId: "",
-		slotId: ""
-	};
-	return {
-		itemId: parts[0],
-		slotId: parts[2]
-	};
-}
 function slotOverrideKey(itemId, slotId) {
 	return `${itemId}::${slotId}`;
 }
+function responseColumnId(itemId, slotId) {
+	return `${itemId}::${slotId}`;
+}
+function metaColumnId(metaField) {
+	return `meta:${metaField}`;
+}
+function contextColumnId(contextKey) {
+	return `context:${contextKey}`;
+}
 function formatMetaValue(response, metaField) {
 	switch (metaField) {
 		case "submittedAt":
@@ -1752,25 +1817,27 @@ var SurveyResponseExporter = class {
 		const binding = this.versions.get(versionId);
 		if (!binding) return [];
 		const survey = binding.survey;
-		const slots = survey.getAvailableResponseValueSlots();
 		const keyIndex = survey.keyIndex;
 		const keyByItemId = new Map(keyIndex.map((r) => [r.itemId, r]));
 		const profile = this.resolveProfileForVersion(versionId);
 		const columns = [];
-		for (const [valueRef, valueType] of Object.entries(slots)) {
-			const { itemId, slotId } = parseValueRef(valueRef);
-			if (!itemId || !slotId) continue;
-			if (valueRef.includes(`${VALUE_REF_SEP$1}${ValueReferenceMethod.isDefined}`)) continue;
+		for (const { itemId, slots } of survey.getResponseSlotDefinitions()) {
 			const keyInfo = keyByItemId.get(itemId);
-			const defaultExportKey = `${keyInfo ? [...keyInfo.keyPath, keyInfo.key].join(".") : itemId}__${slotId}`;
-			const exportKey = (profile?.slotOverrides?.[slotOverrideKey(itemId, slotId)])?.exportKey ?? defaultExportKey;
-			columns.push({
-				key: exportKey,
-				source: ExportColumnSource.response,
-				itemId,
-				slotId,
-				valueType
-			});
+			const itemBaseKey = keyInfo ? [...keyInfo.keyPath, keyInfo.key].join(".") : itemId;
+			for (const slot of slots) {
+				const columnId = responseColumnId(itemId, slot.slotId);
+				const codingPath = [...slot.keyPath, slot.key].filter((part) => part.trim().length > 0);
+				const defaultHeader = codingPath.length > 0 ? `${itemBaseKey}__${codingPath.join(".")}` : `${itemBaseKey}__${slot.slotId}`;
+				const header = this.resolveColumnHeader(profile, columnId, defaultHeader);
+				columns.push({
+					id: columnId,
+					header,
+					source: ExportColumnSource.response,
+					itemId,
+					slotId: slot.slotId,
+					valueType: slot.valueType
+				});
+			}
 		}
 		return columns;
 	}
@@ -1782,13 +1849,14 @@ var SurveyResponseExporter = class {
 		const vids = versionIds ?? [versionId];
 		const responseCols = [];
 		const seen = /* @__PURE__ */ new Set();
-		for (const vid of vids) for (const c of this.computeResponseColumns(vid)) if (!seen.has(c.key)) {
-			seen.add(c.key);
+		for (const vid of vids) for (const c of this.computeResponseColumns(vid)) if (!seen.has(c.id)) {
+			seen.add(c.id);
 			responseCols.push(c);
 		}
 		const profile = this.resolveProfileForVersion(versionId);
 		const metaColumns = META_COLUMN_ORDER.map((metaField) => ({
-			key: metaField,
+			id: metaColumnId(metaField),
+			header: this.resolveColumnHeader(profile, metaColumnId(metaField), metaField),
 			source: ExportColumnSource.meta,
 			metaField
 		}));
@@ -1803,23 +1871,38 @@ var SurveyResponseExporter = class {
 			if (ib >= 0) return 1;
 			return a.localeCompare(b);
 		} : void 0).map((contextKey) => ({
-			key: `context.${contextKey}`,
+			id: contextColumnId(contextKey),
+			header: this.resolveColumnHeader(profile, contextColumnId(contextKey), `context.${contextKey}`),
 			source: ExportColumnSource.context,
 			contextKey
 		}));
 		const respOrder = profile?.responseColumnOrder ?? [];
-		const byOrder = respOrder.filter((k) => responseCols.some((c) => c.key === k)).map((k) => responseCols.find((c) => c.key === k));
-		const remaining = responseCols.filter((c) => !respOrder.includes(c.key)).sort((a, b) => a.key.localeCompare(b.key));
+		const byOrder = respOrder.filter((id) => responseCols.some((c) => c.id === id)).map((id) => responseCols.find((c) => c.id === id));
+		const remaining = responseCols.filter((c) => !respOrder.includes(c.id)).sort((a, b) => a.header.localeCompare(b.header));
 		const respCols = [...byOrder, ...remaining];
-		return [
+		const columns = [
 			...metaColumns,
 			...contextCols,
 			...respCols
 		];
+		this.assertUniqueHeaders(columns);
+		return columns;
 	}
 	resolveProfileForVersion(versionId) {
 		return this.profiles.find((p) => !p.versionId || p.versionId === versionId);
 	}
+	resolveColumnHeader(profile, columnId, defaultHeader) {
+		const override = profile?.columnHeaders?.[columnId]?.trim();
+		return override && override.length > 0 ? override : defaultHeader;
+	}
+	assertUniqueHeaders(columns) {
+		const seen = /* @__PURE__ */ new Map();
+		for (const column of columns) {
+			const existingId = seen.get(column.header);
+			if (existingId && existingId !== column.id) throw new Error(`Duplicate export column header '${column.header}' for columns '${existingId}' and '${column.id}'`);
+			seen.set(column.header, column.id);
+		}
+	}
 	getTransformConfig(versionId, itemId, slotId) {
 		return this.resolveProfileForVersion(versionId)?.slotOverrides?.[slotOverrideKey(itemId, slotId)] ?? DEFAULT_TRANSFORM;
 	}
@@ -1832,14 +1915,14 @@ var SurveyResponseExporter = class {
 		const row = {};
 		for (const col of columns) {
 			if (col.source === ExportColumnSource.meta && col.metaField) {
-				row[col.key] = formatMetaValue(response, col.metaField);
+				row[col.header] = formatMetaValue(response, col.metaField);
 				continue;
 			}
 			if (col.source === ExportColumnSource.context && col.contextKey) {
 				const value = response.context?.[col.contextKey];
 				const transformConfig = this.getContextTransformConfig(response.versionId, col.contextKey);
 				const valueType = value?.type ?? ValueType.string;
-				row[col.key] = exportSingleResponseSlot({
+				row[col.header] = exportSingleResponseSlot({
 					value,
 					valueType,
 					transformConfig
@@ -1849,7 +1932,7 @@ var SurveyResponseExporter = class {
 			if (col.source === ExportColumnSource.response && col.itemId != null && col.slotId != null && col.valueType != null) {
 				const value = response.responses.get(col.itemId)?.response?.get(col.slotId);
 				const transformConfig = this.getTransformConfig(response.versionId, col.itemId, col.slotId);
-				row[col.key] = exportSingleResponseSlot({
+				row[col.header] = exportSingleResponseSlot({
 					value,
 					valueType: col.valueType,
 					transformConfig
@@ -1872,17 +1955,8 @@ var SurveyResponseExporter = class {
 		return serializeToCsv(this.computeColumnsForBatch(responses), responses.map((r) => this.exportResponse(r)).filter((r) => r !== null), options);
 	}
 };
-
 //#endregion
 //#region src/response-exporter/codebook.ts
-const VALUE_REF_SEP = "...";
-/**
-* Extract plain text from Content for codebook display.
-*/
-function contentToPlainText(c) {
-	if (!c) return "";
-	return c.content ?? "";
-}
 /**
 * Generate a structured codebook from a survey definition.
 */
@@ -1890,26 +1964,18 @@ function generateCodebook(survey, options) {
 	const locales = options?.locales ?? survey.locales;
 	const keyIndex = survey.keyIndex;
 	const keyByItemId = new Map(keyIndex.map((r) => [r.itemId, r]));
-	const slots = survey.getAvailableResponseValueSlots();
-	const valueRefToSlots = /* @__PURE__ */ new Map();
-	for (const [valueRef, valueType] of Object.entries(slots)) {
-		const parts = valueRef.split(VALUE_REF_SEP);
-		if (parts.length !== 3 || parts[1] !== ValueReferenceMethod.get) continue;
-		const itemId = parts[0];
-		const slotId = parts[2];
-		const list = valueRefToSlots.get(itemId) ?? [];
-		if (!list.some((s) => s.slotId === slotId)) list.push({
-			slotId,
-			valueType
-		});
-		valueRefToSlots.set(itemId, list);
-	}
+	const slotDefsByItemId = new Map(survey.getResponseSlotDefinitions().map(({ itemId, slots }) => [itemId, slots.map((slot) => ({
+		slotId: slot.slotId,
+		key: slot.key,
+		keyPath: [...slot.keyPath],
+		valueType: slot.valueType
+	}))]));
 	const items = [];
 	for (const item of survey.surveyItems.values()) {
 		const keyInfo = keyByItemId.get(item.id);
 		const key = keyInfo?.key ?? item.id;
 		const keyPath = keyInfo?.keyPath ?? [];
-		const slotList = valueRefToSlots.get(item.id) ?? [];
+		const slotList = slotDefsByItemId.get(item.id) ?? [];
 		slotList.sort((a, b) => a.slotId.localeCompare(b.slotId));
 		let contentByLocale;
 		if (locales.length > 0) {
@@ -1919,7 +1985,7 @@ function generateCodebook(survey, options) {
 				const all = itemTranslations.getAllForLocale(locale);
 				if (all) {
 					const flat = {};
-					for (const [contentKey, content] of Object.entries(all)) flat[contentKey] = contentToPlainText(content);
+					for (const [contentKey, content] of Object.entries(all)) flat[contentKey] = getContentPlainText(content);
 					contentByLocale[locale] = flat;
 				}
 			}
@@ -1939,7 +2005,7 @@ function generateCodebook(survey, options) {
 		items: items.sort((a, b) => a.key.localeCompare(b.key))
 	};
 }
-
 //#endregion
-export { AndExpressionEditor, AttributionType, ConstBooleanEditor, ConstDateArrayEditor, ConstDateEditor, ConstExpression, ConstNumberArrayEditor, ConstNumberEditor, ConstStringArrayEditor, ConstStringEditor, ContentType, ContextVariableExpression, ContextVariableType, CtxCustomExpressionEditor, CtxCustomValueEditor, CtxLocaleEditor, CtxPFlagDateEditor, CtxPFlagIsDefinedEditor, CtxPFlagNumEditor, CtxPFlagStringEditor, DEFAULT_TRANSFORM, DurationUnits, EqExpressionEditor, Expression, ExpressionEditor, ExpressionEvaluator, ExpressionType, FunctionExpression, FunctionExpressionNames, GroupItemCore, GtExpressionEditor, GteExpressionEditor, InRangeExpressionEditor, LtExpressionEditor, LteExpressionEditor, META_COLUMN_ORDER, MaxExpressionEditor, MinExpressionEditor, NumberPrecision, OrExpressionEditor, PageBreakItemCore, ReferenceUsageType, ReservedSurveyItemTypes, ResponseItem, ResponseVariableEditor, ResponseVariableExpression, SlotTransformMode, StrEqExpressionEditor, StrListContainsExpressionEditor, SumExpressionEditor, Survey, SurveyEngineCore, SurveyEventTypes, SurveyItemCore, SurveyItemKey, SurveyItemResponse, SurveyItemTranslations, SurveyResponse, SurveyResponseExporter, SurveyTranslations, TemplateDefTypes, ValueReference, ValueReferenceMethod, ValueType, and, builtInItemCoreRegistry, const_boolean, const_date, const_date_array, const_number, const_number_array, const_string, const_string_array, createFullRegistry, createItemCore, createItemTypeDefinitionRegistry, ctx_custom_expression, ctx_custom_value, ctx_locale, ctx_pflag_date, ctx_pflag_is_defined, ctx_pflag_num, ctx_pflag_string, deserializeTemplateValue, deserializeTemplateValues, eq, escapeCsvCell, exportSingleResponseSlot, flattenTree, generateCodebook, generateCodingKey, generateId, gt, gte, in_range, initValueForType, isBuiltInItemType, isLegacyItemGroupComponent, isLegacySurveyGroupItem, lt, lte, max, min, or, response_boolean, response_date, response_date_array, response_number, response_number_array, response_string, response_string_array, serializeTemplateValue, serializeTemplateValues, serializeToCsv, shuffleIndices, str_eq, str_list_contains, structuredCloneMethod, sum, toItemTypeDefinitionRegistry, validateLocale };
+export { AndExpressionEditor, CURRENT_SURVEY_SCHEMA, ConstBooleanEditor, ConstDateArrayEditor, ConstDateEditor, ConstExpression, ConstNumberArrayEditor, ConstNumberEditor, ConstStringArrayEditor, ConstStringEditor, ContentType, ContextVariableExpression, ContextVariableType, CtxCustomExpressionEditor, CtxCustomValueEditor, CtxLocaleEditor, CtxPFlagDateEditor, CtxPFlagIsDefinedEditor, CtxPFlagNumEditor, CtxPFlagStringEditor, DEFAULT_TRANSFORM, DurationUnits, EXPORT_COLUMN_SLOT_SEPARATOR, EqExpressionEditor, Expression, ExpressionEditor, ExpressionEvaluator, ExpressionType, FunctionExpression, FunctionExpressionNames, GroupItemCore, GtExpressionEditor, GteExpressionEditor, InRangeExpressionEditor, LtExpressionEditor, LteExpressionEditor, META_COLUMN_ORDER, MaxExpressionEditor, MinExpressionEditor, NumberPrecision, OrExpressionEditor, PageBreakItemCore, ReferenceUsageType, ReservedSurveyItemTypes, ResponseItem, ResponseVariableEditor, ResponseVariableExpression, SURVEY_RESPONSE_SCHEMA_VERSION, SlotTransformMode, StrEqExpressionEditor, StrListContainsExpressionEditor, SumExpressionEditor, Survey, SurveyEngineCore, SurveyEventTypes, SurveyItemCore, SurveyItemKey, SurveyItemPrefillApplyMode, SurveyItemPrefillTargetType, SurveyItemResponse, SurveyItemTranslations, SurveyResponse, SurveyResponseExporter, SurveyTranslations, TemplateDefTypes, ValueReference, ValueReferenceMethod, ValueType, and, assertResponseValue, buildItemExpression, builtInItemCoreRegistry, const_boolean, const_date, const_date_array, const_number, const_number_array, const_string, const_string_array, createFullRegistry, createItemCore, createItemTypeDefinitionRegistry, createRichTextContent, createSeededRandom, ctx_custom_expression, ctx_custom_value, ctx_locale, ctx_pflag_date, ctx_pflag_is_defined, ctx_pflag_num, ctx_pflag_string, deserializeSurveyItemPrefill, deserializeTemplateValue, deserializeTemplateValues, eq, escapeCsvCell, exportSingleResponseSlot, flattenTree, generateCodebook, generateCodingKey, generateId, getAssetUsagesFromContent, getContentPlainText, getItemExpressionDefinition, getPlainTextFromRichTextContent, gt, gte, hasRenderableRichTextBlock, hasRenderableRichTextContent, in_range, initValueForType, isBuiltInItemType, isContentEmpty, isLegacyItemGroupComponent, isLegacySurveyGroupItem, isResponseValue, lt, lte, max, min, or, prefillTargetsEqual, response_boolean, response_date, response_date_array, response_number, response_number_array, response_string, response_string_array, serializeSurveyItemPrefill, serializeTemplateValue, serializeTemplateValues, serializeToCsv, shuffleArray, shuffleIndices, str_eq, str_list_contains, structuredCloneMethod, sum, toItemTypeDefinitionRegistry, validateLocale };
+
 //# sourceMappingURL=index.mjs.map