@pixpilot/chrome-lifecycle 0.9.0 → 0.10.5

package/README.md

@@ -110,7 +110,7 @@ import { getSidePanelStateForWindow } from '@pixpilot/chrome-lifecycle';
 const state = getSidePanelStateForWindow(windowId);
 ```
 
-##### `onSidePanelStateChange(listener)`
+##### `onSidePanelStateChange(listener, options?)`
 
 Listens for side panel state changes across all windows.
 
@@ -134,18 +134,41 @@ unsubscribe();
 | `previousState` | `'visible'` \| `'hidden'` \| `undefined` | State known before this one, `undefined` if new |
 | `reason`        | `string`                                 | What triggered the change                       |
 
+**Options:**
+
+| Property         | Type      | Default | Description                                              |
+| ---------------- | --------- | ------- | -------------------------------------------------------- |
+| `includeRepeats` | `boolean` | `false` | Also deliver reports that repeat the state already known |
+
 **Returns:** Unsubscribe function
 
-This fires for **every** state report, including repeats of a state you already know
-about — the tracker re-reports `visible` when it reconnects to a restarted service
-worker, and can report `hidden` twice in a row (a visibility change followed by a
-port disconnect). If you want transitions rather than reports, use
-`onSidePanelShown` / `onSidePanelHidden` below instead of comparing states yourself.
+This fires when a window's state actually **changes**. The tracker reports the same
+state more than once — it re-reports `visible` when it reconnects to a restarted
+service worker, and a panel can report `hidden` twice in a row (a visibility change,
+then a port disconnect) — and those repeats are filtered out, so listeners don't
+have to track the previous state themselves.
+
+Pass `{ includeRepeats: true }` to observe the raw tracker feed instead. The option
+is per listener, so one listener can watch changes while another watches everything:
+
+```typescript
+onSidePanelStateChange(({ windowId, state }) => syncPanel(windowId, state));
+
+onSidePanelStateChange(
+  ({ reason }) => {
+    // 'visibility-change' hidden means the panel was hidden;
+    // 'port-disconnected' hidden means its document went away.
+    if (reason === 'port-disconnected') dropDocumentCache();
+  },
+  { includeRepeats: true },
+);
+```
 
 ##### `onSidePanelShown(listener)`
 
-Fires only when a side panel _becomes_ visible. This is the event to use for "the
-panel is back on screen, resync it".
+`onSidePanelStateChange` narrowed to one direction, for code that only cares when a
+side panel _becomes_ visible. This is the event to use for "the panel is back on
+screen, resync it".
 
 ```typescript
 import { onSidePanelShown } from '@pixpilot/chrome-lifecycle';
@@ -169,9 +192,10 @@ It covers three cases, distinguishable via `reason`:
 
 ##### `onSidePanelHidden(listener)`
 
-Fires only when a side panel stops being visible. Nothing fires for a window that
-was never seen visible, so a service worker restart followed by a port disconnect
-stays quiet instead of reporting a close the listener never saw open.
+The same narrowing for the other direction: fires only when a side panel stops being
+visible. Nothing fires for a window that was never seen visible, so a service worker
+restart followed by a port disconnect stays quiet instead of reporting a close the
+listener never saw open.
 
 **Callback data:** same as `onSidePanelStateChange`
 
@@ -186,8 +210,8 @@ including anything stale it was showing before the switch.
 
 That surfaces here as `visibility-change`, never `document-load`. A listener that
 only refreshes on `document-load` will look correct until a user has two side panel
-extensions installed, and then silently serve stale content. `onSidePanelShown`
-handles both.
+extensions installed, and then silently serve stale content. `onSidePanelShown` — or
+`onSidePanelStateChange` checking for `state === 'visible'` — covers both.
 
 There is no Chrome API to ask whether your panel is the one currently on screen, so
 `document.hidden` in the panel document is the only available signal. Leave

package/dist/index.cjs

@@ -1 +1 @@
-const e=new Map;let t=!1;function n(){t||(t=!0,chrome.windows.onRemoved.addListener(t=>{let n=e.get(t);n&&(n.forEach(e=>{e()}),e.delete(t))}))}function r(t,r){n();let i=e.get(t);return i||(i=new Set,e.set(t,i)),i.add(r),()=>{let n=e.get(t);n&&(n.delete(r),n.size===0&&e.delete(t))}}const i=250,a=5e3,o=2;let s=!1;function c(e={}){if(s)return console.info(`Side panel state tracker already initialized`),()=>{};s=!0;let{trackDocumentVisibility:t=!0}=e,n,r,i=0,a,o=!1;function c(){r&&=(clearTimeout(r),void 0)}return chrome.windows.getCurrent(e=>{if(o)return;if(e.id==null){console.error(`[side-panel-state-tracker] Could not get window ID`);return}let s=e.id;function l(){return t&&document.hidden?`hidden`:`visible`}function u(){if(o||r)return;n=void 0,console.info(`[side-panel-state-tracker] Connection to background lost, scheduling reconnect...`);let e=Math.min(250*2**i,5e3);i+=1,r=setTimeout(()=>{r=void 0,f(`reconnected`)},e)}function d(e){let t=n;if(!t){u();return}try{t.postMessage({...e,windowId:s,type:`side-panel-state-tracker`,timestamp:Date.now()})}catch(e){console.error(`[side-panel-state-tracker] Failed to send message:`,e),u()}}function f(e){if(!o){c();try{let t=chrome.runtime.connect({name:chrome.runtime.id});n=t,i=0,t.onDisconnect.addListener(()=>{n===t&&(console.info(`[side-panel-state-tracker] Background connection lost.`),u())}),t.onMessage.addListener(e=>{e.type===`close-side-panel`&&(o=!0,c(),window.close())}),d({state:e===`document-load`?`visible`:l(),reason:e})}catch(e){console.error(`[side-panel-state-tracker] Failed to connect:`,e),u()}}}t&&(a=()=>{d({state:l(),reason:`visibility-change`})},document.addEventListener(`visibilitychange`,a)),f(`document-load`)}),()=>{o=!0,c(),a&&document.removeEventListener(`visibilitychange`,a);let e=n;n=void 0,e?.disconnect(),s=!1}}const l=new Map,u=new Map,d=new Set;let f=!1;function p(){f||(f=!0,chrome.action.onClicked.addListener(e=>{let t=l.get(e.windowId);t&&t.state===`visible`?t.port&&(l.delete(e.windowId),t.port.postMessage({type:`close-side-panel`})):chrome.sidePanel.open({windowId:e.windowId}).catch(console.error)}),chrome.runtime.onConnect.addListener(e=>{e.name===chrome.runtime.id&&(e.onMessage.addListener(t=>{t.type===`side-panel-state-tracker`&&t.state&&g({port:e,state:t.state,reason:t.reason??`unknown`,windowId:t.windowId,type:t.type})}),e.onDisconnect.addListener(e=>{Array.from(l.entries()).forEach(([t,n])=>{n.port&&n.port===e&&g({port:void 0,state:`hidden`,reason:`port-disconnected`,windowId:t,type:`side-panel-state-tracker`})})}))}),chrome.windows.onRemoved.addListener(e=>{l.delete(e),u.delete(e)}))}function m(){f||=(p(),!0)}function h(e,t){if(e.type!==`side-panel-state-tracker`)return;let n={state:e.state,reason:e.reason,windowId:e.windowId,previousState:t};d.forEach(e=>{try{e(n)}catch(e){console.error(`Error in side panel state listener:`,e)}})}function g(e){let{windowId:t,state:n}=e,r=u.get(t);if(e.type===`side-panel-state-tracker`&&u.set(t,n),n===`hidden`){l.delete(t),h(e,r);return}l.set(t,e),h(e,r)}function _(e){return m(),l.get(e)?.state}function v(e){return m(),_(e)===`visible`}function y(e){return m(),d.add(e),()=>{d.delete(e)}}function b(e){return y(t=>{t.state===`visible`&&t.previousState!==`visible`&&e(t)})}function x(e){return y(t=>{t.state===`hidden`&&t.previousState===`visible`&&e(t)})}exports.getSidePanelStateForWindow=_,exports.initSidePanelStateManager=p,exports.initializeSidePanelStateTracker=c,exports.isWindowSidePanelVisible=v,exports.onSidePanelHidden=x,exports.onSidePanelShown=b,exports.onSidePanelStateChange=y,exports.onWindowClose=r;
+const e=new Map;let t=!1;function n(){t||(t=!0,chrome.windows.onRemoved.addListener(t=>{let n=e.get(t);n&&(n.forEach(e=>{e()}),e.delete(t))}))}function r(t,r){n();let i=e.get(t);return i||(i=new Set,e.set(t,i)),i.add(r),()=>{let n=e.get(t);n&&(n.delete(r),n.size===0&&e.delete(t))}}const i=250,a=5e3,o=2;let s=!1;function c(e={}){if(s)return console.info(`Side panel state tracker already initialized`),()=>{};s=!0;let{trackDocumentVisibility:t=!0}=e,n,r,i=0,a,o=!1;function c(){r&&=(clearTimeout(r),void 0)}return chrome.windows.getCurrent(e=>{if(o)return;if(e.id==null){console.error(`[side-panel-state-tracker] Could not get window ID`);return}let s=e.id;function l(){return t&&document.hidden?`hidden`:`visible`}function u(){if(o||r)return;n=void 0,console.info(`[side-panel-state-tracker] Connection to background lost, scheduling reconnect...`);let e=Math.min(250*2**i,5e3);i+=1,r=setTimeout(()=>{r=void 0,f(`reconnected`)},e)}function d(e){let t=n;if(!t){u();return}try{t.postMessage({...e,windowId:s,type:`side-panel-state-tracker`,timestamp:Date.now()})}catch(e){console.error(`[side-panel-state-tracker] Failed to send message:`,e),u()}}function f(e){if(!o){c();try{let t=chrome.runtime.connect({name:chrome.runtime.id});n=t,i=0,t.onDisconnect.addListener(()=>{n===t&&(console.info(`[side-panel-state-tracker] Background connection lost.`),u())}),t.onMessage.addListener(e=>{e.type===`close-side-panel`&&(o=!0,c(),window.close())}),d({state:e===`document-load`?`visible`:l(),reason:e})}catch(e){console.error(`[side-panel-state-tracker] Failed to connect:`,e),u()}}}t&&(a=()=>{d({state:l(),reason:`visibility-change`})},document.addEventListener(`visibilitychange`,a)),f(`document-load`)}),()=>{o=!0,c(),a&&document.removeEventListener(`visibilitychange`,a);let e=n;n=void 0,e?.disconnect(),s=!1}}const l=new Map,u=new Map,d=new Set;let f=!1;function p(){f||(f=!0,chrome.action.onClicked.addListener(e=>{let t=l.get(e.windowId);t&&t.state===`visible`?t.port&&(l.delete(e.windowId),t.port.postMessage({type:`close-side-panel`})):chrome.sidePanel.open({windowId:e.windowId}).catch(console.error)}),chrome.runtime.onConnect.addListener(e=>{e.name===chrome.runtime.id&&(e.onMessage.addListener(t=>{t.type===`side-panel-state-tracker`&&t.state&&g({port:e,state:t.state,reason:t.reason??`unknown`,windowId:t.windowId,type:t.type})}),e.onDisconnect.addListener(e=>{Array.from(l.entries()).forEach(([t,n])=>{n.port&&n.port===e&&g({port:void 0,state:`hidden`,reason:`port-disconnected`,windowId:t,type:`side-panel-state-tracker`})})}))}),chrome.windows.onRemoved.addListener(e=>{l.delete(e),u.delete(e)}))}function m(){f||=(p(),!0)}function h(e,t){if(e.type!==`side-panel-state-tracker`)return;let n={state:e.state,reason:e.reason,windowId:e.windowId,previousState:t},r=e.state===t;d.forEach(({listener:e,includeRepeats:t})=>{if(!(r&&!t))try{e(n)}catch(e){console.error(`Error in side panel state listener:`,e)}})}function g(e){let{windowId:t,state:n}=e,r=u.get(t);if(e.type===`side-panel-state-tracker`&&u.set(t,n),n===`hidden`){l.delete(t),h(e,r);return}l.set(t,e),h(e,r)}function _(e){return m(),l.get(e)?.state}function v(e){return m(),_(e)===`visible`}function y(e,t={}){m();let n={listener:e,includeRepeats:t.includeRepeats===!0};return d.add(n),()=>{d.delete(n)}}function b(e){return y(t=>{t.reason!==`reconnected`&&t.state===`visible`&&t.previousState!==`visible`&&e(t)})}function x(e){return y(t=>{t.reason!==`reconnected`&&t.state===`hidden`&&t.previousState===`visible`&&e(t)})}exports.getSidePanelStateForWindow=_,exports.initSidePanelStateManager=p,exports.initializeSidePanelStateTracker=c,exports.isWindowSidePanelVisible=v,exports.onSidePanelHidden=x,exports.onSidePanelShown=b,exports.onSidePanelStateChange=y,exports.onWindowClose=r;

package/dist/index.d.cts

@@ -60,6 +60,20 @@ interface SidePanelClientMessage {
 //#endregion
 //#region src/sidepanel-state-manager.d.ts
 type SidePanelStateListener = (data: SidePanelStateChangeData) => void;
+interface SidePanelStateChangeOptions {
+  /**
+   * Also deliver reports that repeat a state already known for that window — a
+   * reconnect while still visible, or a `port-disconnected` after the panel
+   * already reported itself hidden.
+   *
+   * Off by default, so listeners see state *changes*. Turn it on to observe the
+   * raw tracker feed, e.g. to tell "the document died" apart from "the document
+   * was hidden" when both arrive as `hidden`.
+   *
+   * @default false
+   */
+  includeRepeats?: boolean;
+}
 /**
  * Initializes the side panel state manager.
  * Sets up Chrome event listeners for action clicks and runtime connections.
@@ -71,38 +85,53 @@ declare function getSidePanelStateForWindow(windowId: number): SidePanelState |
 declare function isWindowSidePanelVisible(windowId: number): boolean;
 /**
  * Adds a listener for side panel state changes.
- * The listener will be called whenever the side panel state changes (visible/hidden).
+ *
+ * The listener is called when a window's side panel state actually changes. The
+ * tracker reports the same state more than once — it re-reports `visible` when it
+ * reconnects to a restarted service worker, and a panel can report `hidden` twice
+ * (a visibility change, then a port disconnect) — and those repeats are filtered
+ * out unless {@link SidePanelStateChangeOptions.includeRepeats} is set.
+ *
  * Note: Heartbeat messages do not trigger listeners, and timestamp is excluded from the data.
  *
  * @param listener - Callback function that receives state change data
+ * @param options - Delivery options
  * @returns Unsubscribe function to remove the listener
  */
-declare function onSidePanelStateChange(listener: SidePanelStateListener): () => void;
+declare function onSidePanelStateChange(listener: SidePanelStateListener, options?: SidePanelStateChangeOptions): () => void;
 /**
- * Adds a listener that fires only when a side panel *becomes* visible, skipping
- * repeats of a state you already knew about.
+ * Adds a listener that fires only when a side panel *becomes* visible.
+ *
+ * A narrowed {@link onSidePanelStateChange} for code that only cares about one
+ * direction. This is the event to use for "the panel is back on screen, resync
+ * it". It covers a freshly loaded document (`reason: 'document-load'`) and a panel
+ * Chrome had cached while another extension's side panel took over the slot
+ * (`reason: 'visibility-change'`).
  *
- * This is the event to use for "the panel is back on screen, resync it". It covers
- * a freshly loaded document (`reason: 'document-load'`), a panel Chrome had cached
- * while another extension's side panel took over the slot
- * (`reason: 'visibility-change'`), and the first report after a service worker
- * restart (`reason: 'reconnected'`).
+ * Reconnects (`reason: 'reconnected'`) are not shows and never fire this. The
+ * tracker reconnects when the service worker is torn down and restarted, and the
+ * panel document lives through that untouched — nothing appeared, so nothing needs
+ * resyncing. It has to be excluded explicitly because a restarted worker has no
+ * record of the window, leaving `previousState` empty, which would otherwise make
+ * every recycle look like a fresh show.
  *
  * @param listener - Callback function that receives state change data
  * @returns Unsubscribe function to remove the listener
  */
 declare function onSidePanelShown(listener: SidePanelStateListener): () => void;
 /**
- * Adds a listener that fires only when a side panel *stops* being visible, skipping
- * repeats of a state you already knew about.
+ * Adds a listener that fires only when a side panel *stops* being visible.
  *
- * Nothing fires for a window that was never seen visible, so a service worker
+ * A narrowed {@link onSidePanelStateChange} for code that only cares about one
+ * direction. Nothing fires for a window that was never seen visible, so a service worker
  * restart followed by a port disconnect stays quiet instead of reporting a close
- * that the listener never saw open.
+ * that the listener never saw open. Reconnects are excluded for the same reason
+ * they are in {@link onSidePanelShown}: they report the state the panel is already
+ * in, not a move into it.
  *
  * @param listener - Callback function that receives state change data
  * @returns Unsubscribe function to remove the listener
  */
 declare function onSidePanelHidden(listener: SidePanelStateListener): () => void;
 //#endregion
-export { InitializeSidePanelStateTrackerOptions, SidePanelClientMessage, SidePanelState, SidePanelStateChangeData, SidePanelStateData, SidePanelStateListener, getSidePanelStateForWindow, initSidePanelStateManager, initializeSidePanelStateTracker, isWindowSidePanelVisible, onSidePanelHidden, onSidePanelShown, onSidePanelStateChange, onWindowClose };
+export { InitializeSidePanelStateTrackerOptions, SidePanelClientMessage, SidePanelState, SidePanelStateChangeData, SidePanelStateChangeOptions, SidePanelStateData, SidePanelStateListener, getSidePanelStateForWindow, initSidePanelStateManager, initializeSidePanelStateTracker, isWindowSidePanelVisible, onSidePanelHidden, onSidePanelShown, onSidePanelStateChange, onWindowClose };

package/dist/index.d.ts

@@ -60,6 +60,20 @@ interface SidePanelClientMessage {
 //#endregion
 //#region src/sidepanel-state-manager.d.ts
 type SidePanelStateListener = (data: SidePanelStateChangeData) => void;
+interface SidePanelStateChangeOptions {
+  /**
+   * Also deliver reports that repeat a state already known for that window — a
+   * reconnect while still visible, or a `port-disconnected` after the panel
+   * already reported itself hidden.
+   *
+   * Off by default, so listeners see state *changes*. Turn it on to observe the
+   * raw tracker feed, e.g. to tell "the document died" apart from "the document
+   * was hidden" when both arrive as `hidden`.
+   *
+   * @default false
+   */
+  includeRepeats?: boolean;
+}
 /**
  * Initializes the side panel state manager.
  * Sets up Chrome event listeners for action clicks and runtime connections.
@@ -71,38 +85,53 @@ declare function getSidePanelStateForWindow(windowId: number): SidePanelState |
 declare function isWindowSidePanelVisible(windowId: number): boolean;
 /**
  * Adds a listener for side panel state changes.
- * The listener will be called whenever the side panel state changes (visible/hidden).
+ *
+ * The listener is called when a window's side panel state actually changes. The
+ * tracker reports the same state more than once — it re-reports `visible` when it
+ * reconnects to a restarted service worker, and a panel can report `hidden` twice
+ * (a visibility change, then a port disconnect) — and those repeats are filtered
+ * out unless {@link SidePanelStateChangeOptions.includeRepeats} is set.
+ *
  * Note: Heartbeat messages do not trigger listeners, and timestamp is excluded from the data.
  *
  * @param listener - Callback function that receives state change data
+ * @param options - Delivery options
  * @returns Unsubscribe function to remove the listener
  */
-declare function onSidePanelStateChange(listener: SidePanelStateListener): () => void;
+declare function onSidePanelStateChange(listener: SidePanelStateListener, options?: SidePanelStateChangeOptions): () => void;
 /**
- * Adds a listener that fires only when a side panel *becomes* visible, skipping
- * repeats of a state you already knew about.
+ * Adds a listener that fires only when a side panel *becomes* visible.
+ *
+ * A narrowed {@link onSidePanelStateChange} for code that only cares about one
+ * direction. This is the event to use for "the panel is back on screen, resync
+ * it". It covers a freshly loaded document (`reason: 'document-load'`) and a panel
+ * Chrome had cached while another extension's side panel took over the slot
+ * (`reason: 'visibility-change'`).
  *
- * This is the event to use for "the panel is back on screen, resync it". It covers
- * a freshly loaded document (`reason: 'document-load'`), a panel Chrome had cached
- * while another extension's side panel took over the slot
- * (`reason: 'visibility-change'`), and the first report after a service worker
- * restart (`reason: 'reconnected'`).
+ * Reconnects (`reason: 'reconnected'`) are not shows and never fire this. The
+ * tracker reconnects when the service worker is torn down and restarted, and the
+ * panel document lives through that untouched — nothing appeared, so nothing needs
+ * resyncing. It has to be excluded explicitly because a restarted worker has no
+ * record of the window, leaving `previousState` empty, which would otherwise make
+ * every recycle look like a fresh show.
  *
  * @param listener - Callback function that receives state change data
  * @returns Unsubscribe function to remove the listener
  */
 declare function onSidePanelShown(listener: SidePanelStateListener): () => void;
 /**
- * Adds a listener that fires only when a side panel *stops* being visible, skipping
- * repeats of a state you already knew about.
+ * Adds a listener that fires only when a side panel *stops* being visible.
  *
- * Nothing fires for a window that was never seen visible, so a service worker
+ * A narrowed {@link onSidePanelStateChange} for code that only cares about one
+ * direction. Nothing fires for a window that was never seen visible, so a service worker
  * restart followed by a port disconnect stays quiet instead of reporting a close
- * that the listener never saw open.
+ * that the listener never saw open. Reconnects are excluded for the same reason
+ * they are in {@link onSidePanelShown}: they report the state the panel is already
+ * in, not a move into it.
  *
  * @param listener - Callback function that receives state change data
  * @returns Unsubscribe function to remove the listener
  */
 declare function onSidePanelHidden(listener: SidePanelStateListener): () => void;
 //#endregion
-export { InitializeSidePanelStateTrackerOptions, SidePanelClientMessage, SidePanelState, SidePanelStateChangeData, SidePanelStateData, SidePanelStateListener, getSidePanelStateForWindow, initSidePanelStateManager, initializeSidePanelStateTracker, isWindowSidePanelVisible, onSidePanelHidden, onSidePanelShown, onSidePanelStateChange, onWindowClose };
+export { InitializeSidePanelStateTrackerOptions, SidePanelClientMessage, SidePanelState, SidePanelStateChangeData, SidePanelStateChangeOptions, SidePanelStateData, SidePanelStateListener, getSidePanelStateForWindow, initSidePanelStateManager, initializeSidePanelStateTracker, isWindowSidePanelVisible, onSidePanelHidden, onSidePanelShown, onSidePanelStateChange, onWindowClose };

package/dist/index.js

@@ -1 +1 @@
-const e=new Map;let t=!1;function n(){t||(t=!0,chrome.windows.onRemoved.addListener(t=>{let n=e.get(t);n&&(n.forEach(e=>{e()}),e.delete(t))}))}function r(t,r){n();let i=e.get(t);return i||(i=new Set,e.set(t,i)),i.add(r),()=>{let n=e.get(t);n&&(n.delete(r),n.size===0&&e.delete(t))}}let i=!1;function a(e={}){if(i)return console.info(`Side panel state tracker already initialized`),()=>{};i=!0;let{trackDocumentVisibility:t=!0}=e,n,r,a=0,o,s=!1;function c(){r&&=(clearTimeout(r),void 0)}return chrome.windows.getCurrent(e=>{if(s)return;if(e.id==null){console.error(`[side-panel-state-tracker] Could not get window ID`);return}let i=e.id;function l(){return t&&document.hidden?`hidden`:`visible`}function u(){if(s||r)return;n=void 0,console.info(`[side-panel-state-tracker] Connection to background lost, scheduling reconnect...`);let e=Math.min(250*2**a,5e3);a+=1,r=setTimeout(()=>{r=void 0,f(`reconnected`)},e)}function d(e){let t=n;if(!t){u();return}try{t.postMessage({...e,windowId:i,type:`side-panel-state-tracker`,timestamp:Date.now()})}catch(e){console.error(`[side-panel-state-tracker] Failed to send message:`,e),u()}}function f(e){if(!s){c();try{let t=chrome.runtime.connect({name:chrome.runtime.id});n=t,a=0,t.onDisconnect.addListener(()=>{n===t&&(console.info(`[side-panel-state-tracker] Background connection lost.`),u())}),t.onMessage.addListener(e=>{e.type===`close-side-panel`&&(s=!0,c(),window.close())}),d({state:e===`document-load`?`visible`:l(),reason:e})}catch(e){console.error(`[side-panel-state-tracker] Failed to connect:`,e),u()}}}t&&(o=()=>{d({state:l(),reason:`visibility-change`})},document.addEventListener(`visibilitychange`,o)),f(`document-load`)}),()=>{s=!0,c(),o&&document.removeEventListener(`visibilitychange`,o);let e=n;n=void 0,e?.disconnect(),i=!1}}const o=new Map,s=new Map,c=new Set;let l=!1;function u(){l||(l=!0,chrome.action.onClicked.addListener(e=>{let t=o.get(e.windowId);t&&t.state===`visible`?t.port&&(o.delete(e.windowId),t.port.postMessage({type:`close-side-panel`})):chrome.sidePanel.open({windowId:e.windowId}).catch(console.error)}),chrome.runtime.onConnect.addListener(e=>{e.name===chrome.runtime.id&&(e.onMessage.addListener(t=>{t.type===`side-panel-state-tracker`&&t.state&&p({port:e,state:t.state,reason:t.reason??`unknown`,windowId:t.windowId,type:t.type})}),e.onDisconnect.addListener(e=>{Array.from(o.entries()).forEach(([t,n])=>{n.port&&n.port===e&&p({port:void 0,state:`hidden`,reason:`port-disconnected`,windowId:t,type:`side-panel-state-tracker`})})}))}),chrome.windows.onRemoved.addListener(e=>{o.delete(e),s.delete(e)}))}function d(){l||=(u(),!0)}function f(e,t){if(e.type!==`side-panel-state-tracker`)return;let n={state:e.state,reason:e.reason,windowId:e.windowId,previousState:t};c.forEach(e=>{try{e(n)}catch(e){console.error(`Error in side panel state listener:`,e)}})}function p(e){let{windowId:t,state:n}=e,r=s.get(t);if(e.type===`side-panel-state-tracker`&&s.set(t,n),n===`hidden`){o.delete(t),f(e,r);return}o.set(t,e),f(e,r)}function m(e){return d(),o.get(e)?.state}function h(e){return d(),m(e)===`visible`}function g(e){return d(),c.add(e),()=>{c.delete(e)}}function _(e){return g(t=>{t.state===`visible`&&t.previousState!==`visible`&&e(t)})}function v(e){return g(t=>{t.state===`hidden`&&t.previousState===`visible`&&e(t)})}export{m as getSidePanelStateForWindow,u as initSidePanelStateManager,a as initializeSidePanelStateTracker,h as isWindowSidePanelVisible,v as onSidePanelHidden,_ as onSidePanelShown,g as onSidePanelStateChange,r as onWindowClose};
+const e=new Map;let t=!1;function n(){t||(t=!0,chrome.windows.onRemoved.addListener(t=>{let n=e.get(t);n&&(n.forEach(e=>{e()}),e.delete(t))}))}function r(t,r){n();let i=e.get(t);return i||(i=new Set,e.set(t,i)),i.add(r),()=>{let n=e.get(t);n&&(n.delete(r),n.size===0&&e.delete(t))}}let i=!1;function a(e={}){if(i)return console.info(`Side panel state tracker already initialized`),()=>{};i=!0;let{trackDocumentVisibility:t=!0}=e,n,r,a=0,o,s=!1;function c(){r&&=(clearTimeout(r),void 0)}return chrome.windows.getCurrent(e=>{if(s)return;if(e.id==null){console.error(`[side-panel-state-tracker] Could not get window ID`);return}let i=e.id;function l(){return t&&document.hidden?`hidden`:`visible`}function u(){if(s||r)return;n=void 0,console.info(`[side-panel-state-tracker] Connection to background lost, scheduling reconnect...`);let e=Math.min(250*2**a,5e3);a+=1,r=setTimeout(()=>{r=void 0,f(`reconnected`)},e)}function d(e){let t=n;if(!t){u();return}try{t.postMessage({...e,windowId:i,type:`side-panel-state-tracker`,timestamp:Date.now()})}catch(e){console.error(`[side-panel-state-tracker] Failed to send message:`,e),u()}}function f(e){if(!s){c();try{let t=chrome.runtime.connect({name:chrome.runtime.id});n=t,a=0,t.onDisconnect.addListener(()=>{n===t&&(console.info(`[side-panel-state-tracker] Background connection lost.`),u())}),t.onMessage.addListener(e=>{e.type===`close-side-panel`&&(s=!0,c(),window.close())}),d({state:e===`document-load`?`visible`:l(),reason:e})}catch(e){console.error(`[side-panel-state-tracker] Failed to connect:`,e),u()}}}t&&(o=()=>{d({state:l(),reason:`visibility-change`})},document.addEventListener(`visibilitychange`,o)),f(`document-load`)}),()=>{s=!0,c(),o&&document.removeEventListener(`visibilitychange`,o);let e=n;n=void 0,e?.disconnect(),i=!1}}const o=new Map,s=new Map,c=new Set;let l=!1;function u(){l||(l=!0,chrome.action.onClicked.addListener(e=>{let t=o.get(e.windowId);t&&t.state===`visible`?t.port&&(o.delete(e.windowId),t.port.postMessage({type:`close-side-panel`})):chrome.sidePanel.open({windowId:e.windowId}).catch(console.error)}),chrome.runtime.onConnect.addListener(e=>{e.name===chrome.runtime.id&&(e.onMessage.addListener(t=>{t.type===`side-panel-state-tracker`&&t.state&&p({port:e,state:t.state,reason:t.reason??`unknown`,windowId:t.windowId,type:t.type})}),e.onDisconnect.addListener(e=>{Array.from(o.entries()).forEach(([t,n])=>{n.port&&n.port===e&&p({port:void 0,state:`hidden`,reason:`port-disconnected`,windowId:t,type:`side-panel-state-tracker`})})}))}),chrome.windows.onRemoved.addListener(e=>{o.delete(e),s.delete(e)}))}function d(){l||=(u(),!0)}function f(e,t){if(e.type!==`side-panel-state-tracker`)return;let n={state:e.state,reason:e.reason,windowId:e.windowId,previousState:t},r=e.state===t;c.forEach(({listener:e,includeRepeats:t})=>{if(!(r&&!t))try{e(n)}catch(e){console.error(`Error in side panel state listener:`,e)}})}function p(e){let{windowId:t,state:n}=e,r=s.get(t);if(e.type===`side-panel-state-tracker`&&s.set(t,n),n===`hidden`){o.delete(t),f(e,r);return}o.set(t,e),f(e,r)}function m(e){return d(),o.get(e)?.state}function h(e){return d(),m(e)===`visible`}function g(e,t={}){d();let n={listener:e,includeRepeats:t.includeRepeats===!0};return c.add(n),()=>{c.delete(n)}}function _(e){return g(t=>{t.reason!==`reconnected`&&t.state===`visible`&&t.previousState!==`visible`&&e(t)})}function v(e){return g(t=>{t.reason!==`reconnected`&&t.state===`hidden`&&t.previousState===`visible`&&e(t)})}export{m as getSidePanelStateForWindow,u as initSidePanelStateManager,a as initializeSidePanelStateTracker,h as isWindowSidePanelVisible,v as onSidePanelHidden,_ as onSidePanelShown,g as onSidePanelStateChange,r as onWindowClose};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pixpilot/chrome-lifecycle",
   "type": "module",
-  "version": "0.9.0",
+  "version": "0.10.5",
   "description": "Lifecycle management utilities for Chrome extensions.",
   "author": "m.doaie <m.doaie@hotmail.com>",
   "license": "MIT",
@@ -30,10 +30,10 @@
     "tsdown": "^0.15.9",
     "typescript": "^5.9.3",
     "@internal/eslint-config": "0.3.0",
-    "@internal/tsconfig": "0.1.0",
     "@internal/prettier-config": "0.1.0",
-    "@internal/vitest-config": "0.1.0",
-    "@internal/tsdown-config": "0.1.0"
+    "@internal/tsconfig": "0.1.0",
+    "@internal/tsdown-config": "0.1.0",
+    "@internal/vitest-config": "0.1.0"
   },
   "prettier": "@internal/prettier-config",
   "scripts": {