@kerfjs/ui 5.0.0-beta.22 → 5.0.0-beta.24

package/docs/design/templates.md

@@ -10,7 +10,7 @@ component picture without running the app.
 ## Coverage
 
 Templated components (each with light + dark variants): `PanelHeader`,
-`ToolbarControlGroup`, `Toolbar`, `ToolbarText`, `ListItem`, `ListHeader`,
+`ToolbarControlGroup`, `Toolbar`, `ToolbarText`, `List`, `ListItem`, `ListHeader`,
 `ListActionRow`, `ValueTable`, `StateBanner`, `EmptyState`, `Skeleton`,
 `SegmentedControl`, `TabBar`/`AppTab`, and `TokenSearchField`.
 
@@ -27,7 +27,7 @@ catalog and the app-layouts docs cover those.
 
 ```
 docs/design/templates/
-  panel-header.svg              ← library: every variant, inlined (light)
+  panel-header.svg              ← library: every variant, composed (light)
   panel-header-dark.svg         ← library: dark theme
   panel-header/
     icon-summary-actions.svg    ← one self-contained variant (light)
@@ -50,13 +50,12 @@ docs/design/templates/
   kerf UI design font stack is system-based, so the picture matches; a viewer
   without those fonts falls back to its own.
 - The **library** files (`<component>.svg` light, `<component>-dark.svg` dark) lay
-  the variants out with captions and embed an inline **copy** of each variant as a
-  positioned nested `<svg>`. Each is fully self-contained and renders everywhere —
-  a browser, an `<img>`, GitHub, or a static rasterizer. (External
-  `<use href="…#id">` and `<image href="…">` references render blank in many SVG
-  viewers, so the library inlines copies instead. Each copy's local ids and
-  domotion font-family names are namespaced so the inlined variants don't collide
-  in the one document; the individual variant files stay individually reusable.)
+  the variants out with captions. The generator writes a temporary HTML page whose
+  `<img>` elements reference the individual variant SVGs, then captures that page
+  with domotion and `--flatten-nested-svg`. The final library is self-contained,
+  contains positioned groups rather than nested `<svg>` elements, and remains
+  reliable in design tools such as Sketch. The individual variant files stay
+  independently reusable.
 
 ## Building
 
@@ -67,6 +66,9 @@ npm run design-templates:build
 This renders each component's real `SafeHtml` (with its CSS subpaths + `foundation.css`
 tokens and representative sample data) into a standalone page and captures it with
 [`domotion-svg`](https://github.com/brianwestphal/domotion)'s `domotion capture`.
+The capture command uses `--flatten-nested-svg`, which converts safely flattenable
+inline SVGs (including component icons) to groups so design tools such as Sketch do
+not have to interpret nested `<svg>` elements.
 `domotion` must be reachable: it resolves `DOMOTION_BIN`, then a local
 `node_modules/.bin/domotion`, then a sibling `../domotion` checkout.
 
@@ -79,7 +81,9 @@ component can render with or without an icon, include both.
 `npm run check:design-templates` (part of `npm run check`) is an offline gate
 that verifies every component + variant in the manifest has its committed output —
 a light and dark SVG per variant plus the two per-component library files — and
-that no stray template files linger for a removed component. It does **not**
+that no stray template files linger for a removed component. It also rejects any
+variant or library capture that still contains nested `<svg>` elements, guarding
+the Sketch compatibility contract. It does **not**
 re-render (that needs domotion + a browser), so it catches a manifest entry whose
 templates were never generated or a half-regenerated set.
 
@@ -109,11 +113,18 @@ starting point and:
    tokens and `layout.css`), and any of your own component CSS.
 3. Enumerate the presentation combinations in the per-component manifest.
 4. Capture each variant with `domotion capture <page.html> --selector <css>
---text-mode system-font -o <variant>.svg`, once per theme with
+--text-mode system-font --flatten-nested-svg -o <variant>.svg`, once per theme with
    `--color-scheme light` / `--color-scheme dark` (if your components theme with
-   `light-dark()`), then write a light and a dark library file that each embed an
-   inline copy of every variant (namespacing each copy's ids/font-family names so
-   they don't collide) rather than referencing them, so they render everywhere.
+   `light-dark()`).
+5. Build a light and dark HTML library page that references the generated variants
+   with `<img src="./component/variant.svg">`, and capture each page with the same
+   domotion options, including `--flatten-nested-svg`. Let domotion own embedding,
+   id isolation, and flattening instead of hand-assembling SVG markup.
 
 Maintaining these next to the components — and reviewing the captured SVGs on
 every component change — keeps the design source of truth honest.
+
+ListItem templates retain the shared 18px leading icon and 44px row target;
+regenerate both themes and library sheets when that geometry changes. The browser
+pane/sidebar geometry checks cover the resulting 43px icon-label offset from the
+section edge (17px content inset + 18px icon + 8px gap).

package/docs/sunken-panel.md

@@ -14,6 +14,15 @@ import { SunkenPanel } from '@kerfjs/ui/sunken-panel';
 </SunkenPanel>;
 ```
 
+The default `shape="rounded"` uses the shared rounded-rectangle radius. Choose
+`shape="square"` for a flush or edge-to-edge area that needs `border-radius: 0`:
+
+```tsx
+<SunkenPanel shape="square">
+  <Workspace />
+</SunkenPanel>
+```
+
 ## Ownership
 
 The root owns its lowered background, 8px padding, and 8px vertical gap.
@@ -40,4 +49,5 @@ Override the public properties at the composition boundary:
 - `--kui-sunken-panel-radius`
 
 The public root class is `.kui-sunken-panel`. Prefer the properties above over
-styling descendants.
+styling descendants. The `square` shape deliberately overrides the radius
+property with zero; use `rounded` when customizing the radius token.

package/docs/type-contracts.md

@@ -23,7 +23,7 @@ public-signature artifact.
 | `KUI-T008` | `ToolbarText.maxLines` requires `wrap: true`; it is never silently ignored in typed code.                                                                                              |
 | `KUI-T009` | A literal `TabScaffold.active` id belongs to its literal `tabs`.                                                                                                                       |
 | `KUI-T010` | Adjacent-token keyboard removal requires `onRemoveToken`; disabling removal rejects the now-meaningless callback.                                                                      |
-| `KUI-T011` | Finite public variants have named exported union types, including tab activation, banner urgency, and all ToolbarControlGroup presentation axes.                                       |
+| `KUI-T011` | Finite public variants have named exported union types, including divider sides, tab activation, banner urgency, and all ToolbarControlGroup presentation axes.                        |
 
 Literal identity inference is intentionally additive for dynamic applications.
 When choices or ids arrive at runtime and the state signal is correctly typed as
@@ -48,7 +48,7 @@ ordinary source/type gates:
   `SegmentedControl`, `TokenSearchField`, `PanelHeader`, and `ValueTable`;
 - finite variants exported or represented as literal props on `DisclosureArrow`,
   `FloatingToolbar`, `Pane`, `ResizableRegion`, `SegmentedControl`, `StateBanner`,
-  `ToolbarText`, `CollapsiblePanel`, `Catalog`, and the wire helpers;
+  `SunkenPanel`, `ToolbarText`, `CollapsiblePanel`, `Catalog`, and the wire helpers;
 - required controlled-state callbacks on `wireResizableRegions`, `wireTabBars`,
   and `wireTabScaffold`;
 - mutually exclusive count/badge metadata on `ListHeader`; and
@@ -58,7 +58,7 @@ ordinary source/type gates:
 
 The remaining components (`LucideIcon`, `DisclosureArrow`, `Toolbar`,
 `ToolbarControlGroup`, `ListInsetControl`, `ListInsetText`, `LoadingSpinner`,
-`Skeleton`, `SunkenPanel`, `EmptyState`, `StateBanner`, `ValueTableRow`, and the
+`Skeleton`, `EmptyState`, `StateBanner`, `ValueTableRow`, and the
 pure helpers) have independent props with no further conditional invalid state
 that TypeScript can truthfully remove. Optional labels on decorative icons and
 unnamed non-landmark surfaces are intentional variants, not missing contracts.
@@ -94,6 +94,9 @@ move errors into casts without making the integration safer.
   wanted.
 - Remove orphaned `summaryId`, or render the matching `summary`; add
   `wrap: true` anywhere `ToolbarText.maxLines` is used.
+- Replace `Toolbar({ divider: false })` with `dividerSides: ''`; the default
+  remains a bottom divider, while canonical combinations such as `tr` and
+  `trbl` select more physical edges.
 
 JavaScript runtime behavior remains defensive for previously emitted calls, but
 new TypeScript builds report these invalid or ignored combinations.

package/docs/ui-analyzer.md

@@ -28,6 +28,11 @@ its reachable project-local styles into the report, including quoted or
 unquoted `url()` imports; external package styles remain outside the consumer
 boundary.
 
+Recursive discovery excludes generated and tool-owned trees, including any
+nested `.claude/worktrees` checkout. Those checkouts are separate repositories,
+not application source, and cannot contribute files, diagnostics, profile
+policy, or analysis inputs to the containing application.
+
 ## Diagnostics and exit behavior
 
 | Rule       | Kind   | Meaning                                                           |

package/docs/ui-doctor.md

@@ -15,7 +15,7 @@ The default terminal output is short and repair-oriented. `--format json` emits
 
 The catalog stage discovers the package-default application UI profile and workspace/root-to-leaf directory layers. It validates referenced selection/composition catalogs and, when a workspace declares `package.json#kerfComponentCatalog`, invokes the installed `create-kerf-component` catalog checker to validate metadata, source exports, schema conformance, and generated-output drift. This checker reads source text; it does not import application modules.
 
-TypeScript uses the compiler API with `noEmit`. ESLint loads the installed `eslint-plugin-kerfjs` `recommended-ui` preset (`--eslint strict-ui` opts into advisory rules as errors). Stable KUI identifiers come from the packaged `application-ui-diagnostic-ids-v1.json` registry; the doctor also reads installed ESLint message metadata for semantic conflict detection instead of duplicating rule definitions. The analyzer calls the public `@kerfjs/ui/analyzer` contract. None of these stages executes generated application code.
+TypeScript uses the compiler API with `noEmit`. ESLint loads the installed `eslint-plugin-kerfjs` `recommended-ui` preset (`--eslint strict-ui` opts into advisory rules as errors). This is deliberately an isolated Kerf lint pass rather than the consumer's complete ESLint configuration. Inline directives for consumer-owned plugins, such as `@typescript-eslint`, therefore do not produce false "rule definition not found" diagnostics; the consumer's normal ESLint command remains authoritative for those rules. Unknown `kerfjs/*` directives still fail the doctor pass. Stable KUI identifiers come from the packaged `application-ui-diagnostic-ids-v1.json` registry; the doctor also reads installed ESLint message metadata for semantic conflict detection instead of duplicating rule definitions. The analyzer calls the public `@kerfjs/ui/analyzer` contract. None of these stages executes generated application code.
 
 The browser evaluator is different: it runs the application and is disabled by default. It only runs when configuration supplies `browser.url` or the command receives `--browser-url`. Start and authorize the target application separately.
 
@@ -25,6 +25,13 @@ An unavailable or failed stage does not prevent independent stages from reportin
 
 `--full` is the default and analyzes the selected package. `--changed` reads tracked and untracked paths from Git unless one or more `--path` values are supplied. An empty changed set is a configuration error instead of a false-clean success. With `--package`, workspace-relative Git paths are converted to package-relative paths before TypeScript, ESLint, and analyzer selection; paths outside the selected package are ignored.
 
+Full traversal treats generated/tool-owned directories (`dist`, `coverage`,
+`node_modules`, `.git`, `.kerf-cache`, `kerf-ui-evidence`, and nested
+`.claude/worktrees` checkouts) as outside application source. Their files are
+excluded consistently from TypeScript, the isolated ESLint pass, analyzer
+discovery, and cache inputs, even when one lives below another application
+directory.
+
 TypeScript constructs the selected package's program so compiler options retain their real meaning, while its root inputs are narrowed to changed source files. Use `--full` for release gates.
 
 ## Configuration and suppressions

package/docs/ux-demo.md

@@ -10,7 +10,7 @@ deterministic state, and semantic layout owners from the [recipe guide](./recipe
 - The `ListActionRow` route demonstrates sibling primary/trailing native controls, independent disabled states, controlled selection, first-line leading-icon alignment for wrapped labels, and an application-owned native popover relationship without nesting controls. The `ListItem` route demonstrates the same multiline leading-icon anchor alongside its single-control navigation contract.
 - The `AppTab` route demonstrates a runtime-filtered domain metadata slot and a decorative replacement close icon without changing TabBar selection, close, reorder, or focus ownership. The `ResizableRegion` route likewise replaces only the decorative handle glyph while retaining separator semantics and shared wiring.
 - Every first-party visual component and every free Web Awesome 3.12 component has its own stable `?component=<id>` URL and focused demo. Composite header, menu, feedback, and theme scenarios remain addressable alongside their subcomponents; the root opens the first Kerf component.
-- `ai/component-catalog.json` is the canonical catalog metadata. A deterministic checked-in projection supplies the demo's unique id, category, kind (`component`, `composition`, or `recipe`), source (`kerf` or `webawesome`), name, description, recommendation, direct `uses` dependencies, existing documentation path, and demo-source path; first-party, recipe, and Web Awesome renderer maps are exhaustively typed against its generated id unions. Non-supported Web Awesome recommendations project to a visible `Discouraged` sidebar tag, with Popup as the deliberate conditional exception. Demo paths resolve to the matching `ui/ux-demo/demos/<id>.tsx` or `ui/ux-demo/recipes/*.tsx` file, or to `ui/ux-demo/webawesome-demos.tsx` for Web Awesome entries. `ui/ux-demo/main.tsx` owns only the catalog shell, shared state, routing, and interaction wiring. First-party component entries additionally derive `ui/src/<browser-subpath>.tsx` from their canonical `delivery.browserImport`.
+- `ai/component-catalog.json` is the canonical catalog metadata. A deterministic checked-in projection supplies the demo's unique id, category, kind (`component`, `composition`, or `recipe`), source (`kerf` or `webawesome`), name, description, recommendation, direct `uses` dependencies, existing documentation path, and demo-source path; first-party, recipe, and Web Awesome renderer maps are exhaustively typed against its generated id unions. Non-supported Web Awesome recommendations project to a visible `Discouraged` sidebar tag, with Popup as the deliberate conditional exception. Demo paths resolve to the matching `ui/ux-demo/demos/<id>.tsx` or `ui/ux-demo/recipes/*.tsx` file, or to `ui/ux-demo/webawesome-demos.tsx` for Web Awesome entries. `ui/ux-demo/main.tsx` owns only the catalog shell, shared state, routing, and interaction wiring. First-party component entries additionally derive `ui/src/<public-subpath>.tsx` from their canonical `delivery.browserImport` or opt-in `delivery.moduleImport`.
 - Every detail footer groups compact `Demo source` and `Guidance` actions; first-party component details also expose `Component source`. Web Awesome details say `Integration guidance` to distinguish the local integration contract from the upstream component implementation. Each button retains its repository-relative path in the DOM for verification and uses a deploy-safe absolute GitHub blob URL with a contextual new-tab name; the demo does not depend on a local source server or add a package runtime export. At phone widths, the resource group and related-component selector stack as full-width rows, with any resource overflow contained locally so labels cannot overlap the selector or widen the document.
 - The master/detail shell groups first-party routes by category with production `ListHeader` and `ListItem` components. Catalog entries can supply short reusable trailing tags; the Web Awesome projection uses them to label exactly the 15 discouraged choices. The 70 ecosystem components live in a separate `Web Awesome` disclosure with seven subgroups, so they remain discoverable without being presented as first-class `@kerfjs/ui` exports. Direct Web Awesome routes open the disclosure and reveal the selected row at wide sizes; narrow layouts keep the expanded list in document flow rather than introducing a competing nested scroller.
 - The shell itself uses `@kerfjs/ui/layout.css`: sidebars, details, previews, dialogs, and resize specimens share unpadded panes plus self-contained content items. Its sidebar identity uses the Kerf logo beside a vertically centered title, with the subtitle in its own aligned row like `PanelHeader`; the current-view heading is also a toolbar. Collapsing the catalog removes the pane completely and moves its restore action to the main toolbar's leading edge instead of leaving an icon-only rail. The selected view description remains inset below the page toolbar. The checkerboard belongs to the complete scrollable preview region rather than a nested card. A lightly separated footer keeps live status above compact source, guidance, and relationship groups. The focused `ResizableRegion` specimen stretches its surface through the available stage height and reports committed width in that shared status footer; narrow layouts retain local horizontal access when the pane is resized wider than the stage, and the split remains readable at 200% root scaling. Geometry coverage checks wide, intermediate, narrow, and 200% zoom layouts.
@@ -21,7 +21,7 @@ deterministic state, and semantic layout owners from the [recipe guide](./recipe
 - The `DisclosureArrow` route renders the production 18px root-scaled default without a catalog-only size override. Its two native buttons independently control the default right-to-down chevron and a recognizable right-facing replacement arrow with left-to-up custom directions; both use shortest-path rotation and their names stay stable while `aria-expanded` communicates state. Browser coverage verifies the custom clockwise path, pointer and native keyboard activation, focus, narrow and 200%-zoom stacking with contained labels, consumer sizing, and the independent `.5` Web Awesome glyph scale retained by Kerf `Select`.
 - A detail with relationships renders one grouped footer selector: `Uses` links to direct dependencies and `Used by` links to reverse dependents. Choosing either navigates to that component's demo. The relationship group is absent when both sets are empty; no duplicate summary is rendered.
 - Demo-only CSS supplies only the catalog shell and stages; component appearance stays in package CSS. Decorative chrome and Web Awesome controls share the same semantic system palette instead of carrying a separate demo identity.
-- Scenarios use deterministic data and cover real variants, long content, disabled state, selection, progress, feedback, overlays, media, helpers, and stateful interactions. The Web Awesome theme route remains the broad system view, while individual action, form, layout, navigation, feedback, media, and helper routes provide focused specimens; ListItem and ListHeader demonstrate typed domain metadata, protected native button/disclosure semantics, and a native popover trigger relationship without product props; PanelHeader demonstrates its plain top-toolbar identity, extra-large title, optional subtitle row, and bordered brand-filled icon group; the Select route verifies that option icons survive unrelated Kerf rerenders and selected slot content follows value changes; the Animation route exposes preset, easing, duration, playback-rate, and transport controls with live lifecycle status; observer routes provide user-driven intersection, mutation, and resize events with live results; ToolbarControlGroup exposes all eight Hot Sheet 2 variants, loads the Web Awesome registrations needed by its popup specimen, and preserves the upgraded dropdown's managed light-DOM children across Kerf rerenders; the Toolbar route composes a collapsible TokenSearchField inside a group, animates between the empty iconic and complete field states, stays open while populated, and focuses the revealed editor; SegmentedControl covers toolbar, rounded-rectangle, pill, equal-width, and disabled presentations; TokenSearchField covers editable ordered chips, pointer and keyboard removal, caret-preserving controlled deletion, editing, clearing, free text, disabled state, and fixed first-line alignment while content wraps; StateBanner exposes every built-in tone plus a scoped override; TabBar demonstrates overflow, edge autoscroll, and controlled pointer/keyboard reordering.
+- Scenarios use deterministic data and cover real variants, long content, disabled state, selection, progress, feedback, overlays, media, helpers, and stateful interactions. The Web Awesome theme route remains the broad system view, while individual action, form, layout, navigation, feedback, media, and helper routes provide focused specimens; ListItem and ListHeader demonstrate typed domain metadata, protected native button/disclosure semantics, and a native popover trigger relationship without product props; PanelHeader demonstrates its plain top-toolbar identity, extra-large title, optional subtitle row, and bordered brand-filled icon group; the Select route verifies that option icons survive unrelated Kerf rerenders and selected slot content follows value changes; the Animation route exposes preset, easing, duration, playback-rate, and transport controls with live lifecycle status; observer routes provide user-driven intersection, mutation, and resize events with live results; ToolbarControlGroup exposes all eight Hot Sheet 2 variants, loads the Web Awesome registrations needed by its popup specimen, and preserves the upgraded dropdown's managed light-DOM children across Kerf rerenders; the Toolbar route composes a collapsible TokenSearchField inside a group, animates between the empty iconic and complete field states, stays open while populated, and focuses the revealed editor; SegmentedControl covers toolbar, rounded-rectangle, pill, equal-width, and disabled presentations; TokenSearchField covers editable ordered chips, pointer and keyboard removal, caret-preserving controlled deletion, editing, clearing, free text, disabled state, and fixed first-line alignment while content wraps; StateBanner exposes every built-in tone with tone-tinted badges plus a scoped override; TabBar demonstrates overflow, edge autoscroll, and controlled pointer/keyboard reordering.
 - Recipe ownership notes are hidden by default. A page-toolbar toggle reveals them as floating warning-toned notes with a folded corner, keeping instructional copy visually distinct and removable from the specimen flow.
 - Settings exercise light/dark, increased contrast, and reduced motion without changing component code. The theme action starts from the operating system's effective color scheme, always names the appearance it will switch to, and installs an explicit light or dark override when activated; contrast and reduced motion expose their independent preferences through `aria-pressed`.
 - The footer action log is an `aria-live` region, making interactions visible to both people and browser tests.

package/docs/workbench.md

@@ -49,6 +49,19 @@ Each `WorkbenchPanel` takes `content`, an optional `collapsed`, an optional
 `--kui-workbench-rail-width` 280px, `--kui-workbench-drawer-height` 220px), and
 an optional `label`.
 
+## Public styling boundary
+
+Import `@kerfjs/ui/workbench.css` after the component subpath. Applications may
+set `--kui-workbench-rail-width` and `--kui-workbench-drawer-height` on a
+Workbench instance. The supported composition classes are `.kui-workbench`,
+`.kui-workbench__rail`, `.kui-workbench__rail--left`,
+`.kui-workbench__rail--right`, `.kui-workbench__center`,
+`.kui-workbench__main`, `.kui-workbench__drawer`, and
+`.kui-workbench__panel-content`; these exact hooks are cataloged for tools that
+must classify public application selectors. Prefer the component props and two
+size tokens before selecting internal anatomy, and do not target its data
+attributes or descendant tags as styling contracts.
+
 ## How the collapse animates
 
 Collapsing snaps the panel's flex track to zero in a single reflow (so the work

package/doctor/eslint-diagnostics.d.mts

@@ -0,0 +1,8 @@
+export interface EslintDiagnosticLike {
+  ruleId?: string | null;
+  message: string;
+}
+
+export function isForeignRuleDefinitionDiagnostic(
+  item: EslintDiagnosticLike,
+): boolean;

package/doctor/eslint-diagnostics.mjs

@@ -0,0 +1,7 @@
+export function isForeignRuleDefinitionDiagnostic(item) {
+  return (
+    typeof item.ruleId === 'string' &&
+    !item.ruleId.startsWith('kerfjs/') &&
+    item.message === `Definition for rule '${item.ruleId}' was not found.`
+  );
+}

package/doctor/index.mjs

@@ -23,6 +23,11 @@ import { createRequire } from 'node:module';
 import { loadApplicationUiProfile } from '../ai/application-ui-profile.mjs';
 import { analyzeUiProject, UI_ANALYSIS_RULES } from '../analyzer/index.mjs';
 import { evaluateUi, UI_EVALUATION_RULES } from '../evaluator/index.mjs';
+import { isForeignRuleDefinitionDiagnostic } from './eslint-diagnostics.mjs';
+import {
+  isUiTraversalExcluded,
+  UI_TRAVERSAL_ESLINT_IGNORES,
+} from '../traversal-exclusions.mjs';
 
 export const UI_DOCTOR_SCHEMA_VERSION = 1;
 export const UI_DOCTOR_EXIT = Object.freeze({
@@ -54,14 +59,6 @@ const sourceExtensions = new Set([
   '.cts',
   '.css',
 ]);
-const ignoredDirectories = new Set([
-  '.git',
-  '.kerf-cache',
-  'coverage',
-  'dist',
-  'kerf-ui-evidence',
-  'node_modules',
-]);
 const defaultStages = Object.freeze({
   catalog: true,
   typescript: true,
@@ -361,6 +358,7 @@ export async function resolveUiDoctorPackage(root, selector) {
 async function collectInputs(root, paths) {
   const result = [];
   const visit = async (path) => {
+    if (isUiTraversalExcluded(root, path)) return;
     let details;
     try {
       details = await stat(path);
@@ -381,7 +379,6 @@ async function collectInputs(root, paths) {
       return;
     }
     for (const entry of await readdir(path, { withFileTypes: true })) {
-      if (entry.isDirectory() && ignoredDirectories.has(entry.name)) continue;
       await visit(resolve(path, entry.name));
     }
   };
@@ -777,6 +774,9 @@ async function runTypeScript({ packageRoot, paths }) {
     { ...ts.default.sys, onUnRecoverableConfigFileDiagnostic: () => {} },
   );
   if (!parsed) throw new Error('TypeScript could not parse tsconfig.json.');
+  parsed.fileNames = parsed.fileNames.filter(
+    (file) => !isUiTraversalExcluded(packageRoot, file),
+  );
   if (paths?.length) {
     const selected = new Set(paths.map((path) => resolve(packageRoot, path)));
     parsed.fileNames = parsed.fileNames.filter((file) => selected.has(file));
@@ -850,7 +850,7 @@ async function runEslint({
       },
     },
   };
-  const configs = [base];
+  const configs = [{ ignores: UI_TRAVERSAL_ESLINT_IGNORES }, base];
   if (usesTypeScript) {
     const parserModule = await importFrom(
       packageRoot,
@@ -879,6 +879,7 @@ async function runEslint({
   const diagnostics = [];
   for (const result of results)
     for (const item of result.messages) {
+      if (isForeignRuleDefinitionDiagnostic(item)) continue;
       const code = item.message.match(/\bKUI-[A-Z]\d{3}\b/)?.[0];
       diagnostics.push(
         normalizedDiagnostic({

package/llms.txt

@@ -52,7 +52,9 @@ maintain a central style list. Configure JSX with `"jsxImportSource": "kerfjs"`.
 6. **Before calling an integration complete**, run
    [`kerf-ui-doctor`](./docs/ui-doctor.md). Its portable JSON report merges
    profile/catalog, TypeScript, Kerf ESLint, and static analyzer diagnostics;
-   repair source-located errors until exit 0. Use full mode for release gates.
+   repair source-located errors until exit 0. Use full mode for release gates;
+   generated `dist`/`coverage`, dependency, cache, evidence, and nested-worktree
+   directories are excluded consistently from every static stage.
    [`kerf-ui-analyze`](./docs/ui-analyzer.md) remains available when only static
    layout diagnostics are wanted; its review findings are a bounded human/AI
    review queue rather than an objective aesthetic score.
@@ -76,6 +78,10 @@ maintain a central style list. Configure JSX with `"jsxImportSource": "kerfjs"`.
   own the geometry (8px inline margin + 1px border + 8px padding). Do not add a
   container padding on top of a content-item's own margin — pick one owner. Use
   `.kui-content` for 24px major vertical rhythm.
+- **Use `List` for vertical layout.** It supplies a stretch-aligned column plus
+  optional standard/custom `gap`, `flex`, vertical scrolling, and canonical
+  `dividerSides` (`t`/`r`/`b`/`l` order). It adds no list semantics; children own
+  those, and only one bounded region should own scrolling.
 - **Keep Web Awesome on the shared inset tiers.** `webawesome.css` uses
   `--kui-wa-control-inset` (8px controls/items) and
   `--kui-wa-surface-margin` / `--kui-wa-surface-inset` (8px around/inside
@@ -127,9 +133,11 @@ maintain a central style list. Configure JSX with `"jsxImportSource": "kerfjs"`.
   navigation stacks, tab selection and order, pane sizes, and `collapsed`/`expanded`
   disclosure flags in the app — they are data or persisted layout, and the app reads
   them to render. The `wire…` helpers own the _ephemeral_ parts: `wireNavStack` the
-  push/pop animation, `wireTabBars` the overflow autoscroll and drag preview,
+  push/pop animation, `wireTabBars` the overflow autoscroll, drag preview, and
+  replacement focus after controlled automatic tab activation,
   `wireResizableRegions` the live drag preview; they report committed changes via
-  callbacks. The one richer case is `wireTokenSearchFields`, which manages the
+  callbacks. Managed TokenSearchField clear also preserves open state and replacement
+  editor focus for continued typing. The one richer case is `wireTokenSearchFields`, which manages the
   collapsible field's expand/collapse/focus by default (on, per-behavior opt-out) and
   exposes the `expanded` signal on its handle — bind it in render or hand in your own
   via `collapsible.signals`. Do not hand-roll open/collapse/focus that helper
@@ -150,6 +158,10 @@ maintain a central style list. Configure JSX with `"jsxImportSource": "kerfjs"`.
   markup. Use the standalone `Skeleton` for a custom slot. Prefer it over `wa-skeleton`
   (the pure-Kerf primitives avoid Web Awesome), and never animate it — use
   `LoadingSpinner` for known busy activity instead.
+- **Use a StateBanner badge only for compact supporting status.** Pass the
+  optional string `badge` for a terse count or status beside the title. It
+  inherits the banner tone and is announced with the banner, so keep its text
+  meaningful and never rely on color alone.
 
 ## Public exports
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kerfjs/ui",
-  "version": "5.0.0-beta.22",
+  "version": "5.0.0-beta.24",
   "description": "Accessible, composable UI primitives for kerf applications.",
   "type": "module",
   "license": "MIT",
@@ -74,6 +74,11 @@
       "browser": "./dist/browser/toolbar-text.js",
       "import": "./dist/toolbar-text.js"
     },
+    "./list": {
+      "types": "./dist/list.d.ts",
+      "browser": "./dist/browser/list.js",
+      "import": "./dist/list.js"
+    },
     "./list-action-row": {
       "types": "./dist/list-action-row.d.ts",
       "browser": "./dist/browser/list-action-row.js",
@@ -267,6 +272,7 @@
     "./toolbar-control-group.css": "./dist/styles/toolbar-control-group.css",
     "./floating-toolbar.css": "./dist/styles/floating-toolbar.css",
     "./toolbar-text.css": "./dist/styles/toolbar-text.css",
+    "./list.css": "./dist/styles/list.css",
     "./list-action-row.css": "./dist/styles/list-action-row.css",
     "./list-item.css": "./dist/styles/list-item.css",
     "./list-header.css": "./dist/styles/list-header.css",
@@ -301,6 +307,7 @@
     "analyzer",
     "doctor",
     "evaluator",
+    "traversal-exclusions.mjs",
     "docs",
     "ux-demo/recipes",
     "llms.txt",
@@ -376,7 +383,7 @@
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.65.0",
     "@vitest/coverage-v8": "4.1.11",
-    "domotion-svg": "^0.29.0",
+    "domotion-svg": "^0.30.1",
     "esbuild": "^0.25.0",
     "eslint": "^10.8.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",

package/traversal-exclusions.mjs

@@ -0,0 +1,27 @@
+import { relative, sep } from 'node:path';
+
+export const UI_TRAVERSAL_IGNORED_DIRECTORY_NAMES = Object.freeze([
+  '.git',
+  '.kerf-cache',
+  'coverage',
+  'dist',
+  'kerf-ui-evidence',
+  'node_modules',
+]);
+const ignoredDirectoryNames = new Set(UI_TRAVERSAL_IGNORED_DIRECTORY_NAMES);
+
+export const UI_TRAVERSAL_ESLINT_IGNORES = Object.freeze([
+  ...UI_TRAVERSAL_IGNORED_DIRECTORY_NAMES.map((name) => `**/${name}/**`),
+  '**/.claude/worktrees/**',
+]);
+
+export function isUiTraversalExcluded(root, candidate) {
+  const segments = relative(root, candidate).split(sep);
+  return (
+    segments.some((segment) => ignoredDirectoryNames.has(segment)) ||
+    segments.some(
+      (segment, index) =>
+        segment === '.claude' && segments[index + 1] === 'worktrees',
+    )
+  );
+}

package/ux-demo/recipes/collapsible-sidebar.tsx

@@ -160,7 +160,7 @@ export const createRecipe: RecipeFactory = (announce) => {
       >
         <Toolbar
           label="Activity"
-          divider
+          dividerSides="b"
           leading={
             <ToolbarControlGroup appearance="borderless" single>
               <ToolbarText text="Activity" size="small" />

package/ux-demo/recipes/navigation-sidebar.tsx

@@ -92,7 +92,7 @@ export const createRecipe: RecipeFactory = (announce) => {
       <footer class="recipe-sidebar__footer kui-pane__footer">
         <Toolbar
           label="Sidebar actions"
-          divider={false}
+          dividerSides=""
           leading={
             <ToolbarControlGroup appearance="borderless" single>
               <button

package/dist/chunk-7L6EHUMV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/toolbar.tsx"],"names":[],"mappings":";;;AAWO,SAAS,OAAA,CAAQ;AAAA,EACtB,OAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA,GAAU,IAAA;AAAA,EACV,SAAA,GAAY;AACd,CAAA,EAAiB;AACf,EAAA,uBACE,IAAA;AAAA,IAAC,QAAA;AAAA,IAAA;AAAA,MACC,KAAA,EAAO,CAAA,YAAA,EAAe,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AAAA,MACvC,gBAAA,EAAe,SAAA;AAAA,MACf,cAAA,EAAc,OAAO,OAAO,CAAA;AAAA,MAC5B,iBAAA,EAAiB,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAC,CAAA;AAAA,MACvC,YAAA,EAAY,KAAA;AAAA,MAEZ,QAAA,EAAA;AAAA,wBAAA,GAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,sBAAA,EAAwB,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,wBAC3C,GAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,qBAAA,EAAuB,QAAA,EAAA,MAAA,EAAO,CAAA;AAAA,wBACzC,GAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAM,uBAAA,EAAyB,QAAA,EAAA,QAAA,EAAS;AAAA;AAAA;AAAA,GAC/C;AAEJ","file":"chunk-7L6EHUMV.js","sourcesContent":["import type { SafeHtml } from 'kerfjs';\n\nexport interface ToolbarProps {\n  leading?: SafeHtml;\n  center?: SafeHtml;\n  trailing?: SafeHtml;\n  label?: string;\n  divider?: boolean;\n  className?: string;\n}\n\nexport function Toolbar({\n  leading,\n  center,\n  trailing,\n  label,\n  divider = true,\n  className = '',\n}: ToolbarProps) {\n  return (\n    <header\n      class={`kui-toolbar ${className}`.trim()}\n      data-component=\"toolbar\"\n      data-divider={String(divider)}\n      data-has-center={String(Boolean(center))}\n      aria-label={label}\n    >\n      <div class=\"kui-toolbar__leading\">{leading}</div>\n      <div class=\"kui-toolbar__center\">{center}</div>\n      <div class=\"kui-toolbar__trailing\">{trailing}</div>\n    </header>\n  );\n}\n"]}

package/dist/chunk-AASLYRGE.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/wire-tab-bars.ts"],"names":[],"mappings":"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","file":"chunk-AASLYRGE.js","sourcesContent":["import type { TabActivation } from './tab-bar.js';\n\nexport type TabReorderSource = 'pointer' | 'keyboard';\nexport type TabDropPosition = 'before' | 'after';\n\nexport interface TabReorder {\n  barId: string;\n  sourceId: string;\n  targetId: string;\n  position: TabDropPosition;\n  source: TabReorderSource;\n}\n\nexport type { TabActivation } from './tab-bar.js';\n\nexport interface WireTabBarsOptions {\n  onReorder: (change: TabReorder) => void;\n  /**\n   * How arrow / Home / End keys activate tabs (default `'automatic'`):\n   * - `'automatic'` moves roving focus **and** selects the focused tab (clicks it).\n   * - `'manual'` moves roving focus only; the user selects with Enter / Space / click\n   *   (the ARIA Tabs manual-activation pattern). Use this when activation is a heavy or\n   *   side-effecting action (e.g. a tab that loads a project) so arrowing through the\n   *   strip doesn't trigger it on every tab.\n   *\n   * A per-bar `data-tab-activation=\"manual\" | \"automatic\"` attribute (see the `TabBar`\n   * `activation` prop) overrides this option for that strip.\n   */\n  activation?: TabActivation;\n}\n\ntype TabRoot = HTMLElement;\ntype TabBarRoot = HTMLElement;\n\nconst AUTO_SCROLL_EDGE_PX = 56;\nconst AUTO_SCROLL_MIN_PX_PER_SECOND = 180;\nconst AUTO_SCROLL_MAX_PX_PER_SECOND = 900;\n\nexport function reorderTabs<T>(\n  items: readonly T[],\n  getId: (item: T) => string,\n  sourceId: string,\n  targetId: string,\n  position: TabDropPosition,\n): T[] {\n  if (sourceId === targetId) return [...items];\n  const source = items.find((item) => getId(item) === sourceId);\n  if (!source || !items.some((item) => getId(item) === targetId))\n    return [...items];\n  const remaining = items.filter((item) => getId(item) !== sourceId);\n  const targetIndex = remaining.findIndex((item) => getId(item) === targetId);\n  remaining.splice(targetIndex + (position === 'after' ? 1 : 0), 0, source);\n  return remaining;\n}\n\nfunction tabRoot(target: EventTarget | null): TabRoot | undefined {\n  return target instanceof Element\n    ? (target.closest<TabRoot>('[data-component=\"app-tab\"]') ?? undefined)\n    : undefined;\n}\n\nfunction tabBar(tab: TabRoot): TabBarRoot | undefined {\n  return tab.closest<TabBarRoot>('[data-component=\"tab-bar\"]') ?? undefined;\n}\n\nfunction tabId(tab: TabRoot): string | undefined {\n  return tab.dataset.tabId || undefined;\n}\n\nfunction barId(bar: TabBarRoot): string | undefined {\n  return bar.dataset.tabBarId || undefined;\n}\n\nfunction positionFor(event: DragEvent, tab: TabRoot): TabDropPosition {\n  const bounds = tab.getBoundingClientRect();\n  return event.clientX < bounds.left + bounds.width / 2 ? 'before' : 'after';\n}\n\nfunction tabsIn(bar: TabBarRoot): HTMLButtonElement[] {\n  return [\n    ...bar.querySelectorAll<HTMLButtonElement>(\n      '[data-kui-tab-list] [role=\"tab\"]',\n    ),\n  ];\n}\n\nfunction reveal(tab: HTMLElement | null | undefined): void {\n  tab?.scrollIntoView({ block: 'nearest', inline: 'nearest' });\n}\n\n/** Wire reordering and keyboard navigation while leaving controlled state in the application. */\nexport function wireTabBars(\n  root: HTMLElement | Document,\n  { onReorder, activation = 'automatic' }: WireTabBarsOptions,\n): () => void {\n  const ownerDocument = (\n    root.nodeType === 9 ? (root as Document) : root.ownerDocument\n  )!;\n  const view = ownerDocument.defaultView!;\n  let autoScroll:\n    | {\n        strip: HTMLElement;\n        velocity: number;\n        frame: number | undefined;\n        previousTime: number | undefined;\n      }\n    | undefined;\n  const stopAutoScroll = () => {\n    if (!autoScroll) return;\n    if (autoScroll.frame !== undefined)\n      view.cancelAnimationFrame(autoScroll.frame);\n    delete autoScroll.strip.dataset.tabAutoscroll;\n    autoScroll = undefined;\n  };\n  const runAutoScroll = (time: number) => {\n    const current = autoScroll;\n    if (!current) return;\n    current.frame = undefined;\n    const elapsed =\n      current.previousTime === undefined\n        ? 1000 / 60\n        : Math.min(40, Math.max(1, time - current.previousTime));\n    current.previousTime = time;\n    const maximum = Math.max(\n      0,\n      current.strip.scrollWidth - current.strip.clientWidth,\n    );\n    const previous = current.strip.scrollLeft;\n    current.strip.scrollLeft = Math.max(\n      0,\n      Math.min(maximum, previous + (current.velocity * elapsed) / 1000),\n    );\n    if (current.strip.scrollLeft === previous) {\n      stopAutoScroll();\n      return;\n    }\n    current.frame = view.requestAnimationFrame(runAutoScroll);\n  };\n  const updateAutoScroll = (event: DragEvent, strip: HTMLElement) => {\n    if (strip.scrollWidth <= strip.clientWidth) {\n      stopAutoScroll();\n      return;\n    }\n    const bounds = strip.getBoundingClientRect();\n    const edge = Math.min(AUTO_SCROLL_EDGE_PX, bounds.width / 3);\n    const startDistance = event.clientX - bounds.left;\n    const endDistance = bounds.right - event.clientX;\n    let direction = 0;\n    let strength = 0;\n    if (startDistance >= 0 && startDistance < edge) {\n      direction = -1;\n      strength = 1 - startDistance / edge;\n    } else if (endDistance >= 0 && endDistance < edge) {\n      direction = 1;\n      strength = 1 - endDistance / edge;\n    }\n    if (direction === 0) {\n      stopAutoScroll();\n      return;\n    }\n    const maximum = Math.max(0, strip.scrollWidth - strip.clientWidth);\n    if (\n      (direction < 0 && strip.scrollLeft <= 0) ||\n      (direction > 0 && strip.scrollLeft >= maximum)\n    ) {\n      stopAutoScroll();\n      return;\n    }\n    const speed =\n      AUTO_SCROLL_MIN_PX_PER_SECOND +\n      (AUTO_SCROLL_MAX_PX_PER_SECOND - AUTO_SCROLL_MIN_PX_PER_SECOND) *\n        strength *\n        strength;\n    if (autoScroll?.strip !== strip) stopAutoScroll();\n    autoScroll ??= {\n      strip,\n      velocity: 0,\n      frame: undefined,\n      previousTime: undefined,\n    };\n    autoScroll.velocity = direction * speed;\n    strip.dataset.tabAutoscroll = direction < 0 ? 'start' : 'end';\n    autoScroll.frame ??= view.requestAnimationFrame(runAutoScroll);\n  };\n  let dragged: { barId: string; tabId: string } | undefined;\n  const clearDropPositions = () =>\n    root\n      .querySelectorAll<HTMLElement>('[data-tab-drop-position]')\n      .forEach((tab) => delete tab.dataset.tabDropPosition);\n  const clear = () => {\n    stopAutoScroll();\n    dragged = undefined;\n    root\n      .querySelectorAll<HTMLElement>(\n        '[data-tab-dragging], [data-tab-drop-position]',\n      )\n      .forEach((tab) => {\n        delete tab.dataset.tabDragging;\n        delete tab.dataset.tabDropPosition;\n      });\n  };\n  const afterControlledRender = (sourceBarId: string, sourceTabId: string) =>\n    globalThis.queueMicrotask(() => {\n      const tab = [\n        ...root.querySelectorAll<TabRoot>('[data-component=\"app-tab\"]'),\n      ].find((candidate) => {\n        const candidateBar = tabBar(candidate);\n        return (\n          tabId(candidate) === sourceTabId &&\n          candidateBar !== undefined &&\n          barId(candidateBar) === sourceBarId\n        );\n      });\n      const button = tab?.querySelector<HTMLButtonElement>('[role=\"tab\"]');\n      button?.focus();\n      reveal(button);\n    });\n\n  const onDragStart = (event: Event) => {\n    const dragEvent = event as DragEvent;\n    const tab = tabRoot(event.target);\n    const bar = tab && tabBar(tab);\n    const sourceId = tab && tabId(tab);\n    const sourceBarId = bar && barId(bar);\n    if (\n      !tab ||\n      tab.getAttribute('draggable') !== 'true' ||\n      !sourceId ||\n      !sourceBarId\n    )\n      return;\n    dragged = { barId: sourceBarId, tabId: sourceId };\n    tab.dataset.tabDragging = 'true';\n    if (dragEvent.dataTransfer) {\n      dragEvent.dataTransfer.effectAllowed = 'move';\n      dragEvent.dataTransfer.setData(\n        'application/x-kerf-tab',\n        `${sourceBarId}:${sourceId}`,\n      );\n    }\n  };\n  const onDragOver = (event: Event) => {\n    const dragEvent = event as DragEvent;\n    const tab = tabRoot(event.target);\n    const bar =\n      event.target instanceof Element\n        ? (event.target.closest<TabBarRoot>('[data-component=\"tab-bar\"]') ??\n          undefined)\n        : undefined;\n    const targetId = tab && tabId(tab);\n    const targetBarId = bar && barId(bar);\n    if (!dragged || !bar || targetBarId !== dragged.barId) {\n      stopAutoScroll();\n      clearDropPositions();\n      return;\n    }\n    dragEvent.preventDefault();\n    const strip = bar.querySelector<HTMLElement>('[data-kui-tab-list]');\n    if (strip) updateAutoScroll(dragEvent, strip);\n    else stopAutoScroll();\n    clearDropPositions();\n    if (!tab || !targetId || targetId === dragged.tabId) return;\n    tab.dataset.tabDropPosition = positionFor(dragEvent, tab);\n    if (dragEvent.dataTransfer) dragEvent.dataTransfer.dropEffect = 'move';\n  };\n  const onDrop = (event: Event) => {\n    const dragEvent = event as DragEvent;\n    const tab = tabRoot(event.target);\n    const bar = tab && tabBar(tab);\n    const targetId = tab && tabId(tab);\n    const targetBarId = bar && barId(bar);\n    if (\n      !dragged ||\n      !tab ||\n      !targetId ||\n      targetId === dragged.tabId ||\n      targetBarId !== dragged.barId\n    ) {\n      clear();\n      return;\n    }\n    dragEvent.preventDefault();\n    const change: TabReorder = {\n      barId: dragged.barId,\n      sourceId: dragged.tabId,\n      targetId,\n      position: positionFor(dragEvent, tab),\n      source: 'pointer',\n    };\n    clear();\n    onReorder(change);\n    afterControlledRender(change.barId, change.sourceId);\n  };\n  const onKeyDown = (event: Event) => {\n    const keyboardEvent = event as KeyboardEvent;\n    const button =\n      event.target instanceof Element\n        ? event.target.closest<HTMLButtonElement>('[role=\"tab\"]')\n        : null;\n    const tab = button && tabRoot(button);\n    const bar = tab && tabBar(tab);\n    if (!button || !tab || !bar) return;\n    if (keyboardEvent.key === 'Delete' || keyboardEvent.key === 'Backspace') {\n      const close = tab.querySelector<HTMLButtonElement>('.kui-app-tab__close');\n      if (!close) return;\n      keyboardEvent.preventDefault();\n      close.click();\n      return;\n    }\n    const tabs = tabsIn(bar);\n    const current = tabs.indexOf(button);\n    if (current < 0) return;\n    if (\n      keyboardEvent.altKey &&\n      keyboardEvent.shiftKey &&\n      (keyboardEvent.key === 'ArrowLeft' || keyboardEvent.key === 'ArrowRight')\n    ) {\n      const target =\n        tabs[current + (keyboardEvent.key === 'ArrowLeft' ? -1 : 1)];\n      const sourceId = tabId(tab);\n      const targetRoot = target && tabRoot(target);\n      const targetId = targetRoot && tabId(targetRoot);\n      const sourceBarId = barId(bar);\n      if (\n        !target ||\n        !sourceId ||\n        !targetId ||\n        !sourceBarId ||\n        tab.getAttribute('draggable') !== 'true'\n      )\n        return;\n      keyboardEvent.preventDefault();\n      onReorder({\n        barId: sourceBarId,\n        sourceId,\n        targetId,\n        position: keyboardEvent.key === 'ArrowLeft' ? 'before' : 'after',\n        source: 'keyboard',\n      });\n      afterControlledRender(sourceBarId, sourceId);\n      return;\n    }\n    let next: number | undefined;\n    if (keyboardEvent.key === 'ArrowRight') next = (current + 1) % tabs.length;\n    else if (keyboardEvent.key === 'ArrowLeft')\n      next = (current - 1 + tabs.length) % tabs.length;\n    else if (keyboardEvent.key === 'Home') next = 0;\n    else if (keyboardEvent.key === 'End') next = tabs.length - 1;\n    if (next === undefined) return;\n    keyboardEvent.preventDefault();\n    // A per-bar data-tab-activation attribute overrides the wireTabBars option.\n    const perBar = bar.dataset.tabActivation;\n    const mode: TabActivation =\n      perBar === 'manual' || perBar === 'automatic' ? perBar : activation;\n    tabs[next]?.focus();\n    // Manual activation moves roving focus only; the user selects with Enter / Space\n    // (native on the tab <button>) or click. Automatic also selects the focused tab.\n    if (mode === 'automatic') tabs[next]?.click();\n    reveal(tabs[next]);\n  };\n  const onFocusIn = (event: Event) => {\n    const tab =\n      event.target instanceof HTMLElement &&\n      event.target.matches('[role=\"tab\"]')\n        ? event.target\n        : undefined;\n    reveal(tab);\n  };\n\n  root.addEventListener('dragstart', onDragStart);\n  root.addEventListener('dragover', onDragOver);\n  root.addEventListener('drop', onDrop);\n  root.addEventListener('dragend', clear);\n  root.addEventListener('keydown', onKeyDown);\n  root.addEventListener('focusin', onFocusIn);\n  root\n    .querySelectorAll<HTMLElement>(\n      '[data-kui-tab-list] [role=\"tab\"][aria-selected=\"true\"]',\n    )\n    .forEach(reveal);\n\n  return () => {\n    clear();\n    root.removeEventListener('dragstart', onDragStart);\n    root.removeEventListener('dragover', onDragOver);\n    root.removeEventListener('drop', onDrop);\n    root.removeEventListener('dragend', clear);\n    root.removeEventListener('keydown', onKeyDown);\n    root.removeEventListener('focusin', onFocusIn);\n  };\n}\n"]}