basalt-ui 1.31.0 → 1.32.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+# [1.32.0](https://github.com/jkrumm/basalt-ui/compare/v1.31.0...v1.32.0) (2026-09-30)
+
+
+### Bug Fixes
+
+* build BasaltDataTable cards only in card mode, guard the routed-prop lookup ([4024e83](https://github.com/jkrumm/basalt-ui/commit/4024e8333c83cb4808507929f47246209e67a00a))
+* exempt a container Grid only when its breakpoints map resolves ([d6d9bda](https://github.com/jkrumm/basalt-ui/commit/d6d9bdaa7eb693a01166d121fdc5bb95002bb09d))
+* honour maxHeight in BasaltDataTable's card projection ([3b59a2f](https://github.com/jkrumm/basalt-ui/commit/3b59a2f5304969e0dcadfa77b1ff375fd0f1d048))
+* key StatGroup and WidgetGrid on the container-class law ([db6e130](https://github.com/jkrumm/basalt-ui/commit/db6e130d050d562926fce63e7f1a5e3d0aeb45f8))
+* move raw-media-query's promotion to 1.33.0 with its AST twin ([ac2641c](https://github.com/jkrumm/basalt-ui/commit/ac2641c4ac1fcb42b2381758ae9a2b20809ce630))
+* move useBreakpoint's removal to 1.33.0 and correct its replacement ([a2c356b](https://github.com/jkrumm/basalt-ui/commit/a2c356bd1979960b8b9fc26eb8341cc84d3e88ee))
+* narrow the container-grid exemption to the props Mantine routes ([d547022](https://github.com/jkrumm/basalt-ui/commit/d5470226008984fba39849062c0ee0abbac178cc))
+* prune ignored dirs during the doc-drift repo walk instead of after it ([a4647dc](https://github.com/jkrumm/basalt-ui/commit/a4647dcd380f74f7ac73989fa6857d2041d16a23))
+* read only width clauses when judging a shell/ media query ([3f14b7f](https://github.com/jkrumm/basalt-ui/commit/3f14b7f342c64c9f2b7b1b04887930f37f695f01))
+* say legend.maxRows changed unit in its deprecation warning ([29ad3a5](https://github.com/jkrumm/basalt-ui/commit/29ad3a5183648a0edc71250b22a996fa818edfb8))
+* stop warning legend-slot contention on a same-commit owner hand-off ([af18cfa](https://github.com/jkrumm/basalt-ui/commit/af18cfad7c3d9747a7cc6c0a117db34bbb8cd531))
+
+
+### Features
+
+* give basalt/raw-breakpoint a reachable container-grid answer ([2bf4a22](https://github.com/jkrumm/basalt-ui/commit/2bf4a2256fff9b08adcd6c3716b92993b4fdb40a))
+* project BasaltDataTable rows as cards on the table's own width ([f201b2a](https://github.com/jkrumm/basalt-ui/commit/f201b2ac81726fc47b2adb5660fd42ce2c881b3e))
+
 # [1.31.0](https://github.com/jkrumm/basalt-ui/compare/v1.30.2...v1.31.0) (2026-09-28)
 
 

package/MIGRATING.md

@@ -66,18 +66,18 @@ There is one row per SURFACE, not per export, and a surface earns a row once any
 shipped lefthook preset both changed in 1.30.0 with no row that owned them — which is how a
 consumer read this index, found nothing, and diffed a KPI row that had silently gone 4-up → 2-up.
 
-| Surface                       | 1.27.0                                                       | 1.28.0                                                                                 | 1.29.0                                                                                         | 1.30.0                                                                             | 1.30.1                                                                | 1.30.2 | 1.31.0                                                                                                    | Unreleased |
-| ----------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------- | ---------- |
-| **tokens** (`./tokens`)       | —                                                            | `--vx-divider` → `rgba()` on both schemes (§ Shell)                                    | `--vx-space-touch-target` added (§ Additions)                                                  | eight spacing numbers (§ Chrome)                                                   | —                                                                     | —      | `--vx-hit` replaces the touch vars; `SIZE_CLASSES` (§ Unreleased)                                         | —          |
-| **charts** (`./charts`)       | —                                                            | phone tier, `curve`, formatters, `state`, log axis (§ preamble)                        | `ChartState.empty: string`, `AxisBottomNumeric` (§ Additions)                                  | responsive `height`, `legend.maxRows` (§ Charts)                                   | `height` reaches the kinds; `maxRows` beats the `fill` fit (§ Charts) | —      | container-class tier + `height` keys (§ Unreleased)                                                       | —          |
-| **shell** (`.`)               | —                                                            | scrollport, region seams, **the brand left the sidebar** (§§ scrollport, brand, Shell) | `PageTitle`, `BasaltDevDock`, `useBreakpoint` (§ Additions)                                    | More popover, aside pill, the responsive gutter, `useBasaltSpacing` (§ Chrome)     | —                                                                     | —      | `theme.breakpoints` derived, `useSizeClass`, `data-basalt-host`, `useBreakpoint` on notice (§ Unreleased) | —          |
-| **controls** (`./controls`)   | `NumberFilter`, `field.number` (§ Controls)                  | sheet renders panel rows; `PanelRow`, `SliderControl` (§ `basalt-ui/controls`)         | —                                                                                              | —                                                                                  | —                                                                     | —      | —                                                                                                         | —          |
-| **forms** (`./forms`)         | —                                                            | `field` → `inputProps`, **`inputProps` drops `key`**, the layout tier (§ `inputProps`) | `field` DELETED — and the `--fix` recipe no longer works (§ Consolidation)                     | —                                                                                  | —                                                                     | —      | —                                                                                                         | —          |
-| **data** (`./data/table`)     | —                                                            | root is a `<div>`, row selection, `getItemKey` required (§ `basalt-ui/data`)           | `./data` + `./query` + `./connectivity` dropped (§ Consolidation)                              | —                                                                                  | —                                                                     | —      | —                                                                                                         | —          |
-| **dashboard** (`.`)           | `StatCard`: `unit`, `breakdown`, delta format (§ `StatCard`) | `StatGroup`, `WidgetGrid`, query-aware `StatCard` — additive                           | —                                                                                              | **the column law keys on the CONTAINER; `cols={4}` is 2-up at `sm`** (§ Dashboard) | —                                                                     | —      | —                                                                                                         | —          |
-| **toolchain** (`./configs/*`) | —                                                            | —                                                                                      | the shipped lefthook preset's `check-theme` BROKE — the CLI resolver stopped ascending (§ CLI) | the preset's default bin, and the `root:` recipe (§ Toolchain)                     | —                                                                     | —      | —                                                                                                         | —          |
-| **CLI** (`basalt-ui`)         | —                                                            | —                                                                                      | **resolver stops relocating; `doctor` loses 6 of 10 checks** (§ CLI)                           | —                                                                                  | —                                                                     | —      | —                                                                                                         | —          |
-| **guards**                    | five rules → `error` (§ Guards)                              | six new ids at `warn` (§ preamble)                                                     | `query-dual-import` retired in 1.29.1 (§ Guards)                                               | four rules → `error` (§ Guards)                                                    | —                                                                     | —      | —                                                                                                         | —          |
+| Surface                       | 1.27.0                                                       | 1.28.0                                                                                 | 1.29.0                                                                                         | 1.30.0                                                                             | 1.30.1                                                                | 1.30.2 | 1.31.0                                                                                                    | 1.32.0                                                                        | Unreleased |
+| ----------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ---------- |
+| **tokens** (`./tokens`)       | —                                                            | `--vx-divider` → `rgba()` on both schemes (§ Shell)                                    | `--vx-space-touch-target` added (§ Additions)                                                  | eight spacing numbers (§ Chrome)                                                   | —                                                                     | —      | `--vx-hit` replaces the touch vars; `SIZE_CLASSES` (§ Unreleased)                                         | —                                                                             | —          |
+| **charts** (`./charts`)       | —                                                            | phone tier, `curve`, formatters, `state`, log axis (§ preamble)                        | `ChartState.empty: string`, `AxisBottomNumeric` (§ Additions)                                  | responsive `height`, `legend.maxRows` (§ Charts)                                   | `height` reaches the kinds; `maxRows` beats the `fill` fit (§ Charts) | —      | container-class tier + `height` keys (§ Unreleased)                                                       | —                                                                             | —          |
+| **shell** (`.`)               | —                                                            | scrollport, region seams, **the brand left the sidebar** (§§ scrollport, brand, Shell) | `PageTitle`, `BasaltDevDock`, `useBreakpoint` (§ Additions)                                    | More popover, aside pill, the responsive gutter, `useBasaltSpacing` (§ Chrome)     | —                                                                     | —      | `theme.breakpoints` derived, `useSizeClass`, `data-basalt-host`, `useBreakpoint` on notice (§ Unreleased) | `useBreakpoint` removal → 1.33.0; `useSizeClass` is shell-only (§ Unreleased) | —          |
+| **controls** (`./controls`)   | `NumberFilter`, `field.number` (§ Controls)                  | sheet renders panel rows; `PanelRow`, `SliderControl` (§ `basalt-ui/controls`)         | —                                                                                              | —                                                                                  | —                                                                     | —      | —                                                                                                         | —                                                                             | —          |
+| **forms** (`./forms`)         | —                                                            | `field` → `inputProps`, **`inputProps` drops `key`**, the layout tier (§ `inputProps`) | `field` DELETED — and the `--fix` recipe no longer works (§ Consolidation)                     | —                                                                                  | —                                                                     | —      | —                                                                                                         | —                                                                             | —          |
+| **data** (`./data/table`)     | —                                                            | root is a `<div>`, row selection, `getItemKey` required (§ `basalt-ui/data`)           | `./data` + `./query` + `./connectivity` dropped (§ Consolidation)                              | —                                                                                  | —                                                                     | —      | —                                                                                                         | —                                                                             | —          |
+| **dashboard** (`.`)           | `StatCard`: `unit`, `breakdown`, delta format (§ `StatCard`) | `StatGroup`, `WidgetGrid`, query-aware `StatCard` — additive                           | —                                                                                              | **the column law keys on the CONTAINER; `cols={4}` is 2-up at `sm`** (§ Dashboard) | —                                                                     | —      | —                                                                                                         | —                                                                             | —          |
+| **toolchain** (`./configs/*`) | —                                                            | —                                                                                      | the shipped lefthook preset's `check-theme` BROKE — the CLI resolver stopped ascending (§ CLI) | the preset's default bin, and the `root:` recipe (§ Toolchain)                     | —                                                                     | —      | —                                                                                                         | —                                                                             | —          |
+| **CLI** (`basalt-ui`)         | —                                                            | —                                                                                      | **resolver stops relocating; `doctor` loses 6 of 10 checks** (§ CLI)                           | —                                                                                  | —                                                                     | —      | —                                                                                                         | —                                                                             | —          |
+| **guards**                    | five rules → `error` (§ Guards)                              | six new ids at `warn` (§ preamble)                                                     | `query-dual-import` retired in 1.29.1 (§ Guards)                                               | four rules → `error` (§ Guards)                                                    | —                                                                     | —      | —                                                                                                         | `raw-breakpoint`: the container-grid answer, `error` at 1.33.0 (§ Unreleased) | —          |
 
 ---
 
@@ -86,6 +86,88 @@ consumer read this index, found nothing, and diffed a KPI row that had silently
 _Nothing yet. Author the next section under this heading as `## Unreleased — <title>`; the
 release renames it and opens a new one here._
 
+## 1.32.0 — `basalt/raw-breakpoint` gets its answer
+
+### The C1 pair (`control-outside-home` / `raw-selection-control`) — `error` at 1.33.0, the last extension
+
+Re-measured 2026-09-30: basalt's own tree 0, the fleet ~33 (image-gen 11, rb 7, image-share 6,
+weatherorb 5, email-gateway 4, argo 2). Clear them on 1.32.0 while they still warn — the remedies
+are unchanged (§ 1.31.0 below: a `PageBar` home, `basalt-ui/forms` rows, bound `FieldHandle`s, or a
+reasoned `theme-allow`). 1.33.0 promotes all four ids — this pair plus `raw-breakpoint` and
+`raw-media-query` — together.
+
+### `basalt/raw-breakpoint`
+
+1.31.0 shipped this rule (`warn`) with a message that said "reach for a container query" and named
+no primitive, and this file never mentioned it. It flags four shapes; each has a concrete target
+now. **Severity: `warn`, promotes to `error` at 1.33.0** (moved from 1.32.0 — this is the first
+minor with a documented answer). A `theme-allow raw-breakpoint — <reason>` waives one occurrence.
+
+**Its CSS twin, the `raw-media-query` guard kind** (`basalt-ui check-theme`), enforces the same law
+in `.css`: a width `@media` outside `shell/**`, an `@container` name other than `basalt-card` /
+`basalt-form` / `basalt-main` / `basalt-grid` or at a width off a `CONTAINER_CLASSES` boundary, and
+a pointer query other than `coarse`/`fine`. Same `warn`, and it moved with the rule — **`error` at
+1.33.0** (was 1.32.0). `theme-allow raw-media-query — <reason>` waives one line.
+
+**The law.** `useSizeClass()` is for **shell chrome**. A page swapping its OWN layout — a column
+count, a table for a card list, a row for a stack — is a **container** decision, keyed on
+`CONTAINER_CLASSES` (`basalt-ui/tokens`: compact 240 · regular 480 · wide 800), not the viewport.
+The primitive is Mantine 9's own `type="container"` grid. Verified against `@mantine/core` 9.3
+source, which is what the rule's exemption is built on:
+
+- `SimpleGrid type="container"` wraps itself in a `container: simple-grid / inline-size` div (no
+  ancestor needed) and writes **each key verbatim** into `@container simple-grid (min-width: <key>)`.
+  Keys are CSS lengths — `'480px'`, not `480` (unitless is invalid) and not `sm` (never resolved
+  through `theme.breakpoints`; emits a dead query). The rule flags `sm`-style keys there.
+- `Grid type="container"` only goes container **when it also gets a `breakpoints` map**; without
+  one it silently renders viewport media queries (flagged). The map is typed
+  `Record<MantineSize, string>` — all five `xs`–`xl`, no custom names — and `Grid.Col` keys resolve
+  through it, so `sm` there means whatever width the map gives it (exempt).
+
+| Shape (what it flags)                                                                           | Replace with                                                                                                                                                                                                                              |
+| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| responsive object on a Mantine prop — `SimpleGrid cols={{ base, sm }}`                          | `SimpleGrid type="container"` with px keys (below)                                                                                                                                                                                        |
+| `Grid.Col span={{ base, lg }}`                                                                  | `Grid type="container"` + a `breakpoints` map onto container widths; spans keyed through it                                                                                                                                               |
+| `Flex direction={{ base: 'column', sm: 'row' }}`                                                | the container `SimpleGrid` (equal columns); a plain `Group` (wraps by default) for intrinsic-width items; or a CSS module: `container: basalt-grid / inline-size` on the parent, `@container basalt-grid (min-width: 480px)` on the child |
+| `visibleFrom`/`hiddenFrom` outside a shell home or a control's C9 swap                          | the same container rule, `display` toggled in the CSS module — or drop the swap                                                                                                                                                           |
+| `useMediaQuery`/`useMatches`/`useViewportSize` (`@mantine/*`), `window.matchMedia`/`innerWidth` | shell chrome: `useSizeClass()`; a page's layout: one of the above                                                                                                                                                                         |
+
+```tsx
+// before — viewport breakpoints
+<SimpleGrid cols={{ base: 1, sm: 3 }}>…</SimpleGrid>
+<Grid><Grid.Col span={{ base: 12, lg: 4 }}>…</Grid.Col></Grid>
+
+// after — the grid's own width
+import { CONTAINER_CLASSES as C } from 'basalt-ui/tokens'
+<SimpleGrid type="container" cols={{ base: 1, [`${C.regular}px`]: 3 }}>…</SimpleGrid>
+const px = (n: number) => `${n}px`
+const containerBreakpoints = { xs: px(C.compact), sm: px(C.regular), md: px(C.wide), lg: px(C.wide), xl: px(C.wide) }
+<Grid type="container" breakpoints={containerBreakpoints}>
+  <Grid.Col span={{ base: 12, md: 4 }}>…</Grid.Col>
+</Grid>
+```
+
+Pick the container key by the grid's own width, not by the viewport key it replaces: a grid inside a
+page with an aside or a sidebar is narrower than the viewport, which is the point.
+
+### `StatGroup` / `WidgetGrid` — `sm` opens at 800px, container name `basalt-grid`
+
+Both grids now key on the container-class law basalt ships: the `sm` column count opens at the
+`wide` class (**800px** of the grid's own width, was 768); the full `cols` count still opens at
+1200px. A grid 768–799px wide now renders its base count (StatGroup 2, WidgetGrid 1). The
+container they declare is renamed `basalt-stat-group`/`basalt-widget-grid` → **`basalt-grid`** — only
+a consumer rule written against the old names needs editing. The `@supports not (container-type)`
+viewport fallbacks (these two and `FormRow`'s) are gone: every browser that parses basalt's
+`color-mix()` also parses `@container`.
+
+### `useBreakpoint` — removal moved to 1.33.0, and the 1.31.0 replacement line was half wrong
+
+`useBreakpoint('sm')` → `useSizeClass() !== 'compact'` holds for **shell chrome only**. A page
+swapping its own layout on it (argo's table ↔ card list) is a container decision — see above. Note
+that `useSizeClass()` answers `'compact'` on the first frame (the server snapshot,
+`<BasaltProvider sizeClassHint>`) where `useBreakpoint` returned `undefined`, so an
+`isLg === true` guard written for that `undefined` can go.
+
 ## 1.31.0 — size classes and the pointer tier
 
 `theme.breakpoints` is now derived from `SIZE_CLASSES` (compact < 840, medium 840–1199, expanded
@@ -93,7 +175,9 @@ release renames it and opens a new one here._
 it out. Mapping: `xs` = `sm` = 52.5em (medium opens), `md` = `lg` = `xl` = 75em (expanded opens) — the
 keys collapse. So `xs` moves 36em → 52.5em, `sm` 48em → 52.5em (an iPad portrait is now bottom-bar chrome), `md`
 62em → 75em, `lg` stays 75em and `xl` 88em → 75em. Check every `visibleFrom`/`hiddenFrom`/`useBreakpoint`
-on those keys: `xs` no longer differs from `sm`, and `md`/`lg`/`xl` now switch at the same width.
+on those keys: `xs` no longer differs from `sm`, and `md`/`lg`/`xl` now switch at the same width. Outside a
+shell home those props are `basalt/raw-breakpoint` findings — move them to a container grid rather
+than re-keying them (see that section above).
 
 | Removed                                                                                                                     | Replacement                                                                                                                                                                           |
 | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -149,10 +233,10 @@ everywhere).
 `storageKey`. Opt out with a controlled `collapsed` prop; a persisted `false` (the user opened it
 once) pins it open.
 
-**On notice — `useBreakpoint` (removed next minor).** `@deprecated`, still works. Replace
-`useBreakpoint('sm')` with `useSizeClass() !== 'compact'`, and `useBreakpoint('lg')` with
-`useSizeClass() === 'expanded'`. A `max`-edge or non-shell width read is a container concern: use
-`@container` in CSS.
+**On notice — `useBreakpoint` (removal moved to 1.33.0).** `@deprecated`, still works. For shell
+chrome, replace `useBreakpoint('sm')` with `useSizeClass() !== 'compact'` and `useBreakpoint('lg')`
+with `useSizeClass() === 'expanded'`. A page's own layout swap is a container decision, not a
+`useSizeClass()` one — corrected after release; see the `basalt/raw-breakpoint` section above.
 
 **Card chrome keys on the card's own width, not the viewport.** `ChartCard`, `StatCard` and `Section`
 are now `container: basalt-card / inline-size` (`container-type: inline-size` — layout and inline-size

package/agent/rules/basalt-mantine.md

@@ -48,8 +48,7 @@ single mount (`basalt/hand-rolled-shell` fires on `AppShell.*` parts or a `Burge
 does not render it). The sub-components are exported for a genuinely divergent layout; prefer the
 shell, which already wires collapse persistence, the mobile breakpoint and the breadcrumb.
 
-Every extension point is **declared data, not a `ReactNode` slot**, so basalt owns the mobile
-projection:
+Extension points are **declared data, not `ReactNode` slots**, so basalt owns the mobile projection:
 
 | Prop                | Shape                                | What basalt then owns                                                                  |
 | ------------------- | ------------------------------------ | -------------------------------------------------------------------------------------- |
@@ -98,6 +97,8 @@ Depth-tier law (which token for which surface, why static, why the ring is inset
   clears the iOS zoom threshold via an `!important` floor (`sub-16-input-font` flags a smaller one).
 - **Charts measure themselves** — pass `height`/`aspectRatio`/`fill` only; never `useElementSize`
   in a chart file (Mantine is banned there), never raw `@visx/responsive` outside `charts/**`.
+- **A page's own layout keys on its container, not the viewport** — Mantine's `type="container"`
+  grids on `CONTAINER_CLASSES`; `useSizeClass()` is shell chrome only. Recipes: `MIGRATING.md`.
 
 ## Scroll regions
 
@@ -105,8 +106,7 @@ Depth-tier law (which token for which surface, why static, why the ring is inset
 it draws its own bar inside its root, so the bar floats instead of reflowing the column
 (`AppSidebar`'s nav is the reference: `type="hover"`, `scrollbars="y"`). Raw `overflow: auto` stays
 correct only where a library owns the node (`BasaltStickToBottom`, `BasaltVirtualList`) and for a
-table body (`Table.ScrollContainer type="native"` — a `ScrollArea` viewport would break a sticky
-`<thead>`'s positioning context).
+table body (`Table.ScrollContainer type="native"` — a `ScrollArea` viewport breaks a sticky `<thead>`).
 
 ## Interaction feedback and motion
 

package/configs/oxlint-plugin.js

@@ -2708,7 +2708,7 @@ const CONTROL_OUTSIDE_HOME_MESSAGE =
  * `@mantine/form` (a form is the third home and its inputs are not filters), and the owner
  * exemption — a file DEFINING a basalt control cannot be told to use one.
  */
-// Ships: warn (grace → 1.32.0)
+// Ships: warn (grace → 1.33.0)
 const controlOutsideHome = {
   meta: {
     type: 'suggestion',
@@ -3656,8 +3656,9 @@ export const DEPRECATED_EXPORTS = [
   {
     subpath: 'basalt-ui',
     name: 'useBreakpoint',
-    replacement: 'useSizeClass (compact/medium/expanded) or @container for a container concern',
-    removeIn: '1.31.0',
+    replacement:
+      'useSizeClass() for shell chrome; a page’s own layout swap is a container decision — a type="container" SimpleGrid/Grid or an @container rule',
+    removeIn: '1.33.0',
     fix: false,
   },
 ]
@@ -3959,14 +3960,16 @@ const RESPONSIVE_OBJECT_KEYS = new Set(['base', 'xs', 'sm', 'md', 'lg', 'xl'])
  * object that merely happens to have a `sm` key among other, unrelated ones is not this shape, and
  * an empty object is not a breakpoint decision at all.
  */
-function isResponsiveObjectValue(node) {
+function isResponsiveObjectValue(node, namedOnly = false) {
   if (node === null || node === undefined || node.type !== 'ObjectExpression') return false
   if (node.properties.length === 0) return false
-  return node.properties.every((prop) => {
-    if (prop.type !== 'Property') return false
-    const name = propertyKeyName(prop)
-    return typeof name === 'string' && RESPONSIVE_OBJECT_KEYS.has(name)
-  })
+  const names = node.properties.map((prop) =>
+    prop.type === 'Property' ? propertyKeyName(prop) : undefined,
+  )
+  if (!names.every((name) => typeof name === 'string' && RESPONSIVE_OBJECT_KEYS.has(name)))
+    return false
+  // Under `type="container"` a lone `base` is the unconditional value, not a breakpoint decision.
+  return !namedOnly || names.some((name) => name !== 'base')
 }
 
 /**
@@ -3977,17 +3980,91 @@ function isResponsiveObjectValue(node) {
  * appears — the top-level attribute value and a nested property value alike. Matching only a nested
  * `ObjectExpression` left the Identifier-in-a-property shape trivially bypassable.
  */
-function containsResponsiveObjectValue(node, consts, seen = new Set()) {
+function containsResponsiveObjectValue(node, consts, namedOnly = false, seen = new Set()) {
   const resolved =
     node !== null && node !== undefined && node.type === 'Identifier' ? consts.get(node.name) : node
   if (resolved === null || resolved === undefined || resolved.type !== 'ObjectExpression')
     return false
   if (seen.has(resolved)) return false
   seen.add(resolved)
-  if (isResponsiveObjectValue(resolved)) return true
+  if (isResponsiveObjectValue(resolved, namedOnly)) return true
   return resolved.properties.some(
-    (prop) => prop.type === 'Property' && containsResponsiveObjectValue(prop.value, consts, seen),
+    (prop) =>
+      prop.type === 'Property' &&
+      containsResponsiveObjectValue(prop.value, consts, namedOnly, seen),
+  )
+}
+
+/**
+ * The props each Mantine grid routes through `@container` queries under `type="container"` —
+ * confirmed in `@mantine/core` 9.3 source: `SimpleGridContainerVariables` reads `cols`/`spacing`/
+ * `verticalSpacing`, `GridVariables` reads `gap`/`rowGap`/`columnGap`, `GridColVariables` reads
+ * `span`/`offset`/`order`/`align`. Every OTHER responsive prop on the same element (`p`, `mt`,
+ * `mih`, …) is a Box style prop and still compiles to viewport `@media`, so the container exemption
+ * stops at this set. `Grid`'s own `breakpoints` is the container scale itself, not a viewport key.
+ */
+const CONTAINER_ROUTED_PROPS = {
+  SimpleGrid: new Set(['cols', 'spacing', 'verticalSpacing']),
+  Grid: new Set(['gap', 'rowGap', 'columnGap', 'breakpoints']),
+  'Grid.Col': new Set(['span', 'offset', 'order', 'align']),
+}
+
+/**
+ * How Mantine 9 resolves a responsive object on this element's grid, read from `@mantine/core`
+ * 9.3 source — the sanctioned answer to this rule, so it has to be exempt exactly where it works:
+ *
+ * - `'container'` — a `<Grid type="container" breakpoints={…}>` (or a `Grid.Col` inside one) whose
+ *   map statically resolves to a non-empty object. Keys resolve through that map into
+ *   `@container mantine-grid` queries, so an `sm` key is whatever width the map gives it: exempt.
+ *   Mantine types the map as `Record<MantineSize, string>`, so the recipe's keys ARE `xs`–`xl` —
+ *   exempting by key name instead of by owner would flag the sanctioned answer itself.
+ * - `'simple-grid'` — `<SimpleGrid type="container">`. `SimpleGridContainerVariables` writes each
+ *   key VERBATIM as `@container simple-grid (min-width: <key>)` and never consults
+ *   `theme.breakpoints`: a `'480px'` key works (and is not a responsive-object key, so it never
+ *   reaches here), while `sm` emits `(min-width: sm)` — invalid CSS, a dead query. Flagged.
+ * - `'fallback'` — `<Grid type="container">` whose `breakpoints` is absent, `undefined`, `{}` or not
+ *   statically resolvable (or a `Grid.Col` in one). `Grid` takes its container branch only on a
+ *   truthy map, and an empty one emits no query at all — so none of these is the container law,
+ *   and an unreadable map is reported rather than trusted. Flagged.
+ * - `undefined` — not a container grid; the ordinary viewport law applies.
+ *
+ * `type` has to be the string literal `"container"`; a dynamic value is not a decision this rule
+ * can read. `Grid.Col` takes its grid's mode by walking to the nearest enclosing `Grid` element.
+ * `consts` is the rule's same-file name→object map, so `breakpoints={map}` resolves like any value.
+ */
+function containerGridMode(opening, mantineImports, consts) {
+  let tag = resolveMantineTag(opening.name, mantineImports)
+  let grid = opening
+  if (tag === 'Grid.Col') {
+    grid = undefined
+    let node = opening.parent?.parent
+    for (let depth = 0; node !== null && node !== undefined; depth++, node = node.parent) {
+      if (depth > ANCESTRY_MAX_DEPTH || node.type === 'Program') break
+      if (node.type !== 'JSXElement') continue
+      if (resolveMantineTag(node.openingElement.name, mantineImports) !== 'Grid') continue
+      grid = node.openingElement
+      tag = 'Grid'
+      break
+    }
+  }
+  if (grid === undefined || (tag !== 'Grid' && tag !== 'SimpleGrid')) return undefined
+  const attr = (name) =>
+    grid.attributes.find((a) => a.type === 'JSXAttribute' && a.name?.name === name)
+  const type = attr('type')
+  if (
+    type === undefined ||
+    !isStringLiteral(attrValue(type)) ||
+    attrValue(type).value !== 'container'
   )
+    return undefined
+  if (tag === 'SimpleGrid') return 'simple-grid'
+  const breakpoints = attr('breakpoints')
+  if (breakpoints === undefined) return 'fallback'
+  let map = attrValue(breakpoints)
+  if (map?.type === 'Identifier') map = consts.get(map.name)
+  const nonEmpty =
+    map?.type === 'ObjectExpression' && map.properties.some((prop) => prop.type === 'Property')
+  return nonEmpty ? 'container' : 'fallback'
 }
 
 /**
@@ -4011,27 +4088,44 @@ const SHELL_HOME_NAMES = new Set(['BasaltShell', 'AppSidebar', 'MobileNav', 'App
  */
 const RAW_BREAKPOINT_EXEMPT_FILE = /(?:^|[\\/])(?:use-media-query\.ts|ChartTooltip\.tsx)$/
 
+/**
+ * The one recipe every raw-breakpoint message points at. A page's own layout keys on its CONTAINER
+ * (`CONTAINER_CLASSES`, `basalt-ui/tokens`: compact 240 / regular 480 / wide 800), never on the
+ * viewport — `useSizeClass()` is the shell's seam, not a page's. Mantine 9's own `type="container"`
+ * grids are the primitive: both self-wrap in an `inline-size` container, so they need no ancestor.
+ * The px literals are `CONTAINER_CLASSES` written out (the plugin cannot import TS source);
+ * `oxlint-plugin.test.ts` asserts every one against it, and the MIGRATING recipe too.
+ */
+export const RAW_BREAKPOINT_RECIPE =
+  'A page’s own layout keys on its container: <SimpleGrid type="container" cols={{ base: 1, ' +
+  "'480px': 2, '800px': 3 }}> (px keys = CONTAINER_CLASSES, basalt-ui/tokens), or <Grid " +
+  'type="container" breakpoints={…}> mapping all five xs–xl onto those px widths, with Grid.Col ' +
+  'span={{ base: 12, sm: 6 }} keyed through that map; a Flex direction swap becomes that SimpleGrid (equal ' +
+  'columns), a wrapping Group, or a CSS-module @container basalt-grid rule. useSizeClass() is for ' +
+  'shell chrome only. Recipes: basalt-ui MIGRATING.md § basalt/raw-breakpoint.'
+
 const RAW_BREAKPOINT_RESPONSIVE_PROP_MESSAGE =
-  'Responsive-object style prop on a Mantine component — the framework owns the three responsive ' +
-  'axes (size class for shell chrome, container class for a component’s own width, pointer tier), ' +
-  'never a per-component `{ base, sm, … }`. Reach for a container query for this component’s own ' +
-  'width, or useSizeClass() for shell-only chrome. (basalt/raw-breakpoint)'
+  'Responsive-object prop keyed on theme breakpoints — those are viewport widths. ' +
+  `${RAW_BREAKPOINT_RECIPE} (basalt/raw-breakpoint)`
+
+const RAW_BREAKPOINT_CONTAINER_KEY_MESSAGE =
+  'Theme breakpoint name under type="container" — Mantine does not resolve it there: ' +
+  "SimpleGrid uses each key verbatim as a (min-width: …) length, so 'sm' is a dead query, " +
+  'and Grid only goes container with a breakpoints map (without one it silently falls back to ' +
+  `viewport media queries). ${RAW_BREAKPOINT_RECIPE} (basalt/raw-breakpoint)`
 
 const RAW_BREAKPOINT_VISIBLE_HIDDEN_MESSAGE =
-  "visibleFrom/hiddenFrom outside a shell home or a control's own C9 swap — this pair is the " +
-  "size-class axis's one JSX escape hatch. Anywhere else it is a hand-rolled viewport breakpoint " +
-  "the framework cannot see or move. Use a container query for a component's own width instead. " +
-  '(basalt/raw-breakpoint)'
+  "visibleFrom/hiddenFrom outside a shell home or a control's own C9 swap — a viewport " +
+  `breakpoint the framework cannot see or move. ${RAW_BREAKPOINT_RECIPE} (basalt/raw-breakpoint)`
 
 const RAW_BREAKPOINT_HOOK_MESSAGE =
-  "useMediaQuery/useMatches/useViewportSize — a raw viewport read outside the framework's one seam " +
-  '(useSizeClass(), shell-only). A component deciding its own layout from a viewport read instead of ' +
-  'a container query is exactly the law this rule exists to catch. (basalt/raw-breakpoint)'
+  "useMediaQuery/useMatches/useViewportSize — a raw viewport read outside the framework's " +
+  'one seam. Shell chrome reads useSizeClass(); a page swapping its own layout (a table for a card ' +
+  `list, a column count) is a container decision. ${RAW_BREAKPOINT_RECIPE} (basalt/raw-breakpoint)`
 
 const RAW_BREAKPOINT_GLOBAL_MESSAGE =
-  'window.matchMedia/window.innerWidth read directly — the same viewport read useSizeClass() already ' +
-  "owns, shell-only. Route a component's own layout decision through a container query instead. " +
-  '(basalt/raw-breakpoint)'
+  'window.matchMedia/window.innerWidth read directly — the viewport read useSizeClass() owns ' +
+  `for shell chrome. ${RAW_BREAKPOINT_RECIPE} (basalt/raw-breakpoint)`
 
 /** The three viewport hooks the law names, whatever module they are imported from. */
 const RAW_BREAKPOINT_HOOK_NAMES = new Set(['useMediaQuery', 'useMatches', 'useViewportSize'])
@@ -4047,7 +4141,7 @@ const RAW_BREAKPOINT_HOOK_NAMES = new Set(['useMediaQuery', 'useMatches', 'useVi
  * declares a shell home (or a control's own C9 swap) is exempt for all four shapes uniformly — the
  * shell's own responsive chrome is the sanctioned use, whatever shape it takes.
  */
-// Ships: warn (grace → 1.32.0)
+// Ships: warn (grace → 1.33.0)
 const rawBreakpoint = {
   meta: {
     type: 'suggestion',
@@ -4056,7 +4150,8 @@ const rawBreakpoint = {
         'Disallow a hand-rolled viewport breakpoint — a responsive-object Mantine prop, ' +
         'visibleFrom/hiddenFrom outside a shell home, useMediaQuery/useMatches/useViewportSize, or ' +
         'a raw window.matchMedia/innerWidth read. All four shapes are exempt inside a file that ' +
-        'declares a shell-home component (or a control implementing its own C9 swap).',
+        'declares a shell-home component (or a control implementing its own C9 swap); a ' +
+        'responsive object on a Mantine type="container" grid is exempt where Mantine resolves it.',
     },
     schema: [],
   },
@@ -4153,12 +4248,27 @@ const rawBreakpoint = {
         if (definesShellHome || controlOwner.isOwner()) return
         for (const node of responsiveObjectCandidates) {
           const value = unwrapExpressionContainer(node.value)
-          if (!containsResponsiveObjectValue(value, responsiveObjectConsts)) continue
           const owner = node.parent
           if (owner === null || owner === undefined || owner.type !== 'JSXOpeningElement') continue
-          if (resolveMantineTag(owner.name, mantineImports) === undefined) continue
+          const tag = resolveMantineTag(owner.name, mantineImports)
+          if (tag === undefined) continue
+          // The container law reaches only the props Mantine routes through the grid's container
+          // queries; a `p={{ base, lg }}` on the same element is still a viewport @media.
+          const routed = Object.hasOwn(CONTAINER_ROUTED_PROPS, tag)
+            ? CONTAINER_ROUTED_PROPS[tag]
+            : undefined
+          const mode = routed?.has(node.name.name)
+            ? containerGridMode(owner, mantineImports, responsiveObjectConsts)
+            : undefined
+          if (mode === 'container') continue
+          if (!containsResponsiveObjectValue(value, responsiveObjectConsts, mode !== undefined))
+            continue
           if (hasThemeAllow(context, node, 'raw-breakpoint')) continue
-          context.report({ node, message: RAW_BREAKPOINT_RESPONSIVE_PROP_MESSAGE })
+          const message =
+            mode === undefined
+              ? RAW_BREAKPOINT_RESPONSIVE_PROP_MESSAGE
+              : RAW_BREAKPOINT_CONTAINER_KEY_MESSAGE
+          context.report({ node, message })
         }
         for (const node of visibleHiddenCandidates) {
           if (hasThemeAllow(context, node, 'raw-breakpoint')) continue
@@ -4202,8 +4312,9 @@ const rawBreakpoint = {
 export const PLUGIN_RULE_GRACE = {
   'control-outside-home': {
     since: '1.26.0',
-    promote: '1.32.0',
+    promote: '1.33.0',
     why:
+      "Extended 1.32.0 -> 1.33.0 at the 1.32.0 release, the last extension: basalt's own tree is at 0 (consumer-loop r1 dogfood) and argo is at 2, but RE-MEASURED 2026-09-30 the fleet carries ~33 (image-gen 11, rb 7, image-share 6, weatherorb 5, email-gateway 4, argo 2). The 1.32.0 fleet upgrade clears them while they warn, together with raw-breakpoint, so 1.33.0 promotes all four ids against a measured-clean fleet. " +
       'Extended 1.31.0 -> 1.32.0 at the 1.31.0 release: the basalt tree still carries incumbents (data-table, notifications center, theme-lab) and the argo sweep has not run. ' +
       'the wave-6 control guards (docs/CONTROLS-SPEC.md §6). The one openly HEURISTIC rule of the ' +
       'set — "this control has no home" is a claim about layout intent, so its false-positive load ' +
@@ -4232,17 +4343,23 @@ export const PLUGIN_RULE_GRACE = {
   },
   'raw-breakpoint': {
     since: '1.31.0',
-    promote: '1.32.0',
+    promote: '1.33.0',
     why:
-      'new in the wave-11 responsive/touch guards. Catches four ' +
-      'independent shapes at once — a responsive-object Mantine prop, visibleFrom/hiddenFrom outside ' +
-      'the three shell homes, the three raw viewport hooks, and window.matchMedia/innerWidth — none ' +
-      'of which basalt policed before this wave, so every consumer on an earlier minor has a green ' +
-      "build with all four shapes already in it. basalt-ui/content's own article-card.tsx (a " +
-      "`SimpleGrid cols={{ base: 1, sm: 2, lg }}`) is one incumbent measured in basalt's own tree at " +
-      'ship time — a real number, not zero, so this ships warn rather than error from the start. ' +
-      '1.32.0 is when that incumbent and any consumer-side ones are expected to have moved to a ' +
-      'container query or a theme-allow with a stated reason.',
+      'New in the wave-11 responsive/touch guards. Catches four independent shapes at once — a ' +
+      'responsive-object Mantine prop, visibleFrom/hiddenFrom outside the three shell homes, the ' +
+      'three raw viewport hooks, and window.matchMedia/innerWidth — none of which basalt policed ' +
+      'before this wave, so every consumer on an earlier minor has a green build with all four ' +
+      "shapes already in it. basalt-ui/content's own article-card.tsx (a `SimpleGrid cols={{ base: " +
+      "1, sm: 2, lg }}`) was one incumbent measured in basalt's own tree at ship time — a real " +
+      'number, not zero, so it shipped warn rather than error. ' +
+      'Extended 1.32.0 -> 1.33.0: 1.31.0 shipped the rule naming "a container query" but no ' +
+      'primitive, and MIGRATING never mentioned it (argo: 42 warns, no documented target). 1.32.0 ' +
+      'is the first minor with a reachable, documented answer (Mantine type="container" grids keyed ' +
+      'on CONTAINER_CLASSES, exempted here), and promoting in the minor that first makes a rule ' +
+      'satisfiable hands a consumer zero minors to act on it — the control-outside-home ' +
+      "extension's reasoning. 1.33.0 is when the incumbents are expected to have moved to a " +
+      'container grid or a theme-allow with a stated reason. Promotes together with its CSS twin, ' +
+      'the `raw-media-query` guard kind.',
   },
 }