@unif/react-native-design 0.24.0 → 0.25.0

package/lib/typescript/src/components/ui/Confirm/ConfirmHost.d.ts

@@ -1,13 +1,15 @@
 import React from 'react';
 /**
- * Confirm 对话框宿主 —— App 根挂**一次**,监听 `confirm()` 调用并渲染。
+ * Confirm 对话框宿主 —— App 根挂一个,监听 `confirm()` 调用并渲染。
  *
  * 原生 RN `Modal`(transparent + animationType slide)从底部滑入,backdrop 点击
  * 取消、内层 sheet 拦截点击不冒泡。**不依赖 @gorhom**。
  *
- * 唯一 owner:重复挂载的实例拿到 `null` lease,永久惰性、不渲染 —— 不会出现两个
- * Host 争抢同一个对话框。所有关闭路径统一走 `settleConfirm(entry, result)`,
- * 组件内不直接调用 entry 的 resolver。
+ * 栈式 owner:后挂载的实例接管事件,前任入栈挂起并收到 `clear`(对话框就地关闭、
+ * Promise resolve(false));接管者卸载后自动归还。因此**允许**在自己的 `Modal` 里再挂
+ * 一个 —— RN `Modal` 是独立 native window,根 Host 的对话框会被它物理盖住,内层
+ * 自挂才能显示。所有关闭路径统一走 `settleConfirm(entry, result)`,组件内不直接调用
+ * entry 的 resolver。
  */
-export declare function ConfirmHost(): React.JSX.Element | null;
+export declare function ConfirmHost(): React.JSX.Element;
 //# sourceMappingURL=ConfirmHost.d.ts.map

package/lib/typescript/src/components/ui/Confirm/ConfirmHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfirmHost.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Confirm/ConfirmHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAsBxE;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAwItD"}
+{"version":3,"file":"ConfirmHost.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Confirm/ConfirmHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAsBxE;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAgI/C"}

package/lib/typescript/src/components/ui/Confirm/confirm.d.ts

@@ -3,7 +3,8 @@ import type { ConfirmOptions } from './types';
  * 弹出确认对话框,返回 Promise<boolean>。
  * - 用户点确认 → resolve(true)
  * - 用户点取消 / 点 backdrop / 系统返回 → resolve(false)
- * - 未挂 `<ConfirmHost />`、已有对话框在显示、Host 渲染抛错、Host 卸载 → resolve(false)
+ * - 未挂 `<ConfirmHost />`、已有对话框在显示、Host 渲染抛错、Host 卸载、
+ *   被后挂载的 Host 接管 → resolve(false)
  *
  * 任何路径都必然 settle,不会悬挂。
  *
@@ -19,8 +20,8 @@ import type { ConfirmOptions } from './types';
  * ```
  */
 export declare const confirm: (options: ConfirmOptions) => Promise<boolean>;
-/** 内部:ConfirmHost 挂载时注册唯一 owner;重复挂载得到 null。 */
-export declare const registerConfirmHost: (subscriber: import("./store").ConfirmSubscriber) => import("./store").ConfirmHostLease | null;
+/** 内部:ConfirmHost 挂载时接管 owner;前任入栈挂起,本 lease 释放时归还。 */
+export declare const registerConfirmHost: (subscriber: import("./store").ConfirmSubscriber) => import("./store").ConfirmHostLease;
 /** 内部:所有关闭路径的唯一出口(identity-guarded + 幂等)。 */
 export declare const settleConfirm: (entry: import("./store").ConfirmEntry, result: boolean) => boolean;
 //# sourceMappingURL=confirm.d.ts.map

package/lib/typescript/src/components/ui/Confirm/confirm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Confirm/confirm.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,cAAc,KAAG,OAAO,CAAC,OAAO,CACzC,CAAC;AAEzB,gDAAgD;AAChD,eAAO,MAAM,mBAAmB,gGAAqB,CAAC;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,aAAa,qEAAe,CAAC"}
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Confirm/confirm.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,cAAc,KAAG,OAAO,CAAC,OAAO,CACzC,CAAC;AAEzB,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,yFAAqB,CAAC;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,aAAa,qEAAe,CAAC"}

package/lib/typescript/src/components/ui/Confirm/store.d.ts

@@ -4,10 +4,17 @@ import type { ConfirmOptions } from './types';
  * Confirm 的纯状态机 —— 不含任何 React / 渲染依赖,可直接单测。
  *
  * 两条不变量:
- * 1. **唯一 owner** —— 同一时间只有一个 `<ConfirmHost />` 持有订阅。重复挂载拿到 `null`
- *    lease、永久惰性,不会出现两个 Host 争抢同一个 entry。
+ * 1. **单一活跃 owner + 栈式接管** —— 同一时间只有一个 `<ConfirmHost />` 收事件,但
+ *    后挂载者**接管**、前任入栈挂起,卸载时自动归还。RN `Modal` 是独立 native window,
+ *    根 Host 渲染的对话框会被 Modal 物理盖住(iOS 兄弟 Modal 更是不叠放),所以
+ *    「Modal 内自挂一个 Host」是唯一正解、必须是合法用法 —— 旧的 first-wins 把它判成
+ *    恒惰性死码,才是要修的东西。
  * 2. **唯一 active entry** —— 同一时间只有一个未决对话框。所有关闭路径(确认 / 取消 /
- *    backdrop / 系统返回 / Host 卸载 / subscriber 抛错)都汇聚到 `settle()`。
+ *    backdrop / 系统返回 / Host 卸载 / owner 切换 / subscriber 抛错)都汇聚到 `settle()`。
+ *
+ * 由 1 派生出一条关键不变量:**active entry 永远属于当前 owner**。owner 每次切换
+ * (接管或归还)前都把 active 排空为 `false`,因此挂起中的 owner 手里不可能有未决
+ * 对话框,恢复时也不会继承一个自己没见过 `show` 的槽位。
  *
  * `settle()` 用 **identity guard**(`active !== entry` 直接返回 false)而非 id 比较:
  * 旧 entry 的迟到回调拿着的是旧对象引用,永远匹配不上新 active,因此不可能误关新对话框。
@@ -31,12 +38,14 @@ export type ConfirmHostLease = {
     /**
      * Host 卸载。`heldEntry` 是 Host 当时手里那个未决 entry(没有则传 `null`)——
      * 只有它仍是 active 时才会被 settle 成 `false`,避免误伤后来的对话框。
+     * 幂等:重复调用、或本 owner 早已被接管者顶下去,都是无副作用的 no-op。
      */
     release(heldEntry: ConfirmEntry | null): void;
 };
 export type ConfirmStore = {
     request(options: ConfirmOptions): Promise<boolean>;
-    registerHost(subscriber: ConfirmSubscriber): ConfirmHostLease | null;
+    /** 挂载 Host。恒返回可用 lease —— 已有 owner 时走接管,不再拒绝。 */
+    registerHost(subscriber: ConfirmSubscriber): ConfirmHostLease;
     settle(entry: ConfirmEntry, result: boolean): boolean;
     activeEntry(): ConfirmEntry | null;
 };

package/lib/typescript/src/components/ui/Confirm/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Confirm/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,YAAY,CAAC,UAAU,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,IAAI,CAAC;IACrE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IACtD,WAAW,IAAI,YAAY,GAAG,IAAI,CAAC;CACpC,CAAC;AAIF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAmG5D"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Confirm/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,iDAAiD;IACjD,YAAY,CAAC,UAAU,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAC9D,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IACtD,WAAW,IAAI,YAAY,GAAG,IAAI,CAAC;CACpC,CAAC;AAIF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CA0I5D"}

package/lib/typescript/src/components/ui/Toast/ToastHost.d.ts

@@ -1,9 +1,13 @@
 import React from 'react';
 import type { ToastHostProps } from './types';
 /**
- * 在根附近挂**一次**。监听 toast() 调用并渲染当前 toast。
+ * 在根附近挂一个。监听 toast() 调用并渲染当前 toast。
  * 同一时间只显示一条 —— 新的会替换旧的(latest-wins)。
  *
+ * 栈式 owner:后挂载的实例接管投递,前任挂起并收起当前 toast;接管者卸载后自动归还。
+ * 因此**允许**在自己的 `Modal` 里再挂一个 —— RN `Modal` 是独立 native window,根 Host
+ * 的 toast 会被它物理盖住,内层自挂才看得见。
+ *
  * 位置由 `entry.position`('top' / 'bottom' / 'center')决定,top/bottom 自动避让
  * safe-area;进入动画方向随位置(top 从上滑、bottom/center 从下滑)。
  *

package/lib/typescript/src/components/ui/Toast/ToastHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToastHost.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Toast/ToastHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAmBxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAS9C;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,GACP,GAAE,cAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA+HhD"}
+{"version":3,"file":"ToastHost.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Toast/ToastHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAmBxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAS9C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,GACP,GAAE,cAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA6IhD"}

package/lib/typescript/src/components/ui/Toast/ToastHost.web.d.ts

@@ -9,6 +9,7 @@ import type { ToastHostProps } from './types';
  * - opacity 0→1 + translateY 8→0 入场(motion.base ms)
  * - 停留 entry.duration ms
  * - opacity 1→0 + translateY 0→8 退场后 unmount
+ * - 栈式 owner:后挂载者接管、前任挂起并收起 toast,接管者卸载后自动归还
  *
  * 竞态纪律与 native 版一致:timer / RAF 在改 UI 或上报完成前,都要同时通过同步 ref
  * 与 `isCurrentToastDelivery(delivery)` 两道校验。

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

@@ -1 +1 @@
-{"version":3,"file":"ToastHost.web.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Toast/ToastHost.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAkBxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAS9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,GACP,GAAE,cAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAiJhD"}
+{"version":3,"file":"ToastHost.web.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Toast/ToastHost.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAkBxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAS9C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,GACP,GAAE,cAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA0JhD"}

package/lib/typescript/src/components/ui/Toast/store.d.ts

@@ -16,6 +16,18 @@ import type { ToastEntry } from './types';
  *
  * `leaseId` 单调递增,同一 entry 被重新投递(Host 重挂)也会拿到新的 leaseId ——
  * 仅比较 entry.id 不足以区分「同一条消息的两次投递」。
+ *
+ * **栈式 owner**(与 Confirm 同构):后挂载的 Host 接管投递,前任入栈挂起并收到 clear,
+ * 接管者卸载后自动归还。RN `Modal` 是独立 native window,根 Host 渲染的 toast 会被
+ * Modal 物理盖住,只有「Modal 内自挂一个 Host」能显示 —— 旧的 first-wins 把这条唯一
+ * 正解判成恒惰性死码。
+ *
+ * 两个方向对在途 toast 的处理**刻意不同**:
+ * - **接管**(有人挂到我上面)→ 在途 toast **丢弃**。它属于「已经被盖住的过去」,
+ *   搬到接管者身上重放没有意义。
+ * - **归还**(接管者卸载、我恢复)→ 在途 toast **整条交回、立即重投**。
+ *   「Modal 内操作成功 → toast → 关窗」是最常见的一条路径,那条 toast 刚发出、用户
+ *   一眼都还没看到;丢掉的话比不挂内层 Host 还糟。不追剩余时长,重投 = 完整重播一遍。
  */
 export type ToastDelivery = {
     entry: ToastEntry;
@@ -23,13 +35,25 @@ export type ToastDelivery = {
     leaseId: number;
 };
 export type ToastSubscriber = (delivery: ToastDelivery) => void;
+/**
+ * owner 被接管 / 归还时的撤回通知 —— 对应 Confirm 的 `clear` 事件。
+ *
+ * 没有它,挂起中的 Host 会把最后一条 toast **冻在屏幕上**:store 已丢弃那次投递,
+ * Host 自己的退场 timer 过不了 `isCurrent` CAS,永远走不到清 UI 那一步。
+ */
+export type ToastClearSubscriber = () => void;
 export type ToastHostLease = {
     readonly ownerToken: symbol;
+    /** Host 卸载。幂等:重复调用、或本 owner 已被摘掉,都是无副作用的 no-op。 */
     release(): void;
 };
 export type ToastStore = {
     publish(entry: ToastEntry): void;
-    registerHost(subscriber: ToastSubscriber): ToastHostLease | null;
+    /**
+     * 挂载 Host。已有 owner 时走接管(不再拒绝);返回 `null` 只剩一种含义 ——
+     * 补投 pending 时 subscriber 抛错,这个 owner 当场就被作废了。
+     */
+    registerHost(subscriber: ToastSubscriber, onClear?: ToastClearSubscriber): ToastHostLease | null;
     complete(ownerToken: symbol, leaseId: number, entryId: number): boolean;
     isCurrent(delivery: ToastDelivery): boolean;
     pendingEntry(): ToastEntry | null;

package/lib/typescript/src/components/ui/Toast/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Toast/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,UAAU,EAAE,eAAe,GAAG,cAAc,GAAG,IAAI,CAAC;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACxE,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC;IAC5C,YAAY,IAAI,UAAU,GAAG,IAAI,CAAC;IAClC,eAAe,IAAI,aAAa,GAAG,IAAI,CAAC;CACzC,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAsGxD"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Toast/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,YAAY,CACV,UAAU,EAAE,eAAe,EAC3B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,cAAc,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACxE,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC;IAC5C,YAAY,IAAI,UAAU,GAAG,IAAI,CAAC;IAClC,eAAe,IAAI,aAAa,GAAG,IAAI,CAAC;CACzC,CAAC;AAQF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAsKxD"}

package/lib/typescript/src/components/ui/Toast/toast.d.ts

@@ -1,6 +1,7 @@
 import type { ToastInput } from './types';
 /**
- * 命令式 toast API。在 app 根附近挂一次 `<ToastHost />` 即可。
+ * 命令式 toast API。在 app 根附近挂一个 `<ToastHost />` 即可;需要在 `Modal` 里显示
+ * 时可在 Modal 内再挂一个,它会接管、关闭后自动归还。
  *
  * toast('已切换到日报');
  * toast.success('订单提交成功');
@@ -12,8 +13,8 @@ export declare const toast: ((input: ToastInput) => void) & {
     success: (input: ToastInput) => void;
     error: (input: ToastInput) => void;
 };
-/** 内部:ToastHost 挂载时注册唯一 owner;重复挂载得到 null。 */
-export declare const registerToastHost: (subscriber: import("./store").ToastSubscriber) => import("./store").ToastHostLease | null;
+/** 内部:ToastHost 挂载时接管 owner;前任入栈挂起,本 lease 释放时归还。 */
+export declare const registerToastHost: (subscriber: import("./store").ToastSubscriber, onClear?: import("./store").ToastClearSubscriber) => import("./store").ToastHostLease | null;
 /** 内部:三重身份 CAS —— owner token + leaseId + entry id 全对才算完成。 */
 export declare const completeToast: (ownerToken: symbol, leaseId: number, entryId: number) => boolean;
 /** 内部:timer / RAF / 动画回调动 UI 前的守卫。 */

package/lib/typescript/src/components/ui/Toast/toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Toast/toast.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAc,UAAU,EAAa,MAAM,SAAS,CAAC;AA+CjE;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,WAAyB,UAAU;kBACrC,UAAU;qBACP,UAAU;mBACZ,UAAU;CACzB,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,4FAAqB,CAAC;AAEpD,8DAA8D;AAC9D,eAAO,MAAM,aAAa,mEAAiB,CAAC;AAE5C,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,wDAAkB,CAAC"}
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Toast/toast.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAc,UAAU,EAAa,MAAM,SAAS,CAAC;AA+CjE;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,WAAyB,UAAU;kBACrC,UAAU;qBACP,UAAU;mBACZ,UAAU;CACzB,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,8IAAqB,CAAC;AAEpD,8DAA8D;AAC9D,eAAO,MAAM,aAAa,mEAAiB,CAAC;AAE5C,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,wDAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unif/react-native-design",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Unif 设计系统:theme + icons + utils + components",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/components/ui/Confirm/ConfirmHost.tsx

@@ -21,16 +21,18 @@ const SCRIM_IN_MS = 220;
 const SCRIM_OUT_MS = 260;
 
 /**
- * Confirm 对话框宿主 —— App 根挂**一次**,监听 `confirm()` 调用并渲染。
+ * Confirm 对话框宿主 —— App 根挂一个,监听 `confirm()` 调用并渲染。
  *
  * 原生 RN `Modal`(transparent + animationType slide)从底部滑入,backdrop 点击
  * 取消、内层 sheet 拦截点击不冒泡。**不依赖 @gorhom**。
  *
- * 唯一 owner:重复挂载的实例拿到 `null` lease,永久惰性、不渲染 —— 不会出现两个
- * Host 争抢同一个对话框。所有关闭路径统一走 `settleConfirm(entry, result)`,
- * 组件内不直接调用 entry 的 resolver。
+ * 栈式 owner:后挂载的实例接管事件,前任入栈挂起并收到 `clear`(对话框就地关闭、
+ * Promise resolve(false));接管者卸载后自动归还。因此**允许**在自己的 `Modal` 里再挂
+ * 一个 —— RN `Modal` 是独立 native window,根 Host 的对话框会被它物理盖住,内层
+ * 自挂才能显示。所有关闭路径统一走 `settleConfirm(entry, result)`,组件内不直接调用
+ * entry 的 resolver。
  */
-export function ConfirmHost(): React.JSX.Element | null {
+export function ConfirmHost(): React.JSX.Element {
   const styles = useThemedStyles(makeStyles);
   const insets = useSafeAreaInsets();
   const { height: screenH } = useWindowDimensions();
@@ -39,9 +41,6 @@ export function ConfirmHost(): React.JSX.Element | null {
   // 同步权威副本:effect cleanup 与迟到回调都读它,不受 React state 批处理延迟影响。
   const pendingRef = useRef<ConfirmEntry | null>(null);
 
-  // 注册失败(已有 owner)时保持惰性:不订阅、不渲染。
-  const [inert, setInert] = useState(false);
-
   // 保留最后一次显示的 entry:关闭时 entry 立即置 null,但 slide 退场动画期 Modal 仍可见,
   // 渲染 lastEntry 才不会滑出一个只剩 padding 的空 sheet([M-17])。
   const lastEntryRef = useRef<ConfirmEntry | null>(null);
@@ -66,13 +65,10 @@ export function ConfirmHost(): React.JSX.Element | null {
       }
     };
     const lease = registerConfirmHost(subscriber);
-    if (!lease) {
-      setInert(true);
-      return;
-    }
     return () => {
       // 卸载时若对话框仍未决(error boundary 重置 / 根 re-key 切语言主题等),
       // Store 把它 settle(false) —— 否则 confirm() 的 Promise 永久悬挂并锁死单例([H-5])。
+      // 若本实例是接管者,release 顺带把 owner 归还给挂起中的前任。
       const held = pendingRef.current;
       pendingRef.current = null;
       lease.release(held);
@@ -99,8 +95,6 @@ export function ConfirmHost(): React.JSX.Element | null {
     }).start();
   }, [entry, scrimOpacity]);
 
-  if (inert) return null;
-
   return (
     <Modal
       visible={!!entry}

package/src/components/ui/Confirm/confirm.ts

@@ -19,7 +19,8 @@ const store = createConfirmStore(log);
  * 弹出确认对话框,返回 Promise<boolean>。
  * - 用户点确认 → resolve(true)
  * - 用户点取消 / 点 backdrop / 系统返回 → resolve(false)
- * - 未挂 `<ConfirmHost />`、已有对话框在显示、Host 渲染抛错、Host 卸载 → resolve(false)
+ * - 未挂 `<ConfirmHost />`、已有对话框在显示、Host 渲染抛错、Host 卸载、
+ *   被后挂载的 Host 接管 → resolve(false)
  *
  * 任何路径都必然 settle,不会悬挂。
  *
@@ -37,7 +38,7 @@ const store = createConfirmStore(log);
 export const confirm = (options: ConfirmOptions): Promise<boolean> =>
   store.request(options);
 
-/** 内部:ConfirmHost 挂载时注册唯一 owner;重复挂载得到 null。 */
+/** 内部:ConfirmHost 挂载时接管 owner;前任入栈挂起,本 lease 释放时归还。 */
 export const registerConfirmHost = store.registerHost;
 
 /** 内部:所有关闭路径的唯一出口(identity-guarded + 幂等)。 */

package/src/components/ui/Confirm/store.ts

@@ -5,10 +5,17 @@ import type { ConfirmOptions } from './types';
  * Confirm 的纯状态机 —— 不含任何 React / 渲染依赖,可直接单测。
  *
  * 两条不变量:
- * 1. **唯一 owner** —— 同一时间只有一个 `<ConfirmHost />` 持有订阅。重复挂载拿到 `null`
- *    lease、永久惰性,不会出现两个 Host 争抢同一个 entry。
+ * 1. **单一活跃 owner + 栈式接管** —— 同一时间只有一个 `<ConfirmHost />` 收事件,但
+ *    后挂载者**接管**、前任入栈挂起,卸载时自动归还。RN `Modal` 是独立 native window,
+ *    根 Host 渲染的对话框会被 Modal 物理盖住(iOS 兄弟 Modal 更是不叠放),所以
+ *    「Modal 内自挂一个 Host」是唯一正解、必须是合法用法 —— 旧的 first-wins 把它判成
+ *    恒惰性死码,才是要修的东西。
  * 2. **唯一 active entry** —— 同一时间只有一个未决对话框。所有关闭路径(确认 / 取消 /
- *    backdrop / 系统返回 / Host 卸载 / subscriber 抛错)都汇聚到 `settle()`。
+ *    backdrop / 系统返回 / Host 卸载 / owner 切换 / subscriber 抛错)都汇聚到 `settle()`。
+ *
+ * 由 1 派生出一条关键不变量:**active entry 永远属于当前 owner**。owner 每次切换
+ * (接管或归还)前都把 active 排空为 `false`,因此挂起中的 owner 手里不可能有未决
+ * 对话框,恢复时也不会继承一个自己没见过 `show` 的槽位。
  *
  * `settle()` 用 **identity guard**(`active !== entry` 直接返回 false)而非 id 比较:
  * 旧 entry 的迟到回调拿着的是旧对象引用,永远匹配不上新 active,因此不可能误关新对话框。
@@ -32,13 +39,15 @@ export type ConfirmHostLease = {
   /**
    * Host 卸载。`heldEntry` 是 Host 当时手里那个未决 entry(没有则传 `null`)——
    * 只有它仍是 active 时才会被 settle 成 `false`,避免误伤后来的对话框。
+   * 幂等:重复调用、或本 owner 早已被接管者顶下去,都是无副作用的 no-op。
    */
   release(heldEntry: ConfirmEntry | null): void;
 };
 
 export type ConfirmStore = {
   request(options: ConfirmOptions): Promise<boolean>;
-  registerHost(subscriber: ConfirmSubscriber): ConfirmHostLease | null;
+  /** 挂载 Host。恒返回可用 lease —— 已有 owner 时走接管,不再拒绝。 */
+  registerHost(subscriber: ConfirmSubscriber): ConfirmHostLease;
   settle(entry: ConfirmEntry, result: boolean): boolean;
   activeEntry(): ConfirmEntry | null;
 };
@@ -49,6 +58,8 @@ export function createConfirmStore(log: Logger): ConfirmStore {
   let nextId = 0;
   let active: ConfirmEntry | null = null;
   let owner: Owner | null = null;
+  /** 被接管而挂起的前任,栈顶 = 最近一个。当前 owner 卸载时从这里恢复。 */
+  const suspended: Owner[] = [];
 
   function settle(entry: ConfirmEntry, result: boolean): boolean {
     if (entry.settled || active !== entry) return false;
@@ -88,7 +99,7 @@ export function createConfirmStore(log: Logger): ConfirmStore {
     const current = owner;
     if (!current?.subscriber) {
       log.warn(
-        'confirm() 调用时未挂载 <ConfirmHost />,对话框无法显示,已 resolve(false)。请在 app 根附近挂一次 <ConfirmHost />。'
+        'confirm() 调用时未挂载 <ConfirmHost />,对话框无法显示,已 resolve(false)。请在 app 根附近挂一个 <ConfirmHost />。'
       );
       return Promise.resolve(false);
     }
@@ -114,26 +125,63 @@ export function createConfirmStore(log: Logger): ConfirmStore {
     });
   }
 
-  function registerHost(
-    subscriber: ConfirmSubscriber
-  ): ConfirmHostLease | null {
-    if (owner) {
-      log.warn(
-        '检测到多个 <ConfirmHost />。只有第一个生效,重复挂载的实例保持惰性 —— 请在 app 根只挂一次。'
-      );
-      return null;
+  /**
+   * owner 切换前把 active 排空为 `false` —— Promise 不悬挂、单例槽不被带走。
+   *
+   * 每轮 settle 成功即 `active = null`,只有 clear 回调同步再 `request()` 时才会多转
+   * 一轮;settle 返回 false(排不动)立即退出,不给死循环留口子。
+   */
+  function drainActive(): void {
+    while (active) {
+      if (!settle(active, false)) break;
     }
+  }
+
+  /** 弹出最近一个仍可用的挂起 owner;抛错被作废的(subscriber 已置空)直接丢弃。 */
+  function popSuspended(): Owner | null {
+    while (suspended.length > 0) {
+      const next = suspended.pop();
+      if (next?.subscriber) return next;
+    }
+    return null;
+  }
+
+  function registerHost(subscriber: ConfirmSubscriber): ConfirmHostLease {
     const token = Symbol('ConfirmHostOwner');
     const self: Owner = { token, subscriber };
+    if (owner) {
+      // 先排空再换人:此刻前任仍是 owner,clear 事件正好发给它,它的对话框就地关闭。
+      // 顺序反过来(先换 owner 再 settle)clear 会误投给刚接管的新 Host。
+      drainActive();
+      // 排空期间 clear 回调若抛错,settle 已把前任作废(owner 置 null)—— 作废的不入栈,
+      // 免得恢复出一个死订阅;若回调期间又有人注册,入栈的就是那位,同样不丢。
+      const outgoing = owner;
+      if (outgoing) suspended.push(outgoing);
+    }
     owner = self;
     return {
       ownerToken: token,
       release(heldEntry: ConfirmEntry | null): void {
+        const index = suspended.indexOf(self);
+        if (index >= 0) {
+          // 乱序卸载(父 Modal 先于内层 Host 卸载):挂起者的 active 在被接管时已结算,
+          // 这里只把它摘出栈,绝不能碰当前 owner。
+          suspended.splice(index, 1);
+          self.subscriber = null;
+          return;
+        }
         if (owner?.token !== token) return;
         // 先摘订阅,再结算:settle 内部发的 clear 事件不应再回到正在卸载的 Host。
         self.subscriber = null;
         owner = null;
         if (heldEntry) settle(heldEntry, false);
+        const successor = popSuspended();
+        if (successor) {
+          // 归还前再排空一次:前任没见过残留 entry 的 show,不能让它继承一个锁死的槽。
+          // 此刻 owner 为 null,排空不会发出任何 clear。
+          drainActive();
+          owner = successor;
+        }
       },
     };
   }

package/src/components/ui/Toast/ToastHost.tsx

@@ -27,9 +27,13 @@ type DeliveryIdentity = {
 };
 
 /**
- * 在根附近挂**一次**。监听 toast() 调用并渲染当前 toast。
+ * 在根附近挂一个。监听 toast() 调用并渲染当前 toast。
  * 同一时间只显示一条 —— 新的会替换旧的(latest-wins)。
  *
+ * 栈式 owner:后挂载的实例接管投递,前任挂起并收起当前 toast;接管者卸载后自动归还。
+ * 因此**允许**在自己的 `Modal` 里再挂一个 —— RN `Modal` 是独立 native window,根 Host
+ * 的 toast 会被它物理盖住,内层自挂才看得见。
+ *
  * 位置由 `entry.position`('top' / 'bottom' / 'center')决定,top/bottom 自动避让
  * safe-area;进入动画方向随位置(top 从上滑、bottom/center 从下滑)。
  *
@@ -66,7 +70,21 @@ export function ToastHost({
       };
       setDelivery(next);
     };
-    const lease = registerToastHost(subscriber);
+    // 被后挂载的 Host 接管:立刻收起当前 toast。store 已丢弃这次投递,自身的退场
+    // timer 从此过不了 CAS —— 不主动清,这条 toast 会冻在屏幕上直到本 Host 卸载。
+    const clearOnSuspend = () => {
+      currentDeliveryRef.current = null;
+      if (dismissTimer.current) {
+        clearTimeout(dismissTimer.current);
+        dismissTimer.current = null;
+      }
+      cancelAnimation(op);
+      cancelAnimation(ty);
+      setDelivery(null);
+    };
+    const lease = registerToastHost(subscriber, clearOnSuspend);
+    // null lease 只剩一种成因:补投 pending 时 subscriber 抛错,本 owner 当场被作废
+    //(不再是「重复挂载」—— 那条现在走接管)。惰性到卸载为止。
     if (!lease) {
       setInert(true);
       return;

package/src/components/ui/Toast/ToastHost.web.tsx

@@ -34,6 +34,7 @@ type DeliveryIdentity = {
  * - opacity 0→1 + translateY 8→0 入场(motion.base ms)
  * - 停留 entry.duration ms
  * - opacity 1→0 + translateY 0→8 退场后 unmount
+ * - 栈式 owner:后挂载者接管、前任挂起并收起 toast,接管者卸载后自动归还
  *
  * 竞态纪律与 native 版一致:timer / RAF 在改 UI 或上报完成前,都要同时通过同步 ref
  * 与 `isCurrentToastDelivery(delivery)` 两道校验。
@@ -79,7 +80,16 @@ export function ToastHost({
       };
       setDelivery(next);
     };
-    const lease = registerToastHost(subscriber);
+    // 被后挂载的 Host 接管:立刻收起当前 toast。store 已丢弃这次投递,自身的退场
+    // timer/RAF 从此过不了 CAS —— 不主动清,这条 toast 会冻在屏幕上直到本 Host 卸载。
+    const clearOnSuspend = () => {
+      currentDeliveryRef.current = null;
+      cancelCallbacks();
+      setDelivery(null);
+    };
+    const lease = registerToastHost(subscriber, clearOnSuspend);
+    // null lease 只剩一种成因:补投 pending 时 subscriber 抛错,本 owner 当场被作废
+    //(不再是「重复挂载」—— 那条现在走接管)。惰性到卸载为止。
     if (!lease) {
       setInert(true);
       return;