@exxatdesignux/ui 0.2.19 → 0.4.0

package/src/lib/table-properties-types.ts

@@ -0,0 +1,98 @@
+/**
+ * Shared types + design-system constants for the Table Properties drawer
+ * and related data-table primitives (filter chips, sort cards,
+ * conditional formatting rules).
+ *
+ * Product-specific seed data (`FILTER_FIELDS` and `COLUMNS` arrays
+ * tailored to the Placements hub) intentionally stays in
+ * `apps/web/components/table-properties/types.ts` — those values are
+ * **product data**, not design-system primitives, and the package must
+ * not know about Placement specializations, supervisor labels, etc.
+ *
+ * Consumers compose their own `FilterFieldDef[]` / `ColDef[]` arrays
+ * tailored to their entity (Team members, Compliance items, Question
+ * bank rows, …) and pass them into the drawer through props.
+ */
+
+/** Comparison operator vocabulary used by every filter row + conditional rule. */
+export type FilterOperator = "is" | "is_not" | "contains" | "not_contains"
+
+/**
+ * Input mask for `type: "text"` filters. Maps to a
+ * [Shadcn Studio input-mask](https://shadcnstudio.com/docs/components/input-mask)
+ * pattern key. Add new keys here (and in your concrete `exxatMaskPatterns`
+ * map) when a new column needs a structured text format.
+ */
+export type FilterTextMask = "phone" | "zip" | "dateMDY"
+
+export interface FilterFieldDef {
+  key: string
+  label: string
+  icon: string
+  type: "select" | "text" | "date"
+  operators: FilterOperator[]
+  /** Select options, or for `date` fields used by conditional rules (exact row strings). */
+  options?: { value: string; label: string }[]
+  /** When `type` is `text`, optional `use-mask-input` pattern for the value field. */
+  textMask?: FilterTextMask
+}
+
+export interface ActiveFilter {
+  id: string
+  fieldKey: string
+  operator: FilterOperator
+  values: string[]
+}
+
+export interface SortRule {
+  id: string
+  fieldKey: string
+  direction: "asc" | "desc"
+}
+
+/** Operator → human-readable label map (centralized so chips, drawer, and CSV exports stay aligned). */
+export const OPERATOR_LABELS: Record<FilterOperator, string> = {
+  is: "is",
+  is_not: "is not",
+  contains: "contains",
+  not_contains: "does not contain",
+}
+
+/** Column descriptor for `TableProperties` views (Columns / Sort / Group panels). */
+export interface ColDef {
+  key: string
+  label: string
+  sortable: boolean
+  sortKey?: string
+  minWidth: number
+}
+
+/* ─── Conditional formatting ──────────────────────────────────────────── */
+
+export interface ConditionalRule {
+  id: string
+  /** Column key to evaluate */
+  fieldKey: string
+  operator: FilterOperator
+  /** Selected option values (select) or text (single entry) when operator needs values */
+  values: string[]
+  /** Resolved CSS background color string */
+  bgColor: string
+}
+
+/**
+ * Predefined palette for conditional rule backgrounds.
+ *
+ * Backgrounds are exposed as CSS custom properties so theming swaps the
+ * palette per brand without code edits (`--conditional-rule-green`,
+ * `--conditional-rule-yellow`, etc., declared in
+ * `packages/ui/src/globals.css`).
+ */
+export const RULE_COLORS: { name: string; bg: string }[] = [
+  { name: "Green",  bg: "var(--conditional-rule-green)"  },
+  { name: "Yellow", bg: "var(--conditional-rule-yellow)" },
+  { name: "Blue",   bg: "var(--conditional-rule-blue)"   },
+  { name: "Red",    bg: "var(--conditional-rule-red)"    },
+  { name: "Purple", bg: "var(--conditional-rule-purple)" },
+  { name: "Orange", bg: "var(--conditional-rule-orange)" },
+]

package/template/.claude/skills/exxat-ds-skill/SKILL.md

@@ -112,17 +112,18 @@ ListPageTemplate
 ```
 
 **Reference implementations:**
-- `components/team-client.tsx` + `components/team-table.tsx` — canonical pattern
-- `components/data-list-client.tsx` + `components/data-list-table.tsx` — Placements (most complete)
+- `components/columns-showcase.tsx` + `components/columns-client.tsx` — smallest single-view hub (start here)
+- `components/tokens-themes-client.tsx` + `components/tokens-secondary-nav.tsx` — hub with secondary panel + URL-driven scope + built-in pagination chrome
+- `components/library-table.tsx` + `components/library-hub-client.tsx` — full multi-view hub (table, board, dashboard)
 
 **Files to create for a new hub page `Foo`:**
 | File | Purpose |
 |------|---------|
 | `lib/mock/foo.ts` | Mock data + TypeScript interface (12+ rows) |
-| `lib/mock/foo-kpi.ts` | `fooKpiMetrics()` + `fooKpiInsight()` |
+| `lib/mock/foo-kpi.ts` | `fooKpiMetrics()` (≤ 4 `MetricItem`s, each with `onClick` or `href`) + `fooKpiInsight()` returning a single `MetricInsight` |
 | `components/foo-page-header.tsx` | `PageHeader` + primary CTA + ⋯ menu |
-| `components/foo-table.tsx` | `DataTable` + `useTableState` + `TablePropertiesDrawer` |
-| `components/foo-client.tsx` | `ListPageTemplate` orchestrator |
+| `components/foo-showcase.tsx` *or* `components/foo-table.tsx` | `HubTable` (NOT raw `DataTable`) — pass `pagination` / `onPaginationChange` if the hub needs pagination chrome |
+| `components/foo-client.tsx` | `ListPageTemplate` orchestrator, mounts `KeyMetrics` with `items` + `insight` |
 | `app/(app)/foo/page.tsx` | Thin server component |
 
 **Do not** ship a **nav-linked hub** as an **empty page** or a single “replace this later” paragraph. If the route appears in **`lib/mock/navigation.tsx`**, implement the full hub (mock rows, **`ListPageTemplate`**, connected views per **`exxat-ds/AGENTS.md` §4.1**) unless the product explicitly defines a non-data shell.
@@ -148,7 +149,7 @@ Align with **`exxat-ds/AGENTS.md` §6.4**, **`docs/data-views-pattern.md`**, **`
 | `ColumnDef` from `@/components/data-table/types` | Column type |
 | `FilterFieldDef`, `FilterOperator`, `ConditionalRule` from `@/components/table-properties/types` | Filter types |
 
-**Board (kanban) cards:** Use **`ListPageBoardCard`** and related parts from **`components/data-views/list-page-board-card.tsx`**; **`BoardCardTwoLineBlock`** / **`BoardCardIconRow`** from **`board-card-primitives.tsx`**. **List hub** status (Team, Compliance, Question bank, …): maps in **`lib/list-status-badges.ts`**; render with **`ListHubStatusBadge`** (**`surface="table"`** in table/list, **`surface="board"`** on cards); semantic tints **`LIST_HUB_STATUS_TINT_*`** for new domains; no **`uppercase`**. **Placements** uses **`StatusBadge`** in **`data-list-table-cells.tsx`** (wrapper over **`ListHubStatusBadge`** + **`PLACEMENT_STATUS_*`**). **Full rules:** **`exxat-ds/AGENTS.md` §4.4**, **`.cursor/rules/exxat-board-cards.mdc`**, **`.cursor/skills/exxat-board-cards/SKILL.md`**.
+**Board (kanban) cards:** Use **`ListPageBoardCard`** and related parts from **`components/data-views/list-page-board-card.tsx`**; **`BoardCardTwoLineBlock`** / **`BoardCardIconRow`** from **`board-card-primitives.tsx`**. **List hub** status (Team, Compliance, Library, …): maps in **`lib/list-status-badges.ts`**; render with **`ListHubStatusBadge`** (**`surface="table"`** in table/list, **`surface="board"`** on cards); semantic tints **`LIST_HUB_STATUS_TINT_*`** for new domains; no **`uppercase`**. **Placements** uses **`StatusBadge`** in **`data-list-table-cells.tsx`** (wrapper over **`ListHubStatusBadge`** + **`PLACEMENT_STATUS_*`**). **Full rules:** **`exxat-ds/AGENTS.md` §4.4**, **`.cursor/rules/exxat-board-cards.mdc`**, **`.cursor/skills/exxat-board-cards/SKILL.md`**.
 
 **Minimum required features on any data list page:**
 - Search (wire `searchable={displayOptions.showToolbarSearch}`)
@@ -245,7 +246,7 @@ Use `PageHeader` from `@/components/page-header` for the content-area header (be
 
 When a hub is **shared**, use **`PageHeader` `variant="collaboration"`**: **empty roster** → outline **Add collaborator**; **non-empty** → face rail (faces / **`+N`** open the invite sheet). **Invite people** also lives under the entity header **⋯ More** and opens **`InviteCollaboratorsDrawer`** via **`CollaborationAccessFlow`** when possible. Library access (Owner / Editor / Commenter / Viewer) comes from **`lib/collaborator-access.ts`**; directory tags (Faculty, Program coordinator, Director) use **`PageHeaderCollaborator.roles`**.
 
-**Handbook:** `apps/web/AGENTS.md` §4.7 · **Doc:** `docs/collaboration-access-pattern.md` · **Skill:** `.cursor/skills/exxat-collaboration-access/SKILL.md` · **Reference:** Question bank header + client.
+**Handbook:** `apps/web/AGENTS.md` §4.7 · **Doc:** `docs/collaboration-access-pattern.md` · **Skill:** `.cursor/skills/exxat-collaboration-access/SKILL.md` · **Reference:** Library header + client.
 
 ---
 

package/template/.cursor/rules/exxat-accessibility.mdc

@@ -26,7 +26,7 @@ alwaysApply: true
    - **C. Interactive icon-only button/link** (close `×`, chevron, overflow `⋯`, sort, filter-dismiss, copy, Ask Leo toggle, row actions) → MUST pair **`aria-label`** on the `<button>` with a wrapping **`Tooltip`**. `aria-label` alone is not enough — sighted users rely on the tooltip too.
 
    In all cases the inner `<i>` / `<svg>` is `aria-hidden`; tooltip text matches the accessible name. Narrow exception: chevron inside a labelled composite (`Select`, `Combobox`). See **`AGENTS.md` §8.6 (Case A/B/C)**.
-10. **Keyboard shortcut hints inside buttons** MUST use **`<Kbd variant="bare">`** (no background/border, inherits `currentColor` at 70%). The default `tile` variant is for **tooltips** and **menu `shortcut=` slots** only. Glue multi-key chords into one bare kbd (e.g. `<Kbd variant="bare">⌘⌥K</Kbd>`). Reference: Next/Back in `new-placement-form.tsx`; see **`.cursor/rules/exxat-kbd-shortcuts.mdc`**.
+10. **Keyboard shortcut hints inside buttons** MUST use **`<Kbd variant="bare">`** (no background/border, inherits `currentColor` at 70%). The default `tile` variant is for **tooltips** and **menu `shortcut=` slots** only. Glue multi-key chords into one bare kbd (e.g. `<Kbd variant="bare">⌘⌥K</Kbd>`). Reference: Next/Back in `new-library-item-form.tsx`; see **`.cursor/rules/exxat-kbd-shortcuts.mdc`**.
 
 Re-run **axe** on **Placements** (or affected page) after changing **views toolbar** or **tabs**.
 

package/template/.cursor/rules/exxat-command-menu.mdc

@@ -7,7 +7,7 @@ alwaysApply: true
 
 ## Intent
 
-- **`CommandMenu`** (**⌘K** / **Ctrl+K**) is **global search** (routes, library, patterns, AI starters, optional row data such as placements / student names)—see **`AGENTS.md` §7.1** and **`docs/command-menu-pattern.md`**.
+- **`CommandMenu`** (**⌘K** / **Ctrl+K**) is **global search** (routes, library, patterns, AI starters, optional row data such as student names / question stems) — see **`AGENTS.md` §7.1** and **`docs/command-menu-pattern.md`**.
 - **Quick / lookup / short AI:** Prefer **results inside the palette** when the product can return compact answers or lightweight “research” without leaving the flow.
 - **Long or complex answers:** **Ask Leo** side panel (**⌘⌥K** / **Ctrl+Alt+K**)—not forced into the palette.
 
@@ -19,5 +19,5 @@ alwaysApply: true
 
 ## See also
 
-- **`exxat-ds/AGENTS.md` §7.1**
+- **`apps/web/AGENTS.md` §7.1**
 - **`.cursor/rules/exxat-kbd-shortcuts.mdc`** (⌘K vs ⌘⌥K)

package/template/.cursor/rules/exxat-dashboard-view-charts.mdc

@@ -5,14 +5,14 @@ alwaysApply: true
 
 # Exxat DS — Data view dashboard (list hubs)
 
-**Authoritative detail:** **`exxat-ds/AGENTS.md` §4.3** and **`exxat-dashboard-view-charts`** (this rule).
+**Authoritative detail:** **`apps/web/AGENTS.md` §4.3** and **`exxat-dashboard-view-charts`** (this rule).
 
 ## Two dashboard surfaces (do not fork chart engines)
 
 | Surface | Entry | Shared building blocks |
 |--------|--------|-------------------------|
 | **Full-page dashboard** | `app/(app)/dashboard/page.tsx` | `DashboardTabs`, `ChartsOverview` / gallery demos in `charts-overview.tsx` |
-| **Data tab** on Placements / Team / Compliance | `DataListTable`, `TeamTable`, `ComplianceTable` → `*DashboardChartsSection` | `ChartFigure`, `ChartCard`, `useChartVariant()`, `data-view-dashboard-charts*.tsx` |
+| **Data tab** on a hub | `library-table.tsx` → `LibraryDashboardChartsSection` (reference) | `ChartFigure`, `ChartCard`, `useChartVariant()`, the hub's own `*-dashboard-charts.tsx` module |
 
 **MUST NOT** duplicate “another” chart system for Data view — extend **`charts-overview`** patterns and **`lib/chart-keyboard-selection`**.
 
@@ -36,8 +36,8 @@ alwaysApply: true
 
 ## MUST — persistence (centralized)
 
-- **One bundle:** **`lib/data-view-dashboard-storage.ts`** — key **`exxat-ds:data-view-dashboards:v1`**, scopes **`placements` | `team` | `compliance`**.
-- Placements helpers: **`loadDashboardLayout`** / **`saveDashboardLayout`** in **`data-view-dashboard-charts.tsx`** (wrap storage API).
+- **One bundle:** **`lib/data-view-dashboard-storage.ts`** — key **`exxat-ds:data-view-dashboards:v1`**. Each hub registers under a scope string (e.g. **`library`**); add new scopes there, never invent a sibling `localStorage` key.
+- Hub-side: pair **`loadDataViewLayout`** + **`saveDataViewLayout`** with **`mergeDashboardLayoutGeneric`** (`lib/dashboard-layout-merge.ts`) for default-layout safety. Reference: the Library dashboard wiring inside **`library-table.tsx`** + **`library-dashboard-charts.tsx`**.
 - **MUST NOT** introduce parallel **`localStorage`** keys for the same **`DashboardLayout`** shape without updating the storage module.
 
 ## SHOULD — coach marks
@@ -47,7 +47,7 @@ alwaysApply: true
 
 ## Reference files
 
-- `components/data-view-dashboard-charts.tsx` (Placements)
-- `components/data-view-dashboard-charts-team.tsx`, `data-view-dashboard-charts-compliance.tsx`
-- `components/data-list-table.tsx` — `DataListDashboardShell`
+- `components/library-dashboard-charts.tsx` — canonical Data-tab dashboard section (`LibraryDashboardChartsSection`) — chart cards, `MetricsCard`, layout-edit toolbar.
+- `components/library-table.tsx` — dashboard tab body wires `LibraryDashboardChartsSection` + layout-edit toolbar inline (no separate `DashboardShell` component).
+- `components/charts-overview.tsx` — full-page dashboard chart gallery referenced from `app/(app)/dashboard/page.tsx`.
 - `lib/chart-keyboard-selection.ts`, `lib/data-view-dashboard-storage.ts`, `lib/dashboard-customize-coach-mark.ts`

package/template/.cursor/rules/exxat-data-tables.mdc

@@ -7,16 +7,16 @@ alwaysApply: true
 
 ## Use one stack for product data lists
 
-For **any app screen that shows a browsable, filterable grid of records** (lists, directories, placements, etc.):
+For **any app screen that shows a browsable, filterable grid of records** (directories, tokens, columns showcase, question banks, etc.):
 
 1. **Base table:** `DataTable` from `@/components/data-table` (optionally wrapped with `DataTablePaginated` when pagination is required).
 2. **Search:** Wire the table’s search/query UX (toolbar search or equivalent) — do not ship a “bare” table without find-in-list behavior when the page is a data list.
 3. **Filters:** Use the shared filter model (filter chips / `FilterFieldDef` and operators) consistent with existing list pages — not one-off filter UIs that bypass the table stack.
-4. **Table properties:** Include **Table properties** via `TablePropertiesDrawer` from `@/components/table-properties/drawer` (or the same toolbar + drawer pattern used on reference pages such as placements / data list). Users must be able to adjust columns, density, and related table settings from one place.
+4. **Table properties:** Include **Table properties** via `TablePropertiesDrawer` from `@/components/table-properties/drawer` (or the same toolbar + drawer pattern used on the reference pages — `library-table.tsx`, `columns-showcase.tsx`, `tokens-themes-client.tsx`). Users must be able to adjust columns, density, and related table settings from one place.
 5. **Active view:** On **`ListPageTemplate`** pages with **table / list / board / dashboard** tabs, **`TablePropertiesDrawer`** **MUST** receive **`currentView`** and **`onViewChange`** (see **`./AGENTS.md` §4.2** and **`.cursor/rules/exxat-table-properties-drawer.mdc`**) so Properties matches the selected view (not table-only copy on Board).
 6. **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”).
 
-**Reference implementation:** `components/data-list-table.tsx` (placements) shows how `DataTable`, filters, and `TablePropertiesDrawer` compose together.
+**Reference implementations:** `components/library-table.tsx` (full hub: table / board / dashboard, conditional rules, bulk actions), `components/columns-showcase.tsx` (catalog hub composing every `table-cells.tsx` primitive — built-in pagination via `HubTable`), and `components/tokens-themes-client.tsx` (table + secondary-panel category rail). Each shows how `HubTable`, filters, and `TablePropertiesDrawer` compose together.
 
 ## Do not
 

package/template/.cursor/rules/exxat-ds-agents.mdc

@@ -10,9 +10,9 @@ alwaysApply: true
 ## Non‑negotiables (if anything conflicts, open AGENTS.md §12–§13)
 
 1. **Product data lists** → `DataTable` + search + shared filters + `TablePropertiesDrawer` — not raw `<table>` / ui `Table` alone / ad-hoc grids. With **`ListPageTemplate`** view tabs, pass **`currentView`** + **`onViewChange`** into **`TablePropertiesDrawer`** (**`AGENTS.md` §4.2**, **`.cursor/rules/exxat-table-properties-drawer.mdc`**).
-2. **Main `DataTable` surface** → wrapped in **`ListPageTemplate`** (view tabs). All tab view types share **`useTableState`**; list/board/dashboard read **`tableState.rows`**. Reference: `DataListClient`, `TeamClient`, `TeamTable`.
+2. **Main `DataTable` surface** → wrapped in **`ListPageTemplate`** (view tabs). All tab view types share **`useTableState`**; list/board/dashboard read **`tableState.rows`**. Reference: `PlacementsClient`, `TeamClient`, `TeamTable`.
 3. **Do not double-indent** the toolbar/table — avoid extra `px`/`mx` wrappers around `DataTable` when it already applies horizontal inset.
-4. **Primary hub + large/complex data** → same composition as Placements/Team: `ListPageTemplate` + metrics/export pattern as in `DataListClient` / `TeamClient`, not `PageHeader`-only.
+4. **Primary hub + large/complex data** → same composition as Placements/Team: `ListPageTemplate` + metrics/export pattern as in `PlacementsClient` / `TeamClient`, not `PageHeader`-only.
 5. **Exportable pages** → filled primary CTA; **⋯** menu with Export → `ExportDrawer` pattern (see `PlacementsPageHeader`).
 6. **Keyboard hints** → `.cursor/rules/exxat-kbd-shortcuts.mdc`; pair hints with behavior.
 7. **Accessibility** → `.cursor/rules/exxat-accessibility.mdc` + **`AGENTS.md` §8** + `.cursor/skills/exxat-accessibility/SKILL.md` when present in your workspace.

package/template/.cursor/rules/exxat-kbd-shortcuts.mdc

@@ -24,7 +24,7 @@ Use `@/components/ui/kbd` (`Kbd` + `KbdGroup`) anywhere users discover actions b
    | Inside a `DropdownMenuItem` via `shortcut=` | menu handles it — pass the chord string |
    | Standalone helper text on a surface | **default `tile`** |
 
-   Glue multi-key chords into **one** bare kbd (`<Kbd variant="bare">⌘⌥K</Kbd>`), not one tile per key. See `new-placement-form.tsx` (Next = `{mod}⏎`, Back = `{mod}{alt}←`) and the primary "Ask Leo" button inside chart insight popovers.
+   Glue multi-key chords into **one** bare kbd (`<Kbd variant="bare">⌘⌥K</Kbd>`), not one tile per key. See `new-library-item-form.tsx` (Next = `{mod}⏎`, Back = `{mod}{alt}←`) and the primary "Ask Leo" button inside chart insight popovers.
 
 1. **Pair hint with behavior** — If `Kbd` shows a chord, implement the same shortcut. **Preferred:** the shared primitives from `@/components/ui/dropdown-menu`:
 
@@ -58,8 +58,8 @@ Use `@/components/ui/kbd` (`Kbd` + `KbdGroup`) anywhere users discover actions b
 | Toggle main sidebar | ⌘/Ctrl + **B** (`components/ui/sidebar.tsx`) |
 | Table search | ⌘/Ctrl + **K** (no Alt — `DataTable`) |
 | Ask Leo | ⌘/Ctrl + **⌥/Alt** + **K** |
-| New placement (Placements header) | ⌘/Ctrl + **⌥/Alt** + **N** |
-| Placements overflow menu | ⌘/Ctrl + **⌥/Alt** + **M** |
+| New record (primary hub header) | ⌘/Ctrl + **⌥/Alt** + **N** |
+| Hub overflow menu (⋯) | ⌘/Ctrl + **⌥/Alt** + **M** |
 | Export | ⌘/Ctrl + **⇧/Shift** + **E** |
 | Hide/Show metric section | ⌘/Ctrl + **⌥/Alt** + **H** |
 | Rename (view, tab) | **F2** |
@@ -79,14 +79,14 @@ Every **workflow surface** (form, dialog, drawer, sheet, multi-step wizard final
 1. **Primary action (submit/commit)** — **Enter** (⏎). Render the `<Kbd>⏎</Kbd>` **inline inside the button** (after the label, inside a `<KbdGroup className="ml-1.5">`) — NOT inside a hover `Tip`. Primary/secondary workflow buttons must expose the shortcut at rest so it is discoverable without hovering. Pair with a `<Shortcut keys="Enter" onInvoke={...}>` mounted while the surface is open. The shared `useShortcut` hook skips events from inputs/textarea/contenteditable, so Enter inside a text field still types normally — it only fires when focus is on the surface chrome.
 2. **Secondary action (Cancel/Dismiss)** — **Esc**. Inline `<Kbd>Esc</Kbd>` inside the Cancel button (same `ml-1.5` pattern). Radix `Dialog` / `Sheet` / `AlertDialog` already bind Esc natively.
 
-> Tip-on-hover Kbd hints remain correct for **page-level** actions (e.g. "New placement", ⋯ overflow triggers) where the button is part of dense page chrome and a persistent Kbd would crowd the layout. Workflow buttons inside a form/drawer/dialog are spacious enough to render the Kbd inline.
+> Tip-on-hover Kbd hints remain correct for **page-level** actions (e.g. primary "New …" CTA, ⋯ overflow triggers) where the button is part of dense page chrome and a persistent Kbd would crowd the layout. Workflow buttons inside a form/drawer/dialog are spacious enough to render the Kbd inline.
 
 **Variant inside a button:** always use `<Kbd variant="bare">` — no background, no border, inherits `currentColor` at 70% opacity. The default tile variant looks like a pasted-on patch on filled primary buttons. Glue multi-key chords into one `<Kbd variant="bare">⌘⌥←</Kbd>` rather than one tile per key.
 3. **Multi-step wizards** — plain **Enter** must NOT submit on intermediate steps (it would auto-close the review/final step when users hit Enter inside an input). Either:
    - Gate `form.onSubmit` on `step === lastStep` (`if (step !== N) { e.preventDefault(); return }`), **or**
    - Remove `type="submit"` on intermediate Next buttons and bind **⌘Enter** to "Next" via `<Shortcut>`.
    On the final step, plain **Enter** submits and the Kbd hint shows **⏎**.
-4. Examples in-app: `new-placement-form.tsx` (Create placement = Enter on step 5, Back = ⌘⌥←), `export-drawer.tsx` (Export = Enter, Cancel = Esc).
+4. Examples in-app: `new-library-item-form.tsx` (Create = Enter on the final step, Back = ⌘⌥←), `export-drawer.tsx` (Export = Enter, Cancel = Esc).
 
 ## Every action menu MUST carry shortcuts
 
@@ -96,5 +96,5 @@ Adjust this table when adding new global shortcuts.
 
 ## See also
 
-- **`exxat-ds/AGENTS.md`** §7 — keyboard rules in project context.
-- **`exxat-ds/AGENTS.md`** §7.1 — global command palette (⌘K) vs **Ask Leo** (**⌘⌥K**); **`exxat-ds/docs/command-menu-pattern.md`**.
+- **`apps/web/AGENTS.md`** §7 — keyboard rules in project context.
+- **`apps/web/AGENTS.md`** §7.1 — global command palette (⌘K) vs **Ask Leo** (**⌘⌥K**); **`apps/web/docs/command-menu-pattern.md`**.

package/template/.cursor/rules/exxat-mono-ids.mdc

@@ -16,7 +16,7 @@ Use this when rendering **system identifiers** — values a user copies, searche
 
 ## SHOULD
 
-- Match existing hubs: **`question-bank-table.tsx`**, **`question-bank-list-view.tsx`**, **`new-question-composer.tsx`** (header subtitle), **`sites-table.tsx`** (`row.id`).
+- Match existing hubs: **`library-table.tsx`**, **`columns-showcase.tsx`** (mono record IDs in the showcase row), **`new-library-item-form.tsx`** (header subtitle).
 - Prefer **`truncate`** / **`min-w-0`** on mono IDs in tight layouts so long tokens do not blow out columns.
 
 ## MUST NOT

package/template/.cursor/rules/exxat-page-vs-drawer.mdc

@@ -13,7 +13,7 @@ alwaysApply: true
 ## Product examples (this repo)
 
 - **Drawer-appropriate:** `TablePropertiesDrawer`, `ExportDrawer`, lightweight panels that supplement a hub.
-- **Page-appropriate:** Full placement or settings flows that are the main task, multi-screen wizards.
+- **Page-appropriate:** Full settings flows, multi-step record-creation wizards (e.g. `new-library-item-form.tsx`), or any task that is itself the user's primary intent.
 
 ## Authoritative detail
 

package/template/.cursor/rules/exxat-table-properties-drawer.mdc

@@ -28,7 +28,7 @@ When **`ListPageTemplate`** drives **`tab.viewType`** and the page renders **`Ta
 
 3. Thread **`view`** and **`onViewChange`** through: **client → table component → drawer toolbar → `TablePropertiesDrawer`**.
 
-**Reference implementations:** `components/data-list-table.tsx` (`DataListTable`), `components/team-client.tsx` + `team-table.tsx`, `components/compliance-client.tsx` + `compliance-table.tsx`.
+**Reference implementations:** `components/library-hub-client.tsx` + `library-table.tsx` (full hub: table / board / dashboard, conditional rules, bulk actions), `components/columns-showcase.tsx` (single-table catalog + built-in pagination via `HubTable`), `components/tokens-themes-client.tsx` (table + `SecondaryPanel` category rail).
 
 ## MUST NOT