@shenora/react 0.3.0 → 0.4.0

package/dist/bridge.d.ts

@@ -111,7 +111,10 @@ export declare class ShenoraBridge {
      * otherwise is. Nothing is queued and no timer is set, so there is nothing to leak and no deadline.
      *
      * No transport (a plain browser tab) is a silent no-op, matching the fire-and-forget contract —
-     * unlike `invoke`, there is no caller waiting to be told.
+     * unlike `invoke`, there is no caller waiting to be told. **A DISPOSED bridge is the same silent
+     * no-op**, and that one can surprise: `invoke` on a disposed bridge rejects with `NO_TRANSPORT`
+     * while `post` just returns the id, so a stale reference kept across a `configureBridge` swap looks
+     * like it is still sending. `isAvailable` is the check.
      */
     post<TPayload = unknown>(module: string, type: string, options?: PostOptions<TPayload>): string;
     /**

package/dist/bridge.js

@@ -139,7 +139,10 @@ export class ShenoraBridge {
      * otherwise is. Nothing is queued and no timer is set, so there is nothing to leak and no deadline.
      *
      * No transport (a plain browser tab) is a silent no-op, matching the fire-and-forget contract —
-     * unlike `invoke`, there is no caller waiting to be told.
+     * unlike `invoke`, there is no caller waiting to be told. **A DISPOSED bridge is the same silent
+     * no-op**, and that one can surprise: `invoke` on a disposed bridge rejects with `NO_TRANSPORT`
+     * while `post` just returns the id, so a stale reference kept across a `configureBridge` swap looks
+     * like it is still sending. `isAvailable` is the check.
      */
     post(module, type, options = {}) {
         const request = {

package/dist/windowCommands.d.ts

@@ -72,9 +72,13 @@ export declare class WindowCommands extends BaseModuleService<WindowRequests> {
 }
 /**
  * The max/restore-glyph resync pattern from the source app: the authoritative maximize state,
- * re-queried on every window resize (a maximize/restore always resizes the window, and the DOM
- * has no other signal for the manual work-area maximize). Failures (plain browser, no host)
- * leave it false.
+ * re-queried when a resize SETTLES (a maximize/restore always resizes the window, and the DOM has no
+ * other signal for the manual work-area maximize). Failures (plain browser, no host) leave it false.
+ *
+ * Read once immediately, then on the TRAILING edge of a 100 ms debounce — not once per `resize`
+ * event, which a window drag fires ~180 times in three seconds. Coalescing is the correct semantics
+ * here, not just the cheap one: maximize/restore is a single step, so only the end state matters. Do
+ * not build on intermediate values during a drag; there are none.
  */
 export declare function useWindowMaximized(commands?: WindowCommands): boolean;
 export {};

package/dist/windowCommands.js

@@ -60,9 +60,13 @@ export class WindowCommands extends BaseModuleService {
 }
 /**
  * The max/restore-glyph resync pattern from the source app: the authoritative maximize state,
- * re-queried on every window resize (a maximize/restore always resizes the window, and the DOM
- * has no other signal for the manual work-area maximize). Failures (plain browser, no host)
- * leave it false.
+ * re-queried when a resize SETTLES (a maximize/restore always resizes the window, and the DOM has no
+ * other signal for the manual work-area maximize). Failures (plain browser, no host) leave it false.
+ *
+ * Read once immediately, then on the TRAILING edge of a 100 ms debounce — not once per `resize`
+ * event, which a window drag fires ~180 times in three seconds. Coalescing is the correct semantics
+ * here, not just the cheap one: maximize/restore is a single step, so only the end state matters. Do
+ * not build on intermediate values during a drag; there are none.
  */
 export function useWindowMaximized(commands) {
     const [maximized, setMaximized] = useState(false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shenora/react",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "React client for Shenora desktop hosts: correlated invoke/send/subscribe over the WebView2 bridge, typed module services, hooks, and a browser fallback for pure-UI development.",
   "license": "MIT",
   "author": "Jiarong Gu",