@dsh-plugin/dsh-loader 1.3.3-dev.33217535464 → 1.3.3-dev.33722395196

package/lib/types/adapters/dsh-1-x.d.ts

@@ -6,9 +6,16 @@ export declare const hostPackageAliases: Record<string, string>;
 export declare const clientModuleAliases: Record<string, string>;
 export declare const clientPackageAliases: Record<string, string>;
 /**
- * Install a Module._resolveFilename hook that maps old package names to
- * new ones for CJS require() calls. Returns a dispose function that
- * removes the hook.
+ * Ensure the single Module._resolveFilename hook exists and merge `aliases`
+ * into its shared map. Never adds a wrapper: repeat calls (runtime
+ * `registerPackageAlias`, HMR re-apply) only mutate the map. When the chain
+ * top was replaced without chaining into us (the mapping silently stops
+ * applying), the hook is re-pointed at the current top — still the same
+ * single wrapper, no growth.
+ *
+ * Returns a dispose function that rolls back exactly the entries this call
+ * set (when unchanged since) and restores the original resolver once the
+ * last registrant disposes.
  */
 export declare function installHostPackageAliases(aliases: Record<string, string>): Promise<() => void>;
 /**

package/lib/types/client-connection-api-compat.d.ts

@@ -6,6 +6,9 @@ export declare const REMOTE_SERVICE = "remote";
 export interface ConnectionApiCompatContext {
     get?(name: string): unknown;
     inject?(inject: string[], callback: (ctx: ConnectionApiCompatContext) => unknown): unknown;
+    /** cordis effect hook: when present, the bridge assignment and the
+     * fallback timer are torn down with the fiber (HMR-safe). */
+    effect?(fn: () => (() => void) | void): unknown;
 }
 /** Bare RpcResult the 0.1.2 Typert remote resolves to. */
 export interface RpcResultOk<T> {

package/lib/types/client-ui.d.ts

@@ -53,5 +53,9 @@ interface ClientContextLike {
  * facade, then publishes it both as the `dshLoaderUi` cordis service
  * (ordered access) and on `window.__dshLoader__.ui` (ad-hoc access from
  * non-cordis code).
+ *
+ * Every patch installClient makes (the load wrapper, the settings fetch
+ * interceptor) is registered through `ctx.effect`, so fiber unload / HMR
+ * reverts them instead of stacking wrappers on the shared window.
  */
 export declare function apply(ctx: ClientContextLike): void;

package/lib/types/client.d.ts

@@ -124,6 +124,13 @@ interface InstallClientOpts {
     clientCtx?: {
         get?: (name: string) => any;
     };
+    /**
+     * cordis effect hook (`ctx.effect`): the load wrapper and fetch
+     * interceptor register their disposers through it so fiber unload / HMR
+     * tears the patches down instead of leaking them. Absent in bare test
+     * environments, where patches simply live for the process.
+     */
+    effect?: (fn: () => (() => void) | void) => unknown;
 }
 /**
  * Install dshloader into a browser-like environment.
@@ -183,5 +190,6 @@ export declare function apply(ctx: {
     loader?: {
         internal?: DshModulesLike;
     };
+    effect?: (fn: () => (() => void) | void) => unknown;
 }): void;
 export {};

package/lib/types/types.d.ts

@@ -90,16 +90,19 @@ export interface SettingsAPI {
      */
     namespace(id: string): any;
     /**
-     * Install the canonical optional-settings consumer wiring (delegates to dsh's
-     * `installSettingsSection`): register `ns` with `entry` as the `base` layer,
-     * point the hooks' source thunk at the resolved scope while a settings service
-     * exists, and fall back to `entry` when it goes away.
+     * Install the canonical optional-settings consumer wiring: register `ns`
+     * with `entry` as the `base` layer, point the hooks' source thunk at the
+     * resolved scope while a settings service exists, and fall back to `entry`
+     * when it goes away.
      *
-     * Delegated rather than reimplemented — the fallback and fiber semantics are
-     * real upstream behaviour, not something a shim should copy.
+     * Delegates to dsh's `installSettingsSection` when the module exports it
+     * (dsh ≤ 0.1.2-alpha.1); on dsh ≥ 0.1.2-alpha.2 (which dropped the export
+     * but kept the settings service register() contract identical) the facade
+     * runs a faithful port of the same upstream semantics instead.
      *
-     * @returns `true` when the wiring was installed, `false` when dsh-settings is
-     *   unavailable (the caller then keeps using its composition entry).
+     * @returns `true` when the wiring was installed, `false` when the caller's
+     *   context cannot inject the settings service (the caller then keeps using
+     *   its composition entry).
      */
     installSection<T>(ctx: any, ns: any, schema: any, entry: T, hooks: {
         setSource(current: () => T): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugin/dsh-loader",
-  "version": "1.3.3-dev.33217535464",
+  "version": "1.3.3-dev.33722395196",
   "description": "Runtime compatibility shim for dsh (DeepSeek Harness) cordis bundle plugins: decouples third-party plugins from real dsh internal service names, module paths, and RPC details via a version-aware adapter registry.",
   "type": "module",
   "repository": {