@exxatdesignux/ui 0.5.2 → 0.5.3

package/template/docs/hub-supported-views-pattern.md

@@ -0,0 +1,53 @@
+# Hub supported views pattern (Add view parity)
+
+> **Agents:** `.cursor/rules/exxat-hub-supported-views.mdc` (binding). **Reference hub:** Library / All questions (`library-table.tsx`, `library-client.tsx`).
+
+## Problem this solves
+
+`ListPageTemplate` filters **Add view** and Properties view tiles from `supportedViewTypes`. If Column types passes four views but Library passes seven, users see inconsistent menus. If a hub allows Board but has no `board-with-toolbar` renderer, users see **“does not implement Board view”**.
+
+## Canonical allowlist
+
+Import from the registry (single source of truth):
+
+```ts
+import { FULL_HUB_SUPPORTED_VIEWS } from "@/lib/data-list-view-registry"
+// or
+import { LIBRARY_SUPPORTED_VIEWS } from "@/lib/library-supported-views" // alias of FULL
+```
+
+Seven views: **table**, **list**, **board**, **dashboard**, **folder**, **panel**, **tree-panel**.
+
+`HubTable` and `ListPageTemplate` use this list when `supportedViewTypes` is omitted.
+
+`PRIMARY_HUB_SUPPORTED_VIEWS` (four views) remains for hubs that intentionally omit folder/panel/tree — document that in `lib/<entity>-supported-views.ts`.
+
+## Wiring checklist
+
+1. **`ListPageTemplate`** — `supportedViewTypes={FULL_HUB_SUPPORTED_VIEWS}` (or entity alias).
+2. **`HubTable`** — same allowlist (or omit on both).
+3. **List** — `renderListRow` returning **`ListPageBoardCard`** `layout="row"` (copy from `library-table.tsx`).
+4. **Board** — `renderBoardCard` + `boardGroups` and/or `renderers["board-with-toolbar"]`.
+5. **Dashboard** — `renderers["dashboard-with-toolbar"]` with **`KeyMetrics`** on filtered rows.
+6. **Folder / panel / tree** — explicit `renderers` entries (Library reference) or **`LibraryTable`** for `LibraryItem` rows.
+
+## Special cases in this app
+
+| Hub | Pattern |
+|-----|---------|
+| **Library / All questions** | `LibraryTable` + `LIBRARY_SUPPORTED_VIEWS` — reference |
+| **Column types** | `LibraryTable` with `columnDefs` + `hubLabels` + `DEFAULT_LIBRARY_FOLDERS` — custom table, shared other views |
+| **Tokens & themes** | `FULL_HUB_SUPPORTED_VIEWS` + `tokens-hub-auxiliary-views.tsx` |
+| **New entity hub** | Start from `library-table.tsx` or token/columns references; never table-only unless approved |
+
+## Anti-patterns
+
+- `supportedViewTypes={["table"]}` on a `ListPageTemplate` hub.
+- `COLUMNS_SUPPORTED_VIEWS = PRIMARY_HUB_SUPPORTED_VIEWS` without board/folder/panel/tree renderers.
+- Minimal `renderListRow` with only stem + `questionId` (not product list UI).
+
+## See also
+
+- `packages/ui/src/lib/data-list-view-registry.ts`
+- `apps/web/docs/data-views-pattern.md`
+- `apps/web/lib/hub-connected-view-renderers.ts` — `defineHubViewRenderers` dev warnings

package/template/docs/reference-implementations.md

@@ -25,9 +25,9 @@ If you find yourself diverging from the reference page, ask **why** before shipp
 | Full hub: table + board + dashboard + list + paginated + conditional rules + dashboard customize | `apps/web/components/library-table.tsx` + `library-hub-client.tsx` | [`list-page-template`](./blueprints/list-page-template.md), [`data-table`](./blueprints/data-table.md), [`board-card`](./blueprints/board-card.md), [`key-metrics`](./blueprints/key-metrics.md) | [`exxat-data-tables`](../../../.cursor/rules/exxat-data-tables.mdc), [`exxat-list-page-connected-views`](../../../.cursor/rules/exxat-list-page-connected-views.mdc), [`exxat-centralized-list-dataset`](../../../.cursor/rules/exxat-centralized-list-dataset.mdc) | [`data-views-pattern`](./data-views-pattern.md) |
 | Hub with secondary panel scope (folder rail) | `apps/web/components/library-hub-client.tsx` + `library-secondary-nav.tsx` | [`list-page-template`](./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`](./library-hub-header-pattern.md) |
 | Hub with secondary panel scope (URL-driven category rail) — **smallest** secondary-panel reference + built-in pagination chrome | `apps/web/components/tokens-themes-client.tsx` + `tokens-secondary-nav.tsx` | [`list-page-template`](./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`](./blueprints/list-page-template.md), [`data-table`](./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`](./blueprints/list-page-template.md), [`data-table`](./blueprints/data-table.md), [`hub-supported-views-pattern`](./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 `columns-showcase.tsx` (single-view catalog, easiest) or `tokens-themes-client.tsx` (adds a secondary panel + URL-driven scope). Move to `library-table.tsx` only when you genuinely need a board / dashboard / conditional rules.
+> **First-time hub builder:** copy **`library-table.tsx`** + **`library-client.tsx`** for seven-view wiring; use **`columns-showcase.tsx`** for custom columns on **`LibraryItem`**; use **`tokens-themes-client.tsx`** + **`tokens-hub-auxiliary-views.tsx`** for token rows. Read **`hub-supported-views-pattern.md`** before changing Add view.
 
 ---
 

package/template/lib/full-hub-supported-views.ts

@@ -0,0 +1,8 @@
+/**
+ * App-wide default view allowlist for list-page hubs (Add view + Properties).
+ * Keep in sync with `library-table.tsx` / `ListPageTemplate` / `HubTable`.
+ */
+export {
+  FULL_HUB_SUPPORTED_VIEWS,
+  PRIMARY_HUB_SUPPORTED_VIEWS,
+} from "@exxatdesignux/ui/lib/data-list-view-registry"

package/template/lib/library-supported-views.ts

@@ -1,12 +1,5 @@
-import type { DataListViewType } from "@/lib/data-list-view"
-
-/** Views implemented in `LibraryTable` — keep in sync with `ListPageConnectedViewBody` renderers. */
-export const LIBRARY_SUPPORTED_VIEWS = [
-  "table",
-  "list",
-  "board",
-  "dashboard",
-  "folder",
-  "panel",
-  "tree-panel",
-] as const satisfies readonly DataListViewType[]
+export {
+  FULL_HUB_SUPPORTED_VIEWS,
+  FULL_HUB_SUPPORTED_VIEWS as LIBRARY_SUPPORTED_VIEWS,
+  PRIMARY_HUB_SUPPORTED_VIEWS,
+} from "@exxatdesignux/ui/lib/data-list-view-registry"

package/template/package.json

@@ -9,6 +9,7 @@
   },
   "scripts": {
     "dev": "next dev --turbopack",
+    "dev:webpack": "next dev",
     "dev:3001": "next dev --turbopack -p 3001",
     "dev:3005": "next dev --turbopack -p 3005",
     "dev:daemon": "pm2 start ecosystem.config.cjs",

package/tokens/hooks-index.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.5.2",
+  "version": "0.5.3",
   "source": "packages/ui/src/globals.css",
-  "generatedAt": "2026-05-22T05:01:54.358Z",
+  "generatedAt": "2026-05-22T09:24:53.662Z",
   "tokenCount": 197,
   "themeKeys": [
     "tailwind-bridge",