vitral 0.2.0 → 0.3.0

package/dist/cli.js

@@ -7,10 +7,13 @@ 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) {
+var HASH = /^\/\/ vitral:hash ("(?:[^"\\]|\\.)*") (\S+)$/gm;
+function envFile(props, hashes = {}) {
   const lines = Object.entries(props).map(([name, type]) => `    ${JSON.stringify(name)}: ${type}`);
+  const marks = Object.entries(hashes).map(([name, hash]) => `// vitral:hash ${JSON.stringify(name)} ${hash}
+`);
   return `// Gerado por \`npx vitral types\`. N\xE3o edite.
-import 'vitral'
+${marks.join("")}import 'vitral'
 
 declare module 'vitral' {
   interface Remotes {
@@ -19,6 +22,43 @@ ${lines.join("\n")}
 }
 `;
 }
+function readHashes(env) {
+  return Object.fromEntries([...env.matchAll(HASH)].map((m) => [JSON.parse(m[1]), m[2]]));
+}
+async function manifestHash(get, url) {
+  try {
+    const res = await get(url);
+    if (!res.ok) return void 0;
+    const { integrity } = await res.json();
+    return typeof integrity === "string" ? integrity : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function check(remotes, out, get, log) {
+  if (!existsSync(out)) {
+    log(`[vitral] ${out} n\xE3o existe. Rode \`npx vitral types\`.`);
+    return 1;
+  }
+  const recorded = readHashes(readFileSync(out, "utf8"));
+  let stale = 0;
+  for (const [name, url] of Object.entries(remotes)) {
+    const hash = await manifestHash(get, url);
+    if (!hash) log(`[vitral] ${name}: manifesto sem hash, n\xE3o deu para conferir.`);
+    else if (recorded[name] !== hash) {
+      log(`[vitral] ${name}: tipos desatualizados (${recorded[name] ? "o manifesto mudou" : "sem hash registrado"}).`);
+      stale++;
+    }
+  }
+  for (const name of Object.keys(recorded)) {
+    if (!(name in remotes)) {
+      log(`[vitral] ${name}: n\xE3o est\xE1 mais no remotes.json.`);
+      stale++;
+    }
+  }
+  log(stale ? `[vitral] ${stale} remote(s) com tipos desatualizados. Rode \`npx vitral types\`.` : `[vitral] tipos em dia com os manifestos.`);
+  return stale;
+}
 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)]));
@@ -37,7 +77,10 @@ async function types(options = {}) {
   const get = options.fetch ?? fetch;
   const log = options.log ?? console.log;
   const remotes = readRemotes(cwd, options.args ?? [], options.base);
+  const out = resolve(cwd, options.out ?? "vitral-env.d.ts");
+  if (options.check) return check(remotes, out, get, log);
   const props = {};
+  const hashes = {};
   let falhas = 0;
   for (const [name, url] of Object.entries(remotes)) {
     let dts;
@@ -51,19 +94,25 @@ async function types(options = {}) {
       continue;
     }
     const type = parseProps(dts);
-    if (type) props[name] = type;
-    else log(`[vitral] ${name}: vitral.d.ts sem "export type Props".`);
+    if (!type) {
+      log(`[vitral] ${name}: vitral.d.ts sem "export type Props".`);
+      continue;
+    }
+    props[name] = type;
+    const hash = await manifestHash(get, url);
+    if (hash) hashes[name] = hash;
   }
-  const out = resolve(cwd, options.out ?? "vitral-env.d.ts");
-  writeFileSync(out, envFile(props));
+  writeFileSync(out, envFile(props, hashes));
   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]
+var AJUDA = `Uso: vitral types [remotes.json | nome=url ...] [--base url] [--out arquivo] [--check]
 
-  Baixa o vitral.d.ts de cada remote e gera vitral-env.d.ts.`;
+  Baixa o vitral.d.ts de cada remote e gera vitral-env.d.ts.
+  --check  s\xF3 confere se o hash de cada manifesto ainda \xE9 o registrado;
+           sai com erro se algum mudou (\xFAtil no CI).`;
 function flag(args2, name) {
   const i = args2.indexOf(name);
   if (i < 0) return void 0;
@@ -75,7 +124,8 @@ 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(
+  const check2 = args.includes("--check");
+  types({ args: args.filter((a) => a !== "--check"), base, out, check: check2 }).then(
     (falhas) => process.exitCode = falhas ? 1 : 0,
     (err) => {
       console.error(err.message);

package/dist/contract-46EZFQPQ.js

@@ -0,0 +1,17 @@
+import {
+  protocol
+} from "./chunk-GNPFWISJ.js";
+
+// src/core/contract.ts
+async function checkContract(c, range = protocol().settings().contract) {
+  const { satisfies } = await import("./dedupe-S7BHQMOZ.js");
+  if (c.version && !satisfies(c.version, range)) return `o host aceita contrato ${range}, o remote publica ${c.version}`;
+  const offered = protocol().settings().offered ?? {};
+  for (const dep in c.peers) {
+    const have = offered[dep];
+    if (have && !satisfies(have, c.peers[dep])) return `o remote espera ${dep} ${c.peers[dep]}, o host oferece ${have}`;
+  }
+}
+export {
+  checkContract
+};

package/dist/{dedupe-IWFIXRWG.js → dedupe-S7BHQMOZ.js}

@@ -3,14 +3,13 @@ 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);
+  const [v, w] = [version, want].map((s) => (s + ".0.0").split(".", 3).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;
+  const fixed = Math.min(want.split(".").length, op === "~" ? 2 : w[0] ? 1 : w[1] ? 2 : 3);
   return v.slice(0, fixed).join(".") === w.slice(0, fixed).join(".");
 }
 
@@ -73,9 +72,11 @@ function offer(p, groups) {
   for (const name in groups) {
     const { version, modules } = groups[name];
     shared(p)(name, version, { version, load: async () => modules });
+    p.configure({ offered: { ...p.settings().offered, [name]: version } });
   }
 }
 export {
   offer,
+  satisfies,
   shared
 };

package/dist/element.d.ts

@@ -1,6 +1,6 @@
-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';
+import { P as Props, S as Shared, a as RemoteModule } from './types-Czvm-siZ.js';
+import { S as SlotStatus } from './slot-DqXTwGbs.js';
+import './errors-kjBv6IH_.js';
 
 /**
  * Host universal: `<vitral-remote>` funciona em qualquer lugar que renderize

package/dist/element.js

@@ -3,12 +3,13 @@ import {
   VitralRemoteElement,
   defineVitralElement,
   elementRemote
-} from "./chunk-6Y3VMWHH.js";
-import "./chunk-UTYAX6MU.js";
-import "./chunk-NCONW6WS.js";
-import "./chunk-2XF5BKV3.js";
-import "./chunk-SFL6LTP3.js";
-import "./chunk-PX7PBCCT.js";
+} from "./chunk-3YXI3G34.js";
+import "./chunk-IHTUM6LT.js";
+import "./chunk-I3VSKSAZ.js";
+import "./chunk-TD4S3IHA.js";
+import "./chunk-ZAC6QQI6.js";
+import "./chunk-GNHCZRQP.js";
+import "./chunk-AKNNHQ2H.js";
 import "./chunk-GNPFWISJ.js";
 export {
   SharedController,

package/dist/{errors-KKB8FGCz.d.ts → errors-kjBv6IH_.d.ts}

@@ -1,10 +1,16 @@
-type RemoteErrorCode = 'NOT_REGISTERED' | 'NOT_EXPOSED' | 'ORIGIN_BLOCKED' | 'TIMEOUT' | 'INTEGRITY' | 'INVALID_MODULE' | 'LOAD_FAILED' | 'MOUNT_FAILED' | 'RENDER_FAILED' | 'SHARED_READONLY';
+type RemoteErrorCode = 'NOT_REGISTERED' | 'NOT_EXPOSED' | 'ORIGIN_BLOCKED' | 'TIMEOUT' | 'INTEGRITY' | 'INVALID_MODULE' | 'LOAD_FAILED' | 'MOUNT_FAILED' | 'RENDER_FAILED' | 'SHARED_READONLY' | 'CONTRACT_MISMATCH';
 declare class RemoteError extends Error {
     code: RemoteErrorCode;
     remote: string;
     cause?: unknown | undefined;
     /** Link da página deste erro na documentação. */
     docs: string;
+    /** URL do JS do remote (ou a registrada, se o erro veio antes do manifesto). */
+    entry?: string;
+    /** Versão do remote, do campo `version` do `vitral.json`. */
+    version?: string;
+    /** `location.pathname` no momento do erro. */
+    route?: string;
     constructor(code: RemoteErrorCode, remote: string, message: string, cause?: unknown | undefined);
 }
 

package/dist/{events-DUdjhfps.d.ts → events-D5gs7rff.d.ts}

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

package/dist/expose-JUOUN5N5.js

@@ -0,0 +1,15 @@
+import {
+  resolveModule,
+  resolveTarget,
+  splitName
+} from "./chunk-SDB5AZEI.js";
+import "./chunk-TD4S3IHA.js";
+import "./chunk-ZAC6QQI6.js";
+import "./chunk-GNHCZRQP.js";
+import "./chunk-AKNNHQ2H.js";
+import "./chunk-GNPFWISJ.js";
+export {
+  resolveModule,
+  resolveTarget,
+  splitName
+};

package/dist/iframe.d.ts

@@ -1,5 +1,5 @@
 /** 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) })";
+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, portalContainer: doc.body, 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 {

package/dist/iframe.js

@@ -1,25 +1,28 @@
 import {
   splitName
-} from "./chunk-HP6QWU6K.js";
+} from "./chunk-SDB5AZEI.js";
 import {
   verifyIntegrity
-} from "./chunk-S5MZT5IT.js";
+} from "./chunk-AH7KNMBW.js";
 import {
   events,
   navigate,
   setFrameMounter,
   track
-} from "./chunk-NCONW6WS.js";
+} from "./chunk-I3VSKSAZ.js";
 import {
   resolveEntry
-} from "./chunk-2XF5BKV3.js";
-import "./chunk-SFL6LTP3.js";
+} from "./chunk-TD4S3IHA.js";
+import "./chunk-ZAC6QQI6.js";
 import {
-  RemoteError,
   fetchBytes,
   withRetry,
   withTimeout
-} from "./chunk-PX7PBCCT.js";
+} from "./chunk-GNHCZRQP.js";
+import {
+  RemoteError,
+  report
+} from "./chunk-AKNNHQ2H.js";
 import {
   protocol
 } from "./chunk-GNPFWISJ.js";
@@ -46,7 +49,7 @@ var FRAME_RUNTIME = `function (w, load) {
     // Ponto de extens\xE3o: uma ponte nova registra handlers em channel[tipo] e
     // acrescenta campos aqui (a Fase 2 acrescenta ctx.shared).
     var ctx = {
-      name: d.name, baseUrl: d.baseUrl, events: events, shadowRoot: null, protocol: 1,
+      name: d.name, baseUrl: d.baseUrl, events: events, shadowRoot: null, portalContainer: doc.body, protocol: 1,
       reportError: function (e) { post('report', { message: String((e && e.message) || e) }) },
       navigate: function (url, o) { post('navigate', { url: String(url), replace: !!(o && o.replace) }) }
     }
@@ -119,7 +122,6 @@ async function mountFrame(target, name, props, options, sandbox, bridges) {
     await verifyIntegrity(name, bytes, integrity);
     return bytes;
   }) : void 0;
-  track(name, resolved.entry);
   const baseUrl = /^https?:/.test(resolved.entry) ? new URL(".", resolved.entry).href : resolved.entry;
   const frame = document.createElement("iframe");
   frame.setAttribute("sandbox", sandbox);
@@ -188,7 +190,7 @@ async function mountFrame(target, name, props, options, sandbox, bridges) {
         break;
       }
       case "report": {
-        const err = new RemoteError("RENDER_FAILED", name, String(d?.message));
+        const err = report(new RemoteError("RENDER_FAILED", name, String(d?.message)), resolved);
         if (options.onError) options.onError(err);
         else console.error(err);
         break;
@@ -217,6 +219,7 @@ async function mountFrame(target, name, props, options, sandbox, bridges) {
     cleanup();
     throw e;
   }
+  disposers.push(track(name, resolved));
   let alive = true;
   return {
     update(next) {

package/dist/index.d.ts

@@ -1,24 +1,12 @@
-import { V as VitralConfig, c as RemoteEntry, P as Props, a as RemoteModule, I as Isolation, b as StyleOptions, M as MountedRemote, E as EventBus, R as RemoteContext, d as SharedValue } from './types-BV-hUrms.js';
-export { C as CheckedProps, H as Handler, e as PropsOf, f as ProvideOptions, g as ProvidedValue, h as RemoteManifest, i as RemoteMetric, j as Remotes, S as Shared, k as SharedApi, l as SharedModules, m as SharedType, n as batch, p as provide, s as shared } from './types-BV-hUrms.js';
-import { R as RemoteError } from './errors-KKB8FGCz.js';
-export { a as RemoteErrorCode } from './errors-KKB8FGCz.js';
-export { R as RemoteSlot, a as SlotOptions, S as SlotStatus, c as createSlot } from './slot-pB276oPt.js';
-export { e as events } from './events-DUdjhfps.js';
+import { V as VitralConfig, c as RemoteEntry, P as Props, a as RemoteModule, I as Isolation, b as StyleOptions, M as MountedRemote, E as EventBus, R as RemoteContext, d as SharedValue } from './types-Czvm-siZ.js';
+export { C as CheckedProps, H as Handler, e as PropsOf, f as ProvideOptions, g as ProvidedValue, h as RemoteContract, i as RemoteManifest, j as RemoteMetric, k as Remotes, S as Shared, l as SharedApi, m as SharedModules, n as SharedType, o as batch, p as provide, s as shared } from './types-Czvm-siZ.js';
+import { R as RemoteError } from './errors-kjBv6IH_.js';
+export { a as RemoteErrorCode } from './errors-kjBv6IH_.js';
+export { R as RemoteSlot, a as SlotOptions, S as SlotStatus, c as createSlot } from './slot-DqXTwGbs.js';
+export { e as events } from './events-D5gs7rff.js';
 export { n as navigate } from './navigate-BRG1WJUM.js';
 export { r as __reset } from './state-BDdCwc21.js';
 
-/** Configura a lib. Pode ser chamada mais de uma vez; as opções são mescladas. */
-declare function configure(config: VitralConfig): void;
-/** Registra (ou substitui) um remote. */
-declare function register(name: string, entry: string | RemoteEntry): void;
-/**
- * Registra a URL de um `src` e devolve o nome para montar. Sem `name`, o nome
- * é a própria URL (e o nome do manifesto vira um apelido). Com `trusted`, a
- * origem entra na allowlist mesmo com `allowedOrigins`: vale para URL escrita
- * no código do host, nunca para URL vinda de dados.
- */
-declare function registerSrc(src: string, name?: string, trusted?: boolean): string;
-
 /** Uma chave do store vista de fora (devtools, SSR, ponte do iframe). */
 interface SharedEntry {
     key: string;
@@ -60,6 +48,18 @@ interface SharedStore {
     list(): SharedEntry[];
 }
 
+/** Configura a lib. Pode ser chamada mais de uma vez; as opções são mescladas. */
+declare function configure(config: VitralConfig): void;
+/** Registra (ou substitui) um remote. */
+declare function register(name: string, entry: string | RemoteEntry): void;
+/**
+ * Registra a URL de um `src` e devolve o nome para montar. Sem `name`, o nome
+ * é a própria URL (e o nome do manifesto vira um apelido). Com `trusted`, a
+ * origem entra na allowlist mesmo com `allowedOrigins`: vale para URL escrita
+ * no código do host, nunca para URL vinda de dados.
+ */
+declare function registerSrc(src: string, name?: string, trusted?: boolean): string;
+
 /** Baixa (uma vez só) e devolve o módulo de um remote. */
 declare function loadRemote<P extends Props = Props>(name: string): Promise<RemoteModule<P>>;
 /**
@@ -97,12 +97,14 @@ declare function createEventBus(): EventBus;
 
 /**
  * Troca as montagens de `name` (e das partes, `name/…`) pela versão que o
- * manifesto aponta agora, sem recarregar a página. Rejeita se a versão nova
- * não carregar; nesse caso nada muda na tela.
+ * manifesto aponta agora, sem recarregar a página. Resolve quando todas as
+ * montagens já mostram a versão nova. Rejeita se a versão nova não carregar
+ * ou se o `mount` dela falhar; nesse caso a montagem antiga fica na tela.
  */
 declare function refresh(name: string): Promise<void>;
 /**
- * Revalida os manifestos dos remotes montados e emite
+ * Revalida os manifestos dos remotes montados agora (os desmontados ficam de
+ * fora) e emite
  * `vitral:update-available` com `{ name, entry }` para cada deploy novo.
  * Devolve os nomes com versão nova. Falhas de rede são ignoradas.
  */

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   syncTabs,
   unsafeHTML,
   watchUpdates
-} from "./chunk-NCONW6WS.js";
+} from "./chunk-I3VSKSAZ.js";
 import {
   configure,
   loadModule,
@@ -25,11 +25,12 @@ import {
   preload,
   register,
   registerSrc
-} from "./chunk-2XF5BKV3.js";
-import "./chunk-SFL6LTP3.js";
+} from "./chunk-TD4S3IHA.js";
+import "./chunk-ZAC6QQI6.js";
+import "./chunk-GNHCZRQP.js";
 import {
   RemoteError
-} from "./chunk-PX7PBCCT.js";
+} from "./chunk-AKNNHQ2H.js";
 import {
   createEventBus,
   resetProtocol

package/dist/otel.d.ts

@@ -0,0 +1,44 @@
+import { R as RemoteError } from './errors-kjBv6IH_.js';
+
+/**
+ * Erros dos remotes no OpenTelemetry, sem depender do `@opentelemetry/api`:
+ *
+ *   import { trace } from '@opentelemetry/api'
+ *   import { otelOnError } from 'vitral/otel'
+ *
+ *   configure({ onError: otelOnError({ trace, tracer: trace.getTracer('host') }) })
+ *
+ * Com um span ativo, o erro vira um evento `exception` nele. Sem span ativo
+ * (ou sem `trace`), o `tracer` abre e fecha um span `vitral.error` com o erro.
+ * Os atributos são os de exceção do OpenTelemetry mais `vitral.remote`,
+ * `vitral.version`, `vitral.code`, `vitral.entry` e `vitral.route`.
+ */
+
+/** Atributos de span e de evento. */
+type Attributes = Record<string, string>;
+/** A parte de um `Span` que o adaptador usa. */
+interface SpanLike {
+    addEvent(name: string, attributes?: Attributes): unknown;
+    recordException(exception: Error): void;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): unknown;
+    end(): void;
+}
+interface OtelOptions {
+    /** O `trace` de `@opentelemetry/api`, para achar o span ativo. */
+    trace?: {
+        getActiveSpan(): SpanLike | undefined;
+    };
+    /** Tracer que abre um span quando não há span ativo. */
+    tracer?: {
+        startSpan(name: string, options?: {
+            attributes?: Attributes;
+        }): SpanLike;
+    };
+}
+/** `onError` para o `configure` que registra cada `RemoteError` no OpenTelemetry. */
+declare function otelOnError({ trace, tracer }: OtelOptions): (error: RemoteError) => void;
+
+export { type Attributes, type OtelOptions, type SpanLike, otelOnError };

package/dist/otel.js

@@ -0,0 +1,27 @@
+// src/otel.ts
+function otelOnError({ trace, tracer }) {
+  return (error) => {
+    const all = {
+      "exception.type": error.name,
+      "exception.message": error.message,
+      "exception.stacktrace": error.stack,
+      "vitral.remote": error.remote,
+      "vitral.version": error.version,
+      "vitral.code": error.code,
+      "vitral.entry": error.entry,
+      "vitral.route": error.route
+    };
+    const attributes = {};
+    for (const k in all) if (all[k] !== void 0) attributes[k] = all[k];
+    const active = trace?.getActiveSpan();
+    if (active) return void active.addEvent("exception", attributes);
+    const span = tracer?.startSpan("vitral.error", { attributes });
+    if (!span) return;
+    span.recordException(error);
+    span.setStatus({ code: 2, message: error.message });
+    span.end();
+  };
+}
+export {
+  otelOnError
+};

package/dist/preact.d.ts

@@ -1,10 +1,10 @@
 import * as preact from 'preact';
 import { VNode, ComponentType } from 'preact';
-import { P as Props, I as Isolation, C as CheckedProps, a as RemoteModule, S as Shared } from './types-BV-hUrms.js';
-export { R as RemoteContext } from './types-BV-hUrms.js';
-import { R as RemoteError } from './errors-KKB8FGCz.js';
-import { S as SlotStatus } from './slot-pB276oPt.js';
-export { e as events } from './events-DUdjhfps.js';
+import { P as Props, I as Isolation, C as CheckedProps, a as RemoteModule, S as Shared } from './types-Czvm-siZ.js';
+export { R as RemoteContext } from './types-Czvm-siZ.js';
+import { R as RemoteError } from './errors-kjBv6IH_.js';
+import { S as SlotStatus } from './slot-DqXTwGbs.js';
+export { e as events } from './events-D5gs7rff.js';
 export { n as navigate } from './navigate-BRG1WJUM.js';
 import { L as Loading, P as Prefetch } from './host-slot-Cz6EiGsB.js';
 

package/dist/preact.js

@@ -1,6 +1,6 @@
 import {
   hostSlot
-} from "./chunk-UTYAX6MU.js";
+} from "./chunk-IHTUM6LT.js";
 import {
   defineRemote,
   events,
@@ -8,10 +8,11 @@ import {
   navigate,
   same,
   shared
-} from "./chunk-NCONW6WS.js";
-import "./chunk-2XF5BKV3.js";
-import "./chunk-SFL6LTP3.js";
-import "./chunk-PX7PBCCT.js";
+} from "./chunk-I3VSKSAZ.js";
+import "./chunk-TD4S3IHA.js";
+import "./chunk-ZAC6QQI6.js";
+import "./chunk-GNHCZRQP.js";
+import "./chunk-AKNNHQ2H.js";
 import "./chunk-GNPFWISJ.js";
 
 // src/preact.ts

package/dist/react.d.ts

@@ -1,9 +1,10 @@
 import { ReactNode, ComponentType } from 'react';
 import { L as Loading, P as Prefetch } from './host-slot-Cz6EiGsB.js';
 import * as JSXRuntime from 'react/jsx-runtime';
-import { P as Props, I as Isolation, C as CheckedProps, a as RemoteModule, S as Shared, R as RemoteContext } from './types-BV-hUrms.js';
-export { E as EventBus } from './types-BV-hUrms.js';
-export { e as events } from './events-DUdjhfps.js';
+import { P as Props, I as Isolation, C as CheckedProps, a as RemoteModule, S as Shared, R as RemoteContext } from './types-Czvm-siZ.js';
+export { E as EventBus } from './types-Czvm-siZ.js';
+export { e as events } from './events-D5gs7rff.js';
+import './errors-kjBv6IH_.js';
 
 /**
  * Adaptador React (funciona em Vite, CRA e Next.js App/Pages Router).
@@ -17,6 +18,13 @@ export { e as events } from './events-DUdjhfps.js';
 declare function reactRemote<P extends Props>(Component: ComponentType<P>): RemoteModule<P>;
 /** Dentro de um remote: dá acesso ao contexto (nome, eventos, baseUrl). */
 declare function useVitral(): RemoteContext | null;
+/**
+ * Dentro de um remote: onde renderizar portais. No Shadow DOM é um elemento
+ * dentro do shadow root (com os estilos do remote); fora de um remote,
+ * `undefined`, e a biblioteca usa o padrão dela (`document.body`). Use em
+ * `<Popover.Portal container={usePortalContainer()}>`.
+ */
+declare function usePortalContainer(): HTMLElement | undefined;
 /** Assina um evento do barramento global enquanto o componente estiver montado. */
 declare function useEvent<T = unknown>(type: string, handler: (payload: T) => void): void;
 /** Estado derivado do último valor emitido em `type`. */
@@ -60,4 +68,4 @@ interface RemoteProps<P extends Props = Props> {
  */
 declare function Remote<P extends Props = Props, N extends string = string>({ name, src, props, isolate, fallback, error, onError, className, loading, prefetch, priority, keepAlive, }: RemoteProps<P> & CheckedProps<N>): JSXRuntime.JSX.Element;
 
-export { Remote, type RemoteProps, reactRemote, useEvent, useEventValue, useShared, useVitral };
+export { Remote, type RemoteProps, reactRemote, useEvent, useEventValue, usePortalContainer, useShared, useVitral };

package/dist/react.js

@@ -1,17 +1,18 @@
 "use client";
 import {
   hostSlot
-} from "./chunk-UTYAX6MU.js";
+} from "./chunk-IHTUM6LT.js";
 import {
   defineRemote,
   events,
   memoSelect,
   same,
   shared
-} from "./chunk-NCONW6WS.js";
-import "./chunk-2XF5BKV3.js";
-import "./chunk-SFL6LTP3.js";
-import "./chunk-PX7PBCCT.js";
+} from "./chunk-I3VSKSAZ.js";
+import "./chunk-TD4S3IHA.js";
+import "./chunk-ZAC6QQI6.js";
+import "./chunk-GNHCZRQP.js";
+import "./chunk-AKNNHQ2H.js";
 import {
   protocol
 } from "./chunk-GNPFWISJ.js";
@@ -65,6 +66,9 @@ function reactRemote(Component) {
 function useVitral() {
   return useContext(VitralContext);
 }
+function usePortalContainer() {
+  return useVitral()?.portalContainer;
+}
 function useEvent(type, handler) {
   const ref = useRef(handler);
   ref.current = handler;
@@ -99,7 +103,7 @@ function offerReact() {
     // O React 19 expõe o react/compiler-runtime pelo próprio react.
     ...compiler && { "react/compiler-runtime": compiler }
   };
-  p.pending(import("./dedupe-IWFIXRWG.js").then((m) => m.offer(p, { react: { version: ReactAll.version, modules } })).catch(() => {
+  p.pending(import("./dedupe-S7BHQMOZ.js").then((m) => m.offer(p, { react: { version: ReactAll.version, modules } })).catch(() => {
   }));
 }
 function Remote({
@@ -162,6 +166,7 @@ export {
   reactRemote,
   useEvent,
   useEventValue,
+  usePortalContainer,
   useShared,
   useVitral
 };

package/dist/routes.d.ts

@@ -1,6 +1,6 @@
-import { P as Props } from './types-BV-hUrms.js';
-import { S as SlotStatus } from './slot-pB276oPt.js';
-import './errors-KKB8FGCz.js';
+import { P as Props } from './types-Czvm-siZ.js';
+import { S as SlotStatus } from './slot-DqXTwGbs.js';
+import './errors-kjBv6IH_.js';
 
 /** Padrão de URL → nome do remote. A primeira rota que bate vence. */
 type Routes = Record<string, string>;

package/dist/routes.js

@@ -1,10 +1,11 @@
 import {
   createSlot,
   navigate
-} from "./chunk-NCONW6WS.js";
-import "./chunk-2XF5BKV3.js";
-import "./chunk-SFL6LTP3.js";
-import "./chunk-PX7PBCCT.js";
+} from "./chunk-I3VSKSAZ.js";
+import "./chunk-TD4S3IHA.js";
+import "./chunk-ZAC6QQI6.js";
+import "./chunk-GNHCZRQP.js";
+import "./chunk-AKNNHQ2H.js";
 import "./chunk-GNPFWISJ.js";
 
 // src/routes.ts