@neut/ui 0.0.17 → 0.0.18

package/dist/components/progress/ProgressTrack/ProgressTrack.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressTrack.js","names":["splitProps","ProgressTrackProps","clsx","classes","useProgressContext","ProgressTrack","props","value","local","others","_el$","_tmpl$","_$spread","_$mergeProps","data-progressing","_$memo","class","_$mergeProps","_$memo","_tmpl$","ProgressTrack","useProgressContext","local","others","splitProps","props","_el$","spread","mergeProps","memo","value","\"class\"","clsx","classes"],"sources":["../../../../src/components/progress/ProgressTrack/ProgressTrack.tsx"],"sourcesContent":["import { splitProps } from \"solid-js\";\nimport type { ProgressTrackProps } from \"./ProgressTrack.types\";\nimport { clsx } from \"~/utils\";\nimport { classes } from \"./ProgressTrack.styles\";\nimport { useProgressContext } from \"../Progress\";\n\nexport const ProgressTrack = (props: ProgressTrackProps) => {\n  const { value } = useProgressContext();\n\n  const [local, others] = splitProps(props, [\"class\", \"classList\"]);\n\n  return (\n    <div\n      data-slot=\"progress-track\"\n      data-progressing={value() > 0 && value() < 100}\n      class={clsx(classes, local.class)}\n      {...others}\n    />\n  );\n};\n"],"mappings":";;;;;;2DAMaK,KAAiBC,MAA8B;CAC1D,IAAM,EAAEC,aAAUH,EAAmB,GAE/B,CAACI,GAAOC,KAAUT,EAAWM,GAAO,CAAC,SAAS,WAAW,CAAC;CAEhE,cAAA;EAAA,IAAAI,IAAAC,EAAA;EAKc,OALdC,EAAAF,GAAAG,EAAA;GAAA,IAAA,qBAAA;IAAA,OAGsBE,QAAAR,EAAM,IAAI,CAAC,CAAA,CAAA,KAAIA,EAAM,IAAI;GAAG;GAAA,IAAAwB,QAAA;IAAA,OACvC7B,EAAKC,GAASK,EAAMQ,KAAK;GAAC;EAAA,GAC7BP,CAAM,GAAA,IAAA,EAAA,GAAAC;CAAA,EAAA,CAAA;AAGhB"}
+{"version":3,"file":"ProgressTrack.js","names":["splitProps","ProgressTrackProps","clsx","classes","useProgressContext","ProgressTrack","props","value","local","others","_el$","_tmpl$","_$spread","_$mergeProps","data-progressing","_$memo","class","classList","_$mergeProps","_$memo","_tmpl$","ProgressTrack","useProgressContext","local","others","splitProps","props","_el$","spread","mergeProps","memo","value","\"class\"","clsx","classes"],"sources":["../../../../src/components/progress/ProgressTrack/ProgressTrack.tsx"],"sourcesContent":["import { splitProps } from \"solid-js\";\nimport type { ProgressTrackProps } from \"./ProgressTrack.types\";\nimport { clsx } from \"~/utils\";\nimport { classes } from \"./ProgressTrack.styles\";\nimport { useProgressContext } from \"../Progress\";\n\nexport const ProgressTrack = (props: ProgressTrackProps) => {\n  const { value } = useProgressContext();\n\n  const [local, others] = splitProps(props, [\"class\", \"classList\"]);\n\n  return (\n    <div\n      data-slot=\"progress-track\"\n      data-progressing={value() > 0 && value() < 100}\n      class={clsx(classes, local.class)}\n      classList={local.classList}\n      {...others}\n    />\n  );\n};\n"],"mappings":";;;;;;2DAMaK,KAAiBC,MAA8B;CAC1D,IAAM,EAAEC,aAAUH,EAAmB,GAE/B,CAACI,GAAOC,KAAUT,EAAWM,GAAO,CAAC,SAAS,WAAW,CAAC;CAEhE,cAAA;EAAA,IAAAI,IAAAC,EAAA;EAMc,OANdC,EAAAF,GAAAG,EAAA;GAAA,IAAA,qBAAA;IAAA,OAGsBE,QAAAR,EAAM,IAAI,CAAC,CAAA,CAAA,KAAIA,EAAM,IAAI;GAAG;GAAA,IAAAyB,QAAA;IAAA,OACvC9B,EAAKC,GAASK,EAAMQ,KAAK;GAAC;GAAA,IACjCC,YAAS;IAAA,OAAET,EAAMS;GAAS;EAAA,GACtBR,CAAM,GAAA,IAAA,EAAA,GAAAC;CAAA,EAAA,CAAA;AAGhB"}

package/dist/components/progress/ProgressValue/ProgressValue.js

@@ -8,9 +8,14 @@ var c = /*#__PURE__*/ o("<span data-slot=progress-value>%"), l = (o) => {
 	let { value: l } = t(), [u, d] = s(o, ["class", "classList"]);
 	return (() => {
 		var t = c(), o = t.firstChild;
-		return a(t, i({ get class() {
-			return e(n, u.class);
-		} }, d), !1, !0), r(t, l, o), t;
+		return a(t, i({
+			get class() {
+				return e(n, u.class);
+			},
+			get classList() {
+				return u.classList;
+			}
+		}, d), !1, !0), r(t, l, o), t;
 	})();
 };
 //#endregion

package/dist/components/progress/ProgressValue/ProgressValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressValue.js","names":["splitProps","ProgressValueProps","clsx","classes","useProgressContext","ProgressValue","props","value","local","others","_el$","_tmpl$","_el$2","firstChild","_$spread","_$mergeProps","class","_$insert","_$mergeProps","_tmpl$","ProgressValue","useProgressContext","local","others","splitProps","props","_el$","_el$2","spread","mergeProps","\"class\"","clsx","classes","insert","value"],"sources":["../../../../src/components/progress/ProgressValue/ProgressValue.tsx"],"sourcesContent":["import { splitProps } from \"solid-js\";\nimport type { ProgressValueProps } from \"./ProgressValue.types\";\nimport { clsx } from \"~/utils\";\nimport { classes } from \"./ProgressValue.styles\";\nimport { useProgressContext } from \"../Progress\";\n\nexport const ProgressValue = (props: ProgressValueProps) => {\n  const { value } = useProgressContext();\n\n  const [local, others] = splitProps(props, [\"class\", \"classList\"]);\n\n  return (\n    <span\n      data-slot=\"progress-value\"\n      class={clsx(classes, local.class)}\n      {...others}\n    >\n      {value()}%\n    </span>\n  );\n};\n"],"mappings":";;;;;;6DAMaK,KAAiBC,MAA8B;CAC1D,IAAM,EAAEC,aAAUH,EAAmB,GAE/B,CAACI,GAAOC,KAAUT,EAAWM,GAAO,CAAC,SAAS,WAAW,CAAC;CAEhE,cAAA;EAAA,IAAAI,IAAAC,EAAA,GAAAC,IAAAF,EAAAG;EAMU,OANVC,EAAAJ,GAAAK,EAAA,EAAA,IAAAe,QAAA;GAAA,OAGW5B,EAAKC,GAASK,EAAMQ,KAAK;EAAC,EAAA,GAC7BP,CAAM,GAAA,IAAA,EAAA,GAAAQ,EAAAP,GAETH,GAAKK,CAAA,GAAAF;CAAA,EAAA,CAAA;AAGZ"}
+{"version":3,"file":"ProgressValue.js","names":["splitProps","ProgressValueProps","clsx","classes","useProgressContext","ProgressValue","props","value","local","others","_el$","_tmpl$","_el$2","firstChild","_$spread","_$mergeProps","class","classList","_$insert","_$mergeProps","_tmpl$","ProgressValue","useProgressContext","local","others","splitProps","props","_el$","_el$2","spread","mergeProps","\"class\"","clsx","classes","insert","value"],"sources":["../../../../src/components/progress/ProgressValue/ProgressValue.tsx"],"sourcesContent":["import { splitProps } from \"solid-js\";\nimport type { ProgressValueProps } from \"./ProgressValue.types\";\nimport { clsx } from \"~/utils\";\nimport { classes } from \"./ProgressValue.styles\";\nimport { useProgressContext } from \"../Progress\";\n\nexport const ProgressValue = (props: ProgressValueProps) => {\n  const { value } = useProgressContext();\n\n  const [local, others] = splitProps(props, [\"class\", \"classList\"]);\n\n  return (\n    <span\n      data-slot=\"progress-value\"\n      class={clsx(classes, local.class)}\n      classList={local.classList}\n      {...others}\n    >\n      {value()}%\n    </span>\n  );\n};\n"],"mappings":";;;;;;6DAMaK,KAAiBC,MAA8B;CAC1D,IAAM,EAAEC,aAAUH,EAAmB,GAE/B,CAACI,GAAOC,KAAUT,EAAWM,GAAO,CAAC,SAAS,WAAW,CAAC;CAEhE,cAAA;EAAA,IAAAI,IAAAC,EAAA,GAAAC,IAAAF,EAAAG;EAOU,OAPVC,EAAAJ,GAAAK,EAAA;GAAA,IAAAgB,QAAA;IAAA,OAGW7B,EAAKC,GAASK,EAAMQ,KAAK;GAAC;GAAA,IACjCC,YAAS;IAAA,OAAET,EAAMS;GAAS;EAAA,GACtBR,CAAM,GAAA,IAAA,EAAA,GAAAS,EAAAR,GAETH,GAAKK,CAAA,GAAAF;CAAA,EAAA,CAAA;AAGZ"}

package/dist/components/questionnaire/QuestionnaireChoice/questionnaire-choice.utils.d.ts

@@ -0,0 +1,48 @@
+import { QuestionnaireItemStatus } from '../questionnaire.types';
+/**
+ * 固定选项（radio / checkbox）的纯判定。
+ *
+ * 单一职责：把"受控值 / 跳过状态 / 选中集合 / 校验上下文"换算成
+ * 最终要渲染与写回的布尔值，不读信号、不碰 DOM。
+ * 受控与非受控、跳过与未跳过、交互前后的一致性都由这些函数显式表达。
+ */
+/**
+ * 最终是否勾选：
+ * - 受控（`checked` 有值）时以它为唯一来源，但"已跳过"的题目一律不勾选；
+ * - 非受控时看 Item 的选中集合里有没有自己。
+ */
+export declare function resolveChoiceChecked(options: {
+    controlled: boolean | undefined;
+    status: QuestionnaireItemStatus;
+    selectedAnswerIds: readonly string[];
+    id: string;
+}): boolean;
+/** 选项是否需要原生 `required`：整题必填、单选、且本题没有文本框作答 */
+export declare function isChoiceRequired(options: {
+    required: boolean;
+    multiple: boolean;
+    hasInputAnswer: boolean;
+}): boolean;
+/** 已跳过的题目不提交表单字段值（避免把跳过题目的答案一起提交） */
+export declare function resolveChoiceName(status: QuestionnaireItemStatus, name: string): string | undefined;
+/**
+ * 交互后要不要写回选中集合，以及写成什么值：
+ * - 用户回调已经 `preventDefault()` → 什么都不做；
+ * - 非受控 → 直接采用原生控件的勾选结果；
+ * - 受控且题目"已跳过"、原生结果恰好与受控值相同时 → 补一次写回，
+ *   否则 DOM 上的临时勾选会残留（受控方不会再送新值过来）；
+ * - 其余受控情况 → 交给受控方，自己不写。
+ */
+export declare function decideChoiceSelectionChange(options: {
+    canceled: boolean;
+    controlled: boolean | undefined;
+    status: QuestionnaireItemStatus;
+    checked: boolean;
+}): boolean | null;
+/** 选项的快捷键：优先声明式 value 映射，其次按答案 id 分配，都没有则为 null */
+export declare function resolveChoiceShortcut(options: {
+    byChoiceValue: Map<string, string> | null;
+    byAnswerId: Map<string, string>;
+    value: string;
+    id: string;
+}): string | null;

package/dist/components/questionnaire/QuestionnaireChoice/questionnaire-choice.utils.js

@@ -0,0 +1,23 @@
+//#region src/components/questionnaire/QuestionnaireChoice/questionnaire-choice.utils.ts
+function e(e) {
+	let { controlled: t, status: n, selectedAnswerIds: r, id: i } = e;
+	return t === void 0 ? r.includes(i) : n !== "skipped" && t;
+}
+function t(e) {
+	return e.required && !e.multiple && !e.hasInputAnswer;
+}
+function n(e, t) {
+	return e === "skipped" ? void 0 : t;
+}
+function r(e) {
+	let { canceled: t, controlled: n, status: r, checked: i } = e;
+	return t ? null : n === void 0 ? i : r === "skipped" && n === i ? n : null;
+}
+function i(e) {
+	let { byChoiceValue: t, byAnswerId: n, value: r, id: i } = e;
+	return t?.get(r) ?? n.get(i) ?? null;
+}
+//#endregion
+export { r as decideChoiceSelectionChange, t as isChoiceRequired, e as resolveChoiceChecked, n as resolveChoiceName, i as resolveChoiceShortcut };
+
+//# sourceMappingURL=questionnaire-choice.utils.js.map

package/dist/components/questionnaire/QuestionnaireChoice/questionnaire-choice.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire-choice.utils.js","names":["resolveChoiceChecked","options","controlled","selectedAnswerIds","id","status","isChoiceRequired","resolveChoiceName","name","decideChoiceSelectionChange","canceled","checked","resolveChoiceShortcut","byChoiceValue","value","byAnswerId"],"sources":["../../../../src/components/questionnaire/QuestionnaireChoice/questionnaire-choice.utils.ts"],"sourcesContent":["import type { QuestionnaireItemStatus } from \"../questionnaire.types\";\n\n/**\n * 固定选项（radio / checkbox）的纯判定。\n *\n * 单一职责：把\"受控值 / 跳过状态 / 选中集合 / 校验上下文\"换算成\n * 最终要渲染与写回的布尔值，不读信号、不碰 DOM。\n * 受控与非受控、跳过与未跳过、交互前后的一致性都由这些函数显式表达。\n */\n\n/**\n * 最终是否勾选：\n * - 受控（`checked` 有值）时以它为唯一来源，但\"已跳过\"的题目一律不勾选；\n * - 非受控时看 Item 的选中集合里有没有自己。\n */\nexport function resolveChoiceChecked(options: {\n  controlled: boolean | undefined;\n  status: QuestionnaireItemStatus;\n  selectedAnswerIds: readonly string[];\n  id: string;\n}): boolean {\n  const { controlled, status, selectedAnswerIds, id } = options;\n  if (controlled !== undefined) {\n    return status === \"skipped\" ? false : controlled;\n  }\n  return selectedAnswerIds.includes(id);\n}\n\n/** 选项是否需要原生 `required`：整题必填、单选、且本题没有文本框作答 */\nexport function isChoiceRequired(options: {\n  required: boolean;\n  multiple: boolean;\n  hasInputAnswer: boolean;\n}): boolean {\n  return options.required && !options.multiple && !options.hasInputAnswer;\n}\n\n/** 已跳过的题目不提交表单字段值（避免把跳过题目的答案一起提交） */\nexport function resolveChoiceName(\n  status: QuestionnaireItemStatus,\n  name: string,\n): string | undefined {\n  return status === \"skipped\" ? undefined : name;\n}\n\n/**\n * 交互后要不要写回选中集合，以及写成什么值：\n * - 用户回调已经 `preventDefault()` → 什么都不做；\n * - 非受控 → 直接采用原生控件的勾选结果；\n * - 受控且题目\"已跳过\"、原生结果恰好与受控值相同时 → 补一次写回，\n *   否则 DOM 上的临时勾选会残留（受控方不会再送新值过来）；\n * - 其余受控情况 → 交给受控方，自己不写。\n */\nexport function decideChoiceSelectionChange(options: {\n  canceled: boolean;\n  controlled: boolean | undefined;\n  status: QuestionnaireItemStatus;\n  checked: boolean;\n}): boolean | null {\n  const { canceled, controlled, status, checked } = options;\n  if (canceled) return null;\n  if (controlled === undefined) return checked;\n  if (status === \"skipped\" && controlled === checked) return controlled;\n  return null;\n}\n\n/** 选项的快捷键：优先声明式 value 映射，其次按答案 id 分配，都没有则为 null */\nexport function resolveChoiceShortcut(options: {\n  byChoiceValue: Map<string, string> | null;\n  byAnswerId: Map<string, string>;\n  value: string;\n  id: string;\n}): string | null {\n  const { byChoiceValue, byAnswerId, value, id } = options;\n  return byChoiceValue?.get(value) ?? byAnswerId.get(id) ?? null;\n}\n"],"mappings":";AAeA,SAAgBA,EAAqB,GAKzB;CACV,IAAM,EAAE,eAAY,WAAQ,sBAAmB,UAAOC;CAItD,OAHIC,MAAe,KAAA,IAGZC,EAAkB,SAASC,CAAE,IAF3BC,MAAW,aAAoBH;AAG1C;AAGA,SAAgBI,EAAiB,GAIrB;CACV,OAAOL,EAAQ,YAAY,CAACA,EAAQ,YAAY,CAACA,EAAQ;AAC3D;AAGA,SAAgBM,EACd,GACA,GACoB;CACpB,OAAOF,MAAW,YAAY,KAAA,IAAYG;AAC5C;AAUA,SAAgBC,EAA4B,GAKzB;CACjB,IAAM,EAAE,aAAU,eAAY,WAAQ,eAAYR;CAIlD,OAHIS,IAAiB,OACjBR,MAAe,KAAA,IAAkBS,IACjCN,MAAW,aAAaH,MAAeS,IAAgBT,IACpD;AACT;AAGA,SAAgBU,EAAsB,GAKpB;CAChB,IAAM,EAAE,kBAAe,eAAY,UAAO,UAAOX;CACjD,OAAOY,GAAe,IAAIC,CAAK,KAAKC,EAAW,IAAIX,CAAE,KAAK;AAC5D"}

package/dist/components/questionnaire/QuestionnaireChoice/useQuestionnaireChoice.js

@@ -1,67 +1,80 @@
 import { useQuestionnaireItemContext as e } from "../questionnaire.context.js";
 import { keyShortcutText as t } from "../questionnaire.utils.js";
-import { createEffect as n, createSignal as r, createUniqueId as i, onCleanup as a } from "solid-js";
+import { decideChoiceSelectionChange as n, isChoiceRequired as r, resolveChoiceChecked as i, resolveChoiceName as a, resolveChoiceShortcut as o } from "./questionnaire-choice.utils.js";
+import { createEffect as s, createSignal as c, createUniqueId as l, onCleanup as u } from "solid-js";
 //#region src/components/questionnaire/QuestionnaireChoice/useQuestionnaireChoice.ts
-function o(o) {
-	let s = e("QuestionnaireChoice"), c = i(), [l, u] = r(), d = () => s.disabled() || !!o.disabled?.(), f = () => s.multiple() ? "checkbox" : "radio", p = () => s.shortcutByChoiceValue()?.get(o.value) ?? s.shortcutByAnswerId().get(c) ?? null;
-	a(s.registerAnswerSelection(c, !!o.defaultChecked?.())), n(() => s.setAnswerDefault(c, !!o.defaultChecked?.())), n(() => {
-		let e = l();
+function d(d) {
+	let f = e("QuestionnaireChoice"), p = l(), [m, h] = c(), g = () => f.disabled() || !!d.disabled?.(), _ = () => f.multiple() ? "checkbox" : "radio", v = () => o({
+		byChoiceValue: f.shortcutByChoiceValue(),
+		byAnswerId: f.shortcutByAnswerId(),
+		value: d.value,
+		id: p
+	}), y = () => r({
+		required: f.required(),
+		multiple: f.multiple(),
+		hasInputAnswer: f.hasInputAnswer()
+	}), b = () => a(f.status(), f.name);
+	u(f.registerAnswerSelection(p, !!d.defaultChecked?.())), s(() => f.setAnswerDefault(p, !!d.defaultChecked?.())), s(() => {
+		let e = m();
 		if (!e) return;
-		let t = s.registerAnswerControl({
-			id: c,
+		let t = f.registerAnswerControl({
+			id: p,
 			element: e,
 			type: "choice",
-			value: o.value,
-			disabled: d(),
-			ownDisabled: !!o.disabled?.()
+			value: d.value,
+			disabled: g(),
+			ownDisabled: !!d.disabled?.()
 		});
-		a(t);
+		u(t);
 	});
-	let m = () => {
-		let e = o.checked?.();
-		return e === void 0 ? s.selectedAnswerIds().includes(c) : s.status() !== "skipped" && e;
-	};
-	n(() => {
-		let e = l(), t = o.checked?.();
-		s.resetVersion(), e && t !== void 0 && s.syncControlledAnswerSelection(c, t), e && (e.checked = m());
+	let x = () => i({
+		controlled: d.checked?.(),
+		status: f.status(),
+		selectedAnswerIds: f.selectedAnswerIds(),
+		id: p
+	});
+	s(() => {
+		let e = m(), t = d.checked?.();
+		f.resetVersion(), e && t !== void 0 && f.syncControlledAnswerSelection(p, t), e && (e.checked = x());
 	});
-	let h = (e) => {
+	let S = (e) => {
 		let t = e.target;
-		if (o.onChange?.(e), e.defaultPrevented) return;
-		let n = o.checked?.();
-		if (n === void 0) {
-			s.setAnswerSelectionFromInteraction(c, t.checked);
-			return;
-		}
-		s.status() === "skipped" && n === t.checked && s.setAnswerSelectionFromInteraction(c, n);
-	};
+		d.onChange?.(e);
+		let r = n({
+			canceled: e.defaultPrevented,
+			controlled: d.checked?.(),
+			status: f.status(),
+			checked: t.checked
+		});
+		r !== null && f.setAnswerSelectionFromInteraction(p, r);
+	}, C = () => t(v(), !g() && x());
 	return {
-		id: c,
-		setInput: u,
-		type: f,
-		isDisabled: d,
-		shortcut: p,
-		checkedResolved: m,
-		handleChange: h,
-		invalid: s.invalid,
-		required: () => s.required() && !s.multiple() && !s.hasInputAnswer(),
-		name: () => s.status() === "skipped" ? void 0 : s.name,
-		ariaKeyShortcuts: () => t(p(), !d() && m()),
+		id: p,
+		setInput: h,
+		type: _,
+		isDisabled: g,
+		shortcut: v,
+		checkedResolved: x,
+		handleChange: S,
+		invalid: f.invalid,
+		required: y,
+		name: b,
+		ariaKeyShortcuts: C,
 		inputProps: () => ({
-			"aria-keyshortcuts": t(p(), !d() && m()),
-			"aria-invalid": s.invalid() || void 0,
-			checked: m(),
-			disabled: d(),
-			id: c,
-			name: s.status() === "skipped" ? void 0 : s.name,
-			onChange: h,
-			required: s.required() && !s.multiple() && !s.hasInputAnswer(),
-			type: f(),
-			value: o.value
+			"aria-keyshortcuts": C(),
+			"aria-invalid": f.invalid() || void 0,
+			checked: x(),
+			disabled: g(),
+			id: p,
+			name: b(),
+			onChange: S,
+			required: y(),
+			type: _(),
+			value: d.value
 		})
 	};
 }
 //#endregion
-export { o as useQuestionnaireChoice };
+export { d as useQuestionnaireChoice };
 
 //# sourceMappingURL=useQuestionnaireChoice.js.map

package/dist/components/questionnaire/QuestionnaireChoice/useQuestionnaireChoice.js.map

@@ -1 +1 @@
-{"version":3,"file":"useQuestionnaireChoice.js","names":["useQuestionnaireChoice","item","useQuestionnaireItemContext","id","createUniqueId","input","setInput","createSignal","isDisabled","options","type","shortcut","onCleanup","createEffect","element","unregister","checkedResolved","controlled","handleChange","target","event","keyShortcutText"],"sources":["../../../../src/components/questionnaire/QuestionnaireChoice/useQuestionnaireChoice.ts"],"sourcesContent":["import {\n  createEffect,\n  createSignal,\n  createUniqueId,\n  onCleanup,\n  type Accessor,\n} from \"solid-js\";\nimport { useQuestionnaireItemContext } from \"../questionnaire.context\";\nimport { keyShortcutText } from \"../questionnaire.utils\";\n\ninterface Options {\n  value: string;\n  checked?: Accessor<boolean | undefined>;\n  defaultChecked?: Accessor<boolean>;\n  disabled?: Accessor<boolean>;\n  onChange?: (event: Event) => void;\n}\n\n/**\n * 固定选项的状态:选中由 Item 的选中集合驱动(受控时用 checked),\n * 同时把 input 注册成 Item 的 answer control,以便校验与快捷键。\n */\nexport function useQuestionnaireChoice(options: Options) {\n  const item = useQuestionnaireItemContext(\"QuestionnaireChoice\");\n  const id = createUniqueId();\n  const [input, setInput] = createSignal<HTMLInputElement>();\n\n  const isDisabled = () => item.disabled() || !!options.disabled?.();\n  const type = () => (item.multiple() ? \"checkbox\" : \"radio\");\n  const shortcut = () =>\n    item.shortcutByChoiceValue()?.get(options.value) ??\n    item.shortcutByAnswerId().get(id) ??\n    null;\n\n  onCleanup(item.registerAnswerSelection(id, !!options.defaultChecked?.()));\n  createEffect(() => item.setAnswerDefault(id, !!options.defaultChecked?.()));\n\n  createEffect(() => {\n    const element = input();\n    if (!element) return;\n    const unregister = item.registerAnswerControl({\n      id,\n      element,\n      type: \"choice\",\n      value: options.value,\n      disabled: isDisabled(),\n      ownDisabled: !!options.disabled?.(),\n    });\n    onCleanup(unregister);\n  });\n\n  const checkedResolved = () => {\n    const controlled = options.checked?.();\n    if (controlled !== undefined) {\n      return item.status() === \"skipped\" ? false : controlled;\n    }\n    return item.selectedAnswerIds().includes(id);\n  };\n\n  // 受控同步 + reset 后强制同步 DOM checked\n  createEffect(() => {\n    const element = input();\n    const controlled = options.checked?.();\n    item.resetVersion();\n    if (element && controlled !== undefined) {\n      item.syncControlledAnswerSelection(id, controlled);\n    }\n    if (element) element.checked = checkedResolved();\n  });\n\n  const handleChange = (event: Event) => {\n    const target = event.target as HTMLInputElement;\n    options.onChange?.(event);\n    if (event.defaultPrevented) return;\n    const controlled = options.checked?.();\n    if (controlled === undefined) {\n      item.setAnswerSelectionFromInteraction(id, target.checked);\n      return;\n    }\n    if (item.status() === \"skipped\" && controlled === target.checked) {\n      item.setAnswerSelectionFromInteraction(id, controlled);\n    }\n  };\n\n  return {\n    id,\n    setInput,\n    type,\n    isDisabled,\n    shortcut,\n    checkedResolved,\n    handleChange,\n    invalid: item.invalid,\n    required: () =>\n      item.required() && !item.multiple() && !item.hasInputAnswer(),\n    name: () => (item.status() === \"skipped\" ? undefined : item.name),\n    ariaKeyShortcuts: () =>\n      keyShortcutText(shortcut(), !isDisabled() && checkedResolved()),\n    inputProps: () => ({\n      \"aria-keyshortcuts\": keyShortcutText(\n        shortcut(),\n        !isDisabled() && checkedResolved(),\n      ),\n      \"aria-invalid\": item.invalid() || undefined,\n      checked: checkedResolved(),\n      disabled: isDisabled(),\n      id,\n      name: item.status() === \"skipped\" ? undefined : item.name,\n      onChange: handleChange,\n      required: item.required() && !item.multiple() && !item.hasInputAnswer(),\n      type: type(),\n      value: options.value,\n    }),\n  };\n}\n"],"mappings":";;;;AAsBA,SAAgBA,EAAuB,GAAkB;CACvD,IAAMC,IAAOC,EAA4B,qBAAqB,GACxDC,IAAKC,EAAe,GACpB,CAACC,GAAOC,KAAYC,EAA+B,GAEnDC,UAAmBP,EAAK,SAAS,KAAK,CAAC,CAACQ,EAAQ,WAAW,GAC3DC,UAAcT,EAAK,SAAS,IAAI,aAAa,SAC7CU,UACJV,EAAK,sBAAsB,CAAC,EAAE,IAAIQ,EAAQ,KAAK,KAC/CR,EAAK,mBAAmB,CAAC,CAAC,IAAIE,CAAE,KAChC;CAKF,AAHAS,EAAUX,EAAK,wBAAwBE,GAAI,CAAC,CAACM,EAAQ,iBAAiB,CAAC,CAAC,GACxEI,QAAmBZ,EAAK,iBAAiBE,GAAI,CAAC,CAACM,EAAQ,iBAAiB,CAAC,CAAC,GAE1EI,QAAmB;EACjB,IAAMC,IAAUT,EAAM;EACtB,IAAI,CAACS,GAAS;EACd,IAAMC,IAAad,EAAK,sBAAsB;GAC5C;GACA;GACA,MAAM;GACN,OAAOQ,EAAQ;GACf,UAAUD,EAAW;GACrB,aAAa,CAAC,CAACC,EAAQ,WAAW;EACpC,CAAC;EACD,EAAUM,CAAU;CACtB,CAAC;CAED,IAAMC,UAAwB;EAC5B,IAAMC,IAAaR,EAAQ,UAAU;EAIrC,OAHIQ,MAAe,KAAA,IAGZhB,EAAK,kBAAkB,CAAC,CAAC,SAASE,CAAE,IAFlCF,EAAK,OAAO,MAAM,aAAoBgB;CAGjD;CAGA,QAAmB;EACjB,IAAMH,IAAUT,EAAM,GAChBY,IAAaR,EAAQ,UAAU;EAKrC,AAJAR,EAAK,aAAa,GACda,KAAWG,MAAe,KAAA,KAC5BhB,EAAK,8BAA8BE,GAAIc,CAAU,GAE/CH,MAAS,EAAQ,UAAUE,EAAgB;CACjD,CAAC;CAED,IAAME,KAAgB,MAAiB;EACrC,IAAMC,IAASC,EAAM;EAErB,IADAX,EAAQ,WAAWW,CAAK,GACpBA,EAAM,kBAAkB;EAC5B,IAAMH,IAAaR,EAAQ,UAAU;EACrC,IAAIQ,MAAe,KAAA,GAAW;GAC5B,EAAK,kCAAkCd,GAAIgB,EAAO,OAAO;GACzD;EACF;EACA,AAAIlB,EAAK,OAAO,MAAM,aAAagB,MAAeE,EAAO,WACvDlB,EAAK,kCAAkCE,GAAIc,CAAU;CAEzD;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAShB,EAAK;EACd,gBACEA,EAAK,SAAS,KAAK,CAACA,EAAK,SAAS,KAAK,CAACA,EAAK,eAAe;EAC9D,YAAaA,EAAK,OAAO,MAAM,YAAY,KAAA,IAAYA,EAAK;EAC5D,wBACEoB,EAAgBV,EAAS,GAAG,CAACH,EAAW,KAAKQ,EAAgB,CAAC;EAChE,mBAAmB;GACjB,qBAAqBK,EACnBV,EAAS,GACT,CAACH,EAAW,KAAKQ,EAAgB,CACnC;GACA,gBAAgBf,EAAK,QAAQ,KAAK,KAAA;GAClC,SAASe,EAAgB;GACzB,UAAUR,EAAW;GACrB;GACA,MAAMP,EAAK,OAAO,MAAM,YAAY,KAAA,IAAYA,EAAK;GACrD,UAAUiB;GACV,UAAUjB,EAAK,SAAS,KAAK,CAACA,EAAK,SAAS,KAAK,CAACA,EAAK,eAAe;GACtE,MAAMS,EAAK;GACX,OAAOD,EAAQ;EACjB;CACF;AACF"}
+{"version":3,"file":"useQuestionnaireChoice.js","names":["useQuestionnaireChoice","item","useQuestionnaireItemContext","id","createUniqueId","input","setInput","createSignal","isDisabled","options","type","shortcut","resolveChoiceShortcut","required","isChoiceRequired","name","resolveChoiceName","onCleanup","createEffect","element","unregister","checkedResolved","resolveChoiceChecked","controlled","handleChange","target","event","next","decideChoiceSelectionChange","ariaKeyShortcuts","keyShortcutText"],"sources":["../../../../src/components/questionnaire/QuestionnaireChoice/useQuestionnaireChoice.ts"],"sourcesContent":["import {\n  createEffect,\n  createSignal,\n  createUniqueId,\n  onCleanup,\n  type Accessor,\n} from \"solid-js\";\nimport { useQuestionnaireItemContext } from \"../questionnaire.context\";\nimport { keyShortcutText } from \"../questionnaire.utils\";\nimport {\n  decideChoiceSelectionChange,\n  isChoiceRequired,\n  resolveChoiceChecked,\n  resolveChoiceName,\n  resolveChoiceShortcut,\n} from \"./questionnaire-choice.utils\";\n\ninterface Options {\n  value: string;\n  checked?: Accessor<boolean | undefined>;\n  defaultChecked?: Accessor<boolean>;\n  disabled?: Accessor<boolean>;\n  onChange?: (event: Event) => void;\n}\n\n/**\n * 固定选项的状态:选中由 Item 的选中集合驱动(受控时用 checked),\n * 同时把 input 注册成 Item 的 answer control,以便校验与快捷键。\n */\nexport function useQuestionnaireChoice(options: Options) {\n  const item = useQuestionnaireItemContext(\"QuestionnaireChoice\");\n  const id = createUniqueId();\n  const [input, setInput] = createSignal<HTMLInputElement>();\n\n  const isDisabled = () => item.disabled() || !!options.disabled?.();\n  const type = () => (item.multiple() ? \"checkbox\" : \"radio\");\n  const shortcut = () =>\n    resolveChoiceShortcut({\n      byChoiceValue: item.shortcutByChoiceValue(),\n      byAnswerId: item.shortcutByAnswerId(),\n      value: options.value,\n      id,\n    });\n\n  const required = () =>\n    isChoiceRequired({\n      required: item.required(),\n      multiple: item.multiple(),\n      hasInputAnswer: item.hasInputAnswer(),\n    });\n\n  const name = () => resolveChoiceName(item.status(), item.name);\n\n  onCleanup(item.registerAnswerSelection(id, !!options.defaultChecked?.()));\n  createEffect(() => item.setAnswerDefault(id, !!options.defaultChecked?.()));\n\n  createEffect(() => {\n    const element = input();\n    if (!element) return;\n    const unregister = item.registerAnswerControl({\n      id,\n      element,\n      type: \"choice\",\n      value: options.value,\n      disabled: isDisabled(),\n      ownDisabled: !!options.disabled?.(),\n    });\n    onCleanup(unregister);\n  });\n\n  const checkedResolved = () =>\n    resolveChoiceChecked({\n      controlled: options.checked?.(),\n      status: item.status(),\n      selectedAnswerIds: item.selectedAnswerIds(),\n      id,\n    });\n\n  // 受控同步 + reset 后强制同步 DOM checked\n  createEffect(() => {\n    const element = input();\n    const controlled = options.checked?.();\n    item.resetVersion();\n    if (element && controlled !== undefined) {\n      item.syncControlledAnswerSelection(id, controlled);\n    }\n    if (element) element.checked = checkedResolved();\n  });\n\n  const handleChange = (event: Event) => {\n    const target = event.target as HTMLInputElement;\n    options.onChange?.(event);\n    const next = decideChoiceSelectionChange({\n      canceled: event.defaultPrevented,\n      controlled: options.checked?.(),\n      status: item.status(),\n      checked: target.checked,\n    });\n    if (next !== null) item.setAnswerSelectionFromInteraction(id, next);\n  };\n\n  /** aria-keyshortcuts：只有\"可用且当前勾选\"时才附上 Enter 提示 */\n  const ariaKeyShortcuts = () =>\n    keyShortcutText(shortcut(), !isDisabled() && checkedResolved());\n\n  return {\n    id,\n    setInput,\n    type,\n    isDisabled,\n    shortcut,\n    checkedResolved,\n    handleChange,\n    invalid: item.invalid,\n    required,\n    name,\n    ariaKeyShortcuts,\n    inputProps: () => ({\n      \"aria-keyshortcuts\": ariaKeyShortcuts(),\n      \"aria-invalid\": item.invalid() || undefined,\n      checked: checkedResolved(),\n      disabled: isDisabled(),\n      id,\n      name: name(),\n      onChange: handleChange,\n      required: required(),\n      type: type(),\n      value: options.value,\n    }),\n  };\n}\n"],"mappings":";;;;;AA6BA,SAAgBA,EAAuB,GAAkB;CACvD,IAAMC,IAAOC,EAA4B,qBAAqB,GACxDC,IAAKC,EAAe,GACpB,CAACC,GAAOC,KAAYC,EAA+B,GAEnDC,UAAmBP,EAAK,SAAS,KAAK,CAAC,CAACQ,EAAQ,WAAW,GAC3DC,UAAcT,EAAK,SAAS,IAAI,aAAa,SAC7CU,UACJC,EAAsB;EACpB,eAAeX,EAAK,sBAAsB;EAC1C,YAAYA,EAAK,mBAAmB;EACpC,OAAOQ,EAAQ;EACf;CACF,CAAC,GAEGI,UACJC,EAAiB;EACf,UAAUb,EAAK,SAAS;EACxB,UAAUA,EAAK,SAAS;EACxB,gBAAgBA,EAAK,eAAe;CACtC,CAAC,GAEGc,UAAaC,EAAkBf,EAAK,OAAO,GAAGA,EAAK,IAAI;CAK7D,AAHAgB,EAAUhB,EAAK,wBAAwBE,GAAI,CAAC,CAACM,EAAQ,iBAAiB,CAAC,CAAC,GACxES,QAAmBjB,EAAK,iBAAiBE,GAAI,CAAC,CAACM,EAAQ,iBAAiB,CAAC,CAAC,GAE1ES,QAAmB;EACjB,IAAMC,IAAUd,EAAM;EACtB,IAAI,CAACc,GAAS;EACd,IAAMC,IAAanB,EAAK,sBAAsB;GAC5C;GACA;GACA,MAAM;GACN,OAAOQ,EAAQ;GACf,UAAUD,EAAW;GACrB,aAAa,CAAC,CAACC,EAAQ,WAAW;EACpC,CAAC;EACD,EAAUW,CAAU;CACtB,CAAC;CAED,IAAMC,UACJC,EAAqB;EACnB,YAAYb,EAAQ,UAAU;EAC9B,QAAQR,EAAK,OAAO;EACpB,mBAAmBA,EAAK,kBAAkB;EAC1C;CACF,CAAC;CAGH,QAAmB;EACjB,IAAMkB,IAAUd,EAAM,GAChBkB,IAAad,EAAQ,UAAU;EAKrC,AAJAR,EAAK,aAAa,GACdkB,KAAWI,MAAe,KAAA,KAC5BtB,EAAK,8BAA8BE,GAAIoB,CAAU,GAE/CJ,MAAS,EAAQ,UAAUE,EAAgB;CACjD,CAAC;CAED,IAAMG,KAAgB,MAAiB;EACrC,IAAMC,IAASC,EAAM;EACrB,EAAQ,WAAWA,CAAK;EACxB,IAAMC,IAAOC,EAA4B;GACvC,UAAUF,EAAM;GAChB,YAAYjB,EAAQ,UAAU;GAC9B,QAAQR,EAAK,OAAO;GACpB,SAASwB,EAAO;EAClB,CAAC;EACD,AAAIE,MAAS,QAAM1B,EAAK,kCAAkCE,GAAIwB,CAAI;CACpE,GAGME,UACJC,EAAgBnB,EAAS,GAAG,CAACH,EAAW,KAAKa,EAAgB,CAAC;CAEhE,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAASpB,EAAK;EACd;EACA;EACA;EACA,mBAAmB;GACjB,qBAAqB4B,EAAiB;GACtC,gBAAgB5B,EAAK,QAAQ,KAAK,KAAA;GAClC,SAASoB,EAAgB;GACzB,UAAUb,EAAW;GACrB;GACA,MAAMO,EAAK;GACX,UAAUS;GACV,UAAUX,EAAS;GACnB,MAAMH,EAAK;GACX,OAAOD,EAAQ;EACjB;CACF;AACF"}

package/dist/components/questionnaire/QuestionnaireInput/useQuestionnaireInput.js

@@ -19,7 +19,10 @@ function s(s) {
 		e !== h() && (g(e), _() || m(f));
 	}), r(() => {
 		let e = u(), n = s.value();
-		e && (_() ? c.syncControlledAnswerSelection(l, t(n)) : n !== void 0 && (e.defaultValue = String(n)));
+		if (e && _()) {
+			c.syncControlledAnswerSelection(l, t(n));
+			return;
+		}
 	});
 	let x = (e) => {
 		let n = e.target;

package/dist/components/questionnaire/QuestionnaireInput/useQuestionnaireInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"useQuestionnaireInput.js","names":["useQuestionnaireInput","item","useQuestionnaireItemContext","id","createUniqueId","input","setInput","createSignal","initialFilled","hasText","options","internalFilled","setInternalFilled","resetSeen","setResetSeen","controlled","isDisabled","selected","filled","onCleanup","createEffect","element","unregister","version","value","handleChange","target","event","nextFilled","keyShortcutText"],"sources":["../../../../src/components/questionnaire/QuestionnaireInput/useQuestionnaireInput.ts"],"sourcesContent":["import {\n  createEffect,\n  createSignal,\n  createUniqueId,\n  onCleanup,\n  type Accessor,\n} from \"solid-js\";\nimport { useQuestionnaireItemContext } from \"../questionnaire.context\";\nimport { hasText, keyShortcutText } from \"../questionnaire.utils\";\n\ninterface Options {\n  type: Accessor<string>;\n  defaultValue: Accessor<string | undefined>;\n  value: Accessor<string | undefined>;\n  disabled: Accessor<boolean | undefined>;\n  onChange?: (event: Event) => void;\n}\n\n/**\n * 自由作答输入:作为 Item 的一个 answer control 参与校验与 FormData。\n * 选中时才有 name(参与提交),否则用 form=\"\" 排除在表单之外。\n */\nexport function useQuestionnaireInput(options: Options) {\n  const item = useQuestionnaireItemContext(\"QuestionnaireInput\");\n  const id = createUniqueId();\n  const [input, setInput] = createSignal<HTMLInputElement>();\n  const initialFilled = hasText(options.defaultValue());\n  const [internalFilled, setInternalFilled] = createSignal(initialFilled);\n  const [resetSeen, setResetSeen] = createSignal(0);\n\n  const controlled = () => options.value() !== undefined;\n  const isDisabled = () => item.disabled() || !!options.disabled?.();\n  const selected = () => item.selectedAnswerIds().includes(id);\n  const filled = () =>\n    controlled() ? hasText(options.value()) : internalFilled();\n\n  onCleanup(item.registerAnswerSelection(id, initialFilled));\n  createEffect(() => item.setAnswerDefault(id, initialFilled));\n\n  createEffect(() => {\n    const element = input();\n    if (!element) return;\n    const unregister = item.registerAnswerControl({\n      id,\n      element,\n      type: \"input\",\n      disabled: isDisabled(),\n    });\n    onCleanup(unregister);\n  });\n\n  createEffect(() => {\n    const version = item.resetVersion();\n    if (version === resetSeen()) return;\n    setResetSeen(version);\n    if (!controlled()) setInternalFilled(initialFilled);\n  });\n\n  createEffect(() => {\n    const element = input();\n    const value = options.value();\n    if (!element) return;\n    if (controlled()) {\n      item.syncControlledAnswerSelection(id, hasText(value));\n    } else if (value !== undefined) {\n      element.defaultValue = String(value);\n    }\n  });\n\n  const handleChange = (event: Event) => {\n    const target = event.target as HTMLInputElement;\n    options.onChange?.(event);\n    if (event.defaultPrevented) return;\n    const nextFilled = hasText(target.value);\n    if (!controlled()) setInternalFilled(nextFilled);\n    item.setAnswerSelectionFromInteraction(id, nextFilled);\n  };\n\n  return {\n    id,\n    setInput,\n    selected,\n    filled,\n    isDisabled,\n    invalid: item.invalid,\n    controlled,\n    name: () => (selected() ? item.name : undefined),\n    formValue: () => (selected() ? undefined : \"\"),\n    ariaKeyShortcuts: () =>\n      keyShortcutText(null, !isDisabled() && filled() && selected()),\n    inputProps: () => ({\n      \"aria-invalid\": item.invalid() || undefined,\n      \"aria-keyshortcuts\": keyShortcutText(\n        null,\n        !isDisabled() && filled() && selected(),\n      ),\n      defaultValue: controlled() ? undefined : options.defaultValue(),\n      disabled: isDisabled(),\n      form: selected() ? undefined : \"\",\n      id,\n      name: selected() ? item.name : undefined,\n      onChange: handleChange,\n      type: options.type(),\n      value: controlled() ? options.value() : undefined,\n    }),\n  };\n}\n"],"mappings":";;;;AAsBA,SAAgBA,EAAsB,GAAkB;CACtD,IAAMC,IAAOC,EAA4B,oBAAoB,GACvDC,IAAKC,EAAe,GACpB,CAACC,GAAOC,KAAYC,EAA+B,GACnDC,IAAgBC,EAAQC,EAAQ,aAAa,CAAC,GAC9C,CAACC,GAAgBC,KAAqBL,EAAaC,CAAa,GAChE,CAACK,GAAWC,KAAgBP,EAAa,CAAC,GAE1CQ,UAAmBL,EAAQ,MAAM,MAAM,KAAA,GACvCM,UAAmBf,EAAK,SAAS,KAAK,CAAC,CAACS,EAAQ,WAAW,GAC3DO,UAAiBhB,EAAK,kBAAkB,CAAC,CAAC,SAASE,CAAE,GACrDe,UACJH,EAAW,IAAIN,EAAQC,EAAQ,MAAM,CAAC,IAAIC,EAAe;CAwB3D,AAtBAQ,EAAUlB,EAAK,wBAAwBE,GAAIK,CAAa,CAAC,GACzDY,QAAmBnB,EAAK,iBAAiBE,GAAIK,CAAa,CAAC,GAE3DY,QAAmB;EACjB,IAAMC,IAAUhB,EAAM;EACtB,IAAI,CAACgB,GAAS;EACd,IAAMC,IAAarB,EAAK,sBAAsB;GAC5C;GACA;GACA,MAAM;GACN,UAAUe,EAAW;EACvB,CAAC;EACD,EAAUM,CAAU;CACtB,CAAC,GAEDF,QAAmB;EACjB,IAAMG,IAAUtB,EAAK,aAAa;EAClC,AAAIsB,MAAYV,EAAU,MAC1BC,EAAaS,CAAO,GACfR,EAAW,KAAGH,EAAkBJ,CAAa;CACpD,CAAC,GAEDY,QAAmB;EACjB,IAAMC,IAAUhB,EAAM,GAChBmB,IAAQd,EAAQ,MAAM;EAC5B,AAAKW,MACDN,EAAW,IACbd,EAAK,8BAA8BE,GAAIM,EAAQe,CAAK,CAAC,IAC5CA,MAAU,KAAA,MACnB,EAAQ,eAAe,OAAOA,CAAK;CAEvC,CAAC;CAED,IAAMC,KAAgB,MAAiB;EACrC,IAAMC,IAASC,EAAM;EAErB,IADAjB,EAAQ,WAAWiB,CAAK,GACpBA,EAAM,kBAAkB;EAC5B,IAAMC,IAAanB,EAAQiB,EAAO,KAAK;EAEvC,AADKX,EAAW,KAAGH,EAAkBgB,CAAU,GAC/C3B,EAAK,kCAAkCE,GAAIyB,CAAU;CACvD;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA,SAAS3B,EAAK;EACd;EACA,YAAagB,EAAS,IAAIhB,EAAK,OAAO,KAAA;EACtC,iBAAkBgB,EAAS,IAAI,KAAA,IAAY;EAC3C,wBACEY,EAAgB,MAAM,CAACb,EAAW,KAAKE,EAAO,KAAKD,EAAS,CAAC;EAC/D,mBAAmB;GACjB,gBAAgBhB,EAAK,QAAQ,KAAK,KAAA;GAClC,qBAAqB4B,EACnB,MACA,CAACb,EAAW,KAAKE,EAAO,KAAKD,EAAS,CACxC;GACA,cAAcF,EAAW,IAAI,KAAA,IAAYL,EAAQ,aAAa;GAC9D,UAAUM,EAAW;GACrB,MAAMC,EAAS,IAAI,KAAA,IAAY;GAC/B;GACA,MAAMA,EAAS,IAAIhB,EAAK,OAAO,KAAA;GAC/B,UAAUwB;GACV,MAAMf,EAAQ,KAAK;GACnB,OAAOK,EAAW,IAAIL,EAAQ,MAAM,IAAI,KAAA;EAC1C;CACF;AACF"}
+{"version":3,"file":"useQuestionnaireInput.js","names":["useQuestionnaireInput","item","useQuestionnaireItemContext","id","createUniqueId","input","setInput","createSignal","initialFilled","hasText","options","internalFilled","setInternalFilled","resetSeen","setResetSeen","controlled","isDisabled","selected","filled","onCleanup","createEffect","element","unregister","version","value","handleChange","target","event","nextFilled","keyShortcutText"],"sources":["../../../../src/components/questionnaire/QuestionnaireInput/useQuestionnaireInput.ts"],"sourcesContent":["import {\n  createEffect,\n  createSignal,\n  createUniqueId,\n  onCleanup,\n  type Accessor,\n} from \"solid-js\";\nimport { useQuestionnaireItemContext } from \"../questionnaire.context\";\nimport { hasText, keyShortcutText } from \"../questionnaire.utils\";\n\ninterface Options {\n  type: Accessor<string>;\n  defaultValue: Accessor<string | undefined>;\n  value: Accessor<string | undefined>;\n  disabled: Accessor<boolean | undefined>;\n  onChange?: (event: Event) => void;\n}\n\n/**\n * 自由作答输入:作为 Item 的一个 answer control 参与校验与 FormData。\n * 选中时才有 name(参与提交),否则用 form=\"\" 排除在表单之外。\n */\nexport function useQuestionnaireInput(options: Options) {\n  const item = useQuestionnaireItemContext(\"QuestionnaireInput\");\n  const id = createUniqueId();\n  const [input, setInput] = createSignal<HTMLInputElement>();\n  const initialFilled = hasText(options.defaultValue());\n  const [internalFilled, setInternalFilled] = createSignal(initialFilled);\n  const [resetSeen, setResetSeen] = createSignal(0);\n\n  const controlled = () => options.value() !== undefined;\n  const isDisabled = () => item.disabled() || !!options.disabled?.();\n  const selected = () => item.selectedAnswerIds().includes(id);\n  const filled = () =>\n    controlled() ? hasText(options.value()) : internalFilled();\n\n  onCleanup(item.registerAnswerSelection(id, initialFilled));\n  createEffect(() => item.setAnswerDefault(id, initialFilled));\n\n  createEffect(() => {\n    const element = input();\n    if (!element) return;\n    const unregister = item.registerAnswerControl({\n      id,\n      element,\n      type: \"input\",\n      disabled: isDisabled(),\n    });\n    onCleanup(unregister);\n  });\n\n  createEffect(() => {\n    const version = item.resetVersion();\n    if (version === resetSeen()) return;\n    setResetSeen(version);\n    if (!controlled()) setInternalFilled(initialFilled);\n  });\n\n  createEffect(() => {\n    const element = input();\n    const value = options.value();\n    if (!element) return;\n    if (controlled()) {\n      item.syncControlledAnswerSelection(id, hasText(value));\n      return;\n    }\n    // 非受控：value 恒为 undefined（受控/非受控由同一个 accessor 判定），\n    // 因此这里没有\"按 value 写 defaultValue\"的分支——之前那句\n    // `else if (value !== undefined)` 永远不成立，已删除。\n  });\n\n  const handleChange = (event: Event) => {\n    const target = event.target as HTMLInputElement;\n    options.onChange?.(event);\n    if (event.defaultPrevented) return;\n    const nextFilled = hasText(target.value);\n    if (!controlled()) setInternalFilled(nextFilled);\n    item.setAnswerSelectionFromInteraction(id, nextFilled);\n  };\n\n  return {\n    id,\n    setInput,\n    selected,\n    filled,\n    isDisabled,\n    invalid: item.invalid,\n    controlled,\n    name: () => (selected() ? item.name : undefined),\n    formValue: () => (selected() ? undefined : \"\"),\n    ariaKeyShortcuts: () =>\n      keyShortcutText(null, !isDisabled() && filled() && selected()),\n    inputProps: () => ({\n      \"aria-invalid\": item.invalid() || undefined,\n      \"aria-keyshortcuts\": keyShortcutText(\n        null,\n        !isDisabled() && filled() && selected(),\n      ),\n      defaultValue: controlled() ? undefined : options.defaultValue(),\n      disabled: isDisabled(),\n      form: selected() ? undefined : \"\",\n      id,\n      name: selected() ? item.name : undefined,\n      onChange: handleChange,\n      type: options.type(),\n      value: controlled() ? options.value() : undefined,\n    }),\n  };\n}\n"],"mappings":";;;;AAsBA,SAAgBA,EAAsB,GAAkB;CACtD,IAAMC,IAAOC,EAA4B,oBAAoB,GACvDC,IAAKC,EAAe,GACpB,CAACC,GAAOC,KAAYC,EAA+B,GACnDC,IAAgBC,EAAQC,EAAQ,aAAa,CAAC,GAC9C,CAACC,GAAgBC,KAAqBL,EAAaC,CAAa,GAChE,CAACK,GAAWC,KAAgBP,EAAa,CAAC,GAE1CQ,UAAmBL,EAAQ,MAAM,MAAM,KAAA,GACvCM,UAAmBf,EAAK,SAAS,KAAK,CAAC,CAACS,EAAQ,WAAW,GAC3DO,UAAiBhB,EAAK,kBAAkB,CAAC,CAAC,SAASE,CAAE,GACrDe,UACJH,EAAW,IAAIN,EAAQC,EAAQ,MAAM,CAAC,IAAIC,EAAe;CAwB3D,AAtBAQ,EAAUlB,EAAK,wBAAwBE,GAAIK,CAAa,CAAC,GACzDY,QAAmBnB,EAAK,iBAAiBE,GAAIK,CAAa,CAAC,GAE3DY,QAAmB;EACjB,IAAMC,IAAUhB,EAAM;EACtB,IAAI,CAACgB,GAAS;EACd,IAAMC,IAAarB,EAAK,sBAAsB;GAC5C;GACA;GACA,MAAM;GACN,UAAUe,EAAW;EACvB,CAAC;EACD,EAAUM,CAAU;CACtB,CAAC,GAEDF,QAAmB;EACjB,IAAMG,IAAUtB,EAAK,aAAa;EAClC,AAAIsB,MAAYV,EAAU,MAC1BC,EAAaS,CAAO,GACfR,EAAW,KAAGH,EAAkBJ,CAAa;CACpD,CAAC,GAEDY,QAAmB;EACjB,IAAMC,IAAUhB,EAAM,GAChBmB,IAAQd,EAAQ,MAAM;EAC5B,IAAKW,KACDN,EAAW,GAAG;GAChB,EAAK,8BAA8BZ,GAAIM,EAAQe,CAAK,CAAC;GACrD;EACF;CAIF,CAAC;CAED,IAAMC,KAAgB,MAAiB;EACrC,IAAMC,IAASC,EAAM;EAErB,IADAjB,EAAQ,WAAWiB,CAAK,GACpBA,EAAM,kBAAkB;EAC5B,IAAMC,IAAanB,EAAQiB,EAAO,KAAK;EAEvC,AADKX,EAAW,KAAGH,EAAkBgB,CAAU,GAC/C3B,EAAK,kCAAkCE,GAAIyB,CAAU;CACvD;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA,SAAS3B,EAAK;EACd;EACA,YAAagB,EAAS,IAAIhB,EAAK,OAAO,KAAA;EACtC,iBAAkBgB,EAAS,IAAI,KAAA,IAAY;EAC3C,wBACEY,EAAgB,MAAM,CAACb,EAAW,KAAKE,EAAO,KAAKD,EAAS,CAAC;EAC/D,mBAAmB;GACjB,gBAAgBhB,EAAK,QAAQ,KAAK,KAAA;GAClC,qBAAqB4B,EACnB,MACA,CAACb,EAAW,KAAKE,EAAO,KAAKD,EAAS,CACxC;GACA,cAAcF,EAAW,IAAI,KAAA,IAAYL,EAAQ,aAAa;GAC9D,UAAUM,EAAW;GACrB,MAAMC,EAAS,IAAI,KAAA,IAAY;GAC/B;GACA,MAAMA,EAAS,IAAIhB,EAAK,OAAO,KAAA;GAC/B,UAAUwB;GACV,MAAMf,EAAQ,KAAK;GACnB,OAAOK,EAAW,IAAIL,EAAQ,MAAM,IAAI,KAAA;EAC1C;CACF;AACF"}

package/dist/components/questionnaire/QuestionnaireItem/QuestionnaireItem.js

@@ -26,8 +26,7 @@ function m(s) {
 		required: () => h.required,
 		multiple: () => h.multiple,
 		disabled: () => h.disabled,
-		invalid: () => h.invalid,
-		onStatusChange: (e) => h.onStatusChange?.(e)
+		invalid: () => h.invalid
 	}), v;
 	return l(() => {
 		let e = _.context.status();

package/dist/components/questionnaire/QuestionnaireItem/QuestionnaireItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"QuestionnaireItem.js","names":["createEffect","mergeProps","onCleanup","splitProps","clsx","QuestionnaireItemContext","useQuestionnaireItem","QuestionnaireItemStatus","QuestionnaireItemProps","QuestionnaireItem","props","merged","required","multiple","disabled","invalid","local","rest","engine","name","onStatusChange","status","lastStatus","context","undefined","_$createComponent","Provider","value","children","_el$","_tmpl$","_$use","el","registerElement","_$spread","_$mergeProps","hidden","active","inert","aria-describedby","describedBy","aria-invalid","aria-keyshortcuts","keyshortcuts","data-active","data-status","data-invalid","data-disabled","class","classList","_$insert","mergeProps","_$createComponent","_$mergeProps","mergeProps$1","_tmpl$","QuestionnaireItem","merged","props","local","rest","splitProps","engine","useQuestionnaireItem","status","lastStatus","createEffect","createComponent","QuestionnaireItemContext","_el$","use","el","spread","mergeProps","\"tabIndex\"","\"class\"","clsx","insert"],"sources":["../../../../src/components/questionnaire/QuestionnaireItem/QuestionnaireItem.tsx"],"sourcesContent":["import { createEffect, mergeProps, onCleanup, splitProps } from \"solid-js\";\nimport { clsx } from \"~/utils\";\nimport { QuestionnaireItemContext } from \"../questionnaire.context\";\nimport { useQuestionnaireItem } from \"../useQuestionnaireItem\";\nimport type { QuestionnaireItemStatus } from \"../questionnaire.types\";\nimport type { QuestionnaireItemProps } from \"../questionnaire.types\";\n\n/** 单个题目:fieldset,非激活时 hidden + inert,并向 Root 注册命令式句柄 */\nexport function QuestionnaireItem(props: QuestionnaireItemProps) {\n  const merged = mergeProps(\n    { required: false, multiple: false, disabled: false, invalid: false },\n    props,\n  );\n  const [local, rest] = splitProps(merged, [\n    \"name\",\n    \"required\",\n    \"multiple\",\n    \"disabled\",\n    \"invalid\",\n    \"onStatusChange\",\n    \"class\",\n    \"classList\",\n    \"children\",\n  ]);\n\n  const engine = useQuestionnaireItem({\n    name: local.name,\n    required: () => local.required,\n    multiple: () => local.multiple,\n    disabled: () => local.disabled,\n    invalid: () => local.invalid,\n    onStatusChange: (status) => local.onStatusChange?.(status),\n  });\n\n  let lastStatus: QuestionnaireItemStatus | undefined;\n  createEffect(() => {\n    const status = engine.context.status();\n    if (lastStatus !== undefined && lastStatus !== status) {\n      local.onStatusChange?.(status);\n    }\n    lastStatus = status;\n  });\n\n  return (\n    <QuestionnaireItemContext.Provider value={engine.context}>\n      <fieldset\n        {...rest}\n        ref={(el) => {\n          onCleanup(engine.registerElement(el));\n        }}\n        disabled={engine.context.disabled()}\n        hidden={!engine.context.active()}\n        inert={!engine.context.active()}\n        tabIndex={-1}\n        aria-describedby={engine.describedBy()}\n        aria-invalid={engine.context.invalid() || undefined}\n        aria-keyshortcuts={engine.keyshortcuts()}\n        data-slot=\"questionnaire-item\"\n        data-active={engine.context.active() ? \"\" : undefined}\n        data-status={engine.context.status()}\n        data-invalid={engine.context.invalid() ? \"\" : undefined}\n        data-disabled={engine.context.disabled() ? \"\" : undefined}\n        class={clsx(\n          \"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none\",\n          local.class,\n        )}\n        classList={local.classList}\n      >\n        {local.children}\n      </fieldset>\n    </QuestionnaireItemContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;AAQA,SAAgBS,EAAkBC,GAA+B;CAC/D,IAAMC,IAASV,EACb;EAAEW,UAAU;EAAOC,UAAU;EAAOC,UAAU;EAAOC,SAAS;CAAM,GACpEL,CACF,GACM,CAACM,GAAOC,KAAQd,EAAWQ,GAAQ;EACvC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAAU,CACX,GAEKO,IAASZ,EAAqB;EAClCa,MAAMH,EAAMG;EACZP,gBAAgBI,EAAMJ;EACtBC,gBAAgBG,EAAMH;EACtBC,gBAAgBE,EAAMF;EACtBC,eAAeC,EAAMD;EACrBK,iBAAiBC,MAAWL,EAAMI,iBAAiBC,CAAM;CAC3D,CAAC,GAEGC;CASJ,OARAtB,QAAmB;EACjB,IAAMqB,IAASH,EAAOK,QAAQF,OAAO;EAIrCC,AAHIA,MAAeE,KAAAA,KAAaF,MAAeD,KAC7CL,EAAMI,iBAAiBC,CAAM,GAE/BC,IAAaD;CACf,CAAC,GAEDI,EACGpB,EAAyBqB,UAAQ;EAAA,IAACC,QAAK;GAAA,OAAET,EAAOK;EAAO;EAAA,IAAAK,WAAA;GAAA,IAAAC,IAAAC,EAAA;GAwBrC,OAxBqCC,GAG9CC,MAAO;IACX9B,EAAUgB,EAAOe,gBAAgBD,CAAE,CAAC;GACtC,GAACH,CAAA,GAAAK,EAAAL,GAAAM,EAHGlB,GAAI;IAAA,IAIRH,WAAQ;KAAA,OAAEI,EAAOK,QAAQT,SAAS;IAAC;IAAA,IACnCsB,SAAM;KAAA,OAAE,CAAClB,EAAOK,QAAQc,OAAO;IAAC;IAAA,IAChCC,QAAK;KAAA,OAAE,CAACpB,EAAOK,QAAQc,OAAO;IAAC;IAAAqC,UAAA;IAAA,IAAA,qBAAA;KAAA,OAEbxD,EAAOsB,YAAY;IAAC;IAAA,IAAA,iBAAA;KAAA,OACxBtB,EAAOK,QAAQR,QAAQ,KAAKS,KAAAA;IAAS;IAAA,IAAA,sBAAA;KAAA,OAChCN,EAAOyB,aAAa;IAAC;IAAA,aAC9B;IAAoB,IAAA,gBAAA;KAAA,OACjBzB,EAAOK,QAAQc,OAAO,IAAI,KAAKb,KAAAA;IAAS;IAAA,IAAA,gBAAA;KAAA,OACxCN,EAAOK,QAAQF,OAAO;IAAC;IAAA,IAAA,iBAAA;KAAA,OACtBH,EAAOK,QAAQR,QAAQ,IAAI,KAAKS,KAAAA;IAAS;IAAA,IAAA,kBAAA;KAAA,OACxCN,EAAOK,QAAQT,SAAS,IAAI,KAAKU,KAAAA;IAAS;IAAA,IAAAmD,QAAA;KAAA,OAClDvE,EACL,yDACAY,EAAMgC,KACR;IAAC;IAAA,IACDC,YAAS;KAAA,OAAEjC,EAAMiC;IAAS;GAAA,CAAA,GAAA,IAAA,EAAA,GAAAC,EAAArB,SAEzBb,EAAMY,QAAQ,GAAAC;EAAA;CAAA,CAAA;AAIvB"}
+{"version":3,"file":"QuestionnaireItem.js","names":["createEffect","mergeProps","onCleanup","splitProps","clsx","QuestionnaireItemContext","useQuestionnaireItem","QuestionnaireItemStatus","QuestionnaireItemProps","QuestionnaireItem","props","merged","required","multiple","disabled","invalid","local","rest","engine","name","lastStatus","status","context","undefined","onStatusChange","_$createComponent","Provider","value","children","_el$","_tmpl$","_$use","el","registerElement","_$spread","_$mergeProps","hidden","active","inert","aria-describedby","describedBy","aria-invalid","aria-keyshortcuts","keyshortcuts","data-active","data-status","data-invalid","data-disabled","class","classList","_$insert","mergeProps","_$createComponent","_$mergeProps","mergeProps$1","_tmpl$","QuestionnaireItem","merged","props","local","rest","splitProps","engine","useQuestionnaireItem","lastStatus","createEffect","status","createComponent","QuestionnaireItemContext","_el$","use","el","spread","mergeProps","\"tabIndex\"","\"class\"","clsx","insert"],"sources":["../../../../src/components/questionnaire/QuestionnaireItem/QuestionnaireItem.tsx"],"sourcesContent":["import { createEffect, mergeProps, onCleanup, splitProps } from \"solid-js\";\nimport { clsx } from \"~/utils\";\nimport { QuestionnaireItemContext } from \"../questionnaire.context\";\nimport { useQuestionnaireItem } from \"../useQuestionnaireItem\";\nimport type { QuestionnaireItemStatus } from \"../questionnaire.types\";\nimport type { QuestionnaireItemProps } from \"../questionnaire.types\";\n\n/** 单个题目:fieldset,非激活时 hidden + inert,并向 Root 注册命令式句柄 */\nexport function QuestionnaireItem(props: QuestionnaireItemProps) {\n  const merged = mergeProps(\n    { required: false, multiple: false, disabled: false, invalid: false },\n    props,\n  );\n  const [local, rest] = splitProps(merged, [\n    \"name\",\n    \"required\",\n    \"multiple\",\n    \"disabled\",\n    \"invalid\",\n    \"onStatusChange\",\n    \"class\",\n    \"classList\",\n    \"children\",\n  ]);\n\n  const engine = useQuestionnaireItem({\n    name: local.name,\n    required: () => local.required,\n    multiple: () => local.multiple,\n    disabled: () => local.disabled,\n    invalid: () => local.invalid,\n  });\n\n  let lastStatus: QuestionnaireItemStatus | undefined;\n  createEffect(() => {\n    const status = engine.context.status();\n    if (lastStatus !== undefined && lastStatus !== status) {\n      local.onStatusChange?.(status);\n    }\n    lastStatus = status;\n  });\n\n  return (\n    <QuestionnaireItemContext.Provider value={engine.context}>\n      <fieldset\n        {...rest}\n        ref={(el) => {\n          onCleanup(engine.registerElement(el));\n        }}\n        disabled={engine.context.disabled()}\n        hidden={!engine.context.active()}\n        inert={!engine.context.active()}\n        tabIndex={-1}\n        aria-describedby={engine.describedBy()}\n        aria-invalid={engine.context.invalid() || undefined}\n        aria-keyshortcuts={engine.keyshortcuts()}\n        data-slot=\"questionnaire-item\"\n        data-active={engine.context.active() ? \"\" : undefined}\n        data-status={engine.context.status()}\n        data-invalid={engine.context.invalid() ? \"\" : undefined}\n        data-disabled={engine.context.disabled() ? \"\" : undefined}\n        class={clsx(\n          \"flex min-w-0 flex-col gap-4 border-0 p-0 outline-none\",\n          local.class,\n        )}\n        classList={local.classList}\n      >\n        {local.children}\n      </fieldset>\n    </QuestionnaireItemContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;AAQA,SAAgBS,EAAkBC,GAA+B;CAC/D,IAAMC,IAASV,EACb;EAAEW,UAAU;EAAOC,UAAU;EAAOC,UAAU;EAAOC,SAAS;CAAM,GACpEL,CACF,GACM,CAACM,GAAOC,KAAQd,EAAWQ,GAAQ;EACvC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CAAU,CACX,GAEKO,IAASZ,EAAqB;EAClCa,MAAMH,EAAMG;EACZP,gBAAgBI,EAAMJ;EACtBC,gBAAgBG,EAAMH;EACtBC,gBAAgBE,EAAMF;EACtBC,eAAeC,EAAMD;CACvB,CAAC,GAEGK;CASJ,OARApB,QAAmB;EACjB,IAAMqB,IAASH,EAAOI,QAAQD,OAAO;EAIrCD,AAHIA,MAAeG,KAAAA,KAAaH,MAAeC,KAC7CL,EAAMQ,iBAAiBH,CAAM,GAE/BD,IAAaC;CACf,CAAC,GAEDI,EACGpB,EAAyBqB,UAAQ;EAAA,IAACC,QAAK;GAAA,OAAET,EAAOI;EAAO;EAAA,IAAAM,WAAA;GAAA,IAAAC,IAAAC,EAAA;GAwBrC,OAxBqCC,GAG9CC,MAAO;IACX9B,EAAUgB,EAAOe,gBAAgBD,CAAE,CAAC;GACtC,GAACH,CAAA,GAAAK,EAAAL,GAAAM,EAHGlB,GAAI;IAAA,IAIRH,WAAQ;KAAA,OAAEI,EAAOI,QAAQR,SAAS;IAAC;IAAA,IACnCsB,SAAM;KAAA,OAAE,CAAClB,EAAOI,QAAQe,OAAO;IAAC;IAAA,IAChCC,QAAK;KAAA,OAAE,CAACpB,EAAOI,QAAQe,OAAO;IAAC;IAAAqC,UAAA;IAAA,IAAA,qBAAA;KAAA,OAEbxD,EAAOsB,YAAY;IAAC;IAAA,IAAA,iBAAA;KAAA,OACxBtB,EAAOI,QAAQP,QAAQ,KAAKQ,KAAAA;IAAS;IAAA,IAAA,sBAAA;KAAA,OAChCL,EAAOyB,aAAa;IAAC;IAAA,aAC9B;IAAoB,IAAA,gBAAA;KAAA,OACjBzB,EAAOI,QAAQe,OAAO,IAAI,KAAKd,KAAAA;IAAS;IAAA,IAAA,gBAAA;KAAA,OACxCL,EAAOI,QAAQD,OAAO;IAAC;IAAA,IAAA,iBAAA;KAAA,OACtBH,EAAOI,QAAQP,QAAQ,IAAI,KAAKQ,KAAAA;IAAS;IAAA,IAAA,kBAAA;KAAA,OACxCL,EAAOI,QAAQR,SAAS,IAAI,KAAKS,KAAAA;IAAS;IAAA,IAAAoD,QAAA;KAAA,OAClDvE,EACL,yDACAY,EAAMgC,KACR;IAAC;IAAA,IACDC,YAAS;KAAA,OAAEjC,EAAMiC;IAAS;GAAA,CAAA,GAAA,IAAA,EAAA,GAAAC,EAAArB,SAEzBb,EAAMY,QAAQ,GAAAC;EAAA;CAAA,CAAA;AAIvB"}

package/dist/components/questionnaire/questionnaire.answers.d.ts

@@ -0,0 +1,42 @@
+import { Accessor } from 'solid-js';
+import { QuestionnaireAnswerEntry } from './questionnaire.context';
+import { QuestionnaireItemStatus } from './questionnaire.types';
+export interface AnswerBookkeepingOptions {
+    /** 多选：选中集合可以有多项 */
+    multiple: Accessor<boolean>;
+    /** 必填：必填题不允许跳过 */
+    required: Accessor<boolean>;
+}
+export interface AnswerBookkeeping {
+    answers: Accessor<QuestionnaireAnswerEntry[]>;
+    selections: Accessor<string[]>;
+    defaults: Accessor<string[]>;
+    touched: Accessor<boolean>;
+    /** 每次 reset 自增，供子组件强制同步 DOM */
+    resetVersion: Accessor<number>;
+    status: Accessor<QuestionnaireItemStatus>;
+    /** 已跳过：状态为 skipped 且不是必填 */
+    skippable: Accessor<boolean>;
+    answeredOk: Accessor<boolean>;
+    hasInputAnswer: Accessor<boolean>;
+    registerAnswerControl: (entry: QuestionnaireAnswerEntry) => () => void;
+    registerAnswerSelection: (id: string, initialSelected: boolean) => () => void;
+    setAnswerDefault: (id: string, selected: boolean) => void;
+    setAnswerSelectionFromInteraction: (id: string, selected: boolean) => void;
+    syncControlledAnswerSelection: (id: string, selected: boolean) => void;
+    getAnswerByElement: (target: Element) => QuestionnaireAnswerEntry | null;
+    /** 标记已交互（首次校验失败后才显示错误） */
+    markTouched: () => void;
+    /** 跳过本题目；必填时返回 false 且不改变状态 */
+    skip: () => boolean;
+    /** 回到默认选择并把 touched/skipped 复位 */
+    reset: () => void;
+}
+/**
+ * 单个题目的答案账目：注册了哪些答案控件、选中的是哪些、默认值是什么、
+ * 是否被跳过/触碰，以及由这些推导出的作答状态。
+ *
+ * 单一职责：只维护这份账目与它的读写方法，不碰 DOM 焦点、不拼 ARIA 文本、
+ * 不决定校验结果——那些是 item 层的事。
+ */
+export declare function createAnswerBookkeeping(options: AnswerBookkeepingOptions): AnswerBookkeeping;

package/dist/components/questionnaire/questionnaire.answers.js

@@ -0,0 +1,62 @@
+import { isAnswerDisabled as e } from "./questionnaire.utils.js";
+import { createMemo as t, createSignal as n } from "solid-js";
+//#region src/components/questionnaire/questionnaire.answers.ts
+function r(r) {
+	let [i, a] = n([]), [o, s] = n([]), [c, l] = n([]), [u, d] = n(!1), [f, p] = n(!1), [m, h] = n(0), g = (e, t) => {
+		s((n) => t ? r.multiple() ? n.includes(e) ? n : [...n, e] : [e] : n.filter((t) => t !== e));
+	}, _ = t(() => i().some((e) => e.type === "input" && ![
+		"button",
+		"checkbox",
+		"radio",
+		"reset",
+		"submit"
+	].includes(e.element.type))), v = t(() => {
+		if (u()) return "skipped";
+		let t = o();
+		return i().some((n) => t.includes(n.id) && !e(n)) ? "answered" : "unanswered";
+	});
+	return {
+		answers: i,
+		selections: o,
+		defaults: c,
+		touched: f,
+		resetVersion: m,
+		status: v,
+		hasInputAnswer: _,
+		skippable: t(() => v() === "skipped" && !r.required()),
+		answeredOk: t(() => v() === "answered"),
+		registerAnswerControl(e) {
+			return a((t) => [...t.filter((t) => t.id !== e.id && t.element !== e.element), e]), () => a((t) => t.filter((t) => t !== e));
+		},
+		registerAnswerSelection(e, t) {
+			return t && s((t) => r.multiple() ? t.includes(e) ? t : [...t, e] : t.length ? t : [e]), () => {
+				s((t) => t.filter((t) => t !== e)), l((t) => t.filter((t) => t !== e));
+			};
+		},
+		setAnswerDefault(e, t) {
+			l((n) => t ? n.includes(e) ? n : [...n, e] : n.filter((t) => t !== e));
+		},
+		setAnswerSelectionFromInteraction(e, t) {
+			d(!1), g(e, t);
+		},
+		syncControlledAnswerSelection(e, t) {
+			g(e, t);
+		},
+		getAnswerByElement(e) {
+			return i().find((t) => t.element === e) ?? null;
+		},
+		markTouched() {
+			p(!0);
+		},
+		skip() {
+			return !r.required() && (s([]), d(!0), !0);
+		},
+		reset() {
+			p(!1), d(!1), s(r.multiple() ? [...c()] : c().slice(0, 1)), h((e) => e + 1);
+		}
+	};
+}
+//#endregion
+export { r as createAnswerBookkeeping };
+
+//# sourceMappingURL=questionnaire.answers.js.map

package/dist/components/questionnaire/questionnaire.answers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire.answers.js","names":["createAnswerBookkeeping","answers","setAnswers","createSignal","selections","setSelections","defaults","setDefaults","skipped","setSkipped","touched","setTouched","resetVersion","setResetVersion","applySelection","selected","options","prev","id","value","hasInputAnswer","createMemo","entry","status","isAnswerDisabled","item","initialSelected","target"],"sources":["../../../src/components/questionnaire/questionnaire.answers.ts"],"sourcesContent":["import { createMemo, createSignal, type Accessor } from \"solid-js\";\nimport type { QuestionnaireAnswerEntry } from \"./questionnaire.context\";\nimport type { QuestionnaireItemStatus } from \"./questionnaire.types\";\nimport { isAnswerDisabled } from \"./questionnaire.utils\";\n\nexport interface AnswerBookkeepingOptions {\n  /** 多选：选中集合可以有多项 */\n  multiple: Accessor<boolean>;\n  /** 必填：必填题不允许跳过 */\n  required: Accessor<boolean>;\n}\n\nexport interface AnswerBookkeeping {\n  answers: Accessor<QuestionnaireAnswerEntry[]>;\n  selections: Accessor<string[]>;\n  defaults: Accessor<string[]>;\n  touched: Accessor<boolean>;\n  /** 每次 reset 自增，供子组件强制同步 DOM */\n  resetVersion: Accessor<number>;\n  status: Accessor<QuestionnaireItemStatus>;\n  /** 已跳过：状态为 skipped 且不是必填 */\n  skippable: Accessor<boolean>;\n  answeredOk: Accessor<boolean>;\n  hasInputAnswer: Accessor<boolean>;\n\n  registerAnswerControl: (entry: QuestionnaireAnswerEntry) => () => void;\n  registerAnswerSelection: (id: string, initialSelected: boolean) => () => void;\n  setAnswerDefault: (id: string, selected: boolean) => void;\n  setAnswerSelectionFromInteraction: (id: string, selected: boolean) => void;\n  syncControlledAnswerSelection: (id: string, selected: boolean) => void;\n  getAnswerByElement: (target: Element) => QuestionnaireAnswerEntry | null;\n\n  /** 标记已交互（首次校验失败后才显示错误） */\n  markTouched: () => void;\n  /** 跳过本题目；必填时返回 false 且不改变状态 */\n  skip: () => boolean;\n  /** 回到默认选择并把 touched/skipped 复位 */\n  reset: () => void;\n}\n\n/**\n * 单个题目的答案账目：注册了哪些答案控件、选中的是哪些、默认值是什么、\n * 是否被跳过/触碰，以及由这些推导出的作答状态。\n *\n * 单一职责：只维护这份账目与它的读写方法，不碰 DOM 焦点、不拼 ARIA 文本、\n * 不决定校验结果——那些是 item 层的事。\n */\nexport function createAnswerBookkeeping(\n  options: AnswerBookkeepingOptions,\n): AnswerBookkeeping {\n  const [answers, setAnswers] = createSignal<QuestionnaireAnswerEntry[]>([]);\n  const [selections, setSelections] = createSignal<string[]>([]);\n  const [defaults, setDefaults] = createSignal<string[]>([]);\n  const [skipped, setSkipped] = createSignal(false);\n  const [touched, setTouched] = createSignal(false);\n  const [resetVersion, setResetVersion] = createSignal(0);\n\n  const applySelection = (id: string, selected: boolean) => {\n    setSelections((prev) => {\n      if (!selected) return prev.filter((value) => value !== id);\n      if (!options.multiple()) return [id];\n      return prev.includes(id) ? prev : [...prev, id];\n    });\n  };\n\n  const hasInputAnswer = createMemo(() =>\n    answers().some(\n      (entry) =>\n        entry.type === \"input\" &&\n        ![\"button\", \"checkbox\", \"radio\", \"reset\", \"submit\"].includes(\n          entry.element.type,\n        ),\n    ),\n  );\n\n  const status = createMemo<QuestionnaireItemStatus>(() => {\n    if (skipped()) return \"skipped\";\n    const selected = selections();\n    const answered = answers().some(\n      (entry) => selected.includes(entry.id) && !isAnswerDisabled(entry),\n    );\n    return answered ? \"answered\" : \"unanswered\";\n  });\n\n  return {\n    answers,\n    selections,\n    defaults,\n    touched,\n    resetVersion,\n    status,\n    hasInputAnswer,\n    skippable: createMemo(() => status() === \"skipped\" && !options.required()),\n    answeredOk: createMemo(() => status() === \"answered\"),\n\n    registerAnswerControl(entry) {\n      setAnswers((prev) => [\n        ...prev.filter(\n          (item) => item.id !== entry.id && item.element !== entry.element,\n        ),\n        entry,\n      ]);\n      return () => setAnswers((prev) => prev.filter((item) => item !== entry));\n    },\n\n    registerAnswerSelection(id, initialSelected) {\n      if (initialSelected) {\n        setSelections((prev) => {\n          if (!options.multiple()) return prev.length ? prev : [id];\n          return prev.includes(id) ? prev : [...prev, id];\n        });\n      }\n      return () => {\n        setSelections((prev) => prev.filter((value) => value !== id));\n        setDefaults((prev) => prev.filter((value) => value !== id));\n      };\n    },\n\n    setAnswerDefault(id, selected) {\n      setDefaults((prev) => {\n        if (!selected) return prev.filter((value) => value !== id);\n        return prev.includes(id) ? prev : [...prev, id];\n      });\n    },\n\n    setAnswerSelectionFromInteraction(id, selected) {\n      // 用户重新作答即视为取消\"跳过\"\n      setSkipped(false);\n      applySelection(id, selected);\n    },\n\n    syncControlledAnswerSelection(id, selected) {\n      applySelection(id, selected);\n    },\n\n    getAnswerByElement(target) {\n      return answers().find((entry) => entry.element === target) ?? null;\n    },\n\n    markTouched() {\n      setTouched(true);\n    },\n\n    skip() {\n      if (options.required()) return false;\n      setSelections([]);\n      setSkipped(true);\n      return true;\n    },\n\n    reset() {\n      setTouched(false);\n      setSkipped(false);\n      setSelections(\n        options.multiple() ? [...defaults()] : defaults().slice(0, 1),\n      );\n      setResetVersion((value) => value + 1);\n    },\n  };\n}\n"],"mappings":";;;AA+CA,SAAgBA,EACd,GACmB;CACnB,IAAM,CAACC,GAASC,KAAcC,EAAyC,CAAC,CAAC,GACnE,CAACC,GAAYC,KAAiBF,EAAuB,CAAC,CAAC,GACvD,CAACG,GAAUC,KAAeJ,EAAuB,CAAC,CAAC,GACnD,CAACK,GAASC,KAAcN,EAAa,EAAK,GAC1C,CAACO,GAASC,KAAcR,EAAa,EAAK,GAC1C,CAACS,GAAcC,KAAmBV,EAAa,CAAC,GAEhDW,KAAkB,GAAY,MAAsB;EACxD,GAAe,MACRC,IACAC,EAAQ,SAAS,IACfC,EAAK,SAASC,CAAE,IAAID,IAAO,CAAC,GAAGA,GAAMC,CAAE,IADd,CAACA,CAAE,IADbD,EAAK,QAAQ,MAAUE,MAAUD,CAAE,CAG1D;CACH,GAEME,IAAiBC,QACrBpB,EAAQ,CAAC,CAAC,MACP,MACCqB,EAAM,SAAS,WACf,CAAC;EAAC;EAAU;EAAY;EAAS;EAAS;CAAQ,CAAC,CAAC,SAClDA,EAAM,QAAQ,IAChB,CACJ,CACF,GAEMC,IAASF,QAA0C;EACvD,IAAIb,EAAQ,GAAG,OAAO;EACtB,IAAMO,IAAWX,EAAW;EAI5B,OAHiBH,EAAQ,CAAC,CAAC,MACxB,MAAUc,EAAS,SAASO,EAAM,EAAE,KAAK,CAACE,EAAiBF,CAAK,CAE5D,IAAW,aAAa;CACjC,CAAC;CAED,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA,WAAWD,QAAiBE,EAAO,MAAM,aAAa,CAACP,EAAQ,SAAS,CAAC;EACzE,YAAYK,QAAiBE,EAAO,MAAM,UAAU;EAEpD,sBAAsB,GAAO;GAO3B,OANArB,GAAY,MAAS,CACnB,GAAGe,EAAK,QACL,MAASQ,EAAK,OAAOH,EAAM,MAAMG,EAAK,YAAYH,EAAM,OAC3D,GACAA,CACF,CAAC,SACYpB,GAAY,MAASe,EAAK,QAAQ,MAASQ,MAASH,CAAK,CAAC;EACzE;EAEA,wBAAwB,GAAI,GAAiB;GAO3C,OANII,KACFrB,GAAe,MACRW,EAAQ,SAAS,IACfC,EAAK,SAASC,CAAE,IAAID,IAAO,CAAC,GAAGA,GAAMC,CAAE,IADdD,EAAK,SAASA,IAAO,CAACC,CAAE,CAEzD,SAEU;IAEX,AADAb,GAAe,MAASY,EAAK,QAAQ,MAAUE,MAAUD,CAAE,CAAC,GAC5DX,GAAa,MAASU,EAAK,QAAQ,MAAUE,MAAUD,CAAE,CAAC;GAC5D;EACF;EAEA,iBAAiB,GAAI,GAAU;GAC7B,GAAa,MACNH,IACEE,EAAK,SAASC,CAAE,IAAID,IAAO,CAAC,GAAGA,GAAMC,CAAE,IADxBD,EAAK,QAAQ,MAAUE,MAAUD,CAAE,CAE1D;EACH;EAEA,kCAAkC,GAAI,GAAU;GAG9C,AADAT,EAAW,EAAK,GAChBK,EAAeI,GAAIH,CAAQ;EAC7B;EAEA,8BAA8B,GAAI,GAAU;GAC1C,EAAeG,GAAIH,CAAQ;EAC7B;EAEA,mBAAmB,GAAQ;GACzB,OAAOd,EAAQ,CAAC,CAAC,MAAM,MAAUqB,EAAM,YAAYK,CAAM,KAAK;EAChE;EAEA,cAAc;GACZ,EAAW,EAAI;EACjB;EAEA,OAAO;GAIL,OAHA,CAAIX,EAAQ,SAAS,MACrBX,EAAc,CAAC,CAAC,GAChBI,EAAW,EAAI,GACR;EACT;EAEA,QAAQ;GAMN,AALAE,EAAW,EAAK,GAChBF,EAAW,EAAK,GAChBJ,EACEW,EAAQ,SAAS,IAAI,CAAC,GAAGV,EAAS,CAAC,IAAIA,EAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAC9D,GACAO,GAAiB,MAAUM,IAAQ,CAAC;EACtC;CACF;AACF"}

package/dist/components/questionnaire/questionnaire.aria.d.ts

@@ -0,0 +1,34 @@
+import { Accessor } from 'solid-js';
+import { QuestionnaireItemStatus } from './questionnaire.types';
+/**
+ * 题目 ARIA 文本的组装与 id 登记。
+ *
+ * 单一职责：只负责"对外描述文字"——`aria-describedby` 的 id 合并、
+ * `aria-keyshortcuts` 的按键列表。不持有作答状态，也不决定对错：
+ * 是否无效、是否首尾题都由调用方以布尔量传入。
+ */
+export interface IdRegistry {
+    ids: Accessor<string[]>;
+    /** 登记一个 id（重复登记不会加两次），返回注销函数 */
+    register: (id: string) => () => void;
+}
+/** 生成 id 集合并提供登记/注销：描述与错误的多个来源各自登记，读取时合并 */
+export declare function createIdRegistry(): IdRegistry;
+/**
+ * `aria-describedby`：描述 id 常驻，只有**当前无效**时才附上错误 id，
+ * 去重后以空格连接；没有任何 id 时返回 undefined（不输出空属性）。
+ */
+export declare function buildDescribedBy(descriptionIds: readonly string[], errorIds: readonly string[], invalid: boolean): string | undefined;
+/**
+ * `aria-keyshortcuts`：只在题目处于激活态时给出（键盘操作只作用于当前题）。
+ * - 始终可提交（Mod+Enter）；
+ * - 有答案控件时上下箭头可在答案间移动；
+ * - 非首题才提示上一题；非末题且已作答才提示下一题（未作答时右箭头不前进）。
+ */
+export declare function buildItemKeyshortcuts(input: {
+    active: boolean;
+    hasAnswers: boolean;
+    first: boolean;
+    last: boolean;
+    status: QuestionnaireItemStatus;
+}): string | undefined;

package/dist/components/questionnaire/questionnaire.aria.js

@@ -0,0 +1,28 @@
+import { createSignal as e } from "solid-js";
+//#region src/components/questionnaire/questionnaire.aria.ts
+function t() {
+	let [t, n] = e([]);
+	return {
+		ids: t,
+		register(e) {
+			return n((t) => t.includes(e) ? t : [...t, e]), () => n((t) => t.filter((t) => t !== e));
+		}
+	};
+}
+function n(e, t, n) {
+	let r = [...e, ...n ? t : []];
+	return [...new Set(r)].join(" ") || void 0;
+}
+function r(e) {
+	let { active: t, hasAnswers: n, first: r, last: i, status: a } = e;
+	if (t) return [
+		"Meta+Enter Control+Enter",
+		n ? "ArrowUp ArrowDown" : null,
+		r ? null : "ArrowLeft",
+		!i && a !== "unanswered" ? "ArrowRight" : null
+	].filter(Boolean).join(" ");
+}
+//#endregion
+export { n as buildDescribedBy, r as buildItemKeyshortcuts, t as createIdRegistry };
+
+//# sourceMappingURL=questionnaire.aria.js.map

package/dist/components/questionnaire/questionnaire.aria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire.aria.js","names":["createIdRegistry","ids","setIds","createSignal","prev","id","value","buildDescribedBy","descriptionIds","invalid","errorIds","buildItemKeyshortcuts","input","active","hasAnswers","first","last","status"],"sources":["../../../src/components/questionnaire/questionnaire.aria.ts"],"sourcesContent":["import { createSignal, type Accessor } from \"solid-js\";\nimport type { QuestionnaireItemStatus } from \"./questionnaire.types\";\n\n/**\n * 题目 ARIA 文本的组装与 id 登记。\n *\n * 单一职责：只负责\"对外描述文字\"——`aria-describedby` 的 id 合并、\n * `aria-keyshortcuts` 的按键列表。不持有作答状态，也不决定对错：\n * 是否无效、是否首尾题都由调用方以布尔量传入。\n */\n\nexport interface IdRegistry {\n  ids: Accessor<string[]>;\n  /** 登记一个 id（重复登记不会加两次），返回注销函数 */\n  register: (id: string) => () => void;\n}\n\n/** 生成 id 集合并提供登记/注销：描述与错误的多个来源各自登记，读取时合并 */\nexport function createIdRegistry(): IdRegistry {\n  const [ids, setIds] = createSignal<string[]>([]);\n\n  return {\n    ids,\n    register(id) {\n      setIds((prev) => (prev.includes(id) ? prev : [...prev, id]));\n      return () => setIds((prev) => prev.filter((value) => value !== id));\n    },\n  };\n}\n\n/**\n * `aria-describedby`：描述 id 常驻，只有**当前无效**时才附上错误 id，\n * 去重后以空格连接；没有任何 id 时返回 undefined（不输出空属性）。\n */\nexport function buildDescribedBy(\n  descriptionIds: readonly string[],\n  errorIds: readonly string[],\n  invalid: boolean,\n): string | undefined {\n  const ids = [...descriptionIds, ...(invalid ? errorIds : [])];\n  return [...new Set(ids)].join(\" \") || undefined;\n}\n\n/**\n * `aria-keyshortcuts`：只在题目处于激活态时给出（键盘操作只作用于当前题）。\n * - 始终可提交（Mod+Enter）；\n * - 有答案控件时上下箭头可在答案间移动；\n * - 非首题才提示上一题；非末题且已作答才提示下一题（未作答时右箭头不前进）。\n */\nexport function buildItemKeyshortcuts(input: {\n  active: boolean;\n  hasAnswers: boolean;\n  first: boolean;\n  last: boolean;\n  status: QuestionnaireItemStatus;\n}): string | undefined {\n  const { active, hasAnswers, first, last, status } = input;\n  if (!active) return undefined;\n\n  // 第一项是常量，拼接结果不可能为空串，因此不需要 `|| undefined` 兜底\n  return [\n    \"Meta+Enter Control+Enter\",\n    hasAnswers ? \"ArrowUp ArrowDown\" : null,\n    !first ? \"ArrowLeft\" : null,\n    !last && status !== \"unanswered\" ? \"ArrowRight\" : null,\n  ]\n    .filter(Boolean)\n    .join(\" \");\n}\n"],"mappings":";;AAkBA,SAAgBA,IAA+B;CAC7C,IAAM,CAACC,GAAKC,KAAUC,EAAuB,CAAC,CAAC;CAE/C,OAAO;EACL;EACA,SAAS,GAAI;GAEX,OADAD,GAAQ,MAAUE,EAAK,SAASC,CAAE,IAAID,IAAO,CAAC,GAAGA,GAAMC,CAAE,CAAE,SAC9CH,GAAQ,MAASE,EAAK,QAAQ,MAAUE,MAAUD,CAAE,CAAC;EACpE;CACF;AACF;AAMA,SAAgBE,EACd,GACA,GACA,GACoB;CACpB,IAAMN,IAAM,CAAC,GAAGO,GAAgB,GAAIC,IAAUC,IAAW,CAAC,CAAE;CAC5D,OAAO,CAAC,GAAG,IAAI,IAAIT,CAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,KAAA;AACxC;AAQA,SAAgBU,EAAsB,GAMf;CACrB,IAAM,EAAE,WAAQ,eAAY,UAAO,SAAM,cAAWC;CACpD,IAAKC,GAGL,OAAO;EACL;EACAC,IAAa,sBAAsB;EAClCC,IAAsB,OAAd;EACT,CAACC,KAAQC,MAAW,eAAe,eAAe;CACpD,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,GAAG;AACb"}

package/dist/components/questionnaire/questionnaire.dom-watch.d.ts

@@ -0,0 +1,9 @@
+import { Accessor } from 'solid-js';
+/**
+ * 监视表单子树里的 DOM 增删，返回一个"每次变化都会自增"的版本号。
+ *
+ * 单一职责：把结构变化变成一条可被 memo 依赖的响应式边——注册表本身是普通数组，
+ * 子节点被移动位置时注册顺序不变，只有 DOM 顺序变了，排序 memo 需要这条边才会重算。
+ * 环境不支持 `MutationObserver`（SSR）时不做任何事，版本号恒为 0。
+ */
+export declare function createDomVersionWatcher(root: Accessor<Element | undefined>): Accessor<number>;

package/dist/components/questionnaire/questionnaire.dom-watch.js

@@ -0,0 +1,18 @@
+import { createEffect as e, createSignal as t, onCleanup as n } from "solid-js";
+//#region src/components/questionnaire/questionnaire.dom-watch.ts
+function r(r) {
+	let [i, a] = t(0);
+	return e(() => {
+		let e = r();
+		if (!e || typeof MutationObserver > "u") return;
+		let t = new MutationObserver(() => a((e) => e + 1));
+		t.observe(e, {
+			childList: !0,
+			subtree: !0
+		}), a((e) => e + 1), n(() => t.disconnect());
+	}), i;
+}
+//#endregion
+export { r as createDomVersionWatcher };
+
+//# sourceMappingURL=questionnaire.dom-watch.js.map