@praxisui/page-builder 3.0.0-beta.7 → 3.0.0-beta.9

package/README.md

@@ -1,6 +1,6 @@
 # @praxisui/page-builder
 
-Ferramentas de edicao para paginas dinamicas baseadas em Gridster, com builders visuais, palette, graph e integracao com `@praxisui/settings-panel`.
+Ferramentas de edicao para paginas dinamicas canonicas baseadas em `praxis-dynamic-page`, com builders visuais, palette, graph e integracao com `@praxisui/settings-panel`.
 
 ## Documentation
 
@@ -14,7 +14,7 @@ Ferramentas de edicao para paginas dinamicas baseadas em Gridster, com builders
 - Entregar experiencia de builder para usuarios internos ou squads de configuracao
 - Integrar page composition com IA, settings panel e contratos compartilhados do Praxis UI
 
-Inclui o conjunto de editores (Builder, Graph), paleta de componentes e toolbars para montar e inspecionar conexões entre widgets definidos por metadata (`GridPageDefinition` do `@praxisui/core`). Integra com o `@praxisui/settings-panel` para abrir editores em painel lateral e oferece um modo de diálogo fullscreen para edição visual.
+Inclui o conjunto de editores (Builder, Graph), paleta de componentes e toolbars para montar e inspecionar conexões entre widgets definidos por metadata (`WidgetPageDefinition` do `@praxisui/core`). Integra com o `@praxisui/settings-panel` para abrir editores em painel lateral e oferece um modo de diálogo fullscreen para edição visual.
 
 ## Instalação
 
@@ -28,13 +28,12 @@ Peer dependencies (Angular v20):
 - `@angular/forms` `^20.0.0`
 - `@angular/cdk` `^20.0.0`
 - `@angular/material` `^20.0.0`
-- `angular-gridster2` `^20.2.2`
 - `@praxisui/core` `*`
 - `@praxisui/settings-panel` `*`
 
 ## Visão Geral
 
-Este pacote expõe os editores e utilitários usados pelo componente de página dinâmica (Gridster):
+Este pacote expõe os editores e utilitários usados pelo builder canônico de página dinâmica:
 - `ConnectionBuilderComponent` — lista e edita conexões (from.output → to.input) com filtros, agrupamentos e validação.
 - `ConnectionGraph` (uso integrado) — visualiza nós/portas/arestas; suporta arrastar para criar conexões e abrir o Builder.
 - `ComponentPaletteDialog` — paleta para adicionar widgets à página.
@@ -114,17 +113,17 @@ Catálogos conhecidos (exports):
 - `TABS_AI_CAPABILITIES` — `@praxisui/tabs` (`praxis-tabs`)
 - `EXPANSION_AI_CAPABILITIES` — `@praxisui/expansion` (`praxis-expansion`)
 
-## Quick Start (usando a página Gridster)
+## Quick Start
 
-O componente de página dinâmica (parte do workspace) expõe métodos utilitários para abrir editores. Exemplo de uso no template:
+O builder canônico expõe os métodos utilitários de authoring sobre `praxis-dynamic-page`. Exemplo de uso no template:
 
 ```html
-<praxis-dynamic-gridster-page
+<praxis-dynamic-page-builder
   #page
   [page]="page"
   [enableCustomization]="true"
   (pageChange)="onPageChange($event)">
-</praxis-dynamic-gridster-page>
+</praxis-dynamic-page-builder>
 
 <!-- Ações auxiliares -->
 <button (click)="page.openConnectionsGraph()">Conexões (Graph)</button>
@@ -132,7 +131,7 @@ O componente de página dinâmica (parte do workspace) expõe métodos utilitár
 <button (click)="page.openConnectionsEditor()">Editor Visual (Dialog)</button>
 ```
 
-`page` é um `GridPageDefinition` (do `@praxisui/core`) contendo `widgets` e opcionalmente `connections`.
+`page` é um `WidgetPageDefinition` (do `@praxisui/core`) contendo `widgets` e opcionalmente `connections`.
 
 ## Widget Shell (Dashboard Cards)
 
@@ -232,13 +231,13 @@ Para abrir o Builder/Graph em um painel lateral, injete o `SettingsPanelService`
 import { Component } from '@angular/core';
 import { SettingsPanelService } from '@praxisui/settings-panel';
 import { ConnectionBuilderComponent } from '@praxisui/page-builder';
-import type { GridPageDefinition, GridWidgetInstance } from '@praxisui/core';
+import type { WidgetInstance, WidgetPageDefinition } from '@praxisui/core';
 
 @Component({ selector: 'app-page-tools', standalone: true })
 export class PageToolsComponent {
   constructor(private settings: SettingsPanelService) {}
 
-  openBuilder(page: GridPageDefinition, widgets: GridWidgetInstance[]) {
+  openBuilder(page: WidgetPageDefinition, widgets: WidgetInstance[]) {
     this.settings.open({
       id: 'grid-connections:builder',
       title: 'Conexões (Builder)',
@@ -257,7 +256,7 @@ O fluxo visual completo pode ser aberto em diálogo Material (fullscreen). Caso
 ## Dicas
 - O Builder valida se o `output` existe no widget de origem e se o `input` existe no destino.
 - No Graph, ativar “Mostrar portas não conectadas” ajuda a descobrir possibilidades de ligação.
-- Tanto Builder quanto Graph funcionam com `GridPageDefinition` em string (JSON) ou objeto.
+- Tanto Builder quanto Graph funcionam com `WidgetPageDefinition` em string (JSON) ou objeto.
 
 ## API (resumo)