@seedgrid/ai-toolkit 0.3.0 → 0.3.2

package/seedgridKB/SeedGrid/SeedGrid-components/editor/API.md

@@ -1,17 +1,17 @@
----
-tags: [seedgrid, component, frontend, react, editor, tiptap, api]
-fonte: front/seedgrid-fe-components/packages/seedgrid-fe-components/src/inputs/SgTextEditor.tsx
-branch: main
-commit: ad30fc11de
-analisado-em: 2026-10-14
----
-
-# SgTextEditor: API
-
-Import: `import { SgTextEditor, type SgTextEditorProps, type SgTextEditorSaveMeta } from "@seedgrid/fe-components";` (pacote v`2026.7.1`). Contexto: [[SeedGrid/SeedGrid-components/editor/Visao-geral|Visão geral do SgTextEditor]]. Exemplos: [[SeedGrid/SeedGrid-components/editor/Exemplos|Exemplos do SgTextEditor]]. A metodologia da tabela está em [[SeedGrid/SeedGrid-components/inputs-texto/API#Como as tabelas foram montadas|Como as tabelas foram montadas]]. As props RHF seguem o [[SeedGrid/SeedGrid-components/inputs-texto/API#Contrato RhfFieldProps (react-hook-form)|contrato RhfFieldProps]], com o desvio indicado na própria tabela.
-
-## Props (21)
-
+---
+tags: [seedgrid, component, frontend, react, editor, tiptap, api]
+fonte: front/seedgrid-fe-components/packages/seedgrid-fe-components/src/inputs/SgTextEditor.tsx
+branch: main
+commit: ad30fc11de
+analisado-em: 2026-10-14
+---
+
+# SgTextEditor: API
+
+Import: `import { SgTextEditor, type SgTextEditorProps, type SgTextEditorSaveMeta } from "@seedgrid/fe-components";` (pacote v`2026.7.1`). Contexto: [[SeedGrid/SeedGrid-components/editor/Visao-geral|Visão geral do SgTextEditor]]. Exemplos: [[SeedGrid/SeedGrid-components/editor/Exemplos|Exemplos do SgTextEditor]]. A metodologia da tabela está em [[SeedGrid/SeedGrid-components/inputs-texto/API#Como as tabelas foram montadas|Como as tabelas foram montadas]]. As props RHF seguem o [[SeedGrid/SeedGrid-components/inputs-texto/API#Contrato RhfFieldProps (react-hook-form)|contrato RhfFieldProps]], com o desvio indicado na própria tabela.
+
+## Props (21)
+
 | Prop | Tipo | Padrão | Obrigatória | Descrição |
 |---|---|---|---|---|
 | `error` | `string` | — | Não | Erro abaixo do editor. |
@@ -34,92 +34,92 @@ Import: `import { SgTextEditor, type SgTextEditorProps, type SgTextEditorSaveMet
 | `style` | `CSSProperties` | — | Não | Estilo do wrapper. |
 | `name` | `string` | — | Não | Nome do campo no react-hook-form. Só tem efeito junto com `control` ou `register` (ver contrato RHF). |
 | `control` | `any` | — | Não | `Control` do `useForm()`; com `name`, envolve o componente em `<Controller>`. |
-| `rules` | `RegisterOptions<any>` | — | Não | Regras de validação do RHF (`RegisterOptions`). |
-
-## Tipos exportados
-
-| Tipo | Forma |
-|---|---|
-| `SgTextEditorProps` | Tabela acima. |
-| `SgTextEditorSaveMeta` | `{ htmlDocument: string; contentHtml: string; cssText: string }` |
-
-## Eventos e formatos de retorno
-
-- **`onChangeHtml(htmlBody)`:**
-  - Disparado no `onUpdate` do TipTap com `editor.getHTML()`.
-  - Entrega **só o HTML do corpo**, por exemplo `"<p><strong>SeedGrid</strong> editor</p>"`, sem `<html>`/`<style>`.
-- **`onSave(file, meta)`:** acionado pelo botão "Salvar" da toolbar (i18n `components.actions.save`).
-  - `file` é um `File` `text/html;charset=utf-8`, com nome `fileName ?? "<id>.html"`.
-  - O conteúdo é um documento completo: `<!doctype html>`, `<html lang="<locale do i18n>">`, `<meta charset>`, `<meta viewport>`, `<style>` com o `cssText` (se houver) e `<body>` com o HTML.
-  - `meta` traz o mesmo documento como string (`htmlDocument`), além de `contentHtml` e `cssText`.
-- **`onLoad(meta)`:** o botão "Carregar HTML" (i18n `components.actions.loadHtml`) abre um `<input type="file" accept="text/html,.html">`. O componente então:
-  1. lê o arquivo;
-  2. extrai o CSS de `head style` e o `body`;
-  3. troca o conteúdo do editor;
-  4. chama `onCssTextChange` se o CSS mudou;
-  5. chama `onLoad`.
-- **`onCssTextChange(css)`:** chamado pela textarea de CSS (`showCssEditor`) e no carregamento de arquivo.
-
-**Confirmado** (`buildFullHtmlDocument`, `parseHtmlDocument`, `doSave`, `loadFromHtmlString`).
-
-## Controlado e não controlado
-
-- **Controlado:** quando `valueHtml` é `string`. Se o HTML do editor divergir de `valueHtml`, o componente chama `setContent(valueHtml)`.
-- **Não controlado:** o conteúdo inicial vem de `defaultValueHtml`.
-- **`cssText`:** é sempre lido da prop. Sem `onCssTextChange`, a textarea de CSS não altera nada.
-
-**Confirmado**.
-
-## Integração react-hook-form
-
-- **Integração:** via `control` + `name` (`<Controller>`). O valor do campo é o HTML do corpo (`field.value` string → `valueHtml`; `onChangeHtml` → `field.onChange`).
-- Nesse caminho, o `onChangeHtml` do usuário é substituído por `field.onChange`.
-- `rules` são repassadas sem `mergeRequiredRule` (o tipo não tem `required`).
-
-Teste de contrato: `tests/rhf-components-contract.test.mjs` ("SgTextEditor preserves control integration path"). **Confirmado**.
-
-## Ref
-
-O componente não usa `forwardRef` e não expõe a instância do TipTap (`Editor`). **Confirmado**.
-
-## Toolbar e extensões TipTap
-
-| Recurso | Implementação (`useEditor`) |
-|---|---|
-| Parágrafo/títulos H1, H2, H3 | `StarterKit` (`codeBlock` habilitado) + `<select>` |
-| Fonte (Arial, Georgia, Times, Courier) | `@tiptap/extension-font-family` |
-| Tamanho da fonte | `TextStyle` estendido com o atributo `fontSize` (`TextStyleWithSize`) |
-| Negrito, itálico, sublinhado, tachado | `StarterKit` + `@tiptap/extension-underline` |
-| Cor do texto e realce multicolor | `@tiptap/extension-color`, `@tiptap/extension-highlight` (`multicolor: true`) |
-| Sub/sobrescrito | `@tiptap/extension-subscript`, `@tiptap/extension-superscript` |
-| Listas, recuo e avanço | `StarterKit` |
-| Alinhamento (esquerda, centro, direita, justificado) | `@tiptap/extension-text-align` (`types: ["heading", "paragraph"]`) |
-| Link | `@tiptap/extension-link` (`openOnClick: false`, `autolink`, `linkOnPaste`) via `window.prompt` |
-| Imagem por URL | `@tiptap/extension-image` (`inline: false`) via `window.prompt` |
-| Limpar formatação | `unsetAllMarks().clearNodes()` |
-
-O editor é criado com `immediatelyRender: false` (seguro para SSR) e `editable: !disabled`. **Confirmado**.
-
-## Internacionalização
-
-As chaves usadas são:
-- `components.textEditor.placeholder`, `cssEditorLabel`, `editorAriaLabel`, `help.cssEmbedded`;
-- `components.textEditor.prompt.url` e `prompt.imageUrl`;
-- `components.textEditor.toolbar.*`: `heading`, `subheading`, `normal`, `heading3`, `defaultFont`, `bold`, `italic`, `underline`, `strike`, `textColor`, `highlightColor`, `bullets`, `numbered`, `indent`, `outdent`, `alignLeft`, `alignCenter`, `alignRight`, `justify`, `link`, `image`, `clear`, `subscript`, `superscript`;
-- `components.actions.save` e `components.actions.loadHtml`.
-
-O `lang` do documento salvo é o `locale` do i18n. **Confirmado**.
-
-## Acessibilidade comprovável
-
-- A área editável tem `id` e `aria-label` (i18n `components.textEditor.editorAriaLabel`).
-- Os botões da toolbar (`ToolbarButton`) têm `aria-label`, e os ícones são `aria-hidden`.
-- Os `<select>` de estilo, fonte e tamanho **não** têm rótulo associado.
-- O rótulo do editor de CSS é um `<label>` sem `htmlFor`.
-
-**Confirmado**.
-
-## Fontes
-
-- `front/seedgrid-fe-components/packages/seedgrid-fe-components/src/inputs/SgTextEditor.tsx` (`SgTextEditorBase`, `SgTextEditor`, `ToolbarButton`, `TextStyleWithSize`)
-- `front/seedgrid-fe-components/packages/seedgrid-fe-components/package.json` (`peerDependencies`)
+| `rules` | `RegisterOptions<any>` | — | Não | Regras de validação do RHF (`RegisterOptions`). |
+
+## Tipos exportados
+
+| Tipo | Forma |
+|---|---|
+| `SgTextEditorProps` | Tabela acima. |
+| `SgTextEditorSaveMeta` | `{ htmlDocument: string; contentHtml: string; cssText: string }` |
+
+## Eventos e formatos de retorno
+
+- **`onChangeHtml(htmlBody)`:**
+  - Disparado no `onUpdate` do TipTap com `editor.getHTML()`.
+  - Entrega **só o HTML do corpo**, por exemplo `"<p><strong>SeedGrid</strong> editor</p>"`, sem `<html>`/`<style>`.
+- **`onSave(file, meta)`:** acionado pelo botão "Salvar" da toolbar (i18n `components.actions.save`).
+  - `file` é um `File` `text/html;charset=utf-8`, com nome `fileName ?? "<id>.html"`.
+  - O conteúdo é um documento completo: `<!doctype html>`, `<html lang="<locale do i18n>">`, `<meta charset>`, `<meta viewport>`, `<style>` com o `cssText` (se houver) e `<body>` com o HTML.
+  - `meta` traz o mesmo documento como string (`htmlDocument`), além de `contentHtml` e `cssText`.
+- **`onLoad(meta)`:** o botão "Carregar HTML" (i18n `components.actions.loadHtml`) abre um `<input type="file" accept="text/html,.html">`. O componente então:
+  1. lê o arquivo;
+  2. extrai o CSS de `head style` e o `body`;
+  3. troca o conteúdo do editor;
+  4. chama `onCssTextChange` se o CSS mudou;
+  5. chama `onLoad`.
+- **`onCssTextChange(css)`:** chamado pela textarea de CSS (`showCssEditor`) e no carregamento de arquivo.
+
+**Confirmado** (`buildFullHtmlDocument`, `parseHtmlDocument`, `doSave`, `loadFromHtmlString`).
+
+## Controlado e não controlado
+
+- **Controlado:** quando `valueHtml` é `string`. Se o HTML do editor divergir de `valueHtml`, o componente chama `setContent(valueHtml)`.
+- **Não controlado:** o conteúdo inicial vem de `defaultValueHtml`.
+- **`cssText`:** é sempre lido da prop. Sem `onCssTextChange`, a textarea de CSS não altera nada.
+
+**Confirmado**.
+
+## Integração react-hook-form
+
+- **Integração:** via `control` + `name` (`<Controller>`). O valor do campo é o HTML do corpo (`field.value` string → `valueHtml`; `onChangeHtml` → `field.onChange`).
+- Nesse caminho, o `onChangeHtml` do usuário é substituído por `field.onChange`.
+- `rules` são repassadas sem `mergeRequiredRule` (o tipo não tem `required`).
+
+Teste de contrato: `tests/rhf-components-contract.test.mjs` ("SgTextEditor preserves control integration path"). **Confirmado**.
+
+## Ref
+
+O componente não usa `forwardRef` e não expõe a instância do TipTap (`Editor`). **Confirmado**.
+
+## Toolbar e extensões TipTap
+
+| Recurso | Implementação (`useEditor`) |
+|---|---|
+| Parágrafo/títulos H1, H2, H3 | `StarterKit` (`codeBlock` habilitado) + `<select>` |
+| Fonte (Arial, Georgia, Times, Courier) | `@tiptap/extension-font-family` |
+| Tamanho da fonte | `TextStyle` estendido com o atributo `fontSize` (`TextStyleWithSize`) |
+| Negrito, itálico, sublinhado, tachado | `StarterKit` + `@tiptap/extension-underline` |
+| Cor do texto e realce multicolor | `@tiptap/extension-color`, `@tiptap/extension-highlight` (`multicolor: true`) |
+| Sub/sobrescrito | `@tiptap/extension-subscript`, `@tiptap/extension-superscript` |
+| Listas, recuo e avanço | `StarterKit` |
+| Alinhamento (esquerda, centro, direita, justificado) | `@tiptap/extension-text-align` (`types: ["heading", "paragraph"]`) |
+| Link | `@tiptap/extension-link` (`openOnClick: false`, `autolink`, `linkOnPaste`) via `window.prompt` |
+| Imagem por URL | `@tiptap/extension-image` (`inline: false`) via `window.prompt` |
+| Limpar formatação | `unsetAllMarks().clearNodes()` |
+
+O editor é criado com `immediatelyRender: false` (seguro para SSR) e `editable: !disabled`. **Confirmado**.
+
+## Internacionalização
+
+As chaves usadas são:
+- `components.textEditor.placeholder`, `cssEditorLabel`, `editorAriaLabel`, `help.cssEmbedded`;
+- `components.textEditor.prompt.url` e `prompt.imageUrl`;
+- `components.textEditor.toolbar.*`: `heading`, `subheading`, `normal`, `heading3`, `defaultFont`, `bold`, `italic`, `underline`, `strike`, `textColor`, `highlightColor`, `bullets`, `numbered`, `indent`, `outdent`, `alignLeft`, `alignCenter`, `alignRight`, `justify`, `link`, `image`, `clear`, `subscript`, `superscript`;
+- `components.actions.save` e `components.actions.loadHtml`.
+
+O `lang` do documento salvo é o `locale` do i18n. **Confirmado**.
+
+## Acessibilidade comprovável
+
+- A área editável tem `id` e `aria-label` (i18n `components.textEditor.editorAriaLabel`).
+- Os botões da toolbar (`ToolbarButton`) têm `aria-label`, e os ícones são `aria-hidden`.
+- Os `<select>` de estilo, fonte e tamanho **não** têm rótulo associado.
+- O rótulo do editor de CSS é um `<label>` sem `htmlFor`.
+
+**Confirmado**.
+
+## Fontes
+
+- `front/seedgrid-fe-components/packages/seedgrid-fe-components/src/inputs/SgTextEditor.tsx` (`SgTextEditorBase`, `SgTextEditor`, `ToolbarButton`, `TextStyleWithSize`)
+- `front/seedgrid-fe-components/packages/seedgrid-fe-components/package.json` (`peerDependencies`)

package/seedgridKB/SeedGrid/SeedGrid-components/editor/Visao-geral.md

@@ -1,86 +1,86 @@
----
-tags: [seedgrid, component, frontend, react, editor, tiptap]
-fonte: front/seedgrid-fe-components/packages/seedgrid-fe-components/src/inputs/SgTextEditor.tsx
-branch: main
-commit: ad30fc11de
-analisado-em: 2026-10-14
----
-
-# SgTextEditor
-
-O `SgTextEditor` é o editor de texto rico (HTML) do pacote `@seedgrid/fe-components` (v`2026.7.1`), construído sobre o **TipTap 2**. Referência: [[SeedGrid/SeedGrid-components/editor/API|API do SgTextEditor]]. Código: [[SeedGrid/SeedGrid-components/editor/Exemplos|Exemplos do SgTextEditor]].
-
-## Objetivo
-
-O editor produz e edita **documentos HTML com CSS embutido**. As funções principais, todas **Confirmado**:
-- toolbar de formatação (títulos, fontes, tamanhos, cores, listas, alinhamento, link, imagem por URL);
-- editor opcional de CSS;
-- botões para **salvar** o documento como `File` `.html` e **carregar** um `.html` do disco.
-
-Usos indicados: modelos de e-mail, termos e contratos, conteúdo de páginas e notas ricas. Para texto simples, use [[SeedGrid/SeedGrid-components/inputs-texto/Visao-geral|SgInputTextArea]]. Essa recomendação está em `aiHints.avoidUseCases` de `SgInputText.meta.ts`. **Confirmado**.
-
-## Dependências (peers TipTap)
-
-`peerDependencies` do pacote (também em `devDependencies`), todas na faixa `^2.9.1`:
-
-| Pacote | Uso |
-|---|---|
-| `@tiptap/react` | `useEditor`, `EditorContent` |
-| `@tiptap/core` | Tipos/base |
-| `@tiptap/pm` | ProseMirror |
-| `@tiptap/starter-kit` | Parágrafos, títulos, listas, negrito/itálico/tachado, bloco de código |
-| `@tiptap/extension-underline` | Sublinhado |
-| `@tiptap/extension-link` | Links |
-| `@tiptap/extension-image` | Imagens |
-| `@tiptap/extension-text-align` | Alinhamento |
-| `@tiptap/extension-text-style` | Base de estilo (estendida com `fontSize`) |
-| `@tiptap/extension-color` | Cor do texto |
-| `@tiptap/extension-highlight` | Realce |
-| `@tiptap/extension-subscript` / `@tiptap/extension-superscript` | Sub/sobrescrito |
-| `@tiptap/extension-font-family` | Família da fonte |
-
-Além disso: `react`, `react-hook-form` (`Controller`) e `lucide-react` (ícones da toolbar). **Confirmado** pelos imports de `SgTextEditor.tsx` e pelo `package.json`.
-
-**Importante:** o `src/index.ts` reexporta o `SgTextEditor` estaticamente, e o arquivo importa o TipTap no topo. Por isso, **qualquer** importação de `@seedgrid/fe-components` faz o bundler resolver os pacotes `@tiptap/*`, mesmo em aplicações que não usam o editor. Na prática, os peers TipTap são necessários para todo consumidor do pacote. Isso é **Inferência**, pela estrutura dos imports ESM e pelo campo `sideEffects: true`; não foi testado em uma aplicação consumidora.
-
-## Composição
-
-```mermaid
-graph LR
-  TB[Toolbar: selects + ToolbarButton] --> ED[EditorContent TipTap]
-  ED -->|onUpdate| CH[onChangeHtml body HTML]
-  SAVE[Botão Salvar] --> DOC[buildFullHtmlDocument body + cssText] --> F[File .html via onSave]
-  LOAD[Botão Carregar HTML] --> PARSE[parseHtmlDocument] --> ED
-  PARSE --> CSS[onCssTextChange]
-  CSSED[Textarea CSS opcional] --> CSS
-```
-
-- O corpo editado (`valueHtml`) e o CSS (`cssText`) ficam **separados**. Eles só se juntam no documento salvo.
-- O CSS **não** é aplicado ao conteúdo dentro do editor. Ele vai apenas para o `<style>` do arquivo gerado.
-
-**Confirmado**: o `cssText` só é usado em `buildFullHtmlDocument` e na textarea.
-
-## Tema e estilos
-
-- **Área de edição:** classes `prose max-w-none`. As classes `prose` vêm do plugin de tipografia do Tailwind. Se esse plugin está incluído no CSS compilado do pacote **não foi verificado**.
-- **Moldura:** a toolbar e a área usam bordas e `bg-background`.
-- **Customização:** `className`, `style`, `borderRadius`, `height` (padrão 320 px).
-- **Desabilitado:** `disabled` deixa o conteúdo não editável, com opacidade 60%.
-
-**Confirmado**, salvo o ponto do `prose`.
-
-## Internacionalização
-
-Todos os rótulos da toolbar, os prompts e o placeholder vêm de `components.textEditor.*`. Ver [[SeedGrid/SeedGrid-components/editor/API#Internacionalização|API]].
-
-## Testes
-
-Só há o teste de contrato por regex (`tests/rhf-components-contract.test.mjs`), que confere o caminho `control`. Não há teste DOM do editor. **Confirmado**.
-
-## Limitações e pontos de atenção
-
-- **Prompts nativos:** link e imagem usam `window.prompt`, sem diálogo próprio e sem upload de arquivo de imagem. **Confirmado**.
-- **Instância TipTap:** não há ref nem acesso a ela, então não dá para registrar extensões adicionais. **Confirmado**.
-- **RHF:** integração só via `control`. Nesse modo, o `onChangeHtml` do usuário é substituído e deixa de ser chamado. **Confirmado**.
-- **Segurança:** o HTML carregado de arquivo vai para o editor sem sanitização explícita. O TipTap descarta o que não corresponde ao schema das extensões, mas o `cssText` extraído é repassado como veio. **Inferência**.
-- **Seletor de tamanho de fonte:** é um `<select>` com `defaultValue="16px"`, não controlado, e não reflete o tamanho da seleção atual. **Confirmado**.
+---
+tags: [seedgrid, component, frontend, react, editor, tiptap]
+fonte: front/seedgrid-fe-components/packages/seedgrid-fe-components/src/inputs/SgTextEditor.tsx
+branch: main
+commit: ad30fc11de
+analisado-em: 2026-10-14
+---
+
+# SgTextEditor
+
+O `SgTextEditor` é o editor de texto rico (HTML) do pacote `@seedgrid/fe-components` (v`2026.7.1`), construído sobre o **TipTap 2**. Referência: [[SeedGrid/SeedGrid-components/editor/API|API do SgTextEditor]]. Código: [[SeedGrid/SeedGrid-components/editor/Exemplos|Exemplos do SgTextEditor]].
+
+## Objetivo
+
+O editor produz e edita **documentos HTML com CSS embutido**. As funções principais, todas **Confirmado**:
+- toolbar de formatação (títulos, fontes, tamanhos, cores, listas, alinhamento, link, imagem por URL);
+- editor opcional de CSS;
+- botões para **salvar** o documento como `File` `.html` e **carregar** um `.html` do disco.
+
+Usos indicados: modelos de e-mail, termos e contratos, conteúdo de páginas e notas ricas. Para texto simples, use [[SeedGrid/SeedGrid-components/inputs-texto/Visao-geral|SgInputTextArea]]. Essa recomendação está em `aiHints.avoidUseCases` de `SgInputText.meta.ts`. **Confirmado**.
+
+## Dependências (peers TipTap)
+
+`peerDependencies` do pacote (também em `devDependencies`), todas na faixa `^2.9.1`:
+
+| Pacote | Uso |
+|---|---|
+| `@tiptap/react` | `useEditor`, `EditorContent` |
+| `@tiptap/core` | Tipos/base |
+| `@tiptap/pm` | ProseMirror |
+| `@tiptap/starter-kit` | Parágrafos, títulos, listas, negrito/itálico/tachado, bloco de código |
+| `@tiptap/extension-underline` | Sublinhado |
+| `@tiptap/extension-link` | Links |
+| `@tiptap/extension-image` | Imagens |
+| `@tiptap/extension-text-align` | Alinhamento |
+| `@tiptap/extension-text-style` | Base de estilo (estendida com `fontSize`) |
+| `@tiptap/extension-color` | Cor do texto |
+| `@tiptap/extension-highlight` | Realce |
+| `@tiptap/extension-subscript` / `@tiptap/extension-superscript` | Sub/sobrescrito |
+| `@tiptap/extension-font-family` | Família da fonte |
+
+Além disso: `react`, `react-hook-form` (`Controller`) e `lucide-react` (ícones da toolbar). **Confirmado** pelos imports de `SgTextEditor.tsx` e pelo `package.json`.
+
+**Importante:** o `src/index.ts` reexporta o `SgTextEditor` estaticamente, e o arquivo importa o TipTap no topo. Por isso, **qualquer** importação de `@seedgrid/fe-components` faz o bundler resolver os pacotes `@tiptap/*`, mesmo em aplicações que não usam o editor. Na prática, os peers TipTap são necessários para todo consumidor do pacote. Isso é **Inferência**, pela estrutura dos imports ESM e pelo campo `sideEffects: true`; não foi testado em uma aplicação consumidora.
+
+## Composição
+
+```mermaid
+graph LR
+  TB[Toolbar: selects + ToolbarButton] --> ED[EditorContent TipTap]
+  ED -->|onUpdate| CH[onChangeHtml body HTML]
+  SAVE[Botão Salvar] --> DOC[buildFullHtmlDocument body + cssText] --> F[File .html via onSave]
+  LOAD[Botão Carregar HTML] --> PARSE[parseHtmlDocument] --> ED
+  PARSE --> CSS[onCssTextChange]
+  CSSED[Textarea CSS opcional] --> CSS
+```
+
+- O corpo editado (`valueHtml`) e o CSS (`cssText`) ficam **separados**. Eles só se juntam no documento salvo.
+- O CSS **não** é aplicado ao conteúdo dentro do editor. Ele vai apenas para o `<style>` do arquivo gerado.
+
+**Confirmado**: o `cssText` só é usado em `buildFullHtmlDocument` e na textarea.
+
+## Tema e estilos
+
+- **Área de edição:** classes `prose max-w-none`. As classes `prose` vêm do plugin de tipografia do Tailwind. Se esse plugin está incluído no CSS compilado do pacote **não foi verificado**.
+- **Moldura:** a toolbar e a área usam bordas e `bg-background`.
+- **Customização:** `className`, `style`, `borderRadius`, `height` (padrão 320 px).
+- **Desabilitado:** `disabled` deixa o conteúdo não editável, com opacidade 60%.
+
+**Confirmado**, salvo o ponto do `prose`.
+
+## Internacionalização
+
+Todos os rótulos da toolbar, os prompts e o placeholder vêm de `components.textEditor.*`. Ver [[SeedGrid/SeedGrid-components/editor/API#Internacionalização|API]].
+
+## Testes
+
+Só há o teste de contrato por regex (`tests/rhf-components-contract.test.mjs`), que confere o caminho `control`. Não há teste DOM do editor. **Confirmado**.
+
+## Limitações e pontos de atenção
+
+- **Prompts nativos:** link e imagem usam `window.prompt`, sem diálogo próprio e sem upload de arquivo de imagem. **Confirmado**.
+- **Instância TipTap:** não há ref nem acesso a ela, então não dá para registrar extensões adicionais. **Confirmado**.
+- **RHF:** integração só via `control`. Nesse modo, o `onChangeHtml` do usuário é substituído e deixa de ser chamado. **Confirmado**.
+- **Segurança:** o HTML carregado de arquivo vai para o editor sem sanitização explícita. O TipTap descarta o que não corresponde ao schema das extensões, mas o `cssText` extraído é repassado como veio. **Inferência**.
+- **Seletor de tamanho de fonte:** é um `<select>` com `defaultValue="16px"`, não controlado, e não reflete o tamanho da seleção atual. **Confirmado**.