@unif/react-native-design 0.19.0 → 0.21.0

package/lib/typescript/src/components/ui/NavBar/isSlot.d.ts

@@ -1,7 +1,27 @@
-import type { NavBarSlotConfig } from './types';
+import { type ReactNode } from 'react';
+import type { NavBarAction } from './types';
+export type NavBarSlotClassification = {
+    kind: 'empty';
+} | {
+    kind: 'action';
+    action: NavBarAction;
+} | {
+    kind: 'node';
+    node: ReactNode;
+} | {
+    kind: 'invalid';
+};
 /**
- * Type guard：判断 left/right 是否为 NavBarSlotConfig 对象（含 icon 字段）。
- * 不是的话视为 ReactNode 自定义内容。
+ * Type guard：action 的 icon 必须真实存在于生成的 registry，且有 handler 与非空名称。
  */
-export declare function isSlot(v: unknown): v is NavBarSlotConfig;
+export declare function isNavBarAction(v: unknown): v is NavBarAction;
+/**
+ * 未类型化边界的单一分类器。React 的公开 API 无法证明 object 不可伪造；这里拒绝
+ * 结构不成立的 marker-only element 与普通 plain object，同时保留 React 19 声明的
+ * bigint、Iterable、portal、Promise/thenable 等合法 ReactNode。Fragment/Iterable
+ * 会递归验证 primitive 叶子；thenable 映射按源对象缓存，避免每次 render 制造新的
+ * suspend identity；resolution record 的依赖可达性同时拦截 direct/indirect cycle，
+ * 并把 cycle 或非法 resolved value 确定性失败关闭为 null。
+ */
+export declare function classifyNavBarSlot(value: unknown): NavBarSlotClassification;
 //# sourceMappingURL=isSlot.d.ts.map

package/lib/typescript/src/components/ui/NavBar/isSlot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isSlot.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/NavBar/isSlot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,gBAAgB,CAExD"}
+{"version":3,"file":"isSlot.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/NavBar/isSlot.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAuBxB;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,YAAY,CAS5D;AA6TD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAM3E"}

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

@@ -1,22 +1,22 @@
 import type { ReactNode } from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
 import type { IconName } from '../Icon';
-export type NavBarSlotConfig = {
+export type NavBarAction = {
     icon: IconName;
-    onPress?: () => void;
-    /** 屏幕阅读器读出的功能描述。强烈建议传 —— icon-only 按钮无文字,缺省时 SR 回退
-     *  读英文 icon 名(如 "menu")且 dev 下告警。请传人类可读短语(如「返回」「更多」)。 */
-    accessibilityLabel?: string;
+    onPress: () => void;
+    /** 屏幕阅读器读出的非空功能描述。 */
+    accessibilityLabel: string;
 };
+export type NavBarSlot = NavBarAction | ReactNode;
 export type NavBarProps = {
     /** 主标题 */
     title: string;
     /** 副标题（可选，主标题下方一行） */
     subtitle?: string;
-    /** 左侧槽位：传 NavBarSlotConfig 自动用 IconButton 渲染 / 传 ReactNode 自定义 */
-    left?: ReactNode | NavBarSlotConfig;
+    /** 左侧槽位：传 NavBarAction 自动用 IconButton 渲染 / 传 ReactNode 自定义 */
+    left?: NavBarSlot;
     /** 右侧槽位：同 left */
-    right?: ReactNode | NavBarSlotConfig;
+    right?: NavBarSlot;
     /**
      * 视觉变体，默认 'default'：
      * - `default`：白底 + hairline 底边

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/NavBar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;6DACyD;IACzD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,IAAI,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACpC,kBAAkB;IAClB,KAAK,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACrC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;IAC9C,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/NavBar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,sBAAsB;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;AAElD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,kBAAkB;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;IAC9C,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/PasswordInput/PasswordInput.d.ts

@@ -1,16 +1,8 @@
 import React from 'react';
-import type { PasswordInputProps } from './types';
-/**
- * 密码 Input —— Input + leading lock + trailing eye 切换明文 / 密文。
- *
- * [L-32] 增强:
- * - forwardRef<TextInput> —— 业务表单 focus() 聚焦
- * - inputProps 类型改为 Omit<TextInputProps,'secureTextEntry'>
- * - 补 textContentType='password' / autoComplete='current-password' / autoCapitalize='none' 默认值
- * - 暴露 error / disabled 透传给底层 Input
- *
- * showPw 内部 useState,caller 只关心 value/onChangeText。
- * a11y:label 已表达"显示/隐藏密码"意图,不再加 accessibilityHint(避免 SR 朗读 over-hint)。
- */
-export declare const PasswordInput: React.ForwardRefExoticComponent<PasswordInputProps & React.RefAttributes<import("react-native/types_generated/Libraries/Components/TextInput/TextInput.flow")._TextInputInstance>>;
+import type { TextFieldHandle } from '../TextField/types';
+/** 密码输入:只切换 secureTextEntry,不改变调用方持有的受控文本或焦点。 */
+export declare const PasswordInput: React.ForwardRefExoticComponent<Omit<import("..").InputProps, "value" | "defaultValue" | "onChangeText" | "secureTextEntry" | "leading" | "trailing"> & {
+    value: string;
+    onChangeText: (value: string) => void;
+} & React.RefAttributes<TextFieldHandle>>;
 //# sourceMappingURL=PasswordInput.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PasswordInput.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/PasswordInput/PasswordInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAQpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,oLA2DzB,CAAC"}
+{"version":3,"file":"PasswordInput.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/PasswordInput/PasswordInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,oBAAoB,CAAC;AAMzE,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;yCAsEzB,CAAC"}

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

@@ -1,17 +1,7 @@
-import type { TextInputProps } from 'react-native';
-export type PasswordInputProps = {
+import type { InputProps } from '../Input';
+/** 密码必须受控,且所有可用 TextInput 选项都以顶层 props 提供。 */
+export type PasswordInputProps = Omit<InputProps, 'value' | 'defaultValue' | 'onChangeText' | 'secureTextEntry' | 'leading' | 'trailing'> & {
     value: string;
-    onChangeText: (v: string) => void;
-    /** 默认 "请输入密码" */
-    placeholder?: string;
-    testID?: string;
-    /** 错误信息 —— 传入时 Input 进入 error 态并在下方显示 */
-    error?: string;
-    /** 整体禁用:等价于 editable=false + 视觉变灰 */
-    disabled?: boolean;
-    /** 透传给底层 Input 的其他 RN TextInput 属性(maxLength / autoFocus 等)。
-     *  ⚠ 不要传 secureTextEntry,组件自管;传了会被组件内部覆盖。
-     *  [L-32] 类型显式 Omit<TextInputProps,'secureTextEntry'> 封堵传入歧义 */
-    inputProps?: Omit<TextInputProps, 'secureTextEntry'>;
+    onChangeText: (value: string) => void;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/PasswordInput/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,iBAAiB;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;oEAEgE;IAChE,UAAU,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;CACtD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/PasswordInput/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,UAAU,EACR,OAAO,GACP,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,SAAS,GACT,UAAU,CACb,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC"}

package/lib/typescript/src/components/ui/Pulse/PulseDot.d.ts

@@ -1,4 +1,4 @@
 import React from 'react';
 import type { PulseDotProps } from './types';
-export declare function PulseDot({ size, color, from, style, testID, ...opts }?: PulseDotProps): React.JSX.Element;
+export declare function PulseDot({ size, color, style, testID, ...opts }?: PulseDotProps): React.JSX.Element;
 //# sourceMappingURL=PulseDot.d.ts.map

package/lib/typescript/src/components/ui/Pulse/PulseDot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PulseDot.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Pulse/PulseDot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,wBAAgB,QAAQ,CAAC,EACvB,IAAW,EACX,KAAK,EACL,IAAU,EACV,KAAK,EACL,MAAM,EACN,GAAG,IAAI,EACR,GAAE,aAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAsBxC"}
+{"version":3,"file":"PulseDot.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Pulse/PulseDot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,wBAAgB,QAAQ,CAAC,EACvB,IAAW,EACX,KAAK,EACL,KAAK,EACL,MAAM,EACN,GAAG,IAAI,EACR,GAAE,aAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAwBxC"}

package/lib/typescript/src/components/ui/Pulse/normalizePulseOptions.d.ts

@@ -0,0 +1,32 @@
+import type { PulseOptions } from './types';
+export type { PulseOptions };
+/**
+ * Pulse 参数的**唯一**归一化入口 —— 公共 hook 先跑完这里,平台 driver 只消费产物。
+ *
+ * 为什么要单独一层:此前 native / web 两份 `usePulse` 各自读原始 props 并各自解释
+ * 默认值,web 侧甚至把未校验的 `duration` 直接喂给 `setInterval`(0 或 2^31 会退化成
+ * 「每帧触发」)。归一化收口后,两端拿到的一定是同一组已验证数值。
+ *
+ * 纪律:**不做 clamp、不做取整**。非法值一律整体回退到 defaults 并记一条诊断 ——
+ * 悄悄把 `duration: 0` 夹成 `1` 会让调用方永远发现不了自己传错了。
+ */
+export type PulseDefaults = {
+    duration: number;
+    delay: number;
+    from: number;
+    to: number;
+};
+export type PulseDiagnostic = {
+    field: keyof PulseDefaults;
+    received: unknown;
+    fallback: number;
+};
+export type NormalizedPulseOptions = PulseDefaults & {
+    /** 两端相等 —— 没有可播的动画,driver 直接停在 `to`。 */
+    isStatic: boolean;
+    diagnostics: readonly PulseDiagnostic[];
+};
+export declare function normalizePulseOptions(input: PulseOptions | undefined, defaults: PulseDefaults): NormalizedPulseOptions;
+/** driver 是否应当启动循环。静态或系统开启减弱动效时都不启动。 */
+export declare const shouldAnimatePulse: (options: NormalizedPulseOptions, reducedMotion: boolean) => boolean;
+//# sourceMappingURL=normalizePulseOptions.d.ts.map

package/lib/typescript/src/components/ui/Pulse/normalizePulseOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizePulseOptions.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Pulse/normalizePulseOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B;;;;;;;;;GASG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,aAAa,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG;IACnD,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CACzC,CAAC;AAKF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,YAAK,EACxB,QAAQ,EAAE,aAAa,GACtB,sBAAsB,CA6BxB;AAED,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,GAC7B,SAAS,sBAAsB,EAC/B,eAAe,OAAO,KACrB,OAA8C,CAAC"}

package/lib/typescript/src/components/ui/Pulse/usePulse.d.ts

@@ -1,9 +1,14 @@
+import type { PulseDefaults } from './normalizePulseOptions';
 import type { PulseOptions } from './types';
-/**
- * 在两个 opacity 值之间无限循环，返回可直接拼到 Animated.View 上的 style。
- * 走 reanimated 4 的 worklet，整个动画在 UI 线程跑、不占 JS 桥。
- */
-export declare function usePulse({ from, to, duration, delay, }?: PulseOptions): import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
+/** PulseDot / Skeleton 的默认值 —— 只有 from 更低,圆点 / 骨架淡到 0.5。 */
+export declare const DOT_DEFAULTS: PulseDefaults;
+/** 诊断告警的固定 scope 集合。 */
+export type PulseScope = 'Pulse' | 'PulseDot' | 'Skeleton';
+/** 内部:让 PulseDot / Skeleton 复用同一条归一化 + 诊断 + driver 链路。 */
+export declare function usePulseWithDefaults(options: PulseOptions | undefined, defaults: PulseDefaults, scope: PulseScope): import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
+    opacity: number;
+}>;
+export declare function usePulse(options?: PulseOptions): import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
     opacity: number;
 }>;
 //# sourceMappingURL=usePulse.d.ts.map

package/lib/typescript/src/components/ui/Pulse/usePulse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePulse.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Pulse/usePulse.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAU,EACV,EAAM,EACN,QAAc,EACd,KAAS,GACV,GAAE,YAAiB;;GAmBnB"}
+{"version":3,"file":"usePulse.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Pulse/usePulse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAiB5C,4DAA4D;AAC5D,eAAO,MAAM,YAAY,EAAE,aAK1B,CAAC;AAOF,wBAAwB;AACxB,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAa3D,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,UAAU;;GA6BlB;AAED,wBAAgB,QAAQ,CAAC,OAAO,GAAE,YAAiB;;GAElD"}

package/lib/typescript/src/components/ui/Pulse/usePulseDriver.d.ts

@@ -0,0 +1,11 @@
+import type { NormalizedPulseOptions } from './normalizePulseOptions';
+/**
+ * native Pulse driver —— reanimated 4 worklet,整个动画在 UI 线程跑、不占 JS 桥。
+ *
+ * **只接受归一化产物**:duration / delay / from / to 都已验证过,这里不再读原始 props,
+ * 也不再解释默认值。平台差异只到这一层为止。
+ */
+export declare function usePulseDriver(options: NormalizedPulseOptions): import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
+    opacity: number;
+}>;
+//# sourceMappingURL=usePulseDriver.d.ts.map

package/lib/typescript/src/components/ui/Pulse/usePulseDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePulseDriver.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Pulse/usePulseDriver.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,sBAAsB;;GA4B7D"}

package/lib/typescript/src/components/ui/Pulse/usePulseDriver.web.d.ts

@@ -0,0 +1,18 @@
+import type { ImageStyle, TextStyle, ViewStyle } from 'react-native';
+import type { NormalizedPulseOptions } from './normalizePulseOptions';
+/**
+ * Web Pulse driver —— RN-Web 上 reanimated 的 `useAnimatedStyle` 链路会在
+ * `_updatePropsJS` 里对 undefined 取 `Object.keys` 而抛 TypeError,pulse 卡死在初始值。
+ * 故 web 走 **CSS transition 降级**(零 rAF JS 帧):
+ *
+ * - `setInterval` 每隔 `duration` ms 只在 from / to 两档翻转 opacity
+ *   —— setState 频率从 ~60fps 降到 1 次/duration ms(参 ToastHost.web.tsx)
+ * - 补间交给浏览器 CSS transition,JS 侧零插值
+ *
+ * **只接受归一化产物**:duration 已被验证在 `[1, 2^31)`,不会出现 `setInterval(0)`
+ * 那种「每帧触发」的退化。web 端**不跑 worklet** —— 别在文档里宣称它跑。
+ */
+export declare function usePulseDriver(options: NormalizedPulseOptions): (ViewStyle | TextStyle | ImageStyle) & {
+    transition?: string;
+};
+//# sourceMappingURL=usePulseDriver.web.d.ts.map

package/lib/typescript/src/components/ui/Pulse/usePulseDriver.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePulseDriver.web.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Pulse/usePulseDriver.web.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,sBAAsB,GA8CvD,CAAC,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CACpE"}

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

@@ -4,7 +4,7 @@ import type { RadioProps } from './types';
 /**
  * 单个 radio 选项。必须放在 `<Radio.Group>` 里使用。
  */
-export declare function Radio({ value, label, disabled, testID, }: RadioProps): React.JSX.Element;
+export declare function Radio({ value, label, accessibilityLabel, disabled, testID, }: RadioProps): React.JSX.Element;
 export declare namespace Radio {
     var Group: typeof RadioGroup;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Radio.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Radio/Radio.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqB,MAAM,OAAO,CAAC;AAc1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAO1C;;GAEG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,GACP,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA4ChC;yBAjDe,KAAK"}
+{"version":3,"file":"Radio.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Radio/Radio.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgC,MAAM,OAAO,CAAC;AAgBrD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAO1C;;GAEG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,KAAK,EACL,kBAAkB,EAClB,QAAQ,EACR,MAAM,GACP,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAsEhC;yBA5Ee,KAAK"}

package/lib/typescript/src/components/ui/Radio/RadioGroup.d.ts

@@ -3,10 +3,10 @@ import type { GroupProps } from './types';
 /**
  * Radio 组 —— 单选。把若干 `<Radio>` 作为 children 放进来。
  *
- * <Radio.Group value={tier} onChange={setTier}>
+ * <Radio.Group value={tier} onChange={setTier} accessibilityLabel="客户等级">
  *   <Radio value="vip"     label="VIP 客户" />
  *   <Radio value="normal"  label="普通客户" />
  * </Radio.Group>
  */
-export declare function RadioGroup({ value, onChange, children, testID, }: GroupProps): React.JSX.Element;
+export declare function RadioGroup({ value, onChange, accessibilityLabel, children, testID, }: GroupProps): React.JSX.Element;
 //# sourceMappingURL=RadioGroup.d.ts.map

package/lib/typescript/src/components/ui/Radio/RadioGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Radio/RadioGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,MAAM,GACP,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAgBhC"}
+{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Radio/RadioGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6B,MAAM,OAAO,CAAC;AAOlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,MAAM,GACP,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6BhC"}

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

@@ -1,6 +1,15 @@
 import type { ReactNode } from 'react';
 /** Radio 选项值类型 */
 export type Value = string | number;
+type AccessibleName = {
+    /** 可见旁标同时提供 accessible name；可显式覆盖读屏文案 */
+    label: string;
+    accessibilityLabel?: string;
+} | {
+    /** 无可见旁标时必须显式提供 accessible name */
+    label?: never;
+    accessibilityLabel: string;
+};
 export type GroupContext = {
     /** 当前选中值 */
     value: Value;
@@ -14,16 +23,16 @@ export type GroupProps = {
     value: Value;
     /** 选中变化回调 */
     onChange: (value: Value) => void;
+    /** 单选组自身的读屏名称 */
+    accessibilityLabel: string;
     /** 若干个 Radio 子项 */
     children: ReactNode;
     /** E2E / 测试定位 */
     testID?: string;
 };
-export type RadioProps = {
+type RadioBehaviorProps = {
     /** 此项的值 */
     value: Value;
-    /** 此项右侧文字 */
-    label?: string;
     /** 禁用 */
     disabled?: boolean;
     /**
@@ -32,4 +41,6 @@ export type RadioProps = {
      */
     testID?: string;
 };
+export type RadioProps = RadioBehaviorProps & AccessibleName;
+export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Radio/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,kBAAkB;AAClB,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpC,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,aAAa;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,gBAAgB;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,aAAa;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,mBAAmB;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW;IACX,KAAK,EAAE,KAAK,CAAC;IACb,aAAa;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS;IACT,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Radio/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,kBAAkB;AAClB,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpC,KAAK,cAAc,GACf;IACE,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GACD;IACE,mCAAmC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,aAAa;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,gBAAgB;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,aAAa;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,iBAAiB;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,WAAW;IACX,KAAK,EAAE,KAAK,CAAC;IACb,SAAS;IACT,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,cAAc,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"Reveal.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Reveal/Reveal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,EACrB,QAAQ,EACR,KAAK,EACL,QAAsB,EACtB,MAAM,GACP,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAWjC"}
+{"version":3,"file":"Reveal.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Reveal/Reveal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,EACrB,QAAQ,EACR,KAAK,EACL,QAAsB,EACtB,MAAM,GACP,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAajC"}

package/lib/typescript/src/components/ui/Reveal/Reveal.web.d.ts

@@ -6,14 +6,8 @@ import type { RevealProps } from './types';
  * 改用 React state + CSS transition 复刻入场淡入。退场在 web 省略（消费者卸载即移除）;
  * native 走 Reveal.tsx 的 reanimated 实现。
  *
- * **结构分叉说明（三层容器）**：
- * - 外层 `<View style={style}>` —— 承接 RN StyleSheet 样式（flex/margin/padding 等），
- *   与 native Reveal 保持相同的容器语义；
- * - 中间 `<div style={animatedWebStyle}>` —— CSS opacity transition 动画层；
- *   必须是真正的 DOM 元素才能触发 CSS transition（react-native-web 的 <View> 会先
- *   inline 合并 style 再设 opacity，时序不稳定）；
- * - 因此这里刻意不用 animationKeyframes（需要 @keyframes 注入 document），
- *   而用 CSS transition + state 切换 opacity。
+ * caller layout 与动画 opacity 都落到同一个 RN View。双 RAF 建立 opacity:0 起点；
+ * reduced motion 或 RAF 不可用时首 render 就显示，且不输出 transition。
  */
 export declare function Reveal({ children, style, duration, testID, }: RevealProps): React.JSX.Element;
 //# sourceMappingURL=Reveal.web.d.ts.map

package/lib/typescript/src/components/ui/Reveal/Reveal.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Reveal.web.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Reveal/Reveal.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAG3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,EACrB,QAAQ,EACR,KAAK,EACL,QAAsB,EACtB,MAAM,GACP,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmCjC"}
+{"version":3,"file":"Reveal.web.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Reveal/Reveal.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAS3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAyB3C;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,EACrB,QAAQ,EACR,KAAK,EACL,QAAsB,EACtB,MAAM,GACP,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuDjC"}

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

@@ -2,7 +2,7 @@ import type { ReactNode } from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
 export type RevealProps = {
     children: ReactNode;
-    /** 容器样式 */
+    /** 唯一公开容器样式；Web 动画完成后保留 caller opacity。 */
     style?: StyleProp<ViewStyle>;
     /** 入/出场时长（毫秒，默认 motion.base = 200） */
     duration?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Reveal/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW;IACX,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Reveal/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,SAAS,CAAC;IACpB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/lib/typescript/src/components/ui/Reveal/webTransition.d.ts

@@ -0,0 +1,38 @@
+import type { StyleProp, ViewStyle } from 'react-native';
+export type WebTransitionStyle = ViewStyle & {
+    transitionProperty?: 'opacity';
+    transitionDuration?: string;
+    transitionTimingFunction?: 'ease-out';
+};
+type RevealWebStyleResolution = {
+    callerStyle: StyleProp<ViewStyle> | undefined;
+    targetOpacity: number;
+};
+type RevealWebAnimatedStyleOptions = {
+    targetOpacity: number;
+    visible: boolean;
+    animate: boolean;
+    duration: number;
+};
+export type RevealAnimationFrameApi = {
+    requestAnimationFrame: (callback: () => void) => number;
+    cancelAnimationFrame: (id: number) => void;
+};
+type RevealAnimationFrameOptions = {
+    api: RevealAnimationFrameApi | undefined;
+    isCurrent: () => boolean;
+    onVisible: () => void;
+};
+/**
+ * Web Reveal 只读取 caller 最终 opacity，不修改合法 caller style。
+ * flatten 或 RNW transform preprocessing 不安全时丢弃整份 hostile style。
+ */
+export declare function resolveRevealWebStyle(style: unknown): RevealWebStyleResolution;
+export declare function createRevealWebAnimatedStyle({ targetOpacity, visible, animate, duration, }: RevealWebAnimatedStyleOptions): WebTransitionStyle;
+/**
+ * 两个 RAF id 独立保存；cleanup 即使发生在任意一帧之间，也会取消已知 id。
+ * cancelled + generation 双重保护保证旧回调不能写入新一轮 Reveal。
+ */
+export declare function scheduleRevealAnimationFrames({ api, isCurrent, onVisible, }: RevealAnimationFrameOptions): () => void;
+export {};
+//# sourceMappingURL=webTransition.d.ts.map

package/lib/typescript/src/components/ui/Reveal/webTransition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTransition.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Reveal/webTransition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG;IAC3C,kBAAkB,CAAC,EAAE,SAAS,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB,CAAC,EAAE,UAAU,CAAC;CACvC,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,CAAC;IACxD,oBAAoB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,GAAG,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACzC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAkDF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,wBAAwB,CAqC1B;AAED,wBAAgB,4BAA4B,CAAC,EAC3C,aAAa,EACb,OAAO,EACP,OAAO,EACP,QAAQ,GACT,EAAE,6BAA6B,GAAG,kBAAkB,CAWpD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,GAAG,EACH,SAAS,EACT,SAAS,GACV,EAAE,2BAA2B,GAAG,MAAM,IAAI,CAsD1C"}