# Praxis Dialog Overlay Runtime

> 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.

- Skill: `codexrodrigues/praxis-dialog-overlay-runtime` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add codexrodrigues/praxis-dialog-overlay-runtime`
- Raw SKILL.md: https://api.skillmd.com/api/skills/codexrodrigues/praxis-dialog-overlay-runtime/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: codexrodrigues (https://skillmd.com/u/codexrodrigues)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/codexrodrigues/praxis-dialog-overlay-runtime

---


# 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.

