@unif/react-native-design 0.29.0 → 0.30.1

package/lib/typescript/src/components/ui/Avatar/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9E,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,wBAAwB;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,uCAAuC;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9E,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,uCAAuC;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/lib/typescript/src/components/ui/AvatarGroup/AvatarGroup.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { AvatarGroupProps } from './types';
+/** 重叠头像组；只拥有布局、溢出计数和可选溢出 action。 */
+export declare function AvatarGroup({ items, size, shape, max, style, testID, onOverflowPress, overflowAccessibilityLabel, overflowAccessibilityHint, }: AvatarGroupProps): React.JSX.Element | null;
+//# sourceMappingURL=AvatarGroup.d.ts.map

package/lib/typescript/src/components/ui/AvatarGroup/AvatarGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AvatarGroup.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/AvatarGroup/AvatarGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAkBzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAWhD,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,IAAW,EACX,KAAgB,EAChB,GAAG,EACH,KAAK,EACL,MAAM,EACN,eAAe,EACf,0BAA0B,EAC1B,yBAAyB,GAC1B,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA0G7C"}

package/lib/typescript/src/components/ui/AvatarGroup/index.d.ts

@@ -0,0 +1,3 @@
+export { AvatarGroup } from './AvatarGroup';
+export type { AvatarGroupItem, AvatarGroupProps } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/ui/AvatarGroup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/AvatarGroup/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/src/components/ui/AvatarGroup/layout.d.ts

@@ -0,0 +1,16 @@
+import type { AvatarSize } from '../Avatar';
+export type AvatarGroupHitSlop = Readonly<{
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}>;
+export type ResolvedAvatarGroupLayout = Readonly<{
+    box: number;
+    overlap: number;
+    borderWidth: number;
+    hitSlop: AvatarGroupHitSlop;
+}>;
+/** 五档尺寸共享的重叠、分隔边与 44pt 命中区几何。 */
+export declare function resolveAvatarGroupLayout(size: AvatarSize): ResolvedAvatarGroupLayout;
+//# sourceMappingURL=layout.d.ts.map

package/lib/typescript/src/components/ui/AvatarGroup/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/AvatarGroup/layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,CAAC,CAAC;AAEH,iCAAiC;AACjC,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,GACf,yBAAyB,CAmC3B"}

package/lib/typescript/src/components/ui/AvatarGroup/normalize.d.ts

@@ -0,0 +1,9 @@
+import type { AvatarGroupItem } from './types';
+export type NormalizedAvatarGroup = Readonly<{
+    visibleItems: readonly AvatarGroupItem[];
+    overflowCount: number;
+    invalidMax: boolean;
+}>;
+/** AvatarGroup 唯一的 max 与可见成员归一化入口。 */
+export declare function normalizeAvatarGroup(items: readonly AvatarGroupItem[], max: number | undefined): NormalizedAvatarGroup;
+//# sourceMappingURL=normalize.d.ts.map

package/lib/typescript/src/components/ui/AvatarGroup/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/AvatarGroup/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC,CAAC;AAEH,sCAAsC;AACtC,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,qBAAqB,CAevB"}

package/lib/typescript/src/components/ui/AvatarGroup/styles.d.ts

@@ -0,0 +1,17 @@
+import { type ColorTokens } from '../../../theme';
+export declare const makeStyles: (_colors: ColorTokens) => Readonly<{
+    root: {
+        alignItems: "center";
+        flexDirection: "row";
+    };
+    overflow: {
+        alignItems: "center";
+        justifyContent: "center";
+        overflow: "hidden";
+    };
+    overflowText: {
+        fontWeight: "600";
+        lineHeight: undefined;
+    };
+}>;
+//# sourceMappingURL=styles.d.ts.map

package/lib/typescript/src/components/ui/AvatarGroup/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/AvatarGroup/styles.ts"],"names":[],"mappings":"AACA,OAAO,EAAM,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,UAAU,GAAI,SAAS,WAAW;;;;;;;;;;;;;;EAe3C,CAAC"}

package/lib/typescript/src/components/ui/AvatarGroup/types.d.ts

@@ -0,0 +1,36 @@
+import type { ImageSourcePropType, StyleProp, ViewStyle } from 'react-native';
+import type { AvatarShape, AvatarSize, AvatarVariant } from '../Avatar';
+export type AvatarGroupItem = Readonly<{
+    /** 列表内唯一且稳定的身份键。 */
+    key: string;
+    /** 可见回退文字与 Avatar accessible name。 */
+    label: string;
+    source?: ImageSourcePropType;
+    variant?: AvatarVariant;
+}>;
+type SharedAvatarGroupProps = {
+    items: readonly AvatarGroupItem[];
+    /** 所有成员共用的尺寸，默认 'md'。 */
+    size?: AvatarSize;
+    /** 所有成员与溢出位共用的形态，默认 'circle'。 */
+    shape?: AvatarShape;
+    /** 最大视觉位数量，包含 +N 溢出位，必须是大于等于 2 的整数。 */
+    max?: number;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+};
+type StaticOverflowProps = {
+    onOverflowPress?: never;
+    overflowAccessibilityLabel?: never;
+    overflowAccessibilityHint?: never;
+};
+type ActionableOverflowProps = {
+    onOverflowPress: () => void;
+    /** 默认按实际数量生成“查看其余 N 位成员”。 */
+    overflowAccessibilityLabel?: string;
+    /** 描述打开弹层、抽屉或跳转等消费端结果。 */
+    overflowAccessibilityHint?: string;
+};
+export type AvatarGroupProps = SharedAvatarGroupProps & (StaticOverflowProps | ActionableOverflowProps);
+export {};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/components/ui/AvatarGroup/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/AvatarGroup/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CAAC,CAAC;AAEH,KAAK,sBAAsB,GAAG;IAC5B,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC,yBAAyB;IACzB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,0BAA0B,CAAC,EAAE,KAAK,CAAC;IACnC,yBAAyB,CAAC,EAAE,KAAK,CAAC;CACnC,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC7B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,6BAA6B;IAC7B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,0BAA0B;IAC1B,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GACnD,CAAC,mBAAmB,GAAG,uBAAuB,CAAC,CAAC"}

package/lib/typescript/src/components/ui/index.d.ts

@@ -1,5 +1,7 @@
 export { Avatar } from './Avatar';
-export type { AvatarProps, AvatarSize, AvatarVariant } from './Avatar';
+export type { AvatarProps, AvatarShape, AvatarSize, AvatarVariant, } from './Avatar';
+export { AvatarGroup } from './AvatarGroup';
+export type { AvatarGroupItem, AvatarGroupProps } from './AvatarGroup';
 export { BlurLayer } from './BlurLayer';
 export type { BlurLayerProps } from './BlurLayer';
 export { Button } from './Button';

package/lib/typescript/src/components/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unif/react-native-design",
-  "version": "0.29.0",
+  "version": "0.30.1",
   "description": "Unif 设计系统:theme + icons + utils + components",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -85,13 +85,13 @@
     "@eslint/js": "^9.39.4",
     "@jest/globals": "^30.0.0",
     "@react-native-community/cli": "20.1.0",
-    "@react-native-community/template": "0.86.2",
-    "@react-native/babel-preset": "0.86.2",
-    "@react-native/eslint-config": "0.86.2",
-    "@react-native/jest-preset": "0.86.2",
-    "@react-native/metro-config": "0.86.2",
+    "@react-native-community/template": "0.86.3",
+    "@react-native/babel-preset": "0.86.3",
+    "@react-native/eslint-config": "0.86.3",
+    "@react-native/jest-preset": "0.86.3",
+    "@react-native/metro-config": "0.86.3",
     "@release-it/conventional-changelog": "^11.0.0",
-    "@sbaiahmed1/react-native-blur": "^4.6.2",
+    "@sbaiahmed1/react-native-blur": "6.0.1",
     "@types/react": "^19.2.0",
     "commitlint": "^21.0.1",
     "del-cli": "^7.0.0",
@@ -103,14 +103,14 @@
     "lefthook": "^2.1.4",
     "prettier": "^3.8.1",
     "react": "19.2.3",
-    "react-native": "0.86.2",
+    "react-native": "0.86.3",
     "react-native-builder-bob": "^0.41.0",
     "react-native-gesture-handler": "^3.1.0",
-    "react-native-reanimated": "~4.5.3",
+    "react-native-reanimated": "~4.6.0",
     "react-native-reanimated-carousel": "^5.0.0",
     "react-native-safe-area-context": "^5.7.0",
     "react-native-svg": "^15.15.5",
-    "react-native-worklets": "^0.11.3",
+    "react-native-worklets": "^0.12.1",
     "release-it": "^20.0.1",
     "semver": "^7.8.5",
     "smol-toml": "^1.7.1",
@@ -122,11 +122,11 @@
     "react": ">=19.2.3 <20.0.0",
     "react-native": ">=0.86.0",
     "react-native-gesture-handler": ">=3.0.0 <4.0.0",
-    "react-native-reanimated": ">=4.5.2 <4.6.0",
+    "react-native-reanimated": ">=4.5.2 <4.7.0",
     "react-native-reanimated-carousel": ">=5.0.0 <6.0.0",
     "react-native-safe-area-context": ">=5",
     "react-native-svg": ">=15",
-    "react-native-worklets": ">=0.11.0 <0.12.0"
+    "react-native-worklets": ">=0.11.0 <0.13.0"
   },
   "engines": {
     "node": "^20.19.4 || ^22.13.0 || ^24.3.0 || >= 25.0.0"

package/src/components/ui/Avatar/Avatar.tsx

@@ -3,11 +3,16 @@ import { Text, View } from 'react-native';
 import { scaleFontMetric, useColors, useFontScale } from '../../../theme';
 import { resolveImageSource } from '../../../utils/imageSource';
 import { ImageAttempt } from '../shared/ImageAttempt';
-import { paletteFor, sizingFor, styles } from './styles';
+import {
+  paletteFor,
+  resolveAvatarBorderRadius,
+  sizingFor,
+  styles,
+} from './styles';
 import type { AvatarProps } from './types';
 
 /**
- * 圆形头像 —— 5 档尺寸 × 4 种配色 × 可选图片 source。
+ * 头像 —— 2 种形态 × 5 档尺寸 × 4 种配色 × 可选图片 source。
  *
  * 合法 source 由 keyed ImageAttempt 独立持有失败状态；非法 source 或加载失败
  * 时渲染 label + variant 背景色。
@@ -15,6 +20,7 @@ import type { AvatarProps } from './types';
 export function Avatar({
   label,
   size = 'md',
+  shape = 'circle',
   variant = 'neutral',
   source,
   style,
@@ -42,7 +48,7 @@ export function Avatar({
         {
           width: dims.box,
           height: dims.box,
-          borderRadius: dims.box / 2,
+          borderRadius: resolveAvatarBorderRadius(size, shape),
           backgroundColor: palette.bg,
         },
         style,

package/src/components/ui/Avatar/index.ts

@@ -1,2 +1,7 @@
 export { Avatar } from './Avatar';
-export type { AvatarProps, AvatarSize, AvatarVariant } from './types';
+export type {
+  AvatarProps,
+  AvatarShape,
+  AvatarSize,
+  AvatarVariant,
+} from './types';

package/src/components/ui/Avatar/styles.ts

@@ -1,8 +1,8 @@
 import { StyleSheet } from 'react-native';
-import { avatar, fw, rf, type ColorTokens } from '../../../theme';
-import type { AvatarSize, AvatarVariant } from './types';
+import { avatar, fw, radius, rf, type ColorTokens } from '../../../theme';
+import type { AvatarShape, AvatarSize, AvatarVariant } from './types';
 
-/** Avatar 静态 base —— 圆形容器(borderRadius / 尺寸由 sizingFor 派生)。 */
+/** Avatar 静态 base —— 容器圆角 / 尺寸由 resolver 派生。 */
 export const styles = StyleSheet.create({
   base: {
     alignItems: 'center',
@@ -36,6 +36,17 @@ export function sizingFor(size: AvatarSize): { box: number; fs: number } {
   }
 }
 
+/** circle 保留直径一半的现有视觉；square 按尺寸使用既有圆角 token。 */
+export function resolveAvatarBorderRadius(
+  size: AvatarSize,
+  shape: AvatarShape
+): number {
+  if (shape === 'circle') return sizingFor(size).box / 2;
+  if (size === 'xs' || size === 'sm') return radius.xs;
+  if (size === 'xl') return radius.md;
+  return radius.sm;
+}
+
 /** Avatar 配色推导:4 种 variant → { bg, fg }。签名与 Tag/Button 的 paletteFor 一致。 */
 export function paletteFor(
   variant: AvatarVariant,

package/src/components/ui/Avatar/types.ts

@@ -3,6 +3,9 @@ import type { ImageSourcePropType, StyleProp, ViewStyle } from 'react-native';
 /** 头像尺寸（对应 avatar.xs..xl）：xs=18 / sm=28 / md=32 / lg=40 / xl=56 */
 export type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 
+/** 头像形态：circle 为圆形，square 为带 token 圆角的方形。 */
+export type AvatarShape = 'circle' | 'square';
+
 /**
  * 头像配色变体（仅在显示 letter / fallback 时生效，showImage 时被覆盖）：
  * - `brand` 品牌橙底（AI 头像专用）
@@ -20,6 +23,8 @@ export type AvatarProps = {
   label: string;
   /** 尺寸，默认 'md' */
   size?: AvatarSize;
+  /** 形态，默认 'circle' */
+  shape?: AvatarShape;
   /** 配色变体，默认 'neutral' */
   variant?: AvatarVariant;
   /**

package/src/components/ui/AvatarGroup/AvatarGroup.tsx

@@ -0,0 +1,147 @@
+import React, { useEffect } from 'react';
+import { Text, View, type ViewStyle } from 'react-native';
+import { Pressable } from 'react-native-gesture-handler';
+import {
+  pressedOpacity,
+  scaleFontMetric,
+  useColors,
+  useFontScale,
+  useThemedStyles,
+} from '../../../theme';
+import { createLogger } from '../../../utils/logger';
+import { childTestID } from '../../../utils/testID';
+import { Avatar } from '../Avatar';
+import { resolveAvatarBorderRadius, sizingFor } from '../Avatar/styles';
+import { normalizeNonBlankText } from '../shared/accessibilityName';
+import { resolveAvatarGroupLayout } from './layout';
+import { normalizeAvatarGroup } from './normalize';
+import { makeStyles } from './styles';
+import type { AvatarGroupProps } from './types';
+
+const log = createLogger('AvatarGroup');
+const warned = new Set<string>();
+
+function warnOnce(key: string, message: string): void {
+  if (warned.has(key)) return;
+  warned.add(key);
+  log.warn(message);
+}
+
+/** 重叠头像组；只拥有布局、溢出计数和可选溢出 action。 */
+export function AvatarGroup({
+  items,
+  size = 'md',
+  shape = 'circle',
+  max,
+  style,
+  testID,
+  onOverflowPress,
+  overflowAccessibilityLabel,
+  overflowAccessibilityHint,
+}: AvatarGroupProps): React.JSX.Element | null {
+  const colors = useColors();
+  const fontScale = useFontScale();
+  const styles = useThemedStyles(makeStyles);
+  const normalized = normalizeAvatarGroup(items, max);
+  const layout = resolveAvatarGroupLayout(size);
+  const avatarSizing = sizingFor(size);
+  const overflowFontSize = scaleFontMetric(avatarSizing.fs, fontScale);
+  const customOverflowLabel = normalizeNonBlankText(overflowAccessibilityLabel);
+  const hasBlankOverflowLabel =
+    normalized.overflowCount > 0 &&
+    onOverflowPress !== undefined &&
+    overflowAccessibilityLabel !== undefined &&
+    customOverflowLabel === undefined;
+
+  useEffect(() => {
+    if (typeof __DEV__ === 'undefined' || !__DEV__) return;
+    if (normalized.invalidMax) {
+      warnOnce(
+        `max:${String(max)}`,
+        `max 必须是大于等于 2 的有限整数，传入 ${String(max)}，已展示全部成员。`
+      );
+    }
+    if (hasBlankOverflowLabel) {
+      warnOnce(
+        'overflowAccessibilityLabel:blank',
+        'overflowAccessibilityLabel 不能为空白，已回退默认名称。'
+      );
+    }
+  }, [hasBlankOverflowLabel, max, normalized.invalidMax]);
+
+  if (items.length === 0) return null;
+
+  const slotStyle = (index: number): ViewStyle => ({
+    borderColor: colors.surface,
+    borderWidth: layout.borderWidth,
+    marginStart: index === 0 ? 0 : -layout.overlap,
+    zIndex: index,
+  });
+  const overflowCount = normalized.overflowCount;
+  const overflowLabel = `+${overflowCount}`;
+  const overflowA11yLabel =
+    onOverflowPress === undefined
+      ? `还有 ${overflowCount} 位成员`
+      : (customOverflowLabel ?? `查看其余 ${overflowCount} 位成员`);
+  const overflowStyle: ViewStyle = {
+    ...slotStyle(normalized.visibleItems.length),
+    width: layout.box,
+    height: layout.box,
+    borderRadius: resolveAvatarBorderRadius(size, shape),
+    backgroundColor: colors.primaryContainer,
+  };
+  const overflowText = (
+    <Text
+      style={[
+        styles.overflowText,
+        { color: colors.primary, fontSize: overflowFontSize },
+      ]}
+      numberOfLines={1}
+    >
+      {overflowLabel}
+    </Text>
+  );
+
+  return (
+    <View style={[styles.root, style]} testID={testID}>
+      {normalized.visibleItems.map((item, index) => (
+        <Avatar
+          key={item.key}
+          label={item.label}
+          source={item.source}
+          variant={item.variant}
+          size={size}
+          shape={shape}
+          style={slotStyle(index)}
+        />
+      ))}
+      {overflowCount === 0 ? null : onOverflowPress === undefined ? (
+        <View
+          accessible
+          accessibilityLabel={overflowA11yLabel}
+          style={[styles.overflow, overflowStyle]}
+          testID={childTestID(testID, 'overflow')}
+        >
+          {overflowText}
+        </View>
+      ) : (
+        <Pressable
+          accessible
+          accessibilityRole="button"
+          accessibilityLabel={overflowA11yLabel}
+          accessibilityHint={overflowAccessibilityHint}
+          onPress={onOverflowPress}
+          hitSlop={layout.hitSlop}
+          style={({ pressed }) => [
+            styles.overflow,
+            overflowStyle,
+            { opacity: pressed ? pressedOpacity : 1 },
+          ]}
+          testID={childTestID(testID, 'overflow')}
+        >
+          {overflowText}
+        </Pressable>
+      )}
+    </View>
+  );
+}

package/src/components/ui/AvatarGroup/index.ts

@@ -0,0 +1,2 @@
+export { AvatarGroup } from './AvatarGroup';
+export type { AvatarGroupItem, AvatarGroupProps } from './types';

package/src/components/ui/AvatarGroup/layout.ts

@@ -0,0 +1,56 @@
+import { avatar, fixed, r, space } from '../../../theme';
+import type { AvatarSize } from '../Avatar';
+
+export type AvatarGroupHitSlop = Readonly<{
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+}>;
+
+export type ResolvedAvatarGroupLayout = Readonly<{
+  box: number;
+  overlap: number;
+  borderWidth: number;
+  hitSlop: AvatarGroupHitSlop;
+}>;
+
+/** 五档尺寸共享的重叠、分隔边与 44pt 命中区几何。 */
+export function resolveAvatarGroupLayout(
+  size: AvatarSize
+): ResolvedAvatarGroupLayout {
+  const box = avatar[size];
+  let overlap: number;
+  let borderWidth: number;
+
+  switch (size) {
+    case 'xs':
+      overlap = space['1'];
+      borderWidth = r(1);
+      break;
+    case 'sm':
+      overlap = space['2'];
+      borderWidth = r(1);
+      break;
+    case 'md':
+      overlap = space['3'];
+      borderWidth = r(1);
+      break;
+    case 'lg':
+      overlap = space['4'];
+      borderWidth = r(2);
+      break;
+    case 'xl':
+      overlap = space['6'];
+      borderWidth = r(2);
+      break;
+  }
+
+  const inset = Math.max(0, (fixed.hitTarget - box) / 2);
+  return {
+    box,
+    overlap,
+    borderWidth,
+    hitSlop: { top: inset, right: inset, bottom: inset, left: inset },
+  };
+}

package/src/components/ui/AvatarGroup/normalize.ts

@@ -0,0 +1,28 @@
+import type { AvatarGroupItem } from './types';
+
+export type NormalizedAvatarGroup = Readonly<{
+  visibleItems: readonly AvatarGroupItem[];
+  overflowCount: number;
+  invalidMax: boolean;
+}>;
+
+/** AvatarGroup 唯一的 max 与可见成员归一化入口。 */
+export function normalizeAvatarGroup(
+  items: readonly AvatarGroupItem[],
+  max: number | undefined
+): NormalizedAvatarGroup {
+  const invalidMax =
+    max !== undefined &&
+    (!Number.isFinite(max) || !Number.isInteger(max) || max < 2);
+
+  if (max === undefined || invalidMax || items.length <= max) {
+    return { visibleItems: items, overflowCount: 0, invalidMax };
+  }
+
+  const visibleCount = max - 1;
+  return {
+    visibleItems: items.slice(0, visibleCount),
+    overflowCount: items.length - visibleCount,
+    invalidMax: false,
+  };
+}

package/src/components/ui/AvatarGroup/styles.ts

@@ -0,0 +1,19 @@
+import { StyleSheet } from 'react-native';
+import { fw, type ColorTokens } from '../../../theme';
+
+export const makeStyles = (_colors: ColorTokens) =>
+  StyleSheet.create({
+    root: {
+      alignItems: 'center',
+      flexDirection: 'row',
+    },
+    overflow: {
+      alignItems: 'center',
+      justifyContent: 'center',
+      overflow: 'hidden',
+    },
+    overflowText: {
+      fontWeight: fw.semi,
+      lineHeight: undefined,
+    },
+  });

package/src/components/ui/AvatarGroup/types.ts

@@ -0,0 +1,40 @@
+import type { ImageSourcePropType, StyleProp, ViewStyle } from 'react-native';
+import type { AvatarShape, AvatarSize, AvatarVariant } from '../Avatar';
+
+export type AvatarGroupItem = Readonly<{
+  /** 列表内唯一且稳定的身份键。 */
+  key: string;
+  /** 可见回退文字与 Avatar accessible name。 */
+  label: string;
+  source?: ImageSourcePropType;
+  variant?: AvatarVariant;
+}>;
+
+type SharedAvatarGroupProps = {
+  items: readonly AvatarGroupItem[];
+  /** 所有成员共用的尺寸，默认 'md'。 */
+  size?: AvatarSize;
+  /** 所有成员与溢出位共用的形态，默认 'circle'。 */
+  shape?: AvatarShape;
+  /** 最大视觉位数量，包含 +N 溢出位，必须是大于等于 2 的整数。 */
+  max?: number;
+  style?: StyleProp<ViewStyle>;
+  testID?: string;
+};
+
+type StaticOverflowProps = {
+  onOverflowPress?: never;
+  overflowAccessibilityLabel?: never;
+  overflowAccessibilityHint?: never;
+};
+
+type ActionableOverflowProps = {
+  onOverflowPress: () => void;
+  /** 默认按实际数量生成“查看其余 N 位成员”。 */
+  overflowAccessibilityLabel?: string;
+  /** 描述打开弹层、抽屉或跳转等消费端结果。 */
+  overflowAccessibilityHint?: string;
+};
+
+export type AvatarGroupProps = SharedAvatarGroupProps &
+  (StaticOverflowProps | ActionableOverflowProps);

package/src/components/ui/index.ts

@@ -1,5 +1,12 @@
 export { Avatar } from './Avatar';
-export type { AvatarProps, AvatarSize, AvatarVariant } from './Avatar';
+export type {
+  AvatarProps,
+  AvatarShape,
+  AvatarSize,
+  AvatarVariant,
+} from './Avatar';
+export { AvatarGroup } from './AvatarGroup';
+export type { AvatarGroupItem, AvatarGroupProps } from './AvatarGroup';
 export { BlurLayer } from './BlurLayer';
 export type { BlurLayerProps } from './BlurLayer';
 export { Button } from './Button';