@unif/react-native-design 0.28.0 → 0.29.0

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

@@ -0,0 +1,108 @@
+"use strict";
+
+import { Text, View } from 'react-native';
+import Svg, { Circle } from 'react-native-svg';
+import { r, type, useColors } from "../../../theme/index.js";
+import { A11Y_HIDDEN_PROPS } from "../shared/a11y.js";
+import { normalizeCircularProgress } from "./normalizeCircularProgress.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const OUTER_CENTER_STYLE = {
+  alignItems: 'center',
+  justifyContent: 'center'
+};
+const VISUAL_CONTAINER_STYLE = {
+  position: 'relative'
+};
+const LABEL_CENTER_STYLE = {
+  fontWeight: '600',
+  left: 0,
+  position: 'absolute',
+  textAlign: 'center',
+  top: 0
+};
+export function CircularProgress({
+  value,
+  size = r(32),
+  thickness = r(2),
+  color,
+  trackColor,
+  showLabel = false,
+  labelColor,
+  accessibilityLabel = '进度',
+  style,
+  testID
+}) {
+  const colors = useColors();
+  const normalized = normalizeCircularProgress({
+    value,
+    size,
+    thickness
+  });
+  const {
+    circumference,
+    dashOffset,
+    percentage,
+    radius,
+    safeSize,
+    safeThickness
+  } = normalized;
+  const center = safeSize / 2;
+  return /*#__PURE__*/_jsx(View, {
+    accessible: true,
+    accessibilityLabel: accessibilityLabel,
+    accessibilityRole: "progressbar",
+    accessibilityValue: {
+      min: 0,
+      max: 100,
+      now: percentage,
+      text: `${percentage}%`
+    },
+    style: [{
+      height: safeSize,
+      width: safeSize
+    }, style, OUTER_CENTER_STYLE],
+    testID: testID,
+    children: /*#__PURE__*/_jsxs(View, {
+      style: [{
+        height: safeSize,
+        width: safeSize
+      }, VISUAL_CONTAINER_STYLE],
+      ...A11Y_HIDDEN_PROPS,
+      children: [/*#__PURE__*/_jsxs(Svg, {
+        height: safeSize,
+        width: safeSize,
+        children: [/*#__PURE__*/_jsx(Circle, {
+          cx: center,
+          cy: center,
+          fill: "none",
+          r: radius,
+          stroke: trackColor ?? colors.outline,
+          strokeWidth: safeThickness
+        }), /*#__PURE__*/_jsx(Circle, {
+          cx: center,
+          cy: center,
+          fill: "none",
+          r: radius,
+          rotation: -90,
+          originX: center,
+          originY: center,
+          stroke: color ?? colors.primary,
+          strokeDasharray: circumference,
+          strokeDashoffset: dashOffset,
+          strokeLinecap: "round",
+          strokeWidth: safeThickness
+        })]
+      }), showLabel ? /*#__PURE__*/_jsx(Text, {
+        style: [{
+          color: labelColor ?? colors.foreground,
+          fontSize: type.nano,
+          height: safeSize,
+          lineHeight: safeSize,
+          width: safeSize
+        }, LABEL_CENTER_STYLE],
+        children: `${percentage}%`
+      }) : null]
+    })
+  });
+}
+//# sourceMappingURL=CircularProgress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["Text","View","Svg","Circle","r","type","useColors","A11Y_HIDDEN_PROPS","normalizeCircularProgress","jsx","_jsx","jsxs","_jsxs","OUTER_CENTER_STYLE","alignItems","justifyContent","VISUAL_CONTAINER_STYLE","position","LABEL_CENTER_STYLE","fontWeight","left","textAlign","top","CircularProgress","value","size","thickness","color","trackColor","showLabel","labelColor","accessibilityLabel","style","testID","colors","normalized","circumference","dashOffset","percentage","radius","safeSize","safeThickness","center","accessible","accessibilityRole","accessibilityValue","min","max","now","text","height","width","children","cx","cy","fill","stroke","outline","strokeWidth","rotation","originX","originY","primary","strokeDasharray","strokeDashoffset","strokeLinecap","foreground","fontSize","nano","lineHeight"],"sourceRoot":"../../../../../src","sources":["components/ui/CircularProgress/CircularProgress.tsx"],"mappings":"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","ignoreList":[]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"names":["CircularProgress"],"sourceRoot":"../../../../../src","sources":["components/ui/CircularProgress/index.ts"],"mappings":";;AAAA,SAASA,gBAAgB,QAAQ,uBAAoB","ignoreList":[]}

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

@@ -8,6 +8,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","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;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,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/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

@@ -14,6 +14,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.29.0",
   "description": "Unif 设计系统:theme + icons + utils + components",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/components/ui/CircularProgress/CircularProgress.tsx

@@ -0,0 +1,111 @@
+import { Text, View } from 'react-native';
+import type { TextStyle, ViewStyle } from 'react-native';
+import Svg, { Circle } from 'react-native-svg';
+import { r, type, useColors } from '../../../theme';
+import { A11Y_HIDDEN_PROPS } from '../shared/a11y';
+import { normalizeCircularProgress } from './normalizeCircularProgress';
+import type { CircularProgressProps } from './types';
+
+const OUTER_CENTER_STYLE = {
+  alignItems: 'center',
+  justifyContent: 'center',
+} as const satisfies ViewStyle;
+
+const VISUAL_CONTAINER_STYLE = {
+  position: 'relative',
+} as const satisfies ViewStyle;
+
+const LABEL_CENTER_STYLE = {
+  fontWeight: '600',
+  left: 0,
+  position: 'absolute',
+  textAlign: 'center',
+  top: 0,
+} as const satisfies TextStyle;
+
+export function CircularProgress({
+  value,
+  size = r(32),
+  thickness = r(2),
+  color,
+  trackColor,
+  showLabel = false,
+  labelColor,
+  accessibilityLabel = '进度',
+  style,
+  testID,
+}: CircularProgressProps): React.JSX.Element {
+  const colors = useColors();
+  const normalized = normalizeCircularProgress({ value, size, thickness });
+  const {
+    circumference,
+    dashOffset,
+    percentage,
+    radius,
+    safeSize,
+    safeThickness,
+  } = normalized;
+  const center = safeSize / 2;
+
+  return (
+    <View
+      accessible
+      accessibilityLabel={accessibilityLabel}
+      accessibilityRole="progressbar"
+      accessibilityValue={{
+        min: 0,
+        max: 100,
+        now: percentage,
+        text: `${percentage}%`,
+      }}
+      style={[{ height: safeSize, width: safeSize }, style, OUTER_CENTER_STYLE]}
+      testID={testID}
+    >
+      <View
+        style={[{ height: safeSize, width: safeSize }, VISUAL_CONTAINER_STYLE]}
+        {...A11Y_HIDDEN_PROPS}
+      >
+        <Svg height={safeSize} width={safeSize}>
+          <Circle
+            cx={center}
+            cy={center}
+            fill="none"
+            r={radius}
+            stroke={trackColor ?? colors.outline}
+            strokeWidth={safeThickness}
+          />
+          <Circle
+            cx={center}
+            cy={center}
+            fill="none"
+            r={radius}
+            rotation={-90}
+            originX={center}
+            originY={center}
+            stroke={color ?? colors.primary}
+            strokeDasharray={circumference}
+            strokeDashoffset={dashOffset}
+            strokeLinecap="round"
+            strokeWidth={safeThickness}
+          />
+        </Svg>
+        {showLabel ? (
+          <Text
+            style={[
+              {
+                color: labelColor ?? colors.foreground,
+                fontSize: type.nano,
+                height: safeSize,
+                lineHeight: safeSize,
+                width: safeSize,
+              },
+              LABEL_CENTER_STYLE,
+            ]}
+          >
+            {`${percentage}%`}
+          </Text>
+        ) : null}
+      </View>
+    </View>
+  );
+}

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

@@ -0,0 +1,2 @@
+export { CircularProgress } from './CircularProgress';
+export type { CircularProgressProps } from './types';

package/src/components/ui/CircularProgress/normalizeCircularProgress.ts

@@ -0,0 +1,64 @@
+import { createLogger } from '../../../utils/logger';
+
+const log = createLogger('CircularProgress');
+const warnedKeys = new Set<string>();
+
+export type NormalizedCircularProgress = Readonly<{
+  safeValue: number;
+  percentage: number;
+  safeSize: number;
+  safeThickness: number;
+  radius: number;
+  circumference: number;
+  dashOffset: number;
+}>;
+
+function warnOnce(key: string, message: string): void {
+  if (warnedKeys.has(key)) return;
+  warnedKeys.add(key);
+  log.warn(message);
+}
+
+export function normalizeCircularProgress(input: {
+  value: number;
+  size: number;
+  thickness: number;
+}): NormalizedCircularProgress {
+  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),
+  };
+}

package/src/components/ui/CircularProgress/types.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;
+};

package/src/components/ui/index.ts

@@ -20,6 +20,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';