@neut/ui 0.0.15 → 0.0.17

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

@@ -0,0 +1,5 @@
+import { QuestionnaireNavigationProps } from '../questionnaire.types';
+export declare const QuestionnairePrevious: (props: QuestionnaireNavigationProps) => import('solid-js').JSX.Element;
+export declare const QuestionnaireSkip: (props: QuestionnaireNavigationProps) => import('solid-js').JSX.Element;
+export declare const QuestionnaireNext: (props: QuestionnaireNavigationProps) => import('solid-js').JSX.Element;
+export declare const QuestionnaireSubmit: (props: QuestionnaireNavigationProps) => import('solid-js').JSX.Element;

package/dist/components/questionnaire/QuestionnaireNavigation/QuestionnaireNavigation.js

@@ -0,0 +1,104 @@
+import { clsx as e } from "../../../utils/clsx.js";
+import { Button as t } from "../../button/Button.js";
+import { useQuestionnaireRootContext as n } from "../questionnaire.context.js";
+import { createComponent as r, mergeProps as i } from "solid-js/web";
+import { mergeProps as a, splitProps as o } from "solid-js";
+//#region src/components/questionnaire/QuestionnaireNavigation/QuestionnaireNavigation.tsx
+function s(e) {
+	switch (e) {
+		case "previous": return "Previous";
+		case "skip": return "Skip";
+		case "next": return "Next";
+		case "submit": return "Submit";
+	}
+}
+function c(c) {
+	let l = n("QuestionnaireNavigation"), u = a({
+		variant: void 0,
+		size: "md",
+		disabled: !1
+	}, c), [d, f] = o(u, [
+		"kind",
+		"class",
+		"classList",
+		"variant",
+		"size",
+		"disabled",
+		"onClick",
+		"children",
+		"type"
+	]), p = () => {
+		let e = l.state();
+		switch (d.kind) {
+			case "previous": return e.total > 1 && !e.first;
+			case "next": return e.total > 1 && !e.last;
+			case "skip": return l.activeItemRequired() === !1;
+			case "submit": return e.total > 0 && e.last;
+		}
+	}, m = () => p() && !d.disabled && (d.kind === "next" || d.kind === "submit") ? "Enter" : null;
+	return r(t, i(f, {
+		get type() {
+			return d.type ?? (d.kind === "submit" ? "submit" : "button");
+		},
+		get variant() {
+			return d.variant ?? (d.kind === "previous" || d.kind === "skip" ? "outline" : "primary");
+		},
+		get size() {
+			return d.size;
+		},
+		get disabled() {
+			return d.disabled;
+		},
+		onClick: (e) => {
+			let t = d.onClick;
+			Array.isArray(t) ? t[0](t[1], e) : t?.(e), !e?.defaultPrevented && (d.kind === "previous" ? l.goPrevious() : d.kind === "skip" ? l.skipCurrent() : d.kind === "next" && l.goNext());
+		},
+		get "data-slot"() {
+			return `questionnaire-${d.kind}`;
+		},
+		get "data-visible"() {
+			return p() ? "" : void 0;
+		},
+		get "data-hidden"() {
+			return p() ? void 0 : "";
+		},
+		get "data-status"() {
+			return l.activeItemStatus() ?? void 0;
+		},
+		get "data-shortcut"() {
+			return m() ?? void 0;
+		},
+		get "data-disabled"() {
+			return d.disabled ? "" : void 0;
+		},
+		get "aria-hidden"() {
+			return !p() || void 0;
+		},
+		get "aria-keyshortcuts"() {
+			return m() ?? void 0;
+		},
+		get hidden() {
+			return !p();
+		},
+		get inert() {
+			return !p();
+		},
+		get tabIndex() {
+			return p() ? 0 : -1;
+		},
+		get class() {
+			return e(d.kind === "previous" && "justify-self-start", d.kind !== "previous" && "justify-self-end", d.class);
+		},
+		get classList() {
+			return d.classList;
+		},
+		get children() {
+			return d.children ?? s(d.kind);
+		}
+	}));
+}
+var l = (e) => r(c, i(e, { kind: "previous" })), u = (e) => r(c, i(e, { kind: "skip" })), d = (e) => r(c, i(e, { kind: "next" })), f = (e) => r(c, i(e, { kind: "submit" }));
+//#endregion
+export { d as QuestionnaireNext, l as QuestionnairePrevious, u as QuestionnaireSkip, f as QuestionnaireSubmit };
+
+//# sourceMappingURL=QuestionnaireNavigation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuestionnaireNavigation.js","names":["mergeProps","splitProps","Button","clsx","MouseEventHandler","useQuestionnaireRootContext","QuestionnaireNavigationProps","NavigationKind","NavButtonProps","kind","defaultLabel","NavButton","props","root","merged","variant","undefined","size","const","disabled","local","rest","visible","state","total","first","last","activeItemRequired","shortcut","handleClick","event","userOnClick","onClick","e","data","Array","isArray","defaultPrevented","goPrevious","skipCurrent","goNext","_$createComponent","_$mergeProps","type","data-slot","data-visible","data-hidden","data-status","activeItemStatus","data-shortcut","data-disabled","aria-hidden","aria-keyshortcuts","hidden","inert","tabIndex","class","classList","children","QuestionnairePrevious","QuestionnaireSkip","QuestionnaireNext","QuestionnaireSubmit","mergeProps","_$createComponent","_$mergeProps","mergeProps$1","defaultLabel","kind","NavButton","root","useQuestionnaireRootContext","merged","props","local","rest","splitProps","visible","state","shortcut","createComponent","Button","mergeProps","userOnClick","event","\"class\"","clsx","QuestionnairePrevious","QuestionnaireSkip","QuestionnaireNext","QuestionnaireSubmit"],"sources":["../../../../src/components/questionnaire/QuestionnaireNavigation/QuestionnaireNavigation.tsx"],"sourcesContent":["import { mergeProps, splitProps } from \"solid-js\";\nimport { Button } from \"~/components/button\";\nimport { clsx } from \"~/utils\";\nimport type { MouseEventHandler } from \"~/types\";\nimport { useQuestionnaireRootContext } from \"../questionnaire.context\";\nimport type { QuestionnaireNavigationProps } from \"../questionnaire.types\";\n\ntype NavigationKind = \"previous\" | \"skip\" | \"next\" | \"submit\";\n\ninterface NavButtonProps extends QuestionnaireNavigationProps {\n  kind: NavigationKind;\n}\n\nfunction defaultLabel(kind: NavigationKind) {\n  switch (kind) {\n    case \"previous\":\n      return \"Previous\";\n    case \"skip\":\n      return \"Skip\";\n    case \"next\":\n      return \"Next\";\n    case \"submit\":\n      return \"Submit\";\n  }\n}\n\nfunction NavButton(props: NavButtonProps) {\n  const root = useQuestionnaireRootContext(\"QuestionnaireNavigation\");\n  const merged = mergeProps(\n    {\n      variant: undefined,\n      size: \"md\" as const,\n      disabled: false,\n    },\n    props,\n  );\n  const [local, rest] = splitProps(merged, [\n    \"kind\",\n    \"class\",\n    \"classList\",\n    \"variant\",\n    \"size\",\n    \"disabled\",\n    \"onClick\",\n    \"children\",\n    \"type\",\n  ]);\n\n  const visible = () => {\n    const state = root.state();\n    switch (local.kind) {\n      case \"previous\":\n        return state.total > 1 && !state.first;\n      case \"next\":\n        return state.total > 1 && !state.last;\n      case \"skip\":\n        return root.activeItemRequired() === false;\n      case \"submit\":\n        return state.total > 0 && state.last;\n    }\n  };\n\n  const shortcut = () =>\n    visible() &&\n    !local.disabled &&\n    (local.kind === \"next\" || local.kind === \"submit\")\n      ? \"Enter\"\n      : null;\n\n  const handleClick: MouseEventHandler<\"button\"> = (event) => {\n    const userOnClick = local.onClick as\n      | ((e: typeof event) => void)\n      | [(data: unknown, e: typeof event) => void, unknown]\n      | undefined;\n    if (Array.isArray(userOnClick)) userOnClick[0](userOnClick[1], event);\n    else userOnClick?.(event);\n    if (event?.defaultPrevented) return;\n    if (local.kind === \"previous\") root.goPrevious();\n    else if (local.kind === \"skip\") root.skipCurrent();\n    else if (local.kind === \"next\") root.goNext();\n  };\n\n  return (\n    <Button\n      {...rest}\n      type={local.type ?? (local.kind === \"submit\" ? \"submit\" : \"button\")}\n      variant={\n        local.variant ??\n        (local.kind === \"previous\" || local.kind === \"skip\"\n          ? \"outline\"\n          : \"primary\")\n      }\n      size={local.size}\n      disabled={local.disabled}\n      onClick={handleClick}\n      data-slot={`questionnaire-${local.kind}`}\n      data-visible={visible() ? \"\" : undefined}\n      data-hidden={visible() ? undefined : \"\"}\n      data-status={root.activeItemStatus() ?? undefined}\n      data-shortcut={shortcut() ?? undefined}\n      data-disabled={local.disabled ? \"\" : undefined}\n      aria-hidden={!visible() ? true : undefined}\n      aria-keyshortcuts={shortcut() ?? undefined}\n      hidden={!visible()}\n      inert={!visible()}\n      tabIndex={visible() ? 0 : -1}\n      class={clsx(\n        local.kind === \"previous\" && \"justify-self-start\",\n        local.kind !== \"previous\" && \"justify-self-end\",\n        local.class,\n      )}\n      classList={local.classList}\n    >\n      {local.children ?? defaultLabel(local.kind)}\n    </Button>\n  );\n}\n\nexport const QuestionnairePrevious = (props: QuestionnaireNavigationProps) => (\n  <NavButton {...props} kind=\"previous\" />\n);\nexport const QuestionnaireSkip = (props: QuestionnaireNavigationProps) => (\n  <NavButton {...props} kind=\"skip\" />\n);\nexport const QuestionnaireNext = (props: QuestionnaireNavigationProps) => (\n  <NavButton {...props} kind=\"next\" />\n);\nexport const QuestionnaireSubmit = (props: QuestionnaireNavigationProps) => (\n  <NavButton {...props} kind=\"submit\" />\n);\n"],"mappings":"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"}

package/dist/components/questionnaire/QuestionnaireNavigation/index.d.ts

@@ -0,0 +1 @@
+export { QuestionnairePrevious, QuestionnaireSkip, QuestionnaireNext, QuestionnaireSubmit, } from './QuestionnaireNavigation';

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

@@ -0,0 +1,4 @@
+import { JSX } from 'solid-js';
+import { QuestionnaireProgressProps } from '../questionnaire.types';
+/** 进度(默认显示 "Question X of Y");children 传函数可拿到 render state 自绘 */
+export declare function QuestionnaireProgress(props: QuestionnaireProgressProps): JSX.Element;

package/dist/components/questionnaire/QuestionnaireProgress/QuestionnaireProgress.js

@@ -0,0 +1,62 @@
+import { clsx as e } from "../../../utils/clsx.js";
+import { useQuestionnaireRootContext as t } from "../questionnaire.context.js";
+import { insert as n, memo as r, mergeProps as i, spread as a, template as o } from "solid-js/web";
+import { splitProps as s } from "solid-js";
+//#region src/components/questionnaire/QuestionnaireProgress/QuestionnaireProgress.tsx
+var c = /*#__PURE__*/ o("<div>");
+function l(o) {
+	let l = t("QuestionnaireProgress"), [u, d] = s(o, [
+		"class",
+		"classList",
+		"children"
+	]), f = l.state, p = () => {
+		let e = f();
+		return e.total ? `Question ${e.current} of ${e.total}` : void 0;
+	};
+	return (() => {
+		var t = c();
+		return a(t, i(d, {
+			"data-slot": "questionnaire-progress",
+			role: "progressbar",
+			"aria-label": "Questionnaire progress",
+			"aria-live": "polite",
+			get "aria-valuemax"() {
+				return f().total || void 0;
+			},
+			get "aria-valuemin"() {
+				return f().total ? 1 : void 0;
+			},
+			get "aria-valuenow"() {
+				return r(() => !!f().total)() ? f().current : void 0;
+			},
+			get "aria-valuetext"() {
+				return p();
+			},
+			get "data-current"() {
+				return f().current;
+			},
+			get "data-total"() {
+				return f().total;
+			},
+			get "data-first"() {
+				return f().first ? "" : void 0;
+			},
+			get "data-last"() {
+				return f().last ? "" : void 0;
+			},
+			get class() {
+				return e("min-h-[1lh] w-fit min-w-[14ch] font-medium text-xs text-muted-foreground tabular-nums", u.class);
+			},
+			get classList() {
+				return u.classList;
+			}
+		}), !1, !0), n(t, (() => {
+			var e = r(() => typeof u.children == "function");
+			return () => e() ? u.children(f()) : u.children ?? p();
+		})()), t;
+	})();
+}
+//#endregion
+export { l as QuestionnaireProgress };
+
+//# sourceMappingURL=QuestionnaireProgress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuestionnaireProgress.js","names":["splitProps","JSX","clsx","useQuestionnaireRootContext","QuestionnaireProgressProps","QuestionnaireRootState","QuestionnaireProgress","props","root","local","rest","state","label","value","total","current","undefined","_el$","_tmpl$","_$spread","_$mergeProps","aria-valuemax","aria-valuemin","aria-valuenow","_$memo","aria-valuetext","data-current","data-total","data-first","first","data-last","last","class","classList","_$insert","_c$","children","Element","_$mergeProps","_$memo","_tmpl$","QuestionnaireProgress","root","useQuestionnaireRootContext","local","rest","splitProps","props","state","label","value","_el$","spread","mergeProps","\"role\"","memo","\"class\"","clsx","insert","_c$"],"sources":["../../../../src/components/questionnaire/QuestionnaireProgress/QuestionnaireProgress.tsx"],"sourcesContent":["import { splitProps, type JSX } from \"solid-js\";\nimport { clsx } from \"~/utils\";\nimport { useQuestionnaireRootContext } from \"../questionnaire.context\";\nimport type {\n  QuestionnaireProgressProps,\n  QuestionnaireRootState,\n} from \"../questionnaire.types\";\n\n/** 进度(默认显示 \"Question X of Y\");children 传函数可拿到 render state 自绘 */\nexport function QuestionnaireProgress(props: QuestionnaireProgressProps) {\n  const root = useQuestionnaireRootContext(\"QuestionnaireProgress\");\n  const [local, rest] = splitProps(props, [\"class\", \"classList\", \"children\"]);\n  const state = root.state;\n  const label = () => {\n    const value = state();\n    return value.total\n      ? `Question ${value.current} of ${value.total}`\n      : undefined;\n  };\n\n  return (\n    <div\n      {...rest}\n      data-slot=\"questionnaire-progress\"\n      role=\"progressbar\"\n      aria-label=\"Questionnaire progress\"\n      aria-live=\"polite\"\n      aria-valuemax={state().total || undefined}\n      aria-valuemin={state().total ? 1 : undefined}\n      aria-valuenow={state().total ? state().current : undefined}\n      aria-valuetext={label()}\n      data-current={state().current}\n      data-total={state().total}\n      data-first={state().first ? \"\" : undefined}\n      data-last={state().last ? \"\" : undefined}\n      class={clsx(\n        \"min-h-[1lh] w-fit min-w-[14ch] font-medium text-xs text-muted-foreground tabular-nums\",\n        local.class,\n      )}\n      classList={local.classList}\n    >\n      {typeof local.children === \"function\"\n        ? (local.children as (state: QuestionnaireRootState) => JSX.Element)(\n            state(),\n          )\n        : (local.children ?? label())}\n    </div>\n  );\n}\n"],"mappings":";;;;;;AASA,SAAgBM,EAAsBC,GAAmC;CACvE,IAAMC,IAAOL,EAA4B,uBAAuB,GAC1D,CAACM,GAAOC,KAAQV,EAAWO,GAAO;EAAC;EAAS;EAAa;CAAU,CAAC,GACpEI,IAAQH,EAAKG,OACbC,UAAc;EAClB,IAAMC,IAAQF,EAAM;EACpB,OAAOE,EAAMC,QACT,YAAYD,EAAME,QAAO,MAAOF,EAAMC,UACtCE,KAAAA;CACN;CAEA,cAAA;EAAA,IAAAC,IAAAC,EAAA;EAyBmC,OAzBnCC,EAAAF,GAAAG,EAEQV,GAAI;GAAA,aACE;GAAwB4C,MAC7B;GAAa,cACP;GAAwB,aACzB;GAAQ,IAAA,kBAAA;IAAA,OACH3C,EAAM,CAAC,CAACG,SAASE,KAAAA;GAAS;GAAA,IAAA,kBAAA;IAAA,OAC1BL,EAAM,CAAC,CAACG,QAAQ,IAAIE,KAAAA;GAAS;GAAA,IAAA,kBAAA;IAAA,OAC7BQ,QAAA,CAAA,CAAAb,EAAM,CAAC,CAACG,KAAK,CAAA,CAAA,IAAGH,EAAM,CAAC,CAACI,UAAUC,KAAAA;GAAS;GAAA,IAAA,mBAAA;IAAA,OAC1CJ,EAAM;GAAC;GAAA,IAAA,iBAAA;IAAA,OACTD,EAAM,CAAC,CAACI;GAAO;GAAA,IAAA,eAAA;IAAA,OACjBJ,EAAM,CAAC,CAACG;GAAK;GAAA,IAAA,eAAA;IAAA,OACbH,EAAM,CAAC,CAACkB,QAAQ,KAAKb,KAAAA;GAAS;GAAA,IAAA,cAAA;IAAA,OAC/BL,EAAM,CAAC,CAACoB,OAAO,KAAKf,KAAAA;GAAS;GAAA,IAAAwC,QAAA;IAAA,OACjCtD,EACL,yFACAO,EAAMuB,KACR;GAAC;GAAA,IACDC,YAAS;IAAA,OAAExB,EAAMwB;GAAS;EAAA,CAAA,GAAA,IAAA,EAAA,GAAAC,EAAAjB,UAAA;GAAA,IAAAkB,IAAAX,QAEzB,OAAOf,EAAM2B,YAAa,UAAU;GAAA,aAApCD,EAAA,IACI1B,EAAM2B,SACLzB,EAAM,CACR,IACCF,EAAM2B,YAAYxB,EAAM;EAAE,EAAA,CAAA,CAAA,GAAAK;CAAA,EAAA,CAAA;AAGrC"}

package/dist/components/questionnaire/QuestionnaireProgress/index.d.ts

@@ -0,0 +1 @@
+export { QuestionnaireProgress } from './QuestionnaireProgress';

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

@@ -0,0 +1,4 @@
+import { ValidComponent } from 'solid-js';
+import { QuestionnaireTitleProps } from '../questionnaire.types';
+/** 题目标题(legend);可用 component 换成 CardTitle / DialogTitle 等 */
+export declare function QuestionnaireTitle<T extends ValidComponent = "legend">(props: QuestionnaireTitleProps<T>): import('solid-js').JSX.Element;

package/dist/components/questionnaire/QuestionnaireTitle/QuestionnaireTitle.js

@@ -0,0 +1,27 @@
+import { clsx as e } from "../../../utils/clsx.js";
+import { Dynamic as t, createComponent as n, mergeProps as r } from "solid-js/web";
+import { splitProps as i } from "solid-js";
+//#region src/components/questionnaire/QuestionnaireTitle/QuestionnaireTitle.tsx
+function a(a) {
+	let [o, s] = i(a, [
+		"class",
+		"classList",
+		"component"
+	]);
+	return n(t, r(s, {
+		get component() {
+			return o.component ?? "legend";
+		},
+		"data-slot": "questionnaire-title",
+		get class() {
+			return e("text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4", o.class);
+		},
+		get classList() {
+			return o.classList;
+		}
+	}));
+}
+//#endregion
+export { a as QuestionnaireTitle };
+
+//# sourceMappingURL=QuestionnaireTitle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QuestionnaireTitle.js","names":["splitProps","ValidComponent","Dynamic","clsx","QuestionnaireTitleProps","QuestionnaireTitle","props","T","local","rest","_$createComponent","_$mergeProps","component","class","classList","_$createComponent","_$mergeProps","QuestionnaireTitle","local","rest","splitProps","props","createComponent","Dynamic","mergeProps","\"class\"","clsx"],"sources":["../../../../src/components/questionnaire/QuestionnaireTitle/QuestionnaireTitle.tsx"],"sourcesContent":["import { splitProps, type ValidComponent } from \"solid-js\";\nimport { Dynamic } from \"solid-js/web\";\nimport { clsx } from \"~/utils\";\nimport type { QuestionnaireTitleProps } from \"../questionnaire.types\";\n\n/** 题目标题(legend);可用 component 换成 CardTitle / DialogTitle 等 */\nexport function QuestionnaireTitle<T extends ValidComponent = \"legend\">(\n  props: QuestionnaireTitleProps<T>,\n) {\n  const [local, rest] = splitProps(props, [\"class\", \"classList\", \"component\"]);\n  return (\n    <Dynamic\n      {...rest}\n      component={(local.component as ValidComponent) ?? \"legend\"}\n      data-slot=\"questionnaire-title\"\n      class={clsx(\n        \"text-base leading-snug font-medium text-pretty [&:not(:has(~[data-slot=questionnaire-description]))]:mb-4\",\n        local.class,\n      )}\n      classList={local.classList}\n    />\n  );\n}\n"],"mappings":";;;;AAMA,SAAgBK,EACdC,GACA;CACA,IAAM,CAACE,GAAOC,KAAQT,EAAWM,GAAO;EAAC;EAAS;EAAa;CAAW,CAAC;CAC3E,OAAAI,EACGR,GAAOS,EACFF,GAAI;EAAA,IACRG,YAAS;GAAA,OAAGJ,EAAMI,aAAgC;EAAQ;EAAA,aAAA;EAAA,IAAAa,QAAA;GAAA,OAEnDtB,EACL,6GACAK,EAAMK,KACR;EAAC;EAAA,IACDC,YAAS;GAAA,OAAEN,EAAMM;EAAS;CAAA,CAAA,CAAA;AAGhC"}

package/dist/components/questionnaire/QuestionnaireTitle/index.d.ts

@@ -0,0 +1 @@
+export { QuestionnaireTitle } from './QuestionnaireTitle';

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

@@ -0,0 +1,12 @@
+export { Questionnaire } from './Questionnaire';
+export { QuestionnaireProgress } from './QuestionnaireProgress';
+export { QuestionnaireItem } from './QuestionnaireItem';
+export { QuestionnaireTitle } from './QuestionnaireTitle';
+export { QuestionnaireDescription } from './QuestionnaireDescription';
+export { QuestionnaireChoices } from './QuestionnaireChoices';
+export { QuestionnaireChoice } from './QuestionnaireChoice';
+export { QuestionnaireInput } from './QuestionnaireInput';
+export { QuestionnaireError } from './QuestionnaireError';
+export { QuestionnaireActions } from './QuestionnaireActions';
+export { QuestionnairePrevious, QuestionnaireSkip, QuestionnaireNext, QuestionnaireSubmit, } from './QuestionnaireNavigation';
+export type { QuestionnaireItemStatus, QuestionnaireShortcutMode, QuestionnaireChoiceDefinition, QuestionnaireItemDefinition, QuestionnaireRootState, QuestionnaireProps, QuestionnaireProgressProps, QuestionnaireItemProps, QuestionnaireTitleProps, QuestionnaireDescriptionProps, QuestionnaireChoicesProps, QuestionnaireChoiceProps, QuestionnaireInputProps, QuestionnaireInputType, QuestionnaireErrorProps, QuestionnaireNavigationProps, } from './questionnaire.types';

package/dist/components/questionnaire/index.js

@@ -0,0 +1,12 @@
+import { Questionnaire as e } from "./Questionnaire/Questionnaire.js";
+import { QuestionnaireProgress as t } from "./QuestionnaireProgress/QuestionnaireProgress.js";
+import { QuestionnaireItem as n } from "./QuestionnaireItem/QuestionnaireItem.js";
+import { QuestionnaireTitle as r } from "./QuestionnaireTitle/QuestionnaireTitle.js";
+import { QuestionnaireDescription as i } from "./QuestionnaireDescription/QuestionnaireDescription.js";
+import { QuestionnaireChoices as a } from "./QuestionnaireChoices/QuestionnaireChoices.js";
+import { QuestionnaireChoice as o } from "./QuestionnaireChoice/QuestionnaireChoice.js";
+import { QuestionnaireInput as s } from "./QuestionnaireInput/QuestionnaireInput.js";
+import { QuestionnaireError as c } from "./QuestionnaireError/QuestionnaireError.js";
+import { QuestionnaireActions as l } from "./QuestionnaireActions/QuestionnaireActions.js";
+import { QuestionnaireNext as u, QuestionnairePrevious as d, QuestionnaireSkip as f, QuestionnaireSubmit as p } from "./QuestionnaireNavigation/QuestionnaireNavigation.js";
+export { e as Questionnaire, l as QuestionnaireActions, o as QuestionnaireChoice, a as QuestionnaireChoices, i as QuestionnaireDescription, c as QuestionnaireError, s as QuestionnaireInput, n as QuestionnaireItem, u as QuestionnaireNext, d as QuestionnairePrevious, t as QuestionnaireProgress, f as QuestionnaireSkip, p as QuestionnaireSubmit, r as QuestionnaireTitle };

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

@@ -0,0 +1,65 @@
+import { Accessor } from 'solid-js';
+import { QuestionnaireItemDefinition, QuestionnaireItemStatus, QuestionnaireRootState, QuestionnaireShortcutMode } from './questionnaire.types';
+export interface QuestionnaireAnswerEntry {
+    id: string;
+    element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+    type: "choice" | "input";
+    value?: string;
+    disabled: boolean;
+    ownDisabled?: boolean;
+}
+export interface QuestionnaireItemHandle {
+    name: string;
+    element: HTMLElement;
+    disabled: Accessor<boolean>;
+    required: Accessor<boolean>;
+    status: Accessor<QuestionnaireItemStatus>;
+    validate: () => boolean;
+    focus: () => void;
+    focusInvalid: () => void;
+    skip: () => void;
+    reset: () => void;
+    getAnswerByElement: (element: Element) => QuestionnaireAnswerEntry | null;
+    getAnswerByShortcut: (shortcut: string) => QuestionnaireAnswerEntry | null;
+    moveAnswerFocus: (target: Element, direction: "next" | "previous") => boolean;
+}
+export interface QuestionnaireRootContextValue {
+    state: Accessor<QuestionnaireRootState>;
+    activeItemName: Accessor<string | null>;
+    activeItemRequired: Accessor<boolean | null>;
+    activeItemStatus: Accessor<QuestionnaireItemStatus | null>;
+    shortcuts: Accessor<QuestionnaireShortcutMode | null>;
+    nativeValidation: Accessor<boolean>;
+    itemDefinitions: Accessor<Map<string, QuestionnaireItemDefinition> | null>;
+    registerItem: (item: QuestionnaireItemHandle) => () => void;
+    goNext: () => void;
+    goPrevious: () => void;
+    skipCurrent: () => void;
+    requestSubmit: () => void;
+}
+export interface QuestionnaireItemContextValue {
+    name: string;
+    active: Accessor<boolean>;
+    disabled: Accessor<boolean>;
+    invalid: Accessor<boolean>;
+    multiple: Accessor<boolean>;
+    required: Accessor<boolean>;
+    status: Accessor<QuestionnaireItemStatus>;
+    hasInputAnswer: Accessor<boolean>;
+    selectedAnswerIds: Accessor<string[]>;
+    resetVersion: Accessor<number>;
+    shortcutByAnswerId: Accessor<Map<string, string>>;
+    shortcutByChoiceValue: Accessor<Map<string, string> | null>;
+    shortcuts: Accessor<QuestionnaireShortcutMode | null>;
+    registerAnswerControl: (entry: QuestionnaireAnswerEntry) => () => void;
+    registerAnswerSelection: (id: string, initialSelected: boolean) => () => void;
+    registerDescription: (id: string) => () => void;
+    registerError: (id: string) => () => void;
+    setAnswerDefault: (id: string, selected: boolean) => void;
+    setAnswerSelectionFromInteraction: (id: string, selected: boolean) => void;
+    syncControlledAnswerSelection: (id: string, selected: boolean) => void;
+}
+export declare const QuestionnaireRootContext: import('solid-js').Context<QuestionnaireRootContextValue | undefined>;
+export declare function useQuestionnaireRootContext(component: string): QuestionnaireRootContextValue;
+export declare const QuestionnaireItemContext: import('solid-js').Context<QuestionnaireItemContextValue | undefined>;
+export declare function useQuestionnaireItemContext(component: string): QuestionnaireItemContextValue;

package/dist/components/questionnaire/questionnaire.context.js

@@ -0,0 +1,18 @@
+import { createContext as e, useContext as t } from "solid-js";
+//#region src/components/questionnaire/questionnaire.context.ts
+var n = e();
+function r(e) {
+	let r = t(n);
+	if (!r) throw Error(`<${e}> 必须渲染在 <Questionnaire> 内部`);
+	return r;
+}
+var i = e();
+function a(e) {
+	let n = t(i);
+	if (!n) throw Error(`<${e}> 必须渲染在 <QuestionnaireItem> 内部`);
+	return n;
+}
+//#endregion
+export { i as QuestionnaireItemContext, n as QuestionnaireRootContext, a as useQuestionnaireItemContext, r as useQuestionnaireRootContext };
+
+//# sourceMappingURL=questionnaire.context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"questionnaire.context.js","names":["QuestionnaireRootContext","createContext","useQuestionnaireRootContext","ctx","useContext","component","QuestionnaireItemContext","useQuestionnaireItemContext"],"sources":["../../../src/components/questionnaire/questionnaire.context.ts"],"sourcesContent":["import { createContext, useContext, type Accessor } from \"solid-js\";\nimport type {\n  QuestionnaireItemDefinition,\n  QuestionnaireItemStatus,\n  QuestionnaireRootState,\n  QuestionnaireShortcutMode,\n} from \"./questionnaire.types\";\n\nexport interface QuestionnaireAnswerEntry {\n  id: string;\n  element: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;\n  type: \"choice\" | \"input\";\n  value?: string;\n  disabled: boolean;\n  ownDisabled?: boolean;\n}\n\nexport interface QuestionnaireItemHandle {\n  name: string;\n  element: HTMLElement;\n  disabled: Accessor<boolean>;\n  required: Accessor<boolean>;\n  status: Accessor<QuestionnaireItemStatus>;\n  validate: () => boolean;\n  focus: () => void;\n  focusInvalid: () => void;\n  skip: () => void;\n  reset: () => void;\n  getAnswerByElement: (element: Element) => QuestionnaireAnswerEntry | null;\n  getAnswerByShortcut: (shortcut: string) => QuestionnaireAnswerEntry | null;\n  moveAnswerFocus: (target: Element, direction: \"next\" | \"previous\") => boolean;\n}\n\nexport interface QuestionnaireRootContextValue {\n  state: Accessor<QuestionnaireRootState>;\n  activeItemName: Accessor<string | null>;\n  activeItemRequired: Accessor<boolean | null>;\n  activeItemStatus: Accessor<QuestionnaireItemStatus | null>;\n  shortcuts: Accessor<QuestionnaireShortcutMode | null>;\n  nativeValidation: Accessor<boolean>;\n  itemDefinitions: Accessor<Map<string, QuestionnaireItemDefinition> | null>;\n  registerItem: (item: QuestionnaireItemHandle) => () => void;\n  goNext: () => void;\n  goPrevious: () => void;\n  skipCurrent: () => void;\n  requestSubmit: () => void;\n}\n\nexport interface QuestionnaireItemContextValue {\n  name: string;\n  active: Accessor<boolean>;\n  disabled: Accessor<boolean>;\n  invalid: Accessor<boolean>;\n  multiple: Accessor<boolean>;\n  required: Accessor<boolean>;\n  status: Accessor<QuestionnaireItemStatus>;\n  hasInputAnswer: Accessor<boolean>;\n  selectedAnswerIds: Accessor<string[]>;\n  resetVersion: Accessor<number>;\n  shortcutByAnswerId: Accessor<Map<string, string>>;\n  shortcutByChoiceValue: Accessor<Map<string, string> | null>;\n  shortcuts: Accessor<QuestionnaireShortcutMode | null>;\n  registerAnswerControl: (entry: QuestionnaireAnswerEntry) => () => void;\n  registerAnswerSelection: (id: string, initialSelected: boolean) => () => void;\n  registerDescription: (id: string) => () => void;\n  registerError: (id: string) => () => void;\n  setAnswerDefault: (id: string, selected: boolean) => void;\n  setAnswerSelectionFromInteraction: (id: string, selected: boolean) => void;\n  syncControlledAnswerSelection: (id: string, selected: boolean) => void;\n}\n\nexport const QuestionnaireRootContext =\n  createContext<QuestionnaireRootContextValue>();\n\nexport function useQuestionnaireRootContext(\n  component: string,\n): QuestionnaireRootContextValue {\n  const ctx = useContext(QuestionnaireRootContext);\n  if (!ctx) {\n    throw new Error(`<${component}> 必须渲染在 <Questionnaire> 内部`);\n  }\n  return ctx;\n}\n\nexport const QuestionnaireItemContext =\n  createContext<QuestionnaireItemContextValue>();\n\nexport function useQuestionnaireItemContext(\n  component: string,\n): QuestionnaireItemContextValue {\n  const ctx = useContext(QuestionnaireItemContext);\n  if (!ctx) {\n    throw new Error(`<${component}> 必须渲染在 <QuestionnaireItem> 内部`);\n  }\n  return ctx;\n}\n"],"mappings":";;AAuEA,IAAaA,IACXC,EAA6C;AAE/C,SAAgBC,EACd,GAC+B;CAC/B,IAAMC,IAAMC,EAAWJ,CAAwB;CAC/C,IAAI,CAACG,GACH,MAAU,MAAM,IAAIE,EAAU,2BAA2B;CAE3D,OAAOF;AACT;AAEA,IAAaG,IACXL,EAA6C;AAE/C,SAAgBM,EACd,GAC+B;CAC/B,IAAMJ,IAAMC,EAAWE,CAAwB;CAC/C,IAAI,CAACH,GACH,MAAU,MAAM,IAAIE,EAAU,+BAA+B;CAE/D,OAAOF;AACT"}

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 {};