@setsquare/ui 0.2.4 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,137 @@
 # Changelog
 
+## 0.5.0 — 2026-10-11
+
+Breaking: the `Tree` draws no box of its own. A tree that should stay framed goes in a `Card`.
+
+- **`Tree`'s new look**, the one `@setsquare/ui-blocks`' page outline is designed with. No border, card ground or
+  row dividers: rows sit on whatever holds the tree, `--nav-item-gap` apart, rounded, at least `--nav-item-height`
+  tall and `--target-min` at AAA. Each level indents by the new `--tree-indent` token (16px). `TreeHeader` is a
+  caption above its rows. Selected rows add a bold title and a `brand` icon to the old cues.
+- **`TreeItem` gains `icon`, `status`, `statusLabel`, `alwaysShowActions`, `dragLabel` and `allowsDragging`.**
+  - `description` moves onto the title's line, and under the title when it doesn't fit. It wraps and is never
+    cut short, so the text-spacing overrides lose none of it. A string description joins the row's name.
+  - `status` takes a `StatusBadge`, on the title's line and under it on a narrow row, never squeezing the title;
+    `statusLabel` puts its words in the row's name, because React Aria names a
+    row from its `textValue` alone.
+  - A row's `actions` show on the selected, focused and hovered row. Elsewhere they're faded out and take no
+    pointer events, but stay focusable, so focus on one shows it. `alwaysShowActions` keeps them showing.
+  - **Drag and drop.** With `dragAndDropHooks`, every draggable row gets a drag button first among its buttons, so a
+    keyboard or screen reader drag can start: Enter on it, ↑ ↓ through the drop places, Enter to drop, Esc to
+    cancel. Focus comes back to the drag button after a cancel. `allowsDragging={false}` leaves the button off a
+    row that can't move, such as a column in a page layout. The dragged row fades to 50%; a row being dropped
+    into gets `brand-subtle` and a 2px `brand` outline.
+  - Rows that only hold rows: `disabledKeys` with `disabledBehavior="selection"` keeps them focusable and
+    undimmed, never selected. Documented; no code change.
+- **`GridListItem` gains the same drag button, `dragLabel`, and dragging and drop-target states.** A draggable
+  row gives its start padding to the drag button, so the button's target needs no negative margin.
+- **`DropIndicator`**, new: where a dragged row will land in a Tree or a GridList, for `renderDropIndicator`. A
+  4px `brand` line with a 2px `background` halo, taking no room until it's the target. `tone="canvas"` draws it in
+  the new `canvas-mark` and `canvas-mark-halo` tokens, for marks over a page the product doesn't style.
+- **`Toolbar` and `ToolbarSeparator`**, new: React Aria's Toolbar, one tab stop with arrow keys between its
+  buttons, wrapping instead of overflowing. New design-system card: Toolbar.
+- **Forced colours.** A selected `Tree` or `GridList` row loses its ground and inset marker to a forced palette,
+  so it draws its marker in `Highlight` there. The drop line turns `Highlight`. The drop-target outline now draws
+  in every mode: it had a width and no style, so it never showed.
+- **A `Button` that can't act but keeps its focus** (`aria-disabled`, with the reason in its description) now
+  looks it: muted words, a muted ground for the filled variants, no hover, and the not-allowed cursor. It isn't
+  faded, so its words stay readable and its focus ring keeps its contrast.
+- **Tokens.** `canvas-mark` (the brand at its light AAA value in every theme) and `canvas-mark-halo` (white), for
+  selection and drop marks over a page. The contrast check holds them at least 9:1 apart, so one of them has
+  3:1 against any solid colour underneath. `tree-indent`.
+- **`renderIcon`** is exported: an `IconProp` (a component or an element) drawn at a size, the way the components
+  draw theirs, for an add-on's own components.
+- **`Breadcrumbs` takes `onAction`,** for places inside a page rather than pages, such as a block's parents in a
+  page builder.
+- **`ComboBox` takes `emptyState`:** what its open list says when nothing is in it, such as "Searching…" while
+  results load. It goes inside the list because React Aria hides the rest of the page from assistive technology
+  while the list is open, so a status line beside the field wouldn't be heard.
+- **A breadcrumb can carry its own language.** `BreadcrumbItem` takes `lang` and `dir`, for a label in another
+  language than the interface, such as a page's own title in a page builder (3.1.2).
+- **`setsquare-ui/client-directive` knows Puck.** A module that imports `@puckeditor/core` needs `'use client'`:
+  Puck's main entry ships without one. Its `/rsc` entry is server-safe and needs none.
+- **`setsquare-ui/no-builder-surface-override`**, a new lint rule, `warn` in `recommended`: in a file that uses
+  `@setsquare/ui-blocks` or Puck, a Puck `overrides` key that replaces one of the builder's tested surfaces.
+- **Docs.** The `GridList` README said Tab reaches a row's buttons. It's →; Tab leaves the list.
+- **Cards and tests.** The Tree card is a page outline with icons, descriptions, a status, columns and drag and
+  drop, beside operations in a `Card`. The GridList card adds a list put in order by dragging. A new `drag`
+  browser suite drives both by keyboard in all four themes, measures the drop line against `background` and
+  `card`, and checks forced colours. The controls suite's Tree checks follow the new card.
+- **`Switch` in forced colours.** Its thumb was drawn with a background, which forced colours remove, so on and off
+  looked the same. The track and thumb now take the system's colours there: Canvas and CanvasText, Highlight when
+  on.
+- **`@setsquare/ui/testing`: focus appearance and focus not obscured.**
+  - `findWeakFocusIndicators` and `expectFocusAppearance` (2.4.13): for every control a keyboard reaches, the pixels
+    whose colour changes by 3:1 or more when it takes focus, against the area of a 2 CSS px perimeter of the unfocused
+    component, 4h + 4w − (16 − 4π)r for corner radius r (W3C's formulas, read on 9 October 2026). The component is
+    the part whose outline or box shadow changes on focus, so a three-layer control is measured by its paint, not its
+    transparent target.
+  - `findObscuredFocus` and `expectFocusNotObscured` (2.4.11 at `level: 'aa'`, 2.4.12 at `'aaa'`): Tab through the
+    page and sample each focused control for anything on top of it, into same-origin frames. A visually hidden input
+    is measured by its control, and only what's in view is sampled.
+  - `ScreenshotPage.screenshot` takes `scale`, for screenshots at CSS pixels.
+
+## 0.4.0 — 2026-10-08
+
+- **`Tree`, `TreeItem`, `TreeSection` and `TreeHeader`:** React Aria's Tree, for rows inside rows, such as a
+  workflow's steps and their outcomes, or operations grouped by resource. It is one tab stop. ↑ ↓ move between
+  rows, → opens a row and ← closes it, and typing jumps to a row by name. A row's chevron has a target at least
+  `--target-min` square and is out of the tab order. Selection uses the same cues as `GridList`. The
+  `no-raw-aria-controls` and `positioned-scroll-container` lint rules cover it. New design-system card: Tree.
+- **`@setsquare/ui/testing`'s text-spacing check knows pannable panes.** `findClippedText` treats an element marked
+  `data-setsquare-pannable`, and anything inside one, as a scroller: text that spills inside it can be reached by
+  panning, the way a scroller's can by scrolling. `@setsquare/ui-flows` marks its diagrams.
+- **`findInvisibleFocus` (and `expectFocusVisible`) no longer misreport on a tall page.** Moving focus away to
+  compare could scroll the page, as React Aria does for a focused row, and take the control out of the frame, so
+  its focus looked unchanged. The probe now puts every scroll position back before it compares. The positioning
+  suite has a page built to catch it.
+- **`SidebarDisclosure`:** a sidebar row with pages under it. Expanded, it opens and closes them in place, and
+  starts open when one is current. Collapsed to icons, it opens them as a menu beside the rail, with the current
+  page selected. The Sidebar card shows both, and the controls suite checks them. The docs site uses it for
+  Add-ons.
+- **A shell shown inside a page no longer stops that page's transitions.** The site header and the dashboard's
+  header, sidebar and right panel each set a view-transition name, so a page transition leaves them still. A name
+  may be on one element only. A page showing shells inside it, such as documentation with shell previews, had
+  several, and the browser abandoned every transition to or from it ("Unexpected duplicate view-transition-name").
+  Inside a `site-preview` box, a shell now leaves the page its names. So does anything inside a box with the new
+  `shell-preview` utility, the same for a dashboard shell or a part of one. The docs site's page suite fails any
+  page that uses a name twice, and leaves its page of site previews to check that the transition runs.
+- **`edge` and `edge-selected` colour tokens,** for a diagram's connections (`@setsquare/ui-flows`). They alias
+  `input` and `brand`, and the contrast check measures both on `background` and `card` in every theme.
+
+## 0.3.0 — 2026-10-06
+
+Tagged, but never published to npm. These changes reach npm in 0.4.0.
+
+Breaking: React 19.2 or later, a new look and new defaults for `Tabs`, and new names for `Pagination`'s links.
+
+- **React 19.2 or later.** The peer range was `>=18.3`; it is now `>=19.2`, for `<Activity>`. `pnpm typecheck:react18`
+  and the React 18 copies are gone, and the browser suites run the previews on React 19. That move showed a preview
+  still passing `inert=""`, which React 19 reads as false; it is now `inert`.
+- **`Tabs` are icons, and the selected tab opens to show its name** (`display="expanding"`, the default). `Tab`
+  takes `icon`, `count` and `badge`; `display="text"` shows every name and `display="icon"` only icons, each with a
+  brand marker on the selected tab. A tab without an icon shows its name, so existing tabs still read, now as pills
+  rather than on a rule. A tab whose name isn't showing has a tooltip (hover after 500ms, keyboard focus at once,
+  Escape from anywhere). Badges are a count or a dot; `important` adds a ring and a pulse that stops within five
+  seconds; `clearOnOpen` fades them and calls `onBadgeClear`; `announceBadges` says a rise politely.
+  `orientation="vertical"` is a 104px rail that becomes a row below 480px. Panels come in from the side the
+  selection moved towards (a fade at AAA).
+- **Panels you leave are kept** (`hiddenPanels="visited"`, the default), with their state and DOM, in React's
+  `<Activity>`, which stops their effects. `all` renders every panel from the start; `unmount` is the old
+  behaviour. Code that relied on a panel remounting to reset needs `hiddenPanels="unmount"`.
+- **`Pagination` is a results footer.** It takes a Laravel `meta` (it never reads `meta.links`): Rows per page
+  (`onPerPageChange`, `perPageOptions`), the range as a status message, and the pages. Up to 20 pages it shows
+  numbers in at most seven slots and a row that never changes length; above 20 (`fieldAbove`), a "Page [n] of N"
+  GET form that keeps the query. Previous and Next are icon-only. Default names are now "Page 3 of results",
+  "Previous page of results" and "Next page of results" (`labels.noun`); a `labels.page` override still works.
+  A slow page marks the control used and says "Loading page 4…" after 400ms. `page`, `pageCount` and `href` still
+  work, for the pages alone. New utility `rows-arrive` fades a new page's rows in.
+- New design-system cards: TabsRail, TabsDisplay, TabsPanels and PaginationFooter. The contrast check now measures
+  the tab badge's text, the important badge's ring on `card`, `accent` and `brand-subtle`, and a tab's count on
+  `brand-subtle`.
+- The contact form check moves focus out of the message before sending: leaving the field clears its error, which
+  moves the Send button, and on React 19 that lands between the press and the release of a click.
+
 ## 0.2.4 — 2026-10-05
 
 - **`FeatureCard`**, for the top of an overview: a title (a greeting, often) beside an icon, and a panel of

package/NOTICE

@@ -46,4 +46,4 @@ conventions (colour token names, file layout); no shadcn/ui code is copied.
 
 The design-system artifact built by scripts/build-docs.mjs is not part of the
 package. Its bundle.js does include React Aria Components, @internationalized/date,
-lucide-react, clsx and tailwind-merge, and its previews load React 18 (MIT).
+lucide-react, clsx and tailwind-merge, and its previews load React 19 (MIT).

package/README.md

@@ -18,7 +18,7 @@ Controls are built in three layers, so the switch changes targets without changi
 pnpm add @setsquare/ui react-aria-components @internationalized/date
 ```
 
-It needs React 18.3 or later (Next.js 16 uses React 19), React Aria Components 1.21 or later, and Tailwind CSS 4 in the app. A module is a client component (`'use client'`) only when it needs to be: React Aria, a hook, a context or an event handler. The rest — `StatusBadge`, `Avatar`, `ProductMark`, `Kbd`, `EmptyState`, `IconButton`, `PageHeader`, `PageContent`, the site shell's `SiteShell`, `SiteMain`, `SiteHeader`, `SiteNav`, `SiteFooter` and `SiteFooterGroup`, the content components `Section`, `SectionHeader`, `Container`, `Eyebrow`, `Hero`, `HeroHighlight`, `Card`, `CardGrid`, `Prose`, `Steps`, `Step`, `Split`, `Tag`, `StatList` and `Stat`, `CodeBlock`, `ThemeScript`, `buttonTargetStyles()` and `buttonVisualStyles()` — have no directive, so a server component uses them without shipping them to the browser. Server components can render either kind. A server component that gives a client component an icon (`Alert`, `MenuItem`, `SidebarItem`, a search item) passes the element, `icon={<Folder />}`: a component can't cross into a client component.
+It needs React 19.2 or later, React Aria Components 1.21 or later, and Tailwind CSS 4 in the app. A module is a client component (`'use client'`) only when it needs to be: React Aria, a hook, a context or an event handler. The rest — `StatusBadge`, `Avatar`, `ProductMark`, `Kbd`, `EmptyState`, `IconButton`, `PageHeader`, `PageContent`, the site shell's `SiteShell`, `SiteMain`, `SiteHeader`, `SiteNav`, `SiteFooter` and `SiteFooterGroup`, the content components `Section`, `SectionHeader`, `Container`, `Eyebrow`, `Hero`, `HeroHighlight`, `Card`, `CardGrid`, `Prose`, `Steps`, `Step`, `Split`, `Tag`, `StatList` and `Stat`, `CodeBlock`, `ThemeScript`, `buttonTargetStyles()` and `buttonVisualStyles()` — have no directive, so a server component uses them without shipping them to the browser. Server components can render either kind. A server component that gives a client component an icon (`Alert`, `MenuItem`, `SidebarItem`, a search item) passes the element, `icon={<Folder />}`: a component can't cross into a client component.
 
 In the app's global stylesheet, after Tailwind:
 
@@ -70,6 +70,12 @@ const mono = localFont({
 import { Button, DashboardShell, ShellMain, TextField } from '@setsquare/ui';
 ```
 
+### Add-ons
+
+Diagrams of workflows and resource maps are in an add-on, [`@setsquare/ui-flows`](packages/ui-flows/README.md). It's installed on its own, so a product that doesn't draw diagrams carries none of React Flow.
+
+A page builder is in another, [`@setsquare/ui-blocks`](packages/ui-blocks/README.md), on Puck. A product that doesn't build pages carries none of Puck.
+
 ## Themes and levels
 
 - `<html data-conformance="aa|aaa" class="dark?">` picks one of four themes: Light · AA, Dark · AA, Light · AAA, Dark · AAA.
@@ -145,7 +151,7 @@ For a public page — a marketing site, a privacy notice — the stylesheet also
 ```
 
 - Layout: `site-container`, `site-container-narrow`, `section-band`, `section-band-tight`, `section-band-raised`, `section-head` and `split`.
-- Previews: `site-preview` on a box shows a site shell at the box's width instead of the window's, with no iframe. The shell's breakpoints are `site-md`, `site-lg` and `site-xl`, media queries on a real page and container queries in the box.
+- Previews: `site-preview` on a box shows a site shell at the box's width instead of the window's, with no iframe. The shell's breakpoints are `site-md`, `site-lg` and `site-xl`, media queries on a real page and container queries in the box. A shell inside a `site-preview` box, or inside one with `shell-preview` for a dashboard shell, leaves the page its view-transition names, so the page's own transitions still run.
 - Content: `eyebrow`, `site-prose`, `card-surface`, `card-grid`, `steps`, `stat-list` and `tag`.
 - Type: `text-display`, `text-display-page`, `text-display-section` and `text-lead`, fluid from a 320px viewport to 1280px. Each size has a `rem` part, so it still grows as the page zooms in.
 - Tokens: `--site-max`, `--site-max-narrow`, `--site-gutter`, `--section-y` and `--section-y-tight`, with `max-w-site` and `max-w-site-narrow`.
@@ -221,12 +227,13 @@ The components avoid it: every scroll container and every control that hides an
 
 | Rule | Reports |
 | --- | --- |
-| `setsquare-ui/no-raw-aria-controls` | Importing React Aria's `Checkbox`, `Radio`, `Switch`, `Slider`, date fields, `Calendar`, `DropZone` or `GridList` instead of the Setsquare version (and `ColorArea`, `ColorSlider`, `ColorWheel`, which have none yet). |
+| `setsquare-ui/no-raw-aria-controls` | Importing React Aria's `Checkbox`, `Radio`, `Switch`, `Slider`, date fields, `Calendar`, `DropZone`, `GridList` or `Tree` instead of the Setsquare version (and `ColorArea`, `ColorSlider`, `ColorWheel`, which have none yet). |
 | `setsquare-ui/positioned-scroll-container` | A class list with `overflow-auto` or `overflow-scroll` (any axis or variant) and no `relative`, `absolute`, `fixed` or `sticky`, in `className`, `cn()`, `clsx()`, `cva()` and similar; and inline `overflow` styles without a `position`. Fixes itself by adding `relative`. |
 | `setsquare-ui/no-static-control-root` | `static` passed in `className` to a Setsquare component whose root has to stay positioned. |
 | `setsquare-ui/no-target-shrink` | `min-h-*` or `min-w-*` in the `className` of `Button`, `LinkButton`, `IconButton` or `Segment`. `className` is the target, and these replace its `--target-min` floor. |
 | `setsquare-ui/no-visual-only-target` | `buttonVisualStyles()` in the `className` of a link or button: the paint on its own, which makes the painted box the pointer target. |
-| `setsquare-ui/client-directive` | A module without `'use client'` that needs it (it imports React Aria, calls a hook other than `use`, `useCallback`, `useDebugValue`, `useId` or `useMemo`, calls `createContext`, or passes an event handler or a function as a prop or child), and one with it that needs none of those. Not in `recommended`: turn it on for the modules of a component library, where server components import them. |
+| `setsquare-ui/no-builder-surface-override` | In a file that uses `@setsquare/ui-blocks` or Puck, a Puck `overrides` key (`actionBar`, `iframe`, `outline`, `fieldTypes` and the rest) that replaces one of the builder's own surfaces, whose tests then don't reach it. A warning in `recommended`. |
+| `setsquare-ui/client-directive` | A module without `'use client'` that needs it (it imports React Aria or Puck's editor entry, `@puckeditor/core`, calls a hook other than `use`, `useCallback`, `useDebugValue`, `useId` or `useMemo`, calls `createContext`, or passes an event handler or a function as a prop or child), and one with it that needs none of those. Not in `recommended`: turn it on for the modules of a component library, where server components import them. |
 
 ESLint (flat config, with a parser that reads TSX, such as typescript-eslint's):
 
@@ -302,10 +309,11 @@ The positioning, target, link, reflow, text-spacing and motion scans run in the
 
 `pnpm ci:local` runs all of it; each line says what it does and doesn't cover.
 
-- **Types:** `tsc` on React 19 (the build) and React 18 (`pnpm typecheck:react18`).
+- **Types:** `tsc` on React 19.
 - **Lint rules:** ESLint's `RuleTester`, and oxlint loading the built plugin through `jsPlugins`.
+- **Unit:** the pagination window: seven slots on every page of an 8-, 20- and 239-page list, and a gap only where two or more pages are left out.
 - **Contrast:** `scripts/check-contrast.mjs` computes every token pair the usage notes promise, in all four themes. It doesn't check colours a product adds.
-- **Browser (Chromium only):** the design-system previews on React 18, loaded as the design-system artifact loads them:
+- **Browser (Chromium only):** the design-system previews on React 19, loaded as the design-system artifact loads them:
   - axe-core on every preview in all four themes;
   - keyboard and focus behaviour for the dashboard shell, forms, feedback states, and the slider, date, file and selection controls;
   - the site shell: the phone menu opening, pushing the page down and closing on Escape from the panel or the button; the current page's weight and marker; one order for the header, the phone menu and the footer; a sticky header covering no focused control; and the header fitting at seven widths from 320px to 1280px, either side of `lg` among them;
@@ -318,6 +326,8 @@ The positioning, target, link, reflow, text-spacing and motion scans run in the
   - every control a keyboard reaches visibly changing when it takes focus, in two themes;
   - every link in running text underlined, and every target showing the cursor the rule gives it, across its whole area;
   - toasts measured against the focused control;
+  - tabs: the arrow keys in a row and a rail, Home and End, names with counts and badges, tooltips on hover (after 500ms, hoverable, closed by Escape and by a press) and on keyboard focus, the rail becoming a row below 480px, the three `hiddenPanels` modes (a draft surviving, a hidden panel's effects stopping, a Suspense read loading while pre-rendered), an important badge's pulse ending inside five seconds and replaying when its count rises, clear-on-open calling `onBadgeClear`, only opacity and colour changing at AAA, nothing animating under reduced motion, and no badge, ring or halo over any text in all three displays at full width and 360px;
+  - pagination: the tiers at 1, 4, 7, 8, 20, 21 and 239 pages, a row that never changes length, the names of page links and arrows, hrefs that keep the query and never use `meta.links`, rows per page keeping the first row in view, focus after paging, the page field's validation and alert, the pending mark and its message after 400ms (and the mark stopping inside five seconds), and motion at AA, AAA and under reduced motion;
   - nothing on any preview running off its width, no text cut off or spilling with WCAG 1.4.12's spacing applied, and nothing but a loading indicator moving past five seconds, at AA and AAA;
   - the page checks above, each also run on a page built to fail.
 - **Packaging:** `pnpm package:verify` packs the tarball and installs it into a new Next.js app. It builds the app, loads it in both levels, and runs the page checks and the lint plugin from the installed package. It also follows a sidebar link on the freshly started app, to check the templates' page transition runs with its `nav-forward` type. The root layout's `ThemeScript` is checked to put a stored dark theme on `<html>` before any of the page's own JavaScript runs, and the footer's `ThemeSwitcher` to change it for the next page load. A route on the site templates is checked too: the current page, reflow at 320px, the Menu as a link to the footer's navigation with JavaScript off, and the swap to the Menu button when the page hydrates, in the same place and keeping focus.
@@ -329,7 +339,7 @@ The positioning, target, link, reflow, text-spacing and motion scans run in the
 ```sh
 pnpm install
 pnpm build           # CSS from tokens/tokens.json, then tsc into dist/
-pnpm test            # lint-rule tests (vitest)
+pnpm test            # lint-rule and unit tests (vitest)
 pnpm docs:build      # the design-system artifact, into docs/.artifact/
 pnpm test:browser    # browser suites (after docs:build); pnpm test:axe for axe on every card
 pnpm docs:site       # the docs site (apps/docs) in development

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export { TextLink } from './ui/text-link.js';
 export type { TextLinkProps } from './ui/text-link.js';
 export { IconButton } from './ui/icon-button.js';
 export type { IconButtonProps } from './ui/icon-button.js';
+export { renderIcon } from './ui/icon.js';
 export type { IconComponent, IconProp } from './ui/icon.js';
 export { Tooltip, TooltipTrigger } from './ui/tooltip.js';
 export { Kbd } from './ui/kbd.js';
@@ -24,9 +25,9 @@ export { Avatar, ProductMark } from './ui/avatar.js';
 export { Breadcrumbs } from './ui/breadcrumbs.js';
 export type { BreadcrumbItem, BreadcrumbsProps } from './ui/breadcrumbs.js';
 export { Pagination } from './ui/pagination.js';
-export type { PaginationProps, PaginationLabels } from './ui/pagination.js';
+export type { PaginationProps, PaginationLabels, PaginationMeta } from './ui/pagination.js';
 export { Tabs, TabList, Tab, TabPanel } from './ui/tabs.js';
-export type { TabsProps, TabListProps, TabProps, TabPanelProps } from './ui/tabs.js';
+export type { TabsProps, TabListProps, TabProps, TabPanelProps, TabsLabels, TabsDisplay, TabsHiddenPanels, TabBadge, } from './ui/tabs.js';
 export { Menu, MenuItem, MenuSection, MenuSeparator, MenuTrigger, Popover, rowTarget, itemVisual, } from './ui/menu.js';
 export { SegmentedControl, Segment } from './ui/segmented-control.js';
 export { Table, TableHeader, Column, TableBody, Row, Cell } from './ui/table.js';
@@ -38,8 +39,8 @@ export { AppSearch, CommandSearch, SearchTrigger } from './ui/search.js';
 export type { SearchItem, SearchSection, SearchLabels } from './ui/search.js';
 export { DashboardShell, ShellInset, ShellBody, ShellMain, useShell, useOptionalShell, } from './shell/dashboard-shell.js';
 export type { ShellSize, PanelMode, DashboardShellProps } from './shell/dashboard-shell.js';
-export { Sidebar, SidebarHeader, SidebarContent, SidebarFooter, SidebarGroup, SidebarList, SidebarItem, SidebarSwitcher, SidebarTrigger, useSidebarCollapsed, } from './shell/sidebar.js';
-export type { SidebarLabels, SidebarTriggerLabels } from './shell/sidebar.js';
+export { Sidebar, SidebarHeader, SidebarContent, SidebarFooter, SidebarGroup, SidebarList, SidebarItem, SidebarDisclosure, SidebarSwitcher, SidebarTrigger, useSidebarCollapsed, } from './shell/sidebar.js';
+export type { SidebarLabels, SidebarTriggerLabels, SidebarDisclosureProps, SidebarSubItem, } from './shell/sidebar.js';
 export { AppHeader } from './shell/app-header.js';
 export { SiteShell, SiteMain } from './shell/site-shell.js';
 export type { SiteShellProps, SiteMainProps } from './shell/site-shell.js';
@@ -137,6 +138,12 @@ export { FileUpload, formatBytes } from './ui/file-upload.js';
 export type { FileUploadProps, FileUploadItem, FileUploadStatus, FileRejection, FileUploadLabels, } from './ui/file-upload.js';
 export { GridList, GridListItem } from './ui/grid-list.js';
 export type { GridListProps, GridListItemProps } from './ui/grid-list.js';
+export { Tree, TreeItem, TreeSection, TreeHeader } from './ui/tree.js';
+export type { TreeProps, TreeItemProps, TreeSectionProps } from './ui/tree.js';
+export { DropIndicator } from './ui/drop-indicator.js';
+export type { DropIndicatorProps } from './ui/drop-indicator.js';
+export { Toolbar, ToolbarSeparator } from './ui/toolbar.js';
+export type { ToolbarProps } from './ui/toolbar.js';
 export { SelectionBar } from './ui/selection-bar.js';
 export type { SelectionBarProps, SelectionBarLabels } from './ui/selection-bar.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -12,6 +12,7 @@ export { Button, LinkButton } from './ui/button.js';
 export { buttonTargetStyles, buttonVisualStyles } from './ui/button-styles.js';
 export { TextLink } from './ui/text-link.js';
 export { IconButton } from './ui/icon-button.js';
+export { renderIcon } from './ui/icon.js';
 export { Tooltip, TooltipTrigger } from './ui/tooltip.js';
 export { Kbd } from './ui/kbd.js';
 export { StatusBadge } from './ui/badge.js';
@@ -26,7 +27,7 @@ export { ScrollRegion } from './ui/scroll-region.js';
 export { Sheet } from './ui/sheet.js';
 export { AppSearch, CommandSearch, SearchTrigger } from './ui/search.js';
 export { DashboardShell, ShellInset, ShellBody, ShellMain, useShell, useOptionalShell, } from './shell/dashboard-shell.js';
-export { Sidebar, SidebarHeader, SidebarContent, SidebarFooter, SidebarGroup, SidebarList, SidebarItem, SidebarSwitcher, SidebarTrigger, useSidebarCollapsed, } from './shell/sidebar.js';
+export { Sidebar, SidebarHeader, SidebarContent, SidebarFooter, SidebarGroup, SidebarList, SidebarItem, SidebarDisclosure, SidebarSwitcher, SidebarTrigger, useSidebarCollapsed, } from './shell/sidebar.js';
 export { AppHeader } from './shell/app-header.js';
 // The site shell, for public pages. SiteShell, SiteMain, SiteHeader, SiteNav, SiteFooter and SiteFooterGroup
 // have no 'use client'; SiteMenu and SiteNavLink do.
@@ -79,5 +80,8 @@ export { Calendar, RangeCalendar } from './ui/calendar.js';
 export { DateField, TimeField, DatePicker, DateRangePicker } from './ui/date-field.js';
 export { FileUpload, formatBytes } from './ui/file-upload.js';
 export { GridList, GridListItem } from './ui/grid-list.js';
+export { Tree, TreeItem, TreeSection, TreeHeader } from './ui/tree.js';
+export { DropIndicator } from './ui/drop-indicator.js';
+export { Toolbar, ToolbarSeparator } from './ui/toolbar.js';
 export { SelectionBar } from './ui/selection-bar.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpD,yFAAyF;AACzF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAW5D,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACX,OAAO,EACP,SAAS,EACT,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEzE,OAAO,EACL,cAAc,EACd,UAAU,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,OAAO,EACP,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,6GAA6G;AAC7G,qDAAqD;AACrD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAOvB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE/E,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3F,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOhE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AASvF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQ9D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib/page-items.d.ts

@@ -0,0 +1,10 @@
+/** A slot in a pagination row: a page number, or a gap where pages are left out. */
+export type PageItem = number | 'gap-start' | 'gap-end';
+/**
+ * The pages to show around `page` of `count`: MUI's algorithm, with `boundary` pages at each end and `sibling`
+ * pages either side of the current one. Once there are more than `2 × boundary + 2 × sibling + 3` pages (7 with
+ * the defaults) the row always has that many slots: a gap stands for two or more pages left out, and where it would
+ * stand for one page, that page is shown instead. So the row never changes length as you page through.
+ */
+export declare function pageItems(page: number, count: number, boundary?: number, sibling?: number): PageItem[];
+//# sourceMappingURL=page-items.d.ts.map

package/dist/lib/page-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-items.d.ts","sourceRoot":"","sources":["../../src/lib/page-items.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,OAAO,SAAI,GAAG,QAAQ,EAAE,CAqB5F"}

package/dist/lib/page-items.js

@@ -0,0 +1,26 @@
+/**
+ * The pages to show around `page` of `count`: MUI's algorithm, with `boundary` pages at each end and `sibling`
+ * pages either side of the current one. Once there are more than `2 × boundary + 2 × sibling + 3` pages (7 with
+ * the defaults) the row always has that many slots: a gap stands for two or more pages left out, and where it would
+ * stand for one page, that page is shown instead. So the row never changes length as you page through.
+ */
+export function pageItems(page, count, boundary = 1, sibling = 1) {
+    const range = (a, b) => b < a ? [] : Array.from({ length: b - a + 1 }, (_, i) => a + i);
+    const startPages = range(1, Math.min(boundary, count));
+    const endPages = range(Math.max(count - boundary + 1, boundary + 1), count);
+    const siblingsStart = Math.max(Math.min(page - sibling, count - boundary - sibling * 2 - 1), boundary + 2);
+    const siblingsEnd = Math.min(Math.max(page + sibling, boundary + sibling * 2 + 2), endPages.length > 0 ? endPages[0] - 2 : count - 1);
+    const items = [...startPages];
+    if (siblingsStart > boundary + 2)
+        items.push('gap-start');
+    else if (boundary + 1 < count - boundary)
+        items.push(boundary + 1);
+    items.push(...range(siblingsStart, siblingsEnd));
+    if (siblingsEnd < count - boundary - 1)
+        items.push('gap-end');
+    else if (count - boundary > boundary)
+        items.push(count - boundary);
+    items.push(...endPages);
+    return items;
+}
+//# sourceMappingURL=page-items.js.map

package/dist/lib/page-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-items.js","sourceRoot":"","sources":["../../src/lib/page-items.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,QAAQ,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC;IAC9E,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CACrC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAC5D,QAAQ,GAAG,CAAC,CACb,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EACpD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CACnD,CAAC;IACF,MAAM,KAAK,GAAe,CAAC,GAAG,UAAU,CAAC,CAAC;IAC1C,IAAI,aAAa,GAAG,QAAQ,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;SACrD,IAAI,QAAQ,GAAG,CAAC,GAAG,KAAK,GAAG,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;IACjD,IAAI,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;SACzD,IAAI,KAAK,GAAG,QAAQ,GAAG,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lint/index.d.ts

@@ -12,6 +12,9 @@
  * there can shrink the target below 44px at AAA; and the painted classes on their own (Layer 2) make the paint
  * the target.
  *
+ * One more is for products that use @setsquare/ui-blocks: Puck's `overrides` can replace the builder's own
+ * surfaces, and the builder's tests don't reach what replaces them.
+ *
  * Static analysis can only see some of it. `@setsquare/ui/testing` checks the rendered page, and finds the rest.
  */
 import type { Rule } from 'eslint';
@@ -22,6 +25,7 @@ export declare const rules: {
     'no-target-shrink': Rule.RuleModule;
     'no-visual-only-target': Rule.RuleModule;
     'client-directive': Rule.RuleModule;
+    'no-builder-surface-override': Rule.RuleModule;
 };
 declare const plugin: {
     meta: {
@@ -34,6 +38,7 @@ declare const plugin: {
         'no-target-shrink': Rule.RuleModule;
         'no-visual-only-target': Rule.RuleModule;
         'client-directive': Rule.RuleModule;
+        'no-builder-surface-override': Rule.RuleModule;
     };
     configs: Record<string, unknown>;
 };

package/dist/lint/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lint/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAwoBnC,eAAO,MAAM,KAAK;IAChB,sBAAsB;IACtB,6BAA6B;IAC7B,wBAAwB;IACxB,kBAAkB;IAClB,uBAAuB;IACvB,kBAAkB;CACnB,CAAC;AAEF,QAAA,MAAM,MAAM;;QACF,IAAI;;;;;;;;;;aAEG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CACvC,CAAC;eAea,MAAM"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lint/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAstBnC,eAAO,MAAM,KAAK;IAChB,sBAAsB;IACtB,6BAA6B;IAC7B,wBAAwB;IACxB,kBAAkB;IAClB,uBAAuB;IACvB,kBAAkB;IAClB,6BAA6B;CAC9B,CAAC;AAEF,QAAA,MAAM,MAAM;;QACF,IAAI;;;;;;;;;;;aAEG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CACvC,CAAC;eAgBa,MAAM"}

package/dist/lint/index.js

@@ -19,6 +19,8 @@ const WRAPPED = {
     DropZone: 'FileUpload',
     GridList: 'GridList',
     GridListItem: 'GridListItem',
+    Tree: 'Tree',
+    TreeItem: 'TreeItem',
 };
 /** Also render hidden inputs, but have no Setsquare version yet. */
 const UNWRAPPED = ['ColorArea', 'ColorSlider', 'ColorWheel'];
@@ -41,6 +43,8 @@ const POSITIONED_ROOTS = new Set([
     'FileUpload',
     'GridList',
     'GridListItem',
+    'Tree',
+    'TreeItem',
     'Table',
     'ShellMain',
     'SidebarContent',
@@ -534,17 +538,19 @@ const noVisualOnlyTarget = {
 /** Hooks React's server build exports (react.react-server in React 19): a server component may call these. */
 const SERVER_HOOKS = new Set(['use', 'useCallback', 'useDebugValue', 'useId', 'useMemo']);
 /** Packages that only work in the client graph: React Aria's entry imports `client-only`. */
-const CLIENT_PACKAGES = /^(react-aria-components|react-aria|react-stately|@react-aria\/|@react-stately\/)/;
+// Puck's main entry ships no 'use client' of its own, so a module importing it has to carry one. Its /rsc entry
+// is the server-safe one.
+const CLIENT_PACKAGES = /^(react-aria-components|react-aria|react-stately|@react-aria\/|@react-stately\/|@puckeditor\/core$)/;
 const clientDirective = {
     meta: {
         type: 'problem',
         docs: {
-            description: "Require 'use client' exactly when a module needs it: React Aria, a hook, a context, an event handler or a function passed as a prop",
+            description: "Require 'use client' exactly when a module needs it: React Aria or Puck's editor, a hook, a context, an event handler or a function passed as a prop",
         },
         schema: [],
         messages: {
             missing: "This module {{reason}}, which only a client module can do. Add 'use client' as its first line.",
-            unneeded: "'use client' isn't needed here: nothing in this module needs the client (React Aria, a hook other than use, useCallback, useDebugValue, useId or useMemo, createContext, an event handler, or a function passed as a prop or child). Remove it, so server components can use this module without shipping it to the browser.",
+            unneeded: "'use client' isn't needed here: nothing in this module needs the client (React Aria, Puck's editor, a hook other than use, useCallback, useDebugValue, useId or useMemo, createContext, an event handler, or a function passed as a prop or child). Remove it, so server components can use this module without shipping it to the browser.",
         },
     },
     create(context) {
@@ -619,6 +625,79 @@ const clientDirective = {
         };
     },
 };
+/**
+ * The parts of Puck's editor that @setsquare/ui-blocks draws itself, as Puck's `overrides` keys. Replacing one
+ * swaps a surface the builder's tests cover for one they don't see.
+ */
+const BUILDER_SURFACES = new Set([
+    'header',
+    'headerActions',
+    'actionBar',
+    'componentOverlay',
+    'componentItem',
+    'components',
+    'drawer',
+    'drawerItem',
+    'outline',
+    'fields',
+    'fieldLabel',
+    'fieldTypes',
+    'iframe',
+    'preview',
+    'puck',
+]);
+const BUILDER_PACKAGES = /^(?:@setsquare\/ui-blocks|@puckeditor\/core)(?:\/|$)/;
+const noBuilderSurfaceOverride = {
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: "Warn when Puck's `overrides` replace a surface @setsquare/ui-blocks draws and tests: the header, library, outline, fields, canvas and their overlays",
+        },
+        schema: [],
+        messages: {
+            override: "overrides.{{key}} replaces the builder's own {{key}}, and that surface's tests (keyboard routes, focus after each change, announcements, target size) stop applying to it. Add behaviour through useBuilder() or the builder's props instead, or ask for an option.",
+        },
+    },
+    create(context) {
+        // Only files that use the builder or Puck: elsewhere an `overrides` object is someone else's.
+        let builder = false;
+        const report = (obj) => {
+            if (!builder || !obj || obj.type !== 'ObjectExpression')
+                return;
+            for (const p of obj.properties) {
+                if (p.type !== 'Property' || p.computed)
+                    continue;
+                const k = p.key;
+                const key = String(k.type === 'Identifier' ? k.name : k.value);
+                if (BUILDER_SURFACES.has(key))
+                    context.report({ node: p, messageId: 'override', data: { key } });
+            }
+        };
+        return {
+            ImportDeclaration(node) {
+                const n = node;
+                if (BUILDER_PACKAGES.test(String(n.source.value)))
+                    builder = true;
+            },
+            // A plugin, or any object, with `overrides: { … }`.
+            Property(node) {
+                const n = node;
+                const k = n.key;
+                if (!n.computed && (k.name === 'overrides' || k.value === 'overrides'))
+                    report(n.value);
+            },
+            // <Puck overrides={{ … }}>
+            JSXAttribute(node) {
+                const n = node;
+                if (n.name.name !== 'overrides')
+                    return;
+                const v = n.value;
+                if (v?.type === 'JSXExpressionContainer')
+                    report(v.expression);
+            },
+        };
+    },
+};
 export const rules = {
     'no-raw-aria-controls': noRawAriaControls,
     'positioned-scroll-container': positionedScrollContainer,
@@ -626,6 +705,7 @@ export const rules = {
     'no-target-shrink': noTargetShrink,
     'no-visual-only-target': noVisualOnlyTarget,
     'client-directive': clientDirective,
+    'no-builder-surface-override': noBuilderSurfaceOverride,
 };
 const plugin = {
     meta: { name: '@setsquare/ui/lint' },
@@ -642,6 +722,7 @@ plugin.configs.recommended = {
         'setsquare-ui/no-static-control-root': 'error',
         'setsquare-ui/no-target-shrink': 'error',
         'setsquare-ui/no-visual-only-target': 'error',
+        'setsquare-ui/no-builder-surface-override': 'warn',
     },
 };
 export default plugin;