@thehammer/template-verification 0.2.5 → 0.2.6

package/dist/lib/hostBridge.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Outbound signal to the embedding consumer (gpt-manager's `TemplatePreview.vue`)
+ * telling it a nested pan/zoom surface — the Evidence tab's `DanxFileViewer` — is
+ * currently visible and wants exclusive ownership of Ctrl/Cmd+drag.
+ *
+ * Why this exists: the consumer's own preview canvas ALSO binds Ctrl/Cmd+drag to
+ * pan the whole rendered document, and it activates that gesture the instant it
+ * sees a relayed Ctrl/Cmd keydown from anywhere inside this iframe (the danxbot
+ * host-bridge relays raw keyboard events regardless of what's focused inside).
+ * Its pan overlay is a transparent `position: absolute; inset: 0` div stacked
+ * ABOVE the iframe in the PARENT's own DOM — once it renders, every subsequent
+ * mouse event over the iframe's whole bounding box (including this dialog's
+ * nested file viewer) is captured by that parent-level div instead of reaching
+ * anything inside the iframe. The nested viewer's own Ctrl+drag-to-pan-the-image
+ * gesture then never receives its mousedown at all. Posting this message lets
+ * the consumer gate its overlay off while a nested viewer wants the gesture,
+ * without either side needing to know the other's internal DOM structure.
+ *
+ * Message type is namespaced under the same `source: "danxbot-template"`
+ * envelope the danxbot host-bridge already uses for keyboard/wheel relays (see
+ * danxbot's `scaffold.ts` → `buildHostBridgeScript`), sent directly via
+ * `window.top.postMessage` — this call runs as ordinary Vue code already
+ * executing inside the iframe, so it needs no relay of its own.
+ */
+export declare function notifyNestedViewerActive(active: boolean): void;