@unif/react-native-design 0.28.0 → 0.30.0

package/lib/module/components/ui/CircularProgress/normalizeCircularProgress.js

@@ -0,0 +1,42 @@
+"use strict";
+
+import { createLogger } from "../../../utils/logger/index.js";
+const log = createLogger('CircularProgress');
+const warnedKeys = new Set();
+function warnOnce(key, message) {
+  if (warnedKeys.has(key)) return;
+  warnedKeys.add(key);
+  log.warn(message);
+}
+export function normalizeCircularProgress(input) {
+  const {
+    value,
+    size,
+    thickness
+  } = input;
+  if (!Number.isFinite(value) || value < 0 || value > 1) {
+    warnOnce(`value:${value}`, `value 应为 0..1 的有限数，传入 ${value}，已收敛到安全范围`);
+  }
+  if (!Number.isFinite(size) || size < 16) {
+    warnOnce(`size:${size}`, `size 应为 ≥16 的有限数，传入 ${size}，已钳到 16`);
+  }
+  if (!Number.isFinite(thickness) || thickness <= 0) {
+    warnOnce(`thickness:${thickness}`, `thickness 应为正有限数，传入 ${thickness}，已 fallback 为 2`);
+  }
+  const safeValue = Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : 0;
+  const safeSize = Number.isFinite(size) && size >= 16 ? size : 16;
+  const fallbackThickness = Number.isFinite(thickness) && thickness > 0 ? thickness : 2;
+  const safeThickness = Math.min(fallbackThickness, safeSize / 2);
+  const radius = (safeSize - safeThickness) / 2;
+  const circumference = 2 * Math.PI * radius;
+  return {
+    safeValue,
+    percentage: Math.round(safeValue * 100),
+    safeSize,
+    safeThickness,
+    radius,
+    circumference,
+    dashOffset: circumference * (1 - safeValue)
+  };
+}
+//# sourceMappingURL=normalizeCircularProgress.js.map

package/lib/module/components/ui/CircularProgress/normalizeCircularProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createLogger","log","warnedKeys","Set","warnOnce","key","message","has","add","warn","normalizeCircularProgress","input","value","size","thickness","Number","isFinite","safeValue","Math","min","max","safeSize","fallbackThickness","safeThickness","radius","circumference","PI","percentage","round","dashOffset"],"sourceRoot":"../../../../../src","sources":["components/ui/CircularProgress/normalizeCircularProgress.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,gCAAuB;AAEpD,MAAMC,GAAG,GAAGD,YAAY,CAAC,kBAAkB,CAAC;AAC5C,MAAME,UAAU,GAAG,IAAIC,GAAG,CAAS,CAAC;AAYpC,SAASC,QAAQA,CAACC,GAAW,EAAEC,OAAe,EAAQ;EACpD,IAAIJ,UAAU,CAACK,GAAG,CAACF,GAAG,CAAC,EAAE;EACzBH,UAAU,CAACM,GAAG,CAACH,GAAG,CAAC;EACnBJ,GAAG,CAACQ,IAAI,CAACH,OAAO,CAAC;AACnB;AAEA,OAAO,SAASI,yBAAyBA,CAACC,KAIzC,EAA8B;EAC7B,MAAM;IAAEC,KAAK;IAAEC,IAAI;IAAEC;EAAU,CAAC,GAAGH,KAAK;EAExC,IAAI,CAACI,MAAM,CAACC,QAAQ,CAACJ,KAAK,CAAC,IAAIA,KAAK,GAAG,CAAC,IAAIA,KAAK,GAAG,CAAC,EAAE;IACrDR,QAAQ,CACN,SAASQ,KAAK,EAAE,EAChB,yBAAyBA,KAAK,WAChC,CAAC;EACH;EACA,IAAI,CAACG,MAAM,CAACC,QAAQ,CAACH,IAAI,CAAC,IAAIA,IAAI,GAAG,EAAE,EAAE;IACvCT,QAAQ,CAAC,QAAQS,IAAI,EAAE,EAAE,uBAAuBA,IAAI,SAAS,CAAC;EAChE;EACA,IAAI,CAACE,MAAM,CAACC,QAAQ,CAACF,SAAS,CAAC,IAAIA,SAAS,IAAI,CAAC,EAAE;IACjDV,QAAQ,CACN,aAAaU,SAAS,EAAE,EACxB,uBAAuBA,SAAS,iBAClC,CAAC;EACH;EAEA,MAAMG,SAAS,GAAGF,MAAM,CAACC,QAAQ,CAACJ,KAAK,CAAC,GACpCM,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,GAAG,CAAC,CAAC,EAAER,KAAK,CAAC,CAAC,GAC/B,CAAC;EACL,MAAMS,QAAQ,GAAGN,MAAM,CAACC,QAAQ,CAACH,IAAI,CAAC,IAAIA,IAAI,IAAI,EAAE,GAAGA,IAAI,GAAG,EAAE;EAChE,MAAMS,iBAAiB,GACrBP,MAAM,CAACC,QAAQ,CAACF,SAAS,CAAC,IAAIA,SAAS,GAAG,CAAC,GAAGA,SAAS,GAAG,CAAC;EAC7D,MAAMS,aAAa,GAAGL,IAAI,CAACC,GAAG,CAACG,iBAAiB,EAAED,QAAQ,GAAG,CAAC,CAAC;EAC/D,MAAMG,MAAM,GAAG,CAACH,QAAQ,GAAGE,aAAa,IAAI,CAAC;EAC7C,MAAME,aAAa,GAAG,CAAC,GAAGP,IAAI,CAACQ,EAAE,GAAGF,MAAM;EAE1C,OAAO;IACLP,SAAS;IACTU,UAAU,EAAET,IAAI,CAACU,KAAK,CAACX,SAAS,GAAG,GAAG,CAAC;IACvCI,QAAQ;IACRE,aAAa;IACbC,MAAM;IACNC,aAAa;IACbI,UAAU,EAAEJ,aAAa,IAAI,CAAC,GAAGR,SAAS;EAC5C,CAAC;AACH","ignoreList":[]}

package/lib/module/components/ui/CircularProgress/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=types.js.map

package/lib/module/components/ui/CircularProgress/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["components/ui/CircularProgress/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/components/ui/index.js

@@ -1,6 +1,7 @@
 "use strict";
 
 export { Avatar } from "./Avatar/index.js";
+export { AvatarGroup } from "./AvatarGroup/index.js";
 export { BlurLayer } from "./BlurLayer/index.js";
 export { Button } from "./Button/index.js";
 export { Card } from "./Card/index.js";
@@ -8,6 +9,7 @@ export { Carousel } from "./Carousel/index.js";
 export { Cell, List } from "./Cell/index.js";
 export { Checkbox } from "./Checkbox/index.js";
 export { Chip } from "./Chip/index.js";
+export { CircularProgress } from "./CircularProgress/index.js";
 export { confirm, ConfirmHost } from "./Confirm/index.js";
 export { DrawerHeader } from "./DrawerHeader/index.js";
 export { Empty } from "./Empty/index.js";

package/lib/module/components/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Avatar","BlurLayer","Button","Card","Carousel","Cell","List","Checkbox","Chip","confirm","ConfirmHost","DrawerHeader","Empty","EntryCard","Form","FormGroup","FormRow","Grid","Icon","IconButton","Input","Logo","NavBar","PasswordInput","Pulse","PulseDot","usePulse","Radio","Reveal","Ribbon","Search","Skeleton","Segmented","Spinner","StatusDot","Stepper","Switch","TabBar","Tabs","Tag","Textarea","Thumbnail","toast","ToastHost"],"sourceRoot":"../../../../src","sources":["components/ui/index.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,mBAAU;AAEjC,SAASC,SAAS,QAAQ,sBAAa;AAEvC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,QAAQ,QAAQ,qBAAY;AAErC,SAASC,IAAI,EAAEC,IAAI,QAAQ,iBAAQ;AAQnC,SAASC,QAAQ,QAAQ,qBAAY;AAErC,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,OAAO,EAAEC,WAAW,QAAQ,oBAAW;AAEhD,SAASC,YAAY,QAAQ,yBAAgB;AAE7C,SAASC,KAAK,QAAQ,kBAAS;AAE/B,SAASC,SAAS,QAAQ,sBAAa;AAEvC,SAASC,IAAI,EAAEC,SAAS,EAAEC,OAAO,QAAQ,iBAAQ;AAEjD,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,UAAU,QAAQ,uBAAc;AAEzC,SAASC,KAAK,QAAQ,kBAAS;AAO/B,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,aAAa,QAAQ,0BAAiB;AAE/C,SAASC,KAAK,EAAEC,QAAQ,EAAEC,QAAQ,QAAQ,kBAAS;AAEnD,SAASC,KAAK,QAAQ,kBAAS;AAE/B,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,QAAQ,QAAQ,qBAAY;AAErC,SAASC,SAAS,QAAQ,sBAAa;AAEvC,SAASC,OAAO,QAAQ,oBAAW;AAEnC,SAASC,SAAS,QAAQ,sBAAa;AAMvC,SAASC,OAAO,QAAQ,oBAAW;AAEnC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,GAAG,QAAQ,gBAAO;AAE3B,SAASC,QAAQ,QAAQ,qBAAY;AAErC,SAASC,SAAS,QAAQ,sBAAa;AAMvC,SAASC,KAAK,EAAEC,SAAS,QAAQ,kBAAS","ignoreList":[]}
+{"version":3,"names":["Avatar","AvatarGroup","BlurLayer","Button","Card","Carousel","Cell","List","Checkbox","Chip","CircularProgress","confirm","ConfirmHost","DrawerHeader","Empty","EntryCard","Form","FormGroup","FormRow","Grid","Icon","IconButton","Input","Logo","NavBar","PasswordInput","Pulse","PulseDot","usePulse","Radio","Reveal","Ribbon","Search","Skeleton","Segmented","Spinner","StatusDot","Stepper","Switch","TabBar","Tabs","Tag","Textarea","Thumbnail","toast","ToastHost"],"sourceRoot":"../../../../src","sources":["components/ui/index.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,mBAAU;AAOjC,SAASC,WAAW,QAAQ,wBAAe;AAE3C,SAASC,SAAS,QAAQ,sBAAa;AAEvC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,QAAQ,QAAQ,qBAAY;AAErC,SAASC,IAAI,EAAEC,IAAI,QAAQ,iBAAQ;AAQnC,SAASC,QAAQ,QAAQ,qBAAY;AAErC,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,gBAAgB,QAAQ,6BAAoB;AAErD,SAASC,OAAO,EAAEC,WAAW,QAAQ,oBAAW;AAEhD,SAASC,YAAY,QAAQ,yBAAgB;AAE7C,SAASC,KAAK,QAAQ,kBAAS;AAE/B,SAASC,SAAS,QAAQ,sBAAa;AAEvC,SAASC,IAAI,EAAEC,SAAS,EAAEC,OAAO,QAAQ,iBAAQ;AAEjD,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,UAAU,QAAQ,uBAAc;AAEzC,SAASC,KAAK,QAAQ,kBAAS;AAO/B,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,aAAa,QAAQ,0BAAiB;AAE/C,SAASC,KAAK,EAAEC,QAAQ,EAAEC,QAAQ,QAAQ,kBAAS;AAEnD,SAASC,KAAK,QAAQ,kBAAS;AAE/B,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,QAAQ,QAAQ,qBAAY;AAErC,SAASC,SAAS,QAAQ,sBAAa;AAEvC,SAASC,OAAO,QAAQ,oBAAW;AAEnC,SAASC,SAAS,QAAQ,sBAAa;AAMvC,SAASC,OAAO,QAAQ,oBAAW;AAEnC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,MAAM,QAAQ,mBAAU;AAEjC,SAASC,IAAI,QAAQ,iBAAQ;AAE7B,SAASC,GAAG,QAAQ,gBAAO;AAE3B,SAASC,QAAQ,QAAQ,qBAAY;AAErC,SAASC,SAAS,QAAQ,sBAAa;AAMvC,SAASC,KAAK,EAAEC,SAAS,QAAQ,kBAAS","ignoreList":[]}

package/lib/typescript/manual-tests/runtime-api/RuntimeApiScreen.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 /**
  * Runtime API 人工验证屏 —— 由 `yarn create:runtime-harness` 拷进临时的
- * RN 0.86.2 app 里跑,**不属于任何自动化测试**。
+ * RN 0.86.3 app 里跑,**不属于任何自动化测试**。
  *
  * 它只 import 包根 barrel(与真实消费者一致),用来验证 Jest 覆盖不到的部分:
  * 真实 native / Web 结构、44pt 命中框、a11y tree、reduced motion 和竞态。

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

@@ -1,10 +1,10 @@
 import React from 'react';
 import type { AvatarProps } from './types';
 /**
- * 圆形头像 —— 5 档尺寸 × 4 种配色 × 可选图片 source。
+ * 头像 —— 2 种形态 × 5 档尺寸 × 4 种配色 × 可选图片 source。
  *
  * 合法 source 由 keyed ImageAttempt 独立持有失败状态；非法 source 或加载失败
  * 时渲染 label + variant 背景色。
  */
-export declare function Avatar({ label, size, variant, source, style, testID, }: AvatarProps): React.JSX.Element;
+export declare function Avatar({ label, size, shape, variant, source, style, testID, }: AvatarProps): React.JSX.Element;
 //# sourceMappingURL=Avatar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,IAAW,EACX,OAAmB,EACnB,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6CjC"}
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,IAAW,EACX,KAAgB,EAChB,OAAmB,EACnB,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6CjC"}

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

@@ -1,3 +1,3 @@
 export { Avatar } from './Avatar';
-export type { AvatarProps, AvatarSize, AvatarVariant } from './types';
+export type { AvatarProps, AvatarShape, AvatarSize, AvatarVariant, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC"}

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

@@ -1,6 +1,6 @@
 import { type ColorTokens } from '../../../theme';
-import type { AvatarSize, AvatarVariant } from './types';
-/** Avatar 静态 base —— 圆形容器(borderRadius / 尺寸由 sizingFor 派生)。 */
+import type { AvatarShape, AvatarSize, AvatarVariant } from './types';
+/** Avatar 静态 base —— 容器圆角 / 尺寸由 resolver 派生。 */
 export declare const styles: Readonly<{
     base: {
         alignItems: "center";
@@ -22,6 +22,8 @@ export declare function sizingFor(size: AvatarSize): {
     box: number;
     fs: number;
 };
+/** circle 保留直径一半的现有视觉；square 按尺寸使用既有圆角 token。 */
+export declare function resolveAvatarBorderRadius(size: AvatarSize, shape: AvatarShape): number;
 /** Avatar 配色推导:4 种 variant → { bg, fg }。签名与 Tag/Button 的 paletteFor 一致。 */
 export declare function paletteFor(variant: AvatarVariant, c: ColorTokens): {
     bg: string;

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

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/styles.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEzD,+DAA+D;AAC/D,eAAO,MAAM,MAAM;;;;;;;;;;;;;;EAcjB,CAAC;AAEH;wEACwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAavE;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EACtB,CAAC,EAAE,WAAW,GACb;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAW5B"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/styles.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtE,gDAAgD;AAChD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;EAcjB,CAAC;AAEH;wEACwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAavE;AAED,iDAAiD;AACjD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,WAAW,GACjB,MAAM,CAKR;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,EACtB,CAAC,EAAE,WAAW,GACb;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAW5B"}

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

@@ -1,6 +1,8 @@
 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 头像专用）
@@ -17,6 +19,8 @@ export type AvatarProps = {
     label: string;
     /** 尺寸，默认 'md' */
     size?: AvatarSize;
+    /** 形态，默认 'circle' */
+    shape?: AvatarShape;
     /** 配色变体，默认 'neutral' */
     variant?: AvatarVariant;
     /**

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/CircularProgress/CircularProgress.d.ts

@@ -0,0 +1,3 @@
+import type { CircularProgressProps } from './types';
+export declare function CircularProgress({ value, size, thickness, color, trackColor, showLabel, labelColor, accessibilityLabel, style, testID, }: CircularProgressProps): React.JSX.Element;
+//# sourceMappingURL=CircularProgress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CircularProgress.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/CircularProgress/CircularProgress.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAmBrD,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,IAAY,EACZ,SAAgB,EAChB,KAAK,EACL,UAAU,EACV,SAAiB,EACjB,UAAU,EACV,kBAAyB,EACzB,KAAK,EACL,MAAM,GACP,EAAE,qBAAqB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0E3C"}

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

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

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

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

package/lib/typescript/src/components/ui/CircularProgress/normalizeCircularProgress.d.ts

@@ -0,0 +1,15 @@
+export type NormalizedCircularProgress = Readonly<{
+    safeValue: number;
+    percentage: number;
+    safeSize: number;
+    safeThickness: number;
+    radius: number;
+    circumference: number;
+    dashOffset: number;
+}>;
+export declare function normalizeCircularProgress(input: {
+    value: number;
+    size: number;
+    thickness: number;
+}): NormalizedCircularProgress;
+//# sourceMappingURL=normalizeCircularProgress.d.ts.map

package/lib/typescript/src/components/ui/CircularProgress/normalizeCircularProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeCircularProgress.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/CircularProgress/normalizeCircularProgress.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAQH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,0BAA0B,CAsC7B"}

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

@@ -0,0 +1,24 @@
+import type { StyleProp, ViewStyle } from 'react-native';
+export type CircularProgressProps = {
+    /** 当前进度，使用 0..1；越界值会收敛到边界，非有限值按 0 处理。 */
+    value: number;
+    /** 圆环直径，默认 32，最小 16。 */
+    size?: number;
+    /** 圆环描边宽度，默认 2，最大为半径。 */
+    thickness?: number;
+    /** 进度颜色，默认 c.primary。 */
+    color?: string;
+    /** 轨道颜色，默认 c.outline。 */
+    trackColor?: string;
+    /** 是否在圆环中央显示取整后的百分比，默认 false。 */
+    showLabel?: boolean;
+    /** 百分比文字颜色，默认 c.foreground。 */
+    labelColor?: string;
+    /** 进度条可访问性名称，默认“进度”。 */
+    accessibilityLabel?: string;
+    /** 外层布局样式。 */
+    style?: StyleProp<ViewStyle>;
+    /** E2E / 测试定位。 */
+    testID?: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/CircularProgress/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,qBAAqB,GAAG;IAClC,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc;IACd,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,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';
@@ -14,6 +16,8 @@ export { Checkbox } from './Checkbox';
 export type { CheckboxProps } from './Checkbox';
 export { Chip } from './Chip';
 export type { ChipProps } from './Chip';
+export { CircularProgress } from './CircularProgress';
+export type { CircularProgressProps } from './CircularProgress';
 export { confirm, ConfirmHost } from './Confirm';
 export type { ConfirmOptions } from './Confirm';
 export { DrawerHeader } from './DrawerHeader';

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.28.0",
+  "version": "0.30.0",
   "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;
   /**