@praxisui/table 1.0.0-beta.45 → 1.0.0-beta.47

package/README.md

@@ -48,6 +48,15 @@ Nota: a classe de tema é decisão do host (`.dark-theme` ou `.theme-dark`/`.the
 - **Acessibilidade**: WCAG 2.1 AA compliant
 - **Verificação de Schema**: ETag/If-None-Match com notificações (somente em customização)
 
+### 📄 Contrato Inline do Filtro
+
+- Referencia canonica: `projects/praxis-dynamic-fields/docs/filter-inline-components-guide.md`
+- No contexto da tabela, use este contrato para definir `controlType` inline e politica de compatibilidade (canonica vs legado).
+
+### 🧭 Decisoes de Arquitetura (ADR)
+
+- Bundle/adapters: `projects/praxis-table/docs/adr/2026-03-filter-drawer-adapter-light-entrypoint.md`
+
 ### 🎨 Editores Visuais
 
 - **Behavior Editor**: Configuração de comportamentos
@@ -708,7 +717,7 @@ onSchemaStatus(ev: { outdated: boolean; serverHash?: string; lastVerifiedAt?: st
 - O `PraxisFilter` busca schema do DTO de filtro via `/schemas/filtered` com ETag/If-None-Match
   e emite `metaChanged` com `{ schemaId, serverHash, context }`.
 - O schema é normalizado e `advancedConfig.metadata` é preenchido para auditoria/telemetria.
-- Detalhes: `docs/schemas/fluxo-schema.md` (cliente/caching, 200/304, reconciliadores Form/Filter).
+- Detalhes: `projects/praxis-core/docs/schema-flow.md` (canônico) e `docs/schemas/fluxo-schema.md` (resumo operacional) para cliente/caching, 200/304 e reconciliadores Form/Filter.
 
 ### Resolução da chave primária (idField)
 
@@ -1346,7 +1355,7 @@ Atalhos são “chips” que guardam um conjunto de filtros (DTO) para reuso rá
 - i18n
   - Chaves úteis: `saveAsShortcut`, `renameShortcut`, `removeShortcut`, `shortcutSaved`, `shortcutRemoved`, `undo`, `readonlyShortcut`.
 
-Veja também: “Guia de Integração — Hosts (filtro em gaveta)” em `docs/host-crud-integration.md` para detalhes do contrato do Adapter.
+Veja também: `docs/host-crud-integration.md` (guia operacional host) e `projects/praxis-crud/docs/host-crud-runtime-and-openmode.md` (contrato técnico canônico) para detalhes do contrato do Adapter.
 
 ### Novos Inputs/Outputs (PraxisFilter)
 
@@ -1415,6 +1424,35 @@ Exemplos práticos no workspace (rotas):
 - Regras Visuais (Simples): `/table-rules-simple`
 - Regras Visuais (Complexas): `/table-rules-complex`
 
+## Auto-render de Avatar (strict mode)
+
+No bootstrap de schema (quando `config.columns` esta vazio), a tabela detecta automaticamente colunas de avatar e aplica `renderer.type = 'avatar'`.
+
+Deteccao:
+- somente quando `FieldDefinition.controlType === 'avatar'`
+
+Renderer aplicado:
+- `renderer: { type: 'avatar', avatar: { srcField, initialsExpr, shape: 'circle', size: 28 } }`
+- alinhamento central e largura compacta (~56px)
+- `initialsExpr` com fallback para `nomeCompleto|nome|fullName|name|title`
+
+Comportamento importante:
+- a autodeteccao ocorre apenas no bootstrap (nao sobrescreve configuracoes de colunas persistidas)
+- se quiser desabilitar, defina renderer explicito na coluna (`image` ou `text`)
+- para cenarios sem `x-ui`, exponha renderer no config ou ajuste backend para enviar `x-ui.controlType`
+
+Ajustes comuns:
+- `renderer.avatar.shape`: `'square' | 'rounded' | 'circle'`
+- `renderer.avatar.size`: numero em px
+- `renderer.avatar.alt` / `altField`
+- use `conditionalRenderers` para variar renderer por linha
+
+A11y, seguranca e performance:
+- `alt`/`altField` sao respeitados
+- fallback para iniciais quando imagem falha/nao existe
+- URL da imagem sanitizada (bloqueia esquemas perigosos)
+- imagem com `loading=\"lazy\"`
+
 ## 📊 Roadmap
 
 ### Próximas Versões

package/fesm2022/praxisui-table-filter-drawer-adapter.mjs

@@ -0,0 +1,18 @@
+import { InjectionToken } from '@angular/core';
+
+function getFilterDrawerAdapterToken() {
+    const registryKey = '__PAX_FILTER_DRAWER_ADAPTER_TOKEN__';
+    const globalRegistry = globalThis;
+    if (!globalRegistry[registryKey]) {
+        globalRegistry[registryKey] = new InjectionToken('FILTER_DRAWER_ADAPTER');
+    }
+    return globalRegistry[registryKey];
+}
+const FILTER_DRAWER_ADAPTER = getFilterDrawerAdapterToken();
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { FILTER_DRAWER_ADAPTER };
+//# sourceMappingURL=praxisui-table-filter-drawer-adapter.mjs.map

package/fesm2022/praxisui-table-filter-drawer-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"praxisui-table-filter-drawer-adapter.mjs","sources":["../../../projects/praxis-table/filter-drawer-adapter/src/filter-drawer-adapter.ts","../../../projects/praxis-table/filter-drawer-adapter/praxisui-table-filter-drawer-adapter.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\nimport type { FormConfig } from '@praxisui/core';\n\n/**\n * Configuração de abertura do Advanced Filter em gaveta pelo host.\n *\n * Notas para hosts que exibem botão \"Salvar como atalho\":\n * - Exiba a ação apenas quando `allowSaveTags === true`.\n * - Para habilitar o botão, verifique se há ao menos um filtro efetivo no DTO (campos não vazios).\n * - Monte o DTO para salvar mesclando `initialDto` e o valor atual do formulário (`lastValue`),\n *   e limpe chaves com valores vazios ('' | null | undefined) antes de chamar `onSaveShortcut(dto)`.\n */\nexport interface FilterDrawerOpenConfig {\n  resourcePath: string;\n  formId: string;\n  config: FormConfig;\n  initialDto?: Record<string, any>;\n  title?: string;\n  onSubmit(dto: Record<string, any>): void;\n  onClose?(): void;\n  /** Permite que a UI do host exiba ação de salvar atalho (opcional, retrocompatível) */\n  allowSaveTags?: boolean;\n  /** Rótulo i18n para o botão de salvar atalho (opcional) */\n  i18nSaveAsShortcut?: string;\n  /** Callback disparado pelo host com o DTO atual quando o usuário optar por salvar um atalho */\n  onSaveShortcut?: (dto: Record<string, any>) => void;\n}\n\nexport interface FilterDrawerAdapter {\n  open(config: FilterDrawerOpenConfig): Promise<void> | void;\n}\n\nfunction getFilterDrawerAdapterToken(): InjectionToken<FilterDrawerAdapter> {\n  const registryKey = '__PAX_FILTER_DRAWER_ADAPTER_TOKEN__';\n  const globalRegistry = globalThis as typeof globalThis & {\n    [registryKey]?: InjectionToken<FilterDrawerAdapter>;\n  };\n  if (!globalRegistry[registryKey]) {\n    globalRegistry[registryKey] = new InjectionToken<FilterDrawerAdapter>('FILTER_DRAWER_ADAPTER');\n  }\n  return globalRegistry[registryKey];\n}\n\nexport const FILTER_DRAWER_ADAPTER = getFilterDrawerAdapterToken();\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;AAgCA,SAAS,2BAA2B,GAAA;IAClC,MAAM,WAAW,GAAG,qCAAqC;IACzD,MAAM,cAAc,GAAG,UAEtB;AACD,IAAA,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE;QAChC,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,cAAc,CAAsB,uBAAuB,CAAC;IAChG;AACA,IAAA,OAAO,cAAc,CAAC,WAAW,CAAC;AACpC;AAEO,MAAM,qBAAqB,GAAG,2BAA2B;;AC3ChE;;AAEG;;;;"}