@case-framework/survey-assistant 0.1.0 → 0.2.0

package/dist/{engine-sPvuixWg.mjs → engine-DQrCO_ur.mjs}

@@ -1,5 +1,5 @@
-import { N as rawSurveyDocumentSchema, c as surveyAssistantTurnFinalSchema, u as surveyChangeSetSchema } from "./protocol-DV0ka9WT.mjs";
-import { n as assertSurveyAssistantCapabilities } from "./capabilities-B6tvE7fK.mjs";
+import { P as rawSurveyDocumentSchema, c as surveyAssistantTurnFinalSchema, u as surveyChangeSetSchema } from "./protocol-7EEgcYja.mjs";
+import { n as assertSurveyAssistantCapabilities } from "./capabilities-DZ0a_o2y.mjs";
 import { z } from "zod";
 import { ContentType, Expression, ExpressionType, FunctionExpressionNames, JsonPatchError, ReservedSurveyItemTypes, SurveyTranslations, ValueReferenceMethod, ValueType, applyJsonPatch, generateId, getContentPlainText, isContentEmpty, parseJsonPointer, structuredCloneMethod } from "@case-framework/survey-core";
 //#region src/engine/context.ts
@@ -161,7 +161,7 @@ const buildDerivedContext = (snapshot, trustedCapabilities, requestedFocusItemId
 		inspection: {
 			surveyKey: explicitRoot?.key,
 			locales,
-			itemCount: rawItems.length,
+			itemCount: rawItems.filter((item) => item.id !== explicitRoot?.id).length,
 			outline,
 			focus,
 			focusItem,
@@ -476,6 +476,7 @@ const translationEntrySchema = z.object({
 	text: z.string()
 });
 const choiceOptionDetailsSchema = z.object({
+	position: z.number().int().positive().describe("One-based position in the stored option order."),
 	id: z.string(),
 	key: z.string().optional(),
 	labelContentKey: z.string(),
@@ -486,6 +487,7 @@ const choiceOptionDetailsSchema = z.object({
 	embeddedFormResponseSlotPrefix: z.string().optional()
 });
 const formSelectOptionDetailsSchema = z.object({
+	position: z.number().int().positive().describe("One-based position in the stored select-option order."),
 	id: z.string(),
 	value: z.string().optional(),
 	labelContentKey: z.string()
@@ -498,6 +500,7 @@ const formFieldGroupLayoutSchema = z.object({
 	xl: z.number().int().positive()
 });
 const formFieldDetailsSchema = z.object({
+	position: z.number().int().positive().describe("One-based position in this field group's stored field order."),
 	id: z.string(),
 	key: z.string(),
 	type: z.string(),
@@ -516,6 +519,7 @@ const formFieldDetailsSchema = z.object({
 	selectOptions: z.array(formSelectOptionDetailsSchema).optional()
 });
 const formFieldGroupDetailsSchema = z.object({
+	position: z.number().int().positive().describe("One-based position in the form's stored field-group order."),
 	id: z.string(),
 	titleContentKey: z.string(),
 	descriptionContentKey: z.string(),
@@ -533,7 +537,8 @@ const itemConfigDetailsSchema = z.object({
 	summary: z.array(z.string()),
 	mainResponseSlotId: z.string().optional(),
 	choiceOptions: z.array(choiceOptionDetailsSchema).optional(),
-	formFieldGroups: z.array(formFieldGroupDetailsSchema).optional()
+	formFieldGroups: z.array(formFieldGroupDetailsSchema).optional(),
+	listOrdering: z.record(z.string(), z.string()).optional().describe("Meaning of each list in these config details.")
 });
 const normalizeText = (value) => value?.trim().toLowerCase() ?? "";
 const clampLimit = (limit) => Math.min(50, Math.max(1, limit ?? 12));
@@ -668,11 +673,13 @@ const buildChoiceConfigDetails = (rawItem) => {
 	const rawOptions = asArray(config?.options);
 	const mainResponseSlotId = asString(config?.id) ?? rawItem.id;
 	if (rawItem.itemType !== "choiceItem" && rawOptions.length === 0) return;
-	const choiceOptions = rawOptions.filter(isRecord$5).map((option) => {
+	const choiceOptions = rawOptions.map((option, index) => {
+		if (!isRecord$5(option)) return;
 		const id = asString(option.id);
 		if (!id) return;
 		const embeddedFormFieldGroups = asArray((isRecord$5(option.embeddedForm) ? option.embeddedForm : void 0)?.fieldGroups);
 		const details = {
+			position: index + 1,
 			id,
 			labelContentKey: getChoiceOptionLabelContentKey(id)
 		};
@@ -699,10 +706,11 @@ const buildChoiceConfigDetails = (rawItem) => {
 			`responseSlot=${mainResponseSlotId}`
 		],
 		mainResponseSlotId,
-		choiceOptions
+		choiceOptions,
+		listOrdering: { choiceOptions: config?.shuffleOptions === true ? "Stored configured order; positions are one-based. Respondents see a shuffled order, so this is not a stable respondent-visible order." : "Stored configured order; positions are one-based and match respondent-visible order." }
 	};
 };
-const buildFormFieldDetails = (field, translationNamespace, responseSlotPrefix) => {
+const buildFormFieldDetails = (field, position, translationNamespace, responseSlotPrefix) => {
 	const id = asString(field.id);
 	const key = asString(field.key);
 	const type = asString(field.type);
@@ -711,10 +719,12 @@ const buildFormFieldDetails = (field, translationNamespace, responseSlotPrefix)
 	const controllerType = asString(controller?.type);
 	const validations = asArray(field.validations).filter(isRecord$5);
 	const validationMessageContentKeys = validations.map((validation) => asString(validation.id)).filter((validationId) => Boolean(validationId)).map((validationId) => getFormFieldContentKey(id, createContentKey("validations", validationId, "message"), translationNamespace));
-	const selectOptions = controllerType === "select" ? asArray(controller?.options).filter(isRecord$5).map((option) => {
+	const selectOptions = controllerType === "select" ? asArray(controller?.options).map((option, index) => {
+		if (!isRecord$5(option)) return;
 		const optionId = asString(option.id);
 		if (!optionId) return;
 		const details = {
+			position: index + 1,
 			id: optionId,
 			labelContentKey: getFormFieldOptionLabelContentKey(id, optionId, translationNamespace)
 		};
@@ -723,6 +733,7 @@ const buildFormFieldDetails = (field, translationNamespace, responseSlotPrefix)
 		return details;
 	}).filter((option) => Boolean(option)) : void 0;
 	return {
+		position,
 		id,
 		key,
 		type,
@@ -745,12 +756,14 @@ const buildFormConfigDetails = (rawItem, configOverride, translationNamespace, r
 	const configCandidate = configOverride ?? rawItem.config;
 	const rawGroups = asArray((isRecord$5(configCandidate) ? configCandidate : void 0)?.fieldGroups);
 	if (rawItem.itemType !== "formItem" && rawGroups.length === 0) return;
-	const formFieldGroups = rawGroups.filter(isRecord$5).map((group) => {
+	const formFieldGroups = rawGroups.map((group, groupIndex) => {
+		if (!isRecord$5(group)) return;
 		const id = asString(group.id);
 		if (!id) return;
-		const fields = asArray(group.fields).filter(isRecord$5).map((field) => buildFormFieldDetails(field, translationNamespace, responseSlotPrefix)).filter((field) => Boolean(field));
+		const fields = asArray(group.fields).map((field, fieldIndex) => isRecord$5(field) ? buildFormFieldDetails(field, fieldIndex + 1, translationNamespace, responseSlotPrefix) : void 0).filter((field) => Boolean(field));
 		const layout = isRecord$5(group.layout) ? group.layout : void 0;
 		return {
+			position: groupIndex + 1,
 			id,
 			titleContentKey: getFormFieldGroupContentKey(id, "title", translationNamespace),
 			descriptionContentKey: getFormFieldGroupContentKey(id, "description", translationNamespace),
@@ -770,7 +783,12 @@ const buildFormConfigDetails = (rawItem, configOverride, translationNamespace, r
 	return {
 		kind: "form",
 		summary: [`form item config: ${formFieldGroups.length} group(s), ${fieldCount} field(s)`],
-		formFieldGroups
+		formFieldGroups,
+		listOrdering: {
+			formFieldGroups: "Stored configured order; positions are one-based.",
+			"formFieldGroups[].fields": "Stored configured order within each field group; positions are one-based.",
+			"formFieldGroups[].fields[].selectOptions": "Stored configured order within each select field; positions are one-based."
+		}
 	};
 };
 const buildItemConfigDetails = (rawItem) => {
@@ -1434,18 +1452,17 @@ const isRecord$3 = (value) => typeof value === "object" && value !== null && !Ar
 const getString = (value) => typeof value === "string" ? value.trim() : void 0;
 const normalizeChoiceMaxSelection = (config) => {
 	if (config.maxSelection === null) return null;
-	if (typeof config.maxSelection === "number" && Number.isFinite(config.maxSelection)) return Math.max(1, Math.floor(config.maxSelection));
+	if (typeof config.maxSelection === "number") return config.maxSelection;
 	if (typeof config.maxSelection === "string") {
 		const normalized = config.maxSelection.trim().toLowerCase();
 		if (normalized === "multiple" || normalized === "multi" || normalized === "unlimited" || normalized === "none") return null;
-		const parsed = Number.parseInt(normalized, 10);
-		if (Number.isFinite(parsed) && parsed >= 1) return parsed;
+		if (/^[1-9]\d*$/.test(normalized)) return Number.parseInt(normalized, 10);
+		return config.maxSelection;
 	}
 	const mode = getString(config.mode)?.toLowerCase() ?? getString(config.selectionType)?.toLowerCase() ?? getString(config.selectionMode)?.toLowerCase();
 	if (mode === "multiple" || mode === "multi" || mode === "multi-select" || mode === "multiselect" || mode === "checkbox" || mode === "checkboxes") return null;
 	return 1;
 };
-const humanizeKey = (value) => value.replace(/[_-]+/g, " ").replace(/([a-z])([A-Z])/g, "$1 $2").trim().replace(/\b\w/g, (char) => char.toUpperCase());
 const normalizeLayout = (value) => {
 	const baseLayout = {
 		base: 1,
@@ -1456,10 +1473,7 @@ const normalizeLayout = (value) => {
 	};
 	if (!isRecord$3(value)) return baseLayout;
 	const normalized = { ...baseLayout };
-	for (const key of Object.keys(normalized)) {
-		const count = value[key];
-		if (typeof count === "number" && Number.isFinite(count)) normalized[key] = Math.min(4, Math.max(1, Math.round(count)));
-	}
+	for (const key of Object.keys(normalized)) if (value[key] !== void 0) normalized[key] = value[key];
 	return normalized;
 };
 const normalizeKey = (value) => value.trim().replace(/[.\s]+/g, "_").replace(/[^A-Za-z0-9_-]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
@@ -1669,14 +1683,9 @@ const appendMarker = (text, marker) => {
 };
 const getOptionNote = (option) => getString(option.note) ?? getString(option.description) ?? getString(option.helpText) ?? getString(option.instruction);
 const getFootnoteMarker = (option) => getString(option.footnoteMarker) ?? getString(option.marker);
-const hasEmbeddedForm = (option) => isRecord$3(option.embeddedForm);
-const stripTrailingEmbeddedFormCue = (text, option) => {
-	if (!hasEmbeddedForm(option)) return text;
-	return text.replace(/\s*[,;:]?\s*(namelijk|namely|please specify|specify|explain|explanation|toelichting)\s*[:.]?\s*$/iu, "").trim();
-};
 const getOptionTranslationLabel = (option) => {
 	const directLabel = getString(option.label) ?? getString(option.text) ?? getString(option.title);
-	if (directLabel) return appendMarker(stripTrailingEmbeddedFormCue(appendParenthetical(directLabel, getOptionNote(option)), option), getFootnoteMarker(option));
+	if (directLabel) return appendMarker(appendParenthetical(directLabel, getOptionNote(option)), getFootnoteMarker(option));
 	if (!isRecord$3(option.translations)) return;
 	for (const localeValue of Object.values(option.translations)) {
 		if (!isRecord$3(localeValue)) continue;
@@ -1684,7 +1693,7 @@ const getOptionTranslationLabel = (option) => {
 		if (translatedLabel) {
 			const translatedNote = getString(localeValue.note) ?? getString(localeValue.description) ?? getString(localeValue.helpText) ?? getString(localeValue.instruction);
 			const translatedMarker = getString(localeValue.footnoteMarker) ?? getString(localeValue.marker);
-			return appendMarker(stripTrailingEmbeddedFormCue(appendParenthetical(translatedLabel, translatedNote), option), translatedMarker);
+			return appendMarker(appendParenthetical(translatedLabel, translatedNote), translatedMarker);
 		}
 	}
 };
@@ -1723,27 +1732,49 @@ const normalizeLooseField = (field) => {
 	const id = rawId ? normalizeKey(rawId) : void 0;
 	if (!id) return { translations: [] };
 	const rawType = getString(field.type) ?? getString(field.controlType) ?? "input";
-	const type = rawType === "text" || rawType === "email" ? "input" : rawType === "checkbox" ? "switch" : rawType;
-	const controller = rawType === "textarea" ? {
-		type: "textarea",
-		rows: 3
-	} : rawType === "number" ? {
-		type: "number",
-		step: 1
-	} : rawType === "checkbox" ? {
-		type: "switch",
-		defaultChecked: false
-	} : rawType === "select" ? {
-		type: "select",
-		options: []
-	} : {
-		type: "input",
-		inputMode: rawType === "email" ? "email" : "text"
-	};
-	const translations = [{
+	const type = rawType === "text" || rawType === "email" ? "input" : rawType === "date" ? "datepicker" : rawType === "checkbox" ? "switch" : rawType;
+	const controller = (() => {
+		switch (type) {
+			case "textarea": return {
+				type: "textarea",
+				rows: 3
+			};
+			case "number": return {
+				type: "number",
+				step: 1
+			};
+			case "datepicker": return {
+				type: "datepicker",
+				mode: "year-month-day"
+			};
+			case "switch": return {
+				type: "switch",
+				defaultChecked: false
+			};
+			case "select": return {
+				type: "select",
+				options: []
+			};
+			case "slider": return {
+				type: "slider",
+				min: 0,
+				max: 100,
+				step: 1,
+				defaultValue: 50,
+				showValue: true
+			};
+			default: return {
+				type: "input",
+				inputMode: rawType === "email" ? "email" : "text"
+			};
+		}
+	})();
+	const translations = [];
+	const label = getString(field.label);
+	if (label) translations.push({
 		contentKey: `fields.${id}.label`,
-		plainText: getString(field.label) ?? humanizeKey(id)
-	}];
+		plainText: label
+	});
 	const placeholder = getString(field.placeholder);
 	if (placeholder) translations.push({
 		contentKey: `fields.${id}.placeholder`,
@@ -1762,7 +1793,7 @@ const normalizeLooseField = (field) => {
 	return {
 		field: {
 			id,
-			key: getString(field.key) ?? id.toUpperCase(),
+			key: getString(field.key) ?? id,
 			type,
 			required: field.required === true,
 			controller: normalizeSelectControllerOptions({
@@ -2028,6 +2059,149 @@ const validateTranslationBranchShapes = ({ operation, survey }) => {
 	return issues;
 };
 const getRawItemsFromSurvey = (survey) => Array.isArray(survey.surveyItems) ? survey.surveyItems : [];
+const FORM_LAYOUT_BREAKPOINTS = [
+	"base",
+	"xs",
+	"sm",
+	"md",
+	"xl"
+];
+const collectInvalidFieldGroupLayouts = ({ fieldGroups, itemId, prefix, invalid }) => {
+	if (!Array.isArray(fieldGroups)) return;
+	for (const [groupIndex, group] of fieldGroups.entries()) {
+		if (!isRecord$2(group) || !isRecord$2(group.layout)) continue;
+		const groupId = getTrimmedString(group.id) ?? String(groupIndex);
+		for (const breakpoint of FORM_LAYOUT_BREAKPOINTS) {
+			const value = group.layout[breakpoint];
+			if (value !== void 0 && (typeof value !== "number" || !Number.isInteger(value) || value < 1 || value > 4)) {
+				const path = `${prefix}.${groupId}.layout.${breakpoint}`;
+				invalid.set(`${itemId}\u0000${path}`, {
+					itemId,
+					path,
+					value
+				});
+			}
+		}
+	}
+};
+const collectInvalidSurveyFormLayouts = (survey) => {
+	const invalid = /* @__PURE__ */ new Map();
+	for (const item of survey.surveyItems) {
+		const config = isRecord$2(item.config) ? item.config : void 0;
+		if (item.itemType === FORM_ITEM_TYPE) {
+			collectInvalidFieldGroupLayouts({
+				fieldGroups: config?.fieldGroups,
+				itemId: item.id,
+				prefix: "fieldGroups",
+				invalid
+			});
+			continue;
+		}
+		if (item.itemType !== CHOICE_ITEM_TYPE || !Array.isArray(config?.options)) continue;
+		for (const option of config.options) {
+			if (!isRecord$2(option) || !isRecord$2(option.embeddedForm)) continue;
+			const optionId = getTrimmedString(option.id);
+			if (optionId) collectInvalidFieldGroupLayouts({
+				fieldGroups: option.embeddedForm.fieldGroups,
+				itemId: item.id,
+				prefix: `embeddedForms.${optionId}.fieldGroups`,
+				invalid
+			});
+		}
+	}
+	return invalid;
+};
+const addRequiredLocalizedContent = (required, itemId, contentKey) => {
+	required.set(`${itemId}\u0000${contentKey}`, {
+		itemId,
+		contentKey
+	});
+};
+const collectFieldLocalizedContent = ({ fieldGroups, itemId, prefix, required }) => {
+	if (!Array.isArray(fieldGroups)) return;
+	for (const group of fieldGroups) {
+		if (!isRecord$2(group) || !Array.isArray(group.fields)) continue;
+		for (const field of group.fields) {
+			if (!isRecord$2(field)) continue;
+			const fieldId = getTrimmedString(field.id);
+			if (!fieldId) continue;
+			addRequiredLocalizedContent(required, itemId, `${prefix}.${fieldId}.label`);
+			const controller = isRecord$2(field.controller) ? field.controller : void 0;
+			if (field.type !== "select" || controller?.type !== "select") continue;
+			for (const option of Array.isArray(controller.options) ? controller.options : []) {
+				const optionId = isRecord$2(option) ? getTrimmedString(option.id) : void 0;
+				if (optionId) addRequiredLocalizedContent(required, itemId, `${prefix}.${fieldId}.options.${optionId}.label`);
+			}
+		}
+	}
+};
+const collectRequiredLocalizedContent = (survey, snapshot) => {
+	const required = /* @__PURE__ */ new Map();
+	const manifestByItemType = new Map(snapshot.capabilities.itemTypes.map((entry) => [entry.itemType, entry]));
+	for (const item of survey.surveyItems) {
+		const manifest = manifestByItemType.get(item.itemType);
+		for (const surface of manifest?.contentSurfaces ?? []) if (surface.requiredOnCreate && !surface.pattern) addRequiredLocalizedContent(required, item.id, surface.key);
+		const config = isRecord$2(item.config) ? item.config : void 0;
+		if (item.itemType === FORM_ITEM_TYPE) {
+			collectFieldLocalizedContent({
+				fieldGroups: config?.fieldGroups,
+				itemId: item.id,
+				prefix: "fields",
+				required
+			});
+			continue;
+		}
+		if (item.itemType !== CHOICE_ITEM_TYPE || !Array.isArray(config?.options)) continue;
+		for (const option of config.options) {
+			if (!isRecord$2(option)) continue;
+			const optionId = getTrimmedString(option.id);
+			if (!optionId) continue;
+			addRequiredLocalizedContent(required, item.id, `options.${optionId}.label`);
+			if (isRecord$2(option.embeddedForm)) collectFieldLocalizedContent({
+				fieldGroups: option.embeddedForm.fieldGroups,
+				itemId: item.id,
+				prefix: `embeddedForms.${optionId}.fields`,
+				required
+			});
+		}
+	}
+	return required;
+};
+const hasNonEmptySurveyTranslation = (survey, { itemId, contentKey }) => Object.values(survey.translations ?? {}).some((localeTranslations) => {
+	const content = localeTranslations?.itemTranslations?.[itemId]?.[contentKey];
+	return isContent(content) && !isContentEmpty(content);
+});
+const validateNewRawPatchLocalizedContent = ({ operation, originalSurvey, patchedSurvey, snapshot }) => {
+	const existingRequired = collectRequiredLocalizedContent(originalSurvey, snapshot);
+	const existingMissing = new Set(Array.from(existingRequired).filter(([, binding]) => !hasNonEmptySurveyTranslation(originalSurvey, binding)).map(([identity]) => identity));
+	const missing = Array.from(collectRequiredLocalizedContent(patchedSurvey, snapshot)).filter(([identity, binding]) => {
+		if (hasNonEmptySurveyTranslation(patchedSurvey, binding)) return false;
+		return !existingMissing.has(identity);
+	}).map(([, binding]) => binding);
+	if (missing.length === 0) return [];
+	return [createIssue({
+		code: "missing-raw-patch-localized-content",
+		message: `The raw patch introduces respondent-visible content without its required translation. Add non-empty Content values in the same patches array for: ${missing.map(({ itemId, contentKey }) => `/translations/<locale>/itemTranslations/${itemId}/${contentKey}`).join(", ")}. Content keys use config ids exactly and are case-sensitive; for embedded fields, embeddedForms.<optionId> uses the choice option's id, not its key or embeddedForm id.`,
+		operationIndex: 0,
+		operationId: getOperationId(operation),
+		itemId: missing[0]?.itemId
+	})];
+};
+const validateNewRawPatchFormLayouts = ({ operation, originalSurvey, patchedSurvey }) => {
+	const existingInvalid = collectInvalidSurveyFormLayouts(originalSurvey);
+	const introducedInvalid = Array.from(collectInvalidSurveyFormLayouts(patchedSurvey)).filter(([identity, entry]) => {
+		const existing = existingInvalid.get(identity);
+		return !existing || !Object.is(existing.value, entry.value);
+	}).map(([, entry]) => entry);
+	if (introducedInvalid.length === 0) return [];
+	return [createIssue({
+		code: "invalid-form-layout-columns",
+		message: `Form layout values are responsive column counts from 1 to 4, not field spans. Use 1 for a lone full-width field. Invalid values: ${introducedInvalid.map(({ path, value }) => `${path}=${JSON.stringify(value)}`).join(", ")}.`,
+		operationIndex: 0,
+		operationId: getOperationId(operation),
+		itemId: introducedInvalid[0]?.itemId
+	})];
+};
 const createStructureIssue = ({ code, message, operationId, itemId }) => createIssue({
 	code,
 	message,
@@ -2350,6 +2524,15 @@ const validateSurveyJsonPatchOperation = ({ operation, snapshot }) => {
 	issues.push(...validateTranslationBranchShapes({
 		operation,
 		survey: patchedSurvey
+	}), ...validateNewRawPatchLocalizedContent({
+		operation,
+		originalSurvey: snapshot.survey,
+		patchedSurvey,
+		snapshot
+	}), ...validateNewRawPatchFormLayouts({
+		operation,
+		originalSurvey: snapshot.survey,
+		patchedSurvey
 	}), ...validateSurveyTreeStructure(patchedSurvey, operationId, new Set(snapshot.capabilities.itemTypes.map((entry) => entry.itemType))));
 	const documentResult = rawSurveyDocumentSchema.safeParse(patchedSurvey);
 	if (!documentResult.success) {
@@ -2763,6 +2946,66 @@ const getRawFields = (fieldGroups) => {
 	}
 	return fields;
 };
+const getRequiredFormContentKeys = ({ fieldGroups, prefix }) => {
+	const required = /* @__PURE__ */ new Set();
+	for (const field of getRawFields(fieldGroups)) {
+		const fieldId = getTrimmedString(field.id);
+		if (!fieldId) continue;
+		required.add(`${prefix}.${fieldId}.label`);
+		const controller = isRecord$2(field.controller) ? field.controller : void 0;
+		if (field.type !== "select" || controller?.type !== "select") continue;
+		for (const option of Array.isArray(controller.options) ? controller.options : []) {
+			const optionId = isRecord$2(option) ? getTrimmedString(option.id) : void 0;
+			if (optionId) required.add(`${prefix}.${fieldId}.options.${optionId}.label`);
+		}
+	}
+	return Array.from(required);
+};
+const getMissingFormOperationContentKeys = ({ fieldGroups, itemId, prefix, snapshot, translations }) => getRequiredFormContentKeys({
+	fieldGroups,
+	prefix
+}).filter((contentKey) => {
+	if (translations?.some((translation) => translation.contentKey === contentKey && getTranslationPlainText(translation).length > 0)) return false;
+	return !hasNonEmptySurveyTranslation(snapshot.survey, {
+		itemId,
+		contentKey
+	});
+});
+const getInvalidFormLayoutIssue = ({ fieldGroups, itemId, operationId, operationIndex, prefix }) => {
+	const invalid = /* @__PURE__ */ new Map();
+	collectInvalidFieldGroupLayouts({
+		fieldGroups,
+		itemId,
+		prefix,
+		invalid
+	});
+	const entries = Array.from(invalid.values());
+	if (entries.length === 0) return;
+	return createIssue({
+		code: "invalid-form-layout-columns",
+		message: `Form layout values are responsive column counts from 1 to 4, not field spans. Use 1 for a lone full-width field. Invalid values: ${entries.map(({ path, value }) => `${path}=${JSON.stringify(value)}`).join(", ")}.`,
+		operationIndex,
+		operationId,
+		itemId
+	});
+};
+const getFormOperationContentIssue = ({ fieldGroups, itemId, operationId, operationIndex, prefix, snapshot, translations }) => {
+	const missingContentKeys = getMissingFormOperationContentKeys({
+		fieldGroups,
+		itemId,
+		prefix,
+		snapshot,
+		translations
+	});
+	if (missingContentKeys.length === 0) return;
+	return createIssue({
+		code: "missing-form-field-content",
+		message: "Introduced form fields and select options need visible labels. Add non-empty translations for: " + missingContentKeys.join(", ") + ".",
+		operationIndex,
+		operationId,
+		itemId
+	});
+};
 const getMissingSelectOptionLabelContentKeys = ({ fieldGroups, prefix, translations }) => {
 	const missingContentKeys = [];
 	for (const field of getRawFields(fieldGroups)) {
@@ -2890,6 +3133,30 @@ const getChoiceEmbeddedFormFieldLabelIssue = ({ operation, operationId, operatio
 		itemId
 	});
 };
+const getCreateFormLayoutIssue = ({ operation, operationId, operationIndex, itemId }) => {
+	if (!isRecord$2(operation.item.config)) return;
+	if (operation.item.itemType === FORM_ITEM_TYPE) return getInvalidFormLayoutIssue({
+		fieldGroups: operation.item.config.fieldGroups,
+		itemId,
+		operationId,
+		operationIndex,
+		prefix: "fieldGroups"
+	});
+	if (operation.item.itemType !== CHOICE_ITEM_TYPE || !Array.isArray(operation.item.config.options)) return;
+	for (const option of operation.item.config.options) {
+		if (!isRecord$2(option) || !isRecord$2(option.embeddedForm)) continue;
+		const optionId = getTrimmedString(option.id);
+		if (!optionId) continue;
+		const issue = getInvalidFormLayoutIssue({
+			fieldGroups: option.embeddedForm.fieldGroups,
+			itemId,
+			operationId,
+			operationIndex,
+			prefix: `embeddedForms.${optionId}.fieldGroups`
+		});
+		if (issue) return issue;
+	}
+};
 const resolveRawItemByIdentifier = ({ identifier, indexById, outlineById, rawItemsById }) => {
 	const direct = rawItemsById.get(identifier);
 	if (direct) return {
@@ -3310,6 +3577,13 @@ const validateSurveyOperations = ({ operations, snapshot: snapshotInput }) => {
 				itemId
 			});
 			if (formFieldLabelIssue) issues.push(formFieldLabelIssue);
+			const formLayoutIssue = getCreateFormLayoutIssue({
+				operation: normalized,
+				operationId,
+				operationIndex,
+				itemId
+			});
+			if (formLayoutIssue) issues.push(formLayoutIssue);
 			for (const translation of normalized.translations ?? []) {
 				addIntroducedLocaleWarning({
 					locale: translation.locale,
@@ -3663,6 +3937,27 @@ const validateSurveyOperations = ({ operations, snapshot: snapshotInput }) => {
 					}));
 					break;
 				}
+				const layoutIssue = getInvalidFormLayoutIssue({
+					fieldGroups: [normalized.group],
+					itemId: item.itemId,
+					operationId,
+					operationIndex,
+					prefix: normalized.target.optionId ? `embeddedForms.${normalized.target.optionId}.fieldGroups` : "fieldGroups"
+				});
+				const contentIssue = Array.isArray(normalized.group.fields) ? getFormOperationContentIssue({
+					fieldGroups: [normalized.group],
+					itemId: item.itemId,
+					operationId,
+					operationIndex,
+					prefix: normalized.target.optionId ? `embeddedForms.${normalized.target.optionId}.fields` : "fields",
+					snapshot,
+					translations: normalized.translations
+				}) : void 0;
+				if (layoutIssue || contentIssue) {
+					if (layoutIssue) issues.push(layoutIssue);
+					if (contentIssue) issues.push(contentIssue);
+					break;
+				}
 				const existingIndex = groups.findIndex((group) => group.id === normalized.group.id);
 				const existing = existingIndex >= 0 ? groups[existingIndex] : void 0;
 				const nextGroup = normalizeFormFieldGroupRecord({
@@ -3739,6 +4034,19 @@ const validateSurveyOperations = ({ operations, snapshot: snapshotInput }) => {
 					}));
 					break;
 				}
+				const contentIssue = getFormOperationContentIssue({
+					fieldGroups: [{ fields: [normalized.field] }],
+					itemId: item.itemId,
+					operationId,
+					operationIndex,
+					prefix: normalized.target.optionId ? `embeddedForms.${normalized.target.optionId}.fields` : "fields",
+					snapshot,
+					translations: normalized.translations
+				});
+				if (contentIssue) {
+					issues.push(contentIssue);
+					break;
+				}
 				if (groups.flatMap((group) => group.fields).find((field) => field.id !== normalized.field.id && field.key === normalized.field.key)) {
 					issues.push(createIssue({
 						code: "duplicate-form-field-key",
@@ -3858,6 +4166,27 @@ const validateSurveyOperations = ({ operations, snapshot: snapshotInput }) => {
 				}
 				options[optionIndex] = { ...options[optionIndex] };
 				if (normalized.kind === "set-embedded-form") {
+					const layoutIssue = getInvalidFormLayoutIssue({
+						fieldGroups: normalized.form.fieldGroups,
+						itemId: item.itemId,
+						operationId,
+						operationIndex,
+						prefix: `embeddedForms.${normalized.optionId}.fieldGroups`
+					});
+					const contentIssue = getFormOperationContentIssue({
+						fieldGroups: normalized.form.fieldGroups,
+						itemId: item.itemId,
+						operationId,
+						operationIndex,
+						prefix: `embeddedForms.${normalized.optionId}.fields`,
+						snapshot,
+						translations: normalized.translations
+					});
+					if (layoutIssue || contentIssue) {
+						if (layoutIssue) issues.push(layoutIssue);
+						if (contentIssue) issues.push(contentIssue);
+						break;
+					}
 					options[optionIndex].embeddedForm = normalized.form;
 					for (const translation of normalized.translations ?? []) addIntroducedLocaleWarning({
 						locale: translation.locale,
@@ -4280,6 +4609,18 @@ var TurnChangeCollector = class {
 		const ambiguousModeOnly = modeRequired && !candidateWasRejected && continuationIssue?.code === "change-mode-required";
 		const shouldClearActive = continuationMode === "replace" || continuationIssue !== void 0 && !ambiguousModeOnly || candidateWasRejected;
 		const supersedesChangeIds = shouldClearActive ? [...this.#activeChangeSetIds] : [];
+		const recovery = continuationIssue !== void 0 || candidateWasRejected ? ambiguousModeOnly ? {
+			turnAuthorization: "blocked",
+			candidateAuthorization: "not-authorized",
+			requiredAction: "choose-continuation-mode",
+			allowedContinuationModes: ["append", "replace"]
+		} : {
+			turnAuthorization: "blocked",
+			candidateAuthorization: "not-authorized",
+			requiredAction: "resubmit-complete-proposal",
+			allowedContinuationModes: ["replace"],
+			requiredContinuationMode: "replace"
+		} : void 0;
 		const registered = surveyChangeSetSchema.parse({
 			...candidate,
 			turnId: this.turnId,
@@ -4291,7 +4632,8 @@ var TurnChangeCollector = class {
 					issues: [...candidate.validation.issues, continuationIssue]
 				}
 			} : {},
-			...supersedesChangeIds.length > 0 ? { supersedesChangeIds } : {}
+			...supersedesChangeIds.length > 0 ? { supersedesChangeIds } : {},
+			...recovery ? { recovery } : {}
 		});
 		this.#candidates.set(registered.id, registered);
 		const isValidated = registered.status === "validated" && registered.validation.valid;
@@ -4840,7 +5182,7 @@ const auditSurvey = (context, options = {}) => {
 			total: 0
 		}),
 		metrics: {
-			itemCount: items.length,
+			itemCount: context.inspection.itemCount,
 			localeCount: locales.length,
 			responseSlotCount: context.inspection.responseSlots.length,
 			assetCount: Object.keys(assets).length,
@@ -4854,4 +5196,4 @@ const auditSurvey = (context, options = {}) => {
 //#endregion
 export { deriveResponseSlotTypes as $, getRawSurvey$1 as A, resolveItemSummary as B, clampLimit as C, formFieldGroupLayoutSchema as D, formFieldGroupDetailsSchema as E, mapKeyIndexById as F, summarizeKeyIndexEntry as G, summarizeFocusItemNode as H, mapOutlineById as I, translationEntrySchema as J, summarizeOutlineNode as K, mapRawItemsById as L, itemConfigDetailsSchema as M, itemMatchesQuery as N, formSelectOptionDetailsSchema as O, itemSummarySchema as P, createSurveyAssistantEngineContext as Q, normalizeText as R, choiceOptionDetailsSchema as S, formFieldDetailsSchema as T, summarizeItemById as U, sliceWithCursor as V, summarizeKeyIndexEntries as W, inferExpressionReturnType as X, unique as Y, validateExpression as Z, buildConfigSearchText as _, SURVEY_CHANGE_CONTINUATION_MODES as a, buildItemTranslationEntries as b, buildSurveyDocumentVersion as c, normalizeSurveyChangeOperations as d, buildExpressionMutationPatches as f, MAX_LIMIT as g, DEFAULT_LIMIT as h, SURVEY_CHANGE_CONTINUATION_DESCRIPTION as i, getRawSurveyItems as j, getKeyIndexEntries as k, createSurveyChangeSet as l, expressionSchema as m, SurveyAssistantTaskResultCache as n, TurnChangeCollector as o, expressionMutationSchema as p, summarizeRawItem as q, buildSurveyAssistantTaskContext as r, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL as s, auditSurvey as t, validateSurveyOperations as u, buildEmbeddedFormDetails as v, findDirectChildrenByFullKey as w, buildSurveyTranslations as x, buildItemConfigDetails as y, parseCursor as z };
 
-//# sourceMappingURL=engine-sPvuixWg.mjs.map
+//# sourceMappingURL=engine-DQrCO_ur.mjs.map