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

package/dist/avatar/index.js

@@ -1,10 +1,11 @@
+import { a as getImageRequestStatus, i as createImageRequestFrames, n as connectAvatarLoad, r as createAvatarResourceBinding, t as avatarLoadMachine } from "../avatar-load-w9dq05oV.js";
 //#region src/avatar/avatar.ts
 /**
 * Avatar 的跨框架行为契约。
 *
-* Avatar 是无状态的 Prototype A：Core 归一化 props、推导降级模式和徽标状态，
+* Core 归一化 props、推导降级模式和徽标状态；Zag 管图片请求生命周期。
 * 生成 root/image/badge 的 data 属性。React/Vue 适配器只投影内容通道并渲染固定 DOM。
-* 图片加载状态通过 `data-load-status` 属性由 CSS 声明式管理，不参与 Core 状态归一化。
+* 图片请求生命周期由同目录的纯 Zag load machine 决定，适配器仅运输资源标量快照。
 */
 const AVATAR_SHAPES = ["circle", "square"];
 const AVATAR_SIZES = [
@@ -25,6 +26,17 @@ const AVATAR_LOAD_STATUS = [
 ];
 const AVATAR_BADGE_TYPES = ["dot", "number"];
 const BADGE_COUNT_MAX = 99;
+/** Frameworks only report whether a content channel was supplied. */
+function getAvatarContentPresence(props, channels) {
+	return {
+		hasImage: typeof props.src === "string" && !!props.src,
+		hasName: typeof props.name === "string" && !!props.name.trim(),
+		hasFallback: !!channels.fallback,
+		hasIcon: !!channels.icon,
+		hasChildren: !!channels.default,
+		hasBadge: props.badge != null
+	};
+}
 const EMPTY_PRESENCE = {
 	hasImage: false,
 	hasName: false,
@@ -42,33 +54,35 @@ const EMPTY_PRESENCE = {
 * - 上限 2 字符
 * - 空字符串返回空字符串
 *
-* 使用 `Array.from()` 按码点迭代，不按 `charCodeAt` 截断。
+* 按 grapheme 边界截取，不切开组合字符和 emoji 序列。
 */
 function extractInitials(name) {
 	if (!name) return "";
-	const chars = Array.from(name).filter((ch) => ch.trim() !== "");
+	const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" });
+	const chars = Array.from(segmenter.segment(name), ({ segment }) => segment).filter((ch) => ch.trim() !== "");
 	if (chars.length === 0) return "";
-	const isCjk = (ch) => /[\u{4E00}-\u{9FFF}\u{3040}-\u{30FF}\u{AC00}-\u{D7AF}]/u.test(ch);
+	const isCjk = (ch) => /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u.test(ch);
 	if (chars.every(isCjk)) return chars[0];
-	return chars.slice(0, 2).join("").toUpperCase();
+	const result = chars.slice(0, 2).join("").toUpperCase();
+	return Array.from(segmenter.segment(result), ({ segment }) => segment).slice(0, 2).join("");
 }
 /** 将公开输入和内容通道归一化为唯一的跨框架状态。 */
 function resolveAvatarState(props = {}, presence = EMPTY_PRESENCE) {
 	const hasImage = presence.hasImage;
 	const hasName = presence.hasName;
 	const decorative = props.decorative ?? false;
-	const bg = props.bg;
+	const bg = typeof props.bg === "string" ? props.bg : void 0;
 	const displayMode = presence.hasChildren ? "children" : hasImage ? "image" : presence.hasIcon ? "icon" : hasName ? "initials" : "icon";
 	const fallbackMode = presence.hasFallback ? "custom" : presence.hasIcon ? "icon" : hasName ? "initials" : "icon";
 	const initials = hasName && props.name ? extractInitials(props.name) : void 0;
-	const hasBadge = presence.hasBadge;
+	const hasBadge = presence.hasBadge && !!props.badge && AVATAR_BADGE_TYPES.includes(props.badge.type);
 	const badgeType = hasBadge ? props.badge?.type : void 0;
 	let badgeDisplayCount;
 	let badgeOverflow = false;
 	let badgeHidden = false;
 	if (hasBadge && badgeType === "number") {
 		const rawCount = props.badge?.count ?? 0;
-		if (rawCount <= 0) {
+		if (typeof rawCount !== "number" || !Number.isFinite(rawCount) || rawCount <= 0) {
 			badgeHidden = true;
 			badgeDisplayCount = void 0;
 		} else if (rawCount > 99) {
@@ -77,8 +91,8 @@ function resolveAvatarState(props = {}, presence = EMPTY_PRESENCE) {
 		} else badgeDisplayCount = rawCount;
 	}
 	return {
-		shape: props.shape ?? "circle",
-		size: props.size ?? "m",
+		shape: AVATAR_SHAPES.includes(props.shape) ? props.shape : "circle",
+		size: AVATAR_SIZES.includes(props.size) ? props.size : "m",
 		hasImage,
 		hasName,
 		decorative,
@@ -93,15 +107,14 @@ function resolveAvatarState(props = {}, presence = EMPTY_PRESENCE) {
 		badgeHidden
 	};
 }
-/** 将归一化结果转成 root 属性。 */
-function getAvatarRootProps(state) {
+function getAvatarRootProps(state, options = {}) {
 	const props = {
 		"data-scope": "avatar",
 		"data-part": "root",
 		"data-shape": state.shape,
 		"data-size": state.size,
 		"data-display": state.displayMode,
-		"data-load-status": state.displayMode === "image" ? "loading" : "error",
+		"data-load-status": state.displayMode === "image" ? options.loadStatus ?? "loading" : "error",
 		"data-fallback": state.fallbackMode
 	};
 	if (state.decorative) {
@@ -112,7 +125,28 @@ function getAvatarRootProps(state) {
 		props["data-has-badge"] = "true";
 		props["data-badge-type"] = state.badgeType;
 	}
-	return props;
+	if (!state.decorative && state.hasName && options.name) {
+		const label = state.hasBadge && typeof options.badge?.ariaLabel === "string" ? options.badge.ariaLabel.trim() : "";
+		props["aria-label"] = label ? `${options.name}, ${label}` : options.name;
+	}
+	return {
+		...props,
+		...options.lang === void 0 ? {} : { lang: options.lang },
+		...options.dir === void 0 ? {} : { dir: options.dir },
+		...options.hidden === void 0 ? {} : { hidden: options.hidden }
+	};
+}
+function getAvatarImageDescriptor(state, src) {
+	return {
+		src: typeof src === "string" ? src : "",
+		active: state.displayMode === "image" && state.hasImage
+	};
+}
+function getAvatarRootStyle(state) {
+	return state.bg ? { "--qw-avatar-bg": state.bg } : void 0;
+}
+function getAvatarBadgeContent(state) {
+	return state.badgeType === "number" && state.hasBadge ? `${state.badgeDisplayCount}${state.badgeOverflow ? "+" : ""}` : "";
 }
 /** 将归一化结果转成图片包装元素的属性。 */
 function getAvatarImageProps(_state) {
@@ -137,14 +171,19 @@ function getAvatarFallbackProps(_state) {
 	};
 }
 /** 将归一化结果转成徽标元素的属性。 */
-function getAvatarBadgeProps(state) {
-	return {
+function getAvatarBadgeProps(state, badge) {
+	const props = {
 		"data-scope": "avatar",
 		"data-part": "badge",
 		"data-badge-type": state.badgeType ?? "dot"
 	};
+	if (typeof badge?.ariaLabel === "string" && badge.ariaLabel.trim()) {
+		props.role = "img";
+		props["aria-label"] = badge.ariaLabel;
+	}
+	return props;
 }
 //#endregion
-export { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AVATAR_SIZES, BADGE_COUNT_MAX, extractInitials, getAvatarBadgeProps, getAvatarFallbackProps, getAvatarImageElementProps, getAvatarImageProps, getAvatarRootProps, resolveAvatarState };
+export { AVATAR_BADGE_TYPES, AVATAR_LOAD_STATUS, AVATAR_PARTS, AVATAR_SHAPES, AVATAR_SIZES, BADGE_COUNT_MAX, avatarLoadMachine, connectAvatarLoad, createAvatarResourceBinding, createImageRequestFrames, extractInitials, getAvatarBadgeContent, getAvatarBadgeProps, getAvatarContentPresence, getAvatarFallbackProps, getAvatarImageDescriptor, getAvatarImageElementProps, getAvatarImageProps, getAvatarRootProps, getAvatarRootStyle, getImageRequestStatus, resolveAvatarState };
 
 //# sourceMappingURL=index.js.map

package/dist/avatar/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/avatar/avatar.ts"],"sourcesContent":["/**\n * Avatar 的跨框架行为契约。\n *\n * Avatar 是无状态的 Prototype A：Core 归一化 props、推导降级模式和徽标状态，\n * 生成 root/image/badge 的 data 属性。React/Vue 适配器只投影内容通道并渲染固定 DOM。\n * 图片加载状态通过 `data-load-status` 属性由 CSS 声明式管理，不参与 Core 状态归一化。\n */\n\nexport const AVATAR_SHAPES = [\"circle\", \"square\"] as const;\nexport const AVATAR_SIZES = [\"s\", \"m\", \"l\"] as const;\nexport const AVATAR_PARTS = [\"root\", \"image\", \"fallback\", \"badge\"] as const;\nexport const AVATAR_LOAD_STATUS = [\"loading\", \"loaded\", \"error\"] as const;\nexport const AVATAR_BADGE_TYPES = [\"dot\", \"number\"] as const;\nexport const BADGE_COUNT_MAX = 99;\n\nexport type AvatarShape = (typeof AVATAR_SHAPES)[number];\nexport type AvatarSize = (typeof AVATAR_SIZES)[number];\nexport type AvatarPart = (typeof AVATAR_PARTS)[number];\nexport type AvatarLoadStatus = (typeof AVATAR_LOAD_STATUS)[number];\nexport type BadgeType = (typeof AVATAR_BADGE_TYPES)[number];\n\n/** 徽标配置（双栈共享标量，内容通道不进入 Core）。 */\nexport interface BadgeConfig {\n  /** 徽标类型。 */\n  type: BadgeType;\n  /** 数字徽标的数值。 */\n  count?: number;\n  /** 徽标无障碍标签。 */\n  ariaLabel?: string;\n}\n\n/** 双栈共享的标量 props；框架特有的内容通道不进入 Core。 */\nexport interface QwAvatarProps {\n  /** 图片源地址。空字符串或 undefined 时不渲染 img，直接进入降级。 */\n  src?: string;\n  /** 名称，用于提取缩写和 aria-label。 */\n  name?: string;\n  /** 外形，默认 `circle`。 */\n  shape?: AvatarShape;\n  /** 尺寸，默认 `m`。 */\n  size?: AvatarSize;\n  /** 装饰模式（从辅助技术隐藏）。 */\n  decorative?: boolean;\n  /** 自定义背景色，设置后覆盖所有展示形式的默认背景色。 */\n  bg?: string;\n  /** 徽标配置。 */\n  badge?: BadgeConfig;\n}\n\n/** 由各框架的内容通道存在性计算；不检查 DOM 或 VNode 内容。 */\nexport interface AvatarContentPresence {\n  /** 是否提供有效 `src`（非空字符串）。 */\n  hasImage: boolean;\n  /** 是否提供 `name`。 */\n  hasName: boolean;\n  /** 是否提供自定义降级内容（`fallback` prop / `#fallback` slot）。 */\n  hasFallback: boolean;\n  /** 是否提供自定义图标内容（`icon` prop / `#icon` slot）。 */\n  hasIcon: boolean;\n  /** 是否提供子元素（`children` / 默认 slot）。 */\n  hasChildren: boolean;\n  /** 是否提供 `badge` 配置。 */\n  hasBadge: boolean;\n}\n\n/** 内容展示模式，按优先级互斥推导：children > image > icon > name。 */\nexport type DisplayMode = \"children\" | \"image\" | \"icon\" | \"initials\";\n\n/** 图片加载失败时的降级展示模式。 */\nexport type FallbackMode = \"custom\" | \"initials\" | \"icon\";\n\n/** 适配器唯一可消费的归一化结果。 */\nexport interface ResolvedAvatarState {\n  shape: AvatarShape;\n  size: AvatarSize;\n  hasImage: boolean;\n  hasName: boolean;\n  decorative: boolean;\n  /** 用户传入的自定义背景色（undefined 时使用默认分色逻辑）。 */\n  bg: string | undefined;\n  /** 互斥展示模式：children > image > icon > name > default-icon。 */\n  displayMode: DisplayMode;\n  /** 图片加载失败时的降级模式（仅 displayMode=\"image\" 时有效）。 */\n  fallbackMode: FallbackMode;\n  initials: string | undefined;\n  hasBadge: boolean;\n  badgeType: BadgeType | undefined;\n  badgeOverflow: boolean;\n  badgeDisplayCount: number | undefined;\n  badgeHidden: boolean;\n}\n\n/** Core 生成、由适配器覆盖到根元素的属性。 */\nexport interface AvatarRootProps {\n  \"data-scope\": \"avatar\";\n  \"data-part\": \"root\";\n  \"data-shape\": AvatarShape;\n  \"data-size\": AvatarSize;\n  \"data-display\": DisplayMode;\n  \"data-load-status\": AvatarLoadStatus;\n  \"data-fallback\": FallbackMode;\n  role?: \"img\";\n  \"aria-label\"?: string;\n  \"aria-hidden\"?: \"true\";\n  \"data-has-badge\"?: \"true\";\n  \"data-badge-type\"?: BadgeType;\n}\n\n/** Core 生成、由适配器覆盖到图片包装元素的属性。 */\nexport interface AvatarImageProps {\n  \"data-scope\": \"avatar\";\n  \"data-part\": \"image\";\n}\n\n/** Core 生成、由适配器覆盖到 img 元素的属性。 */\nexport interface AvatarImageElementProps {\n  alt: \"\";\n  loading: \"lazy\";\n}\n\n/** Core 生成、由适配器覆盖到降级内容元素的属性。 */\nexport interface AvatarFallbackProps {\n  \"data-scope\": \"avatar\";\n  \"data-part\": \"fallback\";\n  \"aria-hidden\": \"true\";\n}\n\n/** Core 生成、由适配器覆盖到徽标元素的属性。 */\nexport interface AvatarBadgeProps {\n  \"data-scope\": \"avatar\";\n  \"data-part\": \"badge\";\n  \"data-badge-type\": BadgeType;\n  \"aria-label\"?: string;\n}\n\nconst EMPTY_PRESENCE: AvatarContentPresence = {\n  hasImage: false,\n  hasName: false,\n  hasFallback: false,\n  hasIcon: false,\n  hasChildren: false,\n  hasBadge: false,\n};\n\n/**\n * 从名称提取文字缩写。\n *\n * - 纯 CJK（汉字/假名/谚文）取首字\n * - 纯拉丁取前 2 字符大写\n * - 混合取前 2 字符\n * - 上限 2 字符\n * - 空字符串返回空字符串\n *\n * 使用 `Array.from()` 按码点迭代，不按 `charCodeAt` 截断。\n */\nexport function extractInitials(name: string): string {\n  if (!name) return \"\";\n  const chars = Array.from(name).filter((ch) => ch.trim() !== \"\");\n  if (chars.length === 0) return \"\";\n\n  const isCjk = (ch: string) => /[\\u{4E00}-\\u{9FFF}\\u{3040}-\\u{30FF}\\u{AC00}-\\u{D7AF}]/u.test(ch);\n  const allCjk = chars.every(isCjk);\n\n  if (allCjk) {\n    return chars[0]!;\n  }\n\n  const result = chars.slice(0, 2).join(\"\").toUpperCase();\n  return result;\n}\n\n/** 将公开输入和内容通道归一化为唯一的跨框架状态。 */\nexport function resolveAvatarState(\n  props: QwAvatarProps = {},\n  presence: AvatarContentPresence = EMPTY_PRESENCE,\n): ResolvedAvatarState {\n  const hasImage = presence.hasImage;\n  const hasName = presence.hasName;\n  const decorative = props.decorative ?? false;\n  const bg = props.bg;\n\n  // 互斥展示优先级：children > image > icon > name > default-icon\n  const displayMode: DisplayMode = presence.hasChildren\n    ? \"children\"\n    : hasImage\n      ? \"image\"\n      : presence.hasIcon\n        ? \"icon\"\n        : hasName\n          ? \"initials\"\n          : \"icon\"; // 默认：展示 User 图标\n\n  // 图片加载失败时的降级模式（仅 displayMode=\"image\" 时有效）\n  // 降级优先级：fallback prop > icon > name > default-icon\n  const fallbackMode: FallbackMode = presence.hasFallback\n    ? \"custom\"\n    : presence.hasIcon\n      ? \"icon\"\n      : hasName\n        ? \"initials\"\n        : \"icon\";\n\n  const initials = hasName && props.name ? extractInitials(props.name) : undefined;\n\n  // 徽标逻辑\n  const hasBadge = presence.hasBadge;\n  const badgeType = hasBadge ? props.badge?.type : undefined;\n\n  let badgeDisplayCount: number | undefined;\n  let badgeOverflow = false;\n  let badgeHidden = false;\n\n  if (hasBadge && badgeType === \"number\") {\n    const rawCount = props.badge?.count ?? 0;\n    if (rawCount <= 0) {\n      badgeHidden = true;\n      badgeDisplayCount = undefined;\n    } else if (rawCount > BADGE_COUNT_MAX) {\n      badgeOverflow = true;\n      badgeDisplayCount = BADGE_COUNT_MAX;\n    } else {\n      badgeDisplayCount = rawCount;\n    }\n  }\n\n  return {\n    shape: props.shape ?? \"circle\",\n    size: props.size ?? \"m\",\n    hasImage,\n    hasName,\n    decorative,\n    bg,\n    displayMode,\n    fallbackMode,\n    initials,\n    hasBadge: hasBadge && !badgeHidden,\n    badgeType,\n    badgeOverflow,\n    badgeDisplayCount,\n    badgeHidden,\n  };\n}\n\n/** 将归一化结果转成 root 属性。 */\nexport function getAvatarRootProps(state: ResolvedAvatarState): AvatarRootProps {\n  const props: AvatarRootProps = {\n    \"data-scope\": \"avatar\",\n    \"data-part\": \"root\",\n    \"data-shape\": state.shape,\n    \"data-size\": state.size,\n    \"data-display\": state.displayMode,\n    \"data-load-status\": state.displayMode === \"image\" ? \"loading\" : \"error\",\n    \"data-fallback\": state.fallbackMode,\n  };\n\n  // aria 策略：\n  // - decorative → aria-hidden=\"true\" + role=\"img\"（AT 忽略）\n  // - 有 name → role=\"img\" + aria-label（由适配器设置）\n  // - 无 name 且非 decorative → 不设 role（避免 role-img-alt 违规）\n  if (state.decorative) {\n    props[\"aria-hidden\"] = \"true\";\n    props[\"role\"] = \"img\";\n  } else if (state.hasName) {\n    props[\"role\"] = \"img\";\n    // aria-label 由适配器从 name 设置（Core 不持有 name 的运行时值）\n  }\n\n  if (state.hasBadge && state.badgeType) {\n    props[\"data-has-badge\"] = \"true\";\n    props[\"data-badge-type\"] = state.badgeType;\n  }\n\n  return props;\n}\n\n/** 将归一化结果转成图片包装元素的属性。 */\nexport function getAvatarImageProps(_state: ResolvedAvatarState): AvatarImageProps {\n  return {\n    \"data-scope\": \"avatar\",\n    \"data-part\": \"image\",\n  };\n}\n\n/** 将归一化结果转成 img 元素的属性。 */\nexport function getAvatarImageElementProps(\n  _state: ResolvedAvatarState,\n): AvatarImageElementProps {\n  return {\n    alt: \"\",\n    loading: \"lazy\",\n  };\n}\n\n/** 将归一化结果转成降级内容元素的属性。 */\nexport function getAvatarFallbackProps(\n  _state: ResolvedAvatarState,\n): AvatarFallbackProps {\n  return {\n    \"data-scope\": \"avatar\",\n    \"data-part\": \"fallback\",\n    \"aria-hidden\": \"true\",\n  };\n}\n\n/** 将归一化结果转成徽标元素的属性。 */\nexport function getAvatarBadgeProps(state: ResolvedAvatarState): AvatarBadgeProps {\n  const props: AvatarBadgeProps = {\n    \"data-scope\": \"avatar\",\n    \"data-part\": \"badge\",\n    \"data-badge-type\": state.badgeType ?? \"dot\",\n  };\n\n  // aria-label 来自 badge.ariaLabel，由适配器透传\n  return props;\n}\n"],"mappings":";;;;;;;;AAQA,MAAa,gBAAgB,CAAC,UAAU,QAAQ;AAChD,MAAa,eAAe;CAAC;CAAK;CAAK;AAAG;AAC1C,MAAa,eAAe;CAAC;CAAQ;CAAS;CAAY;AAAO;AACjE,MAAa,qBAAqB;CAAC;CAAW;CAAU;AAAO;AAC/D,MAAa,qBAAqB,CAAC,OAAO,QAAQ;AAClD,MAAa,kBAAkB;AA0H/B,MAAM,iBAAwC;CAC5C,UAAU;CACV,SAAS;CACT,aAAa;CACb,SAAS;CACT,aAAa;CACb,UAAU;AACZ;;;;;;;;;;;;AAaA,SAAgB,gBAAgB,MAAsB;CACpD,IAAI,CAAC,MAAM,OAAO;CAClB,MAAM,QAAQ,MAAM,KAAK,IAAI,CAAC,CAAC,QAAQ,OAAO,GAAG,KAAK,MAAM,EAAE;CAC9D,IAAI,MAAM,WAAW,GAAG,OAAO;CAE/B,MAAM,SAAS,OAAe,yDAAyD,KAAK,EAAE;CAG9F,IAFe,MAAM,MAAM,KAElB,GACP,OAAO,MAAM;CAIf,OADe,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,YAC9B;AACd;;AAGA,SAAgB,mBACd,QAAuB,CAAC,GACxB,WAAkC,gBACb;CACrB,MAAM,WAAW,SAAS;CAC1B,MAAM,UAAU,SAAS;CACzB,MAAM,aAAa,MAAM,cAAc;CACvC,MAAM,KAAK,MAAM;CAGjB,MAAM,cAA2B,SAAS,cACtC,aACA,WACE,UACA,SAAS,UACP,SACA,UACE,aACA;CAIV,MAAM,eAA6B,SAAS,cACxC,WACA,SAAS,UACP,SACA,UACE,aACA;CAER,MAAM,WAAW,WAAW,MAAM,OAAO,gBAAgB,MAAM,IAAI,IAAI,KAAA;CAGvE,MAAM,WAAW,SAAS;CAC1B,MAAM,YAAY,WAAW,MAAM,OAAO,OAAO,KAAA;CAEjD,IAAI;CACJ,IAAI,gBAAgB;CACpB,IAAI,cAAc;CAElB,IAAI,YAAY,cAAc,UAAU;EACtC,MAAM,WAAW,MAAM,OAAO,SAAS;EACvC,IAAI,YAAY,GAAG;GACjB,cAAc;GACd,oBAAoB,KAAA;EACtB,OAAO,IAAI,WAAA,IAA4B;GACrC,gBAAgB;GAChB,oBAAA;EACF,OACE,oBAAoB;CAExB;CAEA,OAAO;EACL,OAAO,MAAM,SAAS;EACtB,MAAM,MAAM,QAAQ;EACpB;EACA;EACA;EACA;EACA;EACA;EACA;EACA,UAAU,YAAY,CAAC;EACvB;EACA;EACA;EACA;CACF;AACF;;AAGA,SAAgB,mBAAmB,OAA6C;CAC9E,MAAM,QAAyB;EAC7B,cAAc;EACd,aAAa;EACb,cAAc,MAAM;EACpB,aAAa,MAAM;EACnB,gBAAgB,MAAM;EACtB,oBAAoB,MAAM,gBAAgB,UAAU,YAAY;EAChE,iBAAiB,MAAM;CACzB;CAMA,IAAI,MAAM,YAAY;EACpB,MAAM,iBAAiB;EACvB,MAAM,UAAU;CAClB,OAAO,IAAI,MAAM,SACf,MAAM,UAAU;CAIlB,IAAI,MAAM,YAAY,MAAM,WAAW;EACrC,MAAM,oBAAoB;EAC1B,MAAM,qBAAqB,MAAM;CACnC;CAEA,OAAO;AACT;;AAGA,SAAgB,oBAAoB,QAA+C;CACjF,OAAO;EACL,cAAc;EACd,aAAa;CACf;AACF;;AAGA,SAAgB,2BACd,QACyB;CACzB,OAAO;EACL,KAAK;EACL,SAAS;CACX;AACF;;AAGA,SAAgB,uBACd,QACqB;CACrB,OAAO;EACL,cAAc;EACd,aAAa;EACb,eAAe;CACjB;AACF;;AAGA,SAAgB,oBAAoB,OAA8C;CAQhF,OAAO;EANL,cAAc;EACd,aAAa;EACb,mBAAmB,MAAM,aAAa;CAI7B;AACb"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/avatar/avatar.ts"],"sourcesContent":["/**\n * Avatar 的跨框架行为契约。\n *\n * Core 归一化 props、推导降级模式和徽标状态；Zag 管图片请求生命周期。\n * 生成 root/image/badge 的 data 属性。React/Vue 适配器只投影内容通道并渲染固定 DOM。\n * 图片请求生命周期由同目录的纯 Zag load machine 决定，适配器仅运输资源标量快照。\n */\n\nexport const AVATAR_SHAPES = [\"circle\", \"square\"] as const;\nexport const AVATAR_SIZES = [\"s\", \"m\", \"l\"] as const;\nexport const AVATAR_PARTS = [\"root\", \"image\", \"fallback\", \"badge\"] as const;\nexport const AVATAR_LOAD_STATUS = [\"loading\", \"loaded\", \"error\"] as const;\nexport const AVATAR_BADGE_TYPES = [\"dot\", \"number\"] as const;\nexport const BADGE_COUNT_MAX = 99;\n\nexport type AvatarShape = (typeof AVATAR_SHAPES)[number];\nexport type AvatarSize = (typeof AVATAR_SIZES)[number];\nexport type AvatarPart = (typeof AVATAR_PARTS)[number];\nexport type AvatarLoadStatus = (typeof AVATAR_LOAD_STATUS)[number];\nexport type BadgeType = (typeof AVATAR_BADGE_TYPES)[number];\n\n/** 徽标配置（双栈共享标量，内容通道不进入 Core）。 */\nexport interface BadgeConfig {\n  /** 徽标类型。 */\n  type: BadgeType;\n  /** 数字徽标的数值。 */\n  count?: number;\n  /** 徽标无障碍标签。 */\n  ariaLabel?: string;\n}\n\n/** 双栈共享的标量 props；框架特有的内容通道不进入 Core。 */\nexport interface QwAvatarProps {\n  /** 图片源地址。空字符串或 undefined 时不渲染 img，直接进入降级。 */\n  src?: string;\n  /** 名称，用于提取缩写和 aria-label。 */\n  name?: string;\n  /** 外形，默认 `circle`。 */\n  shape?: AvatarShape;\n  /** 尺寸，默认 `m`。 */\n  size?: AvatarSize;\n  /** 装饰模式（从辅助技术隐藏）。 */\n  decorative?: boolean;\n  /** 自定义背景色，设置后覆盖所有展示形式的默认背景色。 */\n  bg?: string;\n  /** 徽标配置。 */\n  badge?: BadgeConfig;\n}\n\n/** 由各框架的内容通道存在性计算；不检查 DOM 或 VNode 内容。 */\nexport interface AvatarContentPresence {\n  /** 是否提供有效 `src`（非空字符串）。 */\n  hasImage: boolean;\n  /** 是否提供 `name`。 */\n  hasName: boolean;\n  /** 是否提供自定义降级内容（`fallback` prop / `#fallback` slot）。 */\n  hasFallback: boolean;\n  /** 是否提供自定义图标内容（`icon` prop / `#icon` slot）。 */\n  hasIcon: boolean;\n  /** 是否提供子元素（`children` / 默认 slot）。 */\n  hasChildren: boolean;\n  /** 是否提供 `badge` 配置。 */\n  hasBadge: boolean;\n}\n/** Frameworks only report whether a content channel was supplied. */\nexport function getAvatarContentPresence(props: QwAvatarProps, channels: Readonly<Record<string,boolean>>): AvatarContentPresence {\n  return {hasImage:typeof props.src === \"string\" && !!props.src,hasName:typeof props.name === \"string\" && !!props.name.trim(),hasFallback:!!channels.fallback,hasIcon:!!channels.icon,hasChildren:!!channels.default,hasBadge:props.badge != null};\n}\n\n/** 内容展示模式，按优先级互斥推导：children > image > icon > name。 */\nexport type DisplayMode = \"children\" | \"image\" | \"icon\" | \"initials\";\n\n/** 图片加载失败时的降级展示模式。 */\nexport type FallbackMode = \"custom\" | \"initials\" | \"icon\";\n\n/** 适配器唯一可消费的归一化结果。 */\nexport interface ResolvedAvatarState {\n  shape: AvatarShape;\n  size: AvatarSize;\n  hasImage: boolean;\n  hasName: boolean;\n  decorative: boolean;\n  /** 用户传入的自定义背景色（undefined 时使用默认分色逻辑）。 */\n  bg: string | undefined;\n  /** 互斥展示模式：children > image > icon > name > default-icon。 */\n  displayMode: DisplayMode;\n  /** 图片加载失败时的降级模式（仅 displayMode=\"image\" 时有效）。 */\n  fallbackMode: FallbackMode;\n  initials: string | undefined;\n  hasBadge: boolean;\n  badgeType: BadgeType | undefined;\n  badgeOverflow: boolean;\n  badgeDisplayCount: number | undefined;\n  badgeHidden: boolean;\n}\n\n/** Core 生成、由适配器覆盖到根元素的属性。 */\nexport interface AvatarRootProps {\n  \"data-scope\": \"avatar\";\n  \"data-part\": \"root\";\n  \"data-shape\": AvatarShape;\n  \"data-size\": AvatarSize;\n  \"data-display\": DisplayMode;\n  \"data-load-status\": AvatarLoadStatus;\n  \"data-fallback\": FallbackMode;\n  role?: \"img\";\n  \"aria-label\"?: string;\n  \"aria-hidden\"?: \"true\";\n  \"data-has-badge\"?: \"true\";\n  \"data-badge-type\"?: BadgeType;\n}\n\n/** Core 生成、由适配器覆盖到图片包装元素的属性。 */\nexport interface AvatarImageProps {\n  \"data-scope\": \"avatar\";\n  \"data-part\": \"image\";\n}\n\n/** Core 生成、由适配器覆盖到 img 元素的属性。 */\nexport interface AvatarImageElementProps {\n  alt: \"\";\n  loading: \"lazy\";\n}\n\n/** Core 生成、由适配器覆盖到降级内容元素的属性。 */\nexport interface AvatarFallbackProps {\n  \"data-scope\": \"avatar\";\n  \"data-part\": \"fallback\";\n  \"aria-hidden\": \"true\";\n}\n\n/** Core 生成、由适配器覆盖到徽标元素的属性。 */\nexport interface AvatarBadgeProps {\n  \"data-scope\": \"avatar\";\n  \"data-part\": \"badge\";\n  \"data-badge-type\": BadgeType;\n  \"aria-label\"?: string;\n  role?: \"img\";\n}\n\nconst EMPTY_PRESENCE: AvatarContentPresence = {\n  hasImage: false,\n  hasName: false,\n  hasFallback: false,\n  hasIcon: false,\n  hasChildren: false,\n  hasBadge: false,\n};\n\n/**\n * 从名称提取文字缩写。\n *\n * - 纯 CJK（汉字/假名/谚文）取首字\n * - 纯拉丁取前 2 字符大写\n * - 混合取前 2 字符\n * - 上限 2 字符\n * - 空字符串返回空字符串\n *\n * 按 grapheme 边界截取，不切开组合字符和 emoji 序列。\n */\nexport function extractInitials(name: string): string {\n  if (!name) return \"\";\n  const segmenter = new Intl.Segmenter(\"en\", { granularity: \"grapheme\" });\n  const chars = Array.from(segmenter.segment(name), ({ segment }) => segment).filter((ch) => ch.trim() !== \"\");\n  if (chars.length === 0) return \"\";\n\n  const isCjk = (ch: string) => /[\\p{Script=Han}\\p{Script=Hiragana}\\p{Script=Katakana}\\p{Script=Hangul}]/u.test(ch);\n  const allCjk = chars.every(isCjk);\n\n  if (allCjk) {\n    return chars[0]!;\n  }\n\n  const result = chars.slice(0, 2).join(\"\").toUpperCase();\n  return Array.from(segmenter.segment(result), ({ segment }) => segment).slice(0, 2).join(\"\");\n}\n\n/** 将公开输入和内容通道归一化为唯一的跨框架状态。 */\nexport function resolveAvatarState(\n  props: QwAvatarProps = {},\n  presence: AvatarContentPresence = EMPTY_PRESENCE,\n): ResolvedAvatarState {\n  const hasImage = presence.hasImage;\n  const hasName = presence.hasName;\n  const decorative = props.decorative ?? false;\n  const bg = typeof props.bg === \"string\" ? props.bg : undefined;\n\n  // 互斥展示优先级：children > image > icon > name > default-icon\n  const displayMode: DisplayMode = presence.hasChildren\n    ? \"children\"\n    : hasImage\n      ? \"image\"\n      : presence.hasIcon\n        ? \"icon\"\n        : hasName\n          ? \"initials\"\n          : \"icon\"; // 默认：展示 User 图标\n\n  // 图片加载失败时的降级模式（仅 displayMode=\"image\" 时有效）\n  // 降级优先级：fallback prop > icon > name > default-icon\n  const fallbackMode: FallbackMode = presence.hasFallback\n    ? \"custom\"\n    : presence.hasIcon\n      ? \"icon\"\n      : hasName\n        ? \"initials\"\n        : \"icon\";\n\n  const initials = hasName && props.name ? extractInitials(props.name) : undefined;\n\n  // 徽标逻辑\n  const hasBadge = presence.hasBadge && !!props.badge && AVATAR_BADGE_TYPES.includes(props.badge.type);\n  const badgeType = hasBadge ? props.badge?.type : undefined;\n\n  let badgeDisplayCount: number | undefined;\n  let badgeOverflow = false;\n  let badgeHidden = false;\n\n  if (hasBadge && badgeType === \"number\") {\n    const rawCount = props.badge?.count ?? 0;\n    if (typeof rawCount !== \"number\" || !Number.isFinite(rawCount) || rawCount <= 0) {\n      badgeHidden = true;\n      badgeDisplayCount = undefined;\n    } else if (rawCount > BADGE_COUNT_MAX) {\n      badgeOverflow = true;\n      badgeDisplayCount = BADGE_COUNT_MAX;\n    } else {\n      badgeDisplayCount = rawCount;\n    }\n  }\n\n  return {\n    shape: AVATAR_SHAPES.includes(props.shape!) ? props.shape! : \"circle\",\n    size: AVATAR_SIZES.includes(props.size!) ? props.size! : \"m\",\n    hasImage,\n    hasName,\n    decorative,\n    bg,\n    displayMode,\n    fallbackMode,\n    initials,\n    hasBadge: hasBadge && !badgeHidden,\n    badgeType,\n    badgeOverflow,\n    badgeDisplayCount,\n    badgeHidden,\n  };\n}\n\n/** 将归一化结果转成 root 属性。 */\nexport interface AvatarRootOptions { name?:string; badge?:BadgeConfig; loadStatus?:AvatarLoadStatus; lang?:string; dir?:string; hidden?:boolean }\nexport function getAvatarRootProps(state: ResolvedAvatarState, options: AvatarRootOptions = {}): AvatarRootProps & Pick<AvatarRootOptions,\"lang\" | \"dir\" | \"hidden\"> {\n  const props: AvatarRootProps = {\n    \"data-scope\": \"avatar\",\n    \"data-part\": \"root\",\n    \"data-shape\": state.shape,\n    \"data-size\": state.size,\n    \"data-display\": state.displayMode,\n    \"data-load-status\": state.displayMode === \"image\" ? options.loadStatus ?? \"loading\" : \"error\",\n    \"data-fallback\": state.fallbackMode,\n  };\n\n  // aria 策略：\n  // - decorative → aria-hidden=\"true\" + role=\"img\"（AT 忽略）\n  // - 有 name → role=\"img\" + aria-label（由适配器设置）\n  // - 无 name 且非 decorative → 不设 role（避免 role-img-alt 违规）\n  if (state.decorative) {\n    props[\"aria-hidden\"] = \"true\";\n    props[\"role\"] = \"img\";\n  } else if (state.hasName) {\n    props[\"role\"] = \"img\";\n    // The optional root options supply the scalar name through the same Core getter.\n  }\n\n  if (state.hasBadge && state.badgeType) {\n    props[\"data-has-badge\"] = \"true\";\n    props[\"data-badge-type\"] = state.badgeType;\n  }\n  if (!state.decorative && state.hasName && options.name) {\n    const label=state.hasBadge && typeof options.badge?.ariaLabel===\"string\" ? options.badge.ariaLabel.trim() : \"\";\n    props[\"aria-label\"] = label ? `${options.name}, ${label}` : options.name;\n  }\n\n  return { ...props, ...(options.lang === undefined ? {} : {lang:options.lang}), ...(options.dir === undefined ? {} : {dir:options.dir}), ...(options.hidden === undefined ? {} : {hidden:options.hidden}) };\n}\nexport function getAvatarImageDescriptor(state: ResolvedAvatarState, src?:string): {src:string;active:boolean} {\n  return {src:typeof src === \"string\" ? src : \"\",active:state.displayMode === \"image\" && state.hasImage};\n}\nexport function getAvatarRootStyle(state: ResolvedAvatarState): Record<string,string> | undefined {\n  return state.bg ? {\"--qw-avatar-bg\":state.bg} : undefined;\n}\nexport function getAvatarBadgeContent(state: ResolvedAvatarState): string {\n  return state.badgeType === \"number\" && state.hasBadge ? `${state.badgeDisplayCount}${state.badgeOverflow ? \"+\" : \"\"}` : \"\";\n}\n\n/** 将归一化结果转成图片包装元素的属性。 */\nexport function getAvatarImageProps(_state: ResolvedAvatarState): AvatarImageProps {\n  return {\n    \"data-scope\": \"avatar\",\n    \"data-part\": \"image\",\n  };\n}\n\n/** 将归一化结果转成 img 元素的属性。 */\nexport function getAvatarImageElementProps(\n  _state: ResolvedAvatarState,\n): AvatarImageElementProps {\n  return {\n    alt: \"\",\n    loading: \"lazy\",\n  };\n}\n\n/** 将归一化结果转成降级内容元素的属性。 */\nexport function getAvatarFallbackProps(\n  _state: ResolvedAvatarState,\n): AvatarFallbackProps {\n  return {\n    \"data-scope\": \"avatar\",\n    \"data-part\": \"fallback\",\n    \"aria-hidden\": \"true\",\n  };\n}\n\n/** 将归一化结果转成徽标元素的属性。 */\nexport function getAvatarBadgeProps(state: ResolvedAvatarState, badge?:BadgeConfig): AvatarBadgeProps {\n  const props: AvatarBadgeProps = {\n    \"data-scope\": \"avatar\",\n    \"data-part\": \"badge\",\n    \"data-badge-type\": state.badgeType ?? \"dot\",\n  };\n\n  if (typeof badge?.ariaLabel===\"string\" && badge.ariaLabel.trim()) { props.role = \"img\"; props[\"aria-label\"] = badge.ariaLabel; }\n  return props;\n}\n"],"mappings":"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"}

package/dist/avatar-load-w9dq05oV.js

@@ -0,0 +1,139 @@
+import { createMachine } from "@zag-js/core";
+//#region src/avatar/avatar-load.ts
+/** Per-instance monotonic identity; aborted renders never activate a frame. */
+function createImageRequestFrames(initial) {
+	if (initial && (!Number.isSafeInteger(initial.epoch) || initial.epoch < 0 || typeof initial.src !== "string" || typeof initial.active !== "boolean")) throw new TypeError("Invalid image request frame");
+	let epoch = initial?.epoch ?? -1;
+	let current = initial;
+	const create = (src, active) => {
+		src = typeof src === "string" ? src : "";
+		return Object.freeze({
+			epoch: ++epoch,
+			src,
+			active: !!active && !!src
+		});
+	};
+	return {
+		create,
+		resolve(descriptor) {
+			const src = typeof descriptor.src === "string" ? descriptor.src : "", active = !!descriptor.active && !!src;
+			if (!current || current.src !== src || current.active !== active) current = create(src, active);
+			return current;
+		}
+	};
+}
+function getImageRequestStatus(frame, result) {
+	if (!frame.active) return "error";
+	return result?.epoch === frame.epoch && result.src === frame.src ? result.status : "loading";
+}
+const sameFrame = (a, b) => a?.epoch === b.epoch && a.src === b.src;
+const validSession = (params) => params.refs.get("active") && params.event.session === params.refs.get("session");
+function accept(params) {
+	const event = params.event;
+	if (event.type === "RESOURCE.DETACH" || !validSession(params) || !event.frame.active || event.snapshot.srcAttribute !== event.frame.src) return;
+	const status = event.snapshot.complete ? Number.isFinite(event.snapshot.naturalWidth) && event.snapshot.naturalWidth > 0 ? "loaded" : "error" : "loading";
+	params.context.set("result", {
+		epoch: event.frame.epoch,
+		src: event.frame.src,
+		status
+	});
+}
+/** Pure Zag state: resource bridges supply scalars, never DOM objects. */
+const avatarLoadMachine = createMachine({
+	props: ({ props }) => ({ frame: props.frame ?? {
+		epoch: 0,
+		src: "",
+		active: false
+	} }),
+	initialState: () => "ready",
+	states: { ready: {} },
+	context: ({ bindable }) => ({ result: bindable(() => ({
+		defaultValue: void 0,
+		hash: (value) => value ? `${value.epoch}:${value.src}:${value.status}` : "",
+		isEqual: (a, b) => a?.epoch === b?.epoch && a?.src === b?.src && a?.status === b?.status
+	})) }),
+	refs: () => ({
+		active: false,
+		session: 0,
+		committed: void 0
+	}),
+	effects: ["lifecycle"],
+	on: {
+		"RESOURCE.COMMIT": { actions: ["commit"] },
+		"RESOURCE.SNAPSHOT": { actions: ["snapshot"] },
+		"RESOURCE.DETACH": { actions: ["detach"] }
+	},
+	implementations: {
+		effects: { lifecycle({ refs }) {
+			refs.set("active", true);
+			refs.set("session", refs.get("session") + 1);
+			return () => {
+				refs.set("active", false);
+				refs.set("session", refs.get("session") + 1);
+				refs.set("committed", void 0);
+			};
+		} },
+		actions: {
+			commit(params) {
+				const event = params.event;
+				if (event.type !== "RESOURCE.COMMIT" || !validSession(params)) return;
+				const current = params.refs.get("committed");
+				if (current && current.epoch > event.frame.epoch) return;
+				params.refs.set("committed", event.frame);
+				accept(params);
+			},
+			snapshot(params) {
+				if (params.event.type === "RESOURCE.SNAPSHOT" && sameFrame(params.refs.get("committed"), params.event.frame)) accept(params);
+			},
+			detach(params) {
+				if (params.event.type === "RESOURCE.DETACH" && validSession(params) && sameFrame(params.refs.get("committed"), params.event.frame)) params.refs.set("committed", void 0);
+			}
+		}
+	}
+});
+/** A committed renderer binds without reading reactive result state. */
+function createAvatarResourceBinding(service, frame) {
+	const session = service.refs.get("session");
+	let detached = false;
+	const send = (event) => {
+		if (!detached && service.refs.get("active") && service.refs.get("session") === session) service.send(event);
+	};
+	return {
+		commit(snapshot) {
+			send({
+				type: "RESOURCE.COMMIT",
+				frame,
+				session,
+				snapshot: { ...snapshot }
+			});
+		},
+		snapshot(snapshot) {
+			send({
+				type: "RESOURCE.SNAPSHOT",
+				frame,
+				session,
+				snapshot: { ...snapshot }
+			});
+		},
+		detach() {
+			send({
+				type: "RESOURCE.DETACH",
+				frame,
+				session
+			});
+			detached = true;
+		}
+	};
+}
+function connectAvatarLoad(service, frame = service.prop("frame")) {
+	return {
+		frame,
+		status: getImageRequestStatus(frame, service.context.get("result")),
+		imageKey: `${frame.epoch}:${frame.src}`,
+		bindResource: () => createAvatarResourceBinding(service, frame)
+	};
+}
+//#endregion
+export { getImageRequestStatus as a, createImageRequestFrames as i, connectAvatarLoad as n, createAvatarResourceBinding as r, avatarLoadMachine as t };
+
+//# sourceMappingURL=avatar-load-w9dq05oV.js.map

package/dist/avatar-load-w9dq05oV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-load-w9dq05oV.js","names":[],"sources":["../src/avatar/avatar-load.ts"],"sourcesContent":["import { createMachine, type Machine, type Params, type Service } from \"@zag-js/core\";\nimport type { AvatarLoadStatus } from \"./avatar.js\";\n\n/** A render request does not become active until its resource is committed. */\nexport interface ImageRequestFrame { readonly epoch: number; readonly src: string; readonly active: boolean }\nexport interface ImageRequestDescriptor { src: string; active: boolean }\nexport interface ImageResourceSnapshot { srcAttribute: string | null; complete: boolean; naturalWidth: number }\nexport interface ImageRequestResult { epoch: number; src: string; status: AvatarLoadStatus }\nexport interface ImageResourceBinding {\n  commit(snapshot: ImageResourceSnapshot): void;\n  snapshot(snapshot: ImageResourceSnapshot): void;\n  detach(): void;\n}\nexport interface ImageRequestFrames {\n  create(src: string | undefined, active: boolean): ImageRequestFrame;\n  resolve(descriptor:ImageRequestDescriptor):ImageRequestFrame;\n}\n/** Per-instance monotonic identity; aborted renders never activate a frame. */\nexport function createImageRequestFrames(initial?:ImageRequestFrame): ImageRequestFrames {\n  if(initial && (!Number.isSafeInteger(initial.epoch) || initial.epoch<0 || typeof initial.src!==\"string\" || typeof initial.active!==\"boolean\"))throw new TypeError(\"Invalid image request frame\");\n  let epoch = initial?.epoch ?? -1;\n  let current:ImageRequestFrame|undefined=initial;\n  const create=(src:string|undefined,active:boolean):ImageRequestFrame=>{\n    src = typeof src === \"string\" ? src : \"\";\n    return Object.freeze({epoch:++epoch,src,active:!!active && !!src});\n  };\n  return {create,resolve(descriptor){\n    const src=typeof descriptor.src === \"string\" ? descriptor.src : \"\",active=!!descriptor.active && !!src;\n    if(!current || current.src!==src || current.active!==active)current=create(src,active);\n    return current;\n  }};\n}\nexport function getImageRequestStatus(frame: ImageRequestFrame, result?: ImageRequestResult): AvatarLoadStatus {\n  if (!frame.active) return \"error\";\n  return result?.epoch === frame.epoch && result.src === frame.src ? result.status : \"loading\";\n}\nexport interface QwAvatarLoadProps { frame: ImageRequestFrame }\ntype ResourceEvent = { type:\"RESOURCE.COMMIT\" | \"RESOURCE.SNAPSHOT\"; frame:ImageRequestFrame; session:number; snapshot:ImageResourceSnapshot }\n  | { type:\"RESOURCE.DETACH\"; frame:ImageRequestFrame; session:number };\nexport interface QwAvatarLoadSchema {\n  props: QwAvatarLoadProps;\n  context: { result: ImageRequestResult | undefined };\n  refs: { active:boolean; session:number; committed:ImageRequestFrame | undefined };\n  state: \"ready\";\n  effect: \"lifecycle\";\n  action: \"commit\" | \"snapshot\" | \"detach\";\n  event: ResourceEvent;\n}\nexport type QwAvatarLoadService = Service<QwAvatarLoadSchema>;\nexport type QwAvatarLoadMachine = Machine<QwAvatarLoadSchema>;\nconst sameFrame = (a:ImageRequestFrame | undefined,b:ImageRequestFrame) => a?.epoch === b.epoch && a.src === b.src;\nconst validSession = (params:Params<QwAvatarLoadSchema>) => params.refs.get(\"active\") && params.event.session === params.refs.get(\"session\");\nfunction accept(params:Params<QwAvatarLoadSchema>): void {\n  const event=params.event;\n  if (event.type === \"RESOURCE.DETACH\" || !validSession(params) || !event.frame.active || event.snapshot.srcAttribute !== event.frame.src) return;\n  const status:AvatarLoadStatus = event.snapshot.complete ? Number.isFinite(event.snapshot.naturalWidth) && event.snapshot.naturalWidth > 0 ? \"loaded\" : \"error\" : \"loading\";\n  params.context.set(\"result\",{epoch:event.frame.epoch,src:event.frame.src,status});\n}\n/** Pure Zag state: resource bridges supply scalars, never DOM objects. */\nexport const avatarLoadMachine:QwAvatarLoadMachine=createMachine<QwAvatarLoadSchema>({\n  props:({props})=>({frame:props.frame ?? {epoch:0,src:\"\",active:false}}),\n  initialState:()=>\"ready\", states:{ready:{}},\n  context:({bindable})=>({result:bindable<ImageRequestResult | undefined>(()=>({defaultValue:undefined,hash:value=>value ? `${value.epoch}:${value.src}:${value.status}` : \"\",isEqual:(a,b)=>a?.epoch === b?.epoch && a?.src === b?.src && a?.status === b?.status}))}),\n  refs:()=>({active:false,session:0,committed:undefined}),\n  effects:[\"lifecycle\"],\n  on:{\"RESOURCE.COMMIT\":{actions:[\"commit\"]},\"RESOURCE.SNAPSHOT\":{actions:[\"snapshot\"]},\"RESOURCE.DETACH\":{actions:[\"detach\"]}},\n  implementations:{\n    effects:{lifecycle({refs}){\n      refs.set(\"active\",true); refs.set(\"session\",refs.get(\"session\")+1);\n      return ()=>{refs.set(\"active\",false);refs.set(\"session\",refs.get(\"session\")+1);refs.set(\"committed\",undefined);};\n    }},\n    actions:{\n      commit(params){\n        const event=params.event;if(event.type!==\"RESOURCE.COMMIT\" || !validSession(params))return;\n        const current=params.refs.get(\"committed\");if(current && current.epoch>event.frame.epoch)return;\n        params.refs.set(\"committed\",event.frame);accept(params);\n      },\n      snapshot(params){if(params.event.type===\"RESOURCE.SNAPSHOT\" && sameFrame(params.refs.get(\"committed\"),params.event.frame))accept(params);},\n      detach(params){if(params.event.type===\"RESOURCE.DETACH\" && validSession(params) && sameFrame(params.refs.get(\"committed\"),params.event.frame))params.refs.set(\"committed\",undefined);},\n    },\n  },\n});\nexport interface QwAvatarLoadApi {\n  readonly frame:ImageRequestFrame;\n  readonly status:AvatarLoadStatus;\n  readonly imageKey:string;\n  bindResource():ImageResourceBinding;\n}\n/** A committed renderer binds without reading reactive result state. */\nexport function createAvatarResourceBinding(service:QwAvatarLoadService, frame:ImageRequestFrame):ImageResourceBinding {\n  const session=service.refs.get(\"session\");let detached=false;\n  const send=(event:ResourceEvent)=>{if(!detached && service.refs.get(\"active\") && service.refs.get(\"session\")===session)service.send(event);};\n  return {\n    commit(snapshot){send({type:\"RESOURCE.COMMIT\",frame,session,snapshot:{...snapshot}});},\n    snapshot(snapshot){send({type:\"RESOURCE.SNAPSHOT\",frame,session,snapshot:{...snapshot}});},\n    detach(){send({type:\"RESOURCE.DETACH\",frame,session});detached=true;},\n  };\n}\nexport function connectAvatarLoad(service:QwAvatarLoadService, frame=service.prop(\"frame\")):QwAvatarLoadApi {\n  return {\n    frame,status:getImageRequestStatus(frame,service.context.get(\"result\")),imageKey:`${frame.epoch}:${frame.src}`,\n    bindResource:()=>createAvatarResourceBinding(service,frame),\n  };\n}\n"],"mappings":"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"}

package/dist/back-top/back-top.d.ts

@@ -0,0 +1,77 @@
+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 BACK_TOP_PARTS: readonly ["root", "icon", "label"];
+/** SSR-safe input shared by all adapters. */
+export interface QwBackTopProps {
+    /** Page-unique instance identity; adapters generate one when omitted. */
+    id?: string;
+    /** Accessible button name; defaults to 回到顶部. */
+    label?: string;
+    /** Show the visible label next to the icon; the name is always present. */
+    showLabel?: boolean;
+    /** Scroll distance in CSS pixels after which the button appears; defaults to 400. */
+    visibilityHeight?: number;
+    /** Element id of the scrolling container; omitted or missing means the document scroller. */
+    target?: string;
+    /** Called once per activation, after the scroll request is issued. */
+    onActivate?: () => void;
+}
+export interface ResolvedBackTopState {
+    label: string;
+    showLabel: boolean;
+    visibilityHeight: number;
+    target: string | undefined;
+}
+export declare function resolveBackTopState(props?: QwBackTopProps): ResolvedBackTopState;
+/** Visible above the threshold; a focused button is never hidden under the user. */
+export declare function isBackTopShown(state: ResolvedBackTopState, scrollTop: number, focused: boolean): boolean;
+export declare function createBackTopProps(props?: QwBackTopProps): QwBackTopProps;
+export interface QwBackTopSchema {
+    props: QwBackTopProps;
+    context: {
+        scrollTop: number;
+        focused: boolean;
+    };
+    refs: {
+        schedule: (() => void) | null;
+    };
+    state: "ready";
+    action: "setScroll" | "setFocused" | "scrollToTop" | "remeasure";
+    effect: "trackScroll";
+    event: {
+        type: "SCROLL.SET";
+        scrollTop: number;
+    } | {
+        type: "FOCUS.SET";
+        focused: boolean;
+    } | {
+        type: "ACTIVATE";
+    };
+}
+export type QwBackTopMachine = Machine<QwBackTopSchema>;
+export type QwBackTopService = Service<QwBackTopSchema>;
+/** Core owns listening, threshold decisions, reduced-motion scrolling and cleanup. */
+export declare const backTopMachine: QwBackTopMachine;
+export interface QwBackTopApi<T extends PropTypes = PropTypes> {
+    shown: boolean;
+    label: string;
+    showLabel: boolean;
+    activate(): void;
+    getRootProps(): T["button"];
+    getIconProps(): T["element"];
+    getIconState(): IconState;
+    getLabelProps(): T["element"];
+}
+/** Framework/native event shape; only cancellation is read. */
+export interface BackTopDomEvent {
+    readonly defaultPrevented: boolean;
+}
+/** Caller root handlers run first; Core then activates (unless prevented) and always tracks focus. Method syntax keeps framework handlers assignable. */
+export interface BackTopConnectOptions {
+    onClick?(event: BackTopDomEvent): void;
+    onFocus?(event: BackTopDomEvent): void;
+    onBlur?(event: BackTopDomEvent): void;
+}
+export declare function connectBackTop<T extends PropTypes>(service: QwBackTopService, normalize: NormalizeProps<T>, options?: BackTopConnectOptions): QwBackTopApi<T>;

package/dist/back-top/index.d.ts

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

package/dist/back-top/index.js

@@ -0,0 +1,189 @@
+import { o as resolveIconState } from "../icon-Cgdbnk1u.js";
+import { createMachine } from "@zag-js/core";
+//#region src/back-top/back-top.ts
+/** Stable DOM parts shared by every adapter. */
+const BACK_TOP_PARTS = [
+	"root",
+	"icon",
+	"label"
+];
+function resolveBackTopState(props = {}) {
+	const height = props.visibilityHeight;
+	return {
+		label: typeof props.label === "string" && props.label.trim() ? props.label : "回到顶部",
+		showLabel: !!props.showLabel,
+		visibilityHeight: typeof height === "number" && Number.isFinite(height) && height >= 0 ? height : 400,
+		target: typeof props.target === "string" && props.target.trim() ? props.target : void 0
+	};
+}
+/** Visible above the threshold; a focused button is never hidden under the user. */
+function isBackTopShown(state, scrollTop, focused) {
+	return focused || scrollTop >= Math.max(1, state.visibilityHeight);
+}
+function createBackTopProps(props = {}) {
+	if (props.id !== void 0 && (typeof props.id !== "string" || !props.id.trim())) throw new TypeError("BackTop requires a nonempty instance id when provided");
+	return { ...props };
+}
+const rootId = (scope) => `back-top:${scope.id}`;
+const live = (service) => resolveBackTopState({
+	label: service.prop("label"),
+	showLabel: service.prop("showLabel"),
+	visibilityHeight: service.prop("visibilityHeight"),
+	target: service.prop("target")
+});
+/** Platform boundary: the element id is looked up in the button's own root node. */
+function resolveScroller(root, state) {
+	const win = root.ownerDocument.defaultView;
+	const owner = root.getRootNode();
+	const found = state.target ? owner.getElementById?.(state.target) ?? root.ownerDocument.getElementById(state.target) : null;
+	return found ? {
+		node: found,
+		events: found
+	} : {
+		node: null,
+		events: win
+	};
+}
+function readScrollTop(root, node) {
+	if (node) return node.scrollTop;
+	return root.ownerDocument.defaultView?.scrollY ?? root.ownerDocument.documentElement.scrollTop;
+}
+/** Core owns listening, threshold decisions, reduced-motion scrolling and cleanup. */
+const backTopMachine = createMachine({
+	props: ({ props }) => createBackTopProps(props),
+	initialState: () => "ready",
+	states: { ready: {} },
+	context: ({ bindable }) => ({
+		scrollTop: bindable(() => ({ defaultValue: 0 })),
+		focused: bindable(() => ({ defaultValue: false }))
+	}),
+	refs: () => ({ schedule: null }),
+	watch({ track, prop, action }) {
+		track([() => prop("target"), () => prop("visibilityHeight")], () => action(["remeasure"]));
+	},
+	on: {
+		"SCROLL.SET": { actions: ["setScroll"] },
+		"FOCUS.SET": { actions: ["setFocused"] },
+		ACTIVATE: { actions: ["scrollToTop"] }
+	},
+	effects: ["trackScroll"],
+	implementations: {
+		actions: {
+			setScroll(params) {
+				if (params.event.type === "SCROLL.SET") params.context.set("scrollTop", params.event.scrollTop);
+			},
+			setFocused(params) {
+				if (params.event.type === "FOCUS.SET") params.context.set("focused", params.event.focused);
+			},
+			remeasure(params) {
+				params.refs.get("schedule")?.();
+			},
+			scrollToTop({ scope, prop }) {
+				const root = scope.getById(rootId(scope)), win = root?.ownerDocument.defaultView;
+				if (root && win) {
+					const reduce = win.matchMedia?.("(prefers-reduced-motion: reduce)").matches ?? false;
+					const { node } = resolveScroller(root, live({ prop }));
+					const options = {
+						top: 0,
+						behavior: reduce ? "auto" : "smooth"
+					};
+					if (node) node.scrollTo?.(options);
+					else win.scrollTo?.(options);
+				}
+				prop("onActivate")?.();
+			}
+		},
+		effects: { trackScroll({ scope, prop, send, refs, context }) {
+			const root = scope.getById(rootId(scope)), win = root?.ownerDocument.defaultView;
+			if (!root || !win) return;
+			let frame = 0, events = null, node = null, disposed = false;
+			const run = () => {
+				frame = 0;
+				if (disposed) return;
+				const next = resolveScroller(root, live({ prop }));
+				if (next.events !== events) {
+					events?.removeEventListener("scroll", schedule);
+					events = next.events;
+					node = next.node;
+					events.addEventListener("scroll", schedule, { passive: true });
+				}
+				const top = readScrollTop(root, node);
+				if (top !== context.get("scrollTop")) send({
+					type: "SCROLL.SET",
+					scrollTop: top
+				});
+			};
+			function schedule() {
+				if (!frame && !disposed) frame = win.requestAnimationFrame(run);
+			}
+			refs.set("schedule", schedule);
+			run();
+			return () => {
+				disposed = true;
+				refs.set("schedule", null);
+				if (frame) win.cancelAnimationFrame(frame);
+				events?.removeEventListener("scroll", schedule);
+			};
+		} }
+	}
+});
+const callAll = (handlers, event) => {
+	for (const handler of Array.isArray(handlers) ? handlers : [handlers]) if (typeof handler === "function") handler(event);
+};
+function connectBackTop(service, normalize, options = {}) {
+	const state = live(service), id = rootId(service.scope);
+	const shown = isBackTopShown(state, service.context.get("scrollTop"), service.context.get("focused"));
+	const activate = () => service.send({ type: "ACTIVATE" });
+	return {
+		shown,
+		label: state.label,
+		showLabel: state.showLabel,
+		activate,
+		getRootProps: () => normalize.button({
+			"data-scope": "back-top",
+			"data-part": "root",
+			id,
+			type: "button",
+			hidden: !shown || void 0,
+			"data-state": shown ? "visible" : "hidden",
+			"data-show-label": state.showLabel ? "true" : void 0,
+			"aria-label": state.showLabel ? void 0 : state.label,
+			onClick(event) {
+				callAll(options.onClick, event);
+				if (!event.defaultPrevented) activate();
+			},
+			onFocus(event) {
+				callAll(options.onFocus, event);
+				service.send({
+					type: "FOCUS.SET",
+					focused: true
+				});
+			},
+			onBlur(event) {
+				callAll(options.onBlur, event);
+				service.send({
+					type: "FOCUS.SET",
+					focused: false
+				});
+			}
+		}),
+		getIconProps: () => normalize.element({
+			"data-scope": "back-top",
+			"data-part": "icon",
+			"aria-hidden": true
+		}),
+		getIconState: () => resolveIconState({
+			id: `${id}:icon`,
+			name: "to-top"
+		}),
+		getLabelProps: () => normalize.element({
+			"data-scope": "back-top",
+			"data-part": "label",
+			hidden: !state.showLabel || void 0
+		})
+	};
+}
+//#endregion
+export { BACK_TOP_PARTS, backTopMachine, connectBackTop, createBackTopProps, isBackTopShown, resolveBackTopState };
+
+//# sourceMappingURL=index.js.map