@aalis/core 0.7.0 → 0.9.0

package/dist/contributions.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 贡献 spec 的内核契约：只要求一个 id。
+ *
+ * id 是**局部名**（如 'context'、'group-hint'），注册时由门面自动冠以
+ * `${ctx.id}/` 前缀成为全局键（见 {@link ContributionHandle.key}）——
+ * **spec.id 侧**的抢注/顶替由此杜绝，无需归属权校验（与 provide 的
+ * entryId 前缀约定同源，但由构造保证而非 warn）。
+ *
+ * 边界如实声明：该保证以 ctx.id 为信任锚。`ctx.fork(id)` 与
+ * `ctx.useModule(module)`（childId = `${父id}#${模块名}`）都不保证 ctx.id
+ * 唯一，重复 ctx.id 会使两方共用同一命名空间、后注册者替换先注册者。
+ * 这是 Context 模型的信任边界（provide / middleware 的 contextId 归属同理
+ * 暴露），如需硬化应在 fork 层统一处理，而非各原语自设门禁。
+ */
+export interface ContributionSpec {
+    /**
+     * 局部幂等键：同一 ctx 内同 id 重复注册 = 替换。
+     *
+     * 必须**非空且不含 `/`**（`/` 是全局键的分隔符，含它可构造出跨 ctx 的
+     * 键碰撞），违者注册期抛 `TypeError`。
+     */
+    id: string;
+}
+/** collect 的枚举条目：全局键 + 注册时原样传入的 spec（不拷贝、不改写）。 */
+export interface ContributionHandle<S extends ContributionSpec = ContributionSpec> {
+    /** 全局键 `${contextId}/${spec.id}`——归属标识与幂等键。 */
+    readonly key: string;
+    /** 注册方交付的 spec 本体（引用，非副本）。 */
+    readonly spec: S;
+}
+/**
+ * 贡献点注册表 —— 与 services 成对偶的数据原语。
+ *
+ * 四原语按「执行/数据」二分：events（执行·无返回·隔离）、hooks（执行·可变·
+ * 短路）、services（数据·解析单胜者）、contributions（数据·确定性枚举全量）。
+ *
+ * 本注册表**永不执行插件代码**：register/collect 是同步的数据插入与快照枚举。
+ * 如何调用 spec（并行/隔离/超时）是收集方（贡献点 owner）的策略，不在内核。
+ *
+ * 确定性：collect 按全局键（`${contextId}/${id}`）码元序排序——同一注册集合
+ * 在任意注册顺序、任意机器上枚举结果逐字节相同；顺序是键的纯函数，
+ * 重复注册也无法影响排位。
+ *
+ * 插件面与 events / services / hooks 同一门面纪律（方法窄面，对象不外露）：
+ * 注册经 `ctx.contribute(point, spec)`（冠 ctx.id 前缀 + 挂 dispose 链），
+ * 枚举经 `ctx.collect(point)`（驱动公开——任何插件都可拥有自己的贡献点）。
+ * 完整注册表仅 App（组合根）与 Context 内部持有。
+ *
+ * 注册表本身只认 {@link ContributionSpec}（不透明数据面）；按贡献点键精化
+ * spec 类型是 Context 门面的职责（经 types/contributions.ts 的
+ * ContributionPointMap declaration merging）。
+ */
+export declare class ContributionRegistry {
+    /** point → 全局键 → 注册项 */
+    private points;
+    /**
+     * 注册一份贡献，返回 dispose 函数。
+     *
+     * 全局键 = `${contextId}/${spec.id}`；同键重复注册为替换（幂等），
+     * 旧注册的 dispose 函数在替换后失效（不会误删新注册）。
+     */
+    register(point: string, spec: ContributionSpec, contextId: string): () => void;
+    /**
+     * 枚举某贡献点的全部条目，按全局键码元序（`Array.prototype.sort` 默认
+     * 比较，无 locale 依赖）。返回数组快照；spec 按**引用**给出——不拷贝、
+     * 不改写字段，故 class 实例 spec 的原型方法、getter 语义均完好保留
+     * （注册表"永不执行插件代码"因此在枚举侧也成立）。
+     */
+    collect(point: string): ReadonlyArray<ContributionHandle>;
+    /**
+     * 按 contextId 移除该上下文的全部贡献（插件卸载清扫）。
+     */
+    unregisterByContext(contextId: string): void;
+}
+//# sourceMappingURL=contributions.d.ts.map

package/dist/contributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributions.d.ts","sourceRoot":"","sources":["../src/contributions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAC/E,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;CAClB;AAOD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,oBAAoB;IAC/B,wBAAwB;IACxB,OAAO,CAAC,MAAM,CAAgD;IAE9D;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,IAAI;IA0B9E;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,kBAAkB,CAAC;IAMzD;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAQ7C"}

package/dist/contributions.js

@@ -0,0 +1,83 @@
+/**
+ * 贡献点注册表 —— 与 services 成对偶的数据原语。
+ *
+ * 四原语按「执行/数据」二分：events（执行·无返回·隔离）、hooks（执行·可变·
+ * 短路）、services（数据·解析单胜者）、contributions（数据·确定性枚举全量）。
+ *
+ * 本注册表**永不执行插件代码**：register/collect 是同步的数据插入与快照枚举。
+ * 如何调用 spec（并行/隔离/超时）是收集方（贡献点 owner）的策略，不在内核。
+ *
+ * 确定性：collect 按全局键（`${contextId}/${id}`）码元序排序——同一注册集合
+ * 在任意注册顺序、任意机器上枚举结果逐字节相同；顺序是键的纯函数，
+ * 重复注册也无法影响排位。
+ *
+ * 插件面与 events / services / hooks 同一门面纪律（方法窄面，对象不外露）：
+ * 注册经 `ctx.contribute(point, spec)`（冠 ctx.id 前缀 + 挂 dispose 链），
+ * 枚举经 `ctx.collect(point)`（驱动公开——任何插件都可拥有自己的贡献点）。
+ * 完整注册表仅 App（组合根）与 Context 内部持有。
+ *
+ * 注册表本身只认 {@link ContributionSpec}（不透明数据面）；按贡献点键精化
+ * spec 类型是 Context 门面的职责（经 types/contributions.ts 的
+ * ContributionPointMap declaration merging）。
+ */
+export class ContributionRegistry {
+    /** point → 全局键 → 注册项 */
+    points = new Map();
+    /**
+     * 注册一份贡献，返回 dispose 函数。
+     *
+     * 全局键 = `${contextId}/${spec.id}`；同键重复注册为替换（幂等），
+     * 旧注册的 dispose 函数在替换后失效（不会误删新注册）。
+     */
+    register(point, spec, contextId) {
+        // 空 id 会静默同键碰撞；含 '/' 的局部 id 可构造出与他人 `${contextId}/${id}`
+        // 相同的全局键（如 ctx 'a' + id 'b/c' 撞 ctx 'a/b' + id 'c'），打破
+        // 「spec.id 侧无法顶替他人贡献」的保证——两者都必须在注册期拒绝。
+        if (!spec.id || spec.id.includes('/')) {
+            throw new TypeError(`贡献点 "${point}" 的 spec.id 必须非空且不含 '/'（得到 "${spec.id}"）`);
+        }
+        let byKey = this.points.get(point);
+        if (!byKey) {
+            byKey = new Map();
+            this.points.set(point, byKey);
+        }
+        const key = `${contextId}/${spec.id}`;
+        const entry = { spec, contextId };
+        byKey.set(key, entry);
+        return () => {
+            // 仅当当前占位仍是本次注册时才删除——同键已被替换时旧 dispose 是 no-op
+            const current = this.points.get(point);
+            if (current?.get(key) === entry) {
+                current.delete(key);
+                if (current.size === 0)
+                    this.points.delete(point);
+            }
+        };
+    }
+    /**
+     * 枚举某贡献点的全部条目，按全局键码元序（`Array.prototype.sort` 默认
+     * 比较，无 locale 依赖）。返回数组快照；spec 按**引用**给出——不拷贝、
+     * 不改写字段，故 class 实例 spec 的原型方法、getter 语义均完好保留
+     * （注册表"永不执行插件代码"因此在枚举侧也成立）。
+     */
+    collect(point) {
+        const byKey = this.points.get(point);
+        if (!byKey)
+            return [];
+        return [...byKey.keys()].sort().map(key => ({ key, spec: byKey.get(key).spec }));
+    }
+    /**
+     * 按 contextId 移除该上下文的全部贡献（插件卸载清扫）。
+     */
+    unregisterByContext(contextId) {
+        for (const [point, byKey] of this.points) {
+            for (const [key, entry] of byKey) {
+                if (entry.contextId === contextId)
+                    byKey.delete(key);
+            }
+            if (byKey.size === 0)
+                this.points.delete(point);
+        }
+    }
+}
+//# sourceMappingURL=contributions.js.map

package/dist/contributions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contributions.js","sourceRoot":"","sources":["../src/contributions.ts"],"names":[],"mappings":"AAqCA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,oBAAoB;IAC/B,wBAAwB;IAChB,MAAM,GAAG,IAAI,GAAG,EAAqC,CAAC;IAE9D;;;;;OAKG;IACH,QAAQ,CAAC,KAAa,EAAE,IAAsB,EAAE,SAAiB;QAC/D,yDAAyD;QACzD,uDAAuD;QACvD,uCAAuC;QACvC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,SAAS,CAAC,QAAQ,KAAK,+BAA+B,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAChD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEtB,OAAO,GAAG,EAAE;YACV,6CAA6C;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;gBAChC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACpB,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;oBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAa;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrG,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,SAAiB;QACnC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;gBACjC,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;oBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF"}

package/dist/disposable-chain.d.ts

@@ -5,7 +5,8 @@ import type { Logger } from './logger.js';
  * 用途：Context 及其他需要累积「注册 → 卸载」副作用的场景，提供：
  * - `push(fn)` 追加清理函数
  * - `remove(fn)` 精确移除单个清理函数（不执行）
- * - `dispose()` 逆序调用所有清理函数并清空；期间任一抛错不影响其他
+ * - `dispose()` 同步逆序调用所有清理函数并清空；期间任一抛错不影响其他
+ * - `disposeAsync(timeoutMs?)` 逆序**串行等待**每个清理函数（含异步返回值）
  *
  * 相比散落的 `this._disposables: (() => void)[]`，集中管理能避免
  * 「忘记 push / 忘记清空 / 错误处理不一致」等低级 bug。
@@ -15,17 +16,57 @@ export declare class DisposableChain {
     private _items;
     private _disposed;
     constructor(logger?: Logger | undefined);
-    /** 追加一个清理函数。dispose 后追加会立刻执行。 */
-    push(fn: () => void): void;
+    /** 追加一个清理函数。dispose 后追加会立刻执行（异步返回值不等待）。 */
+    push(fn: () => unknown): void;
     /** 精确移除单个 disposable（不执行）。用于缓冲项"取消"场景。 */
-    remove(fn: () => void): boolean;
+    remove(fn: () => unknown): boolean;
     get disposed(): boolean;
     /** 当前登记的清理函数数量（诊断 / 测试用：可检测闭包是否如期自移除）。 */
     get size(): number;
     /**
-     * 逆序执行所有清理函数并清空。重复调用无效果。
-     * 单个函数抛错被 swallow（可选择通过 logger 记录 debug）。
+     * 置位 disposed、快照并清空 items——两个 dispose 入口共用，避免逻辑漂移。
+     *
+     * 先清空再迭代快照：dispose 期间 disposer 常回调 remove(自身)（provide /
+     * whenService / subscribe 的自移除语义）。若在迭代中 splice 活动数组，索引
+     * 会错位、长度缩短，导致取到 undefined 而抛 "is not a function"。清空在前
+     * 则这些 remove 作用于空数组、安全 no-op（返回 false，符合各自移除点注释
+     * 的预期），快照索引也始终稳定。
+     */
+    private take;
+    /**
+     * 同步逆序执行所有清理函数并清空。重复调用无效果。
+     * 单个函数抛错被 swallow（可选择通过 logger 记录 debug）；
+     * 异步返回值**不等待**——需要等待落盘类清理时用 {@link disposeAsync}。
      */
     dispose(): void;
+    /**
+     * 逆序**串行**等待所有清理函数完成。
+     *
+     * 串行而非并发是刻意的：逆序是本类对外承诺的语义（消费侧清理先于提供侧），
+     * 落盘类清理常有顺序依赖。单项抛错/拒绝被隔离，不中断后续清理。
+     *
+     * @param timeoutMs 单个异步清理项的等待上限；超时后放弃等待该项、
+     *        **继续执行后续清理项**（定时器/监听器仍能摘干净），并 warn 点名。
+     *        缺省或 <=0 不设限。
+     */
+    disposeAsync(timeoutMs?: number): Promise<void>;
+    /**
+     * 等待单个清理 promise，可选超时护栏。
+     *
+     * 环境无关性记账：这是 core 首个计时器使用点。`setTimeout`/`clearTimeout`
+     * 是所有 JS 运行时（浏览器/Node/Deno/Worker）的共有全局，非 `node:` 专属，
+     * 不引入环境假设。
+     */
+    private awaitWithTimeout;
 }
+/**
+ * 等待一个 promise，可选超时护栏；超时则放弃等待并调 `onTimeout` 上报。
+ *
+ * 环境无关性记账：`setTimeout`/`clearTimeout` 是所有 JS 运行时（浏览器/Node/
+ * Deno/Worker）的共有全局，非 `node:` 专属，不引入环境假设。
+ *
+ * @internal 仅供 core 内部（DisposableChain 逐项等待、Context join 在飞拆卸）复用，
+ *   不从包根导出。
+ */
+export declare function awaitWithTimeout(p: Promise<unknown>, timeoutMs: number | undefined, onTimeout: () => void): Promise<void>;
 //# sourceMappingURL=disposable-chain.d.ts.map

package/dist/disposable-chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disposable-chain.d.ts","sourceRoot":"","sources":["../src/disposable-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAHpC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAS;gBAEG,MAAM,CAAC,EAAE,MAAM,YAAA;IAE5C,iCAAiC;IACjC,IAAI,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAY1B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO;IAO/B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI;CAkBhB"}
+{"version":3,"file":"disposable-chain.d.ts","sourceRoot":"","sources":["../src/disposable-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAHpC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAS;gBAEG,MAAM,CAAC,EAAE,MAAM,YAAA;IAE5C,2CAA2C;IAC3C,IAAI,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,IAAI;IAY7B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,OAAO;IAOlC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI;IAOZ;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAYf;;;;;;;;;OASG;IACG,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAerD;;;;;;OAMG;YACW,gBAAgB;CAK/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,IAAI,iBAsB/G"}

package/dist/disposable-chain.js

@@ -4,7 +4,8 @@
  * 用途：Context 及其他需要累积「注册 → 卸载」副作用的场景，提供：
  * - `push(fn)` 追加清理函数
  * - `remove(fn)` 精确移除单个清理函数（不执行）
- * - `dispose()` 逆序调用所有清理函数并清空；期间任一抛错不影响其他
+ * - `dispose()` 同步逆序调用所有清理函数并清空；期间任一抛错不影响其他
+ * - `disposeAsync(timeoutMs?)` 逆序**串行等待**每个清理函数（含异步返回值）
  *
  * 相比散落的 `this._disposables: (() => void)[]`，集中管理能避免
  * 「忘记 push / 忘记清空 / 错误处理不一致」等低级 bug。
@@ -16,7 +17,7 @@ export class DisposableChain {
     constructor(logger) {
         this.logger = logger;
     }
-    /** 追加一个清理函数。dispose 后追加会立刻执行。 */
+    /** 追加一个清理函数。dispose 后追加会立刻执行（异步返回值不等待）。 */
     push(fn) {
         if (this._disposed) {
             try {
@@ -45,20 +46,29 @@ export class DisposableChain {
         return this._items.length;
     }
     /**
-     * 逆序执行所有清理函数并清空。重复调用无效果。
-     * 单个函数抛错被 swallow（可选择通过 logger 记录 debug）。
+     * 置位 disposed、快照并清空 items——两个 dispose 入口共用，避免逻辑漂移。
+     *
+     * 先清空再迭代快照：dispose 期间 disposer 常回调 remove(自身)（provide /
+     * whenService / subscribe 的自移除语义）。若在迭代中 splice 活动数组，索引
+     * 会错位、长度缩短，导致取到 undefined 而抛 "is not a function"。清空在前
+     * 则这些 remove 作用于空数组、安全 no-op（返回 false，符合各自移除点注释
+     * 的预期），快照索引也始终稳定。
      */
-    dispose() {
-        if (this._disposed)
-            return;
+    take() {
         this._disposed = true;
-        // 先快照并清空，再迭代快照：dispose 期间 disposer 常回调 remove(自身)
-        // （provide / whenService / subscribe 的自移除语义）。若在迭代中 splice 活动
-        // 数组，索引会错位、长度缩短，导致 `this._items[i]` 取到 undefined 而抛
-        // "is not a function"。清空在前则这些 remove 作用于空数组、安全 no-op
-        // （返回 false，符合各自移除点注释的预期），快照索引也始终稳定。
         const items = this._items;
         this._items = [];
+        return items;
+    }
+    /**
+     * 同步逆序执行所有清理函数并清空。重复调用无效果。
+     * 单个函数抛错被 swallow（可选择通过 logger 记录 debug）；
+     * 异步返回值**不等待**——需要等待落盘类清理时用 {@link disposeAsync}。
+     */
+    dispose() {
+        if (this._disposed)
+            return;
+        const items = this.take();
         for (let i = items.length - 1; i >= 0; i--) {
             try {
                 items[i]();
@@ -68,5 +78,75 @@ export class DisposableChain {
             }
         }
     }
+    /**
+     * 逆序**串行**等待所有清理函数完成。
+     *
+     * 串行而非并发是刻意的：逆序是本类对外承诺的语义（消费侧清理先于提供侧），
+     * 落盘类清理常有顺序依赖。单项抛错/拒绝被隔离，不中断后续清理。
+     *
+     * @param timeoutMs 单个异步清理项的等待上限；超时后放弃等待该项、
+     *        **继续执行后续清理项**（定时器/监听器仍能摘干净），并 warn 点名。
+     *        缺省或 <=0 不设限。
+     */
+    async disposeAsync(timeoutMs) {
+        if (this._disposed)
+            return;
+        const items = this.take();
+        for (let i = items.length - 1; i >= 0; i--) {
+            try {
+                const ret = items[i]();
+                if (ret && typeof ret.then === 'function') {
+                    await this.awaitWithTimeout(Promise.resolve(ret), timeoutMs);
+                }
+            }
+            catch (err) {
+                this.logger?.debug('DisposableChain: dispose 抛出，已忽略:', err);
+            }
+        }
+    }
+    /**
+     * 等待单个清理 promise，可选超时护栏。
+     *
+     * 环境无关性记账：这是 core 首个计时器使用点。`setTimeout`/`clearTimeout`
+     * 是所有 JS 运行时（浏览器/Node/Deno/Worker）的共有全局，非 `node:` 专属，
+     * 不引入环境假设。
+     */
+    async awaitWithTimeout(p, timeoutMs) {
+        await awaitWithTimeout(p, timeoutMs, () => this.logger?.warn(`DisposableChain: 异步清理超过 ${timeoutMs}ms，放弃等待，继续后续清理`));
+    }
+}
+/**
+ * 等待一个 promise，可选超时护栏；超时则放弃等待并调 `onTimeout` 上报。
+ *
+ * 环境无关性记账：`setTimeout`/`clearTimeout` 是所有 JS 运行时（浏览器/Node/
+ * Deno/Worker）的共有全局，非 `node:` 专属，不引入环境假设。
+ *
+ * @internal 仅供 core 内部（DisposableChain 逐项等待、Context join 在飞拆卸）复用，
+ *   不从包根导出。
+ */
+export async function awaitWithTimeout(p, timeoutMs, onTimeout) {
+    if (!timeoutMs || timeoutMs <= 0) {
+        await p;
+        return;
+    }
+    let timer;
+    try {
+        const winner = await Promise.race([
+            p.then(() => 'done'),
+            new Promise(resolve => {
+                timer = setTimeout(() => resolve('timeout'), timeoutMs);
+            }),
+        ]);
+        if (winner === 'timeout') {
+            // 放弃等待，但给原 promise 挂空 catch——迟到的 rejection 不得逃逸成 unhandledRejection
+            p.catch(() => { });
+            onTimeout();
+        }
+    }
+    finally {
+        // clearTimeout 必须在 finally：悬空定时器会拖住事件循环，延迟进程退出
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
 }
 //# sourceMappingURL=disposable-chain.js.map

package/dist/disposable-chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"disposable-chain.js","sourceRoot":"","sources":["../src/disposable-chain.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,eAAe;IAIG;IAHrB,MAAM,GAAmB,EAAE,CAAC;IAC5B,SAAS,GAAG,KAAK,CAAC;IAE1B,YAA6B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEhD,iCAAiC;IACjC,IAAI,CAAC,EAAc;QACjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,EAAE,EAAE,CAAC;YACP,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,EAAc;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0CAA0C;IAC1C,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,kDAAkD;QAClD,6DAA6D;QAC7D,oDAAoD;QACpD,qDAAqD;QACrD,qCAAqC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"disposable-chain.js","sourceRoot":"","sources":["../src/disposable-chain.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAe;IAIG;IAHrB,MAAM,GAAsB,EAAE,CAAC;IAC/B,SAAS,GAAG,KAAK,CAAC;IAE1B,YAA6B,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEhD,2CAA2C;IAC3C,IAAI,CAAC,EAAiB;QACpB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,EAAE,EAAE,CAAC;YACP,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,uCAAuC,GAAG,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,EAAiB;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0CAA0C;IAC1C,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACK,IAAI;QACV,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,YAAY,CAAC,SAAkB;QACnC,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvB,IAAI,GAAG,IAAI,OAAQ,GAA4B,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBACpE,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,gBAAgB,CAAC,CAAmB,EAAE,SAAkB;QACpE,MAAM,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CACxC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,2BAA2B,SAAS,gBAAgB,CAAC,CACxE,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,CAAmB,EAAE,SAA6B,EAAE,SAAqB;IAC9G,IAAI,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,CAAC;QACR,OAAO;IACT,CAAC;IACD,IAAI,KAAgD,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAe,CAAC;YAC7B,IAAI,OAAO,CAAY,OAAO,CAAC,EAAE;gBAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;YAC1D,CAAC,CAAC;SACH,CAAC,CAAC;QACH,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,oEAAoE;YACpE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAClB,SAAS,EAAE,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,+CAA+C;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/events.d.ts

@@ -20,7 +20,7 @@ export declare class EventBus {
     onHandlerError?: (event: string, error: unknown) => void;
     private reportHandlerError;
     /**
-     * 一次性事件（sticky）：emit 后保留最近一次参数；后续 on/once 监听该事件时
+     * 一次性事件（sticky）：emit 后保留最近一次参数；后续 on 监听该事件时
      * 立即用缓存参数同步触发回调。用于"应用生命周期里只发一次的里程碑事件"，
      * 让被热重载的插件在 reactivate 后仍能拿到启动通知。
      * 当前标记为 sticky 的事件：'ready'、'app:started'。
@@ -41,10 +41,6 @@ export declare class EventBus {
      * 再触发，避免 handler 内部的 await 影响调用方流程）。
      */
     on<E extends string & keyof AalisEvents>(event: E, handler: EventHandler<AalisEvents[E]>): () => void;
-    /**
-     * 监听事件一次
-     */
-    once<E extends string & keyof AalisEvents>(event: E, handler: EventHandler<AalisEvents[E]>): () => void;
     /**
      * 触发事件，按注册顺序依次调用，支持异步 handler。
      *
@@ -55,10 +51,6 @@ export declare class EventBus {
      * 插件打成 error 终态）。
      */
     emit<E extends string & keyof AalisEvents>(event: E, ...args: AalisEvents[E]): Promise<void>;
-    /**
-     * 移除指定事件的所有监听器
-     */
-    removeAll(event?: string): void;
 }
 export {};
 //# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,KAAK,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF;;;;;;GAMG;AACH,qBAAa,QAAQ;IAEnB,OAAO,CAAC,QAAQ,CAA6C;IAE7D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzD,OAAO,CAAC,kBAAkB;IAa1B;;;;;;;;;OASG;IAEH,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAqB;IAEzC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQjC;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAgCrG;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IASvG;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlG;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;CAOhC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,KAAK,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF;;;;;;GAMG;AACH,qBAAa,QAAQ;IAEnB,OAAO,CAAC,QAAQ,CAA6C;IAE7D;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzD,OAAO,CAAC,kBAAkB;IAa1B;;;;;;;;;OASG;IAEH,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAqB;IAEzC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQjC;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAgCrG;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAenG"}

package/dist/events.js

@@ -31,7 +31,7 @@ export class EventBus {
         }
     }
     /**
-     * 一次性事件（sticky）：emit 后保留最近一次参数；后续 on/once 监听该事件时
+     * 一次性事件（sticky）：emit 后保留最近一次参数；后续 on 监听该事件时
      * 立即用缓存参数同步触发回调。用于"应用生命周期里只发一次的里程碑事件"，
      * 让被热重载的插件在 reactivate 后仍能拿到启动通知。
      * 当前标记为 sticky 的事件：'ready'、'app:started'。
@@ -93,17 +93,6 @@ export class EventBus {
                 this.handlers.delete(event);
         };
     }
-    /**
-     * 监听事件一次
-     */
-    once(event, handler) {
-        const wrapper = (...args) => {
-            dispose();
-            return handler(...args);
-        };
-        const dispose = this.on(event, wrapper);
-        return dispose;
-    }
     /**
      * 触发事件，按注册顺序依次调用，支持异步 handler。
      *
@@ -130,16 +119,5 @@ export class EventBus {
             }
         }
     }
-    /**
-     * 移除指定事件的所有监听器
-     */
-    removeAll(event) {
-        if (event) {
-            this.handlers.delete(event);
-        }
-        else {
-            this.handlers.clear();
-        }
-    }
 }
 //# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IACnB,mFAAmF;IAC3E,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE7D;;;;;;;OAOG;IACH,cAAc,CAA2C;IAEjD,kBAAkB,CAAC,KAAa,EAAE,KAAc;QACtD,IAAI,CAAC;YACH,2DAA2D;YAC3D,0DAA0D;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,CAAY,CAAC;YAC3D,IAAI,GAAG,IAAI,OAAQ,GAA0B,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACjE,GAAwB,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,iDAAiD;IACzC,UAAU,GAAG,IAAI,GAAG,EAAiB,CAAC;IACtC,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,UAAU,CAAC,KAAa;QACtB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,KAAc;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,EAAE,CAAuC,KAAQ,EAAE,OAAqC;QACtF,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEjB,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAmB,CAAC;YAC1D,cAAc,CAAC,GAAG,EAAE;gBAClB,gCAAgC;gBAChC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC;oBAAE,OAAO;gBAC/B,qDAAqD;gBACrD,uCAAuC;gBACvC,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;oBAC7B,IAAI,GAAG,IAAI,OAAQ,GAAqB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;wBAC5D,GAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;oBAC3E,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,GAAG,EAAE;YACV,GAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrB,IAAI,GAAI,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,CAAuC,KAAQ,EAAE,OAAqC;QACxF,MAAM,OAAO,GAAiC,CAAC,GAAG,IAAI,EAAE,EAAE;YACxD,OAAO,EAAE,CAAC;YACV,OAAO,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAuC,KAAQ,EAAE,GAAG,IAAoB;QAChF,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,sDAAsD;QACtD,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAc;QACtB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/hooks.d.ts

@@ -1,23 +1,4 @@
 import type { HookContextMap, MiddlewareFn } from './types/index.js';
-/**
- * 钩子执行面 —— `ctx.hooks` 暴露给插件的窄接口。
- *
- * 与 events / services 相同的门面纪律（驱动公开、挂载走 id 绑定门面）：
- * - **驱动公开**：任何插件都可 `ctx.hooks.run(...)` 驱动自己定义的钩子链
- *   （对称钩子系统的立身之本，地位等价于 `ctx.emit`）；
- * - **挂载走门面**：注册 handler 只经 `ctx.middleware(hook, fn)` —— 它闭包当前
- *   ctx.id 作 contextId 并登记 dispose 链，插件卸载时才能被 `unregisterByContext`
- *   清扫。裸 `register` 默认落到 'root'，会静默泄漏进全局管道，故不在本接口上。
- *
- * 完整的 {@link HookRegistry}（register / unregisterByContext / onStall）仅
- * App（组合根，接 onStall 到 logger）与 Context 内部持有。
- */
-export interface HookRunner {
-    /** 执行钩子链；语义见 {@link HookRegistry.run}。 */
-    run<K extends string & keyof HookContextMap>(hook: K, data: HookContextMap[K], defaultAction?: () => Promise<void>, opts?: {
-        warnOnStall?: boolean;
-    }): Promise<boolean>;
-}
 /**
  * 钩子注册表 —— 命名生命周期事件的 handler 总线
  *
@@ -28,8 +9,12 @@ export interface HookRunner {
  * 不再使用数字 priority：相位之间的次序由调度方（plugin-gateway 等）
  * 显式表达；相位内部的 handler 应顺序无关，或由相位拥有方约定。
  *
- * 插件通过 `ctx.middleware(hook, fn)` 注册 handler。
- * 服务在关键流程点执行 `hooks.run(hook, data, defaultAction)`。
+ * 插件面与 events / services 同一门面纪律（方法窄面，对象不外露）：
+ * 注册 handler 只经 `ctx.middleware(hook, fn)`（闭包 ctx.id 作 contextId 并登记
+ * dispose 链，插件卸载时被 `unregisterByContext` 清扫；裸 `register` 默认落
+ * 'root'，会静默泄漏进全局管道）；驱动钩子链经 `ctx.runHook(hook, data,
+ * defaultAction)`。完整注册表仅 App（组合根，接 onStall 到 logger）与
+ * Context 内部持有。
  *
  * Handler 可以：
  * - 修改 data 对象（引用传递）
@@ -38,7 +23,7 @@ export interface HookRunner {
  *
  * 第三方插件可通过 TS declaration merging 扩展 HookContextMap。
  */
-export declare class HookRegistry implements HookRunner {
+export declare class HookRegistry {
     private hooks;
     /**
      * 广播型相位的"卡链"上报回调（由 App 接到 logger）。

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAOrF;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,cAAc,EACzC,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACnC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,YAAW,UAAU;IAE7C,OAAO,CAAC,KAAK,CAAuC;IAEpD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1E;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,cAAc,EAC9C,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EACnC,SAAS,GAAE,MAAe,GACzB,MAAM,IAAI;IAsBb;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,cAAc,EAC/C,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACnC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC,OAAO,CAAC;IA8BnB;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAU7C"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAOrF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,KAAK,CAAuC;IAEpD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1E;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,cAAc,EAC9C,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EACnC,SAAS,GAAE,MAAe,GACzB,MAAM,IAAI;IAsBb;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,cAAc,EAC/C,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACnC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC,OAAO,CAAC;IA8BnB;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAU7C"}

package/dist/hooks.js

@@ -8,8 +8,12 @@
  * 不再使用数字 priority：相位之间的次序由调度方（plugin-gateway 等）
  * 显式表达；相位内部的 handler 应顺序无关，或由相位拥有方约定。
  *
- * 插件通过 `ctx.middleware(hook, fn)` 注册 handler。
- * 服务在关键流程点执行 `hooks.run(hook, data, defaultAction)`。
+ * 插件面与 events / services 同一门面纪律（方法窄面，对象不外露）：
+ * 注册 handler 只经 `ctx.middleware(hook, fn)`（闭包 ctx.id 作 contextId 并登记
+ * dispose 链，插件卸载时被 `unregisterByContext` 清扫；裸 `register` 默认落
+ * 'root'，会静默泄漏进全局管道）；驱动钩子链经 `ctx.runHook(hook, data,
+ * defaultAction)`。完整注册表仅 App（组合根，接 onStall 到 logger）与
+ * Context 内部持有。
  *
  * Handler 可以：
  * - 修改 data 对象（引用传递）

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -1,16 +1,17 @@
 export type { AppOptions } from './app.js';
 export { App, createApp } from './app.js';
 export type { AalisConfig, ConfigManagerOptions } from './config.js';
-export { CORE_CONFIG_SCHEMA, ConfigManager } from './config.js';
+export { ConfigManager } from './config.js';
 export { Context } from './context.js';
+export { type ContributionHandle, ContributionRegistry, type ContributionSpec } from './contributions.js';
 export { EventBus } from './events.js';
-export { HookRegistry, type HookRunner } from './hooks.js';
+export { HookRegistry } from './hooks.js';
 export type { LogEntry, LogLevel } from './logger.js';
 export { DefaultLogger, formatLogLine, type Logger, LogHub, parseLogLine } from './logger.js';
 export type { PluginEntry, PluginModule, PluginState } from './plugin.js';
 export { PluginManager, parseInstanceId } from './plugin.js';
 export type { ConfigProvider, PluginDescriptor, PluginLoader, RestartStrategy } from './providers.js';
-export type { NormalizedDependency, ServiceEntry, ServicePriorityValue } from './service.js';
-export { ServiceContainer, ServicePriority } from './service.js';
-export type { AalisEvents, AppService, ConfigSchema, DependencyDeclaration, DisposableService, HookContextMap, InjectDeclaration, MiddlewareFn, MiddlewareNext, PluginManagerService, PluginStatusEntry, SchemaArray, SchemaField, SchemaFieldType, SchemaFieldTypes, SchemaGroup, ServiceDependency, ServiceOf, ServiceTypeMap, } from './types/index.js';
+export type { NormalizedDependency, ServiceEntry, ServicePriorityValue } from './services.js';
+export { ServiceContainer, ServicePriority } from './services.js';
+export type { AalisEvents, AppService, ContributionPointMap, DependencyDeclaration, DisposableService, HookContextMap, InjectDeclaration, MiddlewareFn, MiddlewareNext, PluginManagerService, PluginStatusEntry, ServiceDependency, ServiceOf, ServiceTypeMap, } from './types/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9F,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtG,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEjE,YAAY,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,cAAc,GACf,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,KAAK,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1G,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9F,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtG,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE,YAAY,EACV,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,cAAc,GACf,MAAM,kBAAkB,CAAC"}