Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(records): LayoutPanel publishes its applied inset; Lightbox's gaps for 0, announcements and Tab are closed (#10819)

Cindy Zhang78ac0b132a08
diff --git a/docs/architecture/container-padding.md b/docs/architecture/container-padding.md
index 3ffb11986f..f6d24b42d8 100644
--- a/docs/architecture/container-padding.md
+++ b/docs/architecture/container-padding.md
@@ -104,8 +104,9 @@ The protocol has four layers:
explicit region-padding paths couple those variables to their padding.
Layout also carries an outer/inner split through
`--layout-padding-outer-*` and `--layout-padding-inner-*`; automatic region
- placement applies that split, but not every current path republishes the
- resulting edge exactly (see the conformance gap below).
+ placement applies that split, and each region republishes the edge it
+ applies, except LayoutContent's content-width gutter, which is applied but
+ not published (`component:LayoutContent` FR2).
4. **Boundary reset.** An overlay leaves its ancestor's visual box while
remaining a DOM descendant. `overlayPaddingReset` zeroes values descendants
subtract or take as a corner and invalidates values descendants add, so readers fall through to
@@ -116,14 +117,14 @@ The protocol has four layers:
### Current and admitted publishers and consumers
-| Role | Participants | Contract responsibility |
-| -------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| Container publisher | Card, Section, Dialog, BottomSheet, ScrollableArea | Resolve component padding or publish explicit content-box padding as logical-edge and Layout inset variables |
-| Region publisher | LayoutHeader, LayoutContent, LayoutFooter, LayoutPanel | Publish baseline or explicit-padding geometry; LayoutPanel's automatic-edge publication has the conformance gap below |
-| Bleed consumer | Section, ScrollableArea, Layout, Divider, Table, TabList, List | Subtract inherited inset on the edges each component is designed to escape; ScrollableArea does so only with `isFullBleed`, TabList and List only with `edge="bleed"` |
-| Edge-compensation consumer | List/ListItem rows with `edge="outset"` | Move visible content toward the container content line while retaining component-owned interaction padding; exact alignment depends on each component's bounded geometry |
-| Alignment consumer | Toolbar and edge-compensating child components | Read the current inline inset to align visible content rather than stacked touch-target padding |
-| Boundary owner | Layer surfaces and dialog-based overlay roots; AppShell's root | Apply `overlayPaddingReset`, or at AppShell's root Layout's `layoutReset`, before descendants read inherited page geometry |
+| Role | Participants | Contract responsibility |
+| -------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Container publisher | Card, Section, Dialog, BottomSheet, ScrollableArea | Resolve component padding or publish explicit content-box padding as logical-edge and Layout inset variables |
+| Region publisher | LayoutHeader, LayoutContent, LayoutFooter, LayoutPanel | Publish the padding each region applies, on every edge, on the automatic and explicit-padding paths; LayoutContent's content-width gutter is applied but not published (`component:LayoutContent` FR2) |
+| Bleed consumer | Section, ScrollableArea, Layout, Divider, Table, TabList, List | Subtract inherited inset on the edges each component is designed to escape; ScrollableArea does so only with `isFullBleed`, TabList and List only with `edge="bleed"` |
+| Edge-compensation consumer | List/ListItem rows with `edge="outset"` | Move visible content toward the container content line while retaining component-owned interaction padding; exact alignment depends on each component's bounded geometry |
+| Alignment consumer | Toolbar and edge-compensating child components | Read the current inline inset to align visible content rather than stacked touch-target padding |
+| Boundary owner | Layer surfaces and dialog-based overlay roots; AppShell's root | Apply `overlayPaddingReset`, or at AppShell's root Layout's `layoutReset`, before descendants read inherited page geometry |
The participant list is the shared container system, not a Layout-owned family:
Section and ScrollableArea publish content inset, Section and opt-in full-bleed
@@ -304,8 +305,9 @@ without dropping the active theme's Section default.
- **INV2 — Coupled publication paths stay coupled.** Where current source
publishes geometry alongside a padding declaration—container lowering,
Section's logical-edge overrides, explicit Layout-region padding, and
- full-bleed reset—the matching variable changes with that declaration. This
- invariant does not claim parity for every automatic Layout-region edge.
+ full-bleed reset—the matching variable changes with that declaration. An
+ automatic Layout-region edge publishes the padding it applies, except
+ LayoutContent's content-width gutter (`component:LayoutContent` FR2).
- **INV3 — Bleed is opt-in and edge-specific.** A descendant escapes padding
only when its component contract opts into bleed, and only on the edges that
contract covers. The presence of an inherited variable does not make every
@@ -313,8 +315,7 @@ without dropping the active theme's Section default.
- **INV4 — Layout distinguishes outer and inner edges.** Named Layout regions
apply outer inset where they touch the shell and inner inset where they meet
another region. Slot presence and each region's explicit padding select the
- applied edge styles. Exact descendant-variable parity for automatic outer
- edges is not guaranteed by this invariant.
+ applied edge styles, and each region republishes the edge it applies (INV2).
- **INV5 — Section propagation has narrower authority than theme defaults.** An
ancestor Section's explicit padding may propagate to nested Sections, but it
does not replace the public theme property and does not cross an overlay
@@ -365,20 +366,6 @@ without dropping the active theme's Section default.
reader sits deeper inside it. A reader takes a corner only where its bleed
reaches that edge. Every other element publishes no corner.
-### Known conformance gap
-
-LayoutPanel does not currently publish the padding it applies on every
-automatic edge: it changes padding on shell-facing inline and block edges while
-its baseline geometry variables remain on the inner values. LayoutContent
-publishes the padding it applies on every edge (`component:LayoutContent` FR2).
-
-A full-bleed descendant of such a panel can therefore compensate against a value
-that differs from the region's applied padding. Explicit region padding and
-`padding={0}` do update/reset the geometry variables. No current browser matrix
-covers every slot and descendant-bleed combination, so this record does not claim
-exact region parity. Correcting the mismatch is runtime work with compatibility
-evidence.
-
## Current-state impact
- **BottomSheet corners.** BottomSheet publishes no corner: its grab-bar band
@@ -457,18 +444,18 @@ evidence.
## Verification
-| Invariant | Evidence | Failure signal |
-| ---------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| INV2, INV5 | `Section.test.tsx` per-edge and nested-propagation tests | A per-edge prop leaves a stale geometry variable, or nested Sections lose the shipped propagation order |
-| INV2, INV3, INV8 | `ScrollableArea.test.tsx` padding and full-bleed tests | The content box publishes inset different from its applied padding, or the viewport escapes inherited padding without explicit full bleed |
-| INV4 | Layout source review plus `Layout.test.tsx` and `LayoutSlots.test.tsx` | Slot presence stops selecting the shipped applied outer/inner edge styles; exact republished geometry remains limited by the named conformance gap |
-| INV2 | `BottomSheetPanel.test.tsx` padding tests | The Content area publishes an inset that differs from its applied padding on any edge but the block start, its block start publishes more than the padding past the grab bar's band, or the `padding` prop or theme `padding` does not reach it |
-| INV6 | `overlayPaddingReset.test.tsx` | An overlay inherits page inset, loses its theme's Section padding, or lets ancestor Section propagation cross the boundary |
-| INV5, INV6 | `AppShellLayoutRoot.interaction.browser.spec.ts` and the `AppShell.test.tsx` "AppShell layout root (FR18)" suite | AppShell's regions inside a padded Card, Section, or Layout differ from its page-root render, or a reset value or context leaks into the shell |
-| INV3, INV7 | `Layout/__tests__/edgeCompensation.test.tsx` plus component tests | An unmarked child is compensated, or marked edge content loses direct-child discoverability |
-| INV9, INV10 | `List.test.tsx` plus real-browser geometry evidence | The header moves; a row reads the wrong logical edge, diverges from themed/density padding, applies the wrong bounded movement, or loses paint inset |
-| INV10, INV11 | `TabList.test.tsx` plus real-browser overflow, divider, and indicator evidence | Full host-inset consumption, bounded content movement, divider span, interaction, focus, overflow, scroll controls, or indicator geometry regresses |
-| INV3, INV12 | `ContainerCorners.a11y.chromium.spec.ts` | A Table or bleeding List row that is a Card's or Dialog's first or last child stays square, or its ring is cut at the corner; or a reader between other content, inside a wrapper, past the container's padding, or below a BottomSheet's grab bar rounds |
+| Invariant | Evidence | Failure signal |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| INV2, INV5 | `Section.test.tsx` per-edge and nested-propagation tests | A per-edge prop leaves a stale geometry variable, or nested Sections lose the shipped propagation order |
+| INV2, INV3, INV8 | `ScrollableArea.test.tsx` padding and full-bleed tests | The content box publishes inset different from its applied padding, or the viewport escapes inherited padding without explicit full bleed |
+| INV4 | Layout source review plus `Layout.test.tsx` and `LayoutSlots.test.tsx`; `nestedPadding.test.tsx` and the region audit specs (`LayoutPanelAudit`, `LayoutContentAudit`, `LayoutHeaderAudit`, `LayoutFooterAudit`) for published values | Slot presence stops selecting the shipped applied outer/inner edge styles, or a region republishes an edge that differs from the padding it applies |
+| INV2 | `BottomSheetPanel.test.tsx` padding tests | The Content area publishes an inset that differs from its applied padding on any edge but the block start, its block start publishes more than the padding past the grab bar's band, or the `padding` prop or theme `padding` does not reach it |
+| INV6 | `overlayPaddingReset.test.tsx` | An overlay inherits page inset, loses its theme's Section padding, or lets ancestor Section propagation cross the boundary |
+| INV5, INV6 | `AppShellLayoutRoot.interaction.browser.spec.ts` and the `AppShell.test.tsx` "AppShell layout root (FR18)" suite | AppShell's regions inside a padded Card, Section, or Layout differ from its page-root render, or a reset value or context leaks into the shell |
+| INV3, INV7 | `Layout/__tests__/edgeCompensation.test.tsx` plus component tests | An unmarked child is compensated, or marked edge content loses direct-child discoverability |
+| INV9, INV10 | `List.test.tsx` plus real-browser geometry evidence | The header moves; a row reads the wrong logical edge, diverges from themed/density padding, applies the wrong bounded movement, or loses paint inset |
+| INV10, INV11 | `TabList.test.tsx` plus real-browser overflow, divider, and indicator evidence | Full host-inset consumption, bounded content movement, divider span, interaction, focus, overflow, scroll controls, or indicator geometry regresses |
+| INV3, INV12 | `ContainerCorners.a11y.chromium.spec.ts` | A Table or bleeding List row that is a Card's or Dialog's first or last child stays square, or its ring is cut at the corner; or a reader between other content, inside a wrapper, past the container's padding, or below a BottomSheet's grab bar rounds |
The List evidence must cover each `edge` value in its neutral root and in each
bounded host List admits (Card, Section, Dialog, BottomSheet), with the optional
diff --git a/docs/families/layout-regions.md b/docs/families/layout-regions.md
index 323bc76d52..5eda19782b 100644
--- a/docs/families/layout-regions.md
+++ b/docs/families/layout-regions.md
@@ -119,14 +119,14 @@ wrapper, or a header-like visual treatment.
and Panel apply outer inset where they touch the Layout boundary and inner
inset where they meet another region. LayoutContent keeps its root as the
scroll, padding, and direct-child owner. Omitted slots do not leave an area
- wrapper. The inherited geometry republished to full-bleed descendants is
- subject to the current LayoutPanel conformance gap in
- `architecture:container-padding`.
+ wrapper. Each region republishes the geometry it applies to full-bleed
+ descendants (`architecture:container-padding` INV2).
- **FR4 — Explicit region padding replaces the automatic applied inset.**
Section publishes its component inset; Layout distributes outer and inner
inset across its named slots; a region's explicit padding or zero-padding
- path selects its local styles. This does not claim that every automatic
- Layout edge currently republishes an exact matching descendant variable.
+ path selects its local styles. An automatic Layout edge republishes the
+ padding it applies, except LayoutContent's content-width gutter
+ (`component:LayoutContent` FR2).
- **FR5 — Boundary ownership is caller-selected where composition permits two
owners.** LayoutHeader and LayoutFooter each own their implied edge. Section
and Toolbar expose selected edges. LayoutPanel may draw its content-facing
@@ -238,18 +238,18 @@ exceptions to silently change in a documentation pull request.
## Verification map
-| Contract | Verification | What the evidence proves | Missing evidence |
-| -------------------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| FR1 | Section/Layout/Toolbar render and slot tests | Caller content renders inside the current region structure; Toolbar exposes its current lanes | Tests do not independently prove that product semantics remain caller-owned |
-| FR2 | Logical-property source review plus Layout area-context tests | Start/end slots are identified logically and source selects logical divider/padding properties | No real-browser LTR/RTL geometry matrix covers every region |
-| FR3 | `Layout.test.tsx` and `childrenAsContent.test.tsx` | Slot presence/context and content precedence are pinned; omitted slots do not render area providers | Tests do not assert computed outer/inner inset or exact descendant geometry; LayoutPanel's published-variable mismatch is a named conformance gap |
-| FR4 | Section padding class-set tests and Layout region source | Section's explicit edge overrides move matching variables; region source has automatic, explicit, and zero-padding branches | Layout tests mostly assert acceptance/rendering, not computed padding or automatic-variable parity |
-| FR5, FR6 | `Layout.test.tsx` and `LayoutSlots.test.tsx` | Header/footer divider defaults and explicit false overrides are reflected in `data-divider`; source contains collapse styles | No rendered test prevents a LayoutPanel and adjacent ResizeHandle from both drawing a divider, or proves computed collapse spacing |
-| FR7 | LayoutContent/LayoutPanel source and local class/render tests | The two regions expose their current `isScrollable` branches; Layout exposes fill/auto state | No browser test proves scroll ownership across every shell/region composition |
-| FR8 | `LayoutSlots.test.tsx` landmark assertions | Supplied roles and labels reach Header, Content, Footer, and Panel elements | No family-wide accessibility-tree test covers repeated landmarks |
-| Layout content width | `contentWidth.test.tsx` and Storybook scrollbar-placement states | Header/footer retain aligned wrappers; no-panel LayoutContent owns a full-width scroll region; either single-panel state mirrors content through the opposite open edge; both panels keep the composition constrained | Real-browser evidence verifies computed content alignment and scrollbar placement across the four panel states |
-| Toolbar variation | `Toolbar.test.tsx` | Lanes, role/name/orientation, Section variant delegation, and current keyboard behavior have focused assertions | No computed inset/edge-compensation test covers non-default parent padding |
-| FR10 | LayoutPanel coverage in `LayoutSlots.test.tsx` | Hook-provided `_size` overrides the fixed width prop | Resize interaction, persistence, snapping, and collapse are verified only by Resizable's own tests |
+| Contract | Verification | What the evidence proves | Missing evidence |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| FR1 | Section/Layout/Toolbar render and slot tests | Caller content renders inside the current region structure; Toolbar exposes its current lanes | Tests do not independently prove that product semantics remain caller-owned |
+| FR2 | Logical-property source review plus Layout area-context tests | Start/end slots are identified logically and source selects logical divider/padding properties | No real-browser LTR/RTL geometry matrix covers every region |
+| FR3 | `Layout.test.tsx` and `childrenAsContent.test.tsx`; `nestedPadding.test.tsx` and the region audit specs for published geometry | Slot presence/context and content precedence are pinned; omitted slots do not render area providers | These tests do not assert computed outer/inner inset; `nestedPadding.test.tsx` and the region audit specs check each region's published values |
+| FR4 | Section padding class-set tests and Layout region source | Section's explicit edge overrides move matching variables; region source has automatic, explicit, and zero-padding branches | Layout tests mostly assert acceptance/rendering, not computed padding or automatic-variable parity |
+| FR5, FR6 | `Layout.test.tsx` and `LayoutSlots.test.tsx` | Header/footer divider defaults and explicit false overrides are reflected in `data-divider`; source contains collapse styles | No rendered test prevents a LayoutPanel and adjacent ResizeHandle from both drawing a divider, or proves computed collapse spacing |
+| FR7 | LayoutContent/LayoutPanel source and local class/render tests | The two regions expose their current `isScrollable` branches; Layout exposes fill/auto state | No browser test proves scroll ownership across every shell/region composition |
+| FR8 | `LayoutSlots.test.tsx` landmark assertions | Supplied roles and labels reach Header, Content, Footer, and Panel elements | No family-wide accessibility-tree test covers repeated landmarks |
+| Layout content width | `contentWidth.test.tsx` and Storybook scrollbar-placement states | Header/footer retain aligned wrappers; no-panel LayoutContent owns a full-width scroll region; either single-panel state mirrors content through the opposite open edge; both panels keep the composition constrained | Real-browser evidence verifies computed content alignment and scrollbar placement across the four panel states |
+| Toolbar variation | `Toolbar.test.tsx` | Lanes, role/name/orientation, Section variant delegation, and current keyboard behavior have focused assertions | No computed inset/edge-compensation test covers non-default parent padding |
+| FR10 | LayoutPanel coverage in `LayoutSlots.test.tsx` | Hook-provided `_size` overrides the fixed width prop | Resize interaction, persistence, snapping, and collapse are verified only by Resizable's own tests |
The current tests prove selected structure, attributes, callbacks, and class/style
branches. They do not prove one computed visual alignment across every Section,
diff --git a/docs/specs/components/Layout/Layout.spec.md b/docs/specs/components/Layout/Layout.spec.md
index 2e304732e3..c4fa592a3c 100644
--- a/docs/specs/components/Layout/Layout.spec.md
+++ b/docs/specs/components/Layout/Layout.spec.md
@@ -199,8 +199,7 @@ Panel stands for every LayoutPanel, at logical start, end, or both.
- `architecture:container-padding` owns publication and escape of container
inset; FR2 and FR3 apply it.
- `component:LayoutHeader`, `component:LayoutContent`, `component:LayoutFooter`,
- and `component:LayoutPanel` own each region's behavior, including the
- publication gap LayoutPanel records.
+ and `component:LayoutPanel` own each region's behavior.
- `architecture:component-theming-surface` owns anatomy and target mapping.
- `architecture:public-component-api` owns caller-input routing; FR7 applies
it.
diff --git a/docs/specs/components/Layout/LayoutPanel.spec.md b/docs/specs/components/Layout/LayoutPanel.spec.md
index d07f16df98..f80991f174 100644
--- a/docs/specs/components/Layout/LayoutPanel.spec.md
+++ b/docs/specs/components/Layout/LayoutPanel.spec.md
@@ -13,6 +13,8 @@ review_triggers: [public-api, behavior, layout, theming, accessibility]
verified_by:
[
packages/core/src/Layout/LayoutSlots.test.tsx,
+ packages/core/src/Layout/__tests__/nestedPadding.test.tsx,
+ packages/core/src/Layout/__tests__/LayoutPanelAudit.a11y.chromium.spec.ts,
packages/core/src/Layout/__tests__/Layout.a11y.test.tsx,
packages/core/src/Layout/__tests__/Layout.a11y.chromium.spec.ts,
packages/core/src/hooks/useScrollRegionProps.test.tsx,
@@ -76,12 +78,6 @@ Consumer migration instructions belong in consumer docs and release notes.
## Current-state impact
-- **Published inset differs from applied padding (FR3).** On the automatic
- path a panel applies the Layout-edge inset on its outer inline edge and on
- a block edge with no header or footer, but publishes the inner inset on
- every edge. A full-bleed child then lines up against a value that differs
- from the padding the panel applies, where `architecture:container-padding`
- has a region publish its applied padding.
- **Two divider owners can paint one boundary (FR4).** A panel with
`hasDivider` beside a ResizeHandle that draws the same line paints the
boundary twice; nothing prevents it, so callers keep `hasDivider={false}`
@@ -119,7 +115,7 @@ Consumer migration instructions belong in consumer docs and release notes.
| --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| FR1 | LayoutPanel renders one `div` carrying the `layout-panel` target that does not shrink and holds the children directly. `width` sets its inline size, with numbers as pixels; a `resizable` value's size wins over `width`. It scrolls overflow by default; `isScrollable={false}` clips it. | Current source and tests; `family:layout-regions` FR7, FR10 |
| FR2 | In the `start` slot the panel's content-facing edge is its inline end; in the `end` slot it is its inline start; both follow writing direction. | Current source and tests; `family:layout-regions` FR2 |
-| FR3 | Without `padding`, the panel's outer inline edge has the Layout-edge inset, a block edge with no header or footer beside it has the Layout-edge inset, and other edges have the inner inset, where the Layout-edge inset comes from the Layout's `padding`, else the nearest padding container, and the inner inset from the nearest padding container (Card, Section, Dialog, Drawer, or BottomSheet), each spacing step 4 otherwise. A `padding` step replaces all four edges, and `0` removes them. The panel publishes container-padding values equal to the padding it applies. Implementation gap: on the automatic path it publishes the inner inset on every edge (Current-state impact). | Current source; `family:layout-regions` FR4; `architecture:container-padding` |
+| FR3 | Without `padding`, the panel's outer inline edge has the Layout-edge inset, a block edge with no header or footer beside it has the Layout-edge inset, and other edges have the inner inset, where the Layout-edge inset comes from the Layout's `padding`, else the nearest padding container, and the inner inset from the nearest padding container (Card, Section, Dialog, Drawer, or BottomSheet), each spacing step 4 otherwise. A `padding` step replaces all four edges, and `0` removes them. The panel publishes container-padding values equal to the padding it applies, so a full-bleed child lines up with its outer edge. | Current source; `family:layout-regions` FR4; `architecture:container-padding` |
| FR4 | `hasDivider` draws a 1px solid `--color-border` line on the content-facing edge; LayoutPanel does not read a Layout divider default. Without a divider and with the automatic inset, the panel overlaps the content area by the inner inset so the two share one gap. One boundary has one divider owner (`family:layout-regions` FR5). Implementation gap: nothing prevents a panel divider and an adjacent ResizeHandle line from both painting (Current-state impact). | Current source and docs; `family:layout-regions` FR5, FR6 |
| FR5 | `role` and `label` set the root's `role` and `aria-label`; LayoutPanel adds a role and a name of its own only while it scrolls (AR3). | Current source and tests; `family:layout-regions` FR8 |
| FR6 | `ref` reaches the root. Supported DOM, data, ARIA, and event props reach the root after the component's own attributes; `xstyle`, `className`, and `style` compose after component styles. | Current source and tests; `architecture:public-component-api` INV5–INV8 |
@@ -194,8 +190,7 @@ of its own, so no anatomy-theming block is declared here.
delegation; FR1–FR5 and AR1 apply them.
- `spec:AST-105` FR9 owns the edge reveal FR7 plays and the focus rule AR2
applies; `component:Resizable` FR8 owns when it plays.
-- `architecture:container-padding` owns inset publication; FR3 applies it and
- records the gap.
+- `architecture:container-padding` owns inset publication; FR3 applies it.
- `component:Layout` owns slot placement, the Layout-edge inset, and the
`layout-panel` target mapping.
@@ -205,7 +200,7 @@ of its own, so no anatomy-theming block is declared here.
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| FR1, ORD1 | `LayoutSlots.test.tsx` class, width, and resizable tests; `collapsedPanel.interaction.browser.spec.ts` for width 0 | Numeric, string and zero width; resizable; a collapsed region | A lost `layout-panel` class, a missing width, or `width` beating `resizable` fails. Gap: the non-shrinking root, scrolling, and `isScrollable={false}` have no check. No requirement or check covers how a keyboard user reaches a scrolling panel's overflow when the panel holds no focusable content. | `audit:LayoutPanel/layout` |
| FR2 | `LayoutSlots.test.tsx` start- and end-slot tests; `Layout.a11y.chromium.spec.ts` `start-end-navigation-rtl` state | Start and end panels; right-to-left | A panel that fails to render in either slot fails. Gap: no check asserts which edge carries the divider or the shared gap. | `audit:LayoutPanel/layout` |
-| FR3, ORD2 | Source review | Automatic, explicit, and zero padding | Gap: no test covers the automatic per-edge inset, the `padding` replacement, full bleed, or the published values. | `audit:LayoutPanel/layout` |
+| FR3, ORD2 | `nestedPadding.test.tsx` LayoutPanel publication tests; `LayoutPanelAudit.a11y.chromium.spec.ts` inset and full-bleed receipts | Automatic, explicit, and zero padding | A published edge that differs from the padding the panel applies, an edge with the wrong inset, or a full-bleed child that misses the panel's outer edge fails. | `audit:LayoutPanel/layout` |
| FR4 | Source review | `hasDivider`; no divider | Gap: no test covers the divider line, the shared gap, or a panel divider beside a ResizeHandle. | `audit:LayoutPanel/layout` |
| FR5, AR1 | `LayoutSlots.test.tsx` landmark test; `Layout.a11y.test.tsx` and `Layout.a11y.chromium.spec.ts` `start-end-navigation-rtl` and `nested-panel-region` states | Caller `navigation` and `region` roles and labels | A lost role or name fails, including at the accessibility tree. Gap: no test asserts that a panel without `role` exposes none. | `audit:LayoutPanel/accessibility` |
| FR6 | `LayoutSlots.test.tsx` ref and className tests | Ref; caller class | A ref on another element or a dropped class fails. Gap: no test covers `style`, DOM, data, or event props, or the `xstyle` merge order. | `audit:LayoutPanel/api` |
diff --git a/docs/specs/components/Lightbox/Lightbox.spec.md b/docs/specs/components/Lightbox/Lightbox.spec.md
index fe1b59e2a9..0666e8a718 100644
--- a/docs/specs/components/Lightbox/Lightbox.spec.md
+++ b/docs/specs/components/Lightbox/Lightbox.spec.md
@@ -89,16 +89,8 @@ the requirement it misses and the person it affects.
- **Video controls (FR7).** A video's native controls are taken as a 48 px
band at its bottom edge, since browsers expose no control geometry; a
browser that places controls elsewhere pages from them.
-- **Tab containment (FR4).** Tab from the viewer's last control can move focus
- to the browser's own interface.
-- **Zoom reset key (AR3).** `0` does not return a zoomed photo to its fitted
- size.
- **Zoom announcement (AR4).** A zoom change announces "zoomed in" or "zoomed
out" without the zoom level.
-- **Announcements outside the open viewer (AR4).** Position and zoom messages
- are sent from above the modal Lightbox renders, so they reach the page body
- and a screen-reader user does not hear them while the viewer is open
- (`spec:AST-086` FR14).
- **Fine-pointer gestures (FR11).** FR11's drag paging (FR7) and drag to
close (FR8) are not built for a mouse, a pen or a trackpad: a drag on a
fitted photo does nothing.