@praxisui/core 7.0.0-beta.0 → 8.0.0-beta.1

package/README.md

@@ -59,6 +59,15 @@ Exemplo completo (app de referência)
 
 ### 1) `PraxisIconDirective`
 
+Hosts devem carregar Material Symbols para ícones `mso:*` e Material Icons classic quando usarem `mi:*`, componentes legados baseados em ligature classic, ou `mat-icon.material-icons`. Sem Material Icons classic, a ligature pode aparecer como texto visível, por exemplo `clear` dentro de um select.
+
+Para alinhar tokens e superfícies Angular Material/Praxis, importe o asset canônico do pacote depois do tema Angular Material e do CSS do CDK Overlay:
+
+```scss
+@import "@angular/cdk/overlay-prebuilt.css";
+@import "@praxisui/core/theme-bridge.css";
+```
+
 ```ts
 import { Component } from '@angular/core';
 import { MatIconModule } from '@angular/material/icon';
@@ -111,6 +120,59 @@ export class GridDemoComponent {
 
 Observação: os IDs de widgets usados na página devem estar registrados via `ComponentMetadataRegistry` para que o carregador dinâmico resolva os componentes.
 
+### Component config editors
+
+`ComponentDocMeta.configEditor` é a superfície pública canônica para um
+componente declarar como seus `definition.inputs` devem ser editados em hosts
+visuais como `praxis-dynamic-page` e `@praxisui/page-builder`.
+
+O editor pertence à lib dona da semântica do componente, não ao host. O host
+deve apenas descobrir `configEditor` via `ComponentMetadataRegistry`, abrir o
+componente no `SETTINGS_PANEL_BRIDGE` e aplicar/salvar o payload retornado.
+
+Contrato esperado:
+
+```ts
+registry.register({
+  id: 'praxis-rich-content',
+  selector: 'praxis-rich-content',
+  component: PraxisRichContent,
+  friendlyName: 'Praxis Rich Content',
+  configEditor: {
+    component: PraxisRichContentConfigEditor,
+    title: 'Configurar rich content',
+  },
+});
+```
+
+Payload recomendado para editores de inputs de widget:
+
+```ts
+{
+  inputs: {
+    // mesmo shape consumido por WidgetDefinition.definition.inputs
+  }
+}
+```
+
+Regra de plataforma: não crie editor local no host para uma semântica que já
+tem dono canônico. Corrija ou publique o `configEditor` no metadata da lib dona
+do componente.
+
+### Widget Shell body layout
+
+`WidgetShellConfig.bodyLayout` declares how projected widget content should use
+the shell body:
+
+- `content`: default natural document flow for tables, lists, forms and mixed content.
+- `fill`: makes the shell body a flex container whose direct child fills the usable body; use it for resizable charts, maps and canvases that own their viewport.
+- `scroll`: makes the shell body a flex container with body scrolling for content that may exceed the widget height.
+
+For corporate dashboards, pair chart contracts that use
+`sizing.mode = "fill-container"` with `bodyLayout: "fill"`. Avoid using `fill`
+for long textual content unless the widget supplies its own compact or empty
+state, because the fill body intentionally hides overflow.
+
 ## 📚 API Surface
 
 - Exports públicos: consulte o arquivo