@adatechnology/notification-ui 0.1.0-rc.5 → 0.1.0-rc.7

package/dist/headless.d.ts

@@ -1,333 +1,5 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import * as _adatechnology_notification_client from '@adatechnology/notification-client';
-import { NotificationClient } from '@adatechnology/notification-client';
-import * as _tanstack_react_query from '@tanstack/react-query';
-import * as _adatechnology_notification_contracts from '@adatechnology/notification-contracts';
-import { NotificationSummary, NotificationPreference, PreviewViewportSpec, RenderedTemplatePreview, NotificationTemplate, TemplateVariableDefinition, TemplateVariableDiff } from '@adatechnology/notification-contracts';
-
-var ptBR = {
-	"bell.label": "Notificações",
-	"bell.unreadSuffix": "não lidas",
-	"list.title": "Caixa de entrada",
-	"list.unread": "não lidas",
-	"list.empty": "Nenhuma notificação por aqui.",
-	"list.loading": "Carregando…",
-	"list.error": "Não foi possível carregar suas notificações.",
-	"list.retry": "Tentar de novo",
-	"list.loadMore": "Carregar mais",
-	"list.markAllAsRead": "Marcar todas como lidas",
-	"item.markAsRead": "Marcar como lida",
-	"item.delete": "Excluir",
-	"item.unread": "Não lida",
-	"preferences.title": "Preferências de notificação",
-	"preferences.description": "Escolha por onde você quer ser avisado em cada assunto.",
-	"preferences.save": "Salvar preferências",
-	"preferences.saved": "Preferências salvas.",
-	"preferences.error": "Não foi possível salvar. Tente de novo.",
-	"preferences.empty": "Nenhuma preferência configurada ainda.",
-	"preferences.quietHours": "Silêncio entre",
-	"preferences.quietHoursTo": "e",
-	"channel.inbox": "No app",
-	"channel.push": "Push",
-	"channel.email": "E-mail",
-	"channel.whatsapp": "WhatsApp",
-	"channel.sms": "SMS",
-	"workspace.title": "Notificações",
-	"workspace.description": "O que foi avisado, e por quais canais.",
-	"workspace.settingsLink": "Configurações",
-	"settings.title": "Configurações de notificação",
-	"settings.description": "Por onde avisar, e o texto exato que chega.",
-	"settings.channelsTitle": "Canais",
-	"settings.channelsHint": "Desligar um canal não apaga o histórico — o aviso deixa de sair por ali daqui em diante.",
-	"settings.templatesTitle": "Mensagens",
-	"settings.templatesHint": "Uma versão nova é criada a cada gravação; a anterior fica no histórico.",
-	"settings.templatesEmpty": "Nenhuma mensagem cadastrada.",
-	"settings.pickTemplate": "Escolha uma mensagem para editar.",
-	"settings.subject": "Título",
-	"settings.subjectHint": "O que aparece na lista. Vazio, o título é derivado da primeira linha do texto.",
-	"settings.body": "Texto",
-	"settings.previewTitle": "Como o destinatário vê",
-	"settings.save": "Salvar nova versão",
-	"settings.saving": "Salvando…",
-	"settings.unchanged": "Nada mudou ainda.",
-	"settings.close": "Fechar",
-	"settings.version": "v",
-	"settings.newTemplate": "Nova mensagem",
-	"settings.remove": "Remover",
-	"settings.key": "Chave da notificação",
-	"settings.keyHint": "Não muda depois de criada — é por ela que o envio acha a mensagem.",
-	"settings.channel": "Canal",
-	"settings.locale": "Idioma",
-	"settings.variablesTitle": "Variáveis",
-	"settings.variablesHint": "Clique para inserir no ponto onde o cursor estava.",
-	"settings.unknownVariables": "Variáveis que não existem nesta notificação:",
-	"settings.viewport.desktop": "Computador",
-	"settings.viewport.mobile": "Celular",
-	"settings.constraint.title": "Assunto passa do limite do canal:",
-	"settings.constraint.body": "Texto passa do limite do canal:",
-	"settings.tab.messages": "Mensagens",
-	"settings.tab.routing": "Roteamento",
-	"settings.policiesTitle": "Canais permitidos por assunto",
-	"settings.policiesHint": "Decisão da empresa. Canal desligado aqui não sai, mesmo que o destinatário tenha pedido.",
-	"settings.savePolicies": "Salvar roteamento",
-	"settings.discard": "Descartar"
-};
-
-/**
- * Copyright (c) 2026 Ada Technology. MIT License.
- *
- * Nenhum texto visível vive em tag ou prop (`web.md` §6). O host sobrescreve chaves pontuais via
- * `messageOverrides` sem precisar fornecer um locale inteiro.
- */
-
-type NotificationMessages = typeof ptBR;
-type NotificationLocale = 'pt-BR' | 'en';
-declare const DEFAULT_LOCALE: NotificationLocale;
-declare function resolveMessages(locale: NotificationLocale): NotificationMessages;
-
-type NotificationTheme = {
-    /** Classe aplicada na raiz de cada componente — é por onde o host injeta os tokens dele. */
-    readonly rootClassName?: string;
-    readonly components?: Partial<Record<string, string>>;
-};
-type NotificationContextValue = {
-    readonly client: NotificationClient;
-    /**
-     * O idioma resolvido, e não só os textos dele: data e número não vivem no arquivo de locale —
-     * quem os formata é `Intl`, e `Intl` precisa da tag do idioma. Sem isto o item da lista teria de
-     * chutar um locale fixo, e a inbox mostraria "5 minutes ago" numa tela em português.
-     */
-    readonly locale: NotificationLocale;
-    readonly messages: NotificationMessages;
-    readonly theme: NotificationTheme;
-    /** Polling de fallback quando o SSE não está disponível (segundos); `0` desliga. */
-    readonly pollIntervalSeconds: number;
-};
-type NotificationProviderProps = {
-    readonly client: NotificationClient;
-    readonly locale?: NotificationLocale;
-    /** Sobrescreve textos pontuais sem trocar o locale inteiro. */
-    readonly messageOverrides?: Partial<NotificationMessages>;
-    readonly theme?: NotificationTheme;
-    readonly pollIntervalSeconds?: number;
-    readonly children: ReactNode;
-};
-declare function NotificationProvider({ client, locale, messageOverrides, theme, pollIntervalSeconds, children, }: NotificationProviderProps): react.JSX.Element;
-declare function useNotificationContext(): NotificationContextValue;
-
-type UseNotificationsOptions = {
-    readonly category?: string;
-    readonly read?: boolean;
-    readonly perPage?: number;
-};
-declare function useNotifications(options?: UseNotificationsOptions): _tanstack_react_query.UseInfiniteQueryResult<_tanstack_react_query.InfiniteData<_adatechnology_notification_client.ListNotificationsPage, unknown>, Error>;
-declare function useUnreadCount(): _tanstack_react_query.UseQueryResult<number, Error>;
-declare function useMarkAsRead(): _tanstack_react_query.UseMutationResult<NotificationSummary, Error, string, {
-    previousCount: number | undefined;
-    id: string;
-}>;
-declare function useMarkAllAsRead(): _tanstack_react_query.UseMutationResult<number, Error, void, unknown>;
-declare function useDeleteNotification(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
-/** Achata as páginas do infinite query — a lista quase sempre quer o array direto. */
-declare function flattenNotificationPages(pages: readonly {
-    data: readonly NotificationSummary[];
-}[] | undefined): readonly NotificationSummary[];
-
-/**
- * Copyright (c) 2026 Ada Technology. MIT License.
- */
-type UseNotificationStreamOptions = {
-    /** Desligado por omissão: abrir SSE é decisão do host, que sabe se o backend expõe a rota. */
-    readonly enabled?: boolean;
-    readonly onEvent?: (event: {
-        event: string;
-        data: unknown;
-    }) => void;
-};
-/**
- * Liga o SSE do inbox ao cache do TanStack: cada evento invalida as chaves, e o badge e a lista
- * atualizam juntos. `useEffect` aqui é o uso correto do hook — sincronizar com um sistema externo
- * (`react.md`, "useEffect só para sincronizar com sistemas externos"), não transformar dado.
- */
-declare function useNotificationStream(options?: UseNotificationStreamOptions): void;
-
-/**
- * Copyright (c) 2026 Ada Technology. MIT License.
- *
- * O roteamento: por quais canais cada categoria PODE sair, decidido pela empresa.
- *
- * É a camada que faltava. O chamador já podia enumerar canais em cada `sendNotification`, e quem
- * recebe já tinha preferência — mas "cobrança nunca sai por SMS" não cabia em nenhum dos dois:
- * o primeiro espalha a decisão por todo o código, o segundo deixa ela na mão do destinatário.
- *
- * O modelo aqui é de teto, não de piso: desligar barra o canal para todo mundo; ligar apenas
- * permite, e a preferência de quem recebe continua valendo por cima.
- */
-type UseCategoryPoliciesResult = {
-    readonly isLoading: boolean;
-    readonly isSaving: boolean;
-    readonly error: string | undefined;
-    readonly isDirty: boolean;
-    /** Linha ausente é permitido — o mesmo default do servidor, para a tela não mentir. */
-    isAllowed: (params: {
-        category: string;
-        channel: string;
-    }) => boolean;
-    toggle: (params: {
-        category: string;
-        channel: string;
-    }) => void;
-    save: () => void;
-    reset: () => void;
-};
-declare function useCategoryPolicies(): UseCategoryPoliciesResult;
-
-declare function usePreferences(): _tanstack_react_query.UseQueryResult<NoInfer<readonly NotificationPreference[]>, Error>;
-declare function useUpdatePreferences(): _tanstack_react_query.UseMutationResult<readonly NotificationPreference[], Error, readonly NotificationPreference[], unknown>;
-declare function useTemplates(): _tanstack_react_query.UseQueryResult<NoInfer<readonly _adatechnology_notification_contracts.NotificationTemplate[]>, Error>;
-/**
- * Salva uma VERSÃO nova do template. É o que a tela de configuração usa para o lojista mudar a copy
- * sem deploy.
- *
- * Invalida em vez de escrever no cache: o servidor decide o número da versão, então o objeto salvo
- * traz um campo que o otimista não teria como prever — e mostrar "versão 3" quando o banco gravou 4
- * confunde exatamente quem está tentando conferir o que salvou.
- */
-declare function useUpsertTemplate(): _tanstack_react_query.UseMutationResult<_adatechnology_notification_contracts.NotificationTemplate, Error, {
-    locale: string;
-    channel: "inbox" | "push" | "email" | "whatsapp" | "sms";
-    key: string;
-    body: string;
-    active: boolean;
-    subject?: string | undefined;
-    whatsappTemplateName?: string | undefined;
-}, unknown>;
-/**
- * O catálogo é config do host: muda com deploy, não com uso. `staleTime: Infinity` evita refetch a
- * cada foco de janela por um dado que não muda durante a sessão.
- */
-declare function useTemplateVariables(): _tanstack_react_query.UseQueryResult<NoInfer<Readonly<Record<string, readonly _adatechnology_notification_contracts.TemplateVariableDefinition[]>>>, Error>;
-/**
- * Desativa o template. Invalida a lista pelo mesmo motivo do upsert: o servidor derruba TODAS as
- * versões ativas da identidade, e um cache otimista que removesse só a linha clicada mostraria a
- * versão anterior de volta na tela.
- */
-declare function useDeactivateTemplate(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
-
-/**
- * Copyright (c) 2026 Ada Technology. MIT License.
- *
- * Chaves centralizadas: o sino e a lista leem o mesmo `unreadCount`, e uma invalidação precisa
- * atingir os dois. Chave montada inline em cada hook é como badge e lista passam a mostrar
- * números diferentes.
- */
-declare const NOTIFICATION_QUERY_KEYS: {
-    readonly all: readonly ["notifications"];
-    readonly list: (filters: {
-        category?: string;
-        read?: boolean;
-    }) => readonly ["notifications", "list", {
-        category?: string;
-        read?: boolean;
-    }];
-    readonly unreadCount: () => readonly ["notifications", "unread-count"];
-    readonly preferences: () => readonly ["notifications", "preferences"];
-    readonly templates: () => readonly ["notifications", "templates"];
-    readonly templateVariables: () => readonly ["notifications", "template-variables"];
-    readonly categoryPolicies: () => readonly ["notifications", "category-policies"];
-};
-
-/**
- * Copyright (c) 2026 Ada Technology. MIT License.
- *
- * Quando o aviso chegou, dito do jeito que se diz em voz alta.
- *
- * `Intl` faz o trabalho de idioma — o pacote não guarda "há", "ago" nem nome de mês em lugar nenhum,
- * o que manteria `web.md` §6 de pé e ainda assim quebraria no primeiro locale novo. O que é decisão
- * nossa são as faixas: segundo, minuto, hora, dia, e a virada para data absoluta.
- */
-declare function formatNotificationTime(isoTimestamp: string, locale: string, now: Date): string;
-/** O instante inteiro, para o `title` — é a hora que o texto relativo esconde. */
-declare function formatNotificationTimestamp(isoTimestamp: string, locale: string): string;
-
-/**
- * Copyright (c) 2026 Ada Technology. MIT License.
- *
- * A lógica do editor de template, que estava reimplementada no host.
- *
- * Ela veio de `quickcart/modules/notifications/hooks/useNotificationSettings.hook.ts` — 207 linhas
- * que o segundo produto reescreveria, com as mesmas quatro decisões sutis para redescobrir. Elas
- * são o motivo de isto ser pacote e não exemplo:
- *
- * 1. **Versão ativa mais alta.** A rota devolve o histórico inteiro, correto para auditoria; na tela
- *    isso faz a mesma mensagem aparecer três vezes e ninguém sabe qual está no ar.
- * 2. **Seleção pelo id, não pelo objeto.** Salvar cria versão nova no servidor; segurando o objeto,
- *    o editor mostra a versão que já não é a ativa e a gravação seguinte parte de um texto velho.
- * 3. **Campo vazio é ausência.** Gravar `subject: ''` faz o renderer tratar como subject existente e
- *    derivar título vazio, em vez de cair no fallback que usa o corpo.
- * 4. **Preview pelo `renderTemplate` do contracts**, o mesmo do envio. Reimplementar a interpolação
- *    dá um preview que confere hoje e mente quando o renderer mudar.
- *
- * A criação de template novo trouxe uma quinta: **a identidade é imutável depois de criada**.
- * `key`+`channel`+`locale` é o que o `sendNotification` procura; deixar editar num template
- * existente não seria edição, seria criar outro e deixar o antigo órfão no ar.
- */
-
-type TemplateDraft = {
-    readonly key: string;
-    readonly channel: string;
-    readonly locale: string;
-    readonly subject: string;
-    readonly body: string;
-    readonly whatsappTemplateName: string;
-};
-type TemplateDraftField = 'subject' | 'body';
-type TemplatePreviewFrame = PreviewViewportSpec & {
-    readonly rendered: RenderedTemplatePreview;
-};
-type UseTemplateEditorParams = {
-    /**
-     * Valores de exemplo do preview. Hoje o padrão vem do catálogo de variáveis do servidor; isto
-     * continua existindo para o produto sobrescrever um exemplo pontual sem mexer no catálogo.
-     */
-    readonly previewPayload?: Readonly<Record<string, unknown>>;
-    /** Canal e locale de um template novo, antes de o operador escolher. */
-    readonly defaultChannel?: string;
-    readonly defaultLocale?: string;
-};
-type UseTemplateEditorResult = {
-    readonly templates: readonly NotificationTemplate[];
-    readonly isLoading: boolean;
-    readonly isSaving: boolean;
-    readonly isDeactivating: boolean;
-    readonly error: string | undefined;
-    readonly selected: NotificationTemplate | undefined;
-    readonly draft: TemplateDraft | undefined;
-    /** `true` enquanto o rascunho é um template que ainda não existe no servidor. */
-    readonly isNew: boolean;
-    /** Identidade travada — `false` só durante a criação. */
-    readonly isIdentityLocked: boolean;
-    /** Os dois quadros do preview, na ordem em que a tela desenha. */
-    readonly previews: readonly TemplatePreviewFrame[];
-    /** As variáveis que esta `key` declara. Vazio quando o catálogo não conhece a chave. */
-    readonly variables: readonly TemplateVariableDefinition[];
-    readonly variableDiff: TemplateVariableDiff;
-    readonly isDirty: boolean;
-    readonly canSave: boolean;
-    select: (template: NotificationTemplate) => void;
-    startNew: () => void;
-    update: (patch: Partial<TemplateDraft>) => void;
-    /** Insere `{{nome}}` na posição do cursor. O operador nunca digita o nome à mão. */
-    insertVariable: (params: {
-        name: string;
-        field: TemplateDraftField;
-        cursorIndex: number;
-    }) => void;
-    save: () => void;
-    deactivate: (id: string) => void;
-    clear: () => void;
-};
-declare function useTemplateEditor(params?: UseTemplateEditorParams): UseTemplateEditorResult;
-
-export { DEFAULT_LOCALE, NOTIFICATION_QUERY_KEYS, type NotificationContextValue, type NotificationLocale, type NotificationMessages, NotificationProvider, type NotificationProviderProps, type NotificationTheme, type TemplateDraft, type TemplateDraftField, type TemplatePreviewFrame, type UseCategoryPoliciesResult, type UseNotificationStreamOptions, type UseNotificationsOptions, type UseTemplateEditorParams, type UseTemplateEditorResult, flattenNotificationPages, formatNotificationTime, formatNotificationTimestamp, resolveMessages, useCategoryPolicies, useDeactivateTemplate, useDeleteNotification, useMarkAllAsRead, useMarkAsRead, useNotificationContext, useNotificationStream, useNotifications, usePreferences, useTemplateEditor, useTemplateVariables, useTemplates, useUnreadCount, useUpdatePreferences, useUpsertTemplate };
+export { D as DEFAULT_LOCALE, N as NOTIFICATION_QUERY_KEYS, a as NotificationContextValue, b as NotificationLocale, c as NotificationMessages, d as NotificationProvider, e as NotificationProviderProps, f as NotificationTheme, k as TemplateDraft, l as TemplateDraftField, m as TemplatePreviewFrame, U as UseCategoryPoliciesResult, q as UseNotificationStreamOptions, r as UseNotificationsOptions, s as UseTemplateEditorParams, t as UseTemplateEditorResult, u as flattenNotificationPages, v as formatNotificationTime, w as formatNotificationTimestamp, x as resolveMessages, y as useCategoryPolicies, z as useDeactivateTemplate, A as useDeleteNotification, B as useMarkAllAsRead, C as useMarkAsRead, E as useNotificationContext, F as useNotificationStream, G as useNotifications, H as usePreferences, I as useTemplateEditor, J as useTemplateVariables, K as useTemplates, L as useUnreadCount, M as useUpdatePreferences, O as useUpsertTemplate } from './headless--T3Ry0h4.js';
+import 'react';
+import '@adatechnology/notification-client';
+import '@tanstack/react-query';
+import '@adatechnology/notification-contracts';

package/dist/headless.js

@@ -21,7 +21,7 @@ import {
   useUnreadCount,
   useUpdatePreferences,
   useUpsertTemplate
-} from "./chunk-QBQ62VZ3.js";
+} from "./chunk-7XDQ76IV.js";
 export {
   DEFAULT_LOCALE,
   NOTIFICATION_QUERY_KEYS,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { DEFAULT_LOCALE, NOTIFICATION_QUERY_KEYS, NotificationContextValue, NotificationLocale, NotificationMessages, NotificationProvider, NotificationProviderProps, NotificationTheme, TemplateDraft, TemplateDraftField, TemplatePreviewFrame, UseCategoryPoliciesResult, UseNotificationStreamOptions, UseNotificationsOptions, UseTemplateEditorParams, UseTemplateEditorResult, flattenNotificationPages, formatNotificationTime, formatNotificationTimestamp, resolveMessages, useCategoryPolicies, useDeactivateTemplate, useDeleteNotification, useMarkAllAsRead, useMarkAsRead, useNotificationContext, useNotificationStream, useNotifications, usePreferences, useTemplateEditor, useTemplateVariables, useTemplates, useUnreadCount, useUpdatePreferences, useUpsertTemplate } from './headless.js';
+export { D as DEFAULT_LOCALE, N as NOTIFICATION_QUERY_KEYS, a as NotificationContextValue, b as NotificationLocale, c as NotificationMessages, d as NotificationProvider, e as NotificationProviderProps, f as NotificationTheme, S as SORT_DIRECTIONS, g as SortDirection, T as TEMPLATE_COLUMNS, h as TEMPLATE_SORT_FIELDS, i as TEMPLATE_VIEWS, j as TemplateColumn, k as TemplateDraft, l as TemplateDraftField, m as TemplatePreviewFrame, n as TemplateSort, o as TemplateSortField, p as TemplateView, U as UseCategoryPoliciesResult, q as UseNotificationStreamOptions, r as UseNotificationsOptions, s as UseTemplateEditorParams, t as UseTemplateEditorResult, u as flattenNotificationPages, v as formatNotificationTime, w as formatNotificationTimestamp, x as resolveMessages, y as useCategoryPolicies, z as useDeactivateTemplate, A as useDeleteNotification, B as useMarkAllAsRead, C as useMarkAsRead, E as useNotificationContext, F as useNotificationStream, G as useNotifications, H as usePreferences, I as useTemplateEditor, J as useTemplateVariables, K as useTemplates, L as useUnreadCount, M as useUpdatePreferences, O as useUpsertTemplate } from './headless--T3Ry0h4.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { NotificationSummary, NotificationTemplate } from '@adatechnology/notification-contracts';
@@ -92,6 +92,15 @@ type NotificationCategoryOption = {
     readonly label: string;
     readonly hint?: string;
 };
+/** O laudo do validador, na forma mínima que a tela precisa desenhar. */
+type EmailHtmlReport = {
+    readonly isValid: boolean;
+    readonly problems: readonly {
+        readonly code: string;
+        readonly severity: string;
+        readonly message: string;
+    }[];
+};
 type NotificationSettingsWorkspaceProps = {
     readonly labels?: Partial<Record<string, string>>;
     /** Os canais que ESTE produto oferece — o pacote despacha em cinco e não opina sobre quais usar. */
@@ -114,12 +123,186 @@ type NotificationSettingsWorkspaceProps = {
         readonly value: string;
         readonly onChange: (value: string) => void;
     }) => ReactNode;
+    /**
+     * Confere o documento contra o que cliente de e-mail realmente faz (script, folha externa, imagem
+     * em `data:`, tabela desbalanceada). Ausente, nenhum aviso aparece.
+     */
+    readonly validateEmailHtml?: (html: string) => EmailHtmlReport;
     /** Substitui o cabeçalho padrão — a página que já tem título próprio evita o segundo `<h1>`. */
     readonly renderHeader?: () => ReactNode;
     /** Ações do produto no cabeçalho. */
     readonly renderHeaderActions?: () => ReactNode;
     readonly className?: string;
+    /**
+     * Nome do produto no preview: e o remetente do e-mail e o app do push. O pacote nao sabe de
+     * quem e a marca, e "Aviso" generico faria o preview mentir sobre o que a pessoa ve.
+     */
+    readonly senderName?: string;
+    /** Rótulo humano de uma categoria (`auth` → "Acesso"). Ausente, mostra a própria chave. */
+    readonly categoryLabelOf?: (category: string) => string;
+};
+declare function NotificationSettingsWorkspace({ labels: labelsOverride, channels, categories, previewPayload, templateLabelOf, renderChannelFields, validateEmailHtml, renderHeader, renderHeaderActions, className, senderName, categoryLabelOf, }: NotificationSettingsWorkspaceProps): react.JSX.Element;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Campo de código com realce, numeração de linha e laudo do linter.
+ *
+ * Técnica de sobreposição, e não um editor de verdade: um `<pre>` colorido embaixo e o `<textarea>`
+ * transparente em cima, com a MESMA métrica de texto e a rolagem sincronizada. Custa alinhamento
+ * milimétrico, e paga não trazendo um CodeMirror (~200KB) para dentro de um pacote de UI que hoje
+ * pesa duas dependências — e não perdendo nada do `<textarea>`: seleção, desfazer, corretor,
+ * leitor de tela e o cursor que o editor usa para inserir variável continuam nativos.
+ */
+type HtmlCodeFieldProblem = {
+    readonly code: string;
+    readonly severity: string;
+    readonly message: string;
+};
+type HtmlCodeFieldProps = {
+    readonly value: string;
+    readonly rows?: number;
+    readonly onChange: (value: string) => void;
+    readonly onSelect?: (cursorIndex: number) => void;
+    readonly onFocus?: () => void;
+    /** Ausente, nenhum laudo aparece — o campo vira só realce. */
+    readonly problems?: readonly HtmlCodeFieldProblem[];
+};
+declare function HtmlCodeField({ value, rows, onChange, onSelect, onFocus, problems }: HtmlCodeFieldProps): react.JSX.Element;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Realce de HTML como DADOS, nunca como string de markup.
+ *
+ * A tentação aqui é montar `<span class=...>` numa string e jogar em `dangerouslySetInnerHTML` —
+ * é o caminho mais curto e é como quase toda biblioteca de realce faz. Num editor esse caminho
+ * passa por cima do texto que a pessoa acabou de digitar: o realce vira o vetor de injeção do
+ * próprio conteúdo que ele deveria só colorir. Devolver tokens deixa o React criar nó de texto, e
+ * a questão simplesmente não existe.
+ */
+declare const HTML_TOKEN: {
+    readonly TAG: "tag";
+    readonly NAME: "name";
+    readonly ATTRIBUTE: "attribute";
+    readonly VALUE: "value";
+    readonly COMMENT: "comment";
+    readonly DOCTYPE: "doctype";
+    readonly VARIABLE: "variable";
+    readonly TEXT: "text";
+};
+type HtmlTokenKind = (typeof HTML_TOKEN)[keyof typeof HTML_TOKEN];
+type HtmlToken = {
+    readonly kind: HtmlTokenKind;
+    readonly text: string;
+};
+declare function tokenizeHtml(source: string): readonly HtmlToken[];
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * A caixa de mensagem com barra de formatação.
+ *
+ * A seleção é assunto do DOM, e por isso ela mora aqui e não no `useTemplateEditor`: o hook guarda
+ * o rascunho, este componente guarda onde o cursor está. Depois de cada botão a seleção é
+ * reposicionada à mão — sem isso o cursor pula para o fim do texto a cada clique, e quem estava
+ * corrigindo o meio de uma frase perde o lugar.
+ */
+type MessageBodyFieldProps = {
+    readonly value: string;
+    readonly rows?: number;
+    readonly onChange: (value: string) => void;
+    readonly onSelect?: (cursorIndex: number) => void;
+    readonly onFocus?: () => void;
+    readonly labelOf: (key: string) => string;
 };
-declare function NotificationSettingsWorkspace({ labels: labelsOverride, channels, categories, previewPayload, templateLabelOf, renderChannelFields, renderHeader, renderHeaderActions, className, }: NotificationSettingsWorkspaceProps): react.JSX.Element;
+declare function MessageBodyField({ value, rows, onChange, onSelect, onFocus, labelOf }: MessageBodyFieldProps): react.JSX.Element;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * A barra da caixa de mensagem: negrito, itálico, tachado, monoespaçado e emoji.
+ *
+ * Ela escreve MARCAÇÃO no texto, não HTML. A convenção é a do WhatsApp (`conversation-flow.md` §4)
+ * e vale para todos os canais — quem escreve o fluxo escreve uma vez, e o canal que não a entende
+ * nativamente traduz na renderização. Um editor rico que cuspisse `<b>` obrigaria o mesmo texto a
+ * existir duas vezes, e a segunda cópia sempre atrasa em relação à primeira.
+ */
+type MessageToolbarProps = {
+    /** Aplica o delimitador na seleção corrente do campo. */
+    readonly onMark: (delimiter: string) => void;
+    readonly onInsert: (text: string) => void;
+    /** Rótulos acessíveis, por formato. Nada aqui é literal (web.md §6). */
+    readonly labelOf: (key: string) => string;
+};
+declare function MessageToolbar({ onMark, onInsert, labelOf }: MessageToolbarProps): react.JSX.Element;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Formatação e emoji da caixa de mensagem.
+ *
+ * A marcação é a do WhatsApp — `*negrito*`, `_itálico_` — e ela é ÚNICA para todos os canais
+ * (`conversation-flow.md` §4): quem escreve o fluxo escreve uma vez, e o canal que não entende a
+ * convenção nativamente traduz na renderização. Um editor rico que cuspisse `<b>` obrigaria o texto
+ * a existir duas vezes, e a segunda sempre atrasa em relação à primeira.
+ *
+ * Os delimitadores são simétricos de propósito: envolver a seleção e desfazer o envolvimento é a
+ * mesma operação com o mesmo par, e é isso que deixa o botão alternar em vez de acumular asterisco.
+ */
+declare const MESSAGE_FORMAT: {
+    readonly BOLD: "bold";
+    readonly ITALIC: "italic";
+    readonly STRIKETHROUGH: "strikethrough";
+    readonly MONOSPACE: "monospace";
+};
+type MessageFormat = (typeof MESSAGE_FORMAT)[keyof typeof MESSAGE_FORMAT];
+type MessageFormatMark = {
+    readonly format: MessageFormat;
+    readonly delimiter: string;
+};
+declare const MESSAGE_FORMAT_MARKS: readonly MessageFormatMark[];
+/**
+ * Paleta curada, e não um seletor com todos os emoji do Unicode.
+ *
+ * O mesmo emoji precisa significar a mesma coisa em todo o produto (`conversation-flow.md` §3), e
+ * uma grade infinita garante o contrário: cada pessoa escolhe um símbolo diferente para "confirmar".
+ * Vinte e quatro cobrem aviso, dinheiro, prazo e atendimento — o que estes produtos realmente dizem.
+ */
+declare const MESSAGE_EMOJI: readonly string[];
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ */
+type ApplyMarkParams = {
+    readonly text: string;
+    readonly delimiter: string;
+    readonly selectionStart: number;
+    readonly selectionEnd: number;
+};
+type ApplyMarkResult = {
+    readonly text: string;
+    /** Onde o cursor precisa ficar depois — sem isto, ele volta para o começo a cada clique. */
+    readonly selectionStart: number;
+    readonly selectionEnd: number;
+};
+/**
+ * Envolve a seleção com o delimitador — ou DESFAZ, se ela já estiver envolvida.
+ *
+ * O botão alterna, e não acumula: clicar duas vezes em negrito com o mesmo trecho selecionado
+ * devolve o texto original. Sem isso, `**texto**` vira literal na conversa, porque a convenção do
+ * WhatsApp não aninha — o segundo par cancela o primeiro e o cliente mostra os asteriscos.
+ *
+ * Seleção vazia insere o par e põe o cursor no meio: é o comportamento de quem clica em negrito
+ * ANTES de escrever, que é metade das vezes.
+ */
+declare function applyMark({ text, delimiter, selectionStart, selectionEnd }: ApplyMarkParams): ApplyMarkResult;
+/** Insere no cursor, substituindo o que estiver selecionado — o que todo campo de texto faz. */
+declare function insertAt({ text, insertion, selectionStart, selectionEnd, }: {
+    readonly text: string;
+    readonly insertion: string;
+    readonly selectionStart: number;
+    readonly selectionEnd: number;
+}): ApplyMarkResult;
 
-export { NotificationBell, type NotificationBellProps, type NotificationCategoryOption, type NotificationChannelOption, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationSettingsWorkspace, type NotificationSettingsWorkspaceProps, NotificationsWorkspace, type NotificationsWorkspaceProps, PreferencesPanel, type PreferencesPanelProps };
+export { HTML_TOKEN, HtmlCodeField, type HtmlCodeFieldProblem, type HtmlCodeFieldProps, type HtmlToken, type HtmlTokenKind, MESSAGE_EMOJI, MESSAGE_FORMAT, MESSAGE_FORMAT_MARKS, MessageBodyField, type MessageBodyFieldProps, type MessageFormat, type MessageFormatMark, MessageToolbar, type MessageToolbarProps, NotificationBell, type NotificationBellProps, type NotificationCategoryOption, type NotificationChannelOption, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationSettingsWorkspace, type NotificationSettingsWorkspaceProps, NotificationsWorkspace, type NotificationsWorkspaceProps, PreferencesPanel, type PreferencesPanelProps, applyMark, insertAt, tokenizeHtml };