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

package/dist/collapse-B969h7-H.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapse-B969h7-H.js","names":[],"sources":["../src/collapse/collapse.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\";\nimport { selectionItemKey } from \"../selection.js\";\nimport { resolveIconState, type IconState } from \"../icon/index.js\";\n\n/** Stable DOM parts shared by every adapter. */\nexport const COLLAPSE_PARTS = [\"root\", \"item\", \"heading\", \"trigger\", \"title\", \"arrow\", \"content\", \"body\"] as const;\n/** Allowed heading levels for panel headers; default 3. */\nexport const COLLAPSE_HEADING_LEVELS = [2, 3, 4, 5, 6] as const;\nexport type CollapsePart = (typeof COLLAPSE_PARTS)[number];\nexport type CollapseHeadingLevel = (typeof COLLAPSE_HEADING_LEVELS)[number];\n/** One disclosure panel. `title` is the header button's accessible name. */\nexport interface QwCollapseItem {\n  key: string;\n  title: string;\n  /** Plain text body; adapters may project rich content instead. */\n  content?: string;\n  disabled?: boolean;\n}\nexport interface CollapseValueChangeDetails { value: string[] }\nexport interface QwCollapseProps {\n  id?: string;\n  items: QwCollapseItem[];\n  /** At most one open panel; opening another closes the previous one. */\n  accordion?: boolean;\n  /** Controlled open keys (including []). User toggles only request changes. */\n  value?: string[];\n  /** Initial open keys. Defaults []. */\n  defaultValue?: string[];\n  /** Disable every header. Open panels stay open. */\n  disabled?: boolean;\n  /** Heading level wrapping each header button; 2–6, default 3. */\n  headingLevel?: number;\n  /** ArrowUp/ArrowDown wrap between headers; defaults true. */\n  loop?: boolean;\n  onValueChange?: (details: CollapseValueChangeDetails) => void;\n}\nexport interface QwCollapseSchema {\n  props: QwCollapseProps & { accordion: boolean; defaultValue: string[]; headingLevel: CollapseHeadingLevel; loop: boolean };\n  context: { value: string[] };\n  state: \"ready\";\n  action: \"toggle\" | \"setValue\" | \"normalizeMode\";\n  event: { type: \"VALUE.TOGGLE\"; value: string } | { type: \"VALUE.SET\"; value: string[] };\n}\nexport type QwCollapseMachine = Machine<QwCollapseSchema>;\nexport type QwCollapseService = Service<QwCollapseSchema>;\nexport interface QwCollapseItemProps { key: string }\nexport interface QwCollapseItemState { open: boolean; disabled: boolean }\n\nexport function normalizeCollapseItems(items: readonly QwCollapseItem[]): QwCollapseItem[] {\n  const seen = new Set<string>();\n  return items.map((item) => {\n    if (typeof item.key !== \"string\" || !item.key.length) throw new TypeError(\"Collapse item keys must be nonempty strings\");\n    if (seen.has(item.key)) throw new TypeError(\"Collapse item keys must be unique\");\n    if (typeof item.title !== \"string\" || !item.title.trim()) throw new TypeError(\"Collapse item titles must be nonempty accessible text\");\n    seen.add(item.key);\n    return { ...item };\n  });\n}\n/** Ordered unique keys; accordion keeps the first. Unknown keys are retained. */\nexport function normalizeCollapseValue(value: readonly string[] = [], accordion = false): string[] {\n  if (value.some((key) => typeof key !== \"string\" || !key.length)) throw new TypeError(\"Collapse values must be nonempty strings\");\n  const keys = [...new Set(value)];\n  return accordion ? keys.slice(0, 1) : keys;\n}\nexport function resolveCollapseHeadingLevel(level: unknown): CollapseHeadingLevel {\n  return (COLLAPSE_HEADING_LEVELS as readonly unknown[]).includes(level) ? level as CollapseHeadingLevel : 3;\n}\nexport function createCollapseProps(props: QwCollapseProps): QwCollapseSchema[\"props\"] {\n  if (props.id !== undefined && (typeof props.id !== \"string\" || !props.id.trim())) throw new TypeError(\"Collapse requires a nonempty instance id when provided\");\n  const accordion = !!props.accordion;\n  return { ...props, accordion, items: normalizeCollapseItems(props.items ?? []), value: props.value === undefined ? undefined : normalizeCollapseValue(props.value, accordion),\n    defaultValue: normalizeCollapseValue(props.defaultValue, accordion), headingLevel: resolveCollapseHeadingLevel(props.headingLevel), loop: props.loop ?? true };\n}\n/** Pure toggle rule used by the machine. Returns null when blocked. */\nexport function toggleCollapseValue(value: readonly string[], item: QwCollapseItem, options: { accordion?: boolean; disabled?: boolean } = {}): string[] | null {\n  if (options.disabled || item.disabled) return null;\n  const keys = normalizeCollapseValue(value, options.accordion);\n  if (keys.includes(item.key)) return keys.filter((key) => key !== item.key);\n  return options.accordion ? [item.key] : [...keys, item.key];\n}\n\nconst same = (a: string[], b: string[] | undefined) => !!b && a.length === b.length && a.every((value, index) => value === b[index]);\nconst rootId = (service: Pick<QwCollapseService, \"scope\">) => `collapse:${service.scope.id}`;\nconst partId = (service: Pick<QwCollapseService, \"scope\">, part: string, key: string) => `${rootId(service)}:${part}:${selectionItemKey(key)}`;\n\n/** One Zag bindable lifecycle; Core owns toggling, accordion exclusivity and header focus moves. */\nexport const collapseMachine: QwCollapseMachine = createMachine<QwCollapseSchema>({\n  props: ({ props }) => createCollapseProps({ ...props, items: props.items ?? [] }),\n  initialState: () => \"ready\",\n  context({ prop, bindable }) {\n    return { value: bindable(() => ({ defaultValue: prop(\"defaultValue\"), value: prop(\"value\"), isEqual: same, onChange: (value) => prop(\"onValueChange\")?.({ value: [...value] }) })) };\n  },\n  watch({ track, prop, action }) { track([() => prop(\"accordion\")], () => action([\"normalizeMode\"])); },\n  on: { \"VALUE.TOGGLE\": { actions: [\"toggle\"] }, \"VALUE.SET\": { actions: [\"setValue\"] } },\n  states: { ready: {} },\n  implementations: { actions: {\n    toggle({ event, prop, context }) {\n      if (event.type !== \"VALUE.TOGGLE\") return;\n      const item = prop(\"items\").find((entry) => entry.key === event.value);\n      const next = item && toggleCollapseValue(context.get(\"value\"), item, { accordion: prop(\"accordion\"), disabled: prop(\"disabled\") });\n      if (next) context.set(\"value\", next);\n    },\n    setValue({ event, prop, context }) { if (event.type === \"VALUE.SET\") context.set(\"value\", normalizeCollapseValue(event.value, prop(\"accordion\"))); },\n    normalizeMode({ prop, context }) { context.set(\"value\", normalizeCollapseValue(context.get(\"value\"), prop(\"accordion\"))); },\n  } },\n});\n\nexport interface QwCollapseApi<T extends PropTypes = PropTypes> {\n  value: string[];\n  items: QwCollapseItem[];\n  /** Tag name adapters render for each header wrapper, e.g. \"h3\". */\n  headingTag: `h${CollapseHeadingLevel}`;\n  setValue(value: string[]): void;\n  toggle(key: string): void;\n  getRootProps(): T[\"element\"];\n  getItemState(item: QwCollapseItemProps): QwCollapseItemState;\n  getItemProps(item: QwCollapseItemProps): T[\"element\"];\n  getHeadingProps(item: QwCollapseItemProps): T[\"element\"];\n  getTriggerProps(item: QwCollapseItemProps): T[\"button\"];\n  getTitleProps(item: QwCollapseItemProps): T[\"element\"];\n  getArrowProps(item: QwCollapseItemProps): T[\"element\"];\n  getArrowIconState(item: QwCollapseItemProps): IconState;\n  getContentProps(item: QwCollapseItemProps): T[\"element\"];\n  getBodyProps(item: QwCollapseItemProps): T[\"element\"];\n}\n/** SSR-pure getters; focus moves use the Zag DOM scope only inside key events. */\nexport function connectCollapse<T extends PropTypes>(service: QwCollapseService, normalize: NormalizeProps<T>): QwCollapseApi<T> {\n  const id = rootId(service), items = service.prop(\"items\"), accordion = service.prop(\"accordion\");\n  const value = normalizeCollapseValue(service.context.get(\"value\"), accordion);\n  const resolve = ({ key }: QwCollapseItemProps) => { const item = items.find((entry) => entry.key === key); if (!item) throw new RangeError(\"Collapse item is not present in items\"); return item; };\n  const disabled = (item: QwCollapseItem) => !!service.prop(\"disabled\") || !!item.disabled;\n  const part = (name: string) => ({ \"data-scope\": \"collapse\", \"data-part\": name });\n  const data = (item: QwCollapseItem) => ({ \"data-state\": value.includes(item.key) ? \"open\" : \"closed\", \"data-disabled\": dataAttr(disabled(item)) });\n  return {\n    value: [...value], items: items.map((item) => ({ ...item })), headingTag: `h${service.prop(\"headingLevel\")}`,\n    setValue: (next) => service.send({ type: \"VALUE.SET\", value: normalizeCollapseValue(next, accordion) }),\n    toggle: (key) => service.send({ type: \"VALUE.TOGGLE\", value: key }),\n    getRootProps: () => normalize.element({ ...part(\"root\"), id, \"data-accordion\": dataAttr(accordion), \"data-disabled\": dataAttr(service.prop(\"disabled\")) }),\n    getItemState: (props) => { const item = resolve(props); return { open: value.includes(item.key), disabled: disabled(item) }; },\n    getItemProps: (props) => normalize.element({ ...part(\"item\"), ...data(resolve(props)) }),\n    getHeadingProps: (props) => normalize.element({ ...part(\"heading\"), ...data(resolve(props)) }),\n    getTriggerProps(props) {\n      const item = resolve(props);\n      return normalize.button({ ...part(\"trigger\"), ...data(item), type: \"button\", id: partId(service, \"trigger\", item.key), disabled: disabled(item),\n        \"aria-expanded\": value.includes(item.key), \"aria-controls\": partId(service, \"content\", item.key),\n        onClick(event) { if (!event.defaultPrevented) service.send({ type: \"VALUE.TOGGLE\", value: item.key }); },\n        onKeyDown(event) {\n          if (event.defaultPrevented || event.ctrlKey || event.altKey || event.metaKey || ![\"ArrowUp\", \"ArrowDown\", \"Home\", \"End\"].includes(event.key)) return;\n          const enabled = service.prop(\"items\").filter((entry) => !disabled(entry));\n          const index = enabled.findIndex((entry) => entry.key === item.key);\n          if (index < 0) return;\n          event.preventDefault();\n          let target = event.key === \"Home\" ? 0 : event.key === \"End\" ? enabled.length - 1 : index + (event.key === \"ArrowDown\" ? 1 : -1);\n          if (service.prop(\"loop\")) target = (target + enabled.length) % enabled.length;\n          const next = enabled[target];\n          if (next) service.scope.getById<HTMLButtonElement>(partId(service, \"trigger\", next.key))?.focus();\n        },\n      });\n    },\n    getTitleProps: (props) => normalize.element({ ...part(\"title\"), id: partId(service, \"title\", resolve(props).key) }),\n    getArrowProps: (props) => normalize.element({ ...part(\"arrow\"), ...data(resolve(props)), \"aria-hidden\": true }),\n    getArrowIconState: (props) => resolveIconState({ id: partId(service, \"arrow\", resolve(props).key), name: \"down\" }),\n    getContentProps(props) {\n      const item = resolve(props);\n      return normalize.element({ ...part(\"content\"), ...data(item), id: partId(service, \"content\", item.key), role: \"region\", \"aria-labelledby\": partId(service, \"trigger\", item.key), hidden: !value.includes(item.key) });\n    },\n    getBodyProps: (props) => normalize.element({ ...part(\"body\"), ...data(resolve(props)) }),\n  };\n}\n"],"mappings":"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"}

package/dist/countdown/countdown.d.ts

@@ -0,0 +1,114 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { NormalizeProps, PropTypes } from "@zag-js/types";
+export declare const COUNTDOWN_VARIANTS: readonly ["text", "block"];
+export declare const COUNTDOWN_STATES: readonly ["idle", "running", "finished"];
+/** Stable DOM parts shared by every adapter. */
+export declare const COUNTDOWN_PARTS: readonly ["root", "timer", "segment", "separator", "status"];
+export declare const COUNTDOWN_DEFAULT_FORMAT = "HH:mm:ss";
+/** Refresh cadence when the format shows sub-second digits. */
+export declare const COUNTDOWN_FAST_INTERVAL = 33;
+export type CountdownVariant = (typeof COUNTDOWN_VARIANTS)[number];
+export type CountdownStatus = (typeof COUNTDOWN_STATES)[number];
+export type CountdownPart = (typeof COUNTDOWN_PARTS)[number];
+export type CountdownUnit = "days" | "hours" | "minutes" | "seconds" | "milliseconds";
+/** Time units after format carry-over: units missing from the format roll into the next shown unit. */
+export interface CountdownTimeParts {
+    total: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}
+export type CountdownSegment = {
+    kind: "value";
+    unit: CountdownUnit;
+    text: string;
+} | {
+    kind: "literal";
+    text: string;
+};
+export interface CountdownChangeDetails {
+    remaining: number;
+    parts: CountdownTimeParts;
+}
+export interface QwCountdownProps {
+    id?: string;
+    /** Deadline timestamp (ms). The deadline is the source of truth; pausing only freezes the display. */
+    target?: number;
+    /** Duration in ms, used when target is absent. */
+    duration?: number;
+    /** Reference "now" (ms) for the initial snapshot, e.g. the server time during SSR. The client re-syncs on start. */
+    now?: number;
+    /** Tokens DD HH mm ss S SS SSS; other characters are literal. Defaults to HH:mm:ss. */
+    format?: string;
+    /** Start on mount; defaults true. */
+    autoStart?: boolean;
+    /** Accessible timer name, e.g. "距活动结束". */
+    label?: string;
+    /** Announced once through a polite status region when finished; empty announces nothing. */
+    finishedText?: string;
+    variant?: CountdownVariant;
+    onChange?: (details: CountdownChangeDetails) => void;
+    /** Called exactly once each time the countdown reaches zero (re-armed by reset). */
+    onFinish?: () => void;
+}
+/** Split remaining milliseconds by the units present in the format (Vant-compatible carry-over). */
+export declare function getCountdownTimeParts(remaining: number, format?: string): CountdownTimeParts;
+/** Tokenize the format into value and literal segments. */
+export declare function getCountdownSegments(parts: CountdownTimeParts, format?: string): CountdownSegment[];
+/** Formatted text for a remaining duration. */
+export declare function formatCountdown(remaining: number, format?: string): string;
+/** Remaining ms from props at a given clock time: target first, then duration, else 0. */
+export declare function resolveCountdownRemaining(props: Pick<QwCountdownProps, "target" | "duration">, now: number): number;
+export interface QwCountdownSchema {
+    props: QwCountdownProps & {
+        format: string;
+        autoStart: boolean;
+        variant: CountdownVariant;
+    };
+    context: {
+        remaining: number;
+    };
+    /** resume mirrors remaining synchronously: adapter contexts (e.g. React state) commit after the effect runs. */
+    refs: {
+        endAt: number;
+        resume: number;
+    };
+    state: CountdownStatus;
+    guard: "hasTime" | "autoStartWithTime" | "autoStartNoTime" | "tickDone";
+    action: "freeze" | "restore" | "applyTick" | "clearRemaining" | "notifyFinish";
+    effect: "tick";
+    event: {
+        type: "START" | "PAUSE" | "RESET";
+    } | {
+        type: "TICK";
+        remaining: number;
+    };
+}
+export type QwCountdownMachine = Machine<QwCountdownSchema>;
+export type QwCountdownService = Service<QwCountdownSchema>;
+/** Normalize adapter input. */
+export declare function createCountdownProps(props: QwCountdownProps): Partial<QwCountdownSchema["props"]>;
+/** Core-owned timer lifecycle: scheduling, pausing, completion-once and cleanup all live here. */
+export declare const countdownMachine: QwCountdownMachine;
+export interface QwCountdownApi<T extends PropTypes = PropTypes> {
+    remaining: number;
+    parts: CountdownTimeParts;
+    segments: CountdownSegment[];
+    text: string;
+    state: CountdownStatus;
+    running: boolean;
+    finished: boolean;
+    /** Status-region text: finishedText once finished, otherwise empty. */
+    statusText: string;
+    start(): void;
+    pause(): void;
+    reset(): void;
+    getRootProps(): T["element"];
+    getTimerProps(): T["element"];
+    getSegmentProps(segment: CountdownSegment): T["element"];
+    getStatusProps(): T["element"];
+}
+/** Getters are SSR-pure; only the running-state effect touches timers. */
+export declare function connectCountdown<T extends PropTypes>(service: QwCountdownService, normalize: NormalizeProps<T>): QwCountdownApi<T>;

package/dist/countdown/index.d.ts

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

package/dist/countdown/index.js

@@ -0,0 +1,309 @@
+import { createMachine } from "@zag-js/core";
+import { visuallyHiddenStyle } from "@zag-js/dom-query";
+//#region src/countdown/countdown.ts
+const COUNTDOWN_VARIANTS = ["text", "block"];
+const COUNTDOWN_STATES = [
+	"idle",
+	"running",
+	"finished"
+];
+/** Stable DOM parts shared by every adapter. */
+const COUNTDOWN_PARTS = [
+	"root",
+	"timer",
+	"segment",
+	"separator",
+	"status"
+];
+const COUNTDOWN_DEFAULT_FORMAT = "HH:mm:ss";
+/** Refresh cadence when the format shows sub-second digits. */
+const COUNTDOWN_FAST_INTERVAL = 33;
+const DAY = 864e5;
+const HOUR = 36e5;
+const MINUTE = 6e4;
+const SECOND = 1e3;
+const TOKENS = /DD|HH|mm|ss|SSS|SS|S/g;
+const pad = (value, length = 2) => String(value).padStart(length, "0");
+const finite = (value) => typeof value === "number" && Number.isFinite(value);
+/** Split remaining milliseconds by the units present in the format (Vant-compatible carry-over). */
+function getCountdownTimeParts(remaining, format = COUNTDOWN_DEFAULT_FORMAT) {
+	const total = Math.max(0, Math.floor(finite(remaining) ? remaining : 0));
+	let days = Math.floor(total / DAY), hours = Math.floor(total % DAY / HOUR), minutes = Math.floor(total % HOUR / MINUTE);
+	let seconds = Math.floor(total % MINUTE / SECOND), milliseconds = total % SECOND;
+	if (!format.includes("DD")) {
+		hours += days * 24;
+		days = 0;
+	}
+	if (!format.includes("HH")) {
+		minutes += hours * 60;
+		hours = 0;
+	}
+	if (!format.includes("mm")) {
+		seconds += minutes * 60;
+		minutes = 0;
+	}
+	if (!format.includes("ss")) {
+		milliseconds += seconds * 1e3;
+		seconds = 0;
+	}
+	return {
+		total,
+		days,
+		hours,
+		minutes,
+		seconds,
+		milliseconds
+	};
+}
+/** Tokenize the format into value and literal segments. */
+function getCountdownSegments(parts, format = COUNTDOWN_DEFAULT_FORMAT) {
+	const segments = [];
+	let last = 0;
+	for (const match of format.matchAll(TOKENS)) {
+		if (match.index > last) segments.push({
+			kind: "literal",
+			text: format.slice(last, match.index)
+		});
+		const token = match[0];
+		const value = token === "DD" ? {
+			kind: "value",
+			unit: "days",
+			text: pad(parts.days)
+		} : token === "HH" ? {
+			kind: "value",
+			unit: "hours",
+			text: pad(parts.hours)
+		} : token === "mm" ? {
+			kind: "value",
+			unit: "minutes",
+			text: pad(parts.minutes)
+		} : token === "ss" ? {
+			kind: "value",
+			unit: "seconds",
+			text: pad(parts.seconds)
+		} : token === "SSS" ? {
+			kind: "value",
+			unit: "milliseconds",
+			text: pad(parts.milliseconds, 3)
+		} : token === "SS" ? {
+			kind: "value",
+			unit: "milliseconds",
+			text: pad(Math.floor(parts.milliseconds / 10))
+		} : {
+			kind: "value",
+			unit: "milliseconds",
+			text: String(Math.floor(parts.milliseconds / 100))
+		};
+		segments.push(value);
+		last = match.index + token.length;
+	}
+	if (last < format.length) segments.push({
+		kind: "literal",
+		text: format.slice(last)
+	});
+	return segments;
+}
+/** Formatted text for a remaining duration. */
+function formatCountdown(remaining, format = COUNTDOWN_DEFAULT_FORMAT) {
+	return getCountdownSegments(getCountdownTimeParts(remaining, format), format).map((segment) => segment.text).join("");
+}
+/** Remaining ms from props at a given clock time: target first, then duration, else 0. */
+function resolveCountdownRemaining(props, now) {
+	if (finite(props.target)) return Math.max(0, Math.floor(props.target - now));
+	if (finite(props.duration)) return Math.max(0, Math.floor(props.duration));
+	return 0;
+}
+/** Normalize adapter input. */
+function createCountdownProps(props) {
+	return {
+		...props,
+		format: typeof props.format === "string" && props.format ? props.format : COUNTDOWN_DEFAULT_FORMAT,
+		autoStart: props.autoStart ?? true,
+		variant: COUNTDOWN_VARIANTS.includes(props.variant) ? props.variant : "text"
+	};
+}
+const clock = () => Date.now();
+const fromProps = (params, now = clock()) => resolveCountdownRemaining({
+	target: params.prop("target"),
+	duration: params.prop("duration")
+}, now);
+const setRemaining = (params, remaining) => {
+	params.refs.set("resume", remaining);
+	params.context.set("remaining", remaining);
+};
+const isFast = (format) => format.includes("S");
+/** Core-owned timer lifecycle: scheduling, pausing, completion-once and cleanup all live here. */
+const countdownMachine = createMachine({
+	props: ({ props }) => createCountdownProps(props),
+	initialState({ prop }) {
+		const remaining = resolveCountdownRemaining({
+			target: prop("target"),
+			duration: prop("duration")
+		}, prop("now") ?? clock());
+		return !prop("autoStart") ? "idle" : remaining > 0 ? "running" : "finished";
+	},
+	context({ prop, bindable }) {
+		return { remaining: bindable(() => ({
+			defaultValue: resolveCountdownRemaining({
+				target: prop("target"),
+				duration: prop("duration")
+			}, prop("now") ?? clock()),
+			onChange: (remaining) => prop("onChange")?.({
+				remaining,
+				parts: getCountdownTimeParts(remaining, prop("format"))
+			})
+		})) };
+	},
+	refs: ({ context }) => ({
+		endAt: 0,
+		resume: context.get("remaining")
+	}),
+	watch({ track, send, prop }) {
+		track([() => prop("target"), () => prop("duration")], () => send({ type: "RESET" }));
+	},
+	on: { RESET: [
+		{
+			guard: "autoStartWithTime",
+			target: "running",
+			actions: ["restore"],
+			reenter: true
+		},
+		{
+			guard: "autoStartNoTime",
+			target: "finished",
+			actions: ["restore"],
+			reenter: true
+		},
+		{
+			target: "idle",
+			actions: ["restore"]
+		}
+	] },
+	states: {
+		idle: { on: { START: [{
+			guard: "hasTime",
+			target: "running"
+		}, {
+			target: "finished",
+			actions: ["clearRemaining"]
+		}] } },
+		running: {
+			effects: ["tick"],
+			on: {
+				PAUSE: {
+					target: "idle",
+					actions: ["freeze"]
+				},
+				TICK: [{
+					guard: "tickDone",
+					target: "finished",
+					actions: ["applyTick"]
+				}, { actions: ["applyTick"] }]
+			}
+		},
+		finished: { entry: ["clearRemaining", "notifyFinish"] }
+	},
+	implementations: {
+		guards: {
+			hasTime: (params) => (finite(params.prop("target")) ? fromProps(params) : params.refs.get("resume")) > 0,
+			autoStartWithTime: (params) => params.prop("autoStart") && fromProps(params) > 0,
+			autoStartNoTime: (params) => params.prop("autoStart") && fromProps(params) === 0,
+			tickDone: (params) => params.event.type === "TICK" && params.event.remaining <= 0
+		},
+		actions: {
+			freeze(params) {
+				setRemaining(params, Math.max(0, params.refs.get("endAt") - clock()));
+			},
+			restore(params) {
+				setRemaining(params, fromProps(params));
+			},
+			applyTick(params) {
+				if (params.event.type === "TICK") setRemaining(params, Math.max(0, params.event.remaining));
+			},
+			clearRemaining(params) {
+				setRemaining(params, 0);
+			},
+			notifyFinish(params) {
+				params.prop("onFinish")?.();
+			}
+		},
+		effects: { tick(params) {
+			const now = clock();
+			const initial = finite(params.prop("target")) ? fromProps(params, now) : params.refs.get("resume");
+			params.refs.set("endAt", now + initial);
+			setRemaining(params, initial);
+			let timer;
+			const schedule = () => {
+				const left = params.refs.get("endAt") - clock();
+				const step = isFast(params.prop("format")) ? 33 : left % SECOND || SECOND;
+				timer = setTimeout(() => {
+					const remaining = Math.max(0, params.refs.get("endAt") - clock());
+					params.send({
+						type: "TICK",
+						remaining
+					});
+					if (remaining > 0) schedule();
+				}, Math.max(0, Math.min(step, left)));
+			};
+			schedule();
+			return () => {
+				if (timer !== void 0) clearTimeout(timer);
+			};
+		} }
+	}
+});
+/** Getters are SSR-pure; only the running-state effect touches timers. */
+function connectCountdown(service, normalize) {
+	const format = service.prop("format");
+	const remaining = service.context.get("remaining");
+	const parts = getCountdownTimeParts(remaining, format);
+	const segments = getCountdownSegments(parts, format);
+	const state = service.state.get();
+	const label = service.prop("label")?.trim();
+	return {
+		remaining,
+		parts,
+		segments,
+		text: segments.map((segment) => segment.text).join(""),
+		state,
+		running: state === "running",
+		finished: state === "finished",
+		statusText: state === "finished" ? service.prop("finishedText") ?? "" : "",
+		start: () => service.send({ type: "START" }),
+		pause: () => service.send({ type: "PAUSE" }),
+		reset: () => service.send({ type: "RESET" }),
+		getRootProps: () => normalize.element({
+			"data-scope": "countdown",
+			"data-part": "root",
+			"data-state": state,
+			"data-variant": service.prop("variant")
+		}),
+		getTimerProps: () => normalize.element({
+			"data-scope": "countdown",
+			"data-part": "timer",
+			role: "timer",
+			"aria-live": "off",
+			"aria-atomic": "true",
+			"aria-label": label || void 0,
+			"data-state": state
+		}),
+		getSegmentProps: (segment) => normalize.element(segment.kind === "value" ? {
+			"data-scope": "countdown",
+			"data-part": "segment",
+			"data-unit": segment.unit
+		} : {
+			"data-scope": "countdown",
+			"data-part": "separator"
+		}),
+		getStatusProps: () => normalize.element({
+			"data-scope": "countdown",
+			"data-part": "status",
+			role: "status",
+			style: { ...visuallyHiddenStyle }
+		})
+	};
+}
+//#endregion
+export { COUNTDOWN_DEFAULT_FORMAT, COUNTDOWN_FAST_INTERVAL, COUNTDOWN_PARTS, COUNTDOWN_STATES, COUNTDOWN_VARIANTS, connectCountdown, countdownMachine, createCountdownProps, formatCountdown, getCountdownSegments, getCountdownTimeParts, resolveCountdownRemaining };
+
+//# sourceMappingURL=index.js.map

package/dist/countdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/countdown/countdown.ts"],"sourcesContent":["import { createMachine, type Machine, type Params, type Service } from \"@zag-js/core\";\nimport { visuallyHiddenStyle } from \"@zag-js/dom-query\";\nimport type { NormalizeProps, PropTypes } from \"@zag-js/types\";\n\nexport const COUNTDOWN_VARIANTS = [\"text\", \"block\"] as const;\nexport const COUNTDOWN_STATES = [\"idle\", \"running\", \"finished\"] as const;\n/** Stable DOM parts shared by every adapter. */\nexport const COUNTDOWN_PARTS = [\"root\", \"timer\", \"segment\", \"separator\", \"status\"] as const;\nexport const COUNTDOWN_DEFAULT_FORMAT = \"HH:mm:ss\";\n/** Refresh cadence when the format shows sub-second digits. */\nexport const COUNTDOWN_FAST_INTERVAL = 33;\n\nexport type CountdownVariant = (typeof COUNTDOWN_VARIANTS)[number];\nexport type CountdownStatus = (typeof COUNTDOWN_STATES)[number];\nexport type CountdownPart = (typeof COUNTDOWN_PARTS)[number];\nexport type CountdownUnit = \"days\" | \"hours\" | \"minutes\" | \"seconds\" | \"milliseconds\";\n\n/** Time units after format carry-over: units missing from the format roll into the next shown unit. */\nexport interface CountdownTimeParts { total: number; days: number; hours: number; minutes: number; seconds: number; milliseconds: number }\nexport type CountdownSegment = { kind: \"value\"; unit: CountdownUnit; text: string } | { kind: \"literal\"; text: string };\nexport interface CountdownChangeDetails { remaining: number; parts: CountdownTimeParts }\n\nexport interface QwCountdownProps {\n  id?: string;\n  /** Deadline timestamp (ms). The deadline is the source of truth; pausing only freezes the display. */\n  target?: number;\n  /** Duration in ms, used when target is absent. */\n  duration?: number;\n  /** Reference \"now\" (ms) for the initial snapshot, e.g. the server time during SSR. The client re-syncs on start. */\n  now?: number;\n  /** Tokens DD HH mm ss S SS SSS; other characters are literal. Defaults to HH:mm:ss. */\n  format?: string;\n  /** Start on mount; defaults true. */\n  autoStart?: boolean;\n  /** Accessible timer name, e.g. \"距活动结束\". */\n  label?: string;\n  /** Announced once through a polite status region when finished; empty announces nothing. */\n  finishedText?: string;\n  variant?: CountdownVariant;\n  onChange?: (details: CountdownChangeDetails) => void;\n  /** Called exactly once each time the countdown reaches zero (re-armed by reset). */\n  onFinish?: () => void;\n}\n\nconst DAY = 86_400_000, HOUR = 3_600_000, MINUTE = 60_000, SECOND = 1000;\nconst TOKENS = /DD|HH|mm|ss|SSS|SS|S/g;\nconst pad = (value: number, length = 2) => String(value).padStart(length, \"0\");\nconst finite = (value: unknown): value is number => typeof value === \"number\" && Number.isFinite(value);\n\n/** Split remaining milliseconds by the units present in the format (Vant-compatible carry-over). */\nexport function getCountdownTimeParts(remaining: number, format: string = COUNTDOWN_DEFAULT_FORMAT): CountdownTimeParts {\n  const total = Math.max(0, Math.floor(finite(remaining) ? remaining : 0));\n  let days = Math.floor(total / DAY), hours = Math.floor((total % DAY) / HOUR), minutes = Math.floor((total % HOUR) / MINUTE);\n  let seconds = Math.floor((total % MINUTE) / SECOND), milliseconds = total % SECOND;\n  if (!format.includes(\"DD\")) { hours += days * 24; days = 0; }\n  if (!format.includes(\"HH\")) { minutes += hours * 60; hours = 0; }\n  if (!format.includes(\"mm\")) { seconds += minutes * 60; minutes = 0; }\n  if (!format.includes(\"ss\")) { milliseconds += seconds * 1000; seconds = 0; }\n  return { total, days, hours, minutes, seconds, milliseconds };\n}\n\n/** Tokenize the format into value and literal segments. */\nexport function getCountdownSegments(parts: CountdownTimeParts, format: string = COUNTDOWN_DEFAULT_FORMAT): CountdownSegment[] {\n  const segments: CountdownSegment[] = [];\n  let last = 0;\n  for (const match of format.matchAll(TOKENS)) {\n    if (match.index > last) segments.push({ kind: \"literal\", text: format.slice(last, match.index) });\n    const token = match[0];\n    const value: CountdownSegment = token === \"DD\" ? { kind: \"value\", unit: \"days\", text: pad(parts.days) }\n      : token === \"HH\" ? { kind: \"value\", unit: \"hours\", text: pad(parts.hours) }\n      : token === \"mm\" ? { kind: \"value\", unit: \"minutes\", text: pad(parts.minutes) }\n      : token === \"ss\" ? { kind: \"value\", unit: \"seconds\", text: pad(parts.seconds) }\n      : token === \"SSS\" ? { kind: \"value\", unit: \"milliseconds\", text: pad(parts.milliseconds, 3) }\n      : token === \"SS\" ? { kind: \"value\", unit: \"milliseconds\", text: pad(Math.floor(parts.milliseconds / 10)) }\n      : { kind: \"value\", unit: \"milliseconds\", text: String(Math.floor(parts.milliseconds / 100)) };\n    segments.push(value);\n    last = match.index + token.length;\n  }\n  if (last < format.length) segments.push({ kind: \"literal\", text: format.slice(last) });\n  return segments;\n}\n\n/** Formatted text for a remaining duration. */\nexport function formatCountdown(remaining: number, format: string = COUNTDOWN_DEFAULT_FORMAT): string {\n  return getCountdownSegments(getCountdownTimeParts(remaining, format), format).map((segment) => segment.text).join(\"\");\n}\n\n/** Remaining ms from props at a given clock time: target first, then duration, else 0. */\nexport function resolveCountdownRemaining(props: Pick<QwCountdownProps, \"target\" | \"duration\">, now: number): number {\n  if (finite(props.target)) return Math.max(0, Math.floor(props.target - now));\n  if (finite(props.duration)) return Math.max(0, Math.floor(props.duration));\n  return 0;\n}\n\nexport interface QwCountdownSchema {\n  props: QwCountdownProps & { format: string; autoStart: boolean; variant: CountdownVariant };\n  context: { remaining: number };\n  /** resume mirrors remaining synchronously: adapter contexts (e.g. React state) commit after the effect runs. */\n  refs: { endAt: number; resume: number };\n  state: CountdownStatus;\n  guard: \"hasTime\" | \"autoStartWithTime\" | \"autoStartNoTime\" | \"tickDone\";\n  action: \"freeze\" | \"restore\" | \"applyTick\" | \"clearRemaining\" | \"notifyFinish\";\n  effect: \"tick\";\n  event: { type: \"START\" | \"PAUSE\" | \"RESET\" } | { type: \"TICK\"; remaining: number };\n}\nexport type QwCountdownMachine = Machine<QwCountdownSchema>;\nexport type QwCountdownService = Service<QwCountdownSchema>;\ntype CountdownParams = Params<QwCountdownSchema>;\n\n/** Normalize adapter input. */\nexport function createCountdownProps(props: QwCountdownProps): Partial<QwCountdownSchema[\"props\"]> {\n  return { ...props, format: typeof props.format === \"string\" && props.format ? props.format : COUNTDOWN_DEFAULT_FORMAT,\n    autoStart: props.autoStart ?? true, variant: (COUNTDOWN_VARIANTS as readonly unknown[]).includes(props.variant) ? props.variant : \"text\" };\n}\n\nconst clock = () => Date.now();\nconst fromProps = (params: Pick<CountdownParams, \"prop\">, now = clock()) => resolveCountdownRemaining({ target: params.prop(\"target\"), duration: params.prop(\"duration\") }, now);\nconst setRemaining = (params: Pick<CountdownParams, \"context\" | \"refs\">, remaining: number) => {\n  params.refs.set(\"resume\", remaining);\n  params.context.set(\"remaining\", remaining);\n};\nconst isFast = (format: string) => format.includes(\"S\");\n\n/** Core-owned timer lifecycle: scheduling, pausing, completion-once and cleanup all live here. */\nexport const countdownMachine: QwCountdownMachine = createMachine<QwCountdownSchema>({\n  props: ({ props }) => createCountdownProps(props) as QwCountdownSchema[\"props\"],\n  initialState({ prop }) {\n    const remaining = resolveCountdownRemaining({ target: prop(\"target\"), duration: prop(\"duration\") }, prop(\"now\") ?? clock());\n    return !prop(\"autoStart\") ? \"idle\" : remaining > 0 ? \"running\" : \"finished\";\n  },\n  context({ prop, bindable }) {\n    return {\n      remaining: bindable(() => ({\n        defaultValue: resolveCountdownRemaining({ target: prop(\"target\"), duration: prop(\"duration\") }, prop(\"now\") ?? clock()),\n        onChange: (remaining) => prop(\"onChange\")?.({ remaining, parts: getCountdownTimeParts(remaining, prop(\"format\")) }),\n      })),\n    };\n  },\n  refs: ({ context }) => ({ endAt: 0, resume: context.get(\"remaining\") }),\n  watch({ track, send, prop }) {\n    track([() => prop(\"target\"), () => prop(\"duration\")], () => send({ type: \"RESET\" }));\n  },\n  on: {\n    RESET: [\n      { guard: \"autoStartWithTime\", target: \"running\", actions: [\"restore\"], reenter: true },\n      { guard: \"autoStartNoTime\", target: \"finished\", actions: [\"restore\"], reenter: true },\n      { target: \"idle\", actions: [\"restore\"] },\n    ],\n  },\n  states: {\n    idle: {\n      on: { START: [{ guard: \"hasTime\", target: \"running\" }, { target: \"finished\", actions: [\"clearRemaining\"] }] },\n    },\n    running: {\n      effects: [\"tick\"],\n      on: {\n        PAUSE: { target: \"idle\", actions: [\"freeze\"] },\n        TICK: [{ guard: \"tickDone\", target: \"finished\", actions: [\"applyTick\"] }, { actions: [\"applyTick\"] }],\n      },\n    },\n    finished: {\n      entry: [\"clearRemaining\", \"notifyFinish\"],\n    },\n  },\n  implementations: {\n    guards: {\n      // Target mode re-syncs to the deadline; duration mode resumes the frozen remainder.\n      hasTime: (params) => (finite(params.prop(\"target\")) ? fromProps(params) : params.refs.get(\"resume\")) > 0,\n      autoStartWithTime: (params) => params.prop(\"autoStart\") && fromProps(params) > 0,\n      autoStartNoTime: (params) => params.prop(\"autoStart\") && fromProps(params) === 0,\n      tickDone: (params) => params.event.type === \"TICK\" && params.event.remaining <= 0,\n    },\n    actions: {\n      freeze(params) { setRemaining(params, Math.max(0, params.refs.get(\"endAt\") - clock())); },\n      restore(params) { setRemaining(params, fromProps(params)); },\n      applyTick(params) { if (params.event.type === \"TICK\") setRemaining(params, Math.max(0, params.event.remaining)); },\n      clearRemaining(params) { setRemaining(params, 0); },\n      notifyFinish(params) { params.prop(\"onFinish\")?.(); },\n    },\n    effects: {\n      tick(params) {\n        // Resume: target mode re-syncs to the deadline, duration mode continues the frozen remainder.\n        const now = clock();\n        const initial = finite(params.prop(\"target\")) ? fromProps(params, now) : params.refs.get(\"resume\");\n        params.refs.set(\"endAt\", now + initial);\n        setRemaining(params, initial);\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        const schedule = () => {\n          const left = params.refs.get(\"endAt\") - clock();\n          // Second formats wake exactly on the next whole-second boundary of the remaining time.\n          const step = isFast(params.prop(\"format\")) ? COUNTDOWN_FAST_INTERVAL : (left % SECOND) || SECOND;\n          timer = setTimeout(() => {\n            const remaining = Math.max(0, params.refs.get(\"endAt\") - clock());\n            params.send({ type: \"TICK\", remaining });\n            if (remaining > 0) schedule();\n          }, Math.max(0, Math.min(step, left)));\n        };\n        schedule();\n        return () => { if (timer !== undefined) clearTimeout(timer); };\n      },\n    },\n  },\n});\n\nexport interface QwCountdownApi<T extends PropTypes = PropTypes> {\n  remaining: number;\n  parts: CountdownTimeParts;\n  segments: CountdownSegment[];\n  text: string;\n  state: CountdownStatus;\n  running: boolean;\n  finished: boolean;\n  /** Status-region text: finishedText once finished, otherwise empty. */\n  statusText: string;\n  start(): void;\n  pause(): void;\n  reset(): void;\n  getRootProps(): T[\"element\"];\n  getTimerProps(): T[\"element\"];\n  getSegmentProps(segment: CountdownSegment): T[\"element\"];\n  getStatusProps(): T[\"element\"];\n}\n\n/** Getters are SSR-pure; only the running-state effect touches timers. */\nexport function connectCountdown<T extends PropTypes>(service: QwCountdownService, normalize: NormalizeProps<T>): QwCountdownApi<T> {\n  const format = service.prop(\"format\");\n  const remaining = service.context.get(\"remaining\");\n  const parts = getCountdownTimeParts(remaining, format);\n  const segments = getCountdownSegments(parts, format);\n  const state = service.state.get();\n  const label = service.prop(\"label\")?.trim();\n  return {\n    remaining, parts, segments, text: segments.map((segment) => segment.text).join(\"\"), state,\n    running: state === \"running\", finished: state === \"finished\",\n    statusText: state === \"finished\" ? service.prop(\"finishedText\") ?? \"\" : \"\",\n    start: () => service.send({ type: \"START\" }),\n    pause: () => service.send({ type: \"PAUSE\" }),\n    reset: () => service.send({ type: \"RESET\" }),\n    getRootProps: () => normalize.element({ \"data-scope\": \"countdown\", \"data-part\": \"root\", \"data-state\": state, \"data-variant\": service.prop(\"variant\") }),\n    // The timer is silent (aria-live off); completion is announced by the sibling status region, not nested in it.\n    getTimerProps: () => normalize.element({ \"data-scope\": \"countdown\", \"data-part\": \"timer\", role: \"timer\", \"aria-live\": \"off\", \"aria-atomic\": \"true\",\n      \"aria-label\": label || undefined, \"data-state\": state }),\n    getSegmentProps: (segment) => normalize.element(segment.kind === \"value\"\n      ? { \"data-scope\": \"countdown\", \"data-part\": \"segment\", \"data-unit\": segment.unit }\n      : { \"data-scope\": \"countdown\", \"data-part\": \"separator\" }),\n    getStatusProps: () => normalize.element({ \"data-scope\": \"countdown\", \"data-part\": \"status\", role: \"status\", style: { ...visuallyHiddenStyle } }),\n  };\n}\n"],"mappings":"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"}