@snksergio/design-system 0.63.0 → 0.64.0

package/dist-lib/ai/componentes/DataTable.md

@@ -703,7 +703,8 @@ tableRef.current?.collapseAllTree();      // tree-data: recolhe todos os nós (n
 - `enableExport?` (false) — `true` = dropdown Exportar com CSV default; objeto `{ formats?, items? }` pra formatos custom
 - `enableFullscreen?` (false) — botão ⤢ na toolbar (entre Filtros e Configurações) que expande a tabela pra viewport inteira; Esc volta
 - `moreMenu?` — `{ items: DataTableMoreMenuItem[] }` — MoreMenu (⋯) no canto direito
-- `customLeft?` — ReactNode livre após search/refresh (controls custom)
+- `customLeft?` — **ReactNode livre**, entre o refresh e a busca (mesma posição das `actions`, e antes delas quando as duas vêm juntas). É o único caminho pra um **componente** no toolbar: `actions` só aceita `ToolbarAction[]`, cujos kinds são `button`/`dropdown`/`input` e nenhum recebe componente. Use pra `DatePicker` de período, `Select` composto, segmented custom. ⚠️ Era **inerte** até 2026-09-16 (declarada, documentada, lida por nada — o TS aceitava e nada renderizava); gate: `datatable-toolbar-slots.test.tsx`
+- `customActions?` — ⛔ **@deprecated e sem efeito** — nunca foi lida. Use `customLeft` (componente) ou `moreMenu.items` (itens de menu)
 - `viewToggle?` — override/esconde o segmented table/kanban auto-renderizado
 
 > Bulk actions vão em `selectionConfig.actions` (não no toolbar). Preset views vão na prop

package/dist-lib/ai/componentes/TableToolbar.md

@@ -27,7 +27,7 @@ Em `< md`: o `refresh` some (o menu Configurações cobre o resto).
 | `refresh`    | Botão atualizar (`<ToolbarToolButton>`)                                                                                                                                         |
 | `search`     | Campo de busca (`<ToolbarSearch>`)                                                                                                                                              |
 | `filter`     | Filtro simples: use `<ToolbarFilterButton onClick isActive hasIndicator />` (funil, icon-only — **mesmo botão** no DataTable e DataList) → abre `<ToolbarSimpleFilterDrawer>`   |
-| `actions`    | Ações custom: `<ToolbarActions actions={[...]} />` (`button`/`dropdown`/`input`). Inline no desktop; **colapsam no ⋯ no mobile** (passe `extraItems` p/ absorver o ⋯ existente) |
+| `actions`    | Ações custom: `<ToolbarActions actions={[...]} />` (`button`/`dropdown`/`input`). Inline no desktop; **colapsam no ⋯ no mobile** (passe `extraItems` p/ absorver o ⋯ existente).<br><br>⚠️ **Este slot aceita qualquer nó** — `<ToolbarActions>` é só o uso comum. Pra um **componente** (um `DatePicker mode="range"` de período, um `Select` composto), passe-o direto aqui. Pelo `DataTable` o caminho é a prop `toolbar.customLeft`, que cai neste mesmo slot antes das `actions` — ela era **inerte até a v0.64.0** (declarada e lida por nada) |
 | `settings`   | Configurações: sliders → drill-down (`<ToolbarSettingsMenu>` com Ordenação · Colunas · Filtros avançados · Densidade)                                                           |
 | `more`       | Menu "⋯" (`<MoreMenu>`) — export + ações                                                                                                                                        |
 | `bulkBar`    | Substitui a toolbar inteira pela barra de ações em massa                                                                                                                        |

package/dist-lib/ai/global/componentes.md

@@ -131,6 +131,13 @@ sem passar pela entrevista guiada** (é justamente aí que o erro aparece):
      (`defaultViews`, ex.: "Ativos", "Pendentes"; `allowCreateView={false}` se forem fixas).
 2. **X não é coluna, pequeno e simples** (período/mês, um toggle) → `toolbar.actions`
    (máx ~2, label curta). Período que afeta a página toda → `PageHeader.actions` (dropdown).
+   **Precisa de um COMPONENTE na barra** (um `DatePicker mode="range"` de período)? →
+   `toolbar.customLeft` do `data-table`, que renderiza entre o refresh e a busca —
+   `toolbar.actions` não serve, seus kinds são `button/dropdown/input` e nenhum recebe
+   componente. ⚠️ **Exige o DS `0.64.0` ou mais novo**: em `0.63.0` e anteriores a
+   prop existe no tipo, o TS aceita e **nada renderiza** (era declarada e lida por nada).
+   Confira sua versão antes de prometer o controle — e note que o `data-list` **não tem**
+   esse slot, só `toolbarActions`.
 3. **Muitos filtros, ou muito grandes** → drawer "Filtros" **nativo** do `data-table` + chips
    pré-aplicados. Nunca empilhar selects soltos.
 

package/dist-lib/ai/manifest.json

@@ -1,8 +1,8 @@
 {
   "pacote": "@snksergio/design-system",
-  "versao": "0.63.0",
-  "commit": "d9db4cd",
-  "gerado": "2026-09-15",
+  "versao": "0.64.0",
+  "commit": "cb0a1bf",
+  "gerado": "2026-09-16",
   "conteudo": {
     "roteiros": [
       "app-builder",

package/dist-lib/ai/roteiros/crud-builder/entrevista.md

@@ -90,6 +90,12 @@ em lote ("CNPJ sem copyable"). Critério completo e limites: `generate.md` item
 >   `filterType`. Quer abrir já filtrado? **pré-aplique** (`defaultViews`/`presetView`
 >   ou `filterModel`) → abre com o **chip aplicado**, editável, reativo. Pode pré-setar
 >   **vários** (id/período/status/…), sem campos.
+> - **Componente na barra → `toolbar.customLeft`, não `actions`.** Os kinds de
+>   `ToolbarAction` são `button`/`dropdown`/`input` e nenhum recebe componente; pra um
+>   `DatePicker mode="range"` de período use `customLeft`, que renderiza entre o refresh e
+>   a busca. ⚠️ **Exige o DS `0.64.0` ou mais novo** — em `0.63.0` e anteriores a
+>   prop existe no tipo, o TS aceita e **nada renderiza**. Confira a versão antes de
+>   prometer o controle.
 > - **toolbar.actions é SÓ pra caso pequeno e simples que NÃO reage com coluna** (ex.:
 >   data/período, escopo) — **label curta**, **máx ~2**. Se mexe com coluna, é grande, ou
 >   são muitos → **NÃO use o toolbar.**
@@ -105,7 +111,8 @@ em lote ("CNPJ sem copyable"). Critério completo e limites: `generate.md` item
   deletar direto). Pergunte o texto do confirm.
 - Seleção + ações em massa (exportar, etc.)? (`selectionConfig` + bulk actions).
 - Export: escopo (tudo / filtrado / selecionado) + formato (csv)? (`toolbar.enableExport`).
-- Ação custom no toolbar (ex.: seletor de período/mês, botão extra)? `toolbar.actions: ToolbarAction[]` (`button`/`dropdown`/`input`) — inline no desktop, colapsa no ⋯ no mobile. Oferecer só se o usuário pedir.
+- Ação custom no toolbar (ex.: seletor de período por dropdown de meses, botão extra)? `toolbar.actions: ToolbarAction[]` (`button`/`dropdown`/`input`) — inline no desktop, colapsa no ⋯ no mobile. Oferecer só se o usuário pedir.
+- **Componente** na barra (calendário de período, `Select` composto)? `toolbar.customLeft: ReactNode` — entre o refresh e a busca, antes das `actions`. É o único caminho: `ToolbarAction` não tem kind que receba componente. ⚠️ Exige o DS `0.64.0`+; antes dele a prop é inerte e falha em silêncio.
 
 ## Fase 4 — Views, paginação & densidade
 

package/dist-lib/ai/roteiros/list-builder/entrevista.md

@@ -132,6 +132,11 @@ refresh · busca · filtro(drawer) · ⋯. Sem colunas/toggle de visão.
 > - **Filtro por campo** (status/categoria/tipo/data…) → declare em `filterFields`. Quer
 >   abrir já filtrado? **pré-aplique** via `views` ou `filterModel` → abre com o **chip
 >   aplicado**, editável, reativo. Pode pré-setar **vários** de uma vez.
+> - ⛔ **O `data-list` NÃO tem slot pra componente no toolbar.** O `data-table` ganhou
+>   `toolbar.customLeft` (`0.64.0`+); o `data-list` só tem `toolbarActions`, cujos kinds são
+>   `button`/`dropdown`/`input`. Seletor de período com calendário numa lista vai **fora**
+>   do componente (`PageHeader` ou linha própria). Não tente `customLeft` aqui — não
+>   existe e o TS reprova.
 > - **toolbarActions é SÓ pra caso pequeno e simples que NÃO reage com campo** (ex.:
 >   data/período, escopo) — **label curta**, **máx ~2**. Se mexe com os campos, é grande,
 >   ou são muitos → **NÃO use o toolbar.**

package/dist-lib/chunks/{panel-B-liPlxr.mjs → panel-CN0ChoHM.mjs}

@@ -12416,7 +12416,10 @@ function DataTableInternal(props, ref) {
                     }
                   )
                 ) : void 0,
-                actions: toolbarConfig.actions && toolbarConfig.actions.length > 0 ? /* @__PURE__ */ jsx(ToolbarActions, { actions: toolbarConfig.actions }) : void 0,
+                actions: toolbarConfig.customLeft || toolbarConfig.actions && toolbarConfig.actions.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+                  toolbarConfig.customLeft,
+                  toolbarConfig.actions && toolbarConfig.actions.length > 0 ? /* @__PURE__ */ jsx(ToolbarActions, { actions: toolbarConfig.actions }) : null
+                ] }) : void 0,
                 fullscreen: enableFullscreen ? /* @__PURE__ */ jsx(
                   ToolbarToolButton,
                   {
@@ -13167,4 +13170,4 @@ export {
   DEFAULT_FILTER_OPERATORS as y,
   DataTableActionsCell as z
 };
-//# sourceMappingURL=panel-B-liPlxr.mjs.map
+//# sourceMappingURL=panel-CN0ChoHM.mjs.map