@case-framework/survey-core 0.1.0 → 0.3.0

package/build/editor.mjs

@@ -1,5 +1,305 @@
-import { D as structuredCloneMethod, T as generateId, n as GroupItemCore, r as SurveyItemTranslations, s as ReservedSurveyItemTypes, t as Survey } from "./survey-C3ZHI-5z.mjs";
-
+import { I as generateId, R as structuredCloneMethod, l as GroupItemCore, m as ReservedSurveyItemTypes, n as SurveyItemTranslations, t as Survey } from "./survey-DJbgFVPz.mjs";
+//#region src/editor/ai-context.ts
+const DEFAULT_SCOPE_LIMITS = {
+	tiny: 40,
+	focused: 150,
+	full: 500
+};
+const DEFAULT_FOCUS_TREE_LIMIT = 120;
+const DEFAULT_TRANSLATION_SNIPPETS_PER_ITEM = 8;
+const DEFAULT_TRANSLATION_SNIPPET_TEXT_LIMIT = 120;
+const PURPOSE_DEFAULTS = {
+	generic: {
+		scope: "tiny",
+		includeRawSurvey: false,
+		includeIndexes: false,
+		includeFocusItemTree: false
+	},
+	"key-suggestion": {
+		scope: "tiny",
+		includeRawSurvey: false,
+		includeIndexes: false,
+		includeFocusItemTree: true
+	},
+	"label-suggestion": {
+		scope: "tiny",
+		includeRawSurvey: false,
+		includeIndexes: false,
+		includeFocusItemTree: true
+	},
+	"item-generation": {
+		scope: "focused",
+		includeRawSurvey: false,
+		includeIndexes: true,
+		includeFocusItemTree: true
+	},
+	translation: {
+		scope: "focused",
+		includeRawSurvey: false,
+		includeIndexes: true,
+		includeFocusItemTree: true
+	},
+	"condition-management": {
+		scope: "full",
+		includeRawSurvey: true,
+		includeIndexes: true,
+		includeFocusItemTree: true
+	}
+};
+const sortByItemId = (items) => [...items].sort((a, b) => a.itemId.localeCompare(b.itemId));
+function getChildIds(survey, itemId) {
+	const item = survey.surveyItems.get(itemId);
+	if (!(item instanceof GroupItemCore)) return [];
+	return [...item.items ?? []];
+}
+function buildParentLookup(survey) {
+	const lookup = /* @__PURE__ */ new Map();
+	for (const item of survey.surveyItems.values()) {
+		if (!(item instanceof GroupItemCore)) continue;
+		for (const childId of item.items ?? []) lookup.set(childId, item.id);
+	}
+	return lookup;
+}
+function createFullKeyGetter(survey, parentLookup) {
+	const fullKeyCache = /* @__PURE__ */ new Map();
+	const getFullKey = (itemId, stack = /* @__PURE__ */ new Set()) => {
+		const cached = fullKeyCache.get(itemId);
+		if (cached) return cached;
+		const item = survey.surveyItems.get(itemId);
+		if (!item) return itemId;
+		if (stack.has(itemId)) return item.key;
+		const parentId = parentLookup.get(itemId);
+		if (!parentId) {
+			fullKeyCache.set(itemId, item.key);
+			return item.key;
+		}
+		stack.add(itemId);
+		const parentFullKey = getFullKey(parentId, stack);
+		stack.delete(itemId);
+		const fullKey = `${parentFullKey}.${item.key}`;
+		fullKeyCache.set(itemId, fullKey);
+		return fullKey;
+	};
+	return getFullKey;
+}
+function buildFullOutline(survey, parentLookup, getFullKey) {
+	const outline = [];
+	const visited = /* @__PURE__ */ new Set();
+	const toNode = (itemId, depth) => {
+		const item = survey.surveyItems.get(itemId);
+		if (!item) return;
+		const childCount = item instanceof GroupItemCore ? item.items.length : 0;
+		return {
+			itemId,
+			parentId: parentLookup.get(itemId),
+			depth,
+			itemType: item.type,
+			key: item.key,
+			fullKey: getFullKey(itemId),
+			itemLabel: item.metadata?.itemLabel,
+			childCount
+		};
+	};
+	const visit = (itemId, depth) => {
+		if (visited.has(itemId)) return;
+		visited.add(itemId);
+		const node = toNode(itemId, depth);
+		if (node) outline.push(node);
+		for (const childId of getChildIds(survey, itemId)) visit(childId, depth + 1);
+	};
+	const root = survey.rootItem;
+	if (root) visit(root.id, 0);
+	const remaining = sortByItemId(Array.from(survey.surveyItems.values()).filter((item) => !visited.has(item.id)).map((item) => ({ itemId: item.id })));
+	for (const item of remaining) visit(item.itemId, 0);
+	return outline;
+}
+function collectTinyScopeIds(survey, focusItemId) {
+	const ids = /* @__PURE__ */ new Set();
+	const rootItem = survey.rootItem;
+	if (rootItem) ids.add(rootItem.id);
+	ids.add(focusItemId);
+	for (const id of survey.getItemPath(focusItemId)) ids.add(id);
+	for (const sibling of survey.getSiblings(focusItemId)) ids.add(sibling.id);
+	for (const childId of getChildIds(survey, focusItemId)) ids.add(childId);
+	return ids;
+}
+function addDescendants(survey, itemId, set, maxDepth) {
+	const queue = [{
+		id: itemId,
+		depth: 0
+	}];
+	while (queue.length > 0) {
+		const current = queue.shift();
+		if (!current) continue;
+		if (current.depth >= maxDepth) continue;
+		for (const childId of getChildIds(survey, current.id)) {
+			set.add(childId);
+			queue.push({
+				id: childId,
+				depth: current.depth + 1
+			});
+		}
+	}
+}
+function collectFocusedScopeIds(survey, focusItemId) {
+	const ids = collectTinyScopeIds(survey, focusItemId);
+	const ancestors = survey.getItemPath(focusItemId);
+	addDescendants(survey, focusItemId, ids, 2);
+	for (const sibling of survey.getSiblings(focusItemId)) {
+		if (sibling.id === focusItemId) continue;
+		ids.add(sibling.id);
+		addDescendants(survey, sibling.id, ids, 1);
+	}
+	for (const ancestorId of ancestors) {
+		const siblingIds = (survey.getParentItem(ancestorId)?.items ?? []).filter((id) => id !== ancestorId);
+		for (const siblingId of siblingIds) {
+			ids.add(siblingId);
+			addDescendants(survey, siblingId, ids, 1);
+		}
+	}
+	return ids;
+}
+function buildFocusInfo(survey, focusItemId) {
+	if (!survey.surveyItems.has(focusItemId)) return;
+	const pathItemIds = [...survey.getItemPath(focusItemId), focusItemId];
+	return {
+		focusItemId,
+		parentItemId: survey.getParentItem(focusItemId)?.id,
+		pathItemIds,
+		siblingItemIds: survey.getSiblings(focusItemId).filter((item) => item.id !== focusItemId).map((item) => item.id),
+		childItemIds: getChildIds(survey, focusItemId)
+	};
+}
+const normalizeSnippetText = (text, maxChars) => {
+	return text.trim().replace(/\s+/g, " ").slice(0, maxChars);
+};
+const getContentText = (content, maxChars) => {
+	if (!content) return null;
+	const maybeText = content.content;
+	if (typeof maybeText !== "string") return null;
+	const normalized = normalizeSnippetText(maybeText, maxChars);
+	return normalized.length > 0 ? normalized : null;
+};
+function getItemTranslationSnippets(survey, itemId, maxSnippets, textLimit) {
+	const snippets = [];
+	const translations = survey.getItemTranslations(itemId);
+	if (!translations) return snippets;
+	for (const locale of translations.locales) {
+		const localeContent = translations.getAllForLocale(locale);
+		if (!localeContent) continue;
+		for (const [contentKey, content] of Object.entries(localeContent)) {
+			const text = getContentText(content, textLimit);
+			if (!text) continue;
+			snippets.push({
+				locale,
+				contentKey,
+				text
+			});
+			if (snippets.length >= maxSnippets) return snippets;
+		}
+	}
+	return snippets;
+}
+function buildFocusItemTree(survey, focusItemId, getFullKey, options) {
+	if (!survey.surveyItems.has(focusItemId)) return { truncated: false };
+	let remainingBudget = options.treeLimit;
+	let truncated = false;
+	const visit = (itemId) => {
+		if (remainingBudget <= 0) {
+			truncated = true;
+			return;
+		}
+		const item = survey.surveyItems.get(itemId);
+		if (!item) return;
+		remainingBudget -= 1;
+		const siblingKeys = survey.getSiblings(itemId).filter((sibling) => sibling.id !== itemId).map((sibling) => sibling.key);
+		const descendants = [];
+		if (item instanceof GroupItemCore) for (const childId of item.items) {
+			const childNode = visit(childId);
+			if (childNode) descendants.push(childNode);
+		}
+		return {
+			itemId: item.id,
+			itemType: item.type,
+			itemKey: item.key,
+			fullKey: getFullKey(item.id),
+			itemLabel: item.metadata?.itemLabel,
+			siblingKeys,
+			translations: getItemTranslationSnippets(survey, item.id, options.snippetsPerItem, options.snippetTextLimit),
+			descendants
+		};
+	};
+	return {
+		focusItem: visit(focusItemId),
+		truncated
+	};
+}
+function buildContextIndexes(survey, fullOutline, purpose) {
+	const indexes = { keyIndex: fullOutline.map((node) => ({
+		itemId: node.itemId,
+		itemType: node.itemType,
+		key: node.key,
+		fullKey: node.fullKey,
+		itemLabel: node.itemLabel,
+		path: node.fullKey.split(".").slice(0, -1)
+	})) };
+	if (purpose === "condition-management") indexes.responseSlots = Object.keys(survey.getAvailableResponseValueSlots());
+	return indexes;
+}
+function buildSurveyAIContextPack(survey, options = {}) {
+	const purpose = options.purpose ?? "generic";
+	const purposeDefaults = PURPOSE_DEFAULTS[purpose];
+	const scope = options.scope ?? purposeDefaults.scope;
+	const defaultLimit = DEFAULT_SCOPE_LIMITS[scope];
+	const outlineLimit = Math.max(1, options.outlineLimit ?? defaultLimit);
+	const includeRawSurvey = options.includeRawSurvey ?? purposeDefaults.includeRawSurvey;
+	const includeIndexes = options.includeIndexes ?? purposeDefaults.includeIndexes;
+	const includeFocusItemTree = options.includeFocusItemTree ?? purposeDefaults.includeFocusItemTree;
+	const focusItemId = options.focusItemId;
+	const focusExists = Boolean(focusItemId && survey.surveyItems.has(focusItemId));
+	const parentLookup = buildParentLookup(survey);
+	const getFullKey = createFullKeyGetter(survey, parentLookup);
+	const fullOutline = buildFullOutline(survey, parentLookup, getFullKey);
+	let scopedOutline = fullOutline;
+	if (scope === "tiny" && focusItemId && focusExists) {
+		const includedIds = collectTinyScopeIds(survey, focusItemId);
+		scopedOutline = fullOutline.filter((node) => includedIds.has(node.itemId));
+	} else if (scope === "focused" && focusItemId && focusExists) {
+		const includedIds = collectFocusedScopeIds(survey, focusItemId);
+		scopedOutline = fullOutline.filter((node) => includedIds.has(node.itemId));
+	}
+	const outlineTruncated = scopedOutline.length > outlineLimit;
+	const outline = outlineTruncated ? scopedOutline.slice(0, outlineLimit) : scopedOutline;
+	let focusItemTreeTruncated = false;
+	let focusItem;
+	if (includeFocusItemTree && focusItemId && focusExists) {
+		const focusTreeResult = buildFocusItemTree(survey, focusItemId, getFullKey, {
+			treeLimit: Math.max(1, options.focusItemTreeLimit ?? DEFAULT_FOCUS_TREE_LIMIT),
+			snippetsPerItem: Math.max(1, options.translationSnippetsPerItemLimit ?? DEFAULT_TRANSLATION_SNIPPETS_PER_ITEM),
+			snippetTextLimit: Math.max(1, options.translationSnippetTextLimit ?? DEFAULT_TRANSLATION_SNIPPET_TEXT_LIMIT)
+		});
+		focusItemTreeTruncated = focusTreeResult.truncated;
+		focusItem = focusTreeResult.focusItem;
+	}
+	return {
+		purpose,
+		scope,
+		surveyKey: survey.surveyKey,
+		locales: [...survey.locales],
+		itemCount: survey.surveyItems.size,
+		outline,
+		focus: focusItemId ? buildFocusInfo(survey, focusItemId) : void 0,
+		focusItem,
+		indexes: includeIndexes ? buildContextIndexes(survey, fullOutline, purpose) : void 0,
+		flags: {
+			outlineTruncated,
+			rawSurveyIncluded: includeRawSurvey,
+			focusItemTreeTruncated
+		},
+		rawSurvey: includeRawSurvey ? survey.serialize() : void 0
+	};
+}
+//#endregion
 //#region src/editor/item-copy-paste.ts
 var ItemCopyPaste = class ItemCopyPaste {
 	survey;
@@ -200,7 +500,6 @@ var ItemCopyPaste = class ItemCopyPaste {
 		return clipboardData.type === "survey-item" && clipboardData.version === "1.0.0" && clipboardData.rootItemId !== void 0;
 	}
 };
-
 //#endregion
 //#region src/editor/undo-redo.ts
 const CommitSource = {
@@ -385,7 +684,6 @@ var SurveyEditorUndoRedo = class SurveyEditorUndoRedo {
 		return instance;
 	}
 };
-
 //#endregion
 //#region src/editor/survey-editor.ts
 var SurveyEditor = class SurveyEditor {
@@ -399,8 +697,11 @@ var SurveyEditor = class SurveyEditor {
 		this._pluginRegistry = pluginRegistry;
 		this._undoRedo = new SurveyEditorUndoRedo(survey.serialize(), undoRedoConfig, meta);
 	}
+	/** Returns an immutable copy of the current survey state. */
 	get survey() {
-		return this._survey;
+		const serialized = this._survey.serialize();
+		const registry = this._pluginRegistry ?? this._survey.getPluginRegistry();
+		return Survey.fromJson(serialized, registry);
 	}
 	get hasUncommittedChanges() {
 		return this._hasUncommittedChanges;
@@ -535,7 +836,7 @@ var SurveyEditor = class SurveyEditor {
 		if (target?.index !== void 0) insertIndex = Math.min(target.index, parentGroup.items.length);
 		else insertIndex = parentGroup.items.length;
 		this._survey.surveyItems.set(item.id, item);
-		parentGroup.items.splice(insertIndex, 0, item.id);
+		parentGroup.addChild(item.id, insertIndex);
 		if (content) this._survey.translations.setItemTranslations(item.id, content);
 	}
 	removeItem(itemId, nested = false) {
@@ -572,6 +873,51 @@ var SurveyEditor = class SurveyEditor {
 		targetGroup.items.splice(insertIndex, 0, itemId);
 		return true;
 	}
+	/**
+	* Get a deep copy of an item's raw data.
+	* The returned object is independent of the survey—mutating it will not affect the survey.
+	* Use this when you need to edit an item in a form or pass it to updateItem after modifications.
+	*
+	* @param itemId - The ID of the item to copy
+	* @returns A deep copy of the item's RawSurveyItem data
+	* @throws Error if the item is not found
+	*/
+	getItemDataCopy(itemId) {
+		const item = this._survey.surveyItems.get(itemId);
+		if (!item) throw new Error(`Item with id '${itemId}' not found`);
+		return JSON.parse(JSON.stringify(item.rawItem));
+	}
+	/**
+	* Update an item's data in the survey.
+	* Can update common attributes (displayConditions, disabledConditions, validations, etc.)
+	* as well as type-specific config.
+	*
+	* Use getItemDataCopy to obtain an editable copy, modify it, then pass it here.
+	* Alternatively, pass a Partial to merge specific fields (top-level keys only;
+	* e.g. config replaces the entire config object).
+	*
+	* @param itemId - The ID of the item to update (must match data.id if provided)
+	* @param rawItemData - Full RawSurveyItem or Partial to merge. The id cannot be changed.
+	*/
+	updateItem(itemId, rawItemData) {
+		const existingItem = this._survey.surveyItems.get(itemId);
+		if (!existingItem) throw new Error(`Item with id '${itemId}' not found`);
+		if ("id" in rawItemData && rawItemData.id !== void 0 && rawItemData.id !== itemId) throw new Error(`Cannot change item id from '${itemId}' to '${rawItemData.id}'`);
+		const merged = {
+			...existingItem.rawItem,
+			...rawItemData,
+			id: itemId
+		};
+		const newKey = merged.key ?? existingItem.key;
+		const parentGroup = this._survey.getParentItem(itemId);
+		if (parentGroup) {
+			const siblingWithSameKey = (parentGroup.items ?? []).filter((id) => id !== itemId).map((id) => this._survey.surveyItems.get(id)).find((s) => s !== void 0 && s.key === newKey);
+			if (siblingWithSameKey) throw new Error(`Key '${newKey}' is already in use by sibling item '${siblingWithSameKey.id}'`);
+		}
+		const newItem = this._survey.createItemFromRaw(merged);
+		this._survey.surveyItems.set(itemId, newItem);
+		this.markAsModified();
+	}
 	updateItemTranslations(itemId, updatedContent) {
 		this.markAsModified();
 		if (!this._survey.surveyItems.get(itemId)) throw new Error(`Item with id '${itemId}' not found`);
@@ -579,25 +925,96 @@ var SurveyEditor = class SurveyEditor {
 		return true;
 	}
 	/**
+	* Update survey-level translations that are not tied to specific items.
+	* Use these for survey card, navigation, validation messages, etc.
+	*/
+	updateSurveyTranslations(updates) {
+		this.markAsModified();
+		if (updates.surveyCard) this._survey.translations.setSurveyCardContent(updates.surveyCard.locale, updates.surveyCard.content);
+		if (updates.navigation) this._survey.translations.setNavigationContent(updates.navigation.locale, updates.navigation.content);
+		if (updates.validationMessages) this._survey.translations.setValidationMessages(updates.validationMessages.locale, updates.validationMessages.content);
+	}
+	/**
+	* Get maxItemsPerPage immutably (returns a copy).
+	*/
+	getMaxItemsPerPage() {
+		const val = this._survey.maxItemsPerPage;
+		return val ? { ...val } : void 0;
+	}
+	/**
+	* Update maxItemsPerPage.
+	*/
+	updateMaxItemsPerPage(value) {
+		this.markAsModified();
+		this._survey.maxItemsPerPage = value ? { ...value } : void 0;
+	}
+	/**
+	* Get metadata immutably (returns a copy).
+	*/
+	getMetadata() {
+		const val = this._survey.metadata;
+		return val ? { ...val } : void 0;
+	}
+	/**
+	* Update metadata.
+	*/
+	updateMetadata(metadata) {
+		this.markAsModified();
+		this._survey.metadata = metadata ? { ...metadata } : void 0;
+	}
+	/**
+	* Get a template value immutably (returns a deep copy).
+	*/
+	getTemplateValue(key) {
+		const val = this._survey.getTemplateValue(key);
+		return val ? structuredCloneMethod(val) : void 0;
+	}
+	/**
+	* Get all template values immutably (returns a new Map with deep-copied values).
+	*/
+	getTemplateValues() {
+		const keys = this._survey.getTemplateValueKeys();
+		const result = /* @__PURE__ */ new Map();
+		for (const key of keys) {
+			const val = this._survey.getTemplateValue(key);
+			if (val) result.set(key, structuredCloneMethod(val));
+		}
+		return result;
+	}
+	/**
+	* Add or replace a template value.
+	*/
+	setTemplateValue(key, templateValue) {
+		this.markAsModified();
+		this._survey.setTemplateValue(key, structuredCloneMethod(templateValue));
+	}
+	/**
+	* Remove a template value.
+	*/
+	removeTemplateValue(key) {
+		this.markAsModified();
+		this._survey.deleteTemplateValue(key);
+	}
+	/**
 	* Copy a survey item and all its data to clipboard format
-	* @param itemKey - The full key of the item to copy
+	* @param itemId - The ID of the item to copy
 	* @returns Clipboard data that can be serialized to JSON for clipboard
 	*/
-	copyItem(itemKey) {
-		return new ItemCopyPaste(this._survey).copyItem(itemKey);
+	copyItem(itemId) {
+		return new ItemCopyPaste(this._survey).copyItem(itemId);
 	}
 	/**
 	* Paste a survey item from clipboard data to a target location
 	* @param clipboardData - The clipboard data containing the item to paste
 	* @param target - Target location where to paste the item
-	* @returns The full key of the pasted item
+	* @returns The ID of the pasted item
 	*/
 	pasteItem(clipboardData, target) {
 		this.markAsModified();
 		return new ItemCopyPaste(this._survey).pasteItem(clipboardData, target);
 	}
 };
-
 //#endregion
-export { CommitSource, ItemCopyPaste, SurveyEditor, SurveyEditorUndoRedo };
+export { CommitSource, ItemCopyPaste, SurveyEditor, SurveyEditorUndoRedo, buildSurveyAIContextPack };
+
 //# sourceMappingURL=editor.mjs.map