vobi_document 1.0.1 → 1.1.0

package/README.md

@@ -17,11 +17,11 @@ Montar documentos num app de gestão normalmente vira três implementações que
 ## Principais recursos
 
 - **Editor visual** — drag-and-drop de blocos, painel de estrutura (outline), bloqueio de blocos por permissão, header customizável via render-prop.
-- **Blocos prontos** — texto, botão, divisor, quebra de página, imagem, grade de imagens, orçamento, tabela, ícone + texto, imagem + texto e duas colunas (`defaultBlocks`).
+- **Blocos prontos** — 14 blocos genéricos em `defaultBlocks`: texto, título, lista, destaque, botão, divisor, espaço, imagem, grade de imagens, duas colunas, imagem + texto, ícone + texto, tabela e quebra de página. Todos com `propsSchema` e com as variáveis já resolvidas.
 - **Blocos customizados** — o host cria os seus com `defineBlock` e registra no mesmo registry; entradas posteriores sobrescrevem por `key`.
 - **Tema** — cores (brand/texto/fundo), fonte (allow-list Google Fonts), logo, formato e margens de página, tudo validado por Zod (`themeSchema`) e aplicado via CSS vars no `PageFrame`.
 - **Variáveis dinâmicas** — chips no texto (`<span class="dg-var" data-var-key="customer.name">`) resolvidos a partir de um catálogo + resolver fornecidos pelo host; valores formatados em pt-BR; suporte a variáveis não resolvidas com placeholder ou label.
-- **Paginação para impressão** — `buildDocumentHtml` gera HTML paginado com Paged.js embarcado: capa (`coverBlockKey`), header/footer com dados da empresa, repetição de cabeçalho de tabela entre páginas e blocos protegidos de corte (`noCutBlockKeys`).
+- **Paginação para impressão** — `buildDocumentHtml` (em `vobi_document/print`) gera HTML paginado com Paged.js embarcado: capa (`coverBlockKey`), header/footer com dados da empresa, repetição de cabeçalho de tabela entre páginas e blocos protegidos de corte (`noCutBlockKeys`).
 - **Schemas Zod** — `parseDocument` / `safeParseDocument` validam o documento completo antes de persistir ou renderizar.
 - **Autosave** — `useDocumentAutosave` com debounce para persistência incremental no host.
 
@@ -31,13 +31,13 @@ Montar documentos num app de gestão normalmente vira três implementações que
 pnpm add vobi_document
 ```
 
-Peer dependencies (o host deve declarar as quatro — precisam ser instância única compartilhada com a lib):
+Peer dependencies (o host deve declarar as cinco — precisam ser instância única compartilhada com a lib):
 
 ```bash
-pnpm add react react-dom styled-components @puckeditor/core
+pnpm add react react-dom styled-components @puckeditor/core zod
 ```
 
-> Duas cópias de `@puckeditor/core` ou `styled-components` não geram erro de versão — falham silenciosamente (contexto errado no `usePuck`, estilos ausentes no HTML publicado). Detalhes em `docs/build-and-consume.md`.
+> Duas cópias de `@puckeditor/core`, `styled-components` ou `zod` não geram erro de versão — falham silenciosamente (contexto errado no `usePuck`, estilos ausentes no HTML publicado, `instanceof ZodError` falso). Detalhes em `docs/build-and-consume.md`.
 
 ## Uso básico
 
@@ -71,12 +71,29 @@ const registry = [...defaultBlocks, meuBlocoCustomizado];
 />
 ```
 
-Primitivas do Puck ficam no subpath dedicado, fora do barrel principal:
+### Entry points
+
+O barrel principal traz tudo que roda no browser. As camadas também têm subpath próprio, para import granular:
+
+| Subpath | Contém |
+|---------|--------|
+| `vobi_document` | core + reexport de blocks/editor/render/variables |
+| `vobi_document/blocks` | `defineBlock`, `defaultBlocks`, `ContentIcon` |
+| `vobi_document/editor` | `DocumentEditor`, settings, color picker, autosave |
+| `vobi_document/render` | `DocumentRenderer`, capa, header/footer |
+| `vobi_document/print` | `buildDocumentHtml`, `buildPageCss` — **não sai do barrel** |
+| `vobi_document/variables` | catálogo, resolver, chips |
+| `vobi_document/puck` | primitivas cruas do Puck |
 
 ```ts
+import { buildDocumentHtml } from 'vobi_document/print';  // servidor / preview
 import { Puck, Render, usePuck } from 'vobi_document/puck';
 ```
 
+`./print` fica fora do barrel porque carrega o Paged.js embutido (~513kb) e `react-dom/server` — um
+host que só monta editor ou viewer não deve arriscar carregá-los. Isso derrubou o barrel de 631kb para
+131kb e o `index.d.ts` de 387kb para 9,3kb. Migração de 1.0.x em `docs/build-and-consume.md`.
+
 ## Desenvolvimento
 
 Requer Node >= 20 e **pnpm** (nunca npm/yarn).

package/dist/blocks.cjs

@@ -0,0 +1,100 @@
+'use strict';
+
+var chunkMHTTFNK2_cjs = require('./chunk-MHTTFNK2.cjs');
+require('./chunk-L5FXGEKX.cjs');
+require('./chunk-LNBAFOVK.cjs');
+require('./chunk-KUB3TYG2.cjs');
+require('./chunk-IRFFN74K.cjs');
+
+
+
+Object.defineProperty(exports, "ButtonBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.ButtonBlock; }
+});
+Object.defineProperty(exports, "CONTENT_ICON_CATALOG", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.CONTENT_ICON_CATALOG; }
+});
+Object.defineProperty(exports, "CONTENT_ICON_NAMES", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.CONTENT_ICON_NAMES; }
+});
+Object.defineProperty(exports, "ContentIcon", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.ContentIcon; }
+});
+Object.defineProperty(exports, "DividerBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.DividerBlock; }
+});
+Object.defineProperty(exports, "HeadingBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.HeadingBlock; }
+});
+Object.defineProperty(exports, "IconTextBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.IconTextBlock; }
+});
+Object.defineProperty(exports, "ImageBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.ImageBlock; }
+});
+Object.defineProperty(exports, "ImageGridBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.ImageGridBlock; }
+});
+Object.defineProperty(exports, "ImageTextBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.ImageTextBlock; }
+});
+Object.defineProperty(exports, "ListBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.ListBlock; }
+});
+Object.defineProperty(exports, "PageBreakBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.PageBreakBlock; }
+});
+Object.defineProperty(exports, "QuoteBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.QuoteBlock; }
+});
+Object.defineProperty(exports, "RichText", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.RichText; }
+});
+Object.defineProperty(exports, "SpacerBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.SpacerBlock; }
+});
+Object.defineProperty(exports, "TableBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.TableBlock; }
+});
+Object.defineProperty(exports, "TextBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.TextBlock; }
+});
+Object.defineProperty(exports, "TwoColumnsBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.TwoColumnsBlock; }
+});
+Object.defineProperty(exports, "blocksByKey", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.blocksByKey; }
+});
+Object.defineProperty(exports, "defaultBlocks", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.defaultBlocks; }
+});
+Object.defineProperty(exports, "defineBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.defineBlock; }
+});
+Object.defineProperty(exports, "overrideBlock", {
+  enumerable: true,
+  get: function () { return chunkMHTTFNK2_cjs.overrideBlock; }
+});
+//# sourceMappingURL=blocks.cjs.map
+//# sourceMappingURL=blocks.cjs.map

package/dist/blocks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"blocks.cjs"}

package/dist/blocks.d.cts

@@ -0,0 +1,201 @@
+import { B as BlockEntry, R as Registry } from './types-CvKSS1Sy.cjs';
+export { D as DocumentConfig } from './types-CvKSS1Sy.cjs';
+import * as react from 'react';
+import { ElementType, CSSProperties } from 'react';
+import { Slot } from '@puckeditor/core';
+import 'zod';
+
+/** Helper tipado para declarar um bloco (`fields`/`defaultProps` alinhados às props). */
+declare function defineBlock<Props extends Record<string, unknown>>(entry: BlockEntry<Props>): BlockEntry<Props>;
+
+/**
+ * Deriva um bloco a partir de um default da lib: herda a entry inteira e aplica `patch`
+ * por cima.
+ *
+ * ```ts
+ * const MeuTexto = overrideBlock('Text', { component: MeuRichText });
+ * const Copia = overrideBlock('Text', { key: 'TextoLegal' }); // clona sob outra key
+ * ```
+ *
+ * `key` desconhecida avisa em dev e devolve a entry só com o `patch` — para bloco que é
+ * só do host, use `defineBlock`, que não promete herança nenhuma.
+ */
+declare function overrideBlock<Props extends Record<string, unknown> = Record<string, unknown>>(key: string, patch?: Partial<BlockEntry<Props>>): BlockEntry<Props>;
+
+type TextBlockProps = {
+    content: string;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const TextBlock: BlockEntry<TextBlockProps>;
+
+type HeadingBlockProps = {
+    text: string;
+    level: 1 | 2 | 3 | 4;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const HeadingBlock: BlockEntry<HeadingBlockProps>;
+
+type ListItem = {
+    text: string;
+};
+type ListBlockProps = {
+    items: ListItem[];
+    ordered: boolean;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const ListBlock: BlockEntry<ListBlockProps>;
+
+type QuoteBlockProps = {
+    content: string;
+    author?: string;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const QuoteBlock: BlockEntry<QuoteBlockProps>;
+
+type ButtonBlockProps = {
+    text: string;
+    href: string;
+};
+declare const ButtonBlock: BlockEntry<ButtonBlockProps>;
+
+type DividerBlockProps = {
+    variant: 'solid' | 'dashed' | 'dotted';
+    spacing: 'none' | 'small' | 'medium' | 'large';
+};
+declare const DividerBlock: BlockEntry<DividerBlockProps>;
+
+type SpacerBlockProps = {
+    height: number;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const SpacerBlock: BlockEntry<SpacerBlockProps>;
+
+type ImageBlockProps = {
+    src: string;
+    alt: string;
+    caption?: string;
+    size: 'small' | 'medium' | 'large';
+    opacity: number;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const ImageBlock: BlockEntry<ImageBlockProps>;
+
+type GridImage = {
+    src: string;
+    alt?: string;
+};
+type ImageGridBlockProps = {
+    images: GridImage[];
+    columns: number;
+    gap: 'none' | 'small' | 'medium' | 'large';
+    ratio: 'square' | 'landscape' | 'portrait' | 'auto';
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const ImageGridBlock: BlockEntry<ImageGridBlockProps>;
+
+type TwoColumnsBlockProps = {
+    left: Slot;
+    right: Slot;
+    ratio: number;
+    gap: 'none' | 'small' | 'medium' | 'large';
+    align: 'start' | 'center';
+};
+declare const TwoColumnsBlock: BlockEntry<TwoColumnsBlockProps>;
+
+type ImageTextBlockProps = {
+    image: Slot;
+    text: Slot;
+    ratio: number;
+    imageRight: boolean;
+    gap: 'none' | 'small' | 'medium' | 'large';
+};
+declare const ImageTextBlock: BlockEntry<ImageTextBlockProps>;
+
+type IconTextBlockProps = {
+    icon: string;
+    content: string;
+    iconSize: number;
+    iconRight: boolean;
+    gap: 'none' | 'small' | 'medium' | 'large';
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const IconTextBlock: BlockEntry<IconTextBlockProps>;
+
+type TableCell = {
+    value: string;
+};
+type TableRow = {
+    cells: TableCell[];
+};
+type TableBlockProps = {
+    rows: TableRow[];
+    headerRow: boolean;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const TableBlock: BlockEntry<TableBlockProps>;
+
+type PageBreakBlockProps = {
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const PageBreakBlock: BlockEntry<PageBreakBlockProps>;
+
+declare const defaultBlocks: Registry;
+declare const blocksByKey: Record<string, BlockEntry>;
+
+type RichTextProps = {
+    html?: string;
+    editing?: boolean;
+    as?: ElementType;
+    className?: string;
+};
+declare function RichText({ html, editing, as, className }: RichTextProps): react.JSX.Element;
+
+type ContentIconDef = {
+    label: string;
+    group: string;
+    viewBox: string;
+    inner: string;
+    variant?: 'fill' | 'stroke';
+};
+/**
+ * SVG inline com width/height explícitos: o HTML do documento (iframe, link público, PDF)
+ * não carrega CSS global nenhum, e sem dimensão o svg cai no default 300x150.
+ *
+ * As `key`s são contrato de dado — ficam gravadas em `appearance.icon` no documento.
+ * Renomear uma exige migração; trocar o desenho, não.
+ */
+declare const CONTENT_ICON_CATALOG: Record<string, ContentIconDef>;
+declare const CONTENT_ICON_NAMES: string[];
+type ContentIconProps = {
+    name?: string;
+    /** Aceita número (px) ou qualquer unidade CSS. Default `1em` — acompanha o font-size do contexto. */
+    size?: number | string;
+    color?: string;
+    /** Espessura do traço, em unidades do viewBox (24). Ignorado por ícone preenchido. */
+    strokeWidth?: number;
+    style?: CSSProperties;
+    className?: string;
+};
+declare function ContentIcon({ name, size, color, strokeWidth, style, className }: ContentIconProps): react.JSX.Element | null;
+
+export { BlockEntry, ButtonBlock, CONTENT_ICON_CATALOG, CONTENT_ICON_NAMES, ContentIcon, type ContentIconDef, type ContentIconProps, DividerBlock, HeadingBlock, IconTextBlock, ImageBlock, ImageGridBlock, ImageTextBlock, ListBlock, PageBreakBlock, QuoteBlock, Registry, RichText, type RichTextProps, SpacerBlock, TableBlock, TextBlock, TwoColumnsBlock, blocksByKey, defaultBlocks, defineBlock, overrideBlock };

package/dist/blocks.d.ts

@@ -0,0 +1,201 @@
+import { B as BlockEntry, R as Registry } from './types-CvKSS1Sy.js';
+export { D as DocumentConfig } from './types-CvKSS1Sy.js';
+import * as react from 'react';
+import { ElementType, CSSProperties } from 'react';
+import { Slot } from '@puckeditor/core';
+import 'zod';
+
+/** Helper tipado para declarar um bloco (`fields`/`defaultProps` alinhados às props). */
+declare function defineBlock<Props extends Record<string, unknown>>(entry: BlockEntry<Props>): BlockEntry<Props>;
+
+/**
+ * Deriva um bloco a partir de um default da lib: herda a entry inteira e aplica `patch`
+ * por cima.
+ *
+ * ```ts
+ * const MeuTexto = overrideBlock('Text', { component: MeuRichText });
+ * const Copia = overrideBlock('Text', { key: 'TextoLegal' }); // clona sob outra key
+ * ```
+ *
+ * `key` desconhecida avisa em dev e devolve a entry só com o `patch` — para bloco que é
+ * só do host, use `defineBlock`, que não promete herança nenhuma.
+ */
+declare function overrideBlock<Props extends Record<string, unknown> = Record<string, unknown>>(key: string, patch?: Partial<BlockEntry<Props>>): BlockEntry<Props>;
+
+type TextBlockProps = {
+    content: string;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const TextBlock: BlockEntry<TextBlockProps>;
+
+type HeadingBlockProps = {
+    text: string;
+    level: 1 | 2 | 3 | 4;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const HeadingBlock: BlockEntry<HeadingBlockProps>;
+
+type ListItem = {
+    text: string;
+};
+type ListBlockProps = {
+    items: ListItem[];
+    ordered: boolean;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const ListBlock: BlockEntry<ListBlockProps>;
+
+type QuoteBlockProps = {
+    content: string;
+    author?: string;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const QuoteBlock: BlockEntry<QuoteBlockProps>;
+
+type ButtonBlockProps = {
+    text: string;
+    href: string;
+};
+declare const ButtonBlock: BlockEntry<ButtonBlockProps>;
+
+type DividerBlockProps = {
+    variant: 'solid' | 'dashed' | 'dotted';
+    spacing: 'none' | 'small' | 'medium' | 'large';
+};
+declare const DividerBlock: BlockEntry<DividerBlockProps>;
+
+type SpacerBlockProps = {
+    height: number;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const SpacerBlock: BlockEntry<SpacerBlockProps>;
+
+type ImageBlockProps = {
+    src: string;
+    alt: string;
+    caption?: string;
+    size: 'small' | 'medium' | 'large';
+    opacity: number;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const ImageBlock: BlockEntry<ImageBlockProps>;
+
+type GridImage = {
+    src: string;
+    alt?: string;
+};
+type ImageGridBlockProps = {
+    images: GridImage[];
+    columns: number;
+    gap: 'none' | 'small' | 'medium' | 'large';
+    ratio: 'square' | 'landscape' | 'portrait' | 'auto';
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const ImageGridBlock: BlockEntry<ImageGridBlockProps>;
+
+type TwoColumnsBlockProps = {
+    left: Slot;
+    right: Slot;
+    ratio: number;
+    gap: 'none' | 'small' | 'medium' | 'large';
+    align: 'start' | 'center';
+};
+declare const TwoColumnsBlock: BlockEntry<TwoColumnsBlockProps>;
+
+type ImageTextBlockProps = {
+    image: Slot;
+    text: Slot;
+    ratio: number;
+    imageRight: boolean;
+    gap: 'none' | 'small' | 'medium' | 'large';
+};
+declare const ImageTextBlock: BlockEntry<ImageTextBlockProps>;
+
+type IconTextBlockProps = {
+    icon: string;
+    content: string;
+    iconSize: number;
+    iconRight: boolean;
+    gap: 'none' | 'small' | 'medium' | 'large';
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const IconTextBlock: BlockEntry<IconTextBlockProps>;
+
+type TableCell = {
+    value: string;
+};
+type TableRow = {
+    cells: TableCell[];
+};
+type TableBlockProps = {
+    rows: TableRow[];
+    headerRow: boolean;
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const TableBlock: BlockEntry<TableBlockProps>;
+
+type PageBreakBlockProps = {
+    puck?: {
+        isEditing?: boolean;
+    };
+};
+declare const PageBreakBlock: BlockEntry<PageBreakBlockProps>;
+
+declare const defaultBlocks: Registry;
+declare const blocksByKey: Record<string, BlockEntry>;
+
+type RichTextProps = {
+    html?: string;
+    editing?: boolean;
+    as?: ElementType;
+    className?: string;
+};
+declare function RichText({ html, editing, as, className }: RichTextProps): react.JSX.Element;
+
+type ContentIconDef = {
+    label: string;
+    group: string;
+    viewBox: string;
+    inner: string;
+    variant?: 'fill' | 'stroke';
+};
+/**
+ * SVG inline com width/height explícitos: o HTML do documento (iframe, link público, PDF)
+ * não carrega CSS global nenhum, e sem dimensão o svg cai no default 300x150.
+ *
+ * As `key`s são contrato de dado — ficam gravadas em `appearance.icon` no documento.
+ * Renomear uma exige migração; trocar o desenho, não.
+ */
+declare const CONTENT_ICON_CATALOG: Record<string, ContentIconDef>;
+declare const CONTENT_ICON_NAMES: string[];
+type ContentIconProps = {
+    name?: string;
+    /** Aceita número (px) ou qualquer unidade CSS. Default `1em` — acompanha o font-size do contexto. */
+    size?: number | string;
+    color?: string;
+    /** Espessura do traço, em unidades do viewBox (24). Ignorado por ícone preenchido. */
+    strokeWidth?: number;
+    style?: CSSProperties;
+    className?: string;
+};
+declare function ContentIcon({ name, size, color, strokeWidth, style, className }: ContentIconProps): react.JSX.Element | null;
+
+export { BlockEntry, ButtonBlock, CONTENT_ICON_CATALOG, CONTENT_ICON_NAMES, ContentIcon, type ContentIconDef, type ContentIconProps, DividerBlock, HeadingBlock, IconTextBlock, ImageBlock, ImageGridBlock, ImageTextBlock, ListBlock, PageBreakBlock, QuoteBlock, Registry, RichText, type RichTextProps, SpacerBlock, TableBlock, TextBlock, TwoColumnsBlock, blocksByKey, defaultBlocks, defineBlock, overrideBlock };

package/dist/blocks.js

@@ -0,0 +1,7 @@
+export { ButtonBlock, CONTENT_ICON_CATALOG, CONTENT_ICON_NAMES, ContentIcon, DividerBlock, HeadingBlock, IconTextBlock, ImageBlock, ImageGridBlock, ImageTextBlock, ListBlock, PageBreakBlock, QuoteBlock, RichText, SpacerBlock, TableBlock, TextBlock, TwoColumnsBlock, blocksByKey, defaultBlocks, defineBlock, overrideBlock } from './chunk-IUDN2CGP.js';
+import './chunk-QYBWIJXZ.js';
+import './chunk-ZOJBDFKU.js';
+import './chunk-JEVWEGSE.js';
+import './chunk-M2TPAU2F.js';
+//# sourceMappingURL=blocks.js.map
+//# sourceMappingURL=blocks.js.map

package/dist/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"blocks.js"}

package/dist/catalogContext-DenbX-OW.d.cts

@@ -0,0 +1,15 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { V as VariableDef } from './types-BgIugNWW.cjs';
+
+/** Mapa model → label amigável pt-BR (ex: `{ customer: 'Cliente' }`). */
+type Translator = Record<string, string>;
+declare function CatalogProvider({ catalog, translator, children }: {
+    catalog?: VariableDef[];
+    translator?: Translator;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useCatalog(): VariableDef[];
+declare function useTranslator(): Translator;
+
+export { CatalogProvider as C, type Translator as T, useTranslator as a, useCatalog as u };

package/dist/catalogContext-HGMU-w_4.d.ts

@@ -0,0 +1,15 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { V as VariableDef } from './types-BgIugNWW.js';
+
+/** Mapa model → label amigável pt-BR (ex: `{ customer: 'Cliente' }`). */
+type Translator = Record<string, string>;
+declare function CatalogProvider({ catalog, translator, children }: {
+    catalog?: VariableDef[];
+    translator?: Translator;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useCatalog(): VariableDef[];
+declare function useTranslator(): Translator;
+
+export { CatalogProvider as C, type Translator as T, useTranslator as a, useCatalog as u };