@qw-ui/core 0.3.0-next.40 → 0.3.0-next.42

package/dist/password-input/index.js

@@ -0,0 +1,317 @@
+import { createMachine } from "@zag-js/core";
+import { addDomEvent, dataAttr, isInputElement } from "@zag-js/dom-query";
+//#region src/password-input/password-input.ts
+/**
+* PasswordInput 密码格 / 验证码：一个真实 `<input>` 承载焦点、选区、粘贴、读屏与表单，
+* 格子只是 `aria-hidden` 的呈现层。
+*
+* Core 持有：长度/字符集归一化、受控提议与拒绝写回、粘贴合并、掩码、选区→高亮格、
+* 一次填满一次 onComplete、表单 reset 恢复默认值。Core 从不提交表单、也不校验验证码。
+*/
+/** Stable DOM parts shared by every adapter. */
+const PASSWORD_INPUT_PARTS = [
+	"root",
+	"input",
+	"cells",
+	"cell",
+	"hint"
+];
+const PASSWORD_INPUT_DEFAULT_LENGTH = 6;
+/** Inclusive length bounds; out-of-range or non-integer lengths are clamped / rounded down. */
+const PASSWORD_INPUT_MIN_LENGTH = 1;
+const PASSWORD_INPUT_MAX_LENGTH = 12;
+/** Character kept by each charset. Full-width digits/letters are folded to ASCII first. */
+const PASSWORD_INPUT_CHARSETS = ["numeric", "alphanumeric"];
+const PASSWORD_INPUT_MODES = ["password", "otp"];
+/** Decorative glyph drawn in a filled cell while masked. */
+const PASSWORD_INPUT_MASK_GLYPH = "•";
+const DEFAULT_LABEL = {
+	password: "密码",
+	otp: "验证码"
+};
+const text = (value) => typeof value === "string" ? value.trim() : "";
+/** Clamp to an integer in 1–12; anything unusable falls back to 6. */
+function normalizePasswordInputLength(length) {
+	if (typeof length !== "number" || !Number.isFinite(length)) return 6;
+	return Math.min(12, Math.max(1, Math.floor(length)));
+}
+/** Fold full-width ASCII (IME digits like "１２３") to half-width, drop disallowed characters, then truncate. Never throws. */
+function normalizePasswordInputValue(value, length, charset = "numeric") {
+	if (typeof value !== "string" && typeof value !== "number") return "";
+	const allowed = charset === "alphanumeric" ? /[0-9A-Za-z]/ : /[0-9]/;
+	let result = "";
+	for (const raw of String(value)) {
+		const code = raw.charCodeAt(0), char = code >= 65281 && code <= 65374 ? String.fromCharCode(code - 65248) : raw;
+		if (allowed.test(char)) result += char;
+	}
+	return result.slice(0, normalizePasswordInputLength(length));
+}
+/**
+* Merge pasted text into the current value. A paste that alone fills every cell (after filtering)
+* replaces the whole value — the usual "paste the code from SMS" case; otherwise it replaces the selection.
+* Returns the next value and the caret after the inserted text.
+*/
+function mergePasswordInputPaste(current, pasted, selection, length, charset) {
+	const size = normalizePasswordInputLength(length), clean = normalizePasswordInputValue(pasted, 48, charset);
+	if (clean.length >= size) return {
+		value: clean.slice(0, size),
+		caret: size
+	};
+	const start = Math.max(0, Math.min(selection.start, current.length)), end = Math.max(start, Math.min(selection.end, current.length));
+	const value = normalizePasswordInputValue(current.slice(0, start) + clean + current.slice(end), size, charset);
+	return {
+		value,
+		caret: Math.min(value.length, start + clean.length)
+	};
+}
+function createPasswordInputProps(props = {}) {
+	const mode = props.mode === "otp" ? "otp" : "password", charset = props.charset === "alphanumeric" ? "alphanumeric" : "numeric";
+	const length = normalizePasswordInputLength(props.length);
+	return {
+		...props,
+		mode,
+		charset,
+		length,
+		mask: typeof props.mask === "boolean" ? props.mask : mode === "password",
+		label: text(props.label) || DEFAULT_LABEL[mode],
+		hint: text(props.hint) || `${length} 位${charset === "numeric" ? "数字" : "字母或数字"}`,
+		autoComplete: props.autoComplete ?? (mode === "otp" ? "one-time-code" : "off"),
+		disabled: !!props.disabled,
+		readOnly: !!props.readOnly,
+		required: !!props.required
+	};
+}
+const normalizeWith = (prop, value) => normalizePasswordInputValue(value, prop("length"), prop("charset"));
+const inputId = (id) => `password-input:${id}:input`;
+const hintId = (id) => `password-input:${id}:hint`;
+const passwordInputMachine = createMachine({
+	props: ({ props }) => createPasswordInputProps(props),
+	initialState: () => "idle",
+	context: ({ bindable, prop }) => ({
+		value: bindable(() => ({
+			defaultValue: normalizeWith(prop, prop("defaultValue") ?? ""),
+			value: prop("value") === void 0 ? void 0 : normalizeWith(prop, prop("value")),
+			onChange: (value) => prop("onValueChange")?.({ value })
+		})),
+		selection: bindable(() => ({
+			defaultValue: {
+				start: 0,
+				end: 0
+			},
+			hash: (value) => `${value.start}:${value.end}`
+		})),
+		focused: bindable(() => ({ defaultValue: false }))
+	}),
+	refs: ({ prop }) => ({ completed: normalizeWith(prop, prop("value") ?? prop("defaultValue") ?? "").length === prop("length") }),
+	watch({ track, context, prop, action }) {
+		track([() => context.get("value"), () => prop("length")], () => action(["notifyComplete"]));
+	},
+	effects: ["trackForm"],
+	on: { "VALUE.SET": { actions: ["setValue"] } },
+	states: { idle: {} },
+	implementations: {
+		actions: {
+			setValue({ event, context, prop }) {
+				if (prop("disabled") || prop("readOnly")) return;
+				context.set("value", normalizeWith(prop, event.value));
+			},
+			notifyComplete({ context, prop, refs }) {
+				const value = context.get("value"), full = value.length === prop("length");
+				if (full && !refs.get("completed")) {
+					refs.set("completed", true);
+					prop("onComplete")?.({ value });
+				} else if (!full) refs.set("completed", false);
+			}
+		},
+		effects: { 
+		/**
+		* Form reset. Reset does not bubble, so listen in the document capture phase and match the input's current form owner:
+		* re-parenting, the form attribute and re-rendered inputs need no rebinding. Native reset runs after listeners, so the
+		* default is restored on the next task.
+		*/
+trackForm({ scope, context, prop }) {
+			const doc = scope.getDoc();
+			let stopped = false;
+			const timers = /* @__PURE__ */ new Set();
+			const release = addDomEvent(doc, "reset", (event) => {
+				const input = scope.getById(inputId(scope.id ?? ""));
+				if (!isInputElement(input) || !input.form || event.target !== input.form) return;
+				const timer = setTimeout(() => {
+					timers.delete(timer);
+					if (stopped || event.defaultPrevented) return;
+					context.set("value", normalizeWith(prop, prop("defaultValue") ?? ""));
+					if (input.isConnected) input.value = context.get("value");
+				}, 0);
+				timers.add(timer);
+			}, true);
+			return () => {
+				stopped = true;
+				release();
+				timers.forEach(clearTimeout);
+				timers.clear();
+			};
+		} }
+	}
+});
+const field = (event) => event.currentTarget ?? event.target;
+const place = (target, caret) => {
+	try {
+		target.setSelectionRange?.(caret, caret);
+	} catch {}
+};
+/**
+* Caret semantics: the real input owns caret and selection; arrows, Home/End, Backspace/Delete and shift-selection are native.
+* The visual caret cell follows selectionStart (clamped to the last cell when full); a non-collapsed selection marks its cells.
+* A plain tap/click collapses the caret to the end of the value, because input text geometry does not line up with the cells.
+*/
+function connectPasswordInput(service, normalize) {
+	const { context, prop, send, scope } = service;
+	const value = context.get("value"), length = prop("length") ?? 6, masked = !!prop("mask"), focused = context.get("focused");
+	const disabled = !!prop("disabled"), readOnly = !!prop("readOnly"), locked = disabled || readOnly, selection = context.get("selection");
+	const label = prop("label") || DEFAULT_LABEL[prop("mode") ?? "password"], hint = prop("hint") ?? "";
+	const id = scope.id ?? "";
+	const part = (name) => ({
+		"data-scope": "password-input",
+		"data-part": name
+	});
+	const ranged = selection.end > selection.start, caretIndex = Math.min(selection.start, length - 1);
+	const cells = Array.from({ length }, (_, index) => {
+		const char = value[index] ?? "";
+		return {
+			index,
+			char,
+			display: char ? masked ? "•" : char : "",
+			filled: !!char,
+			caret: focused && !disabled && !ranged && index === caretIndex,
+			selected: focused && ranged && index >= selection.start && index < selection.end
+		};
+	});
+	const select = (start, end) => {
+		const from = Math.max(0, start), current = context.get("selection"), to = Math.max(from, end);
+		if (current.start !== from || current.end !== to) context.set("selection", {
+			start: from,
+			end: to
+		});
+	};
+	const track = (event) => {
+		const target = field(event), start = target.selectionStart ?? target.value.length;
+		select(start, target.selectionEnd ?? start);
+	};
+	/** Propose, then write the effective value back so a rejected or filtered edit never lingers in the DOM. */
+	const commit = (target, proposed, caret) => {
+		if (!locked) context.set("value", proposed);
+		const accepted = context.get("value");
+		if (target.value !== accepted) {
+			target.value = accepted;
+			place(target, Math.min(caret, accepted.length));
+		}
+		select(target.selectionStart ?? accepted.length, target.selectionEnd ?? accepted.length);
+		queueMicrotask(() => {
+			if (target.isConnected !== false && target.value !== context.get("value")) {
+				target.value = context.get("value");
+				place(target, context.get("value").length);
+			}
+		});
+	};
+	return {
+		value,
+		length,
+		masked,
+		focused,
+		complete: value.length === length,
+		disabled,
+		readOnly,
+		label,
+		hint,
+		cells,
+		setValue: (next) => send({
+			type: "VALUE.SET",
+			value: next
+		}),
+		clear: () => send({
+			type: "VALUE.SET",
+			value: ""
+		}),
+		getRootProps: () => normalize.element({
+			...part("root"),
+			"data-disabled": dataAttr(disabled),
+			"data-readonly": dataAttr(readOnly),
+			"data-focused": dataAttr(focused),
+			"data-complete": dataAttr(value.length === length),
+			"data-masked": dataAttr(masked)
+		}),
+		getInputProps: () => normalize.input({
+			...part("input"),
+			id: inputId(id),
+			type: masked ? "password" : "text",
+			value,
+			name: prop("name"),
+			form: prop("form"),
+			disabled,
+			readOnly,
+			required: prop("required"),
+			maxLength: length,
+			pattern: `${prop("charset") === "alphanumeric" ? "[0-9A-Za-z]" : "[0-9]"}{${length}}`,
+			inputMode: prop("charset") === "numeric" ? "numeric" : "text",
+			autoComplete: prop("autoComplete"),
+			enterKeyHint: prop("enterKeyHint"),
+			autoCapitalize: "off",
+			autoCorrect: "off",
+			spellCheck: "false",
+			"aria-label": label,
+			"aria-describedby": hintId(id),
+			onChange(event) {
+				const target = field(event), caret = target.selectionStart ?? target.value.length;
+				if (locked) {
+					commit(target, context.get("value"), caret);
+					return;
+				}
+				commit(target, normalizeWith(prop, target.value), normalizeWith(prop, target.value.slice(0, caret)).length);
+			},
+			onPaste(event) {
+				event.preventDefault();
+				if (locked) return;
+				const target = field(event), start = target.selectionStart ?? value.length;
+				const merged = mergePasswordInputPaste(context.get("value"), event.clipboardData?.getData("text") ?? "", {
+					start,
+					end: target.selectionEnd ?? start
+				}, length, prop("charset"));
+				commit(target, merged.value, merged.caret);
+			},
+			onClick(event) {
+				const target = field(event);
+				if (target.selectionStart === target.selectionEnd) place(target, target.value.length);
+				track(event);
+			},
+			onKeyUp: track,
+			onSelect: track,
+			onFocus(event) {
+				context.set("focused", true);
+				track(event);
+			},
+			onBlur() {
+				context.set("focused", false);
+			}
+		}),
+		getCellsProps: () => normalize.element({
+			...part("cells"),
+			"aria-hidden": "true"
+		}),
+		getCellProps: (cell) => normalize.element({
+			...part("cell"),
+			"data-index": cell.index,
+			"data-filled": dataAttr(cell.filled),
+			"data-caret": dataAttr(cell.caret),
+			"data-selected": dataAttr(cell.selected),
+			"data-disabled": dataAttr(disabled)
+		}),
+		getHintProps: () => normalize.element({
+			...part("hint"),
+			id: hintId(id)
+		})
+	};
+}
+//#endregion
+export { PASSWORD_INPUT_CHARSETS, PASSWORD_INPUT_DEFAULT_LENGTH, PASSWORD_INPUT_MASK_GLYPH, PASSWORD_INPUT_MAX_LENGTH, PASSWORD_INPUT_MIN_LENGTH, PASSWORD_INPUT_MODES, PASSWORD_INPUT_PARTS, connectPasswordInput, createPasswordInputProps, mergePasswordInputPaste, normalizePasswordInputLength, normalizePasswordInputValue, passwordInputMachine };
+
+//# sourceMappingURL=index.js.map

package/dist/password-input/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/password-input/password-input.ts"],"sourcesContent":["import { createMachine, type Machine, type Service } from \"@zag-js/core\";\nimport { addDomEvent, dataAttr, isInputElement } from \"@zag-js/dom-query\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\n\n/**\n * PasswordInput 密码格 / 验证码：一个真实 `<input>` 承载焦点、选区、粘贴、读屏与表单，\n * 格子只是 `aria-hidden` 的呈现层。\n *\n * Core 持有：长度/字符集归一化、受控提议与拒绝写回、粘贴合并、掩码、选区→高亮格、\n * 一次填满一次 onComplete、表单 reset 恢复默认值。Core 从不提交表单、也不校验验证码。\n */\n\n/** Stable DOM parts shared by every adapter. */\nexport const PASSWORD_INPUT_PARTS = [\"root\", \"input\", \"cells\", \"cell\", \"hint\"] as const;\nexport const PASSWORD_INPUT_DEFAULT_LENGTH = 6;\n/** Inclusive length bounds; out-of-range or non-integer lengths are clamped / rounded down. */\nexport const PASSWORD_INPUT_MIN_LENGTH = 1;\nexport const PASSWORD_INPUT_MAX_LENGTH = 12;\n/** Character kept by each charset. Full-width digits/letters are folded to ASCII first. */\nexport const PASSWORD_INPUT_CHARSETS = [\"numeric\", \"alphanumeric\"] as const;\nexport const PASSWORD_INPUT_MODES = [\"password\", \"otp\"] as const;\n/** Decorative glyph drawn in a filled cell while masked. */\nexport const PASSWORD_INPUT_MASK_GLYPH = \"•\";\n\nexport type PasswordInputPart = (typeof PASSWORD_INPUT_PARTS)[number];\nexport type PasswordInputCharset = (typeof PASSWORD_INPUT_CHARSETS)[number];\nexport type PasswordInputMode = (typeof PASSWORD_INPUT_MODES)[number];\nexport type PasswordInputAutoComplete = \"off\" | \"one-time-code\" | \"current-password\" | \"new-password\";\nexport interface PasswordInputValueChangeDetails { value: string }\nexport interface PasswordInputCompleteDetails { value: string }\n/** One presentational cell. `char` is the real character; adapters render `display`. */\nexport interface PasswordInputCell { index: number; char: string; display: string; filled: boolean; caret: boolean; selected: boolean }\n\nexport interface QwPasswordInputProps {\n  /** Instance identity; adapters generate one when omitted. */\n  id?: string;\n  /** Number of cells; integer 1–12, default 6. */\n  length?: number;\n  /** Controlled value. Edits are proposed through onValueChange; the shown value only changes when the owner accepts. */\n  value?: string;\n  /** Uncontrolled initial value, also the value a form reset restores. Default \"\". */\n  defaultValue?: string;\n  /** Proposed value after an edit, paste or reset (already filtered and truncated). */\n  onValueChange?: (details: PasswordInputValueChangeDetails) => void;\n  /** The effective value just became full. Fires once per fill; never submits or verifies anything. */\n  onComplete?: (details: PasswordInputCompleteDetails) => void;\n  /** Allowed characters: numeric (default) keeps 0–9, alphanumeric keeps A–Z/a–z/0–9. */\n  charset?: PasswordInputCharset;\n  /** password (default) masks by default and turns autofill off; otp shows plain text and asks for one-time-code autofill. */\n  mode?: PasswordInputMode;\n  /** Draw dots instead of characters; the real input becomes type=\"password\". Default: true for password, false for otp. */\n  mask?: boolean;\n  /** Overrides the autocomplete token chosen by mode. */\n  autoComplete?: PasswordInputAutoComplete;\n  /** Accessible name of the real input; defaults to 密码 / 验证码 by mode. */\n  label?: string;\n  /** Spoken length description; defaults to \"6 位数字\" / \"6 位字母或数字\". */\n  hint?: string;\n  disabled?: boolean;\n  readOnly?: boolean;\n  required?: boolean;\n  /** Form field name; the real input submits the value under it. */\n  name?: string;\n  /** Owner form id, as the native form attribute. */\n  form?: string;\n  enterKeyHint?: \"done\" | \"go\" | \"next\" | \"send\" | \"enter\";\n}\n\nconst DEFAULT_LABEL: Record<PasswordInputMode, string> = { password: \"密码\", otp: \"验证码\" };\nconst text = (value: unknown): string => (typeof value === \"string\" ? value.trim() : \"\");\n\n/** Clamp to an integer in 1–12; anything unusable falls back to 6. */\nexport function normalizePasswordInputLength(length?: number): number {\n  if (typeof length !== \"number\" || !Number.isFinite(length)) return PASSWORD_INPUT_DEFAULT_LENGTH;\n  return Math.min(PASSWORD_INPUT_MAX_LENGTH, Math.max(PASSWORD_INPUT_MIN_LENGTH, Math.floor(length)));\n}\n\n/** Fold full-width ASCII (IME digits like \"１２３\") to half-width, drop disallowed characters, then truncate. Never throws. */\nexport function normalizePasswordInputValue(value: unknown, length?: number, charset: PasswordInputCharset = \"numeric\"): string {\n  if (typeof value !== \"string\" && typeof value !== \"number\") return \"\";\n  const allowed = charset === \"alphanumeric\" ? /[0-9A-Za-z]/ : /[0-9]/;\n  let result = \"\";\n  for (const raw of String(value)) {\n    const code = raw.charCodeAt(0), char = code >= 0xff01 && code <= 0xff5e ? String.fromCharCode(code - 0xfee0) : raw;\n    if (allowed.test(char)) result += char;\n  }\n  return result.slice(0, normalizePasswordInputLength(length));\n}\n\n/**\n * Merge pasted text into the current value. A paste that alone fills every cell (after filtering)\n * replaces the whole value — the usual \"paste the code from SMS\" case; otherwise it replaces the selection.\n * Returns the next value and the caret after the inserted text.\n */\nexport function mergePasswordInputPaste(current: string, pasted: string, selection: { start: number; end: number }, length?: number, charset?: PasswordInputCharset): { value: string; caret: number } {\n  const size = normalizePasswordInputLength(length), clean = normalizePasswordInputValue(pasted, PASSWORD_INPUT_MAX_LENGTH * 4, charset);\n  if (clean.length >= size) return { value: clean.slice(0, size), caret: size };\n  const start = Math.max(0, Math.min(selection.start, current.length)), end = Math.max(start, Math.min(selection.end, current.length));\n  const value = normalizePasswordInputValue(current.slice(0, start) + clean + current.slice(end), size, charset);\n  return { value, caret: Math.min(value.length, start + clean.length) };\n}\n\nexport function createPasswordInputProps(props: QwPasswordInputProps = {}): QwPasswordInputProps {\n  const mode: PasswordInputMode = props.mode === \"otp\" ? \"otp\" : \"password\", charset: PasswordInputCharset = props.charset === \"alphanumeric\" ? \"alphanumeric\" : \"numeric\";\n  const length = normalizePasswordInputLength(props.length);\n  return {\n    ...props, mode, charset, length,\n    mask: typeof props.mask === \"boolean\" ? props.mask : mode === \"password\",\n    label: text(props.label) || DEFAULT_LABEL[mode],\n    hint: text(props.hint) || `${length} 位${charset === \"numeric\" ? \"数字\" : \"字母或数字\"}`,\n    autoComplete: props.autoComplete ?? (mode === \"otp\" ? \"one-time-code\" : \"off\"),\n    disabled: !!props.disabled, readOnly: !!props.readOnly, required: !!props.required,\n  };\n}\n\ninterface Selection { start: number; end: number }\nexport interface QwPasswordInputSchema {\n  props: QwPasswordInputProps;\n  context: { value: string; selection: Selection; focused: boolean };\n  refs: { completed: boolean };\n  state: \"idle\";\n  action: \"setValue\" | \"notifyComplete\";\n  effect: \"trackForm\";\n  /** Programmatic proposal (api.setValue / clear). DOM handlers write context synchronously instead. */\n  event: { type: \"VALUE.SET\"; value: string };\n}\nexport type QwPasswordInputMachine = Machine<QwPasswordInputSchema>;\nexport type QwPasswordInputService = Service<QwPasswordInputSchema>;\n\nconst normalizeWith = (prop: QwPasswordInputService[\"prop\"], value: unknown) => normalizePasswordInputValue(value, prop(\"length\"), prop(\"charset\"));\nconst inputId = (id: string) => `password-input:${id}:input`;\nconst hintId = (id: string) => `password-input:${id}:hint`;\n\nexport const passwordInputMachine: QwPasswordInputMachine = createMachine<QwPasswordInputSchema>({\n  props: ({ props }) => createPasswordInputProps(props),\n  initialState: () => \"idle\",\n  context: ({ bindable, prop }) => ({\n    value: bindable(() => ({\n      defaultValue: normalizeWith(prop, prop(\"defaultValue\") ?? \"\"),\n      value: prop(\"value\") === undefined ? undefined : normalizeWith(prop, prop(\"value\")),\n      onChange: (value) => prop(\"onValueChange\")?.({ value }),\n    })),\n    selection: bindable<Selection>(() => ({ defaultValue: { start: 0, end: 0 }, hash: (value) => `${value.start}:${value.end}` })),\n    focused: bindable(() => ({ defaultValue: false })),\n  }),\n  // A value that is already full on mount is not a fresh completion.\n  refs: ({ prop }) => ({ completed: normalizeWith(prop, prop(\"value\") ?? prop(\"defaultValue\") ?? \"\").length === prop(\"length\") }),\n  watch({ track, context, prop, action }) {\n    track([() => context.get(\"value\"), () => prop(\"length\")], () => action([\"notifyComplete\"]));\n  },\n  effects: [\"trackForm\"],\n  on: { \"VALUE.SET\": { actions: [\"setValue\"] } },\n  states: { idle: {} },\n  implementations: {\n    actions: {\n      setValue({ event, context, prop }) {\n        if (prop(\"disabled\") || prop(\"readOnly\")) return;\n        context.set(\"value\", normalizeWith(prop, event.value));\n      },\n      notifyComplete({ context, prop, refs }) {\n        const value = context.get(\"value\"), full = value.length === prop(\"length\");\n        if (full && !refs.get(\"completed\")) { refs.set(\"completed\", true); prop(\"onComplete\")?.({ value }); } else if (!full) refs.set(\"completed\", false);\n      },\n    },\n    effects: {\n      /**\n       * Form reset. Reset does not bubble, so listen in the document capture phase and match the input's current form owner:\n       * re-parenting, the form attribute and re-rendered inputs need no rebinding. Native reset runs after listeners, so the\n       * default is restored on the next task.\n       */\n      trackForm({ scope, context, prop }) {\n        const doc = scope.getDoc();\n        let stopped = false;\n        const timers = new Set<ReturnType<typeof setTimeout>>();\n        const release = addDomEvent(doc, \"reset\", (event) => {\n          const input = scope.getById<HTMLInputElement>(inputId(scope.id ?? \"\"));\n          if (!isInputElement(input) || !input.form || event.target !== input.form) return;\n          const timer = setTimeout(() => {\n            timers.delete(timer);\n            if (stopped || event.defaultPrevented) return;\n            // Reset is a form operation, not a user edit: like native reset it restores the default even when disabled or readOnly.\n            context.set(\"value\", normalizeWith(prop, prop(\"defaultValue\") ?? \"\"));\n            // Write the effective value back: a rejected controlled reset or an unchanged default must not keep the browser's reset text.\n            if (input.isConnected) input.value = context.get(\"value\");\n          }, 0);\n          timers.add(timer);\n        }, true);\n        return () => { stopped = true; release(); timers.forEach(clearTimeout); timers.clear(); };\n      },\n    },\n  },\n});\n\nexport interface QwPasswordInputApi<T extends PropTypes = PropTypes> {\n  value: string;\n  length: number;\n  masked: boolean;\n  focused: boolean;\n  complete: boolean;\n  disabled: boolean;\n  readOnly: boolean;\n  label: string;\n  hint: string;\n  cells: PasswordInputCell[];\n  /** Propose a value programmatically (normalized; ignored when disabled or readOnly). */\n  setValue(value: string): void;\n  /** Propose \"\" (ignored when disabled or readOnly). */\n  clear(): void;\n  getRootProps(): T[\"element\"];\n  getInputProps(): T[\"input\"];\n  getCellsProps(): T[\"element\"];\n  getCellProps(cell: PasswordInputCell): T[\"element\"];\n  getHintProps(): T[\"element\"];\n}\n\ninterface FieldTarget { value: string; selectionStart: number | null; selectionEnd: number | null; isConnected?: boolean; setSelectionRange?(start: number, end: number): void }\ninterface FieldEvent { currentTarget?: unknown; target?: unknown }\ninterface PasteEvent extends FieldEvent { clipboardData?: { getData(type: string): string } | null; preventDefault(): void }\nconst field = (event: FieldEvent): FieldTarget => (event.currentTarget ?? event.target) as FieldTarget;\nconst place = (target: FieldTarget, caret: number) => { try { target.setSelectionRange?.(caret, caret); } catch { /* Detached or non-text input. */ } };\n\n/**\n * Caret semantics: the real input owns caret and selection; arrows, Home/End, Backspace/Delete and shift-selection are native.\n * The visual caret cell follows selectionStart (clamped to the last cell when full); a non-collapsed selection marks its cells.\n * A plain tap/click collapses the caret to the end of the value, because input text geometry does not line up with the cells.\n */\nexport function connectPasswordInput<T extends PropTypes>(service: QwPasswordInputService, normalize: NormalizeProps<T>): QwPasswordInputApi<T> {\n  const { context, prop, send, scope } = service;\n  const value = context.get(\"value\"), length = prop(\"length\") ?? PASSWORD_INPUT_DEFAULT_LENGTH, masked = !!prop(\"mask\"), focused = context.get(\"focused\");\n  const disabled = !!prop(\"disabled\"), readOnly = !!prop(\"readOnly\"), locked = disabled || readOnly, selection = context.get(\"selection\");\n  const label = prop(\"label\") || DEFAULT_LABEL[prop(\"mode\") ?? \"password\"], hint = prop(\"hint\") ?? \"\";\n  const id = scope.id ?? \"\";\n  const part = (name: PasswordInputPart) => ({ \"data-scope\": \"password-input\", \"data-part\": name });\n  const ranged = selection.end > selection.start, caretIndex = Math.min(selection.start, length - 1);\n  const cells = Array.from({ length }, (_, index): PasswordInputCell => {\n    const char = value[index] ?? \"\";\n    return { index, char, display: char ? (masked ? PASSWORD_INPUT_MASK_GLYPH : char) : \"\", filled: !!char, caret: focused && !disabled && !ranged && index === caretIndex, selected: focused && ranged && index >= selection.start && index < selection.end };\n  });\n  // Handlers write context synchronously (as Input does): adapter sends are deferred, but write-back must see the accepted value now.\n  const select = (start: number, end: number) => { const from = Math.max(0, start), current = context.get(\"selection\"), to = Math.max(from, end); if (current.start !== from || current.end !== to) context.set(\"selection\", { start: from, end: to }); };\n  const track = (event: FieldEvent) => { const target = field(event), start = target.selectionStart ?? target.value.length; select(start, target.selectionEnd ?? start); };\n  /** Propose, then write the effective value back so a rejected or filtered edit never lingers in the DOM. */\n  const commit = (target: FieldTarget, proposed: string, caret: number) => {\n    if (!locked) context.set(\"value\", proposed);\n    const accepted = context.get(\"value\");\n    if (target.value !== accepted) { target.value = accepted; place(target, Math.min(caret, accepted.length)); }\n    select(target.selectionStart ?? accepted.length, target.selectionEnd ?? accepted.length);\n    queueMicrotask(() => { if (target.isConnected !== false && target.value !== context.get(\"value\")) { target.value = context.get(\"value\"); place(target, context.get(\"value\").length); } });\n  };\n  return {\n    value, length, masked, focused, complete: value.length === length, disabled, readOnly, label, hint, cells,\n    setValue: (next) => send({ type: \"VALUE.SET\", value: next }),\n    clear: () => send({ type: \"VALUE.SET\", value: \"\" }),\n    getRootProps: () => normalize.element({ ...part(\"root\"), \"data-disabled\": dataAttr(disabled), \"data-readonly\": dataAttr(readOnly), \"data-focused\": dataAttr(focused), \"data-complete\": dataAttr(value.length === length), \"data-masked\": dataAttr(masked) }),\n    getInputProps: () => normalize.input({\n      ...part(\"input\"), id: inputId(id), type: masked ? \"password\" : \"text\", value, name: prop(\"name\"), form: prop(\"form\"),\n      disabled, readOnly, required: prop(\"required\"), maxLength: length, pattern: `${prop(\"charset\") === \"alphanumeric\" ? \"[0-9A-Za-z]\" : \"[0-9]\"}{${length}}`,\n      inputMode: prop(\"charset\") === \"numeric\" ? \"numeric\" : \"text\", autoComplete: prop(\"autoComplete\"), enterKeyHint: prop(\"enterKeyHint\"),\n      autoCapitalize: \"off\", autoCorrect: \"off\", spellCheck: \"false\", \"aria-label\": label, \"aria-describedby\": hintId(id),\n      onChange(event: FieldEvent) {\n        const target = field(event), caret = target.selectionStart ?? target.value.length;\n        if (locked) { commit(target, context.get(\"value\"), caret); return; }\n        commit(target, normalizeWith(prop, target.value), normalizeWith(prop, target.value.slice(0, caret)).length);\n      },\n      onPaste(event: PasteEvent) {\n        event.preventDefault();\n        if (locked) return;\n        const target = field(event), start = target.selectionStart ?? value.length;\n        const merged = mergePasswordInputPaste(context.get(\"value\"), event.clipboardData?.getData(\"text\") ?? \"\", { start, end: target.selectionEnd ?? start }, length, prop(\"charset\"));\n        commit(target, merged.value, merged.caret);\n      },\n      onClick(event: FieldEvent) {\n        const target = field(event);\n        if (target.selectionStart === target.selectionEnd) place(target, target.value.length);\n        track(event);\n      },\n      onKeyUp: track, onSelect: track,\n      onFocus(event: FieldEvent) { context.set(\"focused\", true); track(event); },\n      onBlur() { context.set(\"focused\", false); },\n    }),\n    getCellsProps: () => normalize.element({ ...part(\"cells\"), \"aria-hidden\": \"true\" }),\n    getCellProps: (cell) => normalize.element({ ...part(\"cell\"), \"data-index\": cell.index, \"data-filled\": dataAttr(cell.filled), \"data-caret\": dataAttr(cell.caret), \"data-selected\": dataAttr(cell.selected), \"data-disabled\": dataAttr(disabled) }),\n    getHintProps: () => normalize.element({ ...part(\"hint\"), id: hintId(id) }),\n  };\n}\n"],"mappings":"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"}

package/dist/password-input/password-input.d.ts

@@ -0,0 +1,144 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+/**
+ * PasswordInput 密码格 / 验证码：一个真实 `<input>` 承载焦点、选区、粘贴、读屏与表单，
+ * 格子只是 `aria-hidden` 的呈现层。
+ *
+ * Core 持有：长度/字符集归一化、受控提议与拒绝写回、粘贴合并、掩码、选区→高亮格、
+ * 一次填满一次 onComplete、表单 reset 恢复默认值。Core 从不提交表单、也不校验验证码。
+ */
+/** Stable DOM parts shared by every adapter. */
+export declare const PASSWORD_INPUT_PARTS: readonly ["root", "input", "cells", "cell", "hint"];
+export declare const PASSWORD_INPUT_DEFAULT_LENGTH = 6;
+/** Inclusive length bounds; out-of-range or non-integer lengths are clamped / rounded down. */
+export declare const PASSWORD_INPUT_MIN_LENGTH = 1;
+export declare const PASSWORD_INPUT_MAX_LENGTH = 12;
+/** Character kept by each charset. Full-width digits/letters are folded to ASCII first. */
+export declare const PASSWORD_INPUT_CHARSETS: readonly ["numeric", "alphanumeric"];
+export declare const PASSWORD_INPUT_MODES: readonly ["password", "otp"];
+/** Decorative glyph drawn in a filled cell while masked. */
+export declare const PASSWORD_INPUT_MASK_GLYPH = "\u2022";
+export type PasswordInputPart = (typeof PASSWORD_INPUT_PARTS)[number];
+export type PasswordInputCharset = (typeof PASSWORD_INPUT_CHARSETS)[number];
+export type PasswordInputMode = (typeof PASSWORD_INPUT_MODES)[number];
+export type PasswordInputAutoComplete = "off" | "one-time-code" | "current-password" | "new-password";
+export interface PasswordInputValueChangeDetails {
+    value: string;
+}
+export interface PasswordInputCompleteDetails {
+    value: string;
+}
+/** One presentational cell. `char` is the real character; adapters render `display`. */
+export interface PasswordInputCell {
+    index: number;
+    char: string;
+    display: string;
+    filled: boolean;
+    caret: boolean;
+    selected: boolean;
+}
+export interface QwPasswordInputProps {
+    /** Instance identity; adapters generate one when omitted. */
+    id?: string;
+    /** Number of cells; integer 1–12, default 6. */
+    length?: number;
+    /** Controlled value. Edits are proposed through onValueChange; the shown value only changes when the owner accepts. */
+    value?: string;
+    /** Uncontrolled initial value, also the value a form reset restores. Default "". */
+    defaultValue?: string;
+    /** Proposed value after an edit, paste or reset (already filtered and truncated). */
+    onValueChange?: (details: PasswordInputValueChangeDetails) => void;
+    /** The effective value just became full. Fires once per fill; never submits or verifies anything. */
+    onComplete?: (details: PasswordInputCompleteDetails) => void;
+    /** Allowed characters: numeric (default) keeps 0–9, alphanumeric keeps A–Z/a–z/0–9. */
+    charset?: PasswordInputCharset;
+    /** password (default) masks by default and turns autofill off; otp shows plain text and asks for one-time-code autofill. */
+    mode?: PasswordInputMode;
+    /** Draw dots instead of characters; the real input becomes type="password". Default: true for password, false for otp. */
+    mask?: boolean;
+    /** Overrides the autocomplete token chosen by mode. */
+    autoComplete?: PasswordInputAutoComplete;
+    /** Accessible name of the real input; defaults to 密码 / 验证码 by mode. */
+    label?: string;
+    /** Spoken length description; defaults to "6 位数字" / "6 位字母或数字". */
+    hint?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    /** Form field name; the real input submits the value under it. */
+    name?: string;
+    /** Owner form id, as the native form attribute. */
+    form?: string;
+    enterKeyHint?: "done" | "go" | "next" | "send" | "enter";
+}
+/** Clamp to an integer in 1–12; anything unusable falls back to 6. */
+export declare function normalizePasswordInputLength(length?: number): number;
+/** Fold full-width ASCII (IME digits like "１２３") to half-width, drop disallowed characters, then truncate. Never throws. */
+export declare function normalizePasswordInputValue(value: unknown, length?: number, charset?: PasswordInputCharset): string;
+/**
+ * Merge pasted text into the current value. A paste that alone fills every cell (after filtering)
+ * replaces the whole value — the usual "paste the code from SMS" case; otherwise it replaces the selection.
+ * Returns the next value and the caret after the inserted text.
+ */
+export declare function mergePasswordInputPaste(current: string, pasted: string, selection: {
+    start: number;
+    end: number;
+}, length?: number, charset?: PasswordInputCharset): {
+    value: string;
+    caret: number;
+};
+export declare function createPasswordInputProps(props?: QwPasswordInputProps): QwPasswordInputProps;
+interface Selection {
+    start: number;
+    end: number;
+}
+export interface QwPasswordInputSchema {
+    props: QwPasswordInputProps;
+    context: {
+        value: string;
+        selection: Selection;
+        focused: boolean;
+    };
+    refs: {
+        completed: boolean;
+    };
+    state: "idle";
+    action: "setValue" | "notifyComplete";
+    effect: "trackForm";
+    /** Programmatic proposal (api.setValue / clear). DOM handlers write context synchronously instead. */
+    event: {
+        type: "VALUE.SET";
+        value: string;
+    };
+}
+export type QwPasswordInputMachine = Machine<QwPasswordInputSchema>;
+export type QwPasswordInputService = Service<QwPasswordInputSchema>;
+export declare const passwordInputMachine: QwPasswordInputMachine;
+export interface QwPasswordInputApi<T extends PropTypes = PropTypes> {
+    value: string;
+    length: number;
+    masked: boolean;
+    focused: boolean;
+    complete: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+    label: string;
+    hint: string;
+    cells: PasswordInputCell[];
+    /** Propose a value programmatically (normalized; ignored when disabled or readOnly). */
+    setValue(value: string): void;
+    /** Propose "" (ignored when disabled or readOnly). */
+    clear(): void;
+    getRootProps(): T["element"];
+    getInputProps(): T["input"];
+    getCellsProps(): T["element"];
+    getCellProps(cell: PasswordInputCell): T["element"];
+    getHintProps(): T["element"];
+}
+/**
+ * Caret semantics: the real input owns caret and selection; arrows, Home/End, Backspace/Delete and shift-selection are native.
+ * The visual caret cell follows selectionStart (clamped to the last cell when full); a non-collapsed selection marks its cells.
+ * A plain tap/click collapses the caret to the end of the value, because input text geometry does not line up with the cells.
+ */
+export declare function connectPasswordInput<T extends PropTypes>(service: QwPasswordInputService, normalize: NormalizeProps<T>): QwPasswordInputApi<T>;
+export {};

package/dist/picker/index.d.ts

@@ -0,0 +1,8 @@
+export { pickerMachine } from "./picker-machine.js";
+export type { QwPickerSchema, QwPickerService, QwPickerMachine } from "./picker-machine.js";
+export { createPickerProps, connectPicker, getPickerAccessibleName, getPickerDataAttrs, isPickerColumns, isPickerValue, resolvePickerColumns, resolvePickerMode, } from "./picker.js";
+export type { QwPickerProps, QwPickerApi, QwPickerMachineProps, QwResolvedPickerColumn, QwResolvedPickerOption } from "./picker.js";
+export { PickerSelectionModel, getPickerDiagnostics, getPickerFirstValue, getPickerKeyboardTarget, getPickerOptionIndex, isPickerOptionSelectable, } from "./selection-model.js";
+export type { PickerChangeDetails, PickerColumn, PickerColumnSignal, PickerColumnToken, PickerDiagnostic, PickerGeometry, PickerKeyboardMove, PickerMode, PickerOption, PickerScrollCommand, PickerSelectionNotice, PickerSelectionProps, PickerSelectionSnapshot, PickerValue, } from "./selection-model.js";
+export { attachPickerColumn, connectPickerColumn } from "./platform.js";
+export type { PickerBridgeCommand, PickerBridgeNotice, PickerColumnBinding, PickerColumnController, PickerColumnHost, PickerColumnSurface, PickerRawEventFacts, } from "./platform.js";

package/dist/picker/index.js

@@ -0,0 +1,2 @@
+import { _ as isPickerOptionSelectable, a as getPickerAccessibleName, c as isPickerValue, d as pickerMachine, f as PickerSelectionModel, g as getPickerOptionIndex, h as getPickerKeyboardTarget, i as createPickerProps, l as resolvePickerColumns, m as getPickerFirstValue, n as connectPickerColumn, o as getPickerDataAttrs, p as getPickerDiagnostics, r as connectPicker, s as isPickerColumns, t as attachPickerColumn, u as resolvePickerMode } from "../picker-BykFntQN.js";
+export { PickerSelectionModel, attachPickerColumn, connectPicker, connectPickerColumn, createPickerProps, getPickerAccessibleName, getPickerDataAttrs, getPickerDiagnostics, getPickerFirstValue, getPickerKeyboardTarget, getPickerOptionIndex, isPickerColumns, isPickerOptionSelectable, isPickerValue, pickerMachine, resolvePickerColumns, resolvePickerMode };

package/dist/picker/picker-machine.d.ts

@@ -0,0 +1,80 @@
+import type { Machine, Service } from "@zag-js/core";
+import { popupMachine } from "../popup/popup.js";
+import { PickerSelectionModel, type PickerColumnSignal, type PickerColumnToken, type PickerKeyboardMove, type PickerMode, type PickerSelectionNotice, type PickerSelectionProps, type PickerSelectionSnapshot, type PickerValue } from "./selection-model.js";
+/**
+ * Picker 的单一 Foundation service（T002）。
+ *
+ * 不是第二个 machine：它是锁定的上游 `popupMachine` 的显式 typed 投影 —— props / context / states /
+ * transitions / actions / effects 全部来自同一个 Popup machine，只追加选择会话的 context、refs 与事件。
+ * 工具栏（popup）形态的开合、焦点、滚动锁、portal id 与模态票据都由这一个 service 承担；
+ * 内嵌（inline）形态把所有上游打开路径守卫为 closed：没有锁、没有 portal、没有模态登记。
+ *
+ * 迁移自 specs/054-mobile-picker/spike/machine-foundation.ts（T002 + T035–T039 证据），
+ * 仅删去 spike 的 PREVIEW.SET 探针并增加离散选择/键盘/列焦点事件。
+ */
+type PopupSchema = typeof popupMachine extends Machine<infer Schema> ? Schema : never;
+export interface QwPickerSchema extends Omit<PopupSchema, "action" | "event" | "effect"> {
+    props: PopupSchema["props"] & {
+        mode: PickerMode;
+        selection?: PickerSelectionProps;
+        onSelectionNotice?: (event: PickerSelectionNotice) => void;
+    };
+    context: {
+        rendered: PopupSchema["context"]["rendered"];
+        triggerValue: PopupSchema["context"]["triggerValue"];
+        preview: PickerValue;
+        selectionSnapshot: PickerSelectionSnapshot | null;
+        surfaceTokens: readonly (PickerColumnToken | undefined)[];
+    };
+    refs: {
+        /** 构造时固定的形态；切换形态须重新挂载。 */
+        mode: PickerMode;
+        selectionModel: PickerSelectionModel;
+        selectionTransport: {
+            notice?: (event: PickerSelectionNotice) => void;
+            closeIntent: boolean;
+            session: number;
+        };
+    };
+    action: PopupSchema["action"] | "selectionInput";
+    effect: PopupSchema["effect"] | "selectionLifetime";
+    event: PopupSchema["event"] | {
+        type: "SELECTION.MOUNT";
+        columnIndex: number;
+    } | {
+        type: "SELECTION.UNMOUNT";
+        token: PickerColumnToken;
+    } | {
+        type: "SELECTION.INPUT";
+        token: PickerColumnToken;
+        signal: PickerColumnSignal;
+    } | {
+        type: "SELECTION.SELECT";
+        columnIndex: number;
+        optionIndex: number;
+    } | {
+        type: "SELECTION.MOVE";
+        columnIndex: number;
+        move: PickerKeyboardMove;
+    } | {
+        type: "SELECTION.FOCUS";
+        columnIndex: number;
+    } | {
+        type: "SELECTION.CONFIRM";
+    } | {
+        type: "SELECTION.CANCEL";
+    } | {
+        type: "SELECTION.CLOSE";
+        session: number;
+    };
+}
+export type QwPickerService = Service<QwPickerSchema>;
+export type QwPickerMachine = Machine<QwPickerSchema>;
+/** Typed pinned upstream projection: one service, the original two modal states. */
+export declare const pickerMachine: QwPickerMachine;
+/** Project the one service for the upstream Popup connector; never instantiate another. */
+export declare function toPopupService(service: Service<QwPickerSchema>): Service<PopupSchema>;
+type SelectionEvent = QwPickerSchema["event"];
+/** Keep input ordering when the machine scheduler has not consumed an earlier selection yet. */
+export declare function sendPickerSelection(service: QwPickerService, event: SelectionEvent): void;
+export {};