@qw-ui/core 0.3.0-next.8 → 0.3.0

package/dist/input/index.js

@@ -1,6 +1,28 @@
 import { createMachine } from "@zag-js/core";
 import { compact } from "@zag-js/utils";
 //#region src/input/input.ts
+/** Explicitly supported native types; number is a native string field, not numeric validation. */
+const INPUT_TYPES = [
+	"text",
+	"search",
+	"tel",
+	"url",
+	"email",
+	"password",
+	"number"
+];
+function inputType(type) {
+	return INPUT_TYPES.includes(type) ? type : "text";
+}
+function inputLimit(value) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : void 0;
+}
+function clampInput(value, limit) {
+	if (limit === void 0 || value.length <= limit) return value;
+	let end = limit;
+	if (end > 0 && /[\uD800-\uDBFF]/.test(value[end - 1]) && /[\uDC00-\uDFFF]/.test(value[end])) end--;
+	return value.slice(0, end);
+}
 /**
 * Input zag.js machine。
 * 唯一状态来源：value（受控/非受控由 bindable 收敛）。
@@ -19,17 +41,21 @@ const machine = createMachine({
 		return "idle";
 	},
 	context({ bindable, prop }) {
-		return { value: bindable(() => {
-			const controlledValue = prop("value");
-			return {
-				defaultValue: prop("defaultValue") ?? "",
-				sync: true,
-				...controlledValue !== void 0 ? { value: controlledValue } : {},
-				onChange(value, prev) {
-					if (value !== prev) prop("onChange")?.(value);
-				}
-			};
-		}) };
+		return {
+			composing: bindable(() => ({ defaultValue: false })),
+			draft: bindable(() => ({ defaultValue: "" })),
+			value: bindable(() => {
+				const controlledValue = prop("value");
+				return {
+					defaultValue: prop("defaultValue") ?? "",
+					sync: true,
+					...controlledValue !== void 0 ? { value: controlledValue } : {},
+					onChange(value, prev) {
+						if (value !== prev) prop("onChange")?.(value);
+					}
+				};
+			})
+		};
 	},
 	computed: {
 		mode({ prop }) {
@@ -52,36 +78,131 @@ const machine = createMachine({
 			if (external !== void 0 && external !== context.get("value")) context.set("value", external);
 		});
 	},
+	effects: ["trackReset"],
 	states: { idle: { on: { "VALUE.SET": { actions: ["setValue"] } } } },
-	implementations: { actions: { setValue({ context, event }) {
-		if (event.type === "VALUE.SET") context.set("value", event.value);
-	} } }
+	implementations: {
+		effects: { trackReset({ scope, prop, context }) {
+			const root = scope.getRootNode();
+			let active = true;
+			const pending = /* @__PURE__ */ new Set();
+			const onReset = (event) => {
+				const input = scope.getById(prop("control")?.id ?? `input:${scope.id}:input`);
+				if (!input || input.form !== event.target) return;
+				const timer = setTimeout(() => {
+					pending.delete(timer);
+					if (!active || event.defaultPrevented || !input.isConnected) return;
+					context.set("composing", false);
+					if (prop("value") === void 0) context.set("value", prop("defaultValue") ?? "");
+					input.value = context.get("value");
+				}, 0);
+				pending.add(timer);
+			};
+			root.addEventListener("reset", onReset);
+			return () => {
+				active = false;
+				root.removeEventListener("reset", onReset);
+				pending.forEach(clearTimeout);
+			};
+		} },
+		actions: { setValue({ context, event }) {
+			if (event.type === "VALUE.SET") context.set("value", event.value);
+		} }
+	}
 });
 /**
 * connect：把 service 接成业务友好的 prop-getter。
 * 适配层只需调用 connect(service, normalizeProps)，按 api.mode 选择渲染子树。
 */
 function connect(service, normalizeProps) {
-	const { context, computed, prop } = service;
+	const { context, computed, prop, scope } = service;
 	const value = context.get("value");
 	const mode = computed("mode");
 	const overflow = computed("overflow");
 	const clampLines = computed("clampLines");
+	const disabled = () => prop("disabled") === true || prop("control")?.disabled === true;
+	const editable = () => !prop("readOnly") && !disabled();
+	const type = inputType(prop("type"));
+	const limit = type === "number" ? void 0 : inputLimit(prop("maxLength"));
+	const inputId = () => prop("control")?.id ?? `input:${scope.id}:input`;
+	const countId = `input:${scope.id}:count`;
+	function writeback(target) {
+		const confirmed = context.get("value");
+		if (target.value === confirmed) return;
+		const start = target.selectionStart, end = target.selectionEnd, direction = target.selectionDirection;
+		target.value = confirmed;
+		if (typeof target.setSelectionRange === "function" && start !== null && end !== null) try {
+			target.setSelectionRange(Math.min(start, confirmed.length), Math.min(end, confirmed.length), direction ?? void 0);
+		} catch {}
+	}
+	function commit(target) {
+		if (editable() && !target.matches?.(":disabled")) context.set("value", clampInput(target.value, limit));
+		writeback(target);
+		queueMicrotask(() => {
+			if (target.isConnected && !context.get("composing")) writeback(target);
+		});
+	}
 	return {
 		value,
 		mode,
 		overflow,
+		showClear: mode === "input" && !!prop("clearable") && editable() && value.length > 0,
+		showCount: mode === "input" && !!prop("showCount"),
+		countText: limit === void 0 ? String(value.length) : `${value.length} / ${limit}`,
+		getPrefixProps() {
+			return normalizeProps.element({
+				"data-scope": "input",
+				"data-part": "prefix"
+			});
+		},
+		getSuffixProps() {
+			return normalizeProps.element({
+				"data-scope": "input",
+				"data-part": "suffix"
+			});
+		},
+		getCountProps() {
+			return normalizeProps.element({
+				"data-scope": "input",
+				"data-part": "count",
+				id: countId
+			});
+		},
+		getClearProps() {
+			return normalizeProps.button(compact({
+				"data-scope": "input",
+				"data-part": "clear",
+				type: "button",
+				disabled: disabled() || prop("readOnly") || void 0,
+				"aria-label": prop("clearLabel") ?? "Clear input",
+				onPointerDown(event) {
+					event.preventDefault();
+				},
+				onClick() {
+					const input = scope.getById(inputId());
+					if (!editable() || !prop("clearable") || !context.get("value") || input?.matches(":disabled")) return;
+					context.set("composing", false);
+					context.set("value", "");
+					prop("onClear")?.();
+					if (input) {
+						writeback(input);
+						input.focus({ preventScroll: true });
+					}
+				}
+			}));
+		},
 		getRootProps() {
 			return normalizeProps.element(compact({
 				"data-scope": "input",
 				"data-part": "root",
-				"data-mode": mode
+				"data-mode": mode,
+				"data-disabled": disabled() || void 0
 			}));
 		},
 		getTitleProps() {
 			return normalizeProps.element(compact({
 				"data-scope": "input",
-				"data-part": "title"
+				"data-part": "title",
+				id: `input:${scope.id}:title`
 			}));
 		},
 		getFieldProps() {
@@ -91,15 +212,46 @@ function connect(service, normalizeProps) {
 			}));
 		},
 		getInputProps() {
+			const control = prop("control");
 			return normalizeProps.input(compact({
 				"data-scope": "input",
 				"data-part": "input",
-				type: "text",
-				value,
+				type,
+				inputMode: prop("inputMode"),
+				maxLength: limit,
+				value: context.get("composing") ? context.get("draft") : value,
 				placeholder: prop("placeholder"),
+				id: control?.id ?? `input:${scope.id}:input`,
+				name: control?.name,
+				form: control?.form,
+				disabled: disabled() || void 0,
+				required: control?.required,
+				"aria-labelledby": control?.labelledBy ?? (prop("title") ? `input:${scope.id}:title` : void 0),
+				"aria-describedby": [control?.describedBy, prop("showCount") ? countId : void 0].filter(Boolean).join(" ") || void 0,
+				"aria-invalid": control?.invalid || void 0,
+				onBlur() {
+					if (!disabled()) prop("onBlur")?.();
+				},
+				onCompositionStart(event) {
+					if (!editable()) return;
+					context.set("draft", event.target.value);
+					context.set("composing", true);
+				},
+				onCompositionEnd(event) {
+					context.set("composing", false);
+					commit(event.target);
+				},
 				onChange(event) {
 					const target = event.target;
-					context.set("value", target.value);
+					const native = event.nativeEvent;
+					if (context.get("composing") || native?.isComposing) {
+						if (editable()) {
+							context.set("draft", target.value);
+							if (limit === void 0) context.set("value", target.value);
+						}
+						return;
+					}
+					commit(target);
 				}
 			}));
 		},
@@ -108,15 +260,22 @@ function connect(service, normalizeProps) {
 				"data-scope": "input",
 				"data-part": "icon",
 				onClick() {
-					prop("onIconClick")?.();
+					if (editable()) prop("onIconClick")?.();
 				}
 			}));
 		},
 		getReadonlyProps() {
+			const control = prop("control");
 			return normalizeProps.element(compact({
 				"data-scope": "input",
 				"data-part": "readonly",
 				"data-overflow": overflow,
+				id: control?.id ?? `input:${scope.id}:readonly`,
+				role: control || prop("title") ? "group" : void 0,
+				"aria-labelledby": control?.labelledBy,
+				"aria-label": control?.labelledBy === void 0 ? prop("title") : void 0,
+				"aria-describedby": control?.describedBy,
+				"aria-invalid": control?.invalid || void 0,
 				style: clampLines ? { ["--qw-input-max-lines"]: String(clampLines) } : void 0
 			}));
 		}
@@ -134,6 +293,6 @@ function createInputProps(props = {}) {
 	};
 }
 //#endregion
-export { connect, createInputProps, machine };
+export { INPUT_TYPES, connect, createInputProps, machine };
 
 //# sourceMappingURL=index.js.map

package/dist/input/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/input/input.ts"],"sourcesContent":["import { createMachine } from \"@zag-js/core\";\nimport type { MachineSchema, Service } from \"@zag-js/core\";\nimport type { PropTypes, NormalizeProps } from \"@zag-js/types\";\nimport type { JSX } from \"@zag-js/types\";\nimport { compact } from \"@zag-js/utils\";\n\n/**\n * 只读模式溢出策略。\n * - `wrap`：换行展示（默认），可配 `maxLines` 限制最大行数。\n * - `ellipsis`：单行超出省略。\n */\nexport type InputReadOnlyOverflow = \"wrap\" | \"ellipsis\";\n\n/**\n * 渲染模式（由 readOnly 派生）。\n */\nexport type InputMode = \"input\" | \"readonly\";\n\n/**\n * Input 公共 props 契约（双栈共享，不含框架特有节点类型）。\n */\nexport interface QwInputProps {\n  /** 唯一 id 前缀。 */\n  id?: string;\n  /** true=只读模式，false=输入模式。默认 false。 */\n  readOnly?: boolean;\n  /** 受控值。 */\n  value?: string;\n  /** 非受控初始值。默认 \"\"。 */\n  defaultValue?: string;\n  /** 输入变化回调（仅输入模式触发）。 */\n  onChange?: (value: string) => void;\n  /** 输入模式提示文本（右对齐）。 */\n  placeholder?: string;\n  /** 左侧标题文本（宽度自适应）。 */\n  title?: string;\n  /** icon 点击回调（仅输入模式）。 */\n  onIconClick?: () => void;\n  /** 只读模式溢出策略。默认 \"wrap\"。 */\n  readOnlyOverflow?: InputReadOnlyOverflow;\n  /** 只读换行最大行数（仅 wrap 生效；缺省不限行数）。 */\n  maxLines?: number;\n}\n\n/**\n * 内部 schema，用于 createMachine 类型推导。\n */\ninterface InputSchema extends MachineSchema {\n  props: QwInputProps;\n  context: {\n    value: string;\n  };\n  computed: {\n    mode: InputMode;\n    overflow: InputReadOnlyOverflow | undefined;\n    clampLines: number | undefined;\n  };\n  state: \"idle\";\n  event: { type: \"VALUE.SET\"; value: string };\n  action: \"setValue\";\n}\n\n/**\n * Input zag.js machine。\n * 唯一状态来源：value（受控/非受控由 bindable 收敛）。\n * readOnly / overflow / maxLines 为纯派生，不进入状态。\n */\nexport const machine = createMachine<InputSchema>({\n  props({ props }) {\n    return {\n      defaultValue: \"\",\n      readOnly: false,\n      readOnlyOverflow: \"wrap\",\n      ...props,\n    };\n  },\n\n  initialState() {\n    return \"idle\";\n  },\n\n  context({ bindable, prop }) {\n    return {\n      value: bindable<string>(() => {\n        const controlledValue = prop(\"value\");\n        return {\n          defaultValue: prop(\"defaultValue\") ?? \"\",\n          sync: true,\n          ...(controlledValue !== undefined ? { value: controlledValue } : {}),\n          onChange(value, prev) {\n            if (value !== prev) {\n              prop(\"onChange\")?.(value);\n            }\n          },\n        };\n      }),\n    };\n  },\n\n  computed: {\n    mode({ prop }) {\n      return prop(\"readOnly\") ? \"readonly\" : \"input\";\n    },\n    overflow({ prop }) {\n      if (!prop(\"readOnly\")) return undefined;\n      return prop(\"readOnlyOverflow\") ?? \"wrap\";\n    },\n    clampLines({ prop, computed }) {\n      if (computed(\"mode\") !== \"readonly\") return undefined;\n      if (computed(\"overflow\") !== \"wrap\") return undefined;\n      const max = prop(\"maxLines\");\n      return typeof max === \"number\" && max > 0 ? Math.floor(max) : undefined;\n    },\n  },\n\n  watch({ track, prop, context }) {\n    track([() => prop(\"value\")], () => {\n      const external = prop(\"value\");\n      if (external !== undefined && external !== context.get(\"value\")) {\n        context.set(\"value\", external);\n      }\n    });\n  },\n\n  states: {\n    idle: {\n      on: {\n        \"VALUE.SET\": {\n          actions: [\"setValue\"],\n        },\n      },\n    },\n  },\n\n  implementations: {\n    actions: {\n      setValue({ context, event }) {\n        if (event.type === \"VALUE.SET\") {\n          context.set(\"value\", event.value);\n        }\n      },\n    },\n  },\n});\n\n/**\n * Input api 类型（由 connect 返回）。\n */\nexport interface InputApi<T extends PropTypes = PropTypes> {\n  /** 当前值。 */\n  value: string;\n  /** 渲染模式：input | readonly。 */\n  mode: InputMode;\n  /** 只读溢出策略（输入模式为 undefined）。 */\n  overflow: InputReadOnlyOverflow | undefined;\n  /** 根容器 prop-getter。 */\n  getRootProps(): T[\"element\"];\n  /** 左侧标题 prop-getter。 */\n  getTitleProps(): T[\"element\"];\n  /** 输入区容器 prop-getter（输入模式）。 */\n  getFieldProps(): T[\"element\"];\n  /** 输入框 prop-getter（输入模式）。 */\n  getInputProps(): T[\"input\"];\n  /** 右侧图标容器 prop-getter（输入模式，承载点击）。 */\n  getIconProps(): T[\"element\"];\n  /** 只读展示容器 prop-getter（只读模式）。 */\n  getReadonlyProps(): T[\"element\"];\n}\n\n/**\n * connect：把 service 接成业务友好的 prop-getter。\n * 适配层只需调用 connect(service, normalizeProps)，按 api.mode 选择渲染子树。\n */\nexport function connect<T extends PropTypes>(service: Service<InputSchema>, normalizeProps: NormalizeProps<T>): InputApi<T> {\n  const { context, computed, prop } = service;\n\n  const value = context.get(\"value\");\n  const mode = computed(\"mode\");\n  const overflow = computed(\"overflow\");\n  const clampLines = computed(\"clampLines\");\n\n  return {\n    value,\n    mode,\n    overflow,\n\n    getRootProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"root\",\n          \"data-mode\": mode,\n        }),\n      );\n    },\n\n    getTitleProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"title\",\n        }),\n      );\n    },\n\n    getFieldProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"field\",\n        }),\n      );\n    },\n\n    getInputProps() {\n      return normalizeProps.input(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"input\",\n          type: \"text\" as const,\n          value,\n          placeholder: prop(\"placeholder\"),\n          onChange(event: JSX.ChangeEvent<HTMLInputElement>) {\n            const target = event.target as HTMLInputElement;\n            // 直接同步更新，绕过 send() 的 queueMicrotask 延迟\n            context.set(\"value\", target.value);\n          },\n        }),\n      );\n    },\n\n    getIconProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"icon\",\n          onClick() {\n            prop(\"onIconClick\")?.();\n          },\n        }),\n      );\n    },\n\n    getReadonlyProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"readonly\",\n          \"data-overflow\": overflow,\n          style: clampLines ? ({ [\"--qw-input-max-lines\"]: String(clampLines) } as Record<string, string>) : undefined,\n        }),\n      );\n    },\n  };\n}\n\n/**\n * 把 QwInputProps 转成 machine props（默认值收口）。\n */\nexport function createInputProps(props: QwInputProps = {}): Partial<QwInputProps> {\n  return {\n    defaultValue: props.defaultValue ?? \"\",\n    readOnly: props.readOnly ?? false,\n    readOnlyOverflow: props.readOnlyOverflow ?? \"wrap\",\n    ...props,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/input/input.ts"],"sourcesContent":["import { createMachine } from \"@zag-js/core\";\nimport type { MachineSchema, Service } from \"@zag-js/core\";\nimport type { PropTypes, NormalizeProps } from \"@zag-js/types\";\nimport type { JSX } from \"@zag-js/types\";\nimport { compact } from \"@zag-js/utils\";\n\n/**\n * 只读模式溢出策略。\n * - `wrap`：换行展示（默认），可配 `maxLines` 限制最大行数。\n * - `ellipsis`：单行超出省略。\n */\nexport type InputReadOnlyOverflow = \"wrap\" | \"ellipsis\";\n\n/**\n * 渲染模式（由 readOnly 派生）。\n */\nexport type InputMode = \"input\" | \"readonly\";\n\n/** Explicitly supported native types; number is a native string field, not numeric validation. */\nexport const INPUT_TYPES = [\"text\", \"search\", \"tel\", \"url\", \"email\", \"password\", \"number\"] as const;\nexport type InputType = (typeof INPUT_TYPES)[number];\nexport type InputInputMode = \"none\" | \"text\" | \"tel\" | \"url\" | \"email\" | \"numeric\" | \"decimal\" | \"search\";\nfunction inputType(type: InputType | undefined): InputType { return INPUT_TYPES.includes(type as InputType) ? type! : \"text\"; }\nfunction inputLimit(value: number | undefined): number | undefined { return typeof value === \"number\" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : undefined; }\nfunction clampInput(value: string, limit: number | undefined): string {\n  if (limit === undefined || value.length <= limit) return value;\n  let end = limit;\n  if (end > 0 && /[\\uD800-\\uDBFF]/.test(value[end - 1]!) && /[\\uDC00-\\uDFFF]/.test(value[end]!)) end--;\n  return value.slice(0, end);\n}\n\n/** Attributes of the actual editable input or named readonly display. */\nexport interface QwInputControlProps {\n  id?: string;\n  name?: string;\n  form?: string;\n  disabled?: boolean;\n  required?: boolean;\n  labelledBy?: string;\n  describedBy?: string;\n  invalid?: boolean;\n}\n\n/**\n * Input 公共 props 契约（双栈共享，不含框架特有节点类型）。\n */\nexport interface QwInputProps {\n  /** Beta: disables editing and all trailing actions; combines with control.disabled. */\n  disabled?: boolean;\n  /** Beta: native input type, default text. */\n  type?: InputType;\n  /** Beta: independent mobile keyboard hint, not validation. */\n  inputMode?: InputInputMode;\n  /** Beta: optional named native clear button. */\n  clearable?: boolean;\n  clearLabel?: string;\n  onClear?: () => void;\n  /** Beta: finite nonnegative UTF-16 limit for text types; ignored for number. */\n  maxLength?: number;\n  /** Beta: confirmed UTF-16 length, merged into the field description. */\n  showCount?: boolean;\n  /** 唯一 id 前缀。 */\n  id?: string;\n  /** true=只读模式，false=输入模式。默认 false。 */\n  readOnly?: boolean;\n  /** 受控值。 */\n  value?: string;\n  /** 非受控初始值。默认 \"\"。 */\n  defaultValue?: string;\n  /** 输入变化回调（仅输入模式触发）。 */\n  onChange?: (value: string) => void;\n  /** Native editable-control blur notification. */\n  onBlur?: () => void;\n  control?: QwInputControlProps;\n  /** 输入模式提示文本；有 title 时靠末端对齐，独立表单布局靠起始侧。 */\n  placeholder?: string;\n  /** 左侧标题文本（宽度自适应）。 */\n  title?: string;\n  /** icon 点击回调（仅输入模式）。 */\n  onIconClick?: () => void;\n  /** 只读模式溢出策略。默认 \"wrap\"。 */\n  readOnlyOverflow?: InputReadOnlyOverflow;\n  /** 只读换行最大行数（仅 wrap 生效；缺省不限行数）。 */\n  maxLines?: number;\n}\n\n/**\n * 内部 schema，用于 createMachine 类型推导。\n */\ninterface InputSchema extends MachineSchema {\n  props: QwInputProps;\n  context: {\n    value: string;\n    composing: boolean;\n    draft: string;\n  };\n  computed: {\n    mode: InputMode;\n    overflow: InputReadOnlyOverflow | undefined;\n    clampLines: number | undefined;\n  };\n  state: \"idle\";\n  event: { type: \"VALUE.SET\"; value: string };\n  action: \"setValue\";\n  effect: \"trackReset\";\n}\n\n/**\n * Input zag.js machine。\n * 唯一状态来源：value（受控/非受控由 bindable 收敛）。\n * readOnly / overflow / maxLines 为纯派生，不进入状态。\n */\nexport const machine = createMachine<InputSchema>({\n  props({ props }) {\n    return {\n      defaultValue: \"\",\n      readOnly: false,\n      readOnlyOverflow: \"wrap\",\n      ...props,\n    };\n  },\n\n  initialState() {\n    return \"idle\";\n  },\n\n  context({ bindable, prop }) {\n    return {\n      composing: bindable(() => ({ defaultValue: false })),\n      draft: bindable(() => ({ defaultValue: \"\" })),\n      value: bindable<string>(() => {\n        const controlledValue = prop(\"value\");\n        return {\n          defaultValue: prop(\"defaultValue\") ?? \"\",\n          sync: true,\n          ...(controlledValue !== undefined ? { value: controlledValue } : {}),\n          onChange(value, prev) {\n            if (value !== prev) {\n              prop(\"onChange\")?.(value);\n            }\n          },\n        };\n      }),\n    };\n  },\n\n  computed: {\n    mode({ prop }) {\n      return prop(\"readOnly\") ? \"readonly\" : \"input\";\n    },\n    overflow({ prop }) {\n      if (!prop(\"readOnly\")) return undefined;\n      return prop(\"readOnlyOverflow\") ?? \"wrap\";\n    },\n    clampLines({ prop, computed }) {\n      if (computed(\"mode\") !== \"readonly\") return undefined;\n      if (computed(\"overflow\") !== \"wrap\") return undefined;\n      const max = prop(\"maxLines\");\n      return typeof max === \"number\" && max > 0 ? Math.floor(max) : undefined;\n    },\n  },\n\n  watch({ track, prop, context }) {\n    track([() => prop(\"value\")], () => {\n      const external = prop(\"value\");\n      if (external !== undefined && external !== context.get(\"value\")) {\n        context.set(\"value\", external);\n      }\n    });\n  },\n\n  effects: [\"trackReset\"],\n\n  states: {\n    idle: {\n      on: {\n        \"VALUE.SET\": {\n          actions: [\"setValue\"],\n        },\n      },\n    },\n  },\n\n  implementations: {\n    effects: {\n      trackReset({ scope, prop, context }) {\n        const root = scope.getRootNode();\n        let active = true;\n        const pending = new Set<ReturnType<typeof setTimeout>>();\n        const onReset = (event: Event) => {\n          const input = scope.getById<HTMLInputElement>(prop(\"control\")?.id ?? `input:${scope.id}:input`);\n          if (!input || input.form !== event.target) return;\n          const timer = setTimeout(() => {\n            pending.delete(timer);\n            if (!active || event.defaultPrevented || !input.isConnected) return;\n            context.set(\"composing\", false);\n            if (prop(\"value\") === undefined) context.set(\"value\", prop(\"defaultValue\") ?? \"\");\n            input.value = context.get(\"value\");\n          }, 0);\n          pending.add(timer);\n        };\n        root.addEventListener(\"reset\", onReset);\n        return () => { active = false; root.removeEventListener(\"reset\", onReset); pending.forEach(clearTimeout); };\n      },\n    },\n    actions: {\n      setValue({ context, event }) {\n        if (event.type === \"VALUE.SET\") {\n          context.set(\"value\", event.value);\n        }\n      },\n    },\n  },\n});\n\n/**\n * Input api 类型（由 connect 返回）。\n */\nexport interface InputApi<T extends PropTypes = PropTypes> {\n  /** 当前值。 */\n  value: string;\n  /** 渲染模式：input | readonly。 */\n  mode: InputMode;\n  /** 只读溢出策略（输入模式为 undefined）。 */\n  overflow: InputReadOnlyOverflow | undefined;\n  /** Beta clear/count presentation derives from confirmed Core state. */\n  showClear: boolean;\n  showCount: boolean;\n  countText: string;\n  getClearProps(): T[\"button\"];\n  getCountProps(): T[\"element\"];\n  getPrefixProps(): T[\"element\"];\n  getSuffixProps(): T[\"element\"];\n  /** 根容器 prop-getter。 */\n  getRootProps(): T[\"element\"];\n  /** 左侧标题 prop-getter。 */\n  getTitleProps(): T[\"element\"];\n  /** 输入区容器 prop-getter（输入模式）。 */\n  getFieldProps(): T[\"element\"];\n  /** 输入框 prop-getter（输入模式）。 */\n  getInputProps(): T[\"input\"];\n  /** 右侧图标容器 prop-getter（输入模式，承载点击）。 */\n  getIconProps(): T[\"element\"];\n  /** 只读展示容器 prop-getter（只读模式）。 */\n  getReadonlyProps(): T[\"element\"];\n}\n\n/**\n * connect：把 service 接成业务友好的 prop-getter。\n * 适配层只需调用 connect(service, normalizeProps)，按 api.mode 选择渲染子树。\n */\nexport function connect<T extends PropTypes>(service: Service<InputSchema>, normalizeProps: NormalizeProps<T>): InputApi<T> {\n  const { context, computed, prop, scope } = service;\n\n  const value = context.get(\"value\");\n  const mode = computed(\"mode\");\n  const overflow = computed(\"overflow\");\n  const clampLines = computed(\"clampLines\");\n  const disabled = () => prop(\"disabled\") === true || prop(\"control\")?.disabled === true;\n  const editable = () => !prop(\"readOnly\") && !disabled();\n  const type = inputType(prop(\"type\"));\n  const limit = type === \"number\" ? undefined : inputLimit(prop(\"maxLength\"));\n  const inputId = () => prop(\"control\")?.id ?? `input:${scope.id}:input`;\n  const countId = `input:${scope.id}:count`;\n  function writeback(target: HTMLInputElement) {\n    const confirmed = context.get(\"value\");\n    if (target.value === confirmed) return;\n    const start = target.selectionStart, end = target.selectionEnd, direction = target.selectionDirection;\n    target.value = confirmed;\n    if (typeof target.setSelectionRange === \"function\" && start !== null && end !== null) {\n      try { target.setSelectionRange(Math.min(start, confirmed.length), Math.min(end, confirmed.length), direction ?? undefined); } catch { /* number/email do not expose text selection */ }\n    }\n  }\n  function commit(target: HTMLInputElement) {\n    if (editable() && !target.matches?.(\":disabled\")) context.set(\"value\", clampInput(target.value, limit));\n    writeback(target);\n    queueMicrotask(() => { if (target.isConnected && !context.get(\"composing\")) writeback(target); });\n  }\n\n  return {\n    value,\n    mode,\n    overflow,\n    showClear: mode === \"input\" && !!prop(\"clearable\") && editable() && value.length > 0,\n    showCount: mode === \"input\" && !!prop(\"showCount\"),\n    countText: limit === undefined ? String(value.length) : `${value.length} / ${limit}`,\n    getPrefixProps() { return normalizeProps.element({ \"data-scope\": \"input\", \"data-part\": \"prefix\" }); },\n    getSuffixProps() { return normalizeProps.element({ \"data-scope\": \"input\", \"data-part\": \"suffix\" }); },\n    getCountProps() { return normalizeProps.element({ \"data-scope\": \"input\", \"data-part\": \"count\", id: countId }); },\n    getClearProps() {\n      return normalizeProps.button(compact({\n        \"data-scope\": \"input\", \"data-part\": \"clear\", type: \"button\" as const, disabled: disabled() || prop(\"readOnly\") || undefined,\n        \"aria-label\": prop(\"clearLabel\") ?? \"Clear input\",\n        onPointerDown(event: JSX.PointerEvent) { event.preventDefault(); },\n        onClick() {\n          const input = scope.getById<HTMLInputElement>(inputId());\n          if (!editable() || !prop(\"clearable\") || !context.get(\"value\") || input?.matches(\":disabled\")) return;\n          context.set(\"composing\", false);\n          context.set(\"value\", \"\");\n          prop(\"onClear\")?.();\n          if (input) { writeback(input); input.focus({ preventScroll: true }); }\n        },\n      }));\n    },\n\n    getRootProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"root\",\n          \"data-mode\": mode,\n          \"data-disabled\": disabled() || undefined,\n        }),\n      );\n    },\n\n    getTitleProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"title\",\n          id: `input:${scope.id}:title`,\n        }),\n      );\n    },\n\n    getFieldProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"field\",\n        }),\n      );\n    },\n\n    getInputProps() {\n      const control = prop(\"control\");\n      return normalizeProps.input(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"input\",\n          type,\n          inputMode: prop(\"inputMode\"),\n          maxLength: limit,\n          value: context.get(\"composing\") ? context.get(\"draft\") : value,\n          placeholder: prop(\"placeholder\"),\n          id: control?.id ?? `input:${scope.id}:input`,\n          name: control?.name,\n          form: control?.form,\n          disabled: disabled() || undefined,\n          required: control?.required,\n          \"aria-labelledby\": control?.labelledBy ?? (prop(\"title\") ? `input:${scope.id}:title` : undefined),\n          \"aria-describedby\": [control?.describedBy, prop(\"showCount\") ? countId : undefined].filter(Boolean).join(\" \") || undefined,\n          \"aria-invalid\": control?.invalid || undefined,\n          onBlur() { if (!disabled()) prop(\"onBlur\")?.(); },\n          onCompositionStart(event: JSX.CompositionEvent<HTMLInputElement>) {\n            if (!editable()) return;\n            context.set(\"draft\", (event.target as HTMLInputElement).value);\n            context.set(\"composing\", true);\n          },\n          onCompositionEnd(event: JSX.CompositionEvent<HTMLInputElement>) { context.set(\"composing\", false); commit(event.target as HTMLInputElement); },\n          onChange(event: JSX.ChangeEvent<HTMLInputElement>) {\n            const target = event.target as HTMLInputElement;\n            const native = event.nativeEvent as InputEvent | undefined;\n            if (context.get(\"composing\") || native?.isComposing) {\n              if (editable()) {\n                context.set(\"draft\", target.value);\n                // No effective limit preserves the existing intermediate IME notifications.\n                if (limit === undefined) context.set(\"value\", target.value);\n              }\n              return;\n            }\n            commit(target);\n          },\n        }),\n      );\n    },\n\n    getIconProps() {\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"icon\",\n          onClick() {\n            if (editable()) prop(\"onIconClick\")?.();\n          },\n        }),\n      );\n    },\n\n    getReadonlyProps() {\n      const control = prop(\"control\");\n      return normalizeProps.element(\n        compact({\n          \"data-scope\": \"input\",\n          \"data-part\": \"readonly\",\n          \"data-overflow\": overflow,\n          id: control?.id ?? `input:${scope.id}:readonly`,\n          role: control || prop(\"title\") ? \"group\" : undefined,\n          \"aria-labelledby\": control?.labelledBy,\n          \"aria-label\": control?.labelledBy === undefined ? prop(\"title\") : undefined,\n          \"aria-describedby\": control?.describedBy,\n          \"aria-invalid\": control?.invalid || undefined,\n          style: clampLines ? ({ [\"--qw-input-max-lines\"]: String(clampLines) } as Record<string, string>) : undefined,\n        }),\n      );\n    },\n  };\n}\n\n/**\n * 把 QwInputProps 转成 machine props（默认值收口）。\n */\nexport function createInputProps(props: QwInputProps = {}): Partial<QwInputProps> {\n  return {\n    defaultValue: props.defaultValue ?? \"\",\n    readOnly: props.readOnly ?? false,\n    readOnlyOverflow: props.readOnlyOverflow ?? \"wrap\",\n    ...props,\n  };\n}\n"],"mappings":"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"}

package/dist/input/input.d.ts

@@ -10,10 +10,39 @@ export type InputReadOnlyOverflow = "wrap" | "ellipsis";
  * 渲染模式（由 readOnly 派生）。
  */
 export type InputMode = "input" | "readonly";
+/** Explicitly supported native types; number is a native string field, not numeric validation. */
+export declare const INPUT_TYPES: readonly ["text", "search", "tel", "url", "email", "password", "number"];
+export type InputType = (typeof INPUT_TYPES)[number];
+export type InputInputMode = "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search";
+/** Attributes of the actual editable input or named readonly display. */
+export interface QwInputControlProps {
+    id?: string;
+    name?: string;
+    form?: string;
+    disabled?: boolean;
+    required?: boolean;
+    labelledBy?: string;
+    describedBy?: string;
+    invalid?: boolean;
+}
 /**
  * Input 公共 props 契约（双栈共享，不含框架特有节点类型）。
  */
 export interface QwInputProps {
+    /** Beta: disables editing and all trailing actions; combines with control.disabled. */
+    disabled?: boolean;
+    /** Beta: native input type, default text. */
+    type?: InputType;
+    /** Beta: independent mobile keyboard hint, not validation. */
+    inputMode?: InputInputMode;
+    /** Beta: optional named native clear button. */
+    clearable?: boolean;
+    clearLabel?: string;
+    onClear?: () => void;
+    /** Beta: finite nonnegative UTF-16 limit for text types; ignored for number. */
+    maxLength?: number;
+    /** Beta: confirmed UTF-16 length, merged into the field description. */
+    showCount?: boolean;
     /** 唯一 id 前缀。 */
     id?: string;
     /** true=只读模式，false=输入模式。默认 false。 */
@@ -24,7 +53,10 @@ export interface QwInputProps {
     defaultValue?: string;
     /** 输入变化回调（仅输入模式触发）。 */
     onChange?: (value: string) => void;
-    /** 输入模式提示文本（右对齐）。 */
+    /** Native editable-control blur notification. */
+    onBlur?: () => void;
+    control?: QwInputControlProps;
+    /** 输入模式提示文本；有 title 时靠末端对齐，独立表单布局靠起始侧。 */
     placeholder?: string;
     /** 左侧标题文本（宽度自适应）。 */
     title?: string;
@@ -42,6 +74,8 @@ interface InputSchema extends MachineSchema {
     props: QwInputProps;
     context: {
         value: string;
+        composing: boolean;
+        draft: string;
     };
     computed: {
         mode: InputMode;
@@ -54,6 +88,7 @@ interface InputSchema extends MachineSchema {
         value: string;
     };
     action: "setValue";
+    effect: "trackReset";
 }
 /**
  * Input zag.js machine。
@@ -71,6 +106,14 @@ export interface InputApi<T extends PropTypes = PropTypes> {
     mode: InputMode;
     /** 只读溢出策略（输入模式为 undefined）。 */
     overflow: InputReadOnlyOverflow | undefined;
+    /** Beta clear/count presentation derives from confirmed Core state. */
+    showClear: boolean;
+    showCount: boolean;
+    countText: string;
+    getClearProps(): T["button"];
+    getCountProps(): T["element"];
+    getPrefixProps(): T["element"];
+    getSuffixProps(): T["element"];
     /** 根容器 prop-getter。 */
     getRootProps(): T["element"];
     /** 左侧标题 prop-getter。 */