vitral 0.2.0 → 0.3.0

package/dist/sentry.d.ts

@@ -0,0 +1,25 @@
+import { R as RemoteError } from './errors-kjBv6IH_.js';
+
+/**
+ * Erros dos remotes no Sentry, sem depender do SDK:
+ *
+ *   import * as Sentry from '@sentry/browser'
+ *   import { sentryOnError } from 'vitral/sentry'
+ *
+ *   configure({ onError: sentryOnError(Sentry) })
+ *
+ * Cada `RemoteError` vira um `captureException` com as tags `vitral.remote`,
+ * `vitral.version` e `vitral.code`, e com `entry`, `route` e `docs` no `extra`.
+ */
+
+/** A parte do SDK do Sentry que o adaptador usa (`@sentry/browser`, `@sentry/react`…). */
+interface SentryLike {
+    captureException(exception: unknown, hint?: {
+        tags?: Record<string, string>;
+        extra?: Record<string, unknown>;
+    }): unknown;
+}
+/** `onError` para o `configure` que manda cada `RemoteError` ao Sentry. */
+declare function sentryOnError(sentry: SentryLike): (error: RemoteError) => void;
+
+export { type SentryLike, sentryOnError };

package/dist/sentry.js

@@ -0,0 +1,11 @@
+// src/sentry.ts
+function sentryOnError(sentry) {
+  return (error) => {
+    const tags = { "vitral.remote": error.remote, "vitral.code": error.code };
+    if (error.version) tags["vitral.version"] = error.version;
+    sentry.captureException(error, { tags, extra: { entry: error.entry, route: error.route, docs: error.docs } });
+  };
+}
+export {
+  sentryOnError
+};

package/dist/{shadow-MYRJQLLY.js → shadow-6HELCHCJ.js}

@@ -1,33 +1,56 @@
 import {
   fetchCssText,
   injectCss
-} from "./chunk-SFL6LTP3.js";
-import "./chunk-PX7PBCCT.js";
+} from "./chunk-ZAC6QQI6.js";
+import "./chunk-GNHCZRQP.js";
+import "./chunk-AKNNHQ2H.js";
 import "./chunk-GNPFWISJ.js";
 
 // src/core/shadow.ts
 var sheets = /* @__PURE__ */ new Map();
+var noop = () => {
+};
 var hoisted = /* @__PURE__ */ new Set();
 var RELATIVE_URL = /url\(\s*(['"]?)(?![a-z]+:|\/\/|#)([^'")]+)\1\s*\)/gi;
 var GLOBAL_RULES = /@property\s+(--[\w-]+)\s*\{[^}]*\}|@font-face\s*\{[^}]*\}|@import\s+(?:url\(\s*)?(?:(['"])(.*?)\2|([^'"\s);]+))\s*\)?[^;]*;/gi;
-async function attachStyles(root, el, css, global = {}, local = {}, sri = {}) {
+function plan({ css, shadow: s }) {
+  const at = (u) => new URL(u, css[0]).href;
+  const ready = s ? s.css.map(at) : [];
+  return [s ? [...(s.imports ?? []).map(at), ...ready, ...css.slice(ready.length)] : css, ready, (s?.global ?? []).map(at)];
+}
+function prefetch(r, priority) {
+  const [urls, , global] = plan(r);
+  for (const u of urls) fetchCssText(u, r.sri?.[u], priority).catch(noop);
+  injectCss(global, null, r.sri);
+}
+async function attachStyles(root, el, r, global = {}, local = {}) {
+  const sri = r.sri ?? {};
+  const [css, ready, up] = plan(r);
+  const portal = el.cloneNode();
+  portal.setAttribute("data-vitral-portal", "");
+  el.after(portal);
   const urls = [...global.inherit ?? [], ...local.inherit ?? []].map((u) => new URL(u, document.baseURI).href).concat(css);
+  const props = injectCss(up, null, sri);
   if (typeof CSSStyleSheet !== "undefined" && "replaceSync" in CSSStyleSheet.prototype) {
-    const loaded = await Promise.all(urls.map((u) => loadSheet(u, [], sri[u])));
+    const loaded = await Promise.all(urls.map((u) => loadSheet(u, [], sri[u], ready.includes(u) ? !!r.shadow.rebase : void 0)));
     root.adoptedStyleSheets = [.../* @__PURE__ */ new Set([...root.adoptedStyleSheets, ...loaded.flat()])];
   } else {
     await injectCss(urls, root, sri);
   }
-  return (local.mirrorTheme ?? global.mirrorTheme) === false ? () => {
-  } : mirrorTheme(el);
+  await props;
+  const stop = (local.mirrorTheme ?? global.mirrorTheme) === false ? [] : [mirrorTheme(el), mirrorTheme(portal)];
+  return [() => (stop.forEach((fn) => fn()), portal.remove()), portal];
 }
-function loadSheet(href, chain, integrity) {
+function loadSheet(href, chain, integrity, ready) {
   let p = sheets.get(href);
   if (!p) {
     p = fetchCssText(href, integrity).then((text) => {
+      const sheet = new CSSStyleSheet();
+      if (ready !== false) text = text.replace(RELATIVE_URL, (_, q, u) => `url(${q}${new URL(u, href).href}${q})`);
+      if (ready != null) return sheet.replaceSync(text), [sheet];
       const up = [];
       const imports = [];
-      const rest = text.replace(RELATIVE_URL, (_, q, u) => `url(${q}${new URL(u, href).href}${q})`).replace(GLOBAL_RULES, (rule, prop, _q, quoted, bare) => {
+      const rest = text.replace(GLOBAL_RULES, (rule, prop, _q, quoted, bare) => {
         const url = quoted ?? bare;
         if (url) imports.push(new URL(url, href).href);
         else if (!hoisted.has(prop ?? rule)) {
@@ -42,11 +65,13 @@ function loadSheet(href, chain, integrity) {
         style.textContent = up.join("\n");
         document.head.appendChild(style);
       }
-      const sheet = new CSSStyleSheet();
       sheet.replaceSync(rest);
       const next = [...chain, href];
       return Promise.all(imports.filter((u) => !next.includes(u)).map((u) => loadSheet(u, next))).then((found) => [...found.flat(), sheet]);
-    }).catch(() => []);
+    }).catch(() => {
+      sheets.delete(href);
+      return [];
+    });
     sheets.set(href, p);
   }
   return p;
@@ -68,5 +93,6 @@ function mirrorTheme(el) {
   return () => observer.disconnect();
 }
 export {
-  attachStyles
+  attachStyles,
+  prefetch
 };

package/dist/{slot-pB276oPt.d.ts → slot-DqXTwGbs.d.ts}

@@ -1,5 +1,5 @@
-import { R as RemoteError } from './errors-KKB8FGCz.js';
-import { P as Props, I as Isolation, b as StyleOptions } from './types-BV-hUrms.js';
+import { R as RemoteError } from './errors-kjBv6IH_.js';
+import { P as Props, I as Isolation, b as StyleOptions } from './types-Czvm-siZ.js';
 
 type SlotStatus = 'loading' | 'ready' | 'error';
 interface SlotOptions<P extends Props = Props> {

package/dist/solid.d.ts

@@ -1,8 +1,8 @@
 import { JSX, Component, Accessor } from 'solid-js';
-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';
-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';
+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/solid.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/solid.ts

package/dist/{sri-BVKZNX5Q.js → sri-JMX6JLQP.js}

@@ -1,12 +1,14 @@
 import {
   verifyIntegrity
-} from "./chunk-S5MZT5IT.js";
+} from "./chunk-AH7KNMBW.js";
 import {
-  RemoteError,
   addLink,
   fetchBytes,
   withTimeout
-} from "./chunk-PX7PBCCT.js";
+} from "./chunk-GNHCZRQP.js";
+import {
+  RemoteError
+} from "./chunk-AKNNHQ2H.js";
 import "./chunk-GNPFWISJ.js";
 
 // src/core/sri.ts
@@ -52,7 +54,7 @@ async function verified(build, run) {
   const p = globalThis[/* @__PURE__ */ Symbol.for("vitral")];
   const share = async (pre) => {
     if (!run || !dedupe.length) return;
-    const { shared } = await import("./dedupe-IWFIXRWG.js");
+    const { shared } = await import("./dedupe-S7BHQMOZ.js");
     for (const d of dedupe)
       shared(p)(d.name, d.range, {
         version: d.version,

package/dist/svelte.d.ts

@@ -1,9 +1,9 @@
 import { Component } from 'svelte';
-import { P as Props, I as Isolation, a as RemoteModule } 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, a as RemoteModule } 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/svelte.js

@@ -1,14 +1,15 @@
 import {
   hostSlot
-} from "./chunk-UTYAX6MU.js";
+} from "./chunk-IHTUM6LT.js";
 import {
   defineRemote,
   events,
   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/svelte.ts

package/dist/testing.d.ts

@@ -1,5 +1,6 @@
-import { P as Props, R as RemoteContext } from './types-BV-hUrms.js';
+import { P as Props, R as RemoteContext } from './types-Czvm-siZ.js';
 export { r as resetVitral } from './state-BDdCwc21.js';
+import './errors-kjBv6IH_.js';
 
 /**
  * Utilidades de teste: monte o host sem subir nenhum remote de verdade.

package/dist/testing.js

@@ -1,9 +1,10 @@
-import "./chunk-NCONW6WS.js";
+import "./chunk-I3VSKSAZ.js";
 import {
   register
-} from "./chunk-2XF5BKV3.js";
-import "./chunk-SFL6LTP3.js";
-import "./chunk-PX7PBCCT.js";
+} from "./chunk-TD4S3IHA.js";
+import "./chunk-ZAC6QQI6.js";
+import "./chunk-GNHCZRQP.js";
+import "./chunk-AKNNHQ2H.js";
 import {
   resetProtocol
 } from "./chunk-GNPFWISJ.js";

package/dist/{types-BV-hUrms.d.ts → types-Czvm-siZ.d.ts}

@@ -1,3 +1,5 @@
+import { R as RemoteError } from './errors-kjBv6IH_.js';
+
 /**
  * Tipos das chaves compartilhadas. Declare uma vez no projeto:
  *
@@ -90,6 +92,13 @@ interface RemoteContext {
     events: EventBus;
     /** Shadow root quando o host pediu isolamento, senão `null`. */
     shadowRoot: ShadowRoot | null;
+    /**
+     * Onde popovers, menus e dialogs devem ser renderizados (`container` do
+     * Radix e do MUI, `Teleport` do Vue). No Shadow DOM é um elemento dentro do
+     * shadow root, com os estilos e o tema do remote; senão, `document.body`.
+     * Hosts antigos não mandam este campo.
+     */
+    portalContainer?: HTMLElement;
     /** Avisa o host de um erro em tempo de execução (os adaptadores já chamam). */
     reportError(error: unknown): void;
     /** Navega a página inteira (host e todos os roteadores) para `url`. */
@@ -145,6 +154,11 @@ interface RemoteEntry {
      * no host.
      */
     manifest?: RemoteManifest;
+    /**
+     * Faixa de versão do contrato do remote que o host aceita (ex.: `'^2'`).
+     * Vence a de `configure`. Veja `VitralConfig.contract`.
+     */
+    contract?: string;
 }
 /**
  * `none`: CSS com escopo. `shadow`: Shadow DOM. `iframe`: iframe com
@@ -189,6 +203,18 @@ interface VitralConfig {
     styles?: StyleOptions;
     /** Recebe o tempo de cada etapa do carregamento (para RUM). */
     onMetric?: (metric: RemoteMetric) => void;
+    /**
+     * Recebe cada `RemoteError` de qualquer remote (falha de download, de
+     * `mount`, erro de render), uma vez só por erro, além do `onError` de cada
+     * montagem. Use para mandar os erros ao seu monitoramento.
+     */
+    onError?: (error: RemoteError) => void;
+    /**
+     * Atribui a um remote os erros sem tratamento (`error` e
+     * `unhandledrejection` da janela) cujo topo da pilha é um arquivo dele, e
+     * entrega como `RENDER_FAILED` ao `onError`. Padrão `false`.
+     */
+    captureGlobalErrors?: boolean;
     /**
      * Dependências que o host oferece aos remotes com `dedupe`, por grupo:
      * `{ vue: { version: Vue.version, modules: { vue: Vue } } }`. O remote usa
@@ -198,6 +224,14 @@ interface VitralConfig {
         version: string;
         modules: SharedModules;
     }>;
+    /**
+     * Faixa de versão do contrato que o host aceita dos remotes (ex.: `'^2'`).
+     * Antes de executar o remote, o host confere a versão do `contract` do
+     * manifesto e as dependências que ele espera do host; se não servir, o
+     * remote não monta (`CONTRACT_MISMATCH`). Sem contrato no manifesto, nada é
+     * conferido. `'*'` confere só as dependências.
+     */
+    contract?: string;
 }
 /** Módulos de um grupo de `dedupe`, por especificador (`'react-dom/client'`). */
 type SharedModules = Record<string, unknown>;
@@ -253,6 +287,34 @@ interface RemoteManifest {
         file: string;
         chunks?: string[];
     }[];
+    /** O que o remote declara para o host conferir antes de montar. */
+    contract?: RemoteContract;
+    /**
+     * CSS já preparado no build para o Shadow DOM. Sem este campo (manifestos
+     * antigos), o runtime faz esse trabalho em cada página.
+     */
+    shadow?: ShadowCss;
+}
+/** Contrato do remote no `vitral.json`. */
+interface RemoteContract {
+    /** Versão do contrato (opção `contract.version` do plugin). */
+    version?: string;
+    /** Faixa aceita de cada dependência de `dedupe`, por grupo (`{ react: '^19.0.0' }`). */
+    peers?: Record<string, string>;
+}
+/**
+ * CSS do remote preparado no build para `isolate: 'shadow'`. Os caminhos são
+ * relativos ao primeiro arquivo de `css` (o plugin grava tudo na mesma pasta).
+ */
+interface ShadowCss {
+    /** Cada arquivo de `css`, na mesma ordem, sem `@import`, `@property` e `@font-face`. */
+    css: string[];
+    /** `@property` e `@font-face`, que só valem no documento (vão num `<link>`). */
+    global?: string[];
+    /** `@import` que o build não embutiu (outra origem), adotados antes de `css`. */
+    imports?: string[];
+    /** O CSS ainda tem `url()` relativa, que precisa apontar para o remote. */
+    rebase?: boolean;
 }
 type Handler<T = unknown> = (payload: T) => void;
 interface EventBus {
@@ -262,4 +324,4 @@ interface EventBus {
     last<T = unknown>(type: string): T | undefined;
 }
 
-export { type CheckedProps as C, type EventBus as E, type Handler as H, type Isolation as I, type MountedRemote as M, type Props as P, type RemoteContext as R, type Shared as S, type VitralConfig as V, type RemoteModule as a, type StyleOptions as b, type RemoteEntry as c, type SharedValue as d, type PropsOf as e, type ProvideOptions as f, type ProvidedValue as g, type RemoteManifest as h, type RemoteMetric as i, type Remotes as j, type SharedApi as k, type SharedModules as l, type SharedType as m, batch as n, provide as p, shared as s };
+export { type CheckedProps as C, type EventBus as E, type Handler as H, type Isolation as I, type MountedRemote as M, type Props as P, type RemoteContext as R, type Shared as S, type VitralConfig as V, type RemoteModule as a, type StyleOptions as b, type RemoteEntry as c, type SharedValue as d, type PropsOf as e, type ProvideOptions as f, type ProvidedValue as g, type RemoteContract as h, type RemoteManifest as i, type RemoteMetric as j, type Remotes as k, type SharedApi as l, type SharedModules as m, type SharedType as n, batch as o, provide as p, shared as s };

package/dist/vite.d.ts

@@ -72,6 +72,14 @@ interface VitralViteOptions extends CssBuildOptions {
      * projeto e de entrada .ts/.tsx/.js/.jsx. Padrão: true.
      */
     types?: boolean;
+    /**
+     * Contrato publicado no `vitral.json`. O host que declara
+     * `contract: '^2'` só monta o remote se `version` estiver na faixa. As
+     * faixas de `dedupe` entram sozinhas, em `peers`. Padrão: sem versão.
+     */
+    contract?: {
+        version?: string;
+    };
 }
 declare function vitral(options?: VitralViteOptions): Plugin;