@praxisui/dialog 8.0.0-beta.104 → 8.0.0-beta.105

package/README.md

@@ -41,21 +41,34 @@ last_updated: "2026-03-07"
 
 # @praxisui/dialog
 
-> Unified dialog for Praxis built on Angular CDK. Provides a service API (MatDialog-like) and a tag mode (`<praxis-dialog>`) with theming, CSS-only animations, accessibility and metadata integration.
+`@praxisui/dialog` nao e apenas uma camada sobre Angular CDK. Ele publica uma superficie governada para overlays, confirmacoes, presets globais, componentes registrados e acoes de host que precisam manter acessibilidade, tema e politica operacional no mesmo contrato.
 
-## Documentation
+## O que publica por contrato
 
-- Official documentation: https://praxisui.dev
-- Quickstart reference app: https://github.com/codexrodrigues/praxis-ui-quickstart
-- Recommended for: Angular hosts that need an accessible overlay/dialog API aligned with Praxis theming and metadata workflows
+- `PraxisDialog` como service API para abrir confirms, componentes, templates e conteudo registrado.
+- tag mode `<praxis-dialog>` para hosts que precisam embutir uma surface controlada no template.
+- presets globais e variantes para padronizar tamanho, animacao, backdrop, close policy e tema.
+- registries de componentes/templates para resolver conteudo por identificador governado.
+- integracao com global actions para abrir dialogs a partir de fluxos metadata-driven.
+- outputs e refs de fechamento para devolver resultado ao host sem esconder o efeito de negocio.
 
-## When to use
+## O que resolve alem do equivalente basico
 
-- Open confirms, modals and side interactions with a consistent service API
-- Keep dialog behavior aligned with host theming, accessibility and metadata contracts
-- Replace ad hoc overlay implementations with a governed Praxis pattern
+- centraliza confirms e overlays em uma API institucional, em vez de cada tela reimplementar `MatDialog`.
+- aplica presets e acessibilidade de forma consistente entre service, tag mode e acoes globais.
+- permite que dialogs participem de fluxos metadata-driven sem acoplar a tela ao componente concreto.
+- separa shell visual, conteudo hospedado e decisao de negocio final.
+- preserva uma fronteira clara entre runtime de overlay e politica corporativa do host.
 
-The diagram below shows the intended ownership model: the host triggers the dialog service, Praxis Dialog applies presets and accessibility semantics, and the final overlay stays aligned with host theme and policy.
+## O que o host governa
+
+- quais componentes/templates entram nos registries.
+- autorizacao, efeitos de negocio, persistencia e handlers finais apos `afterClosed`.
+- politica de abertura para fluxos sensiveis, destrutivos ou dependentes de dominio.
+- tema global, tokens, textos e presets permitidos por produto.
+- quando usar service API, tag mode ou global action.
+
+O diagrama abaixo mostra o ownership esperado: o host dispara o service, Praxis Dialog aplica contrato, presets e acessibilidade, e o resultado volta para o host executar a decisao operacional.
 
 ```mermaid
 flowchart LR
@@ -66,6 +79,27 @@ flowchart LR
   overlay --> result["afterClosed / host action"]
 ```
 
+## Capacidades contratuais
+
+- confirm, alert e dialogs customizados via service.
+- abertura por componente, template ou registry id.
+- modo tag para overlays controlados pelo template do host.
+- presets globais por tipo e variante.
+- integracao com global actions e component metadata registry.
+- foco, ESC, restore focus, `aria-modal` e roles `dialog`/`alertdialog`.
+
+## Limites e riscos reais
+
+- Dialog nao substitui autorizacao nem regra de negocio do host.
+- registries precisam ser governados; ids soltos viram acoplamento oculto.
+- presets globais devem padronizar UX, nao mascarar flows de dominio inconsistentes.
+- conteudo pesado ou multi-step pode exigir CRUD, Dynamic Form ou Stepper dentro do dialog, nao logica duplicada no overlay.
+
+## Trilha documental
+
+- Hub publicado: [Dialog](/components/dialog)
+- Guia host: [Dialog host integration](/components/dialog/docs/integration)
+
 ## Install
 
 ```bash

package/fesm2022/praxisui-dialog.mjs

@@ -722,6 +722,21 @@ class PraxisDialog {
         }
         catch { }
         const subAction = container.action.subscribe((a) => {
+            const shouldSubmitPrompt = !a.close &&
+                a.id === 'ok' &&
+                config?.data?.mode === 'prompt' &&
+                !config?.disableClose;
+            if (shouldSubmitPrompt) {
+                const content = ref.componentInstance;
+                const submit = content?.submit;
+                if (typeof submit === 'function') {
+                    submit();
+                }
+                else {
+                    ref.close((content?.value ?? ''));
+                }
+                return;
+            }
             if (a.close && !config?.disableClose) {
                 ref.close(a.payload);
             }
@@ -1108,7 +1123,9 @@ function buildDialogConfig(payload) {
 function buildHostInputs(payload, context, options) {
     return {
         subtitle: options?.includeSubtitle === false ? undefined : payload.subtitle,
+        beforeWidget: payload.beforeWidget,
         widget: payload.widget,
+        afterWidget: payload.afterWidget,
         context: {
             ...(payload.context || {}),
             actionContext: context || null,
@@ -1116,9 +1133,40 @@ function buildHostInputs(payload, context, options) {
             pageContext: context?.pageContext,
             meta: context?.meta,
             runtime: context?.runtime,
+            ...(options?.surfaceRuntime
+                ? { surfaceRuntime: options.surfaceRuntime }
+                : {}),
         },
     };
 }
+function buildDialogSurfaceRuntime(ref, resultSubject) {
+    return {
+        closed$: ref.afterClosed(),
+        result$: resultSubject.asObservable(),
+        emitResult: (result) => resultSubject.next(result),
+        close: (result) => { void ref.close(result); },
+        updateSize: (preset) => {
+            const width = resolveDialogWidth(preset);
+            if (width) {
+                ref.updateSize(width);
+            }
+        },
+    };
+}
+function resolveDialogWidth(preset) {
+    switch (preset) {
+        case 'narrow':
+            return '420px';
+        case 'default':
+            return '720px';
+        case 'wide':
+            return '960px';
+        case 'full':
+            return '100vw';
+        default:
+            return preset || undefined;
+    }
+}
 function applySurfaceHostInputs(ref, hostInputs) {
     const apply = () => {
         if (!ref.componentInstance)
@@ -1153,7 +1201,6 @@ function providePraxisSurfaceGlobalActions() {
             return {
                 open: async (payload, context) => {
                     const materializedPayload = await materializer.materialize(payload, context);
-                    const hostInputs = buildHostInputs(materializedPayload, context);
                     if (materializedPayload.presentation === 'drawer') {
                         if (!surfaceDrawer) {
                             throw new Error('Drawer surface service not available');
@@ -1179,6 +1226,13 @@ function providePraxisSurfaceGlobalActions() {
                         return ref;
                     }
                     const ref = dialog.open(PraxisSurfaceHostComponent, buildDialogConfig(materializedPayload));
+                    const resultSubject = new Subject();
+                    ref.afterClosed().subscribe(() => resultSubject.complete());
+                    ref.result$ = resultSubject.asObservable();
+                    ref.emitResult = (result) => resultSubject.next(result);
+                    const hostInputs = buildHostInputs(materializedPayload, context, {
+                        surfaceRuntime: buildDialogSurfaceRuntime(ref, resultSubject),
+                    });
                     applySurfaceHostInputs(ref, hostInputs);
                     return ref;
                 },

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@praxisui/dialog",
-  "version": "8.0.0-beta.104",
+  "version": "8.0.0-beta.105",
   "description": "Dialog helpers and components for Praxis UI with Angular Material integration.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
-    "@praxisui/core": "^8.0.0-beta.104",
+    "@praxisui/core": "^8.0.0-beta.105",
     "@angular/material": "^21.0.0",
     "@angular/platform-browser": "^21.0.0",
     "rxjs": "~7.8.0"