@neut/ui 0.0.16 → 0.0.17

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

@@ -0,0 +1,82 @@
+import { JSX, ParentProps, ValidComponent } from 'solid-js';
+import { ButtonProps } from '../button';
+import { BaseProps, PolymorphicProps } from '../../types';
+export type QuestionnaireItemStatus = "unanswered" | "answered" | "skipped";
+export type QuestionnaireShortcutMode = "letters" | "numbers";
+export interface QuestionnaireChoiceDefinition {
+    disabled?: boolean;
+    value: string;
+}
+export interface QuestionnaireItemDefinition {
+    choices?: readonly QuestionnaireChoiceDefinition[];
+    disabled?: boolean;
+    name: string;
+    required?: boolean;
+}
+export interface QuestionnaireRootState {
+    current: number;
+    first: boolean;
+    last: boolean;
+    total: number;
+}
+interface BaseQuestionnaireProps extends BaseProps, ParentProps {
+    /** 初始激活项 */
+    defaultItem?: string;
+    /** 受控激活项;不传则由内部导航 */
+    item?: string;
+    /** 题目定义:提供后用于按定义顺序分配快捷键、校验名/required 一致性 */
+    items?: readonly QuestionnaireItemDefinition[];
+    onItemChange?: (item: string) => void;
+    /** 答案快捷键模式 */
+    shortcuts?: QuestionnaireShortcutMode;
+    /** 默认 true,关闭浏览器原生校验并走组件校验 */
+    noValidate?: boolean;
+    onReset?: (event: Event) => void;
+    onSubmit?: (event: SubmitEvent) => void;
+}
+export type QuestionnaireProps = PolymorphicProps<"form", BaseQuestionnaireProps, false>;
+export type QuestionnaireProgressProps = PolymorphicProps<"div", BaseProps & {
+    children?: JSX.Element | ((state: QuestionnaireRootState) => JSX.Element);
+}, false>;
+export type QuestionnaireItemProps = PolymorphicProps<"fieldset", BaseProps & {
+    name: string;
+    required?: boolean;
+    multiple?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    onStatusChange?: (status: QuestionnaireItemStatus) => void;
+    "aria-labelledby"?: string;
+}, false>;
+export type QuestionnaireTitleProps<T extends ValidComponent = "legend"> = PolymorphicProps<T, BaseProps & {
+    id?: string;
+    children?: JSX.Element;
+}>;
+export type QuestionnaireDescriptionProps<T extends ValidComponent = "p"> = PolymorphicProps<T, BaseProps & {
+    id?: string;
+    children?: JSX.Element;
+}>;
+export type QuestionnaireChoicesProps = PolymorphicProps<"div", BaseProps, false>;
+export type QuestionnaireChoiceProps = PolymorphicProps<"label", BaseProps & {
+    value: string;
+    checked?: boolean;
+    defaultChecked?: boolean;
+    disabled?: boolean;
+    onChange?: (event: Event) => void;
+}, false>;
+export type QuestionnaireInputType = "date" | "datetime-local" | "email" | "month" | "number" | "password" | "search" | "tel" | "text" | "time" | "url" | "week";
+export type QuestionnaireInputProps = PolymorphicProps<"input", BaseProps & {
+    type?: QuestionnaireInputType;
+    defaultValue?: string;
+    value?: string;
+    disabled?: boolean;
+    onChange?: (event: Event) => void;
+}, false>;
+export type QuestionnaireErrorProps<T extends ValidComponent = "p"> = PolymorphicProps<T, BaseProps & {
+    id?: string;
+    children?: JSX.Element;
+}>;
+export type QuestionnaireNavigationProps = PolymorphicProps<"button", BaseProps & {
+    variant?: ButtonProps<"button">["variant"];
+    size?: ButtonProps<"button">["size"];
+}, false>;
+export {};

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

@@ -0,0 +1,24 @@
+import { QuestionnaireShortcutMode } from './questionnaire.types';
+/** 字符串/数组是否含有非空白内容(与上游 ce 一致) */
+export declare function hasText(value: unknown): boolean;
+/** 按模式生成快捷键字母表:letters = A..Z,numbers = 1..9 */
+export declare function shortcutAlphabet(mode: QuestionnaireShortcutMode | null): string[];
+/** 把按下的键规范成快捷键(字母大小写无关),不匹配返回 null */
+export declare function normalizeShortcut(key: string, mode: QuestionnaireShortcutMode | null): string | null;
+/** 拼 aria-keyshortcuts:有启用状态时额外附上 Enter */
+export declare function keyShortcutText(shortcut: string | null, enterEnabled: boolean): string | undefined;
+/** 判断答案控件当前是否有值(choice 看 checked,input 看 name+value) */
+export declare function isAnswerFilled(entry: {
+    type: "choice" | "input";
+    element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+}): boolean;
+/** 文本类输入框为空(用于原生校验) */
+export declare function isTextInputEmpty(entry: {
+    type: "choice" | "input";
+    element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+}): boolean;
+/** 是否为可输入文本的控件(用于决定方向键是否应当导航而非移动焦点) */
+export declare function isTypingElement(element: EventTarget | null): boolean;
+export declare function isNativeRadio(element: EventTarget | null): boolean;
+/** 按文档顺序比较两个元素 */
+export declare function compareDocumentOrder(a: Element, b: Element): number;

package/dist/components/questionnaire/questionnaire.utils.js

@@ -0,0 +1,38 @@
+//#region src/components/questionnaire/questionnaire.utils.ts
+function e(e) {
+	return Array.isArray(e) ? e.some((e) => String(e).trim().length > 0) : e != null && String(e).trim().length > 0;
+}
+function t(e) {
+	return e === "letters" ? Array.from({ length: 26 }, (e, t) => String.fromCharCode(65 + t)) : e === "numbers" ? Array.from({ length: 9 }, (e, t) => String(t + 1)) : [];
+}
+function n(e, n) {
+	let r = n === "letters" ? e.toUpperCase() : e;
+	return t(n).includes(r) ? r : null;
+}
+function r(e, t) {
+	return [e, t ? "Enter" : null].filter(Boolean).join(" ") || void 0;
+}
+function i(t) {
+	return t.type === "choice" ? t.element.checked : t.element.hasAttribute("name") && e(t.element.value);
+}
+function a(e) {
+	return e instanceof HTMLTextAreaElement || e instanceof HTMLSelectElement ? !0 : e instanceof HTMLInputElement ? ![
+		"button",
+		"checkbox",
+		"radio",
+		"reset",
+		"submit"
+	].includes(e.type) : e instanceof HTMLElement && e.isContentEditable;
+}
+function o(e) {
+	return e instanceof HTMLInputElement && e.type === "radio";
+}
+function s(e, t) {
+	if (e === t) return 0;
+	let n = e.compareDocumentPosition(t);
+	return n & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : n & Node.DOCUMENT_POSITION_PRECEDING ? 1 : 0;
+}
+//#endregion
+export { s as compareDocumentOrder, e as hasText, i as isAnswerFilled, o as isNativeRadio, a as isTypingElement, r as keyShortcutText, n as normalizeShortcut, t as shortcutAlphabet };
+
+//# sourceMappingURL=questionnaire.utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire.utils.js","names":["hasText","value","item","shortcutAlphabet","mode","index","normalizeShortcut","normalized","key","keyShortcutText","shortcut","enterEnabled","isAnswerFilled","entry","isTypingElement","element","isNativeRadio","compareDocumentOrder","a","b","position"],"sources":["../../../src/components/questionnaire/questionnaire.utils.ts"],"sourcesContent":["import type { QuestionnaireShortcutMode } from \"./questionnaire.types\";\n\n/** 字符串/数组是否含有非空白内容(与上游 ce 一致) */\nexport function hasText(value: unknown): boolean {\n  if (Array.isArray(value)) {\n    return value.some((item) => String(item).trim().length > 0);\n  }\n  return value != null && String(value).trim().length > 0;\n}\n\n/** 按模式生成快捷键字母表:letters = A..Z,numbers = 1..9 */\nexport function shortcutAlphabet(\n  mode: QuestionnaireShortcutMode | null,\n): string[] {\n  if (mode === \"letters\") {\n    return Array.from({ length: 26 }, (_, index) =>\n      String.fromCharCode(65 + index),\n    );\n  }\n  if (mode === \"numbers\") {\n    return Array.from({ length: 9 }, (_, index) => String(index + 1));\n  }\n  return [];\n}\n\n/** 把按下的键规范成快捷键(字母大小写无关),不匹配返回 null */\nexport function normalizeShortcut(\n  key: string,\n  mode: QuestionnaireShortcutMode | null,\n): string | null {\n  const normalized = mode === \"letters\" ? key.toUpperCase() : key;\n  return shortcutAlphabet(mode).includes(normalized) ? normalized : null;\n}\n\n/** 拼 aria-keyshortcuts:有启用状态时额外附上 Enter */\nexport function keyShortcutText(\n  shortcut: string | null,\n  enterEnabled: boolean,\n): string | undefined {\n  return (\n    [shortcut, enterEnabled ? \"Enter\" : null].filter(Boolean).join(\" \") ||\n    undefined\n  );\n}\n\n/** 判断答案控件当前是否有值(choice 看 checked,input 看 name+value) */\nexport function isAnswerFilled(entry: {\n  type: \"choice\" | \"input\";\n  element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;\n}): boolean {\n  if (entry.type === \"choice\") {\n    return (entry.element as HTMLInputElement).checked;\n  }\n  return entry.element.hasAttribute(\"name\") && hasText(entry.element.value);\n}\n\n/** 文本类输入框为空(用于原生校验) */\nexport function isTextInputEmpty(entry: {\n  type: \"choice\" | \"input\";\n  element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;\n}): boolean {\n  return (\n    entry.type === \"input\" &&\n    [\"email\", \"password\", \"search\", \"tel\", \"text\", \"url\"].includes(\n      entry.element.type,\n    ) &&\n    !hasText(entry.element.value)\n  );\n}\n\n/** 是否为可输入文本的控件(用于决定方向键是否应当导航而非移动焦点) */\nexport function isTypingElement(element: EventTarget | null): boolean {\n  if (element instanceof HTMLTextAreaElement) return true;\n  if (element instanceof HTMLSelectElement) return true;\n  if (element instanceof HTMLInputElement) {\n    return ![\"button\", \"checkbox\", \"radio\", \"reset\", \"submit\"].includes(\n      element.type,\n    );\n  }\n  return element instanceof HTMLElement && element.isContentEditable;\n}\n\nexport function isNativeRadio(element: EventTarget | null): boolean {\n  return element instanceof HTMLInputElement && element.type === \"radio\";\n}\n\n/** 按文档顺序比较两个元素 */\nexport function compareDocumentOrder(a: Element, b: Element): number {\n  if (a === b) return 0;\n  const position = a.compareDocumentPosition(b);\n  if (position & Node.DOCUMENT_POSITION_FOLLOWING) return -1;\n  if (position & Node.DOCUMENT_POSITION_PRECEDING) return 1;\n  return 0;\n}\n"],"mappings":";AAGA,SAAgBA,EAAQ,GAAyB;CAI/C,OAHI,MAAM,QAAQC,CAAK,IACdA,EAAM,MAAM,MAAS,OAAOC,CAAI,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,IAErDD,KAAS,QAAQ,OAAOA,CAAK,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS;AACxD;AAGA,SAAgBE,EACd,GACU;CASV,OARIC,MAAS,YACJ,MAAM,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,MACpC,OAAO,aAAa,KAAKC,CAAK,CAChC,IAEED,MAAS,YACJ,MAAM,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAU,OAAOC,IAAQ,CAAC,CAAC,IAE3D,CAAC;AACV;AAGA,SAAgBC,EACd,GACA,GACe;CACf,IAAMC,IAAaH,MAAS,YAAYI,EAAI,YAAY,IAAIA;CAC5D,OAAOL,EAAiBC,CAAI,CAAC,CAAC,SAASG,CAAU,IAAIA,IAAa;AACpE;AAGA,SAAgBE,EACd,GACA,GACoB;CACpB,OACE,CAACC,GAAUC,IAAe,UAAU,IAAI,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG,KAClE,KAAA;AAEJ;AAGA,SAAgBC,EAAe,GAGnB;CAIV,OAHIC,EAAM,SAAS,WACTA,EAAM,QAA6B,UAEtCA,EAAM,QAAQ,aAAa,MAAM,KAAKb,EAAQa,EAAM,QAAQ,KAAK;AAC1E;AAiBA,SAAgBC,EAAgB,GAAsC;CAQpE,OAPIC,aAAmB,uBACnBA,aAAmB,oBAA0B,KAC7CA,aAAmB,mBACd,CAAC;EAAC;EAAU;EAAY;EAAS;EAAS;CAAQ,CAAC,CAAC,SACzDA,EAAQ,IACV,IAEKA,aAAmB,eAAeA,EAAQ;AACnD;AAEA,SAAgBC,EAAc,GAAsC;CAClE,OAAOD,aAAmB,oBAAoBA,EAAQ,SAAS;AACjE;AAGA,SAAgBE,EAAqB,GAAY,GAAoB;CACnE,IAAIC,MAAMC,GAAG,OAAO;CACpB,IAAMC,IAAWF,EAAE,wBAAwBC,CAAC;CAG5C,OAFIC,IAAW,KAAK,8BAAoC,KACpDA,IAAW,KAAK,8BAAoC,IACjD;AACT"}

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

@@ -0,0 +1,34 @@
+import { Accessor } from 'solid-js';
+import { QuestionnaireItemContextValue } from './questionnaire.context';
+import { QuestionnaireItemStatus } from './questionnaire.types';
+interface Options {
+    name: string;
+    required: Accessor<boolean>;
+    multiple: Accessor<boolean>;
+    disabled: Accessor<boolean>;
+    invalid: Accessor<boolean>;
+    onStatusChange?: (status: QuestionnaireItemStatus) => void;
+}
+export interface QuestionnaireItemDomProps {
+    "aria-describedby": string | undefined;
+    "aria-invalid": boolean | undefined;
+    "aria-keyshortcuts": string | undefined;
+    disabled: boolean;
+    hidden: boolean;
+    inert: boolean;
+    tabIndex: number;
+}
+export interface UseQuestionnaireItemResult {
+    context: QuestionnaireItemContextValue;
+    /** 反应式:每次读取都根据当前 active/invalid 重新计算 */
+    itemProps: () => QuestionnaireItemDomProps;
+    describedBy: () => string | undefined;
+    keyshortcuts: () => string | undefined;
+    /** 在 fieldset 的 ref 里调用:登记 DOM 元素并把句柄注册到 Root */
+    registerElement: (element: HTMLElement) => () => void;
+}
+/**
+ * 单个题目的状态:答案注册与选中、跳过、校验、快捷键,以及给 Root 的句柄。
+ */
+export declare function useQuestionnaireItem(options: Options): UseQuestionnaireItemResult;
+export {};

package/dist/components/questionnaire/useQuestionnaireItem.js

@@ -0,0 +1,141 @@
+import { useQuestionnaireRootContext as e } from "./questionnaire.context.js";
+import { isAnswerFilled as t, isNativeRadio as n, isTypingElement as r, shortcutAlphabet as i } from "./questionnaire.utils.js";
+import { createMemo as a, createSignal as o } from "solid-js";
+//#region src/components/questionnaire/useQuestionnaireItem.ts
+function s(s) {
+	let c = e("QuestionnaireItem"), [l, u] = o(), [d, f] = o([]), [p, m] = o([]), [h, g] = o([]), [_, v] = o(!1), [y, b] = o(!1), [x, S] = o(0), [C, w] = o([]), [T, E] = o([]), D = a(() => c.activeItemName() === s.name), O = (e) => (f((t) => [...t.filter((t) => t.id !== e.id && t.element !== e.element), e]), () => f((t) => t.filter((t) => t !== e))), k = (e, t) => {
+		m((n) => t ? s.multiple() ? n.includes(e) ? n : [...n, e] : [e] : n.filter((t) => t !== e));
+	}, A = (e, t) => (t && m((t) => s.multiple() ? t.includes(e) ? t : [...t, e] : t.length ? t : [e]), () => {
+		m((t) => t.filter((t) => t !== e)), g((t) => t.filter((t) => t !== e));
+	}), j = (e, t) => {
+		g((n) => t ? n.includes(e) ? n : [...n, e] : n.filter((t) => t !== e));
+	}, M = (e, t) => {
+		v(!1), k(e, t);
+	}, N = (e, t) => {
+		k(e, t);
+	}, P = (e) => e.disabled || e.element.disabled, F = a(() => d().some((e) => e.type === "input" && ![
+		"button",
+		"checkbox",
+		"radio",
+		"reset",
+		"submit"
+	].includes(e.element.type))), I = a(() => {
+		if (_()) return "skipped";
+		let e = p();
+		return d().some((t) => e.includes(t.id) && !P(t)) ? "answered" : "unanswered";
+	}), L = a(() => I() === "skipped" && !s.required()), R = a(() => I() === "answered"), z = a(() => !s.disabled() && !L() && (s.invalid() || y() && !(L() || !s.invalid() && R()))), B = () => {
+		let e = l();
+		if (!e) return;
+		let t = e.querySelector("input[data-filled][name]:not(:disabled)"), n = e.querySelector("input:not([type=hidden]):not(:disabled), textarea:not(:disabled)");
+		(t ?? n ?? e).focus();
+	}, V = () => {
+		if (b(!0), !(s.disabled() || I() === "skipped" && !s.required() || !s.invalid() && I() === "answered")) return !1;
+		if (!c.nativeValidation()) return !0;
+		let e = d().find((e) => t(e) && e.element.willValidate && !e.element.validity.valid);
+		return !e || (e.element.focus(), e.element.reportValidity(), !1);
+	}, H = () => {
+		s.required() || (m([]), v(!0));
+	}, U = () => {
+		b(!1), v(!1), m(s.multiple() ? [...h()] : h().slice(0, 1)), S((e) => e + 1);
+	}, W = (e) => d().find((t) => t.element === e) ?? null, G = a(() => {
+		let e = c.shortcuts(), t = c.itemDefinitions()?.get(s.name);
+		if (!e || !t?.choices) return null;
+		let n = i(e), r = /* @__PURE__ */ new Map(), a = 0;
+		for (let e of t.choices) {
+			if (e.disabled) continue;
+			let t = n[a];
+			if (!t) break;
+			r.set(e.value, t), a += 1;
+		}
+		return r;
+	}), K = a(() => {
+		if (G()) return /* @__PURE__ */ new Map();
+		let e = i(c.shortcuts()), t = d().filter((e) => e.type === "choice");
+		return new Map(t.slice(0, e.length).map((t, n) => [t.id, e[n]]));
+	}), q = (e) => {
+		let t = G();
+		if (t) {
+			let n = [...t.entries()].find(([, t]) => t === e)?.[0];
+			return d().find((e) => e.type === "choice" && e.value === n) ?? null;
+		}
+		let n = [...K().entries()].find(([, t]) => t === e)?.[0];
+		return d().find((e) => e.id === n) ?? null;
+	}, J = (e, t) => {
+		let i = l(), a = d().filter((t) => !P(t) && t.element.isConnected && !(r(e) && t.type === "input"));
+		if (!a.length) return !1;
+		let o = a.findIndex((t) => t.element === e);
+		if (o < 0 && e !== i) return !1;
+		let s = a[o < 0 ? t === "next" ? 0 : a.length - 1 : (o + (t === "next" ? 1 : -1) + a.length) % a.length];
+		return !s || s.element === e ? !1 : (s.element.focus(), s.type === "choice" && n(s.element) && s.element.click(), !0);
+	}, Y = () => {
+		let e = [...C(), ...z() ? T() : []];
+		return [...new Set(e)].join(" ") || void 0;
+	}, X = () => {
+		if (!D()) return;
+		let e = c.state();
+		return [
+			"Meta+Enter Control+Enter",
+			d().length ? "ArrowUp ArrowDown" : null,
+			e.first ? null : "ArrowLeft",
+			!e.last && I() !== "unanswered" ? "ArrowRight" : null
+		].filter(Boolean).join(" ") || void 0;
+	};
+	return {
+		context: {
+			name: s.name,
+			active: D,
+			disabled: s.disabled,
+			invalid: z,
+			multiple: s.multiple,
+			required: s.required,
+			status: I,
+			hasInputAnswer: F,
+			selectedAnswerIds: p,
+			resetVersion: x,
+			shortcutByAnswerId: K,
+			shortcutByChoiceValue: G,
+			shortcuts: c.shortcuts,
+			registerAnswerControl: O,
+			registerAnswerSelection: A,
+			registerDescription: (e) => (w((t) => t.includes(e) ? t : [...t, e]), () => w((t) => t.filter((t) => t !== e))),
+			registerError: (e) => (E((t) => t.includes(e) ? t : [...t, e]), () => E((t) => t.filter((t) => t !== e))),
+			setAnswerDefault: j,
+			setAnswerSelectionFromInteraction: M,
+			syncControlledAnswerSelection: N
+		},
+		itemProps: () => ({
+			"aria-describedby": Y(),
+			"aria-invalid": z() || void 0,
+			"aria-keyshortcuts": X(),
+			disabled: s.disabled(),
+			hidden: !D(),
+			inert: !D(),
+			tabIndex: -1
+		}),
+		registerElement: (e) => {
+			u(e);
+			let t = {
+				name: s.name,
+				element: e,
+				disabled: s.disabled,
+				required: s.required,
+				status: I,
+				validate: V,
+				focus: B,
+				focusInvalid: B,
+				skip: H,
+				reset: U,
+				getAnswerByElement: W,
+				getAnswerByShortcut: q,
+				moveAnswerFocus: J
+			};
+			return c.registerItem(t);
+		},
+		describedBy: Y,
+		keyshortcuts: X
+	};
+}
+//#endregion
+export { s as useQuestionnaireItem };
+
+//# sourceMappingURL=useQuestionnaireItem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQuestionnaireItem.js","names":["useQuestionnaireItem","root","useQuestionnaireRootContext","element","setElement","createSignal","answers","setAnswers","selections","setSelections","defaults","setDefaults","skipped","setSkipped","touched","setTouched","resetVersion","setResetVersion","descriptionIds","setDescriptionIds","errorIds","setErrorIds","active","createMemo","options","registerAnswerControl","prev","item","entry","applySelection","selected","id","value","registerAnswerSelection","initialSelected","setAnswerDefault","setAnswerSelectionFromInteraction","syncControlledAnswerSelection","isEntryDisabled","hasInputAnswer","status","skippable","answeredOk","invalid","focus","target","filled","anyInput","validate","answer","isAnswerFilled","skip","reset","getAnswerByElement","shortcutByChoiceValue","mode","definition","alphabet","shortcutAlphabet","map","cursor","choice","letter","shortcutByAnswerId","choices","index","getAnswerByShortcut","byValue","shortcut","moveAnswerFocus","scope","focusable","isTypingElement","position","next","direction","isNativeRadio","describedBy","ids","keyshortcuts","state","handle"],"sources":["../../../src/components/questionnaire/useQuestionnaireItem.ts"],"sourcesContent":["import { createMemo, createSignal, type Accessor } from \"solid-js\";\nimport {\n  useQuestionnaireRootContext,\n  type QuestionnaireAnswerEntry,\n  type QuestionnaireItemContextValue,\n  type QuestionnaireItemHandle,\n} from \"./questionnaire.context\";\nimport type { QuestionnaireItemStatus } from \"./questionnaire.types\";\nimport {\n  isAnswerFilled,\n  isNativeRadio,\n  isTypingElement,\n  shortcutAlphabet,\n} from \"./questionnaire.utils\";\n\ninterface Options {\n  name: string;\n  required: Accessor<boolean>;\n  multiple: Accessor<boolean>;\n  disabled: Accessor<boolean>;\n  invalid: Accessor<boolean>;\n  onStatusChange?: (status: QuestionnaireItemStatus) => void;\n}\n\nexport interface QuestionnaireItemDomProps {\n  \"aria-describedby\": string | undefined;\n  \"aria-invalid\": boolean | undefined;\n  \"aria-keyshortcuts\": string | undefined;\n  disabled: boolean;\n  hidden: boolean;\n  inert: boolean;\n  tabIndex: number;\n}\n\nexport interface UseQuestionnaireItemResult {\n  context: QuestionnaireItemContextValue;\n  /** 反应式:每次读取都根据当前 active/invalid 重新计算 */\n  itemProps: () => QuestionnaireItemDomProps;\n  describedBy: () => string | undefined;\n  keyshortcuts: () => string | undefined;\n  /** 在 fieldset 的 ref 里调用:登记 DOM 元素并把句柄注册到 Root */\n  registerElement: (element: HTMLElement) => () => void;\n}\n\n/**\n * 单个题目的状态:答案注册与选中、跳过、校验、快捷键,以及给 Root 的句柄。\n */\nexport function useQuestionnaireItem(\n  options: Options,\n): UseQuestionnaireItemResult {\n  const root = useQuestionnaireRootContext(\"QuestionnaireItem\");\n\n  const [element, setElement] = createSignal<HTMLElement>();\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  const [descriptionIds, setDescriptionIds] = createSignal<string[]>([]);\n  const [errorIds, setErrorIds] = createSignal<string[]>([]);\n\n  const active = createMemo(() => root.activeItemName() === options.name);\n\n  const registerAnswerControl = (entry: QuestionnaireAnswerEntry) => {\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  const applySelection = (id: string, selected: boolean) => {\n    setSelections((prev) => {\n      if (selected) {\n        return options.multiple()\n          ? prev.includes(id)\n            ? prev\n            : [...prev, id]\n          : [id];\n      }\n      return prev.filter((value) => value !== id);\n    });\n  };\n\n  const registerAnswerSelection = (id: string, initialSelected: boolean) => {\n    if (initialSelected) {\n      setSelections((prev) =>\n        options.multiple()\n          ? prev.includes(id)\n            ? prev\n            : [...prev, id]\n          : prev.length\n            ? prev\n            : [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  const setAnswerDefault = (id: string, selected: boolean) => {\n    setDefaults((prev) => {\n      if (selected) return prev.includes(id) ? prev : [...prev, id];\n      return prev.filter((value) => value !== id);\n    });\n  };\n\n  const setAnswerSelectionFromInteraction = (id: string, selected: boolean) => {\n    setSkipped(false);\n    applySelection(id, selected);\n  };\n\n  const syncControlledAnswerSelection = (id: string, selected: boolean) => {\n    applySelection(id, selected);\n  };\n\n  const isEntryDisabled = (entry: QuestionnaireAnswerEntry) =>\n    entry.disabled || entry.element.disabled;\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) && !isEntryDisabled(entry),\n    );\n    return answered ? \"answered\" : \"unanswered\";\n  });\n\n  const skippable = createMemo(\n    () => status() === \"skipped\" && !options.required(),\n  );\n  const answeredOk = createMemo(() => status() === \"answered\");\n\n  const invalid = createMemo(\n    () =>\n      !options.disabled() &&\n      !skippable() &&\n      (options.invalid() ||\n        (touched() && !(skippable() || (!options.invalid() && answeredOk())))),\n  );\n\n  const focus = () => {\n    const target = element();\n    if (!target) return;\n    const filled = target.querySelector<HTMLElement>(\n      \"input[data-filled][name]:not(:disabled)\",\n    );\n    const anyInput = target.querySelector<HTMLElement>(\n      \"input:not([type=hidden]):not(:disabled), textarea:not(:disabled)\",\n    );\n    (filled ?? anyInput ?? target).focus();\n  };\n\n  const validate = () => {\n    setTouched(true);\n    const satisfied =\n      options.disabled() ||\n      (status() === \"skipped\" && !options.required()) ||\n      (!options.invalid() && status() === \"answered\");\n    if (!satisfied) return false;\n    if (!root.nativeValidation()) return true;\n    const answer = answers().find(\n      (entry) =>\n        isAnswerFilled(entry) &&\n        entry.element.willValidate &&\n        !entry.element.validity.valid,\n    );\n    if (answer) {\n      answer.element.focus();\n      answer.element.reportValidity();\n      return false;\n    }\n    return true;\n  };\n\n  const skip = () => {\n    if (options.required()) return;\n    setSelections([]);\n    setSkipped(true);\n  };\n\n  const 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  const getAnswerByElement = (target: Element) =>\n    answers().find((entry) => entry.element === target) ?? null;\n\n  const shortcutByChoiceValue = createMemo<Map<string, string> | null>(() => {\n    const mode = root.shortcuts();\n    const definition = root.itemDefinitions()?.get(options.name);\n    if (!mode || !definition?.choices) return null;\n    const alphabet = shortcutAlphabet(mode);\n    const map = new Map<string, string>();\n    let cursor = 0;\n    for (const choice of definition.choices) {\n      if (choice.disabled) continue;\n      const letter = alphabet[cursor];\n      if (!letter) break;\n      map.set(choice.value, letter);\n      cursor += 1;\n    }\n    return map;\n  });\n\n  const shortcutByAnswerId = createMemo<Map<string, string>>(() => {\n    if (shortcutByChoiceValue()) return new Map();\n    const alphabet = shortcutAlphabet(root.shortcuts());\n    const choices = answers().filter((entry) => entry.type === \"choice\");\n    return new Map(\n      choices\n        .slice(0, alphabet.length)\n        .map((entry, index) => [entry.id, alphabet[index]!]),\n    );\n  });\n\n  const getAnswerByShortcut = (shortcut: string) => {\n    const byValue = shortcutByChoiceValue();\n    if (byValue) {\n      const value = [...byValue.entries()].find(\n        ([, letter]) => letter === shortcut,\n      )?.[0];\n      return (\n        answers().find(\n          (entry) => entry.type === \"choice\" && entry.value === value,\n        ) ?? null\n      );\n    }\n    const id = [...shortcutByAnswerId().entries()].find(\n      ([, letter]) => letter === shortcut,\n    )?.[0];\n    return answers().find((entry) => entry.id === id) ?? null;\n  };\n\n  const moveAnswerFocus = (target: Element, direction: \"next\" | \"previous\") => {\n    const scope = element();\n    const focusable = answers().filter(\n      (entry) =>\n        !isEntryDisabled(entry) &&\n        entry.element.isConnected &&\n        !(isTypingElement(target) && entry.type === \"input\"),\n    );\n    if (!focusable.length) return false;\n    const position = focusable.findIndex((entry) => entry.element === target);\n    if (position < 0 && target !== scope) return false;\n    const nextIndex =\n      position < 0\n        ? direction === \"next\"\n          ? 0\n          : focusable.length - 1\n        : (position + (direction === \"next\" ? 1 : -1) + focusable.length) %\n          focusable.length;\n    const next = focusable[nextIndex];\n    if (!next || next.element === target) return false;\n    next.element.focus();\n    if (next.type === \"choice\" && isNativeRadio(next.element)) {\n      (next.element as HTMLInputElement).click();\n    }\n    return true;\n  };\n\n  const describedBy = () => {\n    const ids = [...descriptionIds(), ...(invalid() ? errorIds() : [])];\n    return [...new Set(ids)].join(\" \") || undefined;\n  };\n\n  const keyshortcuts = () => {\n    if (!active()) return undefined;\n    const state = root.state();\n    return (\n      [\n        \"Meta+Enter Control+Enter\",\n        answers().length ? \"ArrowUp ArrowDown\" : null,\n        !state.first ? \"ArrowLeft\" : null,\n        !state.last && status() !== \"unanswered\" ? \"ArrowRight\" : null,\n      ]\n        .filter(Boolean)\n        .join(\" \") || undefined\n    );\n  };\n\n  const registerDescription = (id: string) => {\n    setDescriptionIds((prev) => (prev.includes(id) ? prev : [...prev, id]));\n    return () =>\n      setDescriptionIds((prev) => prev.filter((value) => value !== id));\n  };\n\n  const registerError = (id: string) => {\n    setErrorIds((prev) => (prev.includes(id) ? prev : [...prev, id]));\n    return () => setErrorIds((prev) => prev.filter((value) => value !== id));\n  };\n\n  const context: QuestionnaireItemContextValue = {\n    name: options.name,\n    active,\n    disabled: options.disabled,\n    invalid,\n    multiple: options.multiple,\n    required: options.required,\n    status,\n    hasInputAnswer,\n    selectedAnswerIds: selections,\n    resetVersion,\n    shortcutByAnswerId,\n    shortcutByChoiceValue,\n    shortcuts: root.shortcuts,\n    registerAnswerControl,\n    registerAnswerSelection,\n    registerDescription,\n    registerError,\n    setAnswerDefault,\n    setAnswerSelectionFromInteraction,\n    syncControlledAnswerSelection,\n  };\n\n  const registerElement = (target: HTMLElement) => {\n    setElement(target);\n    const handle: QuestionnaireItemHandle = {\n      name: options.name,\n      element: target,\n      disabled: options.disabled,\n      required: options.required,\n      status,\n      validate,\n      focus,\n      focusInvalid: focus,\n      skip,\n      reset,\n      getAnswerByElement,\n      getAnswerByShortcut,\n      moveAnswerFocus,\n    };\n    return root.registerItem(handle);\n  };\n\n  return {\n    context,\n    itemProps: () => ({\n      \"aria-describedby\": describedBy(),\n      \"aria-invalid\": invalid() || undefined,\n      \"aria-keyshortcuts\": keyshortcuts(),\n      disabled: options.disabled(),\n      hidden: !active(),\n      inert: !active(),\n      tabIndex: -1,\n    }),\n    registerElement,\n    describedBy,\n    keyshortcuts,\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+import { Accessor } from 'solid-js';
+import { QuestionnaireRootContextValue } from './questionnaire.context';
+import { QuestionnaireItemDefinition, QuestionnaireShortcutMode } from './questionnaire.types';
+interface Options {
+    item: Accessor<string | undefined>;
+    defaultItem: Accessor<string | undefined>;
+    items: Accessor<readonly QuestionnaireItemDefinition[] | undefined>;
+    shortcuts: Accessor<QuestionnaireShortcutMode | undefined>;
+    noValidate: Accessor<boolean | undefined>;
+    onItemChange: (item: string) => void;
+    onReset?: (event: Event) => void;
+    onSubmit?: (event: SubmitEvent) => void;
+    formRef: Accessor<HTMLFormElement | undefined>;
+}
+/**
+ * Questionnaire 根状态机:
+ * - 注册各 Item(按 DOM 顺序排序),维护激活项与进度;
+ * - 导航(上一题/下一题/跳过/提交)与校验;
+ * - 键盘:Mod+Enter 提交、上下箭头在答案间移动、左右箭头切题、方向键/Esc/快捷键。
+ */
+export declare function useQuestionnaireRoot(options: Options): {
+    context: QuestionnaireRootContextValue;
+    formProps: {
+        "data-shortcuts": string | undefined;
+        onKeyDown: (event: KeyboardEvent) => void;
+        onSubmit: (event: SubmitEvent) => void;
+        onReset: (event: Event) => void;
+    };
+};
+export {};

package/dist/components/questionnaire/useQuestionnaireRoot.js

@@ -0,0 +1,144 @@
+import { compareDocumentOrder as e, isAnswerFilled as t, isNativeRadio as n, isTypingElement as r, normalizeShortcut as i } from "./questionnaire.utils.js";
+import { createEffect as a, createMemo as o, createSignal as s, onCleanup as c } from "solid-js";
+//#region src/components/questionnaire/useQuestionnaireRoot.ts
+function l(l) {
+	let [u, d] = s([]), [f, p] = s(0), [m, h] = s(null), g = null, _ = o(() => (f(), [...u()].sort((t, n) => e(t.element, n.element)))), v = o(() => _().filter((e) => !e.disabled())), y = o(() => l.item() ?? m()), b = o(() => v().find((e) => e.name === y()) ?? null), x = o(() => v().length), S = o(() => v().findIndex((e) => e.name === y())), C = o(() => S() < 0 ? 0 : S() + 1), w = o(() => x() > 0 && S() === 0), T = o(() => x() > 0 && S() === x() - 1), E = o(() => {
+		let e = l.items();
+		return e ? new Map(e.map((e) => [e.name, e])) : null;
+	}), D = () => {
+		let e = v(), t = l.item() ?? l.defaultItem();
+		return t && e.some((e) => e.name === t) ? t : e[0]?.name ?? null;
+	};
+	a(() => {
+		if (l.item() !== void 0) return;
+		let e = v(), t = y();
+		if (t && e.some((e) => e.name === t)) return;
+		let n = D();
+		n !== t && h(n);
+	});
+	let O = (e) => (d((t) => t.some((t) => t.element === e.element) ? t.map((t) => t.element === e.element ? e : t) : [...t, e]), () => {
+		d((t) => t.filter((t) => t !== e));
+	}), k = (e, t = "item") => {
+		if (e) {
+			if (e === y()) {
+				t === "invalid" && b()?.focusInvalid();
+				return;
+			}
+			g = {
+				name: e,
+				target: t
+			}, l.item() === void 0 && h(e), l.onItemChange?.(e);
+		}
+	}, A = () => l.formRef()?.requestSubmit(), j = () => {
+		let e = b();
+		if (!e) return;
+		if (!e.validate()) {
+			e.focusInvalid();
+			return;
+		}
+		let t = v(), n = t.indexOf(e);
+		n < 0 || n >= t.length - 1 || k(t[n + 1].name);
+	}, M = () => {
+		let e = v(), t = S();
+		t <= 0 || k(e[t - 1].name);
+	}, N = () => {
+		let e = b();
+		if (!e || e.required()) return;
+		if (e.skip(), T()) {
+			queueMicrotask(A);
+			return;
+		}
+		let t = v(), n = t.indexOf(e);
+		k(t[n + 1]?.name ?? null);
+	}, P = () => {
+		T() ? A() : j();
+	};
+	return a(() => {
+		let e = y();
+		if (!g || g.name !== e) return;
+		let t = g.target;
+		g = null;
+		let n = v().find((t) => t.name === e);
+		n && queueMicrotask(() => {
+			t === "invalid" ? n.focusInvalid() : n.focus();
+		});
+	}), a(() => {
+		let e = l.formRef();
+		if (!e || typeof MutationObserver > "u") return;
+		let t = new MutationObserver(() => p((e) => e + 1));
+		t.observe(e, {
+			childList: !0,
+			subtree: !0
+		}), c(() => t.disconnect());
+	}), {
+		context: {
+			state: () => ({
+				current: C(),
+				first: w(),
+				last: T(),
+				total: x()
+			}),
+			activeItemName: y,
+			activeItemRequired: () => b()?.required() ?? null,
+			activeItemStatus: () => b()?.status() ?? null,
+			shortcuts: () => l.shortcuts() ?? null,
+			nativeValidation: () => l.noValidate() === !1,
+			itemDefinitions: E,
+			registerItem: O,
+			goNext: j,
+			goPrevious: M,
+			skipCurrent: N,
+			requestSubmit: A
+		},
+		formProps: {
+			"data-shortcuts": l.shortcuts(),
+			onKeyDown: (e) => {
+				let a = b();
+				if (!a || e.defaultPrevented || e.isComposing || e.keyCode === 229 || !(e.target instanceof Element)) return;
+				let o = e.target;
+				if (e.key === "Enter" && (e.metaKey || e.ctrlKey) && !e.altKey && !e.shiftKey) {
+					e.preventDefault(), e.repeat || P();
+					return;
+				}
+				if (e.metaKey || e.ctrlKey || e.altKey) return;
+				if ((e.key === "ArrowUp" || e.key === "ArrowDown") && a.moveAnswerFocus(o, e.key === "ArrowDown" ? "next" : "previous")) {
+					e.preventDefault();
+					return;
+				}
+				if ((e.key === "ArrowLeft" || e.key === "ArrowRight") && !r(o) && !n(o)) {
+					if (e.preventDefault(), e.repeat) return;
+					e.key === "ArrowLeft" ? M() : a.status() !== "unanswered" && j();
+					return;
+				}
+				if (e.key === "Enter") {
+					let n = a.getAnswerByElement(o);
+					if (!n) return;
+					e.preventDefault(), !e.repeat && t(n) && P();
+					return;
+				}
+				let s = l.shortcuts() ?? null;
+				if (!s || r(o)) return;
+				let c = i(e.key, s), u = c ? a.getAnswerByShortcut(c) : null;
+				u && (e.preventDefault(), !e.repeat && (u.element.focus(), u.type === "choice" && u.element.click()));
+			},
+			onSubmit: (e) => {
+				let t = v().find((e) => !e.validate());
+				if (t) {
+					e.preventDefault(), k(t.name, "invalid");
+					return;
+				}
+				l.onSubmit?.(e);
+			},
+			onReset: (e) => {
+				if (l.onReset?.(e), !e.defaultPrevented) {
+					for (let e of v()) e.reset();
+					k(D());
+				}
+			}
+		}
+	};
+}
+//#endregion
+export { l as useQuestionnaireRoot };
+
+//# sourceMappingURL=useQuestionnaireRoot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQuestionnaireRoot.js","names":["useQuestionnaireRoot","registered","setRegistered","createSignal","domVersion","setDomVersion","internalName","setInternalName","pendingFocus","ordered","createMemo","compareDocumentOrder","a","b","enabled","item","activeName","options","activeItem","total","index","current","first","last","itemDefinitions","list","definition","resolveName","candidate","entry","name","next","registerItem","prev","handle","navigate","target","requestSubmit","goNext","position","goPrevious","skipCurrent","submitOrNext","createEffect","form","observer","v","onCleanup","event","isTypingElement","isNativeRadio","answer","isAnswerFilled","mode","shortcut","normalizeShortcut","invalid"],"sources":["../../../src/components/questionnaire/useQuestionnaireRoot.ts"],"sourcesContent":["import {\n  createEffect,\n  createMemo,\n  createSignal,\n  onCleanup,\n  type Accessor,\n} from \"solid-js\";\nimport type {\n  QuestionnaireItemHandle,\n  QuestionnaireRootContextValue,\n} from \"./questionnaire.context\";\nimport type {\n  QuestionnaireItemDefinition,\n  QuestionnaireShortcutMode,\n} from \"./questionnaire.types\";\nimport {\n  compareDocumentOrder,\n  isAnswerFilled,\n  isNativeRadio,\n  isTypingElement,\n  normalizeShortcut,\n} from \"./questionnaire.utils\";\n\ninterface Options {\n  item: Accessor<string | undefined>;\n  defaultItem: Accessor<string | undefined>;\n  items: Accessor<readonly QuestionnaireItemDefinition[] | undefined>;\n  shortcuts: Accessor<QuestionnaireShortcutMode | undefined>;\n  noValidate: Accessor<boolean | undefined>;\n  onItemChange: (item: string) => void;\n  onReset?: (event: Event) => void;\n  onSubmit?: (event: SubmitEvent) => void;\n  formRef: Accessor<HTMLFormElement | undefined>;\n}\n\n/**\n * Questionnaire 根状态机:\n * - 注册各 Item(按 DOM 顺序排序),维护激活项与进度;\n * - 导航(上一题/下一题/跳过/提交)与校验;\n * - 键盘:Mod+Enter 提交、上下箭头在答案间移动、左右箭头切题、方向键/Esc/快捷键。\n */\nexport function useQuestionnaireRoot(options: Options): {\n  context: QuestionnaireRootContextValue;\n  formProps: {\n    \"data-shortcuts\": string | undefined;\n    onKeyDown: (event: KeyboardEvent) => void;\n    onSubmit: (event: SubmitEvent) => void;\n    onReset: (event: Event) => void;\n  };\n} {\n  const [registered, setRegistered] = createSignal<QuestionnaireItemHandle[]>(\n    [],\n  );\n  const [domVersion, setDomVersion] = createSignal(0);\n  const [internalName, setInternalName] = createSignal<string | null>(null);\n  let pendingFocus: { name: string; target: \"item\" | \"invalid\" } | null = null;\n\n  const ordered = createMemo(() => {\n    domVersion();\n    return [...registered()].sort((a, b) =>\n      compareDocumentOrder(a.element, b.element),\n    );\n  });\n  const enabled = createMemo(() =>\n    ordered().filter((item) => !item.disabled()),\n  );\n  const activeName = createMemo(() => options.item() ?? internalName());\n  const activeItem = createMemo(\n    () => enabled().find((item) => item.name === activeName()) ?? null,\n  );\n  const total = createMemo(() => enabled().length);\n  const index = createMemo(() =>\n    enabled().findIndex((item) => item.name === activeName()),\n  );\n  const current = createMemo(() => (index() < 0 ? 0 : index() + 1));\n  const first = createMemo(() => total() > 0 && index() === 0);\n  const last = createMemo(() => total() > 0 && index() === total() - 1);\n\n  const itemDefinitions = createMemo(() => {\n    const list = options.items();\n    if (!list) return null;\n    return new Map(list.map((definition) => [definition.name, definition]));\n  });\n\n  const resolveName = () => {\n    const list = enabled();\n    const candidate = options.item() ?? options.defaultItem();\n    if (candidate && list.some((entry) => entry.name === candidate)) {\n      return candidate;\n    }\n    return list[0]?.name ?? null;\n  };\n\n  // 激活项不可用时回退到定义/第一个可用项\n  createEffect(() => {\n    if (options.item() !== undefined) return;\n    const list = enabled();\n    const name = activeName();\n    if (name && list.some((entry) => entry.name === name)) return;\n    const next = resolveName();\n    if (next !== name) setInternalName(next);\n  });\n\n  const registerItem = (handle: QuestionnaireItemHandle) => {\n    setRegistered((prev) => {\n      const exists = prev.some((item) => item.element === handle.element);\n      return exists\n        ? prev.map((item) => (item.element === handle.element ? handle : item))\n        : [...prev, handle];\n    });\n    return () => {\n      setRegistered((prev) => prev.filter((item) => item !== handle));\n    };\n  };\n\n  const navigate = (\n    name: string | null,\n    target: \"item\" | \"invalid\" = \"item\",\n  ) => {\n    if (!name) return;\n    if (name === activeName()) {\n      if (target === \"invalid\") activeItem()?.focusInvalid();\n      return;\n    }\n    pendingFocus = { name, target };\n    if (options.item() === undefined) setInternalName(name);\n    options.onItemChange?.(name);\n  };\n\n  const requestSubmit = () => options.formRef()?.requestSubmit();\n\n  const goNext = () => {\n    const item = activeItem();\n    if (!item) return;\n    if (!item.validate()) {\n      item.focusInvalid();\n      return;\n    }\n    const list = enabled();\n    const position = list.indexOf(item);\n    if (position < 0 || position >= list.length - 1) return;\n    navigate(list[position + 1]!.name);\n  };\n\n  const goPrevious = () => {\n    const list = enabled();\n    const position = index();\n    if (position <= 0) return;\n    navigate(list[position - 1]!.name);\n  };\n\n  const skipCurrent = () => {\n    const item = activeItem();\n    if (!item || item.required()) return;\n    item.skip();\n    if (last()) {\n      queueMicrotask(requestSubmit);\n      return;\n    }\n    const list = enabled();\n    const position = list.indexOf(item);\n    navigate(list[position + 1]?.name ?? null);\n  };\n\n  const submitOrNext = () => {\n    if (last()) requestSubmit();\n    else goNext();\n  };\n\n  const handleSubmit = (event: SubmitEvent) => {\n    const invalid = enabled().find((item) => !item.validate());\n    if (invalid) {\n      event.preventDefault();\n      navigate(invalid.name, \"invalid\");\n      return;\n    }\n    options.onSubmit?.(event);\n  };\n\n  const handleReset = (event: Event) => {\n    options.onReset?.(event);\n    if (event.defaultPrevented) return;\n    for (const item of enabled()) item.reset();\n    navigate(resolveName());\n  };\n\n  const handleKeyDown = (event: KeyboardEvent) => {\n    const item = activeItem();\n    if (!item) return;\n    if (\n      event.defaultPrevented ||\n      event.isComposing ||\n      event.keyCode === 229 ||\n      !(event.target instanceof Element)\n    ) {\n      return;\n    }\n    const target = event.target;\n\n    if (\n      event.key === \"Enter\" &&\n      (event.metaKey || event.ctrlKey) &&\n      !event.altKey &&\n      !event.shiftKey\n    ) {\n      event.preventDefault();\n      if (!event.repeat) submitOrNext();\n      return;\n    }\n    if (event.metaKey || event.ctrlKey || event.altKey) return;\n\n    if (\n      (event.key === \"ArrowUp\" || event.key === \"ArrowDown\") &&\n      item.moveAnswerFocus(\n        target,\n        event.key === \"ArrowDown\" ? \"next\" : \"previous\",\n      )\n    ) {\n      event.preventDefault();\n      return;\n    }\n\n    if (\n      (event.key === \"ArrowLeft\" || event.key === \"ArrowRight\") &&\n      !isTypingElement(target) &&\n      !isNativeRadio(target)\n    ) {\n      event.preventDefault();\n      if (event.repeat) return;\n      if (event.key === \"ArrowLeft\") goPrevious();\n      else if (item.status() !== \"unanswered\") goNext();\n      return;\n    }\n\n    if (event.key === \"Enter\") {\n      const answer = item.getAnswerByElement(target);\n      if (!answer) return;\n      event.preventDefault();\n      if (!event.repeat && isAnswerFilled(answer)) submitOrNext();\n      return;\n    }\n\n    const mode = options.shortcuts() ?? null;\n    if (!mode || isTypingElement(target)) return;\n    const shortcut = normalizeShortcut(event.key, mode);\n    const answer = shortcut ? item.getAnswerByShortcut(shortcut) : null;\n    if (!answer) return;\n    event.preventDefault();\n    if (event.repeat) return;\n    answer.element.focus();\n    if (answer.type === \"choice\") (answer.element as HTMLInputElement).click();\n  };\n\n  // 导航后聚焦新激活项(或它的首个答案控件)\n  createEffect(() => {\n    const name = activeName();\n    if (!pendingFocus || pendingFocus.name !== name) return;\n    const target = pendingFocus.target;\n    pendingFocus = null;\n    const handle = enabled().find((item) => item.name === name);\n    if (!handle) return;\n    queueMicrotask(() => {\n      if (target === \"invalid\") handle.focusInvalid();\n      else handle.focus();\n    });\n  });\n\n  // 观察 DOM 变化(动态增删 Item)以便重新排序\n  createEffect(() => {\n    const form = options.formRef();\n    if (!form || typeof MutationObserver === \"undefined\") return;\n    const observer = new MutationObserver(() => setDomVersion((v) => v + 1));\n    observer.observe(form, { childList: true, subtree: true });\n    onCleanup(() => observer.disconnect());\n  });\n\n  const context: QuestionnaireRootContextValue = {\n    state: () => ({\n      current: current(),\n      first: first(),\n      last: last(),\n      total: total(),\n    }),\n    activeItemName: activeName,\n    activeItemRequired: () => activeItem()?.required() ?? null,\n    activeItemStatus: () => activeItem()?.status() ?? null,\n    shortcuts: () => options.shortcuts() ?? null,\n    nativeValidation: () => options.noValidate() === false,\n    itemDefinitions,\n    registerItem,\n    goNext,\n    goPrevious,\n    skipCurrent,\n    requestSubmit,\n  };\n\n  return {\n    context,\n    formProps: {\n      \"data-shortcuts\": options.shortcuts(),\n      onKeyDown: handleKeyDown,\n      onSubmit: handleSubmit,\n      onReset: handleReset,\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/components/resizable/ResizableHandle/ResizableHandle.d.ts

@@ -0,0 +1,6 @@
+import { ResizableHandleProps } from '../resizable.types';
+/**
+ * 两个面板之间的分隔条:支持拖拽、方向键、Home/End、Enter/Space 折叠。
+ * 默认只有 1px 可见线,靠 `::after` 扩大命中区域;`withHandle` 时显示抓手。
+ */
+export declare function ResizableHandle(props: ResizableHandleProps): import('solid-js').JSX.Element;