@selectwin/kit 0.1.67 → 0.1.69

package/dist/SelectPreviewFrame.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { ReactNode, Ref } from 'react';
 type Device = 'desktop' | 'mobile';
 export interface SelectPreviewFrameProps {
     /** Preview URL. Empty/undefined shows the placeholder. */
@@ -23,6 +23,20 @@ export interface SelectPreviewFrameProps {
      * desatualizada. Então: avisa e oferece o botão — não age.
      */
     notice?: ReactNode;
+    /**
+     * Ref para o `<iframe>` INTERNO — o `ref` do componente aponta para o wrapper, e de um
+     * `<div>` não se alcança `contentWindow`.
+     *
+     * Existe para quem DIRIGE o conteúdo do frame por `postMessage` em vez de recarregá-lo: um
+     * builder que manda o desenho ao vivo precisa da janela do frame, e a alternativa — sair
+     * fazendo `querySelector('iframe')` no wrapper — amarraria a página à árvore interna deste
+     * componente, que é exatamente o que a prop existe para evitar.
+     *
+     * ⚠️ O frame REMONTA a cada recarga (o `key` do nonce), então o ref troca de nó. Quem
+     * dirige não deve guardar `contentWindow`: leia-o do ref na hora de mandar, e refaça o
+     * aperto de mão a cada `load`.
+     */
+    iframeRef?: Ref<HTMLIFrameElement>;
     initialDevice?: Device;
     showDeviceToggle?: boolean;
     emptyLabel?: string;