@embedpdf/plugin-interaction-manager 1.4.1 → 2.0.0-next.0

package/dist/index.js

@@ -1,52 +1,53 @@
 import { BasePlugin, createEmitter, createBehaviorEmitter } from "@embedpdf/core";
+const INIT_INTERACTION_STATE = "INTERACTION/INIT_STATE";
+const CLEANUP_INTERACTION_STATE = "INTERACTION/CLEANUP_STATE";
 const ACTIVATE_MODE = "INTERACTION/ACTIVATE_MODE";
 const PAUSE_INTERACTION = "INTERACTION/PAUSE";
 const RESUME_INTERACTION = "INTERACTION/RESUME";
 const SET_CURSOR = "INTERACTION/SET_CURSOR";
+const SET_ACTIVE_DOCUMENT = "INTERACTION/SET_ACTIVE_DOCUMENT";
 const SET_DEFAULT_MODE = "INTERACTION/SET_DEFAULT_MODE";
 const SET_EXCLUSION_RULES = "INTERACTION/SET_EXCLUSION_RULES";
 const ADD_EXCLUSION_CLASS = "INTERACTION/ADD_EXCLUSION_CLASS";
 const REMOVE_EXCLUSION_CLASS = "INTERACTION/REMOVE_EXCLUSION_CLASS";
 const ADD_EXCLUSION_ATTRIBUTE = "INTERACTION/ADD_EXCLUSION_ATTRIBUTE";
 const REMOVE_EXCLUSION_ATTRIBUTE = "INTERACTION/REMOVE_EXCLUSION_ATTRIBUTE";
-const setExclusionRules = (rules) => ({
-  type: SET_EXCLUSION_RULES,
-  payload: { rules }
-});
-const addExclusionClass = (className) => ({
-  type: ADD_EXCLUSION_CLASS,
-  payload: { className }
-});
-const removeExclusionClass = (className) => ({
-  type: REMOVE_EXCLUSION_CLASS,
-  payload: { className }
-});
-const addExclusionAttribute = (attribute) => ({
-  type: ADD_EXCLUSION_ATTRIBUTE,
-  payload: { attribute }
-});
-const removeExclusionAttribute = (attribute) => ({
-  type: REMOVE_EXCLUSION_ATTRIBUTE,
-  payload: { attribute }
-});
-const activateMode = (mode) => ({
-  type: ACTIVATE_MODE,
-  payload: { mode }
-});
-const setCursor = (cursor) => ({
-  type: SET_CURSOR,
-  payload: { cursor }
-});
-const setDefaultMode = (mode) => ({
-  type: SET_DEFAULT_MODE,
-  payload: { mode }
-});
-const pauseInteraction = () => ({
-  type: PAUSE_INTERACTION
-});
-const resumeInteraction = () => ({
-  type: RESUME_INTERACTION
-});
+function initInteractionState(documentId, state) {
+  return { type: INIT_INTERACTION_STATE, payload: { documentId, state } };
+}
+function cleanupInteractionState(documentId) {
+  return { type: CLEANUP_INTERACTION_STATE, payload: documentId };
+}
+function activateMode(documentId, mode) {
+  return { type: ACTIVATE_MODE, payload: { documentId, mode } };
+}
+function pauseInteraction(documentId) {
+  return { type: PAUSE_INTERACTION, payload: documentId };
+}
+function resumeInteraction(documentId) {
+  return { type: RESUME_INTERACTION, payload: documentId };
+}
+function setCursor(documentId, cursor) {
+  return { type: SET_CURSOR, payload: { documentId, cursor } };
+}
+function setDefaultMode(mode) {
+  return { type: SET_DEFAULT_MODE, payload: { mode } };
+}
+function setExclusionRules(rules) {
+  return { type: SET_EXCLUSION_RULES, payload: { rules } };
+}
+function addExclusionClass(className) {
+  return { type: ADD_EXCLUSION_CLASS, payload: { className } };
+}
+function removeExclusionClass(className) {
+  return { type: REMOVE_EXCLUSION_CLASS, payload: { className } };
+}
+function addExclusionAttribute(attribute) {
+  return { type: ADD_EXCLUSION_ATTRIBUTE, payload: { attribute } };
+}
+function removeExclusionAttribute(attribute) {
+  return { type: REMOVE_EXCLUSION_ATTRIBUTE, payload: { attribute } };
+}
 function mergeHandlers(list) {
   const keys = [
     "onPointerDown",
@@ -73,55 +74,92 @@ function mergeHandlers(list) {
   }
   return out;
 }
-const INITIAL_MODE = "pointerMode";
+const INITIAL_MODE$1 = "pointerMode";
 const _InteractionManagerPlugin = class _InteractionManagerPlugin extends BasePlugin {
   constructor(id, registry, config) {
     super(id, registry);
     this.modes = /* @__PURE__ */ new Map();
     this.cursorClaims = /* @__PURE__ */ new Map();
     this.buckets = /* @__PURE__ */ new Map();
-    this.alwaysGlobal = /* @__PURE__ */ new Set();
+    this.alwaysGlobal = /* @__PURE__ */ new Map();
     this.alwaysPage = /* @__PURE__ */ new Map();
     this.onModeChange$ = createEmitter();
     this.onHandlerChange$ = createEmitter();
     this.onCursorChange$ = createEmitter();
     this.onStateChange$ = createBehaviorEmitter();
     this.registerMode({
-      id: INITIAL_MODE,
+      id: INITIAL_MODE$1,
       scope: "page",
       exclusive: false,
       cursor: "auto"
     });
-    this.setDefaultMode(INITIAL_MODE);
-    this.activate(INITIAL_MODE);
+    this.dispatch(setDefaultMode(INITIAL_MODE$1));
     if (config.exclusionRules) {
       this.dispatch(setExclusionRules(config.exclusionRules));
     }
   }
-  async initialize(_) {
+  // ─────────────────────────────────────────────────────────
+  // Document Lifecycle Hooks (from BasePlugin)
+  // ─────────────────────────────────────────────────────────
+  onDocumentLoadingStarted(documentId) {
+    const docState = {
+      activeMode: this.state.defaultMode,
+      cursor: "auto",
+      paused: false
+    };
+    this.dispatch(initInteractionState(documentId, docState));
+    this.cursorClaims.set(documentId, /* @__PURE__ */ new Map());
+    this.buckets.set(documentId, /* @__PURE__ */ new Map());
+    this.alwaysGlobal.set(documentId, /* @__PURE__ */ new Set());
+    this.alwaysPage.set(documentId, /* @__PURE__ */ new Map());
+    const docBuckets = this.buckets.get(documentId);
+    for (const modeId of this.modes.keys()) {
+      docBuckets.set(modeId, { global: /* @__PURE__ */ new Set(), page: /* @__PURE__ */ new Map() });
+    }
+    this.logger.debug(
+      "InteractionManagerPlugin",
+      "DocumentOpened",
+      `Initialized interaction state for document: ${documentId}`
+    );
+  }
+  onDocumentClosed(documentId) {
+    this.cursorClaims.delete(documentId);
+    this.buckets.delete(documentId);
+    this.alwaysGlobal.delete(documentId);
+    this.alwaysPage.delete(documentId);
+    this.dispatch(cleanupInteractionState(documentId));
+    this.logger.debug(
+      "InteractionManagerPlugin",
+      "DocumentClosed",
+      `Cleaned up interaction state for document: ${documentId}`
+    );
   }
+  // ─────────────────────────────────────────────────────────
+  // Capability
+  // ─────────────────────────────────────────────────────────
   buildCapability() {
     return {
-      activate: (modeId) => this.activate(modeId),
-      onModeChange: this.onModeChange$.on,
-      onCursorChange: this.onCursorChange$.on,
-      onHandlerChange: this.onHandlerChange$.on,
-      onStateChange: this.onStateChange$.on,
-      getActiveMode: () => this.state.activeMode,
+      // Active document operations
+      getActiveMode: () => this.getActiveMode(),
       getActiveInteractionMode: () => this.getActiveInteractionMode(),
-      activateDefaultMode: () => this.activate(this.state.defaultMode),
-      registerMode: (mode) => this.registerMode(mode),
-      registerHandlers: (options) => this.registerHandlers(options),
-      registerAlways: (options) => this.registerAlways(options),
-      setCursor: (token, cursor, priority = 0) => this.setCursor(token, cursor, priority),
+      activate: (modeId) => this.activate(modeId),
+      activateDefaultMode: () => this.activateDefaultMode(),
+      setCursor: (token, cursor, priority) => this.setCursor(token, cursor, priority),
+      getCurrentCursor: () => this.getCurrentCursor(),
       removeCursor: (token) => this.removeCursor(token),
-      getCurrentCursor: () => this.state.cursor,
       getHandlersForScope: (scope) => this.getHandlersForScope(scope),
       activeModeIsExclusive: () => this.activeModeIsExclusive(),
-      pause: () => this.dispatch(pauseInteraction()),
-      resume: () => this.dispatch(resumeInteraction()),
+      pause: () => this.pause(),
+      resume: () => this.resume(),
       // Treat a destroyed registry as "paused" so late DOM events are ignored during teardown.
-      isPaused: () => this.registry.isDestroyed() || this.state.paused,
+      isPaused: () => this.registry.isDestroyed() || this.isPaused(),
+      getState: () => this.getDocumentStateOrThrow(),
+      // Document-scoped operations
+      forDocument: (documentId) => this.createInteractionScope(documentId),
+      // Global management
+      registerMode: (mode) => this.registerMode(mode),
+      registerHandlers: (options) => this.registerHandlers(options),
+      registerAlways: (options) => this.registerAlways(options),
       setDefaultMode: (id) => this.setDefaultMode(id),
       getDefaultMode: () => this.state.defaultMode,
       getExclusionRules: () => this.state.exclusionRules,
@@ -129,21 +167,83 @@ const _InteractionManagerPlugin = class _InteractionManagerPlugin extends BasePl
       addExclusionClass: (className) => this.dispatch(addExclusionClass(className)),
       removeExclusionClass: (className) => this.dispatch(removeExclusionClass(className)),
       addExclusionAttribute: (attribute) => this.dispatch(addExclusionAttribute(attribute)),
-      removeExclusionAttribute: (attribute) => this.dispatch(removeExclusionAttribute(attribute))
+      removeExclusionAttribute: (attribute) => this.dispatch(removeExclusionAttribute(attribute)),
+      // Events
+      onModeChange: this.onModeChange$.on,
+      onCursorChange: this.onCursorChange$.on,
+      onHandlerChange: this.onHandlerChange$.on,
+      onStateChange: this.onStateChange$.on
+    };
+  }
+  // ─────────────────────────────────────────────────────────
+  // Document Scoping
+  // ─────────────────────────────────────────────────────────
+  createInteractionScope(documentId) {
+    return {
+      getActiveMode: () => this.getActiveMode(documentId),
+      getActiveInteractionMode: () => this.getActiveInteractionMode(documentId),
+      activate: (modeId) => this.activate(modeId, documentId),
+      activateDefaultMode: () => this.activateDefaultMode(documentId),
+      setCursor: (token, cursor, priority) => this.setCursor(token, cursor, priority, documentId),
+      getCurrentCursor: () => this.getCurrentCursor(documentId),
+      removeCursor: (token) => this.removeCursor(token, documentId),
+      getHandlersForScope: (scope) => this.getHandlersForScope(scope),
+      activeModeIsExclusive: () => this.activeModeIsExclusive(documentId),
+      pause: () => this.pause(documentId),
+      resume: () => this.resume(documentId),
+      isPaused: () => this.isPaused(documentId),
+      getState: () => this.getDocumentStateOrThrow(documentId),
+      onModeChange: (listener) => this.onModeChange$.on((event) => {
+        if (event.documentId === documentId) listener(event.activeMode);
+      }),
+      onCursorChange: (listener) => this.onCursorChange$.on((event) => {
+        if (event.documentId === documentId) listener(event.cursor);
+      }),
+      onStateChange: (listener) => this.onStateChange$.on((event) => {
+        if (event.documentId === documentId) listener(event.state);
+      })
     };
   }
-  activate(mode) {
-    if (!this.modes.has(mode)) {
-      throw new Error(`[interaction] unknown mode '${mode}'`);
+  // ─────────────────────────────────────────────────────────
+  // State Helpers
+  // ─────────────────────────────────────────────────────────
+  getDocumentState(documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    return this.state.documents[id] ?? null;
+  }
+  getDocumentStateOrThrow(documentId) {
+    const state = this.getDocumentState(documentId);
+    if (!state) {
+      throw new Error(`Interaction state not found for document: ${documentId ?? "active"}`);
     }
-    if (mode === this.state.activeMode) return;
-    const previousMode = this.state.activeMode;
-    this.cursorClaims.clear();
-    this.notifyHandlersInactive(previousMode);
-    this.dispatch(activateMode(mode));
-    this.emitCursor();
-    this.notifyHandlersActive(mode);
-    this.onModeChange$.emit({ ...this.state, activeMode: mode });
+    return state;
+  }
+  // ─────────────────────────────────────────────────────────
+  // Core Operations
+  // ─────────────────────────────────────────────────────────
+  activate(modeId, documentId) {
+    var _a;
+    const id = documentId ?? this.getActiveDocumentId();
+    const docState = this.getDocumentStateOrThrow(id);
+    if (!this.modes.has(modeId)) {
+      throw new Error(`[interaction] unknown mode '${modeId}'`);
+    }
+    if (modeId === docState.activeMode) return;
+    const previousMode = docState.activeMode;
+    (_a = this.cursorClaims.get(id)) == null ? void 0 : _a.clear();
+    this.notifyHandlersInactive(id, previousMode);
+    this.dispatch(activateMode(id, modeId));
+    this.emitCursor(id);
+    this.notifyHandlersActive(id, modeId);
+    this.onModeChange$.emit({
+      documentId: id,
+      activeMode: modeId,
+      previousMode
+    });
+  }
+  activateDefaultMode(documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    this.activate(this.state.defaultMode, id);
   }
   setDefaultMode(modeId) {
     if (!this.modes.has(modeId)) {
@@ -151,78 +251,58 @@ const _InteractionManagerPlugin = class _InteractionManagerPlugin extends BasePl
     }
     this.dispatch(setDefaultMode(modeId));
   }
-  notifyHandlersActive(modeId) {
-    this.alwaysGlobal.forEach((handler) => {
-      var _a;
-      (_a = handler.onHandlerActiveStart) == null ? void 0 : _a.call(handler, modeId);
-    });
-    this.alwaysPage.forEach((handlerSet) => {
-      handlerSet.forEach((handler) => {
-        var _a;
-        (_a = handler.onHandlerActiveStart) == null ? void 0 : _a.call(handler, modeId);
-      });
-    });
-    const mode = this.modes.get(modeId);
-    if (!mode) return;
-    const bucket = this.buckets.get(modeId);
-    if (!bucket) return;
-    if (mode.scope === "global") {
-      bucket.global.forEach((handler) => {
-        var _a;
-        (_a = handler.onHandlerActiveStart) == null ? void 0 : _a.call(handler, modeId);
-      });
-    }
-    if (mode.scope === "page") {
-      bucket.page.forEach((handlerSet, pageIndex) => {
-        handlerSet.forEach((handler) => {
-          var _a;
-          (_a = handler.onHandlerActiveStart) == null ? void 0 : _a.call(handler, modeId);
-        });
-      });
-    }
+  getActiveMode(documentId) {
+    return this.getDocumentStateOrThrow(documentId).activeMode;
   }
-  notifyHandlersInactive(modeId) {
-    this.alwaysGlobal.forEach((handler) => {
-      var _a;
-      (_a = handler.onHandlerActiveEnd) == null ? void 0 : _a.call(handler, modeId);
-    });
-    this.alwaysPage.forEach((handlerSet) => {
-      handlerSet.forEach((handler) => {
-        var _a;
-        (_a = handler.onHandlerActiveEnd) == null ? void 0 : _a.call(handler, modeId);
-      });
-    });
-    const mode = this.modes.get(modeId);
-    if (!mode) return;
-    const bucket = this.buckets.get(modeId);
-    if (!bucket) return;
-    if (mode.scope === "global") {
-      bucket.global.forEach((handler) => {
-        var _a;
-        (_a = handler.onHandlerActiveEnd) == null ? void 0 : _a.call(handler, modeId);
-      });
-    }
-    if (mode.scope === "page") {
-      bucket.page.forEach((handlerSet, pageIndex) => {
-        handlerSet.forEach((handler) => {
-          var _a;
-          (_a = handler.onHandlerActiveEnd) == null ? void 0 : _a.call(handler, modeId);
-        });
-      });
-    }
+  getActiveInteractionMode(documentId) {
+    const docState = this.getDocumentState(documentId);
+    if (!docState) return null;
+    return this.modes.get(docState.activeMode) ?? null;
+  }
+  activeModeIsExclusive(documentId) {
+    const mode = this.getActiveInteractionMode(documentId);
+    return !!(mode == null ? void 0 : mode.exclusive);
+  }
+  pause(documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    this.dispatch(pauseInteraction(id));
+  }
+  resume(documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    this.dispatch(resumeInteraction(id));
   }
+  isPaused(documentId) {
+    return this.getDocumentStateOrThrow(documentId).paused;
+  }
+  // ─────────────────────────────────────────────────────────
+  // Mode Management
+  // ─────────────────────────────────────────────────────────
   registerMode(mode) {
     this.modes.set(mode.id, mode);
-    if (!this.buckets.has(mode.id)) {
-      this.buckets.set(mode.id, { global: /* @__PURE__ */ new Set(), page: /* @__PURE__ */ new Map() });
+    for (const documentId of this.buckets.keys()) {
+      const docBuckets = this.buckets.get(documentId);
+      if (!docBuckets.has(mode.id)) {
+        docBuckets.set(mode.id, { global: /* @__PURE__ */ new Set(), page: /* @__PURE__ */ new Map() });
+      }
     }
   }
-  /** ---------- pointer-handler handling ------------ */
-  registerHandlers({ modeId, handlers, pageIndex }) {
+  // ─────────────────────────────────────────────────────────
+  // Handler Management
+  // ─────────────────────────────────────────────────────────
+  registerHandlers({
+    documentId,
+    modeId,
+    handlers,
+    pageIndex
+  }) {
     const modeIds = Array.isArray(modeId) ? modeId : [modeId];
     const cleanupFunctions = [];
+    const docBuckets = this.buckets.get(documentId);
+    if (!docBuckets) {
+      throw new Error(`No buckets found for document: ${documentId}`);
+    }
     for (const id of modeIds) {
-      const bucket = this.buckets.get(id);
+      const bucket = docBuckets.get(id);
       if (!bucket) throw new Error(`unknown mode '${id}'`);
       if (pageIndex == null) {
         bucket.global.add(handlers);
@@ -253,72 +333,182 @@ const _InteractionManagerPlugin = class _InteractionManagerPlugin extends BasePl
   }
   registerAlways({ scope, handlers }) {
     if (scope.type === "global") {
-      this.alwaysGlobal.add(handlers);
+      const set2 = this.alwaysGlobal.get(scope.documentId) ?? /* @__PURE__ */ new Set();
+      set2.add(handlers);
+      this.alwaysGlobal.set(scope.documentId, set2);
       this.onHandlerChange$.emit({ ...this.state });
-      return () => this.alwaysGlobal.delete(handlers);
+      return () => {
+        set2.delete(handlers);
+        this.onHandlerChange$.emit({ ...this.state });
+      };
     }
-    const set = this.alwaysPage.get(scope.pageIndex) ?? /* @__PURE__ */ new Set();
+    const docPageMap = this.alwaysPage.get(scope.documentId) ?? /* @__PURE__ */ new Map();
+    const set = docPageMap.get(scope.pageIndex) ?? /* @__PURE__ */ new Set();
     set.add(handlers);
-    this.alwaysPage.set(scope.pageIndex, set);
+    docPageMap.set(scope.pageIndex, set);
+    this.alwaysPage.set(scope.documentId, docPageMap);
     this.onHandlerChange$.emit({ ...this.state });
     return () => {
       set.delete(handlers);
       this.onHandlerChange$.emit({ ...this.state });
     };
   }
-  /** Returns the *merged* handler set that should be active for the given
-   *  provider (`global` wrapper or a single page wrapper).
-   *  – `alwaysGlobal` / `alwaysPage` are **always** active.
-   *  – Handlers that belong to the current mode are added on top **iff**
-   *    the mode’s own scope matches the provider’s scope.            */
   getHandlersForScope(scope) {
-    if (!this.state) return null;
-    const mode = this.modes.get(this.state.activeMode);
+    var _a;
+    const docState = this.getDocumentState(scope.documentId);
+    if (!docState) return null;
+    const mode = this.modes.get(docState.activeMode);
     if (!mode) return null;
-    const bucket = this.buckets.get(mode.id);
+    const docBuckets = this.buckets.get(scope.documentId);
+    if (!docBuckets) return null;
+    const bucket = docBuckets.get(mode.id);
     if (!bucket) return null;
     const mergeSets = (a, b) => a.size || b.size ? mergeHandlers([...a, ...b]) : null;
     if (scope.type === "global") {
+      const alwaysSet = this.alwaysGlobal.get(scope.documentId) ?? /* @__PURE__ */ new Set();
       const modeSpecific = mode.scope === "global" ? bucket.global : /* @__PURE__ */ new Set();
-      return mergeSets(this.alwaysGlobal, modeSpecific);
+      return mergeSets(alwaysSet, modeSpecific);
     }
-    const alwaysPageSet = this.alwaysPage.get(scope.pageIndex) ?? /* @__PURE__ */ new Set();
+    const alwaysPageSet = ((_a = this.alwaysPage.get(scope.documentId)) == null ? void 0 : _a.get(scope.pageIndex)) ?? /* @__PURE__ */ new Set();
     const modePageSet = mode.scope === "page" ? bucket.page.get(scope.pageIndex) ?? /* @__PURE__ */ new Set() : /* @__PURE__ */ new Set();
     return mergeSets(alwaysPageSet, modePageSet);
   }
-  /** ---------- cursor handling --------------------- */
-  setCursor(token, cursor, priority = 0) {
-    this.cursorClaims.set(token, { cursor, priority });
-    this.emitCursor();
+  // ─────────────────────────────────────────────────────────
+  // Cursor Management
+  // ─────────────────────────────────────────────────────────
+  setCursor(token, cursor, priority = 0, documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    const claims = this.cursorClaims.get(id);
+    if (!claims) return;
+    claims.set(token, { cursor, priority });
+    this.emitCursor(id);
   }
-  removeCursor(token) {
-    this.cursorClaims.delete(token);
-    this.emitCursor();
+  removeCursor(token, documentId) {
+    const id = documentId ?? this.getActiveDocumentId();
+    const claims = this.cursorClaims.get(id);
+    if (!claims) return;
+    claims.delete(token);
+    this.emitCursor(id);
   }
-  emitCursor() {
+  getCurrentCursor(documentId) {
+    return this.getDocumentStateOrThrow(documentId).cursor;
+  }
+  emitCursor(documentId) {
     var _a;
-    const top = [...this.cursorClaims.values()].sort((a, b) => b.priority - a.priority)[0] ?? {
-      cursor: ((_a = this.modes.get(this.state.activeMode)) == null ? void 0 : _a.cursor) ?? "auto"
+    const claims = this.cursorClaims.get(documentId);
+    if (!claims) return;
+    const docState = this.getDocumentState(documentId);
+    if (!docState) return;
+    const top = [...claims.values()].sort((a, b) => b.priority - a.priority)[0] ?? {
+      cursor: ((_a = this.modes.get(docState.activeMode)) == null ? void 0 : _a.cursor) ?? "auto"
     };
-    if (top.cursor !== this.state.cursor) {
-      this.dispatch(setCursor(top.cursor));
-      this.onCursorChange$.emit(top.cursor);
+    if (top.cursor !== docState.cursor) {
+      this.dispatch(setCursor(documentId, top.cursor));
+      this.onCursorChange$.emit({
+        documentId,
+        cursor: top.cursor
+      });
     }
   }
-  onStoreUpdated(_, newState) {
-    this.onStateChange$.emit(newState);
+  // ─────────────────────────────────────────────────────────
+  // Handler Lifecycle Notifications
+  // ─────────────────────────────────────────────────────────
+  notifyHandlersActive(documentId, modeId) {
+    var _a, _b;
+    (_a = this.alwaysGlobal.get(documentId)) == null ? void 0 : _a.forEach((handler) => {
+      var _a2;
+      (_a2 = handler.onHandlerActiveStart) == null ? void 0 : _a2.call(handler, modeId);
+    });
+    (_b = this.alwaysPage.get(documentId)) == null ? void 0 : _b.forEach((handlerSet) => {
+      handlerSet.forEach((handler) => {
+        var _a2;
+        (_a2 = handler.onHandlerActiveStart) == null ? void 0 : _a2.call(handler, modeId);
+      });
+    });
+    const mode = this.modes.get(modeId);
+    if (!mode) return;
+    const docBuckets = this.buckets.get(documentId);
+    if (!docBuckets) return;
+    const bucket = docBuckets.get(modeId);
+    if (!bucket) return;
+    if (mode.scope === "global") {
+      bucket.global.forEach((handler) => {
+        var _a2;
+        (_a2 = handler.onHandlerActiveStart) == null ? void 0 : _a2.call(handler, modeId);
+      });
+    }
+    if (mode.scope === "page") {
+      bucket.page.forEach((handlerSet) => {
+        handlerSet.forEach((handler) => {
+          var _a2;
+          (_a2 = handler.onHandlerActiveStart) == null ? void 0 : _a2.call(handler, modeId);
+        });
+      });
+    }
   }
-  activeModeIsExclusive() {
-    const mode = this.modes.get(this.state.activeMode);
-    return !!(mode == null ? void 0 : mode.exclusive);
+  notifyHandlersInactive(documentId, modeId) {
+    var _a, _b;
+    (_a = this.alwaysGlobal.get(documentId)) == null ? void 0 : _a.forEach((handler) => {
+      var _a2;
+      (_a2 = handler.onHandlerActiveEnd) == null ? void 0 : _a2.call(handler, modeId);
+    });
+    (_b = this.alwaysPage.get(documentId)) == null ? void 0 : _b.forEach((handlerSet) => {
+      handlerSet.forEach((handler) => {
+        var _a2;
+        (_a2 = handler.onHandlerActiveEnd) == null ? void 0 : _a2.call(handler, modeId);
+      });
+    });
+    const mode = this.modes.get(modeId);
+    if (!mode) return;
+    const docBuckets = this.buckets.get(documentId);
+    if (!docBuckets) return;
+    const bucket = docBuckets.get(modeId);
+    if (!bucket) return;
+    if (mode.scope === "global") {
+      bucket.global.forEach((handler) => {
+        var _a2;
+        (_a2 = handler.onHandlerActiveEnd) == null ? void 0 : _a2.call(handler, modeId);
+      });
+    }
+    if (mode.scope === "page") {
+      bucket.page.forEach((handlerSet) => {
+        handlerSet.forEach((handler) => {
+          var _a2;
+          (_a2 = handler.onHandlerActiveEnd) == null ? void 0 : _a2.call(handler, modeId);
+        });
+      });
+    }
+  }
+  // ─────────────────────────────────────────────────────────
+  // Store Update Handlers
+  // ─────────────────────────────────────────────────────────
+  onStoreUpdated(prevState, newState) {
+    for (const documentId in newState.documents) {
+      const prevDoc = prevState.documents[documentId];
+      const newDoc = newState.documents[documentId];
+      if (prevDoc !== newDoc) {
+        this.onStateChange$.emit({
+          documentId,
+          state: newDoc
+        });
+      }
+    }
   }
-  getActiveInteractionMode() {
-    return this.modes.get(this.state.activeMode) ?? null;
+  // ─────────────────────────────────────────────────────────
+  // Lifecycle
+  // ─────────────────────────────────────────────────────────
+  async initialize(_) {
+    this.logger.info(
+      "InteractionManagerPlugin",
+      "Initialize",
+      "Interaction Manager Plugin initialized"
+    );
   }
-  // keep emitter clean
   async destroy() {
     this.onModeChange$.clear();
     this.onCursorChange$.clear();
+    this.onHandlerChange$.clear();
+    this.onStateChange$.clear();
     await super.destroy();
   }
 };
@@ -340,38 +530,119 @@ const manifest = {
     }
   }
 };
-const initialState = {
-  activeMode: "pointerMode",
-  defaultMode: "pointerMode",
+const INITIAL_MODE = "pointerMode";
+const initialDocumentState = {
+  activeMode: INITIAL_MODE,
   cursor: "auto",
-  paused: false,
+  paused: false
+};
+const initialState = {
+  defaultMode: INITIAL_MODE,
   exclusionRules: {
     classes: [],
-    dataAttributes: []
-  }
+    dataAttributes: ["data-no-interaction"]
+  },
+  documents: {},
+  activeDocumentId: null
 };
-const reducer = (state, action) => {
+const reducer = (state = initialState, action) => {
   switch (action.type) {
-    case ACTIVATE_MODE:
+    // ─────────────────────────────────────────────────────────
+    // Document Lifecycle
+    // ─────────────────────────────────────────────────────────
+    case INIT_INTERACTION_STATE: {
+      const { documentId, state: docState } = action.payload;
+      return {
+        ...state,
+        documents: {
+          ...state.documents,
+          [documentId]: docState
+        },
+        // Set as active if no active document
+        activeDocumentId: state.activeDocumentId ?? documentId
+      };
+    }
+    case CLEANUP_INTERACTION_STATE: {
+      const documentId = action.payload;
+      const { [documentId]: removed, ...remainingDocs } = state.documents;
+      return {
+        ...state,
+        documents: remainingDocs,
+        activeDocumentId: state.activeDocumentId === documentId ? null : state.activeDocumentId
+      };
+    }
+    case SET_ACTIVE_DOCUMENT: {
       return {
         ...state,
-        activeMode: action.payload.mode
+        activeDocumentId: action.payload
       };
-    case SET_CURSOR:
+    }
+    // ─────────────────────────────────────────────────────────
+    // Per-Document Actions
+    // ─────────────────────────────────────────────────────────
+    case ACTIVATE_MODE: {
+      const { documentId, mode } = action.payload;
+      const docState = state.documents[documentId];
+      if (!docState) return state;
       return {
         ...state,
-        cursor: action.payload.cursor
+        documents: {
+          ...state.documents,
+          [documentId]: {
+            ...docState,
+            activeMode: mode
+          }
+        }
       };
-    case PAUSE_INTERACTION:
+    }
+    case SET_CURSOR: {
+      const { documentId, cursor } = action.payload;
+      const docState = state.documents[documentId];
+      if (!docState) return state;
       return {
         ...state,
-        paused: true
+        documents: {
+          ...state.documents,
+          [documentId]: {
+            ...docState,
+            cursor
+          }
+        }
       };
-    case RESUME_INTERACTION:
+    }
+    case PAUSE_INTERACTION: {
+      const documentId = action.payload;
+      const docState = state.documents[documentId];
+      if (!docState) return state;
       return {
         ...state,
-        paused: false
+        documents: {
+          ...state.documents,
+          [documentId]: {
+            ...docState,
+            paused: true
+          }
+        }
       };
+    }
+    case RESUME_INTERACTION: {
+      const documentId = action.payload;
+      const docState = state.documents[documentId];
+      if (!docState) return state;
+      return {
+        ...state,
+        documents: {
+          ...state.documents,
+          [documentId]: {
+            ...docState,
+            paused: false
+          }
+        }
+      };
+    }
+    // ─────────────────────────────────────────────────────────
+    // Global Actions
+    // ─────────────────────────────────────────────────────────
     case SET_DEFAULT_MODE:
       return {
         ...state,
@@ -390,7 +661,6 @@ const reducer = (state, action) => {
           classes: [...state.exclusionRules.classes || [], action.payload.className].filter(
             (v, i, a) => a.indexOf(v) === i
           )
-          // Remove duplicates
         }
       };
     case REMOVE_EXCLUSION_CLASS:
@@ -438,6 +708,7 @@ export {
   INTERACTION_MANAGER_PLUGIN_ID,
   InteractionManagerPlugin,
   InteractionManagerPluginPackage,
+  initialDocumentState,
   initialState,
   manifest,
   reducer