@praxisui/page-builder 7.0.0-beta.0 → 8.0.0-beta.0

package/README.md

@@ -53,6 +53,7 @@ import { bootstrapApplication } from '@angular/platform-browser';
 import { PAGE_BUILDER_WIDGET_AI_CATALOGS, providePageBuilderWidgetAiCatalogs } from '@praxisui/page-builder';
 import { TABLE_AI_CAPABILITIES } from '@praxisui/table';
 import { CRUD_AI_CAPABILITIES } from '@praxisui/crud';
+import { RICH_CONTENT_AI_CAPABILITIES } from '@praxisui/rich-content';
 import { AppComponent } from './app/app.component';
 
 bootstrapApplication(AppComponent, {
@@ -62,6 +63,7 @@ bootstrapApplication(AppComponent, {
       useValue: {
         'praxis-table': TABLE_AI_CAPABILITIES,
         'praxis-crud': CRUD_AI_CAPABILITIES,
+        'praxis-rich-content': RICH_CONTENT_AI_CAPABILITIES,
       },
     },
     providePageBuilderWidgetAiCatalogs(),
@@ -75,10 +77,12 @@ Registro manual (util para apps que precisam customizar o mapa):
 import { registerWidgetAiCatalogs } from '@praxisui/page-builder';
 import { TABLE_AI_CAPABILITIES } from '@praxisui/table';
 import { CRUD_AI_CAPABILITIES } from '@praxisui/crud';
+import { RICH_CONTENT_AI_CAPABILITIES } from '@praxisui/rich-content';
 
 registerWidgetAiCatalogs({
   'praxis-table': TABLE_AI_CAPABILITIES,
   'praxis-crud': CRUD_AI_CAPABILITIES,
+  'praxis-rich-content': RICH_CONTENT_AI_CAPABILITIES,
 });
 ```
 
@@ -101,10 +105,32 @@ providers: [
 ]
 ```
 
+## Component Config Editors
+
+O page-builder não deve implementar editores locais para os inputs de cada
+widget. Quando um componente registra `ComponentDocMeta.configEditor`, o runtime
+canônico (`praxis-dynamic-page`) injeta a ação "Configurar conteudo" no shell do
+widget e abre o editor declarado pelo dono do componente.
+
+Fluxo canônico:
+
+- a lib dona registra `configEditor` em `ComponentMetadataRegistry`
+- o page-builder habilita customization e fornece `SETTINGS_PANEL_BRIDGE`
+- o editor recebe `{ inputs, widgetKey, widgetType }`
+- `Apply` atualiza `definition.inputs` sem fechar o painel; ele não é rollback transacional e pode ser observado pelo host imediatamente
+- `Save` atualiza `definition.inputs` e persiste a página quando houver `pageIdentity`
+- `Reset` restaura o estado interno do editor para o snapshot aberto; ele não desfaz automaticamente um `Apply` já emitido ao runtime/host
+
+Exemplo com `praxis-rich-content`: o editor canônico é
+`PraxisRichContentConfigEditor`, publicado por `@praxisui/rich-content`. Ele
+edita `definition.inputs.document`, `layout` e `rootClassName` sem criar uma DSL
+local de page-builder para blocos ricos.
+
 Catalogos conhecidos (exports):
 - `TABLE_AI_CAPABILITIES` - `@praxisui/table` (`praxis-table`)
 - `CRUD_AI_CAPABILITIES` - `@praxisui/crud` (`praxis-crud`)
 - `LIST_AI_CAPABILITIES` - `@praxisui/list` (`praxis-list`)
+- `RICH_CONTENT_AI_CAPABILITIES` - `@praxisui/rich-content` (`praxis-rich-content`)
 - `FORM_AI_CAPABILITIES` - `@praxisui/dynamic-form` (`praxis-dynamic-form`)
 - `FILES_UPLOAD_AI_CAPABILITIES` - `@praxisui/files-upload` (`praxis-files-upload`)
 - `STEPPER_AI_CAPABILITIES` - `@praxisui/stepper` (`praxis-stepper`)
@@ -126,6 +152,12 @@ O builder canonico expoe authoring de shell/palette sobre `praxis-dynamic-page`.
 
 `page` e um `WidgetPageDefinition` (do `@praxisui/core`) contendo `widgets` e opcionalmente `composition.links`. O envelope `composition` e o caminho `composition.links` formam a superficie canonica persistida para wiring da pagina, com `condition` em Json Logic e `policy` para comportamento operacional.
 
+Para conteudo editorial rico dentro da pagina, use um widget `praxis-rich-content`
+com `definition.inputs.document: RichContentDocument`. Isso evita criar uma DSL
+local de page-builder para cards, imagens, timelines ou blocos de apresentacao,
+e preserva `WidgetPageDefinition.widgets` como superficie unica de ocupacao do
+canvas.
+
 ## Widget Shell (Dashboard Cards)
 
 Cada widget pode declarar um `shell` para renderizar um card padronizado com cabecalho rico, acoes de contexto e controles de janela (expandir/recolher).

package/fesm2022/praxisui-page-builder.mjs

@@ -9,7 +9,7 @@ import { MAT_DIALOG_DATA, MatDialogModule } from '@angular/material/dialog';
 import * as i3 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
 import * as i2$2 from '@praxisui/core';
-import { PraxisIconDirective, BUILTIN_SHELL_PRESETS, SETTINGS_PANEL_DATA as SETTINGS_PANEL_DATA$1, providePraxisI18n, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PraxisI18nService, generateId, SETTINGS_PANEL_BRIDGE, DynamicWidgetPageComponent, DYNAMIC_PAGE_SHELL_EDITOR } from '@praxisui/core';
+import { PraxisIconDirective, BUILTIN_SHELL_PRESETS, SETTINGS_PANEL_DATA as SETTINGS_PANEL_DATA$1, providePraxisI18n, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, PraxisI18nService, ComponentMetadataRegistry, generateId, SETTINGS_PANEL_BRIDGE, DynamicWidgetPageComponent, DYNAMIC_PAGE_SHELL_EDITOR } from '@praxisui/core';
 export { WidgetShellComponent } from '@praxisui/core';
 import * as i4 from '@angular/material/tooltip';
 import { MatTooltipModule } from '@angular/material/tooltip';
@@ -4614,6 +4614,8 @@ const PAGE_BUILDER_AI_CAPABILITIES = {
     ],
     notes: [
         'page segue o modelo canonico WidgetPageDefinition (widgets, composition.links, context e state opcional).',
+        'Conteudo editorial rico deve ser modelado como widget praxis-rich-content com definition.inputs.document: RichContentDocument, nao como DSL local do page-builder.',
+        'Edicao visual de inputs de widget deve usar ComponentDocMeta.configEditor publicado pela lib dona do componente; nao criar editor local no page-builder para semantica de outro pacote.',
         'Canvas e o modelo espacial canonico da pagina quando houver posicionamento explicito.',
         'Taxonomia editorial: condition usa Json Logic canonico; transform usa pipeline declarativo; policy cobre apenas comportamento operacional.',
         'Payloads legados de layout ainda podem ser ingeridos, mas sao normalizados para canvas e nao devem ser reemitidos.',
@@ -4656,7 +4658,11 @@ const PAGE_BUILDER_AI_CAPABILITIES = {
         { path: 'page.widgets[].definition', category: 'widgets', valueKind: 'object', description: 'Definicao do widget (WidgetDefinition).' },
         { path: 'page.widgets[].definition.id', category: 'widgets', valueKind: 'string', description: 'ID do componente registrado.' },
         { path: 'page.widgets[].definition.inputs', category: 'widgets', valueKind: 'object', description: 'Inputs do componente.' },
+        { path: 'page.widgets[].definition.inputs.document', category: 'widgets', valueKind: 'object', description: 'RichContentDocument quando definition.id for praxis-rich-content.' },
         { path: 'page.widgets[].definition.bindingOrder', category: 'widgets', valueKind: 'array', description: 'Ordem de aplicacao dos inputs.' },
+        { path: 'ComponentDocMeta.configEditor', category: 'widgets', valueKind: 'object', description: 'Editor canonico de inputs publicado pela lib dona do componente e aberto pelo settings-panel do host.' },
+        { path: 'ComponentDocMeta.configEditor.component', category: 'widgets', valueKind: 'object', description: 'Componente standalone que implementa SettingsValueProvider para editar definition.inputs.' },
+        { path: 'ComponentDocMeta.configEditor.title', category: 'widgets', valueKind: 'string', description: 'Titulo opcional usado pelo host ao abrir o editor de inputs do componente.' },
         { path: 'page.composition', category: 'connections', valueKind: 'object', description: 'Envelope canonico da composicao persistida.' },
         { path: 'page.composition.version', category: 'connections', valueKind: 'string', description: 'Versao do envelope de composicao.' },
         { path: 'page.composition.links', category: 'connections', valueKind: 'array', description: 'Links canonicos entre widgets e estado.' },
@@ -5320,6 +5326,7 @@ class DynamicPageBuilderComponent {
     dialog;
     settingsPanel;
     i18n = inject(PraxisI18nService);
+    componentMetadata = inject(ComponentMetadataRegistry);
     runtime;
     page;
     context = null;
@@ -5372,7 +5379,7 @@ class DynamicPageBuilderComponent {
     addWidget(type) {
         const next = this.clonePage(this.currentPage());
         const key = `${type}-${generateId()}`;
-        const widgets = [...(next.widgets || []), { key, definition: { id: type, inputs: {} } }];
+        const widgets = [...(next.widgets || []), { key, definition: { id: type, inputs: this.defaultInputsFor(type) } }];
         next.widgets = widgets;
         if (next.canvas) {
             const lastRow = Math.max(1, ...Object.values(next.canvas.items || {}).map((item) => (item.row + item.rowSpan) - 1));
@@ -5423,6 +5430,22 @@ class DynamicPageBuilderComponent {
     clonePage(page) {
         return JSON.parse(JSON.stringify(page));
     }
+    defaultInputsFor(type) {
+        const metadata = this.componentMetadata.get(type);
+        const inputs = {};
+        for (const input of metadata?.inputs ?? []) {
+            if (input.default !== undefined) {
+                inputs[input.name] = this.cloneValue(input.default);
+            }
+        }
+        return inputs;
+    }
+    cloneValue(value) {
+        if (value == null || typeof value !== 'object') {
+            return value;
+        }
+        return JSON.parse(JSON.stringify(value));
+    }
     tx(key, fallback) {
         return resolvePraxisPageBuilderText(this.i18n, key, fallback);
     }

package/index.d.ts

@@ -249,7 +249,7 @@ declare class DynamicPageConfigEditorComponent implements OnInit, SettingsValueP
     readonly canvasColumnsControl: FormControl<number>;
     readonly canvasRowUnitControl: FormControl<string>;
     readonly canvasGapControl: FormControl<string>;
-    readonly canvasAutoRowsControl: FormControl<"fixed" | "content">;
+    readonly canvasAutoRowsControl: FormControl<"content" | "fixed">;
     readonly layoutPresetControl: FormControl<string>;
     readonly themePresetControl: FormControl<string>;
     readonly shellPresetControl: FormControl<string>;
@@ -600,6 +600,7 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     private dialog;
     private settingsPanel;
     private readonly i18n;
+    private readonly componentMetadata;
     runtime?: DynamicWidgetPageComponent;
     page?: WidgetPageDefinition | string;
     context?: Record<string, unknown> | null;
@@ -626,6 +627,8 @@ declare class DynamicPageBuilderComponent implements OnChanges {
     focusCanvasWidget(widgetKey: string): void;
     private parsePage;
     private clonePage;
+    private defaultInputsFor;
+    private cloneValue;
     tx(key: string, fallback: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicPageBuilderComponent, [null, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DynamicPageBuilderComponent, "praxis-dynamic-page-builder", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showSettingsButton": { "alias": "showSettingsButton"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/page-builder",
-  "version": "7.0.0-beta.0",
+  "version": "8.0.0-beta.0",
   "description": "Page and widget builder utilities for Praxis UI (grid, dynamic widgets, editors).",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
@@ -8,8 +8,8 @@
     "@angular/forms": "^20.0.0",
     "@angular/cdk": "^20.0.0",
     "@angular/material": "^20.0.0",
-    "@praxisui/core": "^7.0.0-beta.0",
-    "@praxisui/settings-panel": "^7.0.0-beta.0"
+    "@praxisui/core": "^8.0.0-beta.0",
+    "@praxisui/settings-panel": "^8.0.0-beta.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"