@selectwin/kit 0.1.133 → 0.1.134

package/dist/SelectBuilderWorkspace.d.ts

@@ -2,49 +2,74 @@ import { ReactNode } from 'react';
 export interface SelectBuilderSection {
     id: string;
     title: string;
-    /** Linha de apoio no cabeçalho do painel — o que a seção controla. */
+    /** Linha de apoio no topo do painel da seção. */
     description?: string;
-    /** Glifo do item na trilha. */
+    /** Glifo da seção na trilha/lista. */
     icon?: ReactNode;
-    /** Agrupa itens da trilha sob um rótulo (a ordem de aparição define a ordem dos grupos). */
+    /** Grupo (rótulo) — seções do mesmo grupo seguidas ficam juntas. */
     group?: string;
-    /** Termos extras para a busca da trilha (o título já entra por padrão). */
+    /** Palavras extras para a busca. */
     keywords?: string;
-    /** Selo curto à direita do item — estado da seção ("Ativo", "3 itens"). */
+    /** Selo de estado (ex.: "Ativo", "Revisar"). */
     status?: ReactNode;
+    /**
+     * O que está ligado na seção, numa linha (0.1.134) — "Pix 5% · até 12x". Aparece na LISTA do layout
+     * `drill`, onde cada seção se apresenta antes de ser aberta.
+     */
+    summary?: ReactNode;
     content: ReactNode;
 }
 export interface SelectBuilderWorkspaceProps {
     title: string;
     subtitle?: string;
-    /** Destino do voltar; sem ele, volta no histórico. */
+    /** Para onde o voltar leva (padrão: histórico). Ignorado com `onBack`. */
     backTo?: string;
+    /** Voltar controlado (0.1.134) — a tela decide (ex.: perguntar antes de sair com alteração). */
+    onBack?: () => void;
     onSave: () => void;
     saving?: boolean;
     saveLabel?: string;
     saveDisabled?: boolean;
+    /** Mostra "Cancelar" (navega para cá). Com `onDiscard`, vale o "Descartar". */
     cancelTo?: string;
-    /** Banner de erro acima das colunas. */
+    /** Descartar as alterações (0.1.134): o botão aparece ao lado do Salvar SÓ quando `dirty`. */
+    onDiscard?: () => void;
+    discardLabel?: string;
+    /** Banner de erro sob a barra. */
     error?: ReactNode;
-    sections: SelectBuilderSection[];
-    /** Seção ativa (controlado). Sem ela o workspace guarda a própria seleção. */
-    activeId?: string;
-    onActiveChange?: (id: string) => void;
-    /** Caixa de busca na trilha (filtra por título/keywords). */
+    /** As seções (layouts `rail` e `drill`). */
+    sections?: SelectBuilderSection[];
+    /** Seção aberta (controlada). No layout `drill`, `null` = a lista de seções. */
+    activeId?: string | null;
+    onActiveChange?: (id: string | null) => void;
+    /** Busca na trilha/lista. */
     searchable?: boolean;
-    /** O palco: normalmente um `<SelectPreviewFrame fill />`. */
+    searchPlaceholder?: string;
+    /** Palco da direita (a prévia). */
     preview?: ReactNode;
     /**
-     * Como o palco acomoda o `preview`. `fill` (padrão) estica o filho até as bordas — é o que
-     * uma pré-visualização em iframe quer. `document` é para um palco de LEITURA (o resumo do
-     * builder de pixels: não há página para mostrar, há o que acontece numa venda): a coluna rola
-     * sozinha e o conteúdo fica numa largura de leitura, centrado, em vez de esticar por 60rem.
+     * `fill` (padrão): o palco estica o filho (um iframe de prévia). `document`: o palco rola e
+     * centra o conteúdo numa largura de leitura.
      */
     previewLayout?: 'fill' | 'document';
-    /** Controles extras no centro da barra (ex.: alternador de dispositivo). */
+    /** Ferramentas entre a identidade e as ações. */
     toolbar?: ReactNode;
-    /** Selo de "alterações não salvas" na barra. */
     dirty?: boolean;
     dirtyLabel?: string;
+    /** Com nada a salvar (0.1.134): "Salvo às 10:42". */
+    savedLabel?: ReactNode;
+    /** O salvar foi recusado (0.1.134): "2 seções para revisar" — vence o `dirtyLabel`. */
+    reviewLabel?: ReactNode;
+    /** Arranjo das colunas (0.1.134) — ver o topo do arquivo. Padrão `rail`. */
+    layout?: 'rail' | 'drill' | 'single';
+    /** Conteúdo da coluna da esquerda no layout `single`. */
+    panel?: ReactNode;
+    /** Largura da coluna da esquerda nos layouts `drill`/`single` (padrão 26rem). */
+    panelWidth?: string;
+    /**
+     * No estreito (< 64em), duas abas no topo em vez da pilha (0.1.134): [ajustes, palco] — ex.:
+     * `['Ajustes', 'Prévia']`. Sem isto, a prévia fica embaixo do formulário inteiro.
+     */
+    mobileTabs?: [string, string];
 }
-export declare function SelectBuilderWorkspace({ title, subtitle, backTo, onSave, saving, saveLabel, saveDisabled, cancelTo, error, sections, activeId, onActiveChange, searchable, preview, previewLayout, toolbar, dirty, dirtyLabel, }: SelectBuilderWorkspaceProps): import("react").JSX.Element;
+export declare function SelectBuilderWorkspace({ title, subtitle, backTo, onBack, onSave, saving, saveLabel, saveDisabled, cancelTo, onDiscard, discardLabel, error, sections, activeId, onActiveChange, searchable, searchPlaceholder, preview, previewLayout, toolbar, dirty, dirtyLabel, savedLabel, reviewLabel, layout, panel, panelWidth, mobileTabs, }: SelectBuilderWorkspaceProps): import("react").JSX.Element;