vitral 0.1.0 → 0.2.0

package/dist/chunk-SFL6LTP3.js

@@ -0,0 +1,56 @@
+import {
+  addLink
+} from "./chunk-PX7PBCCT.js";
+import {
+  protocol
+} from "./chunk-GNPFWISJ.js";
+
+// src/core/css.ts
+var loadedCss = /* @__PURE__ */ new WeakMap();
+var cssText = /* @__PURE__ */ new Map();
+var noop = () => {
+};
+var adopts = () => typeof CSSStyleSheet !== "undefined" && "replaceSync" in CSSStyleSheet.prototype;
+function fetchCssText(href, integrity, priority) {
+  let p = cssText.get(href);
+  if (!p) {
+    p = fetch(href, { credentials: "omit", integrity, priority }).then((r) => r.ok ? r.text() : "").catch(() => "");
+    cssText.set(href, p);
+  }
+  return p;
+}
+function prefetchCss(urls, shadow, sri = {}, priority = "auto") {
+  for (const href of urls) {
+    if (shadow && adopts()) void fetchCssText(href, sri[href], priority);
+    else if (!document.querySelector(`link[href="${href}"]`)) addLink("preload", href, { as: "style", integrity: sri[href] ?? "", fetchPriority: priority });
+  }
+}
+function injectStyles(urls, root, el, styles, sri = {}) {
+  return root ? import("./shadow-MYRJQLLY.js").then((m) => m.attachStyles(root, el, urls, protocol().settings().styles, styles, sri)) : injectCss(urls, null, sri).then(() => noop);
+}
+function injectCss(urls, root, sri = {}) {
+  const owner = root ?? document;
+  let seen = loadedCss.get(owner);
+  if (!seen) loadedCss.set(owner, seen = /* @__PURE__ */ new Map());
+  const parent = root ?? document.head;
+  return Promise.all(
+    urls.map((href) => {
+      let p = seen.get(href);
+      if (!p) {
+        p = new Promise((resolve) => {
+          const link = addLink("stylesheet", href, { integrity: sri[href] ?? "" }, parent);
+          link.onload = link.onerror = () => resolve();
+        });
+        seen.set(href, p);
+      }
+      return p;
+    })
+  );
+}
+
+export {
+  fetchCssText,
+  prefetchCss,
+  injectStyles,
+  injectCss
+};

package/dist/chunk-UTYAX6MU.js

@@ -0,0 +1,152 @@
+import {
+  createSlot
+} from "./chunk-NCONW6WS.js";
+import {
+  preload,
+  registerSrc
+} from "./chunk-2XF5BKV3.js";
+
+// src/core/host-slot.ts
+var noop = () => {
+};
+function timings(name) {
+  const out = {};
+  if (typeof performance === "undefined" || !performance.getEntriesByName) return out;
+  for (const stage of ["manifest", "js", "css", "mount"]) {
+    const m = performance.getEntriesByName(`vitral:${name}:${stage}`, "measure").pop();
+    if (m) out[stage] = Math.round(m.duration * 10) / 10;
+  }
+  return out;
+}
+function when(el, mode, fn) {
+  if (mode === "lazy" || mode === "visible") {
+    if (typeof IntersectionObserver === "undefined") return fn(), noop;
+    const io = new IntersectionObserver(
+      (entries) => {
+        if (entries.some((e) => e.isIntersecting)) io.disconnect(), fn();
+      },
+      { rootMargin: "200px" }
+    );
+    io.observe(el);
+    return () => io.disconnect();
+  }
+  if (mode === "idle") {
+    if (typeof requestIdleCallback === "undefined") {
+      const t = setTimeout(fn, 1);
+      return () => clearTimeout(t);
+    }
+    const id = requestIdleCallback(fn, { timeout: 2e3 });
+    return () => cancelIdleCallback(id);
+  }
+  if (mode === "hover") {
+    const go = () => (off(), fn());
+    const off = () => {
+      el.removeEventListener("pointerenter", go);
+      el.removeEventListener("focusin", go);
+    };
+    el.addEventListener("pointerenter", go);
+    el.addEventListener("focusin", go);
+    return off;
+  }
+  fn();
+  return noop;
+}
+var kept = /* @__PURE__ */ new Map();
+var shelf = null;
+function move(parent, node) {
+  try {
+    ;
+    parent.moveBefore(node, null);
+  } catch {
+    parent.appendChild(node);
+  }
+}
+function signal(node, type) {
+  for (const el of node.querySelectorAll("*")) {
+    if (el.hasAttribute("data-vitral-root")) el.dispatchEvent(new Event(type));
+    if (el.shadowRoot) signal(el.shadowRoot, type);
+  }
+}
+function park(key, item, max) {
+  kept.get(key)?.slot.destroy();
+  kept.delete(key);
+  if (!shelf?.isConnected) {
+    shelf = document.createElement("div");
+    shelf.hidden = true;
+    shelf.setAttribute("data-vitral-keep-alive", "");
+    document.body.appendChild(shelf);
+  }
+  move(shelf, item.box);
+  signal(item.box, "vitral:deactivate");
+  kept.set(key, item);
+  for (const [k, old] of kept) {
+    if (kept.size <= max) break;
+    kept.delete(k);
+    old.slot.destroy();
+    old.box.remove();
+  }
+}
+function hostSlot(target, options) {
+  let { props = {}, keepAlive } = options;
+  const key = (o) => o.src ? registerSrc(o.src, o.name) : o.name ?? "";
+  let name = key(options);
+  let status = "loading";
+  let item = null;
+  const onStatus = (s, e) => {
+    status = s;
+    options.onStatus?.(s, e);
+  };
+  const cancelPrefetch = options.prefetch ? when(target, options.prefetch, () => preload(name)) : noop;
+  const cancel = when(target, options.loading, () => {
+    cancelPrefetch();
+    const found = keepAlive ? kept.get(name) : void 0;
+    if (found) {
+      kept.delete(name);
+      item = found;
+      item.on = onStatus;
+      move(target, item.box);
+      item.slot.update(props);
+      signal(item.box, "vitral:activate");
+      onStatus(item.slot.status, null);
+      return;
+    }
+    let box = target;
+    if (keepAlive) {
+      box = target.appendChild(document.createElement("div"));
+      box.style.display = "contents";
+    }
+    const it = { box, on: onStatus, slot: null };
+    it.slot = createSlot(box, { ...options, name, src: void 0, props, onStatus: (s, e) => it.on(s, e) });
+    item = it;
+  });
+  return {
+    update(next) {
+      props = next;
+      item?.slot.update(next);
+    },
+    set(next) {
+      if (next.src || next.name !== void 0) name = key(next);
+      item?.slot.set({ ...next, src: void 0, name });
+    },
+    retry: () => item?.slot.retry(),
+    destroy() {
+      cancel();
+      cancelPrefetch();
+      if (!item) return;
+      if (keepAlive && status === "ready") park(name, item, keepAlive === true ? 5 : keepAlive);
+      else {
+        item.slot.destroy();
+        if (item.box !== target) item.box.remove();
+      }
+      item = null;
+    },
+    get status() {
+      return status;
+    }
+  };
+}
+
+export {
+  timings,
+  hostSlot
+};

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+// src/cli/types.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+var PROPS = /export type Props =\s*([\s\S]*?)\s*$/;
+function parseProps(dts) {
+  return PROPS.exec(dts.replace(/^\s*\/\/.*$/gm, "").trim())?.[1]?.replace(/;$/, "") || null;
+}
+function envFile(props) {
+  const lines = Object.entries(props).map(([name, type]) => `    ${JSON.stringify(name)}: ${type}`);
+  return `// Gerado por \`npx vitral types\`. N\xE3o edite.
+import 'vitral'
+
+declare module 'vitral' {
+  interface Remotes {
+${lines.join("\n")}
+  }
+}
+`;
+}
+function readRemotes(cwd, args2, base) {
+  const pairs = args2.filter((a) => a.includes("="));
+  if (pairs.length) return Object.fromEntries(pairs.map((p) => [p.slice(0, p.indexOf("=")), p.slice(p.indexOf("=") + 1)]));
+  const file = [args2[0], "public/remotes.json", "remotes.json"].find((f) => f && existsSync(resolve(cwd, f)));
+  if (!file) throw new Error("[vitral] remotes.json n\xE3o encontrado. Passe o caminho ou pares nome=url.");
+  const map = JSON.parse(readFileSync(resolve(cwd, file), "utf8"));
+  return Object.fromEntries(
+    Object.entries(map).map(([name, v]) => {
+      const url = typeof v === "string" ? v : v.url;
+      return [name, base ? new URL(url, base).href : url];
+    })
+  );
+}
+async function types(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const get = options.fetch ?? fetch;
+  const log = options.log ?? console.log;
+  const remotes = readRemotes(cwd, options.args ?? [], options.base);
+  const props = {};
+  let falhas = 0;
+  for (const [name, url] of Object.entries(remotes)) {
+    let dts;
+    try {
+      const res = await get(new URL("vitral.d.ts", url).href);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      dts = await res.text();
+    } catch (err) {
+      log(`[vitral] ${name}: sem tipos (${err.message}).`);
+      falhas++;
+      continue;
+    }
+    const type = parseProps(dts);
+    if (type) props[name] = type;
+    else log(`[vitral] ${name}: vitral.d.ts sem "export type Props".`);
+  }
+  const out = resolve(cwd, options.out ?? "vitral-env.d.ts");
+  writeFileSync(out, envFile(props));
+  log(`[vitral] ${Object.keys(props).length} remote(s) em ${out}`);
+  return falhas;
+}
+
+// src/cli.ts
+var AJUDA = `Uso: vitral types [remotes.json | nome=url ...] [--base url] [--out arquivo]
+
+  Baixa o vitral.d.ts de cada remote e gera vitral-env.d.ts.`;
+function flag(args2, name) {
+  const i = args2.indexOf(name);
+  if (i < 0) return void 0;
+  const value = args2[i + 1];
+  args2.splice(i, 2);
+  return value;
+}
+var [command, ...args] = process.argv.slice(2);
+if (command === "types") {
+  const base = flag(args, "--base");
+  const out = flag(args, "--out");
+  types({ args, base, out }).then(
+    (falhas) => process.exitCode = falhas ? 1 : 0,
+    (err) => {
+      console.error(err.message);
+      process.exitCode = 1;
+    }
+  );
+} else {
+  console.log(AJUDA);
+  process.exitCode = command && command !== "--help" ? 1 : 0;
+}

package/dist/dedupe-IWFIXRWG.js

@@ -0,0 +1,81 @@
+// src/core/semver.ts
+function satisfies(version, range) {
+  if (range === "*") return true;
+  const [, op = "", want = ""] = /^(\^|~|>=|=)?(.*)$/.exec(range.trim());
+  if (!op || op === "=" || version.includes("-")) return version === want;
+  const v = version.split(".").map(Number);
+  const w = want.split(".").map(Number);
+  for (let i = 0; i < 3; i++) if (v[i] !== w[i]) {
+    if (!(v[i] > w[i])) return false;
+    break;
+  }
+  if (op === ">=") return true;
+  const fixed = op === "~" ? 2 : w[0] ? 1 : w[1] ? 2 : 3;
+  return v.slice(0, fixed).join(".") === w.slice(0, fixed).join(".");
+}
+
+// src/core/dedupe.ts
+var KEY = "vitral:dedupe:";
+var remembered = (k) => {
+  try {
+    return localStorage.getItem(KEY + k);
+  } catch {
+    return null;
+  }
+};
+var remember = (k, url) => {
+  try {
+    localStorage.setItem(KEY + k, url);
+  } catch {
+  }
+};
+function shared(p) {
+  if (!p.dedupe) {
+    const offers = /* @__PURE__ */ new Map();
+    const waiting = /* @__PURE__ */ new Map();
+    const drop = (list, o) => list.includes(o) && list.splice(list.indexOf(o), 1);
+    const start = (name, list, o) => {
+      if (!o.p) {
+        ;
+        (o.p = o.load()).catch(() => drop(list, o));
+        if (o.url) o.p.then(() => remember(`${name}@${o.version}`, o.url), () => {
+        });
+      }
+      return o.p;
+    };
+    p.dedupe = (name, range, offer2) => {
+      const own = offer2;
+      const list = offers.get(name) ?? [];
+      offers.set(name, list);
+      if (own?.url) waiting.get(name + own.url)?.(own);
+      let hit = list.find((o) => satisfies(o.version, range));
+      if (!hit && own) {
+        hit = list[list.push(own) - 1];
+        const want = own.url && remembered(`${name}@${own.version}`);
+        if (want && want !== own.url) {
+          own.p = new Promise((resolve) => {
+            waiting.set(name + want, resolve);
+            setTimeout(resolve, 300, own);
+          }).then((o) => {
+            waiting.delete(name + want);
+            if (o === own) own.p = void 0;
+            return start(name, list, o);
+          });
+          own.p.catch(() => drop(list, own));
+        }
+      }
+      return hit && start(name, list, hit);
+    };
+  }
+  return p.dedupe;
+}
+function offer(p, groups) {
+  for (const name in groups) {
+    const { version, modules } = groups[name];
+    shared(p)(name, version, { version, load: async () => modules });
+  }
+}
+export {
+  offer,
+  shared
+};

package/dist/devtools.d.ts

@@ -0,0 +1,12 @@
+/** Overrides salvos neste navegador: `{ nome: url }`. */
+declare function getOverrides(): Record<string, string>;
+/** Salva (ou remove, com `null`) o override de um remote. Vale a partir do próximo carregamento. */
+declare function setOverride(name: string, url: string | null): void;
+interface DevtoolsOptions {
+    /** Recarrega a página depois de mudar um override. Padrão: true. */
+    reload?: boolean;
+}
+/** Mostra o painel no canto da página. Devolve uma função que o remove. */
+declare function devtools(options?: DevtoolsOptions): () => void;
+
+export { type DevtoolsOptions, devtools, getOverrides, setOverride };

package/dist/devtools.js

@@ -0,0 +1,86 @@
+import {
+  OVERRIDES_KEY,
+  manifestUrl,
+  overridesEnabled,
+  storedOverrides
+} from "./chunk-DXORSF4X.js";
+import "./chunk-GNPFWISJ.js";
+
+// src/devtools.ts
+function getOverrides() {
+  return storedOverrides();
+}
+function setOverride(name, url) {
+  const all = storedOverrides();
+  if (url) all[name] = manifestUrl(url);
+  else delete all[name];
+  if (Object.keys(all).length) localStorage.setItem(OVERRIDES_KEY, JSON.stringify(all));
+  else localStorage.removeItem(OVERRIDES_KEY);
+}
+var STYLE = `
+:host { position: fixed; right: 12px; bottom: 12px; z-index: 2147483647; font: 13px/1.4 system-ui, sans-serif; color: #111 }
+button { font: inherit; cursor: pointer }
+.toggle { border: 1px solid #888; border-radius: 6px; background: #fff; padding: 4px 10px }
+.panel { margin-bottom: 8px; padding: 10px; width: 320px; background: #fff; border: 1px solid #888; border-radius: 8px; box-shadow: 0 4px 16px #0003 }
+ul { list-style: none; margin: 0 0 8px; padding: 0 }
+li { display: flex; gap: 6px; align-items: center; margin-bottom: 4px; word-break: break-all }
+form { display: grid; gap: 4px }
+input { font: inherit; padding: 3px 6px }
+.aviso { color: #a40000; margin: 0 0 8px }
+`;
+function devtools(options = {}) {
+  const host = document.createElement("div");
+  host.setAttribute("data-vitral-devtools", "");
+  const root = host.attachShadow({ mode: "open" });
+  const style = document.createElement("style");
+  style.textContent = STYLE;
+  const panel = document.createElement("div");
+  panel.className = "panel";
+  panel.hidden = true;
+  const toggle = document.createElement("button");
+  toggle.className = "toggle";
+  toggle.type = "button";
+  toggle.textContent = "vitral";
+  toggle.onclick = () => panel.hidden = !panel.hidden;
+  root.append(style, panel, toggle);
+  const changed = () => options.reload === false ? draw() : location.reload();
+  function draw() {
+    panel.replaceChildren();
+    if (!overridesEnabled()) {
+      const p = document.createElement("p");
+      p.className = "aviso";
+      p.textContent = "Overrides desligados: use configure({ devOverrides: true }) ou rode em localhost.";
+      panel.append(p);
+    }
+    const list = document.createElement("ul");
+    for (const [name2, url2] of Object.entries(storedOverrides())) {
+      const item = document.createElement("li");
+      const remove = document.createElement("button");
+      remove.type = "button";
+      remove.textContent = "remover";
+      remove.setAttribute("aria-label", `remover override de ${name2}`);
+      remove.onclick = () => (setOverride(name2, null), changed());
+      item.append(`${name2} \u2192 ${url2}`, remove);
+      list.append(item);
+    }
+    const form = document.createElement("form");
+    const name = Object.assign(document.createElement("input"), { placeholder: "nome (ex.: carrinho)", required: true, name: "name" });
+    const url = Object.assign(document.createElement("input"), { placeholder: "http://localhost:5174", required: true, name: "url" });
+    const save = Object.assign(document.createElement("button"), { type: "submit", textContent: "Salvar" });
+    form.append(name, url, save);
+    form.onsubmit = (e) => {
+      e.preventDefault();
+      setOverride(name.value.trim(), url.value.trim());
+      changed();
+    };
+    panel.append(list, form);
+  }
+  draw();
+  document.body.append(host);
+  return () => host.remove();
+}
+export {
+  devtools,
+  getOverrides,
+  setOverride
+};

package/dist/element.d.ts

@@ -1,4 +1,38 @@
-import { Props, SlotStatus, RemoteModule } from './index.js';
+import { P as Props, S as Shared, a as RemoteModule } from './types-BV-hUrms.js';
+import { S as SlotStatus } from './slot-pB276oPt.js';
+import './errors-KKB8FGCz.js';
+
+/**
+ * Host universal: `<vitral-remote>` funciona em qualquer lugar que renderize
+ * HTML (JS/TS puro, Angular, Svelte, Solid, Lit, Astro, Qwik, jQuery, server
+ * templates…).
+ *
+ *   import { defineVitralElement } from 'vitral/element'
+ *   defineVitralElement()
+ *
+ *   <vitral-remote name="carrinho" props='{"userId": 42}' isolate="shadow"
+ *     inherit-styles="/assets/base.css">
+ *     <p slot="fallback">Carregando…</p>
+ *     <p slot="error">Indisponível</p>
+ *   </vitral-remote>
+ *
+ *   <vitral-remote src="https://cdn.exemplo.com/carrinho/vitral.json"></vitral-remote>
+ *
+ * Sem os slots, mostra um carregando acessível e um erro com "Tentar de novo".
+ *
+ *   el.props = { userId: 43 }          // atualiza sem remontar
+ *   el.addEventListener('vitral-error', (e) => e.detail.error)
+ *   el.addEventListener('vitral-ready', (e) => e.detail.timings) // { manifest, js, css, mount } em ms
+ *   el.retry()
+ *
+ * Atributos de performance: `loading="lazy|idle"` (monta perto de aparecer ou
+ * com o navegador ocioso; reserve o espaço com `min-height`),
+ * `prefetch="hover|visible|idle"` (baixa antes de montar), `priority="high"`
+ * e `keep-alive` (ou `keep-alive="3"`: máximo de remotes guardados).
+ *
+ * Também exporta `elementRemote()` para publicar um Web Component (Lit,
+ * Stencil, vanilla) como remote.
+ */
 
 declare const Base: typeof HTMLElement;
 declare class VitralRemoteElement extends Base {
@@ -21,10 +55,34 @@ declare function defineVitralElement(tag?: string): void;
  *   export default elementRemote('meu-widget')
  */
 declare function elementRemote<P extends Props = Props>(tag: string, setup?: () => void): RemoteModule<P>;
+/** O que o `SharedController` precisa do elemento (o `ReactiveControllerHost` do Lit). */
+interface SharedControllerHost {
+    addController(controller: {
+        hostConnected?(): void;
+        hostDisconnected?(): void;
+    }): void;
+    requestUpdate(): void;
+}
+/**
+ * Controller do Lit para uma chave compartilhada (`provide`/`shared`). Assina
+ * enquanto o elemento está conectado e pede um novo render quando o valor
+ * (ou o resultado do seletor) muda.
+ *
+ *   usuario = new SharedController(this, 'usuario')
+ *   render() { return html`${this.usuario.value?.nome}` }
+ */
+declare class SharedController<T = unknown, S = T | undefined> {
+    #private;
+    /** Valor atual (ou o resultado do seletor). */
+    value: S;
+    constructor(host: SharedControllerHost, key: keyof Shared | (string & {}), select?: (value: T | undefined) => S);
+    hostConnected(): void;
+    hostDisconnected(): void;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'vitral-remote': VitralRemoteElement;
     }
 }
 
-export { VitralRemoteElement, defineVitralElement, elementRemote };
+export { SharedController, type SharedControllerHost, VitralRemoteElement, defineVitralElement, elementRemote };

package/dist/element.js

@@ -1,10 +1,17 @@
 import {
+  SharedController,
   VitralRemoteElement,
   defineVitralElement,
   elementRemote
-} from "./chunk-IZK6ITIJ.js";
-import "./chunk-TTL52BF2.js";
+} from "./chunk-6Y3VMWHH.js";
+import "./chunk-UTYAX6MU.js";
+import "./chunk-NCONW6WS.js";
+import "./chunk-2XF5BKV3.js";
+import "./chunk-SFL6LTP3.js";
+import "./chunk-PX7PBCCT.js";
+import "./chunk-GNPFWISJ.js";
 export {
+  SharedController,
   VitralRemoteElement,
   defineVitralElement,
   elementRemote

package/dist/errors-KKB8FGCz.d.ts

@@ -0,0 +1,11 @@
+type RemoteErrorCode = 'NOT_REGISTERED' | 'NOT_EXPOSED' | 'ORIGIN_BLOCKED' | 'TIMEOUT' | 'INTEGRITY' | 'INVALID_MODULE' | 'LOAD_FAILED' | 'MOUNT_FAILED' | 'RENDER_FAILED' | 'SHARED_READONLY';
+declare class RemoteError extends Error {
+    code: RemoteErrorCode;
+    remote: string;
+    cause?: unknown | undefined;
+    /** Link da página deste erro na documentação. */
+    docs: string;
+    constructor(code: RemoteErrorCode, remote: string, message: string, cause?: unknown | undefined);
+}
+
+export { RemoteError as R, type RemoteErrorCode as a };

package/dist/events-DUdjhfps.d.ts

@@ -0,0 +1,6 @@
+import { E as EventBus } from './types-BV-hUrms.js';
+
+/** Barramento global. É o mesmo objeto que os remotes recebem em `ctx.events`. */
+declare const events: EventBus;
+
+export { events as e };

package/dist/expose-53BEJB34.js

@@ -0,0 +1,14 @@
+import {
+  resolveModule,
+  resolveTarget,
+  splitName
+} from "./chunk-HP6QWU6K.js";
+import "./chunk-2XF5BKV3.js";
+import "./chunk-SFL6LTP3.js";
+import "./chunk-PX7PBCCT.js";
+import "./chunk-GNPFWISJ.js";
+export {
+  resolveModule,
+  resolveTarget,
+  splitName
+};

package/dist/host-slot-Cz6EiGsB.d.ts

@@ -0,0 +1,6 @@
+/** Quando montar: já (`eager`, padrão), perto de aparecer na tela (`lazy`) ou com o navegador ocioso (`idle`). */
+type Loading = 'eager' | 'lazy' | 'idle';
+/** Quando baixar antes de montar: no hover ou foco (`hover`), perto de aparecer (`visible`) ou com o navegador ocioso (`idle`). */
+type Prefetch = 'hover' | 'visible' | 'idle';
+
+export type { Loading as L, Prefetch as P };

package/dist/iframe.d.ts

@@ -0,0 +1,28 @@
+/** Script inline do iframe. Libere o hash dele no CSP (`script-src 'sha256-…'`). */
+declare const FRAME_SCRIPT = "(function (w, load) {\n  var parent = w.parent, doc = w.document, handlers = {}, last = {}, channel = {}, mounted = null, stage = 'LOAD_FAILED'\n  function post(type, data) { parent.postMessage({ vitral: 1, type: type, data: data }, '*') }\n  function call(fn, arg) { try { fn(arg) } catch (e) { w.console.error(e) } }\n  var events = {\n    emit: function (type, payload) { post('emit', { type: type, payload: payload }) },\n    on: function (type, fn) {\n      if (!handlers[type]) { handlers[type] = []; post('on', { type: type }) }\n      handlers[type].push(fn)\n      return function () { handlers[type] = handlers[type].filter(function (h) { return h !== fn }) }\n    },\n    last: function (type) { return last[type] }\n  }\n  function start(d) {\n    var root = doc.createElement('div')\n    root.setAttribute('data-vitral-root', d.name)\n    if (d.scope) root.setAttribute('data-vitral-scope', d.scope)\n    doc.body.appendChild(root)\n    // Ponto de extens\u00E3o: uma ponte nova registra handlers em channel[tipo] e\n    // acrescenta campos aqui (a Fase 2 acrescenta ctx.shared).\n    var ctx = {\n      name: d.name, baseUrl: d.baseUrl, events: events, shadowRoot: null, protocol: 1,\n      reportError: function (e) { post('report', { message: String((e && e.message) || e) }) },\n      navigate: function (url, o) { post('navigate', { url: String(url), replace: !!(o && o.replace) }) }\n    }\n    Promise.all(d.css.map(function (href) {\n      return new Promise(function (done) {\n        var link = doc.createElement('link')\n        link.rel = 'stylesheet'; link.href = href; link.crossOrigin = 'anonymous'\n        link.onload = link.onerror = done\n        doc.head.appendChild(link)\n      })\n    })).then(function () {\n      return load(d.code ? w.URL.createObjectURL(new w.Blob([d.code], { type: 'text/javascript' })) : d.url)\n    }).then(function (ns) {\n      if (!d.key) return ns\n      var table = ns.exposes, part = table && table[d.key]\n      if (!part) { stage = 'NOT_EXPOSED'; throw new Error(d.name + ' n\u00E3o exp\u00F5e ' + d.key) }\n      return typeof part === 'function' ? part() : part\n    }).then(function (ns) {\n      var mod = (ns && ns.default) || ns\n      if (!mod || typeof mod.mount !== 'function') { stage = 'INVALID_MODULE'; throw new Error('o m\u00F3dulo n\u00E3o exporta mount()') }\n      stage = 'MOUNT_FAILED'\n      return mod.mount(root, d.props, ctx)\n    }).then(function (handle) {\n      mounted = handle\n      post('mounted')\n      var size = function () { post('size', { height: Math.ceil(doc.body.getBoundingClientRect().height) }) }\n      size()\n      if (w.ResizeObserver) new w.ResizeObserver(size).observe(doc.body)\n    }, function (e) {\n      post('error', { code: stage, message: String((e && e.message) || e) })\n    })\n  }\n  w.addEventListener('message', function (e) {\n    var m = e.data\n    if (e.source !== parent || !m || m.vitral !== 1) return\n    var d = m.data\n    if (m.type === 'mount') start(d)\n    else if (m.type === 'update') { if (mounted && mounted.update) mounted.update(d) }\n    else if (m.type === 'unmount') { if (mounted) mounted.unmount(); mounted = null }\n    else if (m.type === 'last') last[d.type] = d.payload\n    else if (m.type === 'event') {\n      last[d.type] = d.payload\n      ;(handlers[d.type] || []).slice().forEach(function (h) { call(h, d.payload) })\n    } else (channel[m.type] || []).forEach(function (h) { call(h, d) })\n  })\n  post('ready')\n})(window, function (u) { return import(u) })";
+
+/** Canal com um iframe montado, para pontes novas (ex.: estado compartilhado). */
+interface FramePort {
+    /** Manda `data` (serializável) para o iframe com o tipo `type`. */
+    post(type: string, data?: unknown): void;
+    /** Recebe as mensagens do iframe com o tipo `type`. */
+    on(type: string, handler: (data: unknown) => void): () => void;
+}
+/** Chamada a cada iframe montado. Devolve a limpeza. */
+type FrameBridge = (port: FramePort, info: {
+    name: string;
+}) => void | (() => void);
+interface IframeOptions {
+    /**
+     * Valor do atributo `sandbox`. Padrão `'allow-scripts'`. Acrescente o que o
+     * remote precisa (`'allow-scripts allow-forms allow-popups'`). Com
+     * `allow-same-origin` o iframe ganha a origem da página e deixa de isolar.
+     */
+    sandbox?: string;
+    /** Pontes extras, além de props e eventos. */
+    bridges?: FrameBridge[];
+}
+/** Liga `isolate="iframe"` em todos os componentes de host e em `mountRemote`. */
+declare function enableIframe(options?: IframeOptions): void;
+
+export { FRAME_SCRIPT, type FrameBridge, type FramePort, type IframeOptions, enableIframe };