Praxis Dialog Overlay Runtime
Use this skill for canonical Praxis dialogs and overlays. @praxisui/dialog is the workspace owner for dialog service API, overlay container behavior, presets, tag mode, accessibility, and lifecycle semantics.
Pair with praxis-dialog-surface-global-actions when dialog overlays are opened through GLOBAL_DIALOG_SERVICE, GLOBAL_SURFACE_SERVICE, component/template registries, or surface materialization.
Required Source Audit
Inspect:
projects/praxis-dialog/AGENTS.md
README.md
docs/host-dialog-integration.md
src/public-api.ts
src/lib/dialog/dialog.service.ts
src/lib/dialog/dialog.component.ts
src/lib/dialog/dialog.component.html
src/lib/dialog/dialog.ref.ts
src/lib/dialog/overlay/dialog-overlay.service.ts
src/lib/dialog/dialog.types.ts
src/lib/dialog/dialog.tokens.ts
- focused service/component/preset specs
Runtime Rules
- Use
PraxisDialog.open, confirm, alert, prompt, openByRegistry, openTemplateById, or tag mode; do not add ad hoc overlay shells in consumers.
- For metadata-driven surfaces, go through the global action/surface providers rather than opening ad hoc overlays from consumers.
- Preserve lifecycle streams:
afterOpened, beforeClosed, afterClosed, backdropClick, keydownEvents, afterAllClosed.
- Treat the value passed to
close(...) and emitted by afterClosed() as overlay lifecycle result.
It is not, by itself, a governed business decision, persisted component config, or composition
dispatch. When dialog results need domain or page effects, route them through the owning
GlobalActionRef, surface/global-action provider, composition link, or backend-confirmed action
instead of parsing dialog result payloads in a host.
- Preserve close policy:
disableClose, closeOnBackdropClick, Escape handling, backdrop click handling, and close on navigation.
- Preserve
autoFocus, autoFocusedElement, restoreFocus, visible title or accessible label, and correct ariaRole.
- Use
alertdialog for destructive/blocking confirmations.
- Keep preset merge order canonical: type preset, variant preset, local config.
- Use
PraxisLayerScaleStyleService/core overlay layering before patching individual hosts for z-index issues.
- For governed Quick View overlays (
QuickViewDialogPresenterService, PraxisQuickViewOverlayComponent, providePraxisQuickViewDialogPresenter()), @praxisui/dialog implements PRAXIS_QUICK_VIEW_PRESENTER with a single active CDK overlay per viewport, supporting both element and virtual-rect (QuickViewRuntimeAnchor) origins, frameless identity header (PraxisResourceIdentityComponent, hiding header metadata chips when summaryItems or customBodyRenderer are present to avoid the "Russian Doll" duplication effect) + compact summary/custom body (rendering [data-testid="quick-view-masked-indicator"] and suppressing copy buttons when item.masked is true) + non-destructive action/surface footer, pointer-enter/leave hover handoff, responsive bottom-sheet fallback on coarse pointers / narrow viewports (<= 640px), Escape/backdrop close, and focus restoration (without stealing focus on programmatic hover leave).
Validation
Minimum gates:
- compile:
ng build praxis-dialog
- service API:
src/lib/dialog/dialog.service.spec.ts
- preset merge:
src/lib/dialog/dialog.service.merge-presets.spec.ts
- component accessibility/lifecycle:
src/lib/dialog/dialog.component.spec.ts
- global presets provider:
src/lib/providers/dialog-global-presets.provider.spec.ts
Review README, integration guide, docs manifest, public API, and examples when runtime behavior changes.
1---2name: praxis-dialog-overlay-runtime3description: Use when implementing or auditing `@praxisui/dialog` runtime behavior, including `PraxisDialog`, `PraxisDialogComponent`, `PraxisDialogRef`, `DialogOverlayService`, service API, tag mode, confirm/alert/prompt/custom dialogs, presets merge order, focus, Escape/backdrop close, restoreFocus, `dialog|alertdialog` accessibility, panel/backdrop classes, scroll strategy, sizing, positioning, and overlay lifecycle.4metadata:5 source: https://skillmd.com/skills/codexrodrigues/praxis-dialog-overlay-runtime6---78# Praxis Dialog Overlay Runtime910Use this skill for canonical Praxis dialogs and overlays. `@praxisui/dialog` is the workspace owner for dialog service API, overlay container behavior, presets, tag mode, accessibility, and lifecycle semantics.1112Pair with `praxis-dialog-surface-global-actions` when dialog overlays are opened through `GLOBAL_DIALOG_SERVICE`, `GLOBAL_SURFACE_SERVICE`, component/template registries, or surface materialization.1314## Required Source Audit1516Inspect:1718- `projects/praxis-dialog/AGENTS.md`19- `README.md`20- `docs/host-dialog-integration.md`21- `src/public-api.ts`22- `src/lib/dialog/dialog.service.ts`23- `src/lib/dialog/dialog.component.ts`24- `src/lib/dialog/dialog.component.html`25- `src/lib/dialog/dialog.ref.ts`26- `src/lib/dialog/overlay/dialog-overlay.service.ts`27- `src/lib/dialog/dialog.types.ts`28- `src/lib/dialog/dialog.tokens.ts`29- focused service/component/preset specs3031## Runtime Rules3233- Use `PraxisDialog.open`, `confirm`, `alert`, `prompt`, `openByRegistry`, `openTemplateById`, or tag mode; do not add ad hoc overlay shells in consumers.34- For metadata-driven surfaces, go through the global action/surface providers rather than opening ad hoc overlays from consumers.35- Preserve lifecycle streams: `afterOpened`, `beforeClosed`, `afterClosed`, `backdropClick`, `keydownEvents`, `afterAllClosed`.36- Treat the value passed to `close(...)` and emitted by `afterClosed()` as overlay lifecycle result.37 It is not, by itself, a governed business decision, persisted component config, or composition38 dispatch. When dialog results need domain or page effects, route them through the owning39 `GlobalActionRef`, surface/global-action provider, composition link, or backend-confirmed action40 instead of parsing dialog result payloads in a host.41- Preserve close policy: `disableClose`, `closeOnBackdropClick`, Escape handling, backdrop click handling, and close on navigation.42- Preserve `autoFocus`, `autoFocusedElement`, `restoreFocus`, visible title or accessible label, and correct `ariaRole`.43- Use `alertdialog` for destructive/blocking confirmations.44- Keep preset merge order canonical: type preset, variant preset, local config.45- Use `PraxisLayerScaleStyleService`/core overlay layering before patching individual hosts for z-index issues.46- For governed Quick View overlays (`QuickViewDialogPresenterService`, `PraxisQuickViewOverlayComponent`, `providePraxisQuickViewDialogPresenter()`), `@praxisui/dialog` implements `PRAXIS_QUICK_VIEW_PRESENTER` with a single active CDK overlay per viewport, supporting both `element` and `virtual-rect` (`QuickViewRuntimeAnchor`) origins, frameless identity header (`PraxisResourceIdentityComponent`, hiding header metadata chips when `summaryItems` or `customBodyRenderer` are present to avoid the "Russian Doll" duplication effect) + compact summary/custom body (rendering `[data-testid="quick-view-masked-indicator"]` and suppressing copy buttons when `item.masked` is true) + non-destructive action/surface footer, pointer-enter/leave hover handoff, responsive bottom-sheet fallback on coarse pointers / narrow viewports (`<= 640px`), `Escape`/backdrop close, and focus restoration (without stealing focus on programmatic hover leave).4748## Validation4950Minimum gates:5152- compile: `ng build praxis-dialog`53- service API: `src/lib/dialog/dialog.service.spec.ts`54- preset merge: `src/lib/dialog/dialog.service.merge-presets.spec.ts`55- component accessibility/lifecycle: `src/lib/dialog/dialog.component.spec.ts`56- global presets provider: `src/lib/providers/dialog-global-presets.provider.spec.ts`5758Review README, integration guide, docs manifest, public API, and examples when runtime behavior changes.