@exxatdesignux/ui 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.5.4
+
+### Patch Changes
+
+- **Remove Vaul `Drawer` primitive** — side panels use **`Sheet`** only (`ExportDrawer`, `TablePropertiesDrawer`, invite/folder sheets). **`vaul`** dropped from package dependencies; consumers should remove it from their app and delete any `components/ui/drawer.tsx` shim.
+- **New consumer agent rules (vendored via `sync-extras`):** `exxat-no-vaul`, `exxat-tabs-chrome` (no full-width tab stretch), `exxat-page-header-actions`, `exxat-table-row-preview` (HoverCard + DS cells).
+- **`consumer-upgrade-checklist.md`** — Prism-style audit table (tabs, header buttons, popovers, hub views).
+- **Docs:** sheet-panel vs dialog pattern; landing page start-fresh three-step commands at `@0.5.3+`.
+
+## 0.5.3
+
+### Patch Changes
+
+- **List hubs default to seven connected views.** `FULL_HUB_SUPPORTED_VIEWS` (table, list, board, dashboard, folder, panel, tree-panel) is exported from `lib/data-list-view-registry` and used as the default `supportedViewTypes` on `HubTable` and `ListPageTemplate`. `PRIMARY_HUB_SUPPORTED_VIEWS` remains for documented four-view exceptions.
+- **`prepare` builds `dist/` when missing** (`scripts/ensure-dist.mjs`) so fresh installs resolve `@exxatdesignux/ui` subpath imports without a manual build step.
+- **`nav-active` helpers** (`lib/nav-active.ts`) for single-active sidebar / secondary nav links.
+- **Vendored agent docs:** `exxat-hub-supported-views.mdc` and `hub-supported-views-pattern.md` in `consumer-extras` so npm consumers get Add view parity guardrails.
+
 ## 0.5.2
 
 ### Patch Changes

package/README.md

@@ -89,7 +89,7 @@ code are never touched.
 ## What's inside
 
 - **Primitives** (`@exxatdesignux/ui/components/<name>`) — Button, Input,
-  Select, Dialog, AlertDialog, Sheet, Drawer, Popover, DropdownMenu,
+  Select, Dialog, AlertDialog, Sheet, Popover, DropdownMenu,
   ContextMenu, Tabs, Accordion, Tooltip, Toast-free Banner, ScrollArea,
   Slider, HoverCard, Avatar, Badge, StatusBadge, Calendar, Kbd, …
 - **Hub stack** — `DataTable<TRow>`, `useTableState<TRow>`,

package/consumer-extras/cursor-rules/exxat-accessibility.mdc

@@ -17,7 +17,7 @@ alwaysApply: true
 4. **Touch targets (2.5.8):** interactive controls **≥ 24×24 CSS px** or **24px** spacing so hit areas do not overlap — use **`min-h-6 min-w-6` / `size-6`** for icon-only targets; avoid **`size-4`** as the sole target.
 5. **Contrast:** normal text **≥ 4.5:1**; UI components / focus where required **≥ 3:1**; muted text on tinted surfaces use tokens against the correct surface (e.g. sidebar), not only `--background`.
 6. **Minimum text size:** visible product copy **≥ 11px** — use **`text-xs`** or larger; **MUST NOT** use arbitrary Tailwind font sizes below that (see **`apps/web/AGENTS.md` §8.3**, **`apps/web/app/globals.css`** `--text-xs`).
-7. **Dialogs / sheets / drawers:** must expose a **Title** (`DialogTitle` / `SheetTitle` / `DrawerTitle`); use **`sr-only`** if visually hidden (shadcn pattern).
+7. **Dialogs / sheets:** must expose a **Title** (`DialogTitle` / `SheetTitle`); use **`sr-only`** if visually hidden (shadcn pattern).
 8. **Format hints are persistent, not placeholders (SC 3.3.2 Labels or Instructions, 1.3.1).** Any field that expects a specific format — **date, time, phone, currency, ID pattern, GPA scale, URL, hours, unit-bearing numbers** — MUST show the format as **persistent helper text** via **`FormDescription`** (or the field's description slot). Placeholders disappear on focus and are unreliable for AT, so **MUST NOT** be the sole carrier of the format. Example: GPA → "Out of 4.0"; Date → "MM/DD/YYYY"; Phone → "+1 (555) 555-0100"; Student ID → "STU-YYYY-####". Pair with `inputMode`, `pattern`, or a picker primitive (e.g. `DatePickerField`) where applicable; never rely on a free-text date input.
 9. **Every icon that communicates information MUST have a text alternative** — not just icon-only buttons. Three cases (SC 1.1.1 Non-text Content, 3.3.2 Labels or Instructions, 2.4.6 Headings and Labels):
 

package/consumer-extras/cursor-rules/exxat-data-tables.mdc

@@ -7,7 +7,7 @@ alwaysApply: true
 
 ## Use one stack for product data lists
 
-For **any app screen that shows a browsable, filterable grid of records** (lists, directories, placements, tokens, columns showcase, etc.):
+For **any app screen that shows a browsable, filterable grid of records** (directories, tokens, columns showcase, question banks, etc.):
 
 1. **Inside `ListPageTemplate` (every primary hub + every showcase page that mounts a hub-style grid) MUST use `HubTable`** from `@/components/data-views`. `HubTable` is the **canonical** wrapper that wires `useTableState`, the toolbar (**search + filter chips + filter dropdown + sort**), the **Table properties drawer**, view-type tiles, bulk-actions, and conditional rules in one place. Pages that drop down to raw `<DataTable>` silently lose filters and Properties — **MUST NOT** ship a hub or showcase that way.
 2. **Outside `ListPageTemplate`** (rare — e.g. embedded mini-grids, modal sub-tables, drawer body lists), use `DataTable` from `@/components/data-table` directly. Even then, prefer composing a small `toolbarSlot` with `TablePropertiesDrawerButton` whenever the grid is more than a handful of rows.
@@ -17,14 +17,13 @@ For **any app screen that shows a browsable, filterable grid of records** (lists
 6. **Table properties:** Always reachable. `HubTable` mounts `TablePropertiesDrawerButton` in `toolbarSlot`; on **`ListPageTemplate`** pages with **table / list / board / dashboard** tabs it **MUST** also receive **`currentView`** and **`onViewChange`** (see **`apps/web/AGENTS.md` §4.2** and **`.cursor/rules/exxat-table-properties-drawer.mdc`**) so Properties matches the selected view.
 7. **Dropdown menus:** `DropdownMenuContent` uses the shared **`@exxatdesignux/ui`** default (**intrinsic `w-max`**, **`min-w-52`**, capped **`max-w`**) for view settings, row ⋯, column menus, and filter pickers — **pure CSS**, no **`ResizeObserver`**. Override only for deliberate narrow/wide rails (e.g. pagination **`w-20`**, account trigger-width, school switcher **`!w-max min-w-72 …`**). See **`docs/data-views-pattern.md`** (“Dropdown menus”).
 8. **Cell renderers MUST come from `@/components/data-views` (`table-cells.tsx`).** The DS ships **`ProgressCell`**, **`CurrencyCell`**, **`NumericCell`**, **`RatingCell`**, **`SignalBarsCell`**, **`BooleanToggleCell`**, **`AttachmentCountCell`**, **`ExternalLinkCell`**, **`RelativeTimeCell`**, **`PeopleAvatarRailCell`**, **`PillCell`**, **`TagListCell`**, and a generic **`RowActionsCell<TRow>`**. A `ColumnDef['cell']` for these patterns is a **one-liner** that calls the named cell. **MUST NOT** inline `Intl.NumberFormat`, raw `<a target="_blank">`, `[1,2,3,4,5].map(s => …)` star loops, paperclip + count chips, custom face-rail `AvatarGroup`s, or per-hub `DropdownMenu` overflow menus inside `cell:` — those are signals you're re-deriving a shipped primitive. Catalog: `apps/web/components/columns-showcase.tsx` (`/columns`). Skill: `.cursor/skills/exxat-token-economy/SKILL.md` §3.
+9. **Add view parity** — **`FULL_HUB_SUPPORTED_VIEWS`** + a real renderer per view — **`.cursor/rules/exxat-hub-supported-views.mdc`**, **`docs/exxat-ds/patterns/hub-supported-views-pattern.md`**.
 
 **Reference implementations:**
 
-- `components/placements-table.tsx` — full hub: paged table, board, dashboard, list, conditional rules, dashboard customize, bulk actions.
-- `components/sites-table.tsx` — table + finder/board.
-- `components/team-table.tsx` — table + dashboard + list.
-- `components/columns-showcase.tsx` — minimal hub (single `table` view); good reference for showcase pages.
-- `components/tokens-themes-client.tsx` — minimal hub + secondary panel scope.
+- `components/library-table.tsx` + `components/library-client.tsx` — **canonical** seven-view hub (All questions).
+- `components/columns-showcase.tsx` — cell-pattern catalog via **`LibraryTable`** (`columnDefs` + folder state); same Add view as Library.
+- `components/tokens-themes-client.tsx` + `components/tokens-hub-auxiliary-views.tsx` — tokens hub with **`FULL_HUB_SUPPORTED_VIEWS`**.
 
 ## Do not
 
@@ -32,12 +31,15 @@ For **any app screen that shows a browsable, filterable grid of records** (lists
 - Do **not** mount raw `<DataTable>` inside `ListPageTemplate.renderContent` — use `HubTable`. Raw `<DataTable>` does not ship the Properties drawer or filter chips; users lose discoverability.
 - Do **not** introduce a second “table component” pattern for the same product surfaces (splitting search/filters/properties across incompatible implementations).
 - Do **not** inline-implement progress bars, currency formatters, rating stars, relative-time helpers, attachment chips, external-link wrappers, face rails, type pills, tag lists, or row-action dropdowns inside a `ColumnDef['cell']`. Import the named cell from `@/components/data-views` instead. New hub with novel cell needs MUST extend `table-cells.tsx` (and ship the catalog entry in `columns-showcase.tsx`), not fork inline JSX.
+- Do **not** trim **`supportedViewTypes`** to table-only or **`PRIMARY_HUB_SUPPORTED_VIEWS`** on hubs that should match Library — see **`exxat-hub-supported-views.mdc`**.
 
 ## Exceptions
 
 - **Tiny, read-only tables inside charts or analytics cards** (e.g. chart figure captions / summary matrices) may use minimal markup when they are not primary data-list experiences — still prefer tokens and accessibility, but the full hub stack is not required there.
 - **Drawer body and dialog sub-grids** (small, secondary, scoped to a transient flow) — raw `<DataTable>` is acceptable; still expose search if rows > ~10.
+- **Documented narrow allowlists** in `lib/*-supported-views.ts` when product truly omits folder/panel/tree (comment required).
 
 ## See also
 
 - **`apps/web/AGENTS.md`** — full MUST/MUST NOT, list-page template, primary hubs, checklist.
+- **`.cursor/rules/exxat-hub-supported-views.mdc`** — Add view menu + renderer matrix.

package/consumer-extras/cursor-rules/exxat-drawer-vs-dialog.mdc

@@ -7,16 +7,16 @@ alwaysApply: true
 
 ## MUST
 
-1. **Drawer / sheet** — Hub-**adjacent** work where **parent context** (list, filters, selection) stays relevant: properties, export, invites, long option lists beside the grid.
+1. **Sheet panel** — Hub-**adjacent** work where **parent context** (list, filters, selection) stays relevant: properties, export, invites, long option lists beside the grid. Use **`Sheet`** (`showOverlay={false}`, floating inset) — **MUST NOT** add a Vaul `Drawer` primitive.
 2. **Dialog** — **Blocking**, **short** focus: destructive confirm, legal/acknowledgment, single-step choice, alert when the user must not interact with the page behind until resolved.
 3. **Route** — **Primary**, **long**, or **bookmarkable** flows — **`AGENTS.md` §6.4**, **`.cursor/rules/exxat-page-vs-drawer.mdc`**.
 
 ## MUST NOT
 
-- Put **irreversible delete** only in a dismissible toast — use **dialog** (or drawer with explicit confirm) per **`exxat-no-toast.mdc`**.
-- Use a **centered dialog** for **wide tables of export columns** when a **drawer** matches mental model and space.
+- Put **irreversible delete** only in a dismissible toast — use **dialog** (or sheet with explicit confirm) per **`exxat-no-toast.mdc`**.
+- Use a **centered dialog** for **wide tables of export columns** when a **sheet panel** matches mental model and space.
 
 ## See also
 
 - **`docs/drawer-vs-dialog-pattern.md`** · **`.cursor/skills/exxat-drawer-vs-dialog/SKILL.md`**
-- **`exxat-page-vs-drawer.mdc`** (drawer vs **route**)
+- **`exxat-page-vs-drawer.mdc`** (sheet vs **route**)

package/consumer-extras/cursor-rules/exxat-ds-agents.mdc

@@ -40,6 +40,11 @@ Before implementing or reviewing **list / table / board / dashboard / data-heavy
 25. **No SLDS leakage** — **`.cursor/rules/exxat-no-slds-leakage.mdc`** — no `slds-*` classes, no `<lightning-*>` markup, no SLDS token names, no synthetic-shadow assumptions. ESLint catches via `exxat-ds/no-slds-classes` + `exxat-ds/no-lightning-elements` (from **`@exxatdesignux/eslint-plugin`**).
 26. **Blueprints + selection guide** — **`apps/web/docs/blueprints/`** + **`apps/web/docs/component-selection-guide.md`** — framework-agnostic specs + decision tree across the whole DS. Start there before composing a new hub.
 27. **Migrations** — **`apps/web/docs/migrations/`** — every deprecation gets a numbered entry (`NNNN-<slug>.md`). Token deprecations surface in `tokens/hooks-index.json` as `deprecated: true` and are lint-flagged.
+28. **Hub supported views (Add view parity)** — **`exxat-hub-supported-views.mdc`** + **`docs/exxat-ds/patterns/hub-supported-views-pattern.md`** — **`FULL_HUB_SUPPORTED_VIEWS`** (seven views, same as Library); sync **`ListPageTemplate`** + **`HubTable`**; real renderers per view; **`LibraryTable`** for **`LibraryItem`** catalogs; **`tokens-hub-auxiliary-views.tsx`** for tokens.
+29. **No Vaul** — **`exxat-no-vaul.mdc`** — side panels = **`Sheet`** only; remove **`vaul`** from consumer apps on **`@exxatdesignux/ui@0.5.3+`**.
+30. **Tabs chrome** — **`exxat-tabs-chrome.mdc`** — hub views = **`ListPageTemplate`** toolbar (`w-max`); record tabs = **`TabsList`** `w-fit`, never full-width stretch.
+31. **Page header actions** — **`exxat-page-header-actions.mdc`** — filled primary + outline overflow; no hand-built grey buttons.
+32. **Table row preview** — **`exxat-table-row-preview.mdc`** — **`HoverCard`** + DS badges/cells; no bespoke popover cards.
 
 ## Also read
 
@@ -50,7 +55,7 @@ Before implementing or reviewing **list / table / board / dashboard / data-heavy
 - **`apps/web/docs/blueprints/`** — framework-agnostic specs (start: `page-header.md`, `data-table.md`).
 - **`apps/web/docs/migrations/`** — token rename + removal history.
 - **`packages/ui/tokens/hooks-index.json`** — machine-readable token index (regenerate via `pnpm --filter @exxatdesignux/ui tokens:index`).
-- `.cursor/rules/exxat-data-tables.mdc`, `exxat-list-page-connected-views.mdc`, **`exxat-centralized-list-dataset.mdc`**, **`exxat-list-page-view-shells.mdc`**, **`exxat-fontawesome-icons.mdc`**, **`exxat-mono-ids.mdc`**, **`exxat-primary-nav-secondary-panel.mdc`**, **`exxat-library-hub-header.mdc`**, **`exxat-collaboration-access.mdc`**, **`exxat-dedicated-search-surfaces.mdc`**, **`exxat-kpi-trends.mdc`**, **`exxat-kpi-flat-band.mdc`**, **`exxat-drawer-vs-dialog.mdc`**, **`exxat-card-vs-list-rows.mdc`**, **`exxat-kpi-max-four.mdc`**, **`exxat-reuse-before-custom.mdc`**, `exxat-table-properties-drawer.mdc`, **`exxat-board-cards.mdc`**, **`exxat-page-vs-drawer.mdc`**, **`exxat-no-toast.mdc`**, **`exxat-command-menu.mdc`**, `exxat-kbd-shortcuts.mdc`, `exxat-accessibility.mdc` at repo root; **`apps/web/.cursor/rules/exxat-dashboard-view-charts.mdc`** for Data tab charts.
+- `.cursor/rules/exxat-data-tables.mdc`, **`exxat-hub-supported-views.mdc`**, **`exxat-no-vaul.mdc`**, **`exxat-tabs-chrome.mdc`**, **`exxat-page-header-actions.mdc`**, **`exxat-table-row-preview.mdc`**, `exxat-list-page-connected-views.mdc`, **`exxat-centralized-list-dataset.mdc`**, **`exxat-list-page-view-shells.mdc`**, **`exxat-fontawesome-icons.mdc`**, **`exxat-mono-ids.mdc`**, **`exxat-primary-nav-secondary-panel.mdc`**, **`exxat-library-hub-header.mdc`**, **`exxat-collaboration-access.mdc`**, **`exxat-dedicated-search-surfaces.mdc`**, **`exxat-kpi-trends.mdc`**, **`exxat-kpi-flat-band.mdc`**, **`exxat-drawer-vs-dialog.mdc`**, **`exxat-card-vs-list-rows.mdc`**, **`exxat-kpi-max-four.mdc`**, **`exxat-reuse-before-custom.mdc`**, `exxat-table-properties-drawer.mdc`, **`exxat-board-cards.mdc`**, **`exxat-page-vs-drawer.mdc`**, **`exxat-no-toast.mdc`**, **`exxat-command-menu.mdc`**, `exxat-kbd-shortcuts.mdc`, `exxat-accessibility.mdc` at repo root; **`apps/web/.cursor/rules/exxat-dashboard-view-charts.mdc`** for Data tab charts.
 - **`apps/web/docs/kpi-flat-band-pattern.md`**, **`apps/web/docs/shell-surface-elevation-pattern.md`** — flat KPI strip + sidebar/secondary/page OKLCH stack.
 - **`apps/web/docs/library-hub-header-pattern.md`** — folder-scoped library header **Customize folder**.
 - **`apps/web/docs/collaboration-access-pattern.md`** — shared hub face rail + invite sheet.

package/consumer-extras/cursor-rules/exxat-hub-supported-views.mdc

@@ -0,0 +1,54 @@
+---
+description: List-page hubs — FULL_HUB_SUPPORTED_VIEWS, Add view parity, and real renderers (never trimmed allowlists or placeholder list rows)
+alwaysApply: true
+---
+
+# Exxat DS — hub supported views (Add view parity)
+
+**Canonical reference:** `components/library-table.tsx` + `components/library-client.tsx` (All questions / Library).
+
+**Registry:** `FULL_HUB_SUPPORTED_VIEWS` in `@exxatdesignux/ui/lib/data-list-view-registry` (re-export `@/lib/data-list-view-registry`).
+
+## Default allowlist (seven views)
+
+Every **`ListPageTemplate`** + **`HubTable`** hub that mounts a product data grid **MUST** expose the same **Add view** menu as Library unless product documents a narrower exception in the hub’s `*-supported-views.ts` file:
+
+| # | View | Render kind | How to implement |
+|---|------|-------------|------------------|
+| 1 | Table | `data-table` | Default `HubTable` / custom `columnDefs` |
+| 2 | List | `list-with-toolbar` | **`ListPageBoardCard`** `layout="row"` via `renderListRow` — same as `library-table.tsx` |
+| 3 | Board | `board-with-toolbar` | `renderers["board-with-toolbar"]` or `renderBoardCard` + `boardGroups` |
+| 4 | Dashboard | `dashboard-with-toolbar` | `renderers["dashboard-with-toolbar"]` with **`KeyMetrics`** / charts on `state.rows` |
+| 5 | Folder | `folder-with-toolbar` | `renderers["folder-with-toolbar"]` (e.g. `LibraryOsFolderView`, `FolderGridView`) |
+| 6 | List & details | `panel-with-toolbar` | `renderers["panel-with-toolbar"]` (Miller columns — see `library-table.tsx`) |
+| 7 | Tree & details | `tree-panel-with-toolbar` | `renderers["tree-panel-with-toolbar"]` (e.g. `HubTreePanelView`) |
+
+`HubTable` and `ListPageTemplate` default to **`FULL_HUB_SUPPORTED_VIEWS`** when `supportedViewTypes` is omitted.
+
+**`PRIMARY_HUB_SUPPORTED_VIEWS`** (table, list, board, dashboard only) is for hubs that **document** they intentionally omit folder/panel/tree — not the default for new work.
+
+## MUST (every new or touched hub)
+
+1. **Sync allowlists** — Pass the **same** `supportedViewTypes` to **`ListPageTemplate`** and **`HubTable`** (or only omit on both so the default applies).
+2. **Implement every allowed view** — Each entry in `supportedViewTypes` needs a renderer (explicit `renderers` map and/or `renderListRow` / `renderBoardCard` + `boardGroups`). Dev warns when a view is allowed but missing; users see **“does not implement X view”** if you ship the allowlist without bodies.
+3. **List rows use DS chrome** — **`ListPageBoardCard`** (Library list pattern). **MUST NOT** ship a bare two-line `renderListRow` (title + mono id only).
+4. **Library-shaped rows** — Hubs on **`LibraryItem`** with a custom table (e.g. Column types) **MUST** delegate non-table views to **`LibraryTable`** (`columnDefs` + `hubLabels` + `folders` state) — do not reimplement folder/panel/tree in isolation.
+5. **Token hubs** — Use **`FULL_HUB_SUPPORTED_VIEWS`** + **`components/tokens-hub-auxiliary-views.tsx`** (`renderTokenListRow`, `buildTokensHubRenderers`) — **MUST NOT** use `supportedViewTypes={["table"]}`.
+
+## MUST NOT
+
+- Pass **`PRIMARY_HUB_SUPPORTED_VIEWS`** or `["table", "list", "board", "dashboard"]` on a hub that should match Library Add view parity.
+- Pass **`supportedViewTypes={["table"]}`** on any primary hub or showcase inside **`ListPageTemplate`**.
+- Copy **`COLUMNS_SUPPORTED_VIEWS = PRIMARY_…`** without implementing folder/panel/tree.
+- Invent a new per-page allowlist constant without a matching renderer for every listed view.
+
+## Narrow exceptions (document in code comment)
+
+- Hubs that genuinely lack calendar/folder/panel/tree (e.g. legacy Placements-only four views) — export `ENTITY_SUPPORTED_VIEWS` in `lib/*-supported-views.ts` and **comment why** it is narrower than `FULL_HUB_SUPPORTED_VIEWS`.
+- Calendar is **not** in `FULL_HUB_SUPPORTED_VIEWS`; add only when the hub implements `calendar-with-toolbar`.
+
+## See also
+
+- **`.cursor/rules/exxat-data-tables.mdc`**, **`exxat-list-page-connected-views.mdc`**, **`exxat-list-page-view-shells.mdc`**
+- **`docs/exxat-ds/patterns/hub-supported-views-pattern.md`** (vendored from monorepo `apps/web/docs/`)
+- **`docs/exxat-ds/patterns/data-views-pattern.md`**

package/consumer-extras/cursor-rules/exxat-nav-single-active.mdc

@@ -0,0 +1,31 @@
+---
+description: Sidebar and secondary nav — exactly one active item per route (longest path match)
+globs: "**/app-sidebar.tsx,**/secondary-nav.tsx,**/navigation.tsx,**/lib/nav-active.ts"
+alwaysApply: false
+---
+
+# Exxat DS — single active nav item (MUST)
+
+Only **one** primary sidebar row, collapsible child, or secondary-panel link may show the active/selected state for the current route.
+
+## MUST
+
+1. **Use shared helpers** from `@exxatdesignux/ui/lib/nav-active` (or the app copy synced from the DS template):
+   - `collectNavUrls` + `buildNavHashClaims` for the full nav tree
+   - `isNavHrefActive(pathname, url, allNavUrls, { locationHash, hashClaimsByPath })` for sidebar `SidebarMenuButton` / `isActive`
+   - `resolveActiveNavHref(pathname, allLinkHrefs)` for secondary-panel links — compare the returned href to each link’s `href` (longest prefix wins)
+2. **Never** mark a nav item active with bare `pathname === href` or `pathname.startsWith(href + "/")` when other nav targets share that prefix (e.g. `/dashboard` vs `/dashboard/students`).
+3. **Hash disambiguation** — when multiple items share the same path (e.g. `/settings` vs `/settings#appearance`), use `buildNavHashClaims` so the no-fragment row defers to the hash-specific row.
+4. **Collapsible parents** — when any child is active, the **parent** row stays visually neutral in the expanded sidebar; only the child gets `data-active` (icon rail may still highlight the parent — see `isCollapsibleParentMenuButtonActive` in `app-sidebar.tsx`).
+5. **Keep `ListPageTemplate.supportedViewTypes` and `HubTable.supportedViewTypes` in sync** on the same hub — do not pass `supportedViewTypes={["table"]}` on a primary hub unless that hub truly implements only table.
+
+## MUST NOT
+
+- Duplicate bespoke `isNavActive` / `isActive` logic that ignores longest-prefix matching.
+- Ship a new nav surface (sidebar, secondary rail, hub scope list) without wiring the helpers above.
+
+## Reference
+
+- `packages/ui/src/lib/nav-active.ts`
+- `packages/ui/template/components/sidebar/app-sidebar.tsx`
+- `packages/ui/template/components/sidebar/secondary-nav.tsx`

package/consumer-extras/cursor-rules/exxat-no-vaul.mdc

@@ -0,0 +1,25 @@
+---
+description: Exxat DS — no Vaul Drawer primitive; side panels use Sheet only
+alwaysApply: true
+---
+
+# Exxat DS — no Vaul
+
+## MUST
+
+- Side panels (export, properties, invite, folder create) use **`Sheet`** from `@exxatdesignux/ui/components/sheet` with the floating inset pattern (`showOverlay={false}`, `getFloatingSheetInsetProps`).
+- Product code names may end in `*Drawer` (`ExportDrawer`, `TablePropertiesDrawer`) — implementation is **`Sheet`**, not Vaul.
+
+## MUST NOT
+
+- Add **`vaul`** to `package.json` or import `@/components/ui/drawer` / Vaul `Drawer`.
+- Scaffold or extend the removed shadcn Vaul wrapper — it was deleted from `@exxatdesignux/ui@0.5.3+`.
+
+## Consumer apps
+
+After upgrading to **`@exxatdesignux/ui@0.5.3`**, remove **`vaul`** from the app `package.json`, delete any local `components/ui/drawer.tsx` re-export, and re-run **`exxat-ui sync-extras`**.
+
+## See also
+
+- **`.cursor/rules/exxat-drawer-vs-dialog.mdc`**
+- **`docs/exxat-ds/patterns/drawer-vs-dialog-pattern.md`**

package/consumer-extras/cursor-rules/exxat-page-header-actions.mdc

@@ -0,0 +1,31 @@
+---
+description: Exxat DS — PageHeader actions slot; View as / overflow / primary CTA patterns
+alwaysApply: true
+---
+
+# Exxat DS — page header actions
+
+**Blueprint:** `docs/exxat-ds/handbook/HANDBOOK.md` + `node_modules/@exxatdesignux/ui/template/docs/blueprints/page-header.md`
+
+## Anatomy (actions slot only)
+
+| Control | DS pattern |
+|---------|------------|
+| **Primary CTA** | One **`Button`** `variant="default"` `size="lg"` (filled) — e.g. “Add student”, “Ask Leo” when it is the main action |
+| **Secondary / scope** (“View as”, “All students”) | **`Button variant="outline" size="lg"`** + chevron, or **`Select`** / **`DropdownMenu`** trigger styled as outline button — **not** plain grey rectangles or unstyled `<button>` |
+| **Overflow (⋯)** | **`Button variant="outline" size="icon-lg"`** (or `size="lg"` icon-only) opening **`DropdownMenu`** — Export, settings, invite |
+| **Collaboration** | **`PageHeader variant="collaboration"`** face rail — not a custom avatar row |
+
+## MUST
+
+- Compose **`PageHeader`** + pass **`actions`** as DS **`Button`** / **`DropdownMenu`** primitives.
+- Keep **one** filled primary; put Export and long-tail items under **⋯**.
+
+## MUST NOT
+
+- Hand-built header button rows that skip **`PageHeader`** and **`Button`** variants.
+- Multiple filled primaries beside each other (e.g. “Ask Leo” + “Add student” both solid black unless product explicitly documents hierarchy — prefer outline for secondary).
+
+## Reference
+
+- **`docs/exxat-ds/handbook/reference-implementations.md`**

package/consumer-extras/cursor-rules/exxat-table-row-preview.mdc

@@ -0,0 +1,24 @@
+---
+description: Exxat DS — table row identity preview uses HoverCard + DS tokens, not bespoke Popover cards
+alwaysApply: false
+---
+
+# Exxat DS — table row preview (hover / click)
+
+When a **data table** cell opens a **rich preview** of a person or record (student, placement, team member):
+
+## MUST
+
+- Use **`HoverCard`** (`@/components/ui/hover-card`) for hover-driven previews, or **`Popover`** only when the preview is **click-pinned** and small.
+- Structure identity with **`AvatarInitials`**, name, **`font-mono tabular-nums`** on IDs only (**`exxat-mono-ids.mdc`**), **`ListHubStatusBadge`** + **`lib/list-status-badges.ts`** for status — **color + icon** (**`exxat-accessibility.mdc`** 1.4.1).
+- Reuse table cell patterns from **`@/components/data-views`** (`PeopleAvatarRailCell`, `PillCell`, progress cells) — see **`columns-showcase.tsx`**.
+
+## MUST NOT
+
+- Bespoke **`PopoverContent`** layouts with ad-hoc spacing, one-off progress bars, or status chips without the shared badge map.
+- Raw email as the only identifier when a display name exists (**`exxat-person-identity-display.mdc`**).
+
+## Reference
+
+- **`HoverCard`** docs in `packages/ui/src/components/ui/hover-card.tsx`
+- **`apps/web/docs/blueprints/data-table.md`**

package/consumer-extras/cursor-rules/exxat-tabs-chrome.mdc

@@ -0,0 +1,31 @@
+---
+description: Exxat DS — Tabs and view toolbars must not stretch full width; use ListPageTemplate for hub views
+alwaysApply: true
+---
+
+# Exxat DS — tabs chrome (no full-width stretch)
+
+## List hubs (All students, Placements, …)
+
+**MUST** use **`ListPageTemplate`** view toolbar — `role="toolbar"` + **`w-max`** segmented control (`viewSegmentedToolbarClass`), **not** Radix **`Tabs`** stretched across the page.
+
+- Reference: `packages/ui/src/components/templates/list-page.tsx` (views toolbar block).
+- **MUST NOT** build a custom full-width tab bar for “All students · 16” + Add view.
+
+## Entity / record detail (Overview, Academics, Placements, …)
+
+**MUST** use **`Tabs`**, **`TabsList`**, **`TabsTrigger`** from `@/components/ui/tabs`:
+
+- **`TabsList`** defaults to **`inline-flex w-fit`** — **MUST NOT** pass `className="w-full"` or wrap the list in a full-width flex container that forces triggers to **`flex-1`**.
+- Prefer **`variant="line"`** for record sub-nav under a **`PageHeader`** (`record-home` blueprint).
+- **`TabsTrigger`** may use `flex-1` only inside a **`w-fit`** list with a fixed number of tabs — never inside a bar that spans the content column.
+
+## MUST NOT
+
+- A single grey/white bar spanning the entire content width with tabs distributed edge-to-edge.
+- Mix hub **view tabs** (table/list/board) with entity **section tabs** (Overview/Academics) — different patterns.
+
+## See also
+
+- **`docs/exxat-ds/handbook/HANDBOOK.md`** — header never carries view tabs
+- **`docs/exxat-ds/patterns/data-views-pattern.md`** — `ListPageTemplate` view toolbar

package/consumer-extras/cursor-skills/exxat-drawer-vs-dialog/SKILL.md

@@ -1,6 +1,6 @@
 # Exxat DS — drawer vs dialog
 
-Use when choosing **Radix `Dialog` / `AlertDialog`** vs **`Sheet` / `Drawer`** vs **route** for a flow.
+Use when choosing **Radix `Dialog` / `AlertDialog`** vs **floating `Sheet` panels** vs **route** for a flow.
 
 ## Read first
 
@@ -10,11 +10,11 @@ Use when choosing **Radix `Dialog` / `AlertDialog`** vs **`Sheet` / `Drawer`** v
 
 ## Checklist
 
-1. **Must the user see the hub while acting?** Yes → **drawer/sheet** (properties, export, invite). No and short → **dialog**. Long / own URL → **route**.
-2. **Destructive confirm?** Prefer **dialog** (`AlertDialog`) unless the product explicitly keeps context in a drawer with the same safeguards.
-3. **Title + focus** — Dialog/drawer/sheet all need an accessible **title**; restore focus to trigger on close.
+1. **Must the user see the hub while acting?** Yes → **`Sheet`** panel (properties, export, invite). No and short → **dialog**. Long / own URL → **route**.
+2. **Destructive confirm?** Prefer **dialog** (`AlertDialog`) unless the product explicitly keeps context in a sheet with the same safeguards.
+3. **Title + focus** — Dialog and sheet both need an accessible **title**; restore focus to trigger on close.
 
 ## Repo references
 
-- `TablePropertiesDrawer`, `ExportDrawer`, `InviteCollaboratorsDrawer` — drawer-class.
+- `TablePropertiesDrawer`, `ExportDrawer`, `InviteCollaboratorsDrawer` — floating **`Sheet`** (names end in “Drawer” but implementation is `Sheet` only).
 - Delete / irreversible — dialog pattern, not toast (**`exxat-no-toast.mdc`**).

package/consumer-extras/cursor-skills/exxat-ds-skill/SKILL.md

@@ -251,15 +251,20 @@ For "System" variants, use the **`SplitSystemSvg`** helper. It renders `ChromeIl
 Any **primary nav destination** that shows a list of records **must** use this composition (same as Placements / Team):
 
 ```
-ListPageTemplate
+ListPageTemplate  (supportedViewTypes = FULL_HUB_SUPPORTED_VIEWS — seven views)
   ├── PageHeader (title, subtitle with count, primary CTA, ⋯ more menu)
   ├── KeyMetrics (flat variant, single row)
   └── renderContent()
-        └── DataTable + useTableState + TablePropertiesDrawer
+        └── HubTable + useTableState + TablePropertiesDrawer + renderers per view
 ```
 
+**Add view parity (binding):** `.cursor/rules/exxat-hub-supported-views.mdc`, `apps/web/docs/hub-supported-views-pattern.md`. **MUST NOT** use `supportedViewTypes={["table"]}` or four-view-only allowlists without a documented exception. List view **MUST** use **`ListPageBoardCard`** (`library-table.tsx`).
+
 **Reference implementations:**
-- `components/team-client.tsx` + `components/team-table.tsx` — canonical pattern
+- `components/library-client.tsx` + `components/library-table.tsx` — **canonical seven-view hub** (All questions)
+- `components/columns-showcase.tsx` — custom table via **`LibraryTable`** + same seven views
+- `components/tokens-themes-client.tsx` + `components/tokens-hub-auxiliary-views.tsx`
+- `components/team-client.tsx` + `components/team-table.tsx` — entity hub pattern
 - `components/placements-client.tsx` + `components/placements-table.tsx` — Placements (most complete)
 
 **Files to create for a new hub page `Foo`:**
@@ -617,7 +622,7 @@ Full checklist in `references/accessibility.md`. Summary of the most-violated ru
 ### Structure
 - One `<main id="main-content" tabIndex={-1}>` per page
 - One `<h1>` per page (via `PageHeader`) — `SiteHeader` title is NOT an h1
-- `DialogTitle` / `SheetTitle` / `DrawerTitle` always present (use `className="sr-only"` if visually hidden)
+- `DialogTitle` / `SheetTitle` always present (use `className="sr-only"` if visually hidden)
 
 ### ARIA roles
 - `role="tablist"` → only `role="tab"` children. **Never** put buttons, menus, or other controls inside `tablist`
@@ -874,7 +879,7 @@ Copy and complete for every list/table/hub page:
 - [ ] All icons: `aria-hidden="true"`; Ask Leo: `fa-duotone fa-solid fa-star-christmas text-brand`
 - [ ] **Every icon that communicates info has a text alternative** — Case A adjacent label (preferred), Case B `role="img"` + `aria-label` + `Tooltip` (calendar-for-date, status dot, trend arrow, icon-only legend), Case C `aria-label` + `Tooltip` on icon-only buttons; target ≥ 24×24 px. See §12 *Icons that communicate information*.
 - [ ] **`Kbd` inside a `Button` uses `variant="bare"`** (glue chords into one bare kbd); **`Kbd` inside `TooltipContent` uses the default tile** — see §11 Keyboard shortcuts
-- [ ] `DialogTitle`/`SheetTitle`/`DrawerTitle` present on every overlay
+- [ ] `DialogTitle`/`SheetTitle` present on every overlay
 - [ ] `role="tablist"` contains only tab-role children
 - [ ] No new shadcn components, no hardcoded colors, no duplicate component abstractions
 

package/consumer-extras/cursor-skills/exxat-ds-skill/references/accessibility.md

@@ -42,7 +42,7 @@ This is the single source of truth for all accessibility requirements in Exxat D
 - Heading hierarchy: one `<h1>` (via `PageHeader`), logical `<h2>` → `<h3>` (no skipping)
 - `SiteHeader` title in the breadcrumb bar is NOT an `<h1>`
 - Multiple `<nav>` elements: each must have `aria-label`
-- Modal/Sheet/Dialog: `DialogTitle`/`SheetTitle`/`DrawerTitle` ALWAYS present — use `sr-only` if visually hidden
+- Modal/Sheet/Dialog: `DialogTitle`/`SheetTitle` ALWAYS present — use `sr-only` if visually hidden
 - `<aside>` panels: `aria-label` (e.g. "Ask Leo assistant", "Rotation navigation")
 - Data tables: `<table>` + `<thead>` + `<th scope="col">`; sortable columns: `aria-sort` on `<th>`
 - Listbox: `role="listbox"` + `role="option"` + `aria-selected`

package/consumer-extras/cursor-skills/exxat-ds-skill/references/data-table-pattern.md

@@ -1,16 +1,26 @@
 # Data Table Pattern — Full Implementation Guide
 
-Reference implementation: `components/team-table.tsx` (Team) and `components/placements-table.tsx` (Placements).
+**Primary hub stack:** `ListPageTemplate` → **`HubTable`** (not raw `DataTable` inside hubs).
+
+**Add view parity:** `FULL_HUB_SUPPORTED_VIEWS` on **`ListPageTemplate`** + **`HubTable`**; implement every allowed view — **`.cursor/rules/exxat-hub-supported-views.mdc`**, **`apps/web/docs/hub-supported-views-pattern.md`**.
+
+**Reference implementations:**
+- `components/library-table.tsx` + `library-client.tsx` — canonical seven-view hub
+- `components/columns-showcase.tsx` — `LibraryTable` + custom `columnDefs`
+- `components/tokens-themes-client.tsx` + `tokens-hub-auxiliary-views.tsx`
+- `components/team-table.tsx`, `components/placements-table.tsx` — entity hubs
 
 ---
 
 ## Stack Summary
 
 ```
-DataTable                         ← base table component
-  └── useTableState               ← manages sort/filter/column/group state
-  └── toolbarSlot                 ← renders the properties button + drawer
-        └── TablePropertiesDrawer ← columns, density, filters, sort, conditional rules
+HubTable (inside ListPageTemplate)  ← canonical hub wrapper
+  └── DataTable                     ← base table component
+  └── useTableState                 ← sort/filter/column/group state
+  └── toolbarSlot                   ← properties button + filter chips + search
+        └── TablePropertiesDrawer
+  └── renderListRow / renderers     ← list, board, dashboard, folder, panel, tree
 ```
 
 All imports:

package/consumer-extras/cursor-skills/exxat-token-economy/SKILL.md

@@ -38,7 +38,7 @@ Open **only** these files. Skip everything else unless one of these files cites
 
 | Task | Read (minimum) | Skip (do not open) |
 |------|----------------|--------------------|
-| **Build a new hub page** (table + KPIs + view tabs) | `apps/web/components/columns-showcase.tsx` (or any reference hub), `docs/exxat-ds/handbook/HANDBOOK.md` §"How to build a hub" | `AGENTS.md`, `hub-table.tsx` source, all `*-pattern.md` |
+| **Build a new hub page** (table + KPIs + view tabs) | `apps/web/components/library-table.tsx` + `library-client.tsx`, `exxat-hub-supported-views.mdc` (or `hub-supported-views-pattern.md`) | `AGENTS.md`, `hub-table.tsx` source, all `*-pattern.md` |
 | **Add a column / cell pattern** | `apps/web/components/columns-showcase.tsx` (the live catalog) | `data-table/index.tsx`, the whole `types.ts` |
 | **Add a board / kanban view** | `apps/web/components/placements-board-card.tsx`, `exxat-board-cards.mdc` only | All other rules |
 | **Add a KPI strip** | `docs/exxat-ds/handbook/reference-implementations.md` § KPI flat band, `exxat-kpi-max-four.mdc`, `exxat-kpi-trends.mdc` | `key-metrics.tsx` source |
@@ -63,8 +63,11 @@ Answer **yes / no / N/A** to each. A **no** means re-plan; you'll save a regener
 3. **Color + icon on every status chip?** — `ListHubStatusBadge` + a tint from `lib/list-status-badges.ts` + an FA icon. Color alone fails WCAG 1.4.1.
 4. **≤ 4 KPIs on the primary strip?** — `KEY_METRICS_KPI_COUNT_MAX = 4`. A fifth becomes a `MetricInsight` or a chart.
 5. **No toasts for product feedback?** — use `LocalBanner` / `SystemBanner` / inline status. Toasts are reserved for build-tool messages.
+6. **Seven views + real bodies?** — `FULL_HUB_SUPPORTED_VIEWS` on **`ListPageTemplate`** + **`HubTable`** (sync both); every allowed view has a renderer; list uses **`ListPageBoardCard`** — not `["table"]` / `PRIMARY_HUB_SUPPORTED_VIEWS` / empty `renderers={}`.
+7. **Sheet only (no Vaul)?** — side panels use **`Sheet`**; **`vaul`** must not be in `package.json`.
+8. **Header + tabs + table preview?** — **`PageHeader`** + DS **`Button`** variants for actions; hub views via **`ListPageTemplate`** (not full-width tabs); record tabs **`TabsList`** `w-fit`; row preview via **`HoverCard`** + shared cells — not custom popovers.
 
-If all five are **yes**, generate. If any is **no**, either narrow the requirements
+If all eight are **yes**, generate. If any is **no**, either narrow the requirements
 with **one** clarifying question or fix the gap silently and note it in your response.
 
 ---
@@ -83,7 +86,7 @@ When the user says "X", reach for "Y". Save the search.
 | chip, badge, status, tag | `Badge`, `ListHubStatusBadge`, `StatusBadge` | `@/components/{ui/badge,list-hub-status-badge}` |
 | dropdown, menu, ⋯ | `DropdownMenu` family | `@/components/ui/dropdown-menu` |
 | tooltip, hint | `Tip` (or `Tooltip`) | `@/components/ui/tip` |
-| sheet, drawer | `Sheet` family, `ExportDrawer`, `TablePropertiesDrawer` | `@/components/ui/sheet` |
+| sheet, side panel | `Sheet` family, `ExportDrawer`, `TablePropertiesDrawer` | `@/components/ui/sheet` |
 | dialog, modal, confirm | `Dialog` family | `@/components/ui/dialog` |
 | table, list, grid (product data) | `HubTable` inside `ListPageTemplate` | `@/components/data-views` |
 | KPI, metric, stat | `KeyMetrics` + `MetricItem` | `@/components/key-metrics` |
@@ -141,8 +144,11 @@ import { PageHeader } from "@/components/page-header"
 import { KeyMetrics, type MetricItem } from "@/components/key-metrics"
 import { ListPageTemplate, type ViewTab, HubTable } from "@/components/data-views"
 
+import { FULL_HUB_SUPPORTED_VIEWS } from "@/lib/data-list-view-registry"
+
 const ENTITY_TABS: ViewTab[] = [{ id: "all", label: "All", viewType: "table", icon: "fa-table", filterId: "all" }]
-const ENTITY_SUPPORTED_VIEWS = ["table", "list", "board"] as const
+/** Seven views (Library parity) unless product documents a narrower list in lib/entity-supported-views.ts */
+const ENTITY_SUPPORTED_VIEWS = FULL_HUB_SUPPORTED_VIEWS
 
 export function EntityClient({ rows }) {
   const [tabs, setTabs] = React.useState<ViewTab[]>(ENTITY_TABS)
@@ -163,7 +169,10 @@ export function EntityClient({ rows }) {
             hubLabel="Entity" lifecycleTabLabel="Entity"
             getRowId={r => r.id} getRowSelectionLabel={r => r.name}
             defaultSort={{ key: "name", dir: "asc" }}
-            renderers={{}}
+            renderListRow={row => /* ListPageBoardCard layout="row" — copy library-table.tsx */}
+            renderers={{
+              /* board-with-toolbar, dashboard-with-toolbar, folder/panel/tree — see library-table.tsx or tokens-hub-auxiliary-views.tsx */
+            }}
           />
         )}
       />

package/consumer-extras/handbook/HANDBOOK.md

@@ -33,7 +33,7 @@ This is the **happy path** for the most common task: "I have an entity (placemen
 | 5 | Compose the page client with `PrimaryPageTemplate` → `ListPageTemplate` (KPIs in `metrics`, view tabs in `defaultTabs`, the `HubTable` in `renderContent`). | `apps/web/components/<entity>-client.tsx` | `exxat-list-page-connected-views.mdc` |
 | 6 | Add to nav (`lib/mock/navigation.tsx`). If the hub needs scoped sub-navigation (e.g. categories), declare `secondaryPanel: "<id>"` and register the panel. | `apps/web/lib/mock/navigation.tsx`, `apps/web/components/sidebar/secondary-panel.tsx` | `exxat-primary-nav-secondary-panel.mdc` |
 
-**Reference page to copy:** `apps/web/components/sites-table.tsx` (the smallest complete hub) or `apps/web/components/columns-showcase.tsx` (single-view hub with a `HubTable`).
+**Reference pages to copy:** `apps/web/components/library-table.tsx` + `library-client.tsx` (seven-view hub), `columns-showcase.tsx` (`LibraryTable` + custom columns), `tokens-themes-client.tsx` + `tokens-hub-auxiliary-views.tsx`. See **`hub-supported-views-pattern.md`** (vendored under `docs/exxat-ds/patterns/`).
 
 > **Stop signs.** If you find yourself building a parallel table stack, a second metrics strip, a custom filter row, or pasting raw `<DataTable>` into `renderContent` — **stop and re-read** `.cursor/rules/exxat-reuse-before-custom.mdc`.
 

package/consumer-extras/handbook/reference-implementations.md

@@ -27,9 +27,9 @@ If you find yourself diverging from the reference page, ask **why** before shipp
 | Hub with finder / split-panel view | `apps/web/components/sites-table.tsx` + `sites-client.tsx` | [`list-page-template`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/blueprints/list-page-template.md) | [`exxat-list-page-view-shells`](../../../.cursor/rules/exxat-list-page-view-shells.mdc) | [`data-views-pattern`](../data-views-pattern.md) |
 | Hub with secondary panel scope (folder rail) | `apps/web/components/library-table.tsx` + `library-client.tsx` | [`list-page-template`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/blueprints/list-page-template.md) | [`exxat-primary-nav-secondary-panel`](../../../.cursor/rules/exxat-primary-nav-secondary-panel.mdc), [`exxat-library-hub-header`](../../../.cursor/rules/exxat-library-hub-header.mdc) | [`library-hub-header-pattern`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/library-hub-header-pattern.md) |
 | Hub with secondary panel scope (token categories) — **smallest** secondary-panel reference | `apps/web/components/tokens-themes-client.tsx` + `tokens-secondary-nav.tsx` | [`list-page-template`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/blueprints/list-page-template.md) | [`exxat-primary-nav-secondary-panel`](../../../.cursor/rules/exxat-primary-nav-secondary-panel.mdc) | [`shell-surface-elevation-pattern`](../shell-surface-elevation-pattern.md) |
-| Single-view showcase hub (table only) — **18 SaaS cell patterns**, each rendered by an **importable named cell** from `@/components/data-views` (see "Cell primitives" table below). Categories: select, primary identity + ID + favorite, avatar + name + email, avatar group +N, type pill, difficulty signal, status chip, inline toggle, tag list, rating stars, progress bar, currency, numeric, attachment count, external link, relative time, absolute date, row actions overflow. | `apps/web/components/columns-showcase.tsx` + `columns-client.tsx` | [`list-page-template`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/blueprints/list-page-template.md), [`data-table`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/blueprints/data-table.md) | [`exxat-data-tables`](../../../.cursor/rules/exxat-data-tables.mdc) | — |
+| Cell-pattern catalog — **18 SaaS cell patterns** via custom `columnDefs`; **seven views** via **`LibraryTable`** (same Add view as Library). | `apps/web/components/columns-showcase.tsx` + `columns-client.tsx` | [`list-page-template`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/blueprints/list-page-template.md), [`data-table`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/blueprints/data-table.md), [`hub-supported-views-pattern`](https://github.com/ExxatDesign/Exxat-DS-Workspace/blob/main/apps/web/docs/hub-supported-views-pattern.md) | [`exxat-data-tables`](../../../.cursor/rules/exxat-data-tables.mdc), [`exxat-hub-supported-views`](../../../.cursor/rules/exxat-hub-supported-views.mdc) | — |
 
-> **First-time hub builder:** start with `sites-table.tsx` (smallest complete hub) or `columns-showcase.tsx` (single-view, easiest).
+> **First-time hub builder:** copy **`library-table.tsx`** + **`library-client.tsx`**; use **`columns-showcase.tsx`** for custom columns; **`tokens-themes-client.tsx`** + **`tokens-hub-auxiliary-views.tsx`** for tokens. Read **`hub-supported-views-pattern.md`** before changing Add view.
 
 ---
 

package/consumer-extras/patterns/consumer-upgrade-checklist.md

@@ -29,8 +29,21 @@ Use it when you need to know **what files exist**, **how shims re-export** `@exx
 
 - Keep **`@exxatdesignux/ui`** on the same semver your team tested; prefer explicit **`^x.y.z`** or pinned **`x.y.z`**.
 - Match **`engines.node`** in your app to the value declared in **`node_modules/@exxatdesignux/ui/package.json`** (see CHANGELOG if it changed).
+- **≥ 0.5.3:** Remove **`vaul`** from your app `package.json` and delete any `components/ui/drawer.tsx` shim — side panels use **`Sheet`** only (**`.cursor/rules/exxat-no-vaul.mdc`**).
 
-## 5. Still stuck?
+## 5. Consumer UI audit (after sync-extras)
+
+If the app was built before current agent rules, verify:
+
+| Symptom | Fix |
+|---------|-----|
+| Full-width tab bar on list hub | Use **`ListPageTemplate`** view toolbar — **`exxat-tabs-chrome.mdc`** |
+| Full-width Overview / Academics tabs | **`TabsList`** must stay **`w-fit`** — no `w-full` / `flex-1` stretch |
+| Grey custom header buttons | **`PageHeader`** + **`Button`** variants — **`exxat-page-header-actions.mdc`** |
+| Bespoke student popover in table | **`HoverCard`** + shared cells/badges — **`exxat-table-row-preview.mdc`** |
+| Custom hub table / trimmed Add view | **`HubTable`** + **`FULL_HUB_SUPPORTED_VIEWS`** — **`exxat-hub-supported-views.mdc`** |
+
+## 6. Still stuck?
 
 - **`npx --package=@exxatdesignux/ui@latest exxat-ui doctor`** — compares local CLI version vs npm **`latest`**.
 - **`npx --package=@exxatdesignux/ui@latest exxat-ui update`** — install commands and reminders.

package/consumer-extras/patterns/data-views-pattern.md

@@ -6,6 +6,12 @@
 
 This document describes how list pages combine **views**, **toolbar** behavior, **filters**, **properties**, and **persistence** in this codebase.
 
+## Add view parity (seven views)
+
+**Binding:** `.cursor/rules/exxat-hub-supported-views.mdc`. **Detail:** `docs/hub-supported-views-pattern.md`.
+
+Every list hub **should** use **`FULL_HUB_SUPPORTED_VIEWS`** (table, list, board, dashboard, folder, panel, tree-panel) on both **`ListPageTemplate`** and **`HubTable`**, with a working renderer per view. **Library** (`library-table.tsx`) is the reference. Do not ship table-only or four-view allowlists on showcase/catalog hubs unless product documents an exception.
+
 ## Reuse existing components (required)
 
 **Prefer composing what already exists** over rebuilding one-off tabs, search, filters, or property panels. The **Placements** flow is the reference implementation; new list/table/board pages should wire the same building blocks with new data and column definitions.