vitral 0.1.0 → 0.2.0

package/dist/vite.d.ts

@@ -1,8 +1,40 @@
 import { Plugin } from 'vite';
 
-interface VitralViteOptions {
-    /** Arquivo que exporta o remote (default export de reactRemote/vueRemote/defineRemote). */
-    entry: string;
+interface CssBuildOptions {
+    /**
+     * `'host'`: as variáveis globais do remote (`:root`, `:host`) viram só
+     * fallback. O remote usa o valor do host quando ele existe e o próprio
+     * quando não existe. Para quem não tem um pacote de tokens compartilhado.
+     */
+    theme?: 'host';
+    /**
+     * `'flatten'`: tira os `@layer` do CSS do remote mantendo a ordem. Use quando
+     * o host tem CSS sem camada (Tailwind v3, CSS legado), que no modo escopo
+     * venceria todo o CSS em camada do remote.
+     */
+    layers?: 'flatten';
+    /**
+     * Renomeia as propriedades `--tw-*` registradas com `@property` para
+     * `--tw-<escopo>-*`. Use quando o host tem Tailwind v3 e o remote, v4:
+     * sem isso os gradientes do host quebram.
+     */
+    renameRegisteredProperties?: boolean;
+}
+
+type AdapterName = 'react' | 'vue' | 'svelte' | 'solid' | 'preact' | 'angular' | 'element';
+
+interface VitralViteOptions extends CssBuildOptions {
+    /**
+     * Arquivo cujo `export default` é o remote: um componente do framework ou
+     * um objeto com `mount`. Padrão: `src/remote.*` ou `src/App.*`.
+     */
+    entry?: string;
+    /**
+     * Adaptador que embrulha o `export default`. Padrão: descoberto pelos
+     * plugins do Vite (React, Vue, Svelte, Solid, Preact, Angular; sem nenhum,
+     * Web Component ou função). `false` usa o export como está.
+     */
+    adapter?: AdapterName | false;
     /** Nome do remote no manifesto. Padrão: `name` do package.json. */
     name?: string;
     /** Versão no manifesto. Padrão: `version` do package.json. */
@@ -11,6 +43,7 @@ interface VitralViteOptions {
      * Dependências que NÃO entram no bundle e vêm do import map do host
      * (ex.: ['react', 'react-dom', 'react-dom/client']). Padrão: nenhuma, cada
      * remote leva suas dependências e nunca há conflito de versão.
+     * @deprecated Use `dedupe`, que cai na própria cópia se a versão não servir.
      */
     shared?: string[];
     /**
@@ -18,7 +51,28 @@ interface VitralViteOptions {
      * preflight/tema do Tailwind). Padrão: true.
      */
     scopeCss?: boolean;
+    /**
+     * Outros componentes e módulos do remote, por nome. O host usa
+     * `carrinho/MiniCarrinho` ou `loadModule('carrinho/api')`.
+     *
+     *   exposes: { './MiniCarrinho': 'src/MiniCarrinho.tsx', './api': 'src/api.ts' }
+     *
+     * Um componente exporta `default` com `mount` (`reactRemote(Mini)` etc.).
+     */
+    exposes?: Record<string, string>;
+    /**
+     * Dependências que o remote usa da página, se a versão servir (padrão: `^`
+     * da versão instalada), ou da própria cópia. Ex.: `['react']` (o grupo do
+     * React inteiro) ou `['vue']`.
+     */
+    dedupe?: string[];
+    /**
+     * Publica `vitral.d.ts` com o tipo das props do `export default`, para o
+     * host checar as props (`npx vitral types`). Precisa de TypeScript no
+     * projeto e de entrada .ts/.tsx/.js/.jsx. Padrão: true.
+     */
+    types?: boolean;
 }
-declare function vitral(options: VitralViteOptions): Plugin;
+declare function vitral(options?: VitralViteOptions): Plugin;
 
 export { type VitralViteOptions, vitral as default, vitral };