Praxis Settings Panel Shell
The praxis-settings-* skill family is the canonical Codex skill surface for @praxisui/settings-panel and projects/praxis-settings-panel; do not create parallel praxis-settings-panel-* guidance unless this family cannot express a proven contract gap.
Use this skill for the canonical authoring drawer shell. Do not duplicate drawer chrome, footer protocol, dirty/valid/busy rules, resize, shortcuts, or close mediation in consumer editors when the issue belongs to @praxisui/settings-panel.
Resolve paths from praxis-ui-angular/projects/praxis-settings-panel/ unless another root is named.
Canonical Boundary
SettingsPanelService opens authoring drawers.
SettingsPanelRef emits applied$, saved$, reset$, closed$, and sizeChanged$.
SettingsValueProvider is the editor contract: getSettingsValue, optional onSave, optional reset, and required isDirty$, isValid$, isBusy$.
BaseSidePanelService owns shared overlay, scope replacement, backdrop, Escape, width presets, resize, and persisted width.
providePraxisSettingsPanelBridge() is authoring; providePraxisSurfaceDrawerBridge() is runtime surface.open. Do not mix these semantics.
BaseSidePanelService is infrastructure, not an authoring protocol. SettingsPanelService adds authoring semantics on top of it; SurfaceDrawerComponent/SURFACE_DRAWER_BRIDGE uses the same infrastructure for neutral runtime drawers.
Required Inventory
Inspect:
projects/praxis-settings-panel/AGENTS.md
docs/host-settings-panel-integration.md
src/public-api.ts
src/lib/settings-panel.service.ts
src/lib/settings-panel.component.ts
src/lib/settings-panel.component.html
src/lib/settings-panel.component.scss
src/lib/settings-panel.ref.ts
src/lib/settings-panel.types.ts
src/lib/base-side-panel.service.ts
src/lib/base-side-panel.component.ts
src/lib/base-side-panel.component.html
src/lib/base-side-panel.component.scss
src/lib/base-side-panel.ref.ts
src/lib/base-side-panel.types.ts
src/lib/side-panel-theme.contract.ts
src/lib/overlay-escape-defer.ts
src/lib/settings-panel-bridge.provider.ts
src/lib/settings-panel-bridge.provider.spec.ts
src/lib/surface-drawer-bridge.provider.ts
src/lib/surface-drawer-bridge.provider.spec.ts
src/lib/surface-drawer.component.ts
src/lib/surface-drawer.component.html
src/lib/surface-drawer.component.scss
Shell Rules
Keep Apply enabled only when the hosted editor is dirty, valid, not busy, and interactive.
Keep Save enabled when the editor is valid, not busy, interactive, and either has a dirty draft or has changes already published through Apply that still need final persistence.
Apply previews without closing through applied$; it may synchronously clear the editor draft. Save must then read the provider's current value again, emit through saved$, and close without replaying a cached transient operation.
Reset delegates to the hosted editor and emits reset$; it must not clear unrelated host state.
The optional provider acceptAppliedValue(value) updates the draft baseline only after the document owner accepts its commit. Do not invoke it merely because applied$ emitted. Unified widget settings reset appearance and size to their last applied baseline; restoring an earlier resize remains an explicit Undo operation.
Validate controlled hosts that feed pageChange back into [page], including cloned canonical documents. An unchanged acknowledgement must keep the widget settings provider, size template and Apply/Save subscriptions alive. A different document, page identity, instance or context must still invalidate stale editing. Empty fixtures without an output-to-input binding cannot prove this lifecycle.
The optional open configuration previewTarget resolves an ephemeral live DOM target. View result keeps the editor mounted, reveals only this panel's backdrop and offers a return bar without applying or saving. Return, Escape and backdrop resume editing with scroll/focus restored. Do not persist this callback, clone the widget or remove backdrops globally.
Result inspection does not replace a docked inspector or guarantee that oversized content fits the viewport. Test the preview/return lifecycle with dirty and invalid drafts in desktop and narrow layouts, including the accessible name while the normal header is hidden.
Cancel, backdrop, Escape, and replacement of an open panel must pass through the canonical close mediation, including onBeforeClose and dirty discard confirmation where applicable.
Persist width through persistSizeKey; expanded/collapsed state must not accidentally overwrite persisted manual width.
Use SettingsPanelConfig.diagnostics only to show/hide status, disabled reason, busy state, or validation state. It must not change the gating rules.
Use canonical tokens/classes for visual changes: --pfx-settings-panel-*, .praxis-settings-panel-backdrop, and .praxis-settings-panel-pane.
Do not bypass SettingsPanelService.open(...) replacement mediation. It must consult onBeforeClose('cancel'), preserve the current panel when vetoed, and apply dirty discard confirmation when relevant.
Inputs are applied through declared Angular inputs when possible and also passed via the relevant data token (SETTINGS_PANEL_DATA for authoring, BASE_SIDE_PANEL_DATA for base/runtime).
SettingsPanelConfig.owner is transient lifecycle ownership. Reject an already destroyed owner, cancel a pending open if the owner expires while inputs/context resolve, and close the owner's current panel plus descendants when it is destroyed. Target destruction must not emit Save or ask the user to preserve a draft for a target that no longer exists.
Resolve functional content.inputs only when the opening is still current, after replacement mediation. Recheck owner, opening revision, current panel and parent lifetime before attaching content; a stale asynchronous acceptance must not close or replace a newer reentrant editor.
Keep parent and child sessions explicit. Replacing a child preserves its parent and restores parent interaction if the candidate is vetoed, fails, or expires. Closing a parent closes descendants. A delayed backdrop or close decision may act only on the panel that requested it, never on a child opened meanwhile.
Escape must defer to active interactive child CDK overlays before closing the panel. overlay-escape-defer must ignore panes that are themselves aria-hidden="true" or whose direct content host is aria-hidden, such as a non-interactive Material tooltip; otherwise a tooltip can block the drawer indefinitely. Do not reintroduce local document listeners in consumers that bypass this mediation.
Base Side Panel Rules
When changing BaseSidePanelService or BaseSidePanelComponent:
- Preserve scope isolation. Opening scope
settings-panel must not close scope surface-drawer, and vice versa.
- Default width presets are
narrow=420px, default=720px, wide=960px, and full=100vw.
- Persisted width uses localStorage key
praxis.side-panel.width:<persistSizeKey> and accepts only pixel values.
updateSize(...) must update the overlay, emit sizeChanged$, and persist when a persistSizeKey is bound.
- Horizontal resize is
resizeAxis: 'x' only; keyboard resize uses ArrowLeft/ArrowRight plus Home/End for min/max when available.
- Backdrop and Escape close should emit typed close results such as
{ type: 'backdrop' } or { type: 'esc' }.
- Escape coverage must prove both transitions: the panel remains open while an interactive child pane is active, then closes after that pane disappears even if an aria-hidden tooltip pane remains. Dispose every opened scope in test teardown so stale CDK overlays cannot capture later keyboard events.
- Keep base panel neutral: it may host optional footer content, but it must not introduce Settings Panel Apply/Save/Reset semantics.
Authoring Vs Runtime Drawer
Authoring bridge:
providePraxisSettingsPanelBridge() adapts SettingsPanelService to SETTINGS_PANEL_BRIDGE.
- It should preserve
id, title, titleIcon, component, and input envelope.
- It is for authoring editors with
SettingsValueProvider, footer protocol, diagnostics, dirty/valid/busy gates, and apply/save/reset/cancel.
Runtime drawer bridge:
providePraxisSurfaceDrawerBridge() adapts BaseSidePanelService.openHost(...) to SURFACE_DRAWER_BRIDGE.
- It uses scope
surface-drawer, SurfaceDrawerComponent, and neutral runtime chrome.
- It injects
context.surfaceRuntime into hosted content, exposing closed$, result$, close, emitResult, updateTitle, and updateSize.
- It publishes hosted
rowClick and selectionChange outputs through result$ using result envelopes with type, data, output, and payload.
- It must not show authoring footer/status text such as Apply or Save & Close.
- Treat
context.surfaceRuntime, result$, rowClick, and selectionChange as runtime interaction
contracts. They are not authoring documents, persisted config, dirty state, or replacement for a
SettingsValueProvider.
- Do not persist runtime drawer context, runtime selection envelopes, diagnostics visibility, or
resolved surface state into component config from this bridge. If a host needs an authored
connection to a runtime drawer, model that in the owning action/composition authoring contract,
not as Settings Panel shell state.
- In Ergon migrations, a drawer that only needs to show detail, emit a selected row, update title, or
close with a result should stay on
SURFACE_DRAWER_BRIDGE. Promote it to Settings Panel authoring
only when the user is editing a stable config document through an editor that owns
SettingsValueProvider.
Visual And Token Rules
- Authoring-specific classes:
.praxis-settings-panel-pane, .praxis-settings-panel-backdrop, .settings-panel-*.
- Neutral/shared runtime classes:
.praxis-side-panel-pane, .praxis-side-panel-backdrop, .pfx-base-side-panel-*, .pfx-surface-drawer-*.
- Authoring tokens use
--pfx-settings-panel-*.
- Neutral runtime/shared tokens use
--pfx-side-panel-* from SidePanelThemeContract.
SidePanelThemeContract.cssVars must use neutral --pfx-side-panel-* keys, never --pfx-settings-panel-*.
- Hosted editors with wide intrinsic content must fit inside the panel body. Preserve
min-width: 0, max-width: 100%, overflow-x: hidden, and body scroll padding rules unless replacing them with an equivalent shell-level solution.
Validation
Prefer focused checks:
npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/settings-panel.service.spec.ts
npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/settings-panel.component.spec.ts
npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/base-side-panel.service.spec.ts
npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/base-side-panel.component.spec.ts
npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/settings-panel-bridge.provider.spec.ts
npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/surface-drawer-bridge.provider.spec.ts
npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/surface-drawer.component.spec.ts
npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/side-panel-theme.contract.spec.ts
- screenshot or Playwright evidence when visual drawer behavior is material
Review README, public API, and host integration docs when shell behavior, public tokens, or bridge semantics change.
Container Width and Unified Widget Settings
Adapt editor navigation to the available panel width, not only the browser viewport: a narrow drawer can exist on a wide desktop. Reuse the editor's section collection and stable selected ID for responsive topic navigation. Verify switching to expanded mode preserves the selected section. Keep close/expand controls aligned with long titles and put preview on its own row when necessary.
When unified widget settings expose Size, suppress the redundant overflow-menu shortcut only when that editor can actually open; standalone consumers retain the shortcut. A page lockSize constraint should expose an explanation in the Size tab without editable size controls, while other permitted properties remain editable. Do not infer or persist a second lock state.
Escape Routing Across Overlay Layers
Inspect BaseSidePanelService, overlay-escape-defer and the SettingsPanel
service regression before changing Escape. Keep a keydownEvents() subscription
on the owner overlay even with closeOnEsc: false: this option disables automatic
closure, not CDK keyboard ownership. Otherwise CDK can route Escape to the launching
menu still animating underneath; that menu prevents the event before the editor
can mediate clean close or dirty-draft confirmation.
Defer Escape only to active panes above the owner in the overlay stack, never to
an older menu below it. Preserve first-Escape ownership for a real child overlay.
Prove previous overlay → owner panel → child with real CDK overlays and a bubbling
keyboard event; then verify mobile menu opening, Escape, return focus and discard
veto in the real host. An isolated pass or longer timeout does not close a race
that still reproduces in the full interaction sequence.
Provider emissions during child rendering
When a corrected field leaves Apply/Save disabled, inspect provider state, wrapper
state, panel state and the rendered buttons separately. A true validity property
and a manual detectChanges call do not prove the footer refreshed. Test late
dirty/valid/busy emissions during a child check under zoneless change detection,
await natural stabilization, and inspect the actual buttons without another click.
Use reactive state in the panel owner when those emissions occur after the panel
was checked; do not add consumer-specific delays or weaken validity gates.
Reference regressions: settings-panel-provider-render.spec.ts in Settings Panel and
page-settings-fidelity.integration.spec.ts in Page Builder (real shell, size editor,
Core and Settings Panel; invalid full width -> half width -> Apply).
1---2name: praxis-settings-panel-shell3description: Use when changing or reviewing `@praxisui/settings-panel` or the praxis-settings-panel package shell behavior, SettingsPanelService, SettingsPanelRef, SettingsValueProvider, BaseSidePanelService, drawer sizing, close/backdrop/Escape mediation, Apply/Save/Reset/Cancel enablement, diagnostics, tokens, or host bridge integration.4metadata:5 source: https://skillmd.com/skills/codexrodrigues/praxis-settings-panel-shell6---78# Praxis Settings Panel Shell910The `praxis-settings-*` skill family is the canonical Codex skill surface for `@praxisui/settings-panel` and `projects/praxis-settings-panel`; do not create parallel `praxis-settings-panel-*` guidance unless this family cannot express a proven contract gap.1112Use this skill for the canonical authoring drawer shell. Do not duplicate drawer chrome, footer protocol, dirty/valid/busy rules, resize, shortcuts, or close mediation in consumer editors when the issue belongs to `@praxisui/settings-panel`.1314Resolve paths from `praxis-ui-angular/projects/praxis-settings-panel/` unless another root is named.1516## Canonical Boundary1718- `SettingsPanelService` opens authoring drawers.19- `SettingsPanelRef` emits `applied$`, `saved$`, `reset$`, `closed$`, and `sizeChanged$`.20- `SettingsValueProvider` is the editor contract: `getSettingsValue`, optional `onSave`, optional `reset`, and required `isDirty$`, `isValid$`, `isBusy$`.21- `BaseSidePanelService` owns shared overlay, scope replacement, backdrop, Escape, width presets, resize, and persisted width.22- `providePraxisSettingsPanelBridge()` is authoring; `providePraxisSurfaceDrawerBridge()` is runtime `surface.open`. Do not mix these semantics.2324`BaseSidePanelService` is infrastructure, not an authoring protocol. `SettingsPanelService` adds authoring semantics on top of it; `SurfaceDrawerComponent`/`SURFACE_DRAWER_BRIDGE` uses the same infrastructure for neutral runtime drawers.2526## Required Inventory2728Inspect:2930- `projects/praxis-settings-panel/AGENTS.md`31- `docs/host-settings-panel-integration.md`32- `src/public-api.ts`33- `src/lib/settings-panel.service.ts`34- `src/lib/settings-panel.component.ts`35- `src/lib/settings-panel.component.html`36- `src/lib/settings-panel.component.scss`37- `src/lib/settings-panel.ref.ts`38- `src/lib/settings-panel.types.ts`39- `src/lib/base-side-panel.service.ts`40- `src/lib/base-side-panel.component.ts`41- `src/lib/base-side-panel.component.html`42- `src/lib/base-side-panel.component.scss`43- `src/lib/base-side-panel.ref.ts`44- `src/lib/base-side-panel.types.ts`45- `src/lib/side-panel-theme.contract.ts`46- `src/lib/overlay-escape-defer.ts`47- `src/lib/settings-panel-bridge.provider.ts`48- `src/lib/settings-panel-bridge.provider.spec.ts`49- `src/lib/surface-drawer-bridge.provider.ts`50- `src/lib/surface-drawer-bridge.provider.spec.ts`51- `src/lib/surface-drawer.component.ts`52- `src/lib/surface-drawer.component.html`53- `src/lib/surface-drawer.component.scss`5455## Shell Rules5657- Keep `Apply` enabled only when the hosted editor is dirty, valid, not busy, and interactive.58- Keep `Save` enabled when the editor is valid, not busy, interactive, and either has a dirty draft or has changes already published through `Apply` that still need final persistence.59- `Apply` previews without closing through `applied$`; it may synchronously clear the editor draft. `Save` must then read the provider's current value again, emit through `saved$`, and close without replaying a cached transient operation.60- `Reset` delegates to the hosted editor and emits `reset$`; it must not clear unrelated host state.61- The optional provider `acceptAppliedValue(value)` updates the draft baseline only after the document owner accepts its commit. Do not invoke it merely because `applied$` emitted. Unified widget settings reset appearance and size to their last applied baseline; restoring an earlier resize remains an explicit Undo operation.62- Validate controlled hosts that feed `pageChange` back into `[page]`, including cloned canonical documents. An unchanged acknowledgement must keep the widget settings provider, size template and Apply/Save subscriptions alive. A different document, page identity, instance or context must still invalidate stale editing. Empty fixtures without an output-to-input binding cannot prove this lifecycle.63- The optional open configuration `previewTarget` resolves an ephemeral live DOM target. View result keeps the editor mounted, reveals only this panel's backdrop and offers a return bar without applying or saving. Return, Escape and backdrop resume editing with scroll/focus restored. Do not persist this callback, clone the widget or remove backdrops globally.64- Result inspection does not replace a docked inspector or guarantee that oversized content fits the viewport. Test the preview/return lifecycle with dirty and invalid drafts in desktop and narrow layouts, including the accessible name while the normal header is hidden.6566- `Cancel`, backdrop, Escape, and replacement of an open panel must pass through the canonical close mediation, including `onBeforeClose` and dirty discard confirmation where applicable.67- Persist width through `persistSizeKey`; expanded/collapsed state must not accidentally overwrite persisted manual width.68- Use `SettingsPanelConfig.diagnostics` only to show/hide status, disabled reason, busy state, or validation state. It must not change the gating rules.69- Use canonical tokens/classes for visual changes: `--pfx-settings-panel-*`, `.praxis-settings-panel-backdrop`, and `.praxis-settings-panel-pane`.70- Do not bypass `SettingsPanelService.open(...)` replacement mediation. It must consult `onBeforeClose('cancel')`, preserve the current panel when vetoed, and apply dirty discard confirmation when relevant.71- Inputs are applied through declared Angular inputs when possible and also passed via the relevant data token (`SETTINGS_PANEL_DATA` for authoring, `BASE_SIDE_PANEL_DATA` for base/runtime).72- `SettingsPanelConfig.owner` is transient lifecycle ownership. Reject an already destroyed owner, cancel a pending open if the owner expires while inputs/context resolve, and close the owner's current panel plus descendants when it is destroyed. Target destruction must not emit Save or ask the user to preserve a draft for a target that no longer exists.73- Resolve functional `content.inputs` only when the opening is still current, after replacement mediation. Recheck owner, opening revision, current panel and parent lifetime before attaching content; a stale asynchronous acceptance must not close or replace a newer reentrant editor.74- Keep parent and child sessions explicit. Replacing a child preserves its parent and restores parent interaction if the candidate is vetoed, fails, or expires. Closing a parent closes descendants. A delayed backdrop or close decision may act only on the panel that requested it, never on a child opened meanwhile.75- Escape must defer to active interactive child CDK overlays before closing the panel. `overlay-escape-defer` must ignore panes that are themselves `aria-hidden="true"` or whose direct content host is aria-hidden, such as a non-interactive Material tooltip; otherwise a tooltip can block the drawer indefinitely. Do not reintroduce local document listeners in consumers that bypass this mediation.7677## Base Side Panel Rules7879When changing `BaseSidePanelService` or `BaseSidePanelComponent`:8081- Preserve scope isolation. Opening scope `settings-panel` must not close scope `surface-drawer`, and vice versa.82- Default width presets are `narrow=420px`, `default=720px`, `wide=960px`, and `full=100vw`.83- Persisted width uses localStorage key `praxis.side-panel.width:<persistSizeKey>` and accepts only pixel values.84- `updateSize(...)` must update the overlay, emit `sizeChanged$`, and persist when a `persistSizeKey` is bound.85- Horizontal resize is `resizeAxis: 'x'` only; keyboard resize uses ArrowLeft/ArrowRight plus Home/End for min/max when available.86- Backdrop and Escape close should emit typed close results such as `{ type: 'backdrop' }` or `{ type: 'esc' }`.87- Escape coverage must prove both transitions: the panel remains open while an interactive child pane is active, then closes after that pane disappears even if an aria-hidden tooltip pane remains. Dispose every opened scope in test teardown so stale CDK overlays cannot capture later keyboard events.88- Keep base panel neutral: it may host optional footer content, but it must not introduce Settings Panel Apply/Save/Reset semantics.8990## Authoring Vs Runtime Drawer9192Authoring bridge:9394- `providePraxisSettingsPanelBridge()` adapts `SettingsPanelService` to `SETTINGS_PANEL_BRIDGE`.95- It should preserve `id`, `title`, `titleIcon`, component, and input envelope.96- It is for authoring editors with `SettingsValueProvider`, footer protocol, diagnostics, dirty/valid/busy gates, and apply/save/reset/cancel.9798Runtime drawer bridge:99100- `providePraxisSurfaceDrawerBridge()` adapts `BaseSidePanelService.openHost(...)` to `SURFACE_DRAWER_BRIDGE`.101- It uses scope `surface-drawer`, `SurfaceDrawerComponent`, and neutral runtime chrome.102- It injects `context.surfaceRuntime` into hosted content, exposing `closed$`, `result$`, `close`, `emitResult`, `updateTitle`, and `updateSize`.103- It publishes hosted `rowClick` and `selectionChange` outputs through `result$` using result envelopes with `type`, `data`, `output`, and `payload`.104- It must not show authoring footer/status text such as Apply or Save & Close.105- Treat `context.surfaceRuntime`, `result$`, `rowClick`, and `selectionChange` as runtime interaction106 contracts. They are not authoring documents, persisted config, dirty state, or replacement for a107 `SettingsValueProvider`.108- Do not persist runtime drawer context, runtime selection envelopes, diagnostics visibility, or109 resolved surface state into component config from this bridge. If a host needs an authored110 connection to a runtime drawer, model that in the owning action/composition authoring contract,111 not as Settings Panel shell state.112- In Ergon migrations, a drawer that only needs to show detail, emit a selected row, update title, or113 close with a result should stay on `SURFACE_DRAWER_BRIDGE`. Promote it to Settings Panel authoring114 only when the user is editing a stable config document through an editor that owns115 `SettingsValueProvider`.116117## Visual And Token Rules118119- Authoring-specific classes: `.praxis-settings-panel-pane`, `.praxis-settings-panel-backdrop`, `.settings-panel-*`.120- Neutral/shared runtime classes: `.praxis-side-panel-pane`, `.praxis-side-panel-backdrop`, `.pfx-base-side-panel-*`, `.pfx-surface-drawer-*`.121- Authoring tokens use `--pfx-settings-panel-*`.122- Neutral runtime/shared tokens use `--pfx-side-panel-*` from `SidePanelThemeContract`.123- `SidePanelThemeContract.cssVars` must use neutral `--pfx-side-panel-*` keys, never `--pfx-settings-panel-*`.124- Hosted editors with wide intrinsic content must fit inside the panel body. Preserve `min-width: 0`, `max-width: 100%`, `overflow-x: hidden`, and body scroll padding rules unless replacing them with an equivalent shell-level solution.125126## Validation127128Prefer focused checks:129130- `npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/settings-panel.service.spec.ts`131- `npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/settings-panel.component.spec.ts`132- `npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/base-side-panel.service.spec.ts`133- `npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/base-side-panel.component.spec.ts`134- `npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/settings-panel-bridge.provider.spec.ts`135- `npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/surface-drawer-bridge.provider.spec.ts`136- `npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/surface-drawer.component.spec.ts`137- `npx ng test praxis-settings-panel --watch=false --progress=false --include=projects/praxis-settings-panel/src/lib/side-panel-theme.contract.spec.ts`138- screenshot or Playwright evidence when visual drawer behavior is material139140Review README, public API, and host integration docs when shell behavior, public tokens, or bridge semantics change.141142## Container Width and Unified Widget Settings143144Adapt editor navigation to the available panel width, not only the browser viewport: a narrow drawer can exist on a wide desktop. Reuse the editor's section collection and stable selected ID for responsive topic navigation. Verify switching to expanded mode preserves the selected section. Keep close/expand controls aligned with long titles and put preview on its own row when necessary.145146When unified widget settings expose Size, suppress the redundant overflow-menu shortcut only when that editor can actually open; standalone consumers retain the shortcut. A page lockSize constraint should expose an explanation in the Size tab without editable size controls, while other permitted properties remain editable. Do not infer or persist a second lock state.147148149## Escape Routing Across Overlay Layers150151Inspect `BaseSidePanelService`, `overlay-escape-defer` and the SettingsPanel152service regression before changing Escape. Keep a `keydownEvents()` subscription153on the owner overlay even with `closeOnEsc: false`: this option disables automatic154closure, not CDK keyboard ownership. Otherwise CDK can route Escape to the launching155menu still animating underneath; that menu prevents the event before the editor156can mediate clean close or dirty-draft confirmation.157158Defer Escape only to active panes above the owner in the overlay stack, never to159an older menu below it. Preserve first-Escape ownership for a real child overlay.160Prove previous overlay → owner panel → child with real CDK overlays and a bubbling161keyboard event; then verify mobile menu opening, Escape, return focus and discard162veto in the real host. An isolated pass or longer timeout does not close a race163that still reproduces in the full interaction sequence.164165### Provider emissions during child rendering166167When a corrected field leaves Apply/Save disabled, inspect provider state, wrapper168state, panel state and the rendered buttons separately. A true validity property169and a manual detectChanges call do not prove the footer refreshed. Test late170dirty/valid/busy emissions during a child check under zoneless change detection,171await natural stabilization, and inspect the actual buttons without another click.172Use reactive state in the panel owner when those emissions occur after the panel173was checked; do not add consumer-specific delays or weaken validity gates.174Reference regressions: settings-panel-provider-render.spec.ts in Settings Panel and175page-settings-fidelity.integration.spec.ts in Page Builder (real shell, size editor,176Core and Settings Panel; invalid full width -> half width -> Apply).