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

package/dist/notify/notify.d.ts

@@ -0,0 +1,123 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+import { type IconState } from "../icon/index.js";
+/** Stable DOM parts shared by every adapter. */
+export declare const NOTIFY_PARTS: readonly ["root", "message", "action", "close"];
+/** Four semantic types; primary doubles as the neutral/info tone. */
+export declare const NOTIFY_TYPES: readonly ["primary", "success", "warning", "danger"];
+export type NotifyType = (typeof NOTIFY_TYPES)[number];
+export declare const NOTIFY_DEFAULT_DURATION = 3000;
+/** Why the open state changed: timer expiry, close button / Escape, action activation, or an imperative show/close. */
+export type NotifyOpenChangeReason = "timeout" | "close" | "action" | "api";
+export interface NotifyOpenChangeDetails {
+    open: boolean;
+    reason: NotifyOpenChangeReason;
+}
+export interface QwNotifyProps {
+    /** Page-unique instance identity; adapters generate one when omitted. */
+    id?: string;
+    /** Controlled visibility; undefined lets Core own it (seeded by defaultOpen). */
+    open?: boolean;
+    defaultOpen?: boolean;
+    /** Called for every open request; controlled owners accept by updating `open`. */
+    onOpenChange?: (details: NotifyOpenChangeDetails) => void;
+    /** Semantic type; default primary. danger is announced assertively (role=alert). */
+    type?: NotifyType;
+    /** Notification text. Changing it while open replaces the content and restarts the timer. */
+    message?: string;
+    /** Optional action button text; omitted hides the action. */
+    actionText?: string;
+    /** The action button was activated (before the optional close). */
+    onAction?: () => void;
+    /** Close after the action; default true. */
+    closeOnAction?: boolean;
+    /** Show the close button (and allow Escape); default true. */
+    closable?: boolean;
+    /** Accessible name of the close button; default 关闭通知. */
+    closeLabel?: string;
+    /** Auto-dismiss delay in ms; 0 keeps it open; invalid uses 3000. Paused on hover and while focus is inside. */
+    duration?: number;
+}
+export interface ResolvedNotifyState {
+    type: NotifyType;
+    message: string;
+    actionText: string;
+    closeOnAction: boolean;
+    closable: boolean;
+    closeLabel: string;
+    duration: number;
+}
+export declare function resolveNotifyState(props?: QwNotifyProps): ResolvedNotifyState;
+export declare function createNotifyProps(props?: QwNotifyProps): QwNotifyProps;
+/** Minimal event surface shared by React, Vue and native events. */
+export interface NotifyDomEvent {
+    readonly defaultPrevented: boolean;
+    readonly type?: string;
+    readonly key?: string;
+    readonly pointerType?: string;
+    readonly currentTarget?: unknown;
+    readonly relatedTarget?: unknown;
+    preventDefault?(): void;
+}
+export type NotifyEventHandler = (event: NotifyDomEvent) => void;
+type RootHandler = "onPointerEnter" | "onPointerLeave" | "onFocus" | "onBlur" | "onKeyDown";
+/** Caller handlers for the root run first; Core's own handler is skipped when the caller calls preventDefault(). */
+export interface NotifyConnectOptions {
+    root?: Partial<Record<RootHandler, NotifyEventHandler | readonly NotifyEventHandler[] | undefined>>;
+}
+export interface QwNotifySchema {
+    props: QwNotifyProps;
+    context: {
+        open: boolean;
+    };
+    refs: {
+        timer: ReturnType<typeof setTimeout> | undefined;
+        remaining: number;
+        startedAt: number;
+        hovered: boolean;
+        focused: boolean;
+    };
+    state: "ready";
+    action: "show" | "close" | "action" | "restart" | "pause" | "expire";
+    effect: "lifecycle";
+    event: {
+        type: "SHOW";
+    } | {
+        type: "CLOSE";
+        reason: NotifyOpenChangeReason;
+    } | {
+        type: "ACTION";
+    } | {
+        type: "RESTART";
+    } | {
+        type: "TIMEOUT";
+    } | {
+        type: "HOVER";
+        value: boolean;
+    } | {
+        type: "FOCUS";
+        value: boolean;
+    };
+}
+export type QwNotifyMachine = Machine<QwNotifySchema>;
+export type QwNotifyService = Service<QwNotifySchema>;
+/** Core owns visibility requests, the auto-dismiss timer, hover/focus pause, content-replacement restarts and cleanup. */
+export declare const notifyMachine: QwNotifyMachine;
+export interface QwNotifyApi<T extends PropTypes = PropTypes> {
+    open: boolean;
+    type: NotifyType;
+    message: string;
+    actionText: string;
+    closable: boolean;
+    closeLabel: string;
+    show(): void;
+    close(): void;
+    getRootProps(): T["element"];
+    getMessageProps(): T["element"];
+    getActionProps(): T["button"];
+    getCloseProps(): T["button"];
+    /** Decorative close glyph rendered inside the close button. */
+    getCloseIconState(): IconState;
+}
+export declare function connectNotify<T extends PropTypes>(service: QwNotifyService, normalize: NormalizeProps<T>, options?: NotifyConnectOptions): QwNotifyApi<T>;
+export {};

package/dist/number-keyboard/index.d.ts

@@ -0,0 +1 @@
+export * from "./number-keyboard.js";

package/dist/number-keyboard/index.js

@@ -0,0 +1,333 @@
+import { createMachine } from "@zag-js/core";
+import { dataAttr } from "@zag-js/dom-query";
+//#region src/number-keyboard/number-keyboard.ts
+/**
+* NumberKeyboard 数字键盘：内联输入事件源。
+*
+* Core 只报告按了什么（输入 / 删除 / 完成），从不持有或修改调用方的值。
+* 长按删除、禁用、物理按键映射都在这里；适配层只运输事件并重绘。
+*/
+/** Stable DOM parts shared by every adapter. */
+const NUMBER_KEYBOARD_PARTS = [
+	"root",
+	"keys",
+	"key",
+	"sidebar",
+	"delete-key",
+	"delete-icon",
+	"done-key"
+];
+/** Digit keys in render order: 1–9 fill three rows, 0 sits in the bottom row. */
+const NUMBER_KEYBOARD_DIGITS = [
+	"1",
+	"2",
+	"3",
+	"4",
+	"5",
+	"6",
+	"7",
+	"8",
+	"9",
+	"0"
+];
+/** At most two extra keys share the bottom row with 0. */
+const NUMBER_KEYBOARD_MAX_EXTRA_KEYS = 2;
+/** Hold time (ms) before a pressed delete key starts repeating. */
+const NUMBER_KEYBOARD_LONG_PRESS_DELAY = 500;
+/** Interval (ms) between repeated deletes while the pointer stays down. */
+const NUMBER_KEYBOARD_REPEAT_INTERVAL = 100;
+/** Decorative delete glyph. Adapters render it `aria-hidden`; the name comes from `deleteLabel`. */
+const NUMBER_KEYBOARD_DELETE_GLYPH = "⌫";
+const DEFAULT_LABEL = "数字键盘";
+const DEFAULT_DELETE_LABEL = "删除";
+const DEFAULT_DONE_TEXT = "完成";
+const DIGITS = NUMBER_KEYBOARD_DIGITS;
+const text = (value) => typeof value === "string" ? value.trim() : "";
+/** Trim extra keys; drop empty, digit and duplicate keys; keep at most two. Never throws. */
+function normalizeNumberKeyboardExtraKeys(extraKeys) {
+	const result = [];
+	for (const item of Array.isArray(extraKeys) ? extraKeys : []) {
+		const key = text(typeof item === "string" ? item : item?.key), label = item && typeof item === "object" ? text(item.label) : "";
+		if (!key || DIGITS.includes(key) || result.some((entry) => entry.key === key)) continue;
+		result.push(label ? {
+			key,
+			label
+		} : { key });
+		if (result.length === 2) break;
+	}
+	return result;
+}
+/**
+* Ordered input keys. Bottom row: no extra → 0 spans three columns; one extra → 0 spans two, then the extra;
+* two extras → extra₁, 0, extra₂. Delete and done live in the separate side column.
+*/
+function getNumberKeyboardKeys(extraKeys) {
+	const extras = normalizeNumberKeyboardExtraKeys(extraKeys).map((entry) => ({
+		...entry,
+		kind: "extra",
+		span: 1
+	}));
+	const keys = DIGITS.slice(0, 9).map((key) => ({
+		key,
+		kind: "digit",
+		span: 1
+	}));
+	const zero = {
+		key: "0",
+		kind: "digit",
+		span: extras.length === 2 ? 1 : extras.length === 1 ? 2 : 3
+	};
+	return extras.length === 2 ? [
+		...keys,
+		extras[0],
+		zero,
+		extras[1]
+	] : [
+		...keys,
+		zero,
+		...extras
+	];
+}
+/** Resolve a pressed or typed key against the current key set. Single letters match case-insensitively. */
+function resolveNumberKeyboardKey(extraKeys, key) {
+	if (typeof key !== "string" || !key) return void 0;
+	const keys = getNumberKeyboardKeys(extraKeys);
+	return keys.find((item) => item.key === key) ?? (key.length === 1 ? keys.find((item) => item.key.toLowerCase() === key.toLowerCase()) : void 0);
+}
+function createNumberKeyboardProps(props = {}) {
+	return {
+		...props,
+		label: text(props.label) || DEFAULT_LABEL,
+		deleteLabel: text(props.deleteLabel) || DEFAULT_DELETE_LABEL,
+		doneText: text(props.doneText) || DEFAULT_DONE_TEXT,
+		disabled: !!props.disabled,
+		dir: props.dir === "rtl" || props.dir === "ltr" ? props.dir : void 0
+	};
+}
+/**
+* Tap = click: one notification for mouse, touch, keyboard and assistive tech alike.
+* Hold (delete only): after the delay Core repeats `onDelete({ repeat: true })` until the same pointer
+* goes up / cancels / leaves, the keyboard is disabled, or the machine stops. Timers live in state effects,
+* so leaving the state or stopping the machine always clears them. The pointer click that ends a repeat
+* session is swallowed so a long press never adds one extra delete.
+*/
+const numberKeyboardMachine = createMachine({
+	props: ({ props }) => createNumberKeyboardProps(props),
+	initialState: () => "idle",
+	refs: () => ({
+		pointerId: null,
+		swallowClick: false
+	}),
+	watch({ track, prop, send }) {
+		track([() => !!prop("disabled")], () => {
+			if (prop("disabled")) send({ type: "PRESS.ABORT" });
+		});
+	},
+	on: {
+		"KEY.INPUT": { actions: ["input"] },
+		"KEY.DELETE": { actions: ["remove"] },
+		"KEY.DONE": { actions: ["done"] }
+	},
+	states: {
+		idle: { on: { "PRESS.START": {
+			guard: "isEnabled",
+			target: "holding",
+			actions: ["beginPress"]
+		} } },
+		holding: {
+			effects: ["waitForHold"],
+			on: {
+				"PRESS.END": {
+					guard: "isPressPointer",
+					target: "idle",
+					actions: ["endPress"]
+				},
+				"PRESS.ABORT": {
+					target: "idle",
+					actions: ["endPress"]
+				},
+				"HOLD.ELAPSED": [{
+					guard: "isEnabled",
+					target: "repeating",
+					actions: ["repeatRemove"]
+				}, {
+					target: "idle",
+					actions: ["endPress"]
+				}]
+			}
+		},
+		repeating: {
+			effects: ["repeatWhileHeld"],
+			on: {
+				"PRESS.END": {
+					guard: "isPressPointer",
+					target: "idle",
+					actions: ["endPress"]
+				},
+				"PRESS.ABORT": {
+					target: "idle",
+					actions: ["endPress"]
+				},
+				"REPEAT.TICK": [{
+					guard: "isEnabled",
+					actions: ["repeatRemove"]
+				}, {
+					target: "idle",
+					actions: ["endPress"]
+				}]
+			}
+		}
+	},
+	implementations: {
+		guards: {
+			isEnabled: ({ prop }) => !prop("disabled"),
+			isPressPointer: ({ event, refs }) => event.type === "PRESS.END" && event.pointerId === refs.get("pointerId")
+		},
+		actions: {
+			input({ event, prop }) {
+				if (event.type !== "KEY.INPUT" || prop("disabled")) return;
+				const key = resolveNumberKeyboardKey(prop("extraKeys"), event.key);
+				if (key) prop("onInput")?.({ key: key.key });
+			},
+			remove({ event, prop, refs }) {
+				if (event.type !== "KEY.DELETE" || prop("disabled")) return;
+				const swallow = !!event.pointer && refs.get("swallowClick");
+				refs.set("swallowClick", false);
+				if (!swallow) prop("onDelete")?.({ repeat: !!event.repeat });
+			},
+			done({ prop }) {
+				if (!prop("disabled")) prop("onDone")?.();
+			},
+			beginPress({ event, refs }) {
+				if (event.type === "PRESS.START") {
+					refs.set("pointerId", event.pointerId);
+					refs.set("swallowClick", false);
+				}
+			},
+			endPress({ refs }) {
+				refs.set("pointerId", null);
+			},
+			repeatRemove({ prop, refs }) {
+				refs.set("swallowClick", true);
+				prop("onDelete")?.({ repeat: true });
+			}
+		},
+		effects: {
+			waitForHold({ send }) {
+				const timer = setTimeout(() => send({ type: "HOLD.ELAPSED" }), 500);
+				return () => clearTimeout(timer);
+			},
+			repeatWhileHeld({ send }) {
+				const timer = setInterval(() => send({ type: "REPEAT.TICK" }), 100);
+				return () => clearInterval(timer);
+			}
+		}
+	}
+});
+function connectNumberKeyboard(service, normalize) {
+	const { prop, send } = service;
+	const disabled = !!prop("disabled"), keys = getNumberKeyboardKeys(prop("extraKeys")), repeating = service.state.matches("repeating");
+	const label = prop("label") || DEFAULT_LABEL, deleteLabel = prop("deleteLabel") || DEFAULT_DELETE_LABEL, doneText = prop("doneText") || DEFAULT_DONE_TEXT;
+	const part = (name) => ({
+		"data-scope": "number-keyboard",
+		"data-part": name
+	});
+	const end = (event) => send({
+		type: "PRESS.END",
+		pointerId: event.pointerId
+	});
+	return {
+		keys,
+		disabled,
+		repeating,
+		label,
+		deleteLabel,
+		doneText,
+		input: (key) => send({
+			type: "KEY.INPUT",
+			key
+		}),
+		remove: () => send({ type: "KEY.DELETE" }),
+		done: () => send({ type: "KEY.DONE" }),
+		getRootProps: () => normalize.element({
+			...part("root"),
+			role: "group",
+			"aria-label": label,
+			dir: prop("dir"),
+			"data-disabled": dataAttr(disabled),
+			onKeyDown(event) {
+				if (event.defaultPrevented || disabled || event.ctrlKey || event.metaKey || event.altKey || event.isComposing) return;
+				if (event.key === "Backspace") {
+					event.preventDefault();
+					send({
+						type: "KEY.DELETE",
+						repeat: !!event.repeat
+					});
+					return;
+				}
+				const key = typeof event.key === "string" && event.key.length === 1 ? resolveNumberKeyboardKey(prop("extraKeys"), event.key) : void 0;
+				if (key) {
+					event.preventDefault();
+					send({
+						type: "KEY.INPUT",
+						key: key.key
+					});
+				}
+			}
+		}),
+		getKeysProps: () => normalize.element(part("keys")),
+		getKeyProps: (key) => normalize.button({
+			...part("key"),
+			type: "button",
+			"data-value": key.key,
+			"data-kind": key.kind,
+			"data-span": key.span > 1 ? String(key.span) : void 0,
+			"aria-label": key.label,
+			disabled,
+			onClick: () => send({
+				type: "KEY.INPUT",
+				key: key.key
+			})
+		}),
+		getSidebarProps: () => normalize.element(part("sidebar")),
+		getDeleteKeyProps: () => normalize.button({
+			...part("delete-key"),
+			type: "button",
+			"aria-label": deleteLabel,
+			disabled,
+			"data-repeating": dataAttr(repeating),
+			onClick(event) {
+				send({
+					type: "KEY.DELETE",
+					pointer: (event.detail ?? 0) > 0
+				});
+			},
+			onPointerDown(event) {
+				if (event.isPrimary !== false && !((event.button ?? 0) > 0)) send({
+					type: "PRESS.START",
+					pointerId: event.pointerId
+				});
+			},
+			onPointerUp: end,
+			onPointerCancel: end,
+			onPointerLeave: end,
+			onContextMenu(event) {
+				event.preventDefault();
+			}
+		}),
+		getDeleteIconProps: () => normalize.element({
+			...part("delete-icon"),
+			"aria-hidden": true
+		}),
+		getDoneKeyProps: () => normalize.button({
+			...part("done-key"),
+			type: "button",
+			disabled,
+			onClick: () => send({ type: "KEY.DONE" })
+		})
+	};
+}
+//#endregion
+export { NUMBER_KEYBOARD_DELETE_GLYPH, NUMBER_KEYBOARD_DIGITS, NUMBER_KEYBOARD_LONG_PRESS_DELAY, NUMBER_KEYBOARD_MAX_EXTRA_KEYS, NUMBER_KEYBOARD_PARTS, NUMBER_KEYBOARD_REPEAT_INTERVAL, connectNumberKeyboard, createNumberKeyboardProps, getNumberKeyboardKeys, normalizeNumberKeyboardExtraKeys, numberKeyboardMachine, resolveNumberKeyboardKey };
+
+//# sourceMappingURL=index.js.map

package/dist/number-keyboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/number-keyboard/number-keyboard.ts"],"sourcesContent":["import { createMachine, type Machine, type Service } from \"@zag-js/core\";\nimport { dataAttr } from \"@zag-js/dom-query\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\n\n/**\n * NumberKeyboard 数字键盘：内联输入事件源。\n *\n * Core 只报告按了什么（输入 / 删除 / 完成），从不持有或修改调用方的值。\n * 长按删除、禁用、物理按键映射都在这里；适配层只运输事件并重绘。\n */\n\n/** Stable DOM parts shared by every adapter. */\nexport const NUMBER_KEYBOARD_PARTS = [\"root\", \"keys\", \"key\", \"sidebar\", \"delete-key\", \"delete-icon\", \"done-key\"] as const;\n/** Digit keys in render order: 1–9 fill three rows, 0 sits in the bottom row. */\nexport const NUMBER_KEYBOARD_DIGITS = [\"1\", \"2\", \"3\", \"4\", \"5\", \"6\", \"7\", \"8\", \"9\", \"0\"] as const;\n/** At most two extra keys share the bottom row with 0. */\nexport const NUMBER_KEYBOARD_MAX_EXTRA_KEYS = 2;\n/** Hold time (ms) before a pressed delete key starts repeating. */\nexport const NUMBER_KEYBOARD_LONG_PRESS_DELAY = 500;\n/** Interval (ms) between repeated deletes while the pointer stays down. */\nexport const NUMBER_KEYBOARD_REPEAT_INTERVAL = 100;\n/** Decorative delete glyph. Adapters render it `aria-hidden`; the name comes from `deleteLabel`. */\nexport const NUMBER_KEYBOARD_DELETE_GLYPH = \"⌫\";\n\nexport type NumberKeyboardPart = (typeof NUMBER_KEYBOARD_PARTS)[number];\n/** An extra key: a bare string such as \".\" / \"X\", or a key with an accessible label. */\nexport type NumberKeyboardExtraKey = string | { key: string; label?: string };\n/** One rendered input key. `span` is the number of grid columns it occupies. */\nexport interface NumberKeyboardKey { key: string; kind: \"digit\" | \"extra\"; label?: string; span: 1 | 2 | 3 }\nexport interface NumberKeyboardInputDetails { key: string }\n/** `repeat` is true for deletes produced by a held delete key or a held physical Backspace. */\nexport interface NumberKeyboardDeleteDetails { repeat: boolean }\n\nexport interface QwNumberKeyboardProps {\n  /** Instance identity; adapters generate one when omitted. */\n  id?: string;\n  /** Accessible name of the keyboard group; defaults to 数字键盘. */\n  label?: string;\n  /** Up to two extra keys next to 0, e.g. [\".\"] for amounts or [\"X\"] for ID cards. Empty, digit and duplicate keys are dropped. */\n  extraKeys?: readonly NumberKeyboardExtraKey[];\n  /** Disables every key; nothing is reported and an active long press stops. */\n  disabled?: boolean;\n  /** Layout direction; rtl moves the delete/done column to the inline end and mirrors the delete glyph. Digits keep keypad order. */\n  dir?: \"ltr\" | \"rtl\";\n  /** Accessible name of the delete key; defaults to 删除. */\n  deleteLabel?: string;\n  /** Visible text of the done key; defaults to 完成. */\n  doneText?: string;\n  /** A digit or extra key was pressed. The caller decides how its own value changes. */\n  onInput?: (details: NumberKeyboardInputDetails) => void;\n  /** The delete key was pressed, or repeated while held. */\n  onDelete?: (details: NumberKeyboardDeleteDetails) => void;\n  /** The done key was pressed. */\n  onDone?: () => void;\n}\n\nconst DEFAULT_LABEL = \"数字键盘\", DEFAULT_DELETE_LABEL = \"删除\", DEFAULT_DONE_TEXT = \"完成\";\nconst DIGITS: readonly string[] = NUMBER_KEYBOARD_DIGITS;\nconst text = (value: unknown): string => (typeof value === \"string\" ? value.trim() : \"\");\n\n/** Trim extra keys; drop empty, digit and duplicate keys; keep at most two. Never throws. */\nexport function normalizeNumberKeyboardExtraKeys(extraKeys?: readonly NumberKeyboardExtraKey[]): { key: string; label?: string }[] {\n  const result: { key: string; label?: string }[] = [];\n  for (const item of Array.isArray(extraKeys) ? extraKeys : []) {\n    const key = text(typeof item === \"string\" ? item : item?.key), label = item && typeof item === \"object\" ? text(item.label) : \"\";\n    if (!key || DIGITS.includes(key) || result.some((entry) => entry.key === key)) continue;\n    result.push(label ? { key, label } : { key });\n    if (result.length === NUMBER_KEYBOARD_MAX_EXTRA_KEYS) break;\n  }\n  return result;\n}\n\n/**\n * Ordered input keys. Bottom row: no extra → 0 spans three columns; one extra → 0 spans two, then the extra;\n * two extras → extra₁, 0, extra₂. Delete and done live in the separate side column.\n */\nexport function getNumberKeyboardKeys(extraKeys?: readonly NumberKeyboardExtraKey[]): NumberKeyboardKey[] {\n  const extras = normalizeNumberKeyboardExtraKeys(extraKeys).map((entry): NumberKeyboardKey => ({ ...entry, kind: \"extra\", span: 1 }));\n  const keys = DIGITS.slice(0, 9).map((key): NumberKeyboardKey => ({ key, kind: \"digit\", span: 1 }));\n  const zero: NumberKeyboardKey = { key: \"0\", kind: \"digit\", span: extras.length === 2 ? 1 : extras.length === 1 ? 2 : 3 };\n  return extras.length === 2 ? [...keys, extras[0]!, zero, extras[1]!] : [...keys, zero, ...extras];\n}\n\n/** Resolve a pressed or typed key against the current key set. Single letters match case-insensitively. */\nexport function resolveNumberKeyboardKey(extraKeys: readonly NumberKeyboardExtraKey[] | undefined, key: string): NumberKeyboardKey | undefined {\n  if (typeof key !== \"string\" || !key) return undefined;\n  const keys = getNumberKeyboardKeys(extraKeys);\n  return keys.find((item) => item.key === key) ?? (key.length === 1 ? keys.find((item) => item.key.toLowerCase() === key.toLowerCase()) : undefined);\n}\n\nexport function createNumberKeyboardProps(props: QwNumberKeyboardProps = {}): QwNumberKeyboardProps {\n  return {\n    ...props,\n    label: text(props.label) || DEFAULT_LABEL,\n    deleteLabel: text(props.deleteLabel) || DEFAULT_DELETE_LABEL,\n    doneText: text(props.doneText) || DEFAULT_DONE_TEXT,\n    disabled: !!props.disabled,\n    dir: props.dir === \"rtl\" || props.dir === \"ltr\" ? props.dir : undefined,\n  };\n}\n\nexport interface QwNumberKeyboardSchema {\n  props: QwNumberKeyboardProps;\n  refs: { pointerId: number | null; swallowClick: boolean };\n  state: \"idle\" | \"holding\" | \"repeating\";\n  guard: \"isEnabled\" | \"isPressPointer\";\n  action: \"input\" | \"remove\" | \"done\" | \"beginPress\" | \"endPress\" | \"repeatRemove\";\n  effect: \"waitForHold\" | \"repeatWhileHeld\";\n  event:\n    | { type: \"KEY.INPUT\"; key: string }\n    | { type: \"KEY.DELETE\"; pointer?: boolean; repeat?: boolean }\n    | { type: \"KEY.DONE\" }\n    | { type: \"PRESS.START\"; pointerId: number }\n    | { type: \"PRESS.END\"; pointerId: number }\n    | { type: \"PRESS.ABORT\" }\n    | { type: \"HOLD.ELAPSED\" }\n    | { type: \"REPEAT.TICK\" };\n}\nexport type QwNumberKeyboardMachine = Machine<QwNumberKeyboardSchema>;\nexport type QwNumberKeyboardService = Service<QwNumberKeyboardSchema>;\n\n/**\n * Tap = click: one notification for mouse, touch, keyboard and assistive tech alike.\n * Hold (delete only): after the delay Core repeats `onDelete({ repeat: true })` until the same pointer\n * goes up / cancels / leaves, the keyboard is disabled, or the machine stops. Timers live in state effects,\n * so leaving the state or stopping the machine always clears them. The pointer click that ends a repeat\n * session is swallowed so a long press never adds one extra delete.\n */\nexport const numberKeyboardMachine: QwNumberKeyboardMachine = createMachine<QwNumberKeyboardSchema>({\n  props: ({ props }) => createNumberKeyboardProps(props),\n  initialState: () => \"idle\",\n  refs: () => ({ pointerId: null, swallowClick: false }),\n  watch({ track, prop, send }) { track([() => !!prop(\"disabled\")], () => { if (prop(\"disabled\")) send({ type: \"PRESS.ABORT\" }); }); },\n  on: { \"KEY.INPUT\": { actions: [\"input\"] }, \"KEY.DELETE\": { actions: [\"remove\"] }, \"KEY.DONE\": { actions: [\"done\"] } },\n  states: {\n    idle: { on: { \"PRESS.START\": { guard: \"isEnabled\", target: \"holding\", actions: [\"beginPress\"] } } },\n    holding: {\n      effects: [\"waitForHold\"],\n      on: {\n        \"PRESS.END\": { guard: \"isPressPointer\", target: \"idle\", actions: [\"endPress\"] },\n        \"PRESS.ABORT\": { target: \"idle\", actions: [\"endPress\"] },\n        \"HOLD.ELAPSED\": [{ guard: \"isEnabled\", target: \"repeating\", actions: [\"repeatRemove\"] }, { target: \"idle\", actions: [\"endPress\"] }],\n      },\n    },\n    repeating: {\n      effects: [\"repeatWhileHeld\"],\n      on: {\n        \"PRESS.END\": { guard: \"isPressPointer\", target: \"idle\", actions: [\"endPress\"] },\n        \"PRESS.ABORT\": { target: \"idle\", actions: [\"endPress\"] },\n        \"REPEAT.TICK\": [{ guard: \"isEnabled\", actions: [\"repeatRemove\"] }, { target: \"idle\", actions: [\"endPress\"] }],\n      },\n    },\n  },\n  implementations: {\n    guards: {\n      isEnabled: ({ prop }) => !prop(\"disabled\"),\n      isPressPointer: ({ event, refs }) => event.type === \"PRESS.END\" && event.pointerId === refs.get(\"pointerId\"),\n    },\n    actions: {\n      input({ event, prop }) {\n        if (event.type !== \"KEY.INPUT\" || prop(\"disabled\")) return;\n        const key = resolveNumberKeyboardKey(prop(\"extraKeys\"), event.key);\n        if (key) prop(\"onInput\")?.({ key: key.key });\n      },\n      remove({ event, prop, refs }) {\n        if (event.type !== \"KEY.DELETE\" || prop(\"disabled\")) return;\n        const swallow = !!event.pointer && refs.get(\"swallowClick\");\n        refs.set(\"swallowClick\", false);\n        if (!swallow) prop(\"onDelete\")?.({ repeat: !!event.repeat });\n      },\n      done({ prop }) { if (!prop(\"disabled\")) prop(\"onDone\")?.(); },\n      beginPress({ event, refs }) { if (event.type === \"PRESS.START\") { refs.set(\"pointerId\", event.pointerId); refs.set(\"swallowClick\", false); } },\n      endPress({ refs }) { refs.set(\"pointerId\", null); },\n      repeatRemove({ prop, refs }) { refs.set(\"swallowClick\", true); prop(\"onDelete\")?.({ repeat: true }); },\n    },\n    effects: {\n      waitForHold({ send }) { const timer = setTimeout(() => send({ type: \"HOLD.ELAPSED\" }), NUMBER_KEYBOARD_LONG_PRESS_DELAY); return () => clearTimeout(timer); },\n      repeatWhileHeld({ send }) { const timer = setInterval(() => send({ type: \"REPEAT.TICK\" }), NUMBER_KEYBOARD_REPEAT_INTERVAL); return () => clearInterval(timer); },\n    },\n  },\n});\n\nexport interface QwNumberKeyboardApi<T extends PropTypes = PropTypes> {\n  keys: NumberKeyboardKey[];\n  disabled: boolean;\n  /** A held delete key is currently repeating. */\n  repeating: boolean;\n  label: string;\n  deleteLabel: string;\n  doneText: string;\n  /** Report a key press programmatically (ignored when disabled or unknown). */\n  input(key: string): void;\n  /** Report one delete programmatically. */\n  remove(): void;\n  /** Report done programmatically. */\n  done(): void;\n  getRootProps(): T[\"element\"];\n  getKeysProps(): T[\"element\"];\n  getKeyProps(key: NumberKeyboardKey): T[\"button\"];\n  getSidebarProps(): T[\"element\"];\n  getDeleteKeyProps(): T[\"button\"];\n  getDeleteIconProps(): T[\"element\"];\n  getDoneKeyProps(): T[\"button\"];\n}\n\ninterface NumberKeyboardPressEvent { pointerId: number; isPrimary?: boolean; button?: number }\ninterface NumberKeyboardKeyEvent {\n  key: string; repeat?: boolean; defaultPrevented: boolean; ctrlKey?: boolean; metaKey?: boolean; altKey?: boolean; isComposing?: boolean;\n  preventDefault(): void;\n}\n\nexport function connectNumberKeyboard<T extends PropTypes>(service: QwNumberKeyboardService, normalize: NormalizeProps<T>): QwNumberKeyboardApi<T> {\n  const { prop, send } = service;\n  const disabled = !!prop(\"disabled\"), keys = getNumberKeyboardKeys(prop(\"extraKeys\")), repeating = service.state.matches(\"repeating\");\n  const label = prop(\"label\") || DEFAULT_LABEL, deleteLabel = prop(\"deleteLabel\") || DEFAULT_DELETE_LABEL, doneText = prop(\"doneText\") || DEFAULT_DONE_TEXT;\n  const part = (name: NumberKeyboardPart) => ({ \"data-scope\": \"number-keyboard\", \"data-part\": name });\n  const end = (event: NumberKeyboardPressEvent) => send({ type: \"PRESS.END\", pointerId: event.pointerId });\n  return {\n    keys, disabled, repeating, label, deleteLabel, doneText,\n    input: (key) => send({ type: \"KEY.INPUT\", key }),\n    remove: () => send({ type: \"KEY.DELETE\" }),\n    done: () => send({ type: \"KEY.DONE\" }),\n    getRootProps: () => normalize.element({\n      ...part(\"root\"), role: \"group\", \"aria-label\": label, dir: prop(\"dir\"), \"data-disabled\": dataAttr(disabled),\n      onKeyDown(event: NumberKeyboardKeyEvent) {\n        if (event.defaultPrevented || disabled || event.ctrlKey || event.metaKey || event.altKey || event.isComposing) return;\n        if (event.key === \"Backspace\") { event.preventDefault(); send({ type: \"KEY.DELETE\", repeat: !!event.repeat }); return; }\n        const key = typeof event.key === \"string\" && event.key.length === 1 ? resolveNumberKeyboardKey(prop(\"extraKeys\"), event.key) : undefined;\n        if (key) { event.preventDefault(); send({ type: \"KEY.INPUT\", key: key.key }); }\n      },\n    }),\n    getKeysProps: () => normalize.element(part(\"keys\")),\n    getKeyProps: (key) => normalize.button({\n      ...part(\"key\"), type: \"button\", \"data-value\": key.key, \"data-kind\": key.kind, \"data-span\": key.span > 1 ? String(key.span) : undefined,\n      \"aria-label\": key.label, disabled, onClick: () => send({ type: \"KEY.INPUT\", key: key.key }),\n    }),\n    getSidebarProps: () => normalize.element(part(\"sidebar\")),\n    getDeleteKeyProps: () => normalize.button({\n      ...part(\"delete-key\"), type: \"button\", \"aria-label\": deleteLabel, disabled, \"data-repeating\": dataAttr(repeating),\n      onClick(event: { detail?: number }) { send({ type: \"KEY.DELETE\", pointer: (event.detail ?? 0) > 0 }); },\n      onPointerDown(event: NumberKeyboardPressEvent) { if (event.isPrimary !== false && !((event.button ?? 0) > 0)) send({ type: \"PRESS.START\", pointerId: event.pointerId }); },\n      onPointerUp: end, onPointerCancel: end, onPointerLeave: end,\n      // A held key must not open the long-press context menu (Android) or the desktop menu.\n      onContextMenu(event: { preventDefault(): void }) { event.preventDefault(); },\n    }),\n    getDeleteIconProps: () => normalize.element({ ...part(\"delete-icon\"), \"aria-hidden\": true }),\n    getDoneKeyProps: () => normalize.button({ ...part(\"done-key\"), type: \"button\", disabled, onClick: () => send({ type: \"KEY.DONE\" }) }),\n  };\n}\n"],"mappings":"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"}

package/dist/number-keyboard/number-keyboard.d.ts

@@ -0,0 +1,141 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+/**
+ * NumberKeyboard 数字键盘：内联输入事件源。
+ *
+ * Core 只报告按了什么（输入 / 删除 / 完成），从不持有或修改调用方的值。
+ * 长按删除、禁用、物理按键映射都在这里；适配层只运输事件并重绘。
+ */
+/** Stable DOM parts shared by every adapter. */
+export declare const NUMBER_KEYBOARD_PARTS: readonly ["root", "keys", "key", "sidebar", "delete-key", "delete-icon", "done-key"];
+/** Digit keys in render order: 1–9 fill three rows, 0 sits in the bottom row. */
+export declare const NUMBER_KEYBOARD_DIGITS: readonly ["1", "2", "3", "4", "5", "6", "7", "8", "9", "0"];
+/** At most two extra keys share the bottom row with 0. */
+export declare const NUMBER_KEYBOARD_MAX_EXTRA_KEYS = 2;
+/** Hold time (ms) before a pressed delete key starts repeating. */
+export declare const NUMBER_KEYBOARD_LONG_PRESS_DELAY = 500;
+/** Interval (ms) between repeated deletes while the pointer stays down. */
+export declare const NUMBER_KEYBOARD_REPEAT_INTERVAL = 100;
+/** Decorative delete glyph. Adapters render it `aria-hidden`; the name comes from `deleteLabel`. */
+export declare const NUMBER_KEYBOARD_DELETE_GLYPH = "\u232B";
+export type NumberKeyboardPart = (typeof NUMBER_KEYBOARD_PARTS)[number];
+/** An extra key: a bare string such as "." / "X", or a key with an accessible label. */
+export type NumberKeyboardExtraKey = string | {
+    key: string;
+    label?: string;
+};
+/** One rendered input key. `span` is the number of grid columns it occupies. */
+export interface NumberKeyboardKey {
+    key: string;
+    kind: "digit" | "extra";
+    label?: string;
+    span: 1 | 2 | 3;
+}
+export interface NumberKeyboardInputDetails {
+    key: string;
+}
+/** `repeat` is true for deletes produced by a held delete key or a held physical Backspace. */
+export interface NumberKeyboardDeleteDetails {
+    repeat: boolean;
+}
+export interface QwNumberKeyboardProps {
+    /** Instance identity; adapters generate one when omitted. */
+    id?: string;
+    /** Accessible name of the keyboard group; defaults to 数字键盘. */
+    label?: string;
+    /** Up to two extra keys next to 0, e.g. ["."] for amounts or ["X"] for ID cards. Empty, digit and duplicate keys are dropped. */
+    extraKeys?: readonly NumberKeyboardExtraKey[];
+    /** Disables every key; nothing is reported and an active long press stops. */
+    disabled?: boolean;
+    /** Layout direction; rtl moves the delete/done column to the inline end and mirrors the delete glyph. Digits keep keypad order. */
+    dir?: "ltr" | "rtl";
+    /** Accessible name of the delete key; defaults to 删除. */
+    deleteLabel?: string;
+    /** Visible text of the done key; defaults to 完成. */
+    doneText?: string;
+    /** A digit or extra key was pressed. The caller decides how its own value changes. */
+    onInput?: (details: NumberKeyboardInputDetails) => void;
+    /** The delete key was pressed, or repeated while held. */
+    onDelete?: (details: NumberKeyboardDeleteDetails) => void;
+    /** The done key was pressed. */
+    onDone?: () => void;
+}
+/** Trim extra keys; drop empty, digit and duplicate keys; keep at most two. Never throws. */
+export declare function normalizeNumberKeyboardExtraKeys(extraKeys?: readonly NumberKeyboardExtraKey[]): {
+    key: string;
+    label?: string;
+}[];
+/**
+ * Ordered input keys. Bottom row: no extra → 0 spans three columns; one extra → 0 spans two, then the extra;
+ * two extras → extra₁, 0, extra₂. Delete and done live in the separate side column.
+ */
+export declare function getNumberKeyboardKeys(extraKeys?: readonly NumberKeyboardExtraKey[]): NumberKeyboardKey[];
+/** Resolve a pressed or typed key against the current key set. Single letters match case-insensitively. */
+export declare function resolveNumberKeyboardKey(extraKeys: readonly NumberKeyboardExtraKey[] | undefined, key: string): NumberKeyboardKey | undefined;
+export declare function createNumberKeyboardProps(props?: QwNumberKeyboardProps): QwNumberKeyboardProps;
+export interface QwNumberKeyboardSchema {
+    props: QwNumberKeyboardProps;
+    refs: {
+        pointerId: number | null;
+        swallowClick: boolean;
+    };
+    state: "idle" | "holding" | "repeating";
+    guard: "isEnabled" | "isPressPointer";
+    action: "input" | "remove" | "done" | "beginPress" | "endPress" | "repeatRemove";
+    effect: "waitForHold" | "repeatWhileHeld";
+    event: {
+        type: "KEY.INPUT";
+        key: string;
+    } | {
+        type: "KEY.DELETE";
+        pointer?: boolean;
+        repeat?: boolean;
+    } | {
+        type: "KEY.DONE";
+    } | {
+        type: "PRESS.START";
+        pointerId: number;
+    } | {
+        type: "PRESS.END";
+        pointerId: number;
+    } | {
+        type: "PRESS.ABORT";
+    } | {
+        type: "HOLD.ELAPSED";
+    } | {
+        type: "REPEAT.TICK";
+    };
+}
+export type QwNumberKeyboardMachine = Machine<QwNumberKeyboardSchema>;
+export type QwNumberKeyboardService = Service<QwNumberKeyboardSchema>;
+/**
+ * Tap = click: one notification for mouse, touch, keyboard and assistive tech alike.
+ * Hold (delete only): after the delay Core repeats `onDelete({ repeat: true })` until the same pointer
+ * goes up / cancels / leaves, the keyboard is disabled, or the machine stops. Timers live in state effects,
+ * so leaving the state or stopping the machine always clears them. The pointer click that ends a repeat
+ * session is swallowed so a long press never adds one extra delete.
+ */
+export declare const numberKeyboardMachine: QwNumberKeyboardMachine;
+export interface QwNumberKeyboardApi<T extends PropTypes = PropTypes> {
+    keys: NumberKeyboardKey[];
+    disabled: boolean;
+    /** A held delete key is currently repeating. */
+    repeating: boolean;
+    label: string;
+    deleteLabel: string;
+    doneText: string;
+    /** Report a key press programmatically (ignored when disabled or unknown). */
+    input(key: string): void;
+    /** Report one delete programmatically. */
+    remove(): void;
+    /** Report done programmatically. */
+    done(): void;
+    getRootProps(): T["element"];
+    getKeysProps(): T["element"];
+    getKeyProps(key: NumberKeyboardKey): T["button"];
+    getSidebarProps(): T["element"];
+    getDeleteKeyProps(): T["button"];
+    getDeleteIconProps(): T["element"];
+    getDoneKeyProps(): T["button"];
+}
+export declare function connectNumberKeyboard<T extends PropTypes>(service: QwNumberKeyboardService, normalize: NormalizeProps<T>): QwNumberKeyboardApi<T>;

package/dist/overlay-panel/index.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULT_OVERLAY_PANEL_HEADER_HEIGHT, OVERLAY_PANEL_PARTS, resolveOverlayPanelHeight, } from "./overlay-panel.js";
+export type { OverlayPanelHeight, OverlayPanelPart, QwOverlayPanelProps, } from "./overlay-panel.js";

package/dist/overlay-panel/index.js

@@ -0,0 +1,2 @@
+import { n as OVERLAY_PANEL_PARTS, r as resolveOverlayPanelHeight, t as DEFAULT_OVERLAY_PANEL_HEADER_HEIGHT } from "../overlay-panel-Z_qdKeBj.js";
+export { DEFAULT_OVERLAY_PANEL_HEADER_HEIGHT, OVERLAY_PANEL_PARTS, resolveOverlayPanelHeight };

package/dist/overlay-panel/overlay-panel.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OverlayPanel 契约 — 原型 A（无状态），core 无 machine。
+ * 渲染契约：`data-scope="overlay-panel"`，根/header/title/actions/content/footer
+ * 以 data-part 摊平，React/Vue 适配层同名同义。
+ */
+/** OverlayPanel 各渲染部位全集（data-part 取值）。 */
+export declare const OVERLAY_PANEL_PARTS: readonly ["root", "header", "title", "actions", "content", "footer"];
+/** 默认 header 高度，对齐 Figma H5 浮层导航。 */
+export declare const DEFAULT_OVERLAY_PANEL_HEADER_HEIGHT = 60;
+export type OverlayPanelPart = (typeof OVERLAY_PANEL_PARTS)[number];
+export type OverlayPanelHeight = number | string;
+/** QwOverlayPanelProps — 双栈共享的容器契约。 */
+export interface QwOverlayPanelProps {
+    /** 容器高度；数字按 px 归一化，字符串原样透传。 */
+    height?: OverlayPanelHeight;
+    /** 默认 header 的标题内容。 */
+    title?: unknown;
+}
+/** 将外部传入的 height 归一化为 CSS height 值。 */
+export declare function resolveOverlayPanelHeight(height?: OverlayPanelHeight): string | undefined;