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

package/dist/area-picker/index.js

@@ -0,0 +1,348 @@
+import { l as resolveCascaderPath, s as normalizeCascaderOptions, u as updateCascaderChildren } from "../cascader-D-xMjs7P.js";
+import { createMachine } from "@zag-js/core";
+//#region src/area-picker/area-picker.ts
+const AREA_PICKER_PARTS = [
+	"root",
+	"status",
+	"retry-trigger",
+	"input"
+];
+function toAreaPickerOptions(data) {
+	return normalizeCascaderOptions(data.map((node) => ({
+		value: node.code,
+		label: node.label,
+		disabled: node.disabled,
+		leaf: node.leaf,
+		children: node.children ? toAreaPickerOptions(node.children) : void 0
+	})), "AreaPicker");
+}
+function toNode(node) {
+	return {
+		code: node.value,
+		label: node.label,
+		disabled: node.disabled,
+		leaf: node.leaf,
+		children: node.children?.map(toNode)
+	};
+}
+const depthOf = (props) => Number.isInteger(props.maxDepth) && props.maxDepth > 0 ? props.maxDepth : 3;
+/** Fill enabled descendants; a disabled ancestor invalidates its entire branch. */
+function resolveAreaPickerValue(options, value, maxDepth = 3) {
+	const path = [];
+	let level = options;
+	for (let depth = 0; depth < maxDepth; depth++) {
+		const selected = level.find((node) => node.value === value[depth] && !node.disabled) ?? level.find((node) => !node.disabled);
+		if (!selected) break;
+		path.push(selected.value);
+		if (selected.leaf) break;
+		level = selected.children ?? [];
+	}
+	return path;
+}
+function details(options, value) {
+	const path = resolveCascaderPath(options, value).map(toNode);
+	return {
+		value: [...value],
+		labels: path.map((node) => node.label),
+		path,
+		code: value.at(-1)
+	};
+}
+function createAreaPickerProps(props) {
+	toAreaPickerOptions(props.data ?? []);
+	return {
+		...props,
+		data: props.data ?? [],
+		maxDepth: depthOf(props)
+	};
+}
+function invalidate({ context, refs }) {
+	refs.get("controller")?.abort();
+	refs.set("controller", null);
+	refs.set("request", refs.get("request") + 1);
+	context.set("loading", []);
+}
+function currentOptions({ context, refs }) {
+	return refs.get("options") ?? context.get("options");
+}
+function load(params, path, options = currentOptions(params)) {
+	const { context, prop, refs, send } = params, loader = prop("loadChildren"), option = resolveCascaderPath(options, path).at(-1);
+	if (!loader || !option || option.disabled || option.leaf || option.children !== void 0 || path.length >= (prop("maxDepth") ?? 3)) return;
+	invalidate(params);
+	const controller = new AbortController(), request = refs.get("request"), sourceData = prop("data"), sourceDepth = prop("maxDepth");
+	refs.set("controller", controller);
+	context.set("loading", path);
+	context.set("error", []);
+	Promise.resolve().then(() => {
+		if (!refs.get("active") || controller.signal.aborted || refs.get("request") !== request || prop("data") !== sourceData || prop("maxDepth") !== sourceDepth || prop("loadChildren") !== loader) return void 0;
+		return loader({
+			node: toNode(option),
+			path: [...path],
+			signal: controller.signal
+		});
+	}).then((data) => {
+		if (data === void 0) return void 0;
+		toAreaPickerOptions(data);
+		return data;
+	}).then((data) => {
+		if (data !== void 0 && refs.get("active") && !controller.signal.aborted && refs.get("request") === request) send({
+			type: "SUCCESS",
+			request,
+			path,
+			data
+		});
+	}).catch(() => {
+		if (refs.get("active") && !controller.signal.aborted) send({
+			type: "ERROR",
+			request,
+			path
+		});
+	});
+}
+const loaderIdentities = /* @__PURE__ */ new WeakMap();
+let nextLoaderIdentity = 0;
+function loaderIdentity(loader) {
+	if (!loader) return 0;
+	const known = loaderIdentities.get(loader);
+	if (known !== void 0) return known;
+	const identity = ++nextLoaderIdentity;
+	loaderIdentities.set(loader, identity);
+	return identity;
+}
+const areaPickerMachine = createMachine({
+	props: ({ props }) => createAreaPickerProps({
+		...props,
+		data: props.data ?? []
+	}),
+	initialState: () => "idle",
+	states: { idle: {} },
+	context: ({ bindable, prop }) => ({
+		value: bindable(() => ({
+			defaultValue: prop("defaultValue") ?? [],
+			value: prop("value"),
+			hash: JSON.stringify
+		})),
+		preview: bindable(() => ({
+			defaultValue: [],
+			hash: JSON.stringify
+		})),
+		base: bindable(() => ({ defaultValue: "" })),
+		options: bindable(() => ({
+			defaultValue: toAreaPickerOptions(prop("data") ?? []),
+			hash: JSON.stringify
+		})),
+		loading: bindable(() => ({
+			defaultValue: [],
+			hash: JSON.stringify
+		})),
+		error: bindable(() => ({
+			defaultValue: [],
+			hash: JSON.stringify
+		}))
+	}),
+	refs: () => ({
+		controller: null,
+		active: false,
+		request: 0,
+		options: void 0
+	}),
+	effects: ["lifecycle"],
+	watch({ track, prop, send }) {
+		track([
+			() => JSON.stringify(prop("data") ?? []),
+			() => prop("maxDepth"),
+			() => loaderIdentity(prop("loadChildren"))
+		], () => send({ type: "SYNC" }));
+		track([() => JSON.stringify(prop("value"))], () => send({ type: "OPEN" }));
+		track([() => prop("open")], () => send({ type: prop("open") ? "OPEN" : "RESET" }));
+	},
+	on: {
+		PREVIEW: { actions: ["preview"] },
+		COMMIT: { actions: ["commit"] },
+		SYNC: { actions: ["sync"] },
+		RETRY: { actions: ["retry"] },
+		RESET: { actions: ["reset"] },
+		OPEN: { actions: ["open"] },
+		SUCCESS: { actions: ["success"] },
+		ERROR: { actions: ["error"] }
+	},
+	implementations: {
+		actions: {
+			preview(params) {
+				const { context, prop, event } = params;
+				if (event.type !== "PREVIEW") return;
+				const value = resolveAreaPickerValue(currentOptions(params), event.value, prop("maxDepth"));
+				context.set("base", JSON.stringify(context.get("value")));
+				context.set("preview", value);
+				context.set("error", []);
+				invalidate(params);
+				load(params, value);
+				prop("onPreviewChange")?.(details(currentOptions(params), value));
+			},
+			commit(params) {
+				const { context, prop, event } = params;
+				if (event.type !== "COMMIT" || context.get("loading").length || context.get("error").length) return;
+				const options = currentOptions(params), value = resolveAreaPickerValue(options, event.value, prop("maxDepth")), last = resolveCascaderPath(options, value).at(-1);
+				if (!last || !last.leaf && value.length < (prop("maxDepth") ?? 3)) return;
+				context.set("value", value);
+				context.set("preview", []);
+				prop("onValueChange")?.(details(options, value));
+			},
+			sync(params) {
+				invalidate(params);
+				const options = toAreaPickerOptions(params.prop("data"));
+				params.refs.set("options", options);
+				params.context.set("options", options);
+				params.context.set("preview", []);
+				params.context.set("error", []);
+				load(params, resolveAreaPickerValue(options, params.context.get("value"), params.prop("maxDepth")), options);
+			},
+			reset(params) {
+				invalidate(params);
+				params.context.set("preview", []);
+				params.context.set("error", []);
+			},
+			open(params) {
+				invalidate(params);
+				params.context.set("preview", []);
+				params.context.set("error", []);
+				load(params, resolveAreaPickerValue(currentOptions(params), params.context.get("value"), params.prop("maxDepth")));
+			},
+			success(params) {
+				const { context, event, refs } = params;
+				if (event.type !== "SUCCESS" || event.request !== refs.get("request")) return;
+				params.refs.set("controller", null);
+				const options = updateCascaderChildren(currentOptions(params), event.path, toAreaPickerOptions(event.data));
+				refs.set("options", options);
+				context.set("options", options);
+				context.set("loading", []);
+				const value = resolveAreaPickerValue(options, context.get("base") === JSON.stringify(context.get("value")) && context.get("preview").length ? context.get("preview") : context.get("value"), params.prop("maxDepth"));
+				context.set("base", JSON.stringify(context.get("value")));
+				context.set("preview", value);
+				load(params, value, options);
+			},
+			error({ context, event, refs }) {
+				if (event.type !== "ERROR" || event.request !== refs.get("request")) return;
+				refs.set("controller", null);
+				context.set("loading", []);
+				context.set("error", event.path);
+			},
+			retry(params) {
+				const path = params.context.get("error");
+				if (path.length) load(params, path);
+			}
+		},
+		effects: { lifecycle(params) {
+			params.refs.set("active", true);
+			load(params, resolveAreaPickerValue(params.context.get("options"), params.prop("value") ?? params.prop("defaultValue") ?? [], params.prop("maxDepth")));
+			return () => {
+				params.refs.set("active", false);
+				params.refs.get("controller")?.abort();
+			};
+		} }
+	}
+});
+function connectAreaPicker(service, props) {
+	const options = service.context.get("options"), owner = service.context.get("value"), value = resolveAreaPickerValue(options, owner, depthOf(props));
+	const preview = resolveAreaPickerValue(options, service.context.get("base") === JSON.stringify(owner) && service.context.get("preview").length ? service.context.get("preview") : value, depthOf(props)), last = resolveCascaderPath(options, preview).at(-1);
+	const loading = service.context.get("loading").length > 0, error = service.context.get("error").length > 0;
+	const committedLast = resolveCascaderPath(options, value).at(-1);
+	const committedValid = !!committedLast && (committedLast.leaf === true || value.length === depthOf(props));
+	const valid = !!last && (last.leaf === true || preview.length === depthOf(props)) && !loading && !error;
+	const columns = [];
+	let level = options;
+	for (let depth = 0; depth < depthOf(props); depth++) {
+		columns.push({
+			label: props.columnLabels?.[depth] ?? [
+				"省",
+				"市",
+				"区"
+			][depth] ?? `第 ${depth + 1} 级`,
+			options: level.map((node) => ({
+				value: node.value,
+				label: node.label,
+				disabled: node.disabled
+			}))
+		});
+		const selected = level.find((node) => node.value === preview[depth]);
+		if (selected?.leaf) break;
+		level = selected?.children ?? [];
+	}
+	const notifyPreview = (v) => service.send({
+		type: "PREVIEW",
+		value: v
+	}), notifyCommit = (v) => service.send({
+		type: "COMMIT",
+		value: v
+	});
+	const rest = { ...props };
+	for (const key of [
+		"data",
+		"value",
+		"defaultValue",
+		"maxDepth",
+		"columnLabels",
+		"loadChildren",
+		"loadingText",
+		"errorText",
+		"retryText",
+		"name",
+		"onValueChange",
+		"onPreviewChange"
+	]) delete rest[key];
+	return {
+		value,
+		labels: details(options, value).labels,
+		previewValue: preview,
+		valid,
+		loading,
+		error,
+		statusText: error ? props.errorText ?? "地区加载失败" : loading ? props.loadingText ?? "地区加载中" : "",
+		retryText: props.retryText ?? "重试",
+		columns,
+		pickerProps: {
+			...rest,
+			id: props.id ? `${props.id}-picker` : void 0,
+			ariaLabel: props.ariaLabel ?? "选择地区",
+			columns,
+			value,
+			onPreviewChange: (d) => notifyPreview(d.value),
+			onValueChange: (d) => notifyCommit(d.value),
+			onOpenChange: (open) => {
+				service.send({ type: open ? "OPEN" : "RESET" });
+				props.onOpenChange?.(open);
+			}
+		},
+		notifyPreview,
+		notifyCommit,
+		retry: () => service.send({ type: "RETRY" }),
+		getRootProps: () => ({
+			lang: props.lang,
+			dir: props.dir,
+			"data-scope": "area-picker",
+			"data-part": "root",
+			"data-visual-target": "area-picker-root"
+		}),
+		getStatusProps: () => ({
+			"data-scope": "area-picker",
+			"data-part": "status",
+			role: error ? "alert" : "status",
+			hidden: !loading && !error
+		}),
+		getRetryProps: () => ({
+			type: "button",
+			hidden: !error,
+			onClick: () => service.send({ type: "RETRY" })
+		}),
+		getInputProps: () => ({
+			type: "hidden",
+			name: props.name,
+			value: value.join("/"),
+			disabled: !committedValid
+		})
+	};
+}
+//#endregion
+export { AREA_PICKER_PARTS, areaPickerMachine, connectAreaPicker, createAreaPickerProps, resolveAreaPickerValue, toAreaPickerOptions };
+
+//# sourceMappingURL=index.js.map

package/dist/area-picker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/area-picker/area-picker.ts"],"sourcesContent":["import { createMachine, type Machine, type Params, type Service } from \"@zag-js/core\";\nimport { normalizeCascaderOptions, resolveCascaderPath, updateCascaderChildren, type CascaderOption } from \"../cascader/cascader.js\";\nimport type { QwPickerProps } from \"../picker/picker.js\";\nimport type { PickerColumn, PickerValue } from \"../picker/selection-model.js\";\n\n/** Caller-owned region data. No national administrative dataset is bundled. Codes are opaque strings. */\nexport interface AreaPickerNode { code: string; label: string; disabled?: boolean; leaf?: boolean; children?: AreaPickerNode[] }\nexport interface AreaPickerChangeDetails { value: string[]; labels: string[]; path: AreaPickerNode[]; code: string | undefined }\nexport interface AreaPickerLoadDetails { node: AreaPickerNode; path: string[]; signal: AbortSignal }\nexport interface QwAreaPickerProps extends Omit<QwPickerProps, \"columns\" | \"value\" | \"defaultValue\" | \"onValueChange\" | \"onPreviewChange\"> {\n  data: readonly AreaPickerNode[];\n  /** Explicit locale boundary copied by the real Picker portal. */\n  lang?: string;\n  dir?: string;\n  value?: string[];\n  defaultValue?: string[];\n  /** Maximum hierarchy depth, default 3. Explicit leaf nodes may terminate earlier. */\n  maxDepth?: number;\n  columnLabels?: string[];\n  loadChildren?: (details: AreaPickerLoadDetails) => Promise<AreaPickerNode[]>;\n  loadingText?: string;\n  errorText?: string;\n  retryText?: string;\n  name?: string;\n  onValueChange?: (details: AreaPickerChangeDetails) => void;\n  onPreviewChange?: (details: AreaPickerChangeDetails) => void;\n}\nexport const AREA_PICKER_PARTS = [\"root\", \"status\", \"retry-trigger\", \"input\"] as const;\nexport function toAreaPickerOptions(data: readonly AreaPickerNode[]): CascaderOption[] {\n  return normalizeCascaderOptions(data.map(node => ({ value: node.code, label: node.label, disabled: node.disabled, leaf: node.leaf, children: node.children ? toAreaPickerOptions(node.children) : undefined })), \"AreaPicker\");\n}\nfunction toNode(node: CascaderOption): AreaPickerNode { return { code: node.value, label: node.label, disabled: node.disabled, leaf: node.leaf, children: node.children?.map(toNode) }; }\nconst depthOf = (props: QwAreaPickerProps) => Number.isInteger(props.maxDepth) && props.maxDepth! > 0 ? props.maxDepth! : 3;\n/** Fill enabled descendants; a disabled ancestor invalidates its entire branch. */\nexport function resolveAreaPickerValue(options: readonly CascaderOption[], value: readonly (string | null)[], maxDepth = 3): string[] {\n  const path: string[] = []; let level = options;\n  for (let depth = 0; depth < maxDepth; depth++) {\n    const selected = level.find(node => node.value === value[depth] && !node.disabled) ?? level.find(node => !node.disabled);\n    if (!selected) break;\n    path.push(selected.value);\n    if (selected.leaf) break;\n    level = selected.children ?? [];\n  }\n  return path;\n}\nfunction details(options: readonly CascaderOption[], value: string[]): AreaPickerChangeDetails {\n  const path = resolveCascaderPath(options, value).map(toNode);\n  return { value: [...value], labels: path.map(node => node.label), path, code: value.at(-1) };\n}\nexport interface QwAreaPickerSchema {\n  props: QwAreaPickerProps;\n  context: { value: string[]; preview: string[]; base: string; options: CascaderOption[]; loading: string[]; error: string[] };\n  refs: { controller: AbortController | null; active: boolean; request: number; options: CascaderOption[] | undefined };\n  state: \"idle\";\n  action: \"preview\" | \"commit\" | \"sync\" | \"success\" | \"error\" | \"retry\" | \"reset\" | \"open\";\n  effect: \"lifecycle\";\n  event: { type: \"PREVIEW\" | \"COMMIT\"; value: PickerValue } | { type: \"SYNC\" | \"RETRY\" | \"RESET\" | \"OPEN\" } | { type: \"SUCCESS\"; request: number; path: string[]; data: AreaPickerNode[] } | { type: \"ERROR\"; request: number; path: string[] };\n}\nexport type QwAreaPickerMachine = Machine<QwAreaPickerSchema>;\nexport type QwAreaPickerService = Service<QwAreaPickerSchema>;\nexport function createAreaPickerProps(props: QwAreaPickerProps): QwAreaPickerProps { toAreaPickerOptions(props.data ?? []); return { ...props, data: props.data ?? [], maxDepth: depthOf(props) }; }\ntype LoadParams = Pick<Params<QwAreaPickerSchema>, \"context\" | \"prop\" | \"refs\" | \"send\">;\nfunction invalidate({ context, refs }: LoadParams) { refs.get(\"controller\")?.abort(); refs.set(\"controller\", null); refs.set(\"request\", refs.get(\"request\") + 1); context.set(\"loading\", []); }\nfunction currentOptions({ context, refs }: LoadParams): CascaderOption[] { return refs.get(\"options\") ?? context.get(\"options\"); }\nfunction load(params: LoadParams, path: string[], options: CascaderOption[] = currentOptions(params)) {\n  const { context, prop, refs, send } = params, loader = prop(\"loadChildren\"), option = resolveCascaderPath(options, path).at(-1);\n  if (!loader || !option || option.disabled || option.leaf || option.children !== undefined || path.length >= (prop(\"maxDepth\") ?? 3)) return;\n  invalidate(params); const controller = new AbortController(), request = refs.get(\"request\"), sourceData = prop(\"data\"), sourceDepth = prop(\"maxDepth\"); refs.set(\"controller\", controller); context.set(\"loading\", path); context.set(\"error\", []);\n  // Deferred invocation also catches synchronous loader throws and validates data within the rejection chain.\n  Promise.resolve().then(() => { if (!refs.get(\"active\") || controller.signal.aborted || refs.get(\"request\") !== request || prop(\"data\") !== sourceData || prop(\"maxDepth\") !== sourceDepth || prop(\"loadChildren\") !== loader) return undefined; return loader({ node: toNode(option), path: [...path], signal: controller.signal }); }).then(data => { if (data === undefined) return undefined; toAreaPickerOptions(data); return data; }).then(data => { if (data !== undefined && refs.get(\"active\") && !controller.signal.aborted && refs.get(\"request\") === request) send({ type: \"SUCCESS\", request, path, data }); }).catch(() => { if (refs.get(\"active\") && !controller.signal.aborted) send({ type: \"ERROR\", request, path }); });\n}\nconst loaderIdentities = new WeakMap<NonNullable<QwAreaPickerProps[\"loadChildren\"]>, number>();\nlet nextLoaderIdentity = 0;\nfunction loaderIdentity(loader: QwAreaPickerProps[\"loadChildren\"]): number {\n  if (!loader) return 0;\n  const known = loaderIdentities.get(loader);\n  if (known !== undefined) return known;\n  const identity = ++nextLoaderIdentity; loaderIdentities.set(loader, identity); return identity;\n}\nexport const areaPickerMachine: QwAreaPickerMachine = createMachine<QwAreaPickerSchema>({\n  props: ({ props }) => createAreaPickerProps({ ...props, data: props.data ?? [] }), initialState: () => \"idle\", states: { idle: {} },\n  context: ({ bindable, prop }) => ({\n    value: bindable(() => ({ defaultValue: prop(\"defaultValue\") ?? [], value: prop(\"value\"), hash: JSON.stringify })),\n    preview: bindable<string[]>(() => ({ defaultValue: [], hash: JSON.stringify })), base: bindable(() => ({ defaultValue: \"\" })),\n    options: bindable(() => ({ defaultValue: toAreaPickerOptions(prop(\"data\") ?? []), hash: JSON.stringify })),\n    loading: bindable<string[]>(() => ({ defaultValue: [], hash: JSON.stringify })), error: bindable<string[]>(() => ({ defaultValue: [], hash: JSON.stringify })),\n  }), refs: () => ({ controller: null, active: false, request: 0, options: undefined }), effects: [\"lifecycle\"],\n  watch({ track, prop, send }) { track([() => JSON.stringify(prop(\"data\") ?? []), () => prop(\"maxDepth\"), () => loaderIdentity(prop(\"loadChildren\"))], () => send({ type: \"SYNC\" })); track([() => JSON.stringify(prop(\"value\"))], () => send({ type: \"OPEN\" })); track([() => prop(\"open\")], () => send({ type: prop(\"open\") ? \"OPEN\" : \"RESET\" })); },\n  on: { PREVIEW: { actions: [\"preview\"] }, COMMIT: { actions: [\"commit\"] }, SYNC: { actions: [\"sync\"] }, RETRY: { actions: [\"retry\"] }, RESET: { actions: [\"reset\"] }, OPEN: { actions: [\"open\"] }, SUCCESS: { actions: [\"success\"] }, ERROR: { actions: [\"error\"] } },\n  implementations: { actions: {\n    preview(params) {\n      const { context, prop, event } = params; if (event.type !== \"PREVIEW\") return;\n      const value = resolveAreaPickerValue(currentOptions(params), event.value, prop(\"maxDepth\"));\n      context.set(\"base\", JSON.stringify(context.get(\"value\"))); context.set(\"preview\", value); context.set(\"error\", []); invalidate(params); load(params, value);\n      prop(\"onPreviewChange\")?.(details(currentOptions(params), value));\n    },\n    commit(params) {\n      const { context, prop, event } = params;\n      if (event.type !== \"COMMIT\" || context.get(\"loading\").length || context.get(\"error\").length) return;\n      const options = currentOptions(params), value = resolveAreaPickerValue(options, event.value, prop(\"maxDepth\")), last = resolveCascaderPath(options, value).at(-1);\n      if (!last || (!last.leaf && value.length < (prop(\"maxDepth\") ?? 3))) return;\n      context.set(\"value\", value); context.set(\"preview\", []); prop(\"onValueChange\")?.(details(options, value));\n    },\n    sync(params) { invalidate(params); const options = toAreaPickerOptions(params.prop(\"data\")); params.refs.set(\"options\", options); params.context.set(\"options\", options); params.context.set(\"preview\", []); params.context.set(\"error\", []); const value = resolveAreaPickerValue(options, params.context.get(\"value\"), params.prop(\"maxDepth\")); load(params, value, options); },\n    reset(params) { invalidate(params); params.context.set(\"preview\", []); params.context.set(\"error\", []); },\n    open(params) { invalidate(params); params.context.set(\"preview\", []); params.context.set(\"error\", []); const value = resolveAreaPickerValue(currentOptions(params), params.context.get(\"value\"), params.prop(\"maxDepth\")); load(params, value); },\n    success(params) { const { context, event, refs } = params; if (event.type !== \"SUCCESS\" || event.request !== refs.get(\"request\")) return; params.refs.set(\"controller\", null); const options = updateCascaderChildren(currentOptions(params), event.path, toAreaPickerOptions(event.data)); refs.set(\"options\", options); context.set(\"options\", options); context.set(\"loading\", []); const draft = context.get(\"base\") === JSON.stringify(context.get(\"value\")) && context.get(\"preview\").length ? context.get(\"preview\") : context.get(\"value\"); const value = resolveAreaPickerValue(options, draft, params.prop(\"maxDepth\")); context.set(\"base\", JSON.stringify(context.get(\"value\"))); context.set(\"preview\", value); load(params, value, options); },\n    error({ context, event, refs }) { if (event.type !== \"ERROR\" || event.request !== refs.get(\"request\")) return; refs.set(\"controller\", null); context.set(\"loading\", []); context.set(\"error\", event.path); },\n    retry(params) { const path = params.context.get(\"error\"); if (path.length) load(params, path); },\n  }, effects: { lifecycle(params) { params.refs.set(\"active\", true); const value = resolveAreaPickerValue(params.context.get(\"options\"), params.prop(\"value\") ?? params.prop(\"defaultValue\") ?? [], params.prop(\"maxDepth\")); load(params, value); return () => { params.refs.set(\"active\", false); params.refs.get(\"controller\")?.abort(); }; } } },\n});\nexport interface QwAreaPickerApi {\n  value: string[]; labels: string[]; previewValue: string[]; valid: boolean; loading: boolean; error: boolean; statusText: string; retryText: string; columns: PickerColumn[]; pickerProps: QwPickerProps;\n  notifyPreview(value: PickerValue): void; notifyCommit(value: PickerValue): void; retry(): void;\n  getRootProps(): Record<string, string | undefined>;\n  getStatusProps(): Record<string, string | boolean>;\n  getRetryProps(): { type: \"button\"; hidden: boolean; onClick(): void };\n  getInputProps(): { type: \"hidden\"; name: string | undefined; value: string; disabled: boolean };\n}\nexport function connectAreaPicker(service: QwAreaPickerService, props: QwAreaPickerProps): QwAreaPickerApi {\n  const options = service.context.get(\"options\"), owner = service.context.get(\"value\"), value = resolveAreaPickerValue(options, owner, depthOf(props));\n  const draft = service.context.get(\"base\") === JSON.stringify(owner) && service.context.get(\"preview\").length ? service.context.get(\"preview\") : value;\n  const preview = resolveAreaPickerValue(options, draft, depthOf(props)), path = resolveCascaderPath(options, preview), last = path.at(-1);\n  const loading = service.context.get(\"loading\").length > 0, error = service.context.get(\"error\").length > 0;\n  const committedLast = resolveCascaderPath(options, value).at(-1);\n  const committedValid = !!committedLast && (committedLast.leaf === true || value.length === depthOf(props));\n  const valid = !!last && (last.leaf === true || preview.length === depthOf(props)) && !loading && !error;\n  const columns: PickerColumn[] = []; let level: readonly CascaderOption[] = options;\n  for (let depth = 0; depth < depthOf(props); depth++) {\n    columns.push({ label: props.columnLabels?.[depth] ?? [\"省\", \"市\", \"区\"][depth] ?? `第 ${depth + 1} 级`, options: level.map(node => ({ value: node.value, label: node.label, disabled: node.disabled })) });\n    const selected = level.find(node => node.value === preview[depth]); if (selected?.leaf) break; level = selected?.children ?? [];\n  }\n  const notifyPreview = (v: PickerValue) => service.send({ type: \"PREVIEW\", value: v }), notifyCommit = (v: PickerValue) => service.send({ type: \"COMMIT\", value: v });\n  const rest: Record<string, unknown> = { ...props }; for (const key of [\"data\", \"value\", \"defaultValue\", \"maxDepth\", \"columnLabels\", \"loadChildren\", \"loadingText\", \"errorText\", \"retryText\", \"name\", \"onValueChange\", \"onPreviewChange\"]) delete rest[key];\n  return { value, labels: details(options, value).labels, previewValue: preview, valid, loading, error, statusText: error ? props.errorText ?? \"地区加载失败\" : loading ? props.loadingText ?? \"地区加载中\" : \"\", retryText: props.retryText ?? \"重试\", columns,\n    pickerProps: { ...rest, id: props.id ? `${props.id}-picker` : undefined, ariaLabel: props.ariaLabel ?? \"选择地区\", columns, value, onPreviewChange: d => notifyPreview(d.value), onValueChange: d => notifyCommit(d.value), onOpenChange: open => { service.send({ type: open ? \"OPEN\" : \"RESET\" }); props.onOpenChange?.(open); } }, notifyPreview, notifyCommit, retry: () => service.send({ type: \"RETRY\" }),\n    getRootProps: () => ({ lang: props.lang, dir: props.dir, \"data-scope\": \"area-picker\", \"data-part\": \"root\", \"data-visual-target\": \"area-picker-root\" }),\n    getStatusProps: () => ({ \"data-scope\": \"area-picker\", \"data-part\": \"status\", role: error ? \"alert\" : \"status\", hidden: !loading && !error }),\n    getRetryProps: () => ({ type: \"button\", hidden: !error, onClick: () => service.send({ type: \"RETRY\" }) }),\n    getInputProps: () => ({ type: \"hidden\", name: props.name, value: value.join(\"/\"), disabled: !committedValid }),\n  };\n}\n"],"mappings":"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"}

package/dist/aria-description-CimD2M_C.js

@@ -0,0 +1,13 @@
+//#region src/aria-description.ts
+/** Preserve control-owned descriptions while linking distinct external help/errors. */
+function mergeDescriptionIds(...values) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const value of values) if (typeof value === "string") {
+		for (const id of value.split(/\s+/)) if (id) ids.add(id);
+	}
+	return ids.size ? [...ids].join(" ") : void 0;
+}
+//#endregion
+export { mergeDescriptionIds as t };
+
+//# sourceMappingURL=aria-description-CimD2M_C.js.map

package/dist/aria-description-CimD2M_C.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-description-CimD2M_C.js","names":[],"sources":["../src/aria-description.ts"],"sourcesContent":["/** Preserve control-owned descriptions while linking distinct external help/errors. */\nexport function mergeDescriptionIds(...values: readonly (string | undefined)[]): string | undefined {\n  const ids = new Set<string>();\n  for (const value of values) if (typeof value === \"string\") for (const id of value.split(/\\s+/)) if (id) ids.add(id);\n  return ids.size ? [...ids].join(\" \") : undefined;\n}\n"],"mappings":";;AACA,SAAgB,oBAAoB,GAAG,QAA6D;CAClG,MAAM,sBAAM,IAAI,IAAY;CAC5B,KAAK,MAAM,SAAS,QAAQ,IAAI,OAAO,UAAU;OAAe,MAAM,MAAM,MAAM,MAAM,KAAK,GAAG,IAAI,IAAI,IAAI,IAAI,EAAE;CAAA;CAClH,OAAO,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,KAAA;AACzC"}

package/dist/aria-description.d.ts

@@ -0,0 +1,2 @@
+/** Preserve control-owned descriptions while linking distinct external help/errors. */
+export declare function mergeDescriptionIds(...values: readonly (string | undefined)[]): string | undefined;

package/dist/avatar/avatar-load.d.ts

@@ -0,0 +1,76 @@
+import { type Machine, type Service } from "@zag-js/core";
+import type { AvatarLoadStatus } from "./avatar.js";
+/** A render request does not become active until its resource is committed. */
+export interface ImageRequestFrame {
+    readonly epoch: number;
+    readonly src: string;
+    readonly active: boolean;
+}
+export interface ImageRequestDescriptor {
+    src: string;
+    active: boolean;
+}
+export interface ImageResourceSnapshot {
+    srcAttribute: string | null;
+    complete: boolean;
+    naturalWidth: number;
+}
+export interface ImageRequestResult {
+    epoch: number;
+    src: string;
+    status: AvatarLoadStatus;
+}
+export interface ImageResourceBinding {
+    commit(snapshot: ImageResourceSnapshot): void;
+    snapshot(snapshot: ImageResourceSnapshot): void;
+    detach(): void;
+}
+export interface ImageRequestFrames {
+    create(src: string | undefined, active: boolean): ImageRequestFrame;
+    resolve(descriptor: ImageRequestDescriptor): ImageRequestFrame;
+}
+/** Per-instance monotonic identity; aborted renders never activate a frame. */
+export declare function createImageRequestFrames(initial?: ImageRequestFrame): ImageRequestFrames;
+export declare function getImageRequestStatus(frame: ImageRequestFrame, result?: ImageRequestResult): AvatarLoadStatus;
+export interface QwAvatarLoadProps {
+    frame: ImageRequestFrame;
+}
+type ResourceEvent = {
+    type: "RESOURCE.COMMIT" | "RESOURCE.SNAPSHOT";
+    frame: ImageRequestFrame;
+    session: number;
+    snapshot: ImageResourceSnapshot;
+} | {
+    type: "RESOURCE.DETACH";
+    frame: ImageRequestFrame;
+    session: number;
+};
+export interface QwAvatarLoadSchema {
+    props: QwAvatarLoadProps;
+    context: {
+        result: ImageRequestResult | undefined;
+    };
+    refs: {
+        active: boolean;
+        session: number;
+        committed: ImageRequestFrame | undefined;
+    };
+    state: "ready";
+    effect: "lifecycle";
+    action: "commit" | "snapshot" | "detach";
+    event: ResourceEvent;
+}
+export type QwAvatarLoadService = Service<QwAvatarLoadSchema>;
+export type QwAvatarLoadMachine = Machine<QwAvatarLoadSchema>;
+/** Pure Zag state: resource bridges supply scalars, never DOM objects. */
+export declare const avatarLoadMachine: QwAvatarLoadMachine;
+export interface QwAvatarLoadApi {
+    readonly frame: ImageRequestFrame;
+    readonly status: AvatarLoadStatus;
+    readonly imageKey: string;
+    bindResource(): ImageResourceBinding;
+}
+/** A committed renderer binds without reading reactive result state. */
+export declare function createAvatarResourceBinding(service: QwAvatarLoadService, frame: ImageRequestFrame): ImageResourceBinding;
+export declare function connectAvatarLoad(service: QwAvatarLoadService, frame?: ImageRequestFrame): QwAvatarLoadApi;
+export {};

package/dist/avatar/avatar.d.ts

@@ -1,9 +1,9 @@
 /**
  * Avatar 的跨框架行为契约。
  *
- * Avatar 是无状态的 Prototype A：Core 归一化 props、推导降级模式和徽标状态，
+ * Core 归一化 props、推导降级模式和徽标状态；Zag 管图片请求生命周期。
  * 生成 root/image/badge 的 data 属性。React/Vue 适配器只投影内容通道并渲染固定 DOM。
- * 图片加载状态通过 `data-load-status` 属性由 CSS 声明式管理，不参与 Core 状态归一化。
+ * 图片请求生命周期由同目录的纯 Zag load machine 决定，适配器仅运输资源标量快照。
  */
 export declare const AVATAR_SHAPES: readonly ["circle", "square"];
 export declare const AVATAR_SIZES: readonly ["s", "m", "l"];
@@ -57,6 +57,8 @@ export interface AvatarContentPresence {
     /** 是否提供 `badge` 配置。 */
     hasBadge: boolean;
 }
+/** Frameworks only report whether a content channel was supplied. */
+export declare function getAvatarContentPresence(props: QwAvatarProps, channels: Readonly<Record<string, boolean>>): AvatarContentPresence;
 /** 内容展示模式，按优先级互斥推导：children > image > icon > name。 */
 export type DisplayMode = "children" | "image" | "icon" | "initials";
 /** 图片加载失败时的降级展示模式。 */
@@ -118,6 +120,7 @@ export interface AvatarBadgeProps {
     "data-part": "badge";
     "data-badge-type": BadgeType;
     "aria-label"?: string;
+    role?: "img";
 }
 /**
  * 从名称提取文字缩写。
@@ -128,13 +131,27 @@ export interface AvatarBadgeProps {
  * - 上限 2 字符
  * - 空字符串返回空字符串
  *
- * 使用 `Array.from()` 按码点迭代，不按 `charCodeAt` 截断。
+ * 按 grapheme 边界截取，不切开组合字符和 emoji 序列。
  */
 export declare function extractInitials(name: string): string;
 /** 将公开输入和内容通道归一化为唯一的跨框架状态。 */
 export declare function resolveAvatarState(props?: QwAvatarProps, presence?: AvatarContentPresence): ResolvedAvatarState;
 /** 将归一化结果转成 root 属性。 */
-export declare function getAvatarRootProps(state: ResolvedAvatarState): AvatarRootProps;
+export interface AvatarRootOptions {
+    name?: string;
+    badge?: BadgeConfig;
+    loadStatus?: AvatarLoadStatus;
+    lang?: string;
+    dir?: string;
+    hidden?: boolean;
+}
+export declare function getAvatarRootProps(state: ResolvedAvatarState, options?: AvatarRootOptions): AvatarRootProps & Pick<AvatarRootOptions, "lang" | "dir" | "hidden">;
+export declare function getAvatarImageDescriptor(state: ResolvedAvatarState, src?: string): {
+    src: string;
+    active: boolean;
+};
+export declare function getAvatarRootStyle(state: ResolvedAvatarState): Record<string, string> | undefined;
+export declare function getAvatarBadgeContent(state: ResolvedAvatarState): string;
 /** 将归一化结果转成图片包装元素的属性。 */
 export declare function getAvatarImageProps(_state: ResolvedAvatarState): AvatarImageProps;
 /** 将归一化结果转成 img 元素的属性。 */
@@ -142,4 +159,4 @@ export declare function getAvatarImageElementProps(_state: ResolvedAvatarState):
 /** 将归一化结果转成降级内容元素的属性。 */
 export declare function getAvatarFallbackProps(_state: ResolvedAvatarState): AvatarFallbackProps;
 /** 将归一化结果转成徽标元素的属性。 */
-export declare function getAvatarBadgeProps(state: ResolvedAvatarState): AvatarBadgeProps;
+export declare function getAvatarBadgeProps(state: ResolvedAvatarState, badge?: BadgeConfig): AvatarBadgeProps;

package/dist/avatar/index.d.ts

@@ -1 +1,2 @@
 export * from "./avatar.js";
+export * from "./avatar-load.js";