@case-framework/survey-items 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# `@case-framework/survey-items`
+
+Headless domain models for the standard CASE survey item types. This package is
+shared by participant, editor, and assistant integrations and contains no
+React, editor, assistant, server, or localization dependencies.
+
+Import only the item-family entry point you need:
+
+```ts
+import {
+  createChoiceItemConfig,
+  normalizeChoiceItemConfig,
+} from "@case-framework/survey-items/choice";
+
+const config = normalizeChoiceItemConfig(rawConfig, itemId);
+```
+
+Choice configuration uses the canonical embedded-form model from
+`@case-framework/survey-items/form`. Import that entry point directly for form
+types, normalization, translation keys, defaults, layout helpers, and
+authoring-mode transitions.

package/dist/choice.d.mts

@@ -0,0 +1,36 @@
+import { FormItemConfig } from "./form.mjs";
+import { ValueType } from "@case-framework/survey-core";
+
+//#region src/choice.d.ts
+/** `1` = single selection (radio). `null` = multiple selection with no upper cap. Integers above 1 cap how many options may be selected. */
+type ChoiceMaxSelection = number | null;
+interface ChoiceOptionConfig {
+  id: string;
+  key?: string;
+  hasDisplayCondition?: boolean;
+  embeddedFormItemId?: string;
+  embeddedForm?: FormItemConfig;
+}
+interface ChoiceItemConfig {
+  id: string;
+  maxSelection: ChoiceMaxSelection;
+  shuffleOptions: boolean;
+  options: ChoiceOptionConfig[];
+}
+declare function choiceIsSingleSelect(maxSelection: ChoiceMaxSelection): boolean;
+declare function getChoiceResponseValueType(maxSelection: ChoiceMaxSelection): ValueType;
+declare function createChoiceItemConfig(itemId: string): ChoiceItemConfig;
+declare function getChoiceOptionLabelContentKey(optionId: string): string;
+declare function getChoiceOptionEmbeddedFormTranslationPrefix(optionId: string): string;
+declare function getChoiceOptionEmbeddedFormResponseSlotPrefix(optionId: string): string;
+declare function getChoiceOptionEmbeddedFormResponseSlotId(optionId: string, fieldKey: string): string;
+declare function getChoiceOptionEmbeddedFormResponseKeyPathSegment(option: Pick<ChoiceOptionConfig, "id" | "key">): string;
+declare function choiceOptionHasEmbeddedForm(option: Pick<ChoiceOptionConfig, "embeddedFormItemId" | "embeddedForm">): boolean;
+declare function normalizeChoiceOptionKey(value: string): string;
+declare function normalizeChoiceItemConfig(rawConfig: unknown, itemId: string): ChoiceItemConfig;
+declare function createChoiceOptionConfig(existingOptions: ChoiceOptionConfig[]): ChoiceOptionConfig;
+declare function createDuplicatedChoiceOptionConfig(option: ChoiceOptionConfig, existingOptions: ChoiceOptionConfig[]): ChoiceOptionConfig;
+declare function getDisplayOrder<T>(items: readonly T[], shouldShuffle: boolean, seed: string): T[];
+//#endregion
+export { ChoiceItemConfig, ChoiceMaxSelection, ChoiceOptionConfig, choiceIsSingleSelect, choiceOptionHasEmbeddedForm, createChoiceItemConfig, createChoiceOptionConfig, createDuplicatedChoiceOptionConfig, getChoiceOptionEmbeddedFormResponseKeyPathSegment, getChoiceOptionEmbeddedFormResponseSlotId, getChoiceOptionEmbeddedFormResponseSlotPrefix, getChoiceOptionEmbeddedFormTranslationPrefix, getChoiceOptionLabelContentKey, getChoiceResponseValueType, getDisplayOrder, normalizeChoiceItemConfig, normalizeChoiceOptionKey };
+//# sourceMappingURL=choice.d.mts.map

package/dist/choice.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice.d.mts","names":[],"sources":["../src/choice.ts"],"mappings":";;;;;KAUY,kBAAA;AAAA,UAEK,kBAAA;EACf,EAAA;EACA,GAAA;EACA,mBAAA;EACA,kBAAA;EACA,YAAA,GAAe,cAAA;AAAA;AAAA,UAGA,gBAAA;EACf,EAAA;EACA,YAAA,EAAc,kBAAA;EACd,cAAA;EACA,OAAA,EAAS,kBAAA;AAAA;AAAA,iBAGK,oBAAA,CAAqB,YAAA,EAAc,kBAAA;AAAA,iBAInC,0BAAA,CAA2B,YAAA,EAAc,kBAAA,GAAqB,SAAA;AAAA,iBAI9D,sBAAA,CAAuB,MAAA,WAAiB,gBAAA;AAAA,iBASxC,8BAAA,CAA+B,QAAA;AAAA,iBAI/B,4CAAA,CAA6C,QAAA;AAAA,iBAI7C,6CAAA,CAA8C,QAAA;AAAA,iBAI9C,yCAAA,CACd,QAAA,UACA,QAAA;AAAA,iBAKc,iDAAA,CACd,MAAA,EAAQ,IAAA,CAAK,kBAAA;AAAA,iBAKC,2BAAA,CACd,MAAA,EAAQ,IAAA,CAAK,kBAAA;AAAA,iBAKC,wBAAA,CAAyB,KAAA;AAAA,iBAuDzB,yBAAA,CAA0B,SAAA,WAAoB,MAAA,WAAiB,gBAAA;AAAA,iBAiB/D,wBAAA,CACd,eAAA,EAAiB,kBAAA,KAChB,kBAAA;AAAA,iBAea,kCAAA,CACd,MAAA,EAAQ,kBAAA,EACR,eAAA,EAAiB,kBAAA,KAChB,kBAAA;AAAA,iBAWa,eAAA,GAAA,CAAmB,KAAA,WAAgB,CAAA,IAAK,aAAA,WAAwB,IAAA,WAAe,CAAA"}

package/dist/choice.mjs

@@ -0,0 +1,103 @@
+import { normalizeFormItemConfig } from "./form.mjs";
+import { ValueType, createSeededRandom, generateId, shuffleArray, structuredCloneMethod } from "@case-framework/survey-core";
+//#region src/choice.ts
+function choiceIsSingleSelect(maxSelection) {
+	return maxSelection === 1;
+}
+function getChoiceResponseValueType(maxSelection) {
+	return choiceIsSingleSelect(maxSelection) ? ValueType.reference : ValueType.referenceArray;
+}
+function createChoiceItemConfig(itemId) {
+	return {
+		id: itemId,
+		maxSelection: 1,
+		shuffleOptions: false,
+		options: []
+	};
+}
+function getChoiceOptionLabelContentKey(optionId) {
+	return `options.${optionId}.label`;
+}
+function getChoiceOptionEmbeddedFormTranslationPrefix(optionId) {
+	return `embeddedForms.${optionId}`;
+}
+function getChoiceOptionEmbeddedFormResponseSlotPrefix(optionId) {
+	return `embedded.${optionId}`;
+}
+function getChoiceOptionEmbeddedFormResponseSlotId(optionId, fieldKey) {
+	return `${getChoiceOptionEmbeddedFormResponseSlotPrefix(optionId)}.${fieldKey}`;
+}
+function getChoiceOptionEmbeddedFormResponseKeyPathSegment(option) {
+	return normalizeChoiceOptionKey(option.key ?? "") || option.id;
+}
+function choiceOptionHasEmbeddedForm(option) {
+	return Boolean(option.embeddedFormItemId || option.embeddedForm?.fieldGroups.length);
+}
+function normalizeChoiceOptionKey(value) {
+	return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+}
+function normalizeChoiceOptionConfig(rawOption) {
+	if (!rawOption || typeof rawOption !== "object") return null;
+	const option = rawOption;
+	const trimmedId = typeof option.id === "string" ? option.id.trim() : "";
+	if (!trimmedId) return null;
+	const trimmedKey = typeof option.key === "string" ? option.key.trim() : "";
+	const trimmedEmbeddedFormItemId = typeof option.embeddedFormItemId === "string" ? option.embeddedFormItemId.trim() : "";
+	return {
+		id: trimmedId,
+		key: trimmedKey || void 0,
+		hasDisplayCondition: option.hasDisplayCondition === true ? true : void 0,
+		embeddedFormItemId: trimmedEmbeddedFormItemId || void 0,
+		embeddedForm: option.embeddedForm ? normalizeFormItemConfig(option.embeddedForm, trimmedId) : void 0
+	};
+}
+function normalizeMaxSelection(config) {
+	const hasMaxSelectionKey = "maxSelection" in config && config.maxSelection !== void 0;
+	const rawMax = config.maxSelection;
+	if (rawMax === null) return null;
+	if (typeof rawMax === "number" && Number.isFinite(rawMax)) {
+		const n = Math.floor(rawMax);
+		return n >= 1 ? n : 1;
+	}
+	if (typeof rawMax === "string") {
+		const parsed = Number.parseInt(rawMax.trim(), 10);
+		if (Number.isFinite(parsed) && parsed >= 1) return parsed;
+	}
+	if (!hasMaxSelectionKey && config.mode === "multiple") return null;
+	return 1;
+}
+function normalizeChoiceItemConfig(rawConfig, itemId) {
+	const config = rawConfig ?? {};
+	return {
+		id: typeof config.id === "string" && config.id.trim() ? config.id : itemId,
+		maxSelection: normalizeMaxSelection(config),
+		shuffleOptions: config.shuffleOptions === true,
+		options: Array.isArray(config.options) ? config.options.map((option) => normalizeChoiceOptionConfig(option)).filter((option) => option !== null) : []
+	};
+}
+function createChoiceOptionConfig(existingOptions) {
+	const usedNumbers = new Set(existingOptions.map((option) => normalizeChoiceOptionKey(option.key ?? "").match(/^opt_(\d+)$/)?.[1]).filter((value) => value !== void 0).map((value) => Number.parseInt(value, 10)).filter((value) => Number.isFinite(value)));
+	let nextNumber = 1;
+	while (usedNumbers.has(nextNumber)) nextNumber += 1;
+	return {
+		id: generateId(),
+		key: `opt_${nextNumber}`
+	};
+}
+function createDuplicatedChoiceOptionConfig(option, existingOptions) {
+	const generatedOption = createChoiceOptionConfig(existingOptions);
+	return {
+		...option,
+		id: generatedOption.id,
+		key: generatedOption.key,
+		embeddedForm: option.embeddedForm ? structuredCloneMethod(option.embeddedForm) : void 0
+	};
+}
+function getDisplayOrder(items, shouldShuffle, seed) {
+	if (!shouldShuffle || items.length < 2) return [...items];
+	return shuffleArray(items, createSeededRandom(seed));
+}
+//#endregion
+export { choiceIsSingleSelect, choiceOptionHasEmbeddedForm, createChoiceItemConfig, createChoiceOptionConfig, createDuplicatedChoiceOptionConfig, getChoiceOptionEmbeddedFormResponseKeyPathSegment, getChoiceOptionEmbeddedFormResponseSlotId, getChoiceOptionEmbeddedFormResponseSlotPrefix, getChoiceOptionEmbeddedFormTranslationPrefix, getChoiceOptionLabelContentKey, getChoiceResponseValueType, getDisplayOrder, normalizeChoiceItemConfig, normalizeChoiceOptionKey };
+
+//# sourceMappingURL=choice.mjs.map

package/dist/choice.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice.mjs","names":[],"sources":["../src/choice.ts"],"sourcesContent":["import {\n  createSeededRandom,\n  generateId,\n  shuffleArray,\n  structuredCloneMethod,\n  ValueType,\n} from \"@case-framework/survey-core\";\nimport { normalizeFormItemConfig, type FormItemConfig } from \"./form\";\n\n/** `1` = single selection (radio). `null` = multiple selection with no upper cap. Integers above 1 cap how many options may be selected. */\nexport type ChoiceMaxSelection = number | null;\n\nexport interface ChoiceOptionConfig {\n  id: string;\n  key?: string;\n  hasDisplayCondition?: boolean;\n  embeddedFormItemId?: string;\n  embeddedForm?: FormItemConfig;\n}\n\nexport interface ChoiceItemConfig {\n  id: string;\n  maxSelection: ChoiceMaxSelection;\n  shuffleOptions: boolean;\n  options: ChoiceOptionConfig[];\n}\n\nexport function choiceIsSingleSelect(maxSelection: ChoiceMaxSelection): boolean {\n  return maxSelection === 1;\n}\n\nexport function getChoiceResponseValueType(maxSelection: ChoiceMaxSelection): ValueType {\n  return choiceIsSingleSelect(maxSelection) ? ValueType.reference : ValueType.referenceArray;\n}\n\nexport function createChoiceItemConfig(itemId: string): ChoiceItemConfig {\n  return {\n    id: itemId,\n    maxSelection: 1,\n    shuffleOptions: false,\n    options: [],\n  };\n}\n\nexport function getChoiceOptionLabelContentKey(optionId: string): string {\n  return `options.${optionId}.label`;\n}\n\nexport function getChoiceOptionEmbeddedFormTranslationPrefix(optionId: string): string {\n  return `embeddedForms.${optionId}`;\n}\n\nexport function getChoiceOptionEmbeddedFormResponseSlotPrefix(optionId: string): string {\n  return `embedded.${optionId}`;\n}\n\nexport function getChoiceOptionEmbeddedFormResponseSlotId(\n  optionId: string,\n  fieldKey: string,\n): string {\n  return `${getChoiceOptionEmbeddedFormResponseSlotPrefix(optionId)}.${fieldKey}`;\n}\n\nexport function getChoiceOptionEmbeddedFormResponseKeyPathSegment(\n  option: Pick<ChoiceOptionConfig, \"id\" | \"key\">,\n): string {\n  return normalizeChoiceOptionKey(option.key ?? \"\") || option.id;\n}\n\nexport function choiceOptionHasEmbeddedForm(\n  option: Pick<ChoiceOptionConfig, \"embeddedFormItemId\" | \"embeddedForm\">,\n): boolean {\n  return Boolean(option.embeddedFormItemId || option.embeddedForm?.fieldGroups.length);\n}\n\nexport function normalizeChoiceOptionKey(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"_\")\n    .replace(/_+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n}\n\nfunction normalizeChoiceOptionConfig(rawOption: unknown): ChoiceOptionConfig | null {\n  if (!rawOption || typeof rawOption !== \"object\") {\n    return null;\n  }\n\n  const option = rawOption as Partial<ChoiceOptionConfig>;\n  const trimmedId = typeof option.id === \"string\" ? option.id.trim() : \"\";\n  if (!trimmedId) {\n    return null;\n  }\n\n  const trimmedKey = typeof option.key === \"string\" ? option.key.trim() : \"\";\n  const trimmedEmbeddedFormItemId =\n    typeof option.embeddedFormItemId === \"string\" ? option.embeddedFormItemId.trim() : \"\";\n\n  return {\n    id: trimmedId,\n    key: trimmedKey || undefined,\n    hasDisplayCondition: option.hasDisplayCondition === true ? true : undefined,\n    embeddedFormItemId: trimmedEmbeddedFormItemId || undefined,\n    embeddedForm: option.embeddedForm\n      ? normalizeFormItemConfig(option.embeddedForm, trimmedId)\n      : undefined,\n  };\n}\n\nfunction normalizeMaxSelection(config: {\n  maxSelection?: unknown;\n  mode?: \"single\" | \"multiple\";\n}): ChoiceMaxSelection {\n  const hasMaxSelectionKey = \"maxSelection\" in config && config.maxSelection !== undefined;\n  const rawMax = config.maxSelection;\n\n  if (rawMax === null) return null;\n  if (typeof rawMax === \"number\" && Number.isFinite(rawMax)) {\n    const n = Math.floor(rawMax);\n    return n >= 1 ? n : 1;\n  }\n  if (typeof rawMax === \"string\") {\n    const parsed = Number.parseInt(rawMax.trim(), 10);\n    if (Number.isFinite(parsed) && parsed >= 1) return parsed;\n  }\n  if (!hasMaxSelectionKey && config.mode === \"multiple\") return null;\n  return 1;\n}\n\nexport function normalizeChoiceItemConfig(rawConfig: unknown, itemId: string): ChoiceItemConfig {\n  const config = (rawConfig ?? {}) as Partial<ChoiceItemConfig> & {\n    mode?: \"single\" | \"multiple\";\n  };\n\n  return {\n    id: typeof config.id === \"string\" && config.id.trim() ? config.id : itemId,\n    maxSelection: normalizeMaxSelection(config),\n    shuffleOptions: config.shuffleOptions === true,\n    options: Array.isArray(config.options)\n      ? config.options\n          .map((option) => normalizeChoiceOptionConfig(option))\n          .filter((option): option is ChoiceOptionConfig => option !== null)\n      : [],\n  };\n}\n\nexport function createChoiceOptionConfig(\n  existingOptions: ChoiceOptionConfig[],\n): ChoiceOptionConfig {\n  const usedNumbers = new Set(\n    existingOptions\n      .map((option) => normalizeChoiceOptionKey(option.key ?? \"\").match(/^opt_(\\d+)$/)?.[1])\n      .filter((value): value is string => value !== undefined)\n      .map((value) => Number.parseInt(value, 10))\n      .filter((value) => Number.isFinite(value)),\n  );\n\n  let nextNumber = 1;\n  while (usedNumbers.has(nextNumber)) nextNumber += 1;\n\n  return { id: generateId(), key: `opt_${nextNumber}` };\n}\n\nexport function createDuplicatedChoiceOptionConfig(\n  option: ChoiceOptionConfig,\n  existingOptions: ChoiceOptionConfig[],\n): ChoiceOptionConfig {\n  const generatedOption = createChoiceOptionConfig(existingOptions);\n\n  return {\n    ...option,\n    id: generatedOption.id,\n    key: generatedOption.key,\n    embeddedForm: option.embeddedForm ? structuredCloneMethod(option.embeddedForm) : undefined,\n  };\n}\n\nexport function getDisplayOrder<T>(items: readonly T[], shouldShuffle: boolean, seed: string): T[] {\n  if (!shouldShuffle || items.length < 2) return [...items];\n  return shuffleArray(items, createSeededRandom(seed));\n}\n"],"mappings":"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"}

package/dist/form.d.mts

@@ -0,0 +1,187 @@
+import { SurveyItemTranslations, ValueType } from "@case-framework/survey-core";
+
+//#region src/form.d.ts
+type FormFieldType = "input" | "textarea" | "number" | "datepicker" | "switch" | "select" | "slider";
+declare const FORM_DATEPICKER_FIELD_MODES: readonly ["year", "year-month", "year-month-day"];
+type FormDatepickerFieldMode = (typeof FORM_DATEPICKER_FIELD_MODES)[number];
+declare function getFormFieldValueType(field: {
+  type?: unknown;
+}): ValueType;
+type FormFieldValidationType = "required" | "minLength" | "maxLength" | "pattern" | "email" | "url" | "integer" | "min" | "max" | "minDate" | "maxDate" | "mustBeTrue";
+interface FormFieldValidationConfig {
+  id: string;
+  type: FormFieldValidationType;
+  value?: number | string;
+  message?: string;
+}
+type FormFieldEffectiveValidationType = "required" | FormFieldValidationType;
+interface FormFieldEffectiveValidationConfig {
+  id: string;
+  type: FormFieldEffectiveValidationType;
+  value?: number | string;
+  message?: string;
+  source: "required" | "validation";
+}
+interface FormFieldSelectOptionConfig {
+  id: string;
+  value: string;
+  label?: string;
+}
+interface FormInputFieldControlConfig {
+  type: "input";
+  placeholder?: string;
+  inputMode?: "text" | "email" | "tel" | "url" | "password";
+  autocomplete?: string;
+}
+interface FormTextareaFieldControlConfig {
+  type: "textarea";
+  placeholder?: string;
+  rows?: number;
+}
+interface FormNumberFieldControlConfig {
+  type: "number";
+  placeholder?: string;
+  step?: number;
+  unit?: string;
+  defaultValue?: number;
+}
+interface FormDatepickerFieldControlConfig {
+  type: "datepicker";
+  placeholder?: string;
+  mode: FormDatepickerFieldMode;
+}
+interface FormSwitchFieldControlConfig {
+  type: "switch";
+  checkedLabel?: string;
+  uncheckedLabel?: string;
+  defaultChecked?: boolean;
+}
+interface FormSelectFieldControlConfig {
+  type: "select";
+  placeholder?: string;
+  allowClear?: boolean;
+  options: FormFieldSelectOptionConfig[];
+}
+interface FormSliderFieldControlConfig {
+  type: "slider";
+  min?: number;
+  max?: number;
+  step?: number;
+  defaultValue?: number;
+  showValue?: boolean;
+}
+type FormFieldControlConfig = FormInputFieldControlConfig | FormTextareaFieldControlConfig | FormNumberFieldControlConfig | FormDatepickerFieldControlConfig | FormSwitchFieldControlConfig | FormSelectFieldControlConfig | FormSliderFieldControlConfig;
+interface FormFieldConfig {
+  id: string;
+  key: string;
+  type: FormFieldType;
+  label?: string;
+  description?: string;
+  errorMessage?: string;
+  required?: boolean;
+  controller: FormFieldControlConfig;
+  validations: FormFieldValidationConfig[];
+  hasValidations?: boolean;
+  isInvalid?: boolean;
+}
+declare function getFormFieldEffectiveValidations(field: Pick<FormFieldConfig, "id" | "required" | "validations">): FormFieldEffectiveValidationConfig[];
+/**
+ * Column counts keyed by field group card width (container), not the viewport.
+ * Breakpoints match `@container (width >= …)` on `form-field-group`: 20rem / 24rem / 28rem / 36rem.
+ */
+interface FormFieldGroupLayoutConfig {
+  /** Below @xs (under 20rem) */
+  base: number;
+  /** @xs — width >= 20rem */
+  xs: number;
+  /** @sm — width >= 24rem */
+  sm: number;
+  /** @md — width >= 28rem */
+  md: number;
+  /** @xl — width >= 36rem */
+  xl: number;
+}
+interface FormFieldGroupConfig {
+  id: string;
+  title?: string;
+  description?: string;
+  hasDisplayCondition?: boolean;
+  layout: FormFieldGroupLayoutConfig;
+  fields: FormFieldConfig[];
+}
+interface FormItemConfig {
+  id: string;
+  /** Editor-facing complexity level; it does not change participant behavior. */
+  authoringMode: "simple" | "custom";
+  fieldGroups: FormFieldGroupConfig[];
+}
+declare function createFormItemConfig(itemId: string): FormItemConfig;
+declare function getFormFieldGroupTranslationPrefix(groupId: string, translationNamespace?: string): string;
+declare function getFormFieldGroupTitleContentKey(groupId: string, translationNamespace?: string): string;
+declare function getFormFieldGroupDescriptionContentKey(groupId: string, translationNamespace?: string): string;
+declare function getFormFieldTranslationPrefix(fieldId: string, translationNamespace?: string): string;
+declare function getFormFieldLabelContentKey(fieldId: string, translationNamespace?: string): string;
+declare function getFormFieldDescriptionContentKey(fieldId: string, translationNamespace?: string): string;
+declare function getFormFieldErrorMessageContentKey(fieldId: string, translationNamespace?: string): string;
+declare function getFormFieldPlaceholderContentKey(fieldId: string, translationNamespace?: string): string;
+declare function getFormFieldUnitContentKey(fieldId: string, translationNamespace?: string): string;
+declare function getFormFieldCheckedLabelContentKey(fieldId: string, translationNamespace?: string): string;
+declare function getFormFieldUncheckedLabelContentKey(fieldId: string, translationNamespace?: string): string;
+declare function getFormFieldOptionLabelContentKey(fieldId: string, optionId: string, translationNamespace?: string): string;
+declare function getFormFieldValidationMessageContentKey(fieldId: string, validationId: string, translationNamespace?: string): string;
+declare function getFormFieldTranslationKeys(field: Pick<FormFieldConfig, "id" | "type" | "controller" | "validations">, translationNamespace?: string): string[];
+declare function getFormFieldGroupTranslationKeys(group: Pick<FormFieldGroupConfig, "id">, translationNamespace?: string): string[];
+declare function writeFormFieldGroupTranslations(itemTranslations: SurveyItemTranslations, locale: string, group: Pick<FormFieldGroupConfig, "id" | "title" | "description">, translationNamespace?: string): void;
+declare function writeFormFieldTranslations(itemTranslations: SurveyItemTranslations, locale: string, field: Pick<FormFieldConfig, "id" | "type" | "label" | "description" | "errorMessage" | "controller" | "validations">, translationNamespace?: string): void;
+declare function withFormItemTranslatedContent(config: FormItemConfig, itemTranslations: SurveyItemTranslations | undefined, locale: string, options?: {
+  fallbackLocale?: string;
+  translationNamespace?: string;
+}): FormItemConfig;
+declare function withoutFormItemTranslatedContent(config: FormItemConfig): FormItemConfig;
+/** CSS custom properties for `.form-field-group-layout-scope` + `.form-field-group-grid`. */
+declare function formFieldGroupLayoutCssVars(layout: FormFieldGroupLayoutConfig): Record<string, string>;
+declare function normalizeFormItemConfig(rawConfig: unknown, itemId: string): FormItemConfig;
+declare function createFormFieldGroupConfig(): FormFieldGroupConfig;
+declare function getNextAvailableFormFieldKey(fields: Pick<FormFieldConfig, "key">[]): string;
+declare function createFormFieldConfig(type: FormFieldType, key?: string): FormFieldConfig;
+type FormAuthoringMode = FormItemConfig["authoringMode"];
+declare const getFormAuthoringMode: (config: unknown) => FormAuthoringMode;
+declare const hasSingleFormField: (config: unknown) => boolean;
+declare const isValidSimpleFormConfig: (config: unknown) => boolean;
+/**
+ * Canonicalizes the editor-facing mode without modifying groups, fields, or translations.
+ * Missing modes and malformed simple forms become custom; valid simple forms stay simple.
+ */
+declare const normalizeFormAuthoringConfig: (config: unknown) => Record<string, unknown> | undefined;
+/**
+ * Returns true only for an in-place edit of the existing sole field that the simple editor can
+ * still represent. Adding, moving, retyping, or exposing hidden field configuration is structural.
+ */
+declare const isCompatibleSimpleFieldUpsert: ({
+  config,
+  field,
+  groupId,
+  index
+}: {
+  config: unknown;
+  field: Record<string, unknown> & {
+    id: string;
+    key: string;
+    type: string;
+  };
+  groupId: string;
+  index?: number;
+}) => boolean;
+/** Structural form edits leave simple mode unless the sole field remains representable there. */
+declare const transitionFormAuthoringMode: ({
+  config,
+  fieldGroups,
+  preserveSimpleMode
+}: {
+  config: Record<string, unknown>;
+  fieldGroups: Record<string, unknown>[];
+  preserveSimpleMode?: boolean;
+}) => Record<string, unknown>;
+//#endregion
+export { FORM_DATEPICKER_FIELD_MODES, FormAuthoringMode, FormDatepickerFieldControlConfig, FormDatepickerFieldMode, FormFieldConfig, FormFieldControlConfig, FormFieldEffectiveValidationConfig, FormFieldEffectiveValidationType, FormFieldGroupConfig, FormFieldGroupLayoutConfig, FormFieldSelectOptionConfig, FormFieldType, FormFieldValidationConfig, FormFieldValidationType, FormInputFieldControlConfig, FormItemConfig, FormNumberFieldControlConfig, FormSelectFieldControlConfig, FormSliderFieldControlConfig, FormSwitchFieldControlConfig, FormTextareaFieldControlConfig, createFormFieldConfig, createFormFieldGroupConfig, createFormItemConfig, formFieldGroupLayoutCssVars, getFormAuthoringMode, getFormFieldCheckedLabelContentKey, getFormFieldDescriptionContentKey, getFormFieldEffectiveValidations, getFormFieldErrorMessageContentKey, getFormFieldGroupDescriptionContentKey, getFormFieldGroupTitleContentKey, getFormFieldGroupTranslationKeys, getFormFieldGroupTranslationPrefix, getFormFieldLabelContentKey, getFormFieldOptionLabelContentKey, getFormFieldPlaceholderContentKey, getFormFieldTranslationKeys, getFormFieldTranslationPrefix, getFormFieldUncheckedLabelContentKey, getFormFieldUnitContentKey, getFormFieldValidationMessageContentKey, getFormFieldValueType, getNextAvailableFormFieldKey, hasSingleFormField, isCompatibleSimpleFieldUpsert, isValidSimpleFormConfig, normalizeFormAuthoringConfig, normalizeFormItemConfig, transitionFormAuthoringMode, withFormItemTranslatedContent, withoutFormItemTranslatedContent, writeFormFieldGroupTranslations, writeFormFieldTranslations };
+//# sourceMappingURL=form.d.mts.map

package/dist/form.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.mts","names":[],"sources":["../src/form.ts"],"mappings":"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"}