@praxisui/table 9.0.4 → 9.0.5-rc.10

package/README.md

@@ -244,6 +244,39 @@ const config: TableConfig = {
 };
 ```
 
+### Adaptive toolbar composition
+
+`PraxisTableToolbar` materializes the toolbar as semantic regions rather than one wrapping row:
+
+- **identity** — title, subtitle and table context;
+- **query** — quick filters, always-visible dynamic filters and projected query shortcuts;
+- **commands** — collection/business actions, table utilities and authoring entrypoints.
+
+The runtime owns the responsive composition through container queries. This is important when a table
+is rendered inside a drawer, split pane or dashboard card: behavior follows the width actually available
+to the table, not only the browser viewport. At wide widths, identity and commands share the first band
+and query controls use a stable second band. At compact widths, the regions move as complete units and
+commands are consolidated under one localized `Mais ações` entrypoint without losing export, column or
+density controls.
+
+Authoring guidance:
+
+- use `toolbar.filters.quickFilters` for a small governed scope switch, not as a substitute for every filter;
+- use `advancedFilters.settings.alwaysVisibleFields` for frequent editable criteria;
+- keep one clear collection/business action primary; export, columns and density are utilities;
+- project custom shortcuts through the toolbar slots, but do not target internal layout classes from the host;
+- validate the component container at `1440`, `1024`, `768`, `480` and `320` px, including long localized labels, zoom and keyboard focus.
+
+Adding filters or actions never requires a host breakpoint. When the command set grows, the compact menu
+preserves capability parity and keyboard order while the query region remains independently scroll-free at
+the page level.
+
+The existing `toolbar.layout` fields are materialized by the same runtime: `alignment` aligns the identity
+and command regions, `padding` and `backgroundColor` project governed chrome, `height` defines the minimum
+toolbar height, and `showSeparator` adds the boundary with the data surface. `toolbar.appearance.tokens.bg`
+remains the most specific background override, followed by `toolbar.layout.backgroundColor` and the legacy
+`actionsBackgroundColor` projection.
+
 ## Filtering And Row Actions
 
 The package exports both the table runtime and `PraxisFilter` integration surfaces.
@@ -251,6 +284,10 @@ The package exports both the table runtime and `PraxisFilter` integration surfac
 - Inline and advanced filter controls use `@praxisui/dynamic-fields` contracts.
 - Row actions can be declared in `config.actions.row.actions`.
 - Contextual row discovery can use backend HATEOAS/capabilities when enabled.
+- Configured row actions that depend on contextual discovery stay visible but disabled while their
+  capabilities/actions are unresolved. The runtime enables them only after backend metadata proves
+  availability; transient errors and missing discovered operations fail closed. Actions with an
+  explicit `globalAction` or `recordSurface` remain governed by that declared execution contract.
 - `visibleWhen` and `disabledWhen` use canonical JSON Logic.
 - Inline and overflow actions preserve their actionable origin. Overflow menus finish closing and restore the trigger before emitting the action, allowing dialogs and drawers with `restoreFocus` to return keyboard focus to the correct table control.
 

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-11T17:36:05.628Z",
+  "generatedAt": "2026-08-12T23:49:15.227Z",
   "packageName": "@praxisui/table",
-  "packageVersion": "9.0.4",
+  "packageVersion": "9.0.5-rc.10",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 3,
@@ -5733,7 +5733,7 @@
             "preserve",
             "fill-compatible"
           ],
-          "description": "Define se linhas parciais com dois campos ou mais preservam os spans canônicos ou redistribuem apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
+          "description": "Define se cada linha visual parcial, depois de resolver visibilidade responsiva, CSS order e wrap, preserva os spans canônicos ou redistribui apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
           "safetyNotes": "fill-compatible é uma projeção transitória do runtime: não altera x-ui.width nem persiste sections. Controles compactos, uploads e tipos desconhecidos preservam a largura canônica."
         },
         {
@@ -6361,9 +6361,9 @@
         {
           "chunkIndex": 10,
           "chunkKind": "capabilities",
-          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.partialRowStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se linhas parciais com dois campos ou mais preservam os spans canônicos ou redistribuem apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
+          "content": "Schema Capability:\n  - Path: fieldMetadata[].transformDisplayValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para exibição.\n\nSchema Capability:\n  - Path: fieldMetadata[].transformSaveValue\n    Category: transform\n    Kind: expression\n    Description: Transforma valor para salvar.\n\nSchema Capability:\n  - Path: fieldMetadata[].textTransformApply\n    Category: transform\n    Kind: enum\n    Description: Quando aplicar transformação de texto.\n\nSchema Capability:\n  - Path: fieldMetadata[].inlineEditing\n    Category: behavior\n    Kind: boolean\n    Description: Permite edição inline (tabelas).\n\nSchema Capability:\n  - Path: fieldMetadata[].unique\n    Category: validation\n    Kind: boolean\n    Description: Valida unicidade no backend.\n\nSchema Capability:\n  - Path: fieldMetadata[].readOnly\n    Category: behavior\n    Kind: boolean\n    Description: Campo somente leitura.\n\nSchema Capability:\n  - Path: fieldMetadata[].disabled\n    Category: behavior\n    Kind: boolean\n    Description: Campo desabilitado.\n\nSchema Capability:\n  - Path: fieldMetadata[].defaultValue\n    Category: data\n    Kind: object\n    Description: Valor inicial do campo.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaLabel\n    Category: accessibility\n    Kind: string\n    Description: Label para leitores de tela.\n\nSchema Capability:\n  - Path: fieldMetadata[].ariaDescribedBy\n    Category: accessibility\n    Kind: string\n    Description: IDs de descrição acessível.\n\nSchema Capability:\n  - Path: fieldMetadata[].tabIndex\n    Category: accessibility\n    Kind: number\n    Description: Ordem de tabulacao para teclado.\n\nSchema Capability:\n  - Path: fieldMetadata[].accessKey\n    Category: accessibility\n    Kind: string\n    Description: Atalho de teclado (accessKey).\n\nComponent Capability:\n  - Path: inputs.resourcePath\n    Category: inputs\n    Kind: string\n    Description: Caminho do recurso para carregar/salvar dados via CRUD.\n\nComponent Capability:\n  - Path: inputs.resourceId\n    Category: inputs\n    Kind: string\n    Description: ID do registro atual (string ou number).\n\nComponent Capability:\n  - Path: inputs.initialValue\n    Category: inputs\n    Kind: object\n    Description: Valores iniciais locais para campos host-authored ou complementares.\n\nComponent Capability:\n  - Path: inputs.mode\n    Category: inputs\n    Kind: enum\n    Description: Modo do formulario (create/edit/view).\n\nComponent Capability:\n  - Path: inputs.config\n    Category: inputs\n    Kind: object\n    Description: Configuracao completa do formulario (FormConfig).\n\nComponent Capability:\n  - Path: inputs.schemaSource\n    Category: inputs\n    Kind: enum\n    Description: Fonte de schema para construcao automatica (resource/filter).\n\nComponent Capability:\n  - Path: inputs.schemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema canonico explicito publicado pelo backend para hosts que seguem surfaces/actions/capabilities.\n\nComponent Capability:\n  - Path: inputs.readUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de leitura publicado por surface VIEW/READ_PROJECTION para hidratar a entidade exibida.\n\nComponent Capability:\n  - Path: inputs.apiEndpointKey\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico usado para resolver schemaUrl, readUrl e submitUrl relativos em hosts destacados.\n\nComponent Capability:\n  - Path: inputs.submitUrl\n    Category: inputs\n    Kind: string\n    Description: Endpoint canonico de submit publicado por surface/action.\n\nComponent Capability:\n  - Path: inputs.submitMethod\n    Category: inputs\n    Kind: enum\n    Description: Metodo HTTP canonico para o submit quando o backend publica operacao explicita.\n\nComponent Capability:\n  - Path: inputs.submitIdempotencyKey\n    Category: inputs\n    Kind: string\n    Description: Identidade estavel da tentativa de comando, materializada a partir da politica execution da action.\n\nComponent Capability:\n  - Path: inputs.submitCorrelationId\n    Category: inputs\n    Kind: string\n    Description: Identificador de correlacao governado para rastreabilidade ponta a ponta do comando.\n\nComponent Capability:\n  - Path: inputs.submitResourceVersion\n    Category: inputs\n    Kind: string\n    Description: Versao persistida esperada, transportada como If-Match quando exigida pela action.\n\nComponent Capability:\n  - Path: inputs.responseSchemaUrl\n    Category: inputs\n    Kind: string\n    Description: Schema de resposta publicado pelo backend para inspeção diagnostica/read-only do host.\n\nComponent Capability:\n  - Path: inputs.enableCustomization\n    Category: inputs\n    Kind: boolean\n    Description: Habilita a edicao de layout/configuracao no editor.\n\nComponent Capability:\n  - Path: inputs.showAiAssistant\n    Category: inputs\n    Kind: boolean\n    Description: Mostra os gatilhos do copiloto semantico Praxis para a instancia do formulario.\n\nComponent Capability:\n  - Path: inputs.formId\n    Category: inputs\n    Kind: string\n    Description: ID persistente para salvar configuracoes e preferencias.\n\nComponent Capability:\n  - Path: inputs.editorialContext\n    Category: inputs\n    Kind: object\n    Description: Override de contexto editorial fornecido pelo host para os blocos hospedados antes/depois do formulario.\n\nComponent Capability:\n  - Path: inputs.layout\n    Category: inputs\n    Kind: object\n    Description: Layout legado (FormLayout). Preferir inputs.config + sections.\n\nComponent Capability:\n  - Path: inputs.generatedLayoutPreset\n    Category: inputs\n    Kind: enum\n    Description: Preset usado somente na criacao inicial de FormConfig a partir de schema/metadata.\n\nComponent Capability:\n  - Path: inputs.configPersistenceStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se preferências locais persistidas ou o contrato explícito do host governam a materialização corrente.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy\n    Category: inputs\n    Kind: object\n    Description: Politica opt-in para materializar layout diretamente do schema atual sem depender de FormConfig.sections authoradas.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.source\n    Category: inputs\n    Kind: enum\n    Description: Define se o layout vem de configuracao authorada ou do schema.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.preset\n    Category: inputs\n    Kind: enum\n    Description: Preset de layout schema-driven. compactPresentation cobre detalhe read-only; groupedCommand cobre create/edit.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.intent\n    Category: inputs\n    Kind: enum\n    Description: Intencao da surface: detalhe/apresentacao ou comando/editavel.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.lifecycle\n    Category: inputs\n    Kind: enum\n    Description: Ciclo de materializacao do layout schema-driven.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.persistence\n    Category: inputs\n    Kind: enum\n    Description: Define se sections geradas sao transient ou podem virar layout authorado apos detach explicito.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.orphanFieldExpansion\n    Category: inputs\n    Kind: enum\n    Description: Define como uma linha groupedCommand com um unico campo usa o espaco restante. O default medium-and-wide expande spans 6 ou 8 e preserva campos compactos.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.contextFields\n    Category: inputs\n    Kind: array\n    Description: Campos canônicos do request cujo valor vem do contexto da surface. Eles permanecem no FormGroup e no payload, sem renderizar controles redundantes.\n\nComponent Capability:\n  - Path: inputs.layoutPolicy.groupedCommand.partialRowStrategy\n    Category: inputs\n    Kind: enum\n    Description: Define se cada linha visual parcial, depois de resolver visibilidade responsiva, CSS order e wrap, preserva os spans canônicos ou redistribui apenas campos compatíveis para completar 12 colunas no breakpoint atual.",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/ai/form-ai-capabilities.ts",
-          "contentHash": "d8ba06c1f0006e7d3189b75d8329245c840d75d84d753c6dfccc480a4880d347",
+          "contentHash": "a05a482e5873ff1de353543220891daaa3867cea957150def37ea50539a20c21",
           "sourceKind": "component_definition",
           "sourceId": "praxis-filter-form-dialog-host",
           "corpusVersion": "1.0.0"