@payfit/unity-components 2.48.11 → 2.48.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payfit/unity-components",
-  "version": "2.48.11",
+  "version": "2.48.12",
   "module": "./dist/esm/index.js",
   "type": "module",
   "sideEffects": false,
@@ -92,7 +92,7 @@
     "tailwind-variants": "3.2.2",
     "usehooks-ts": "3.1.1",
     "zod": "4.4.3",
-    "@payfit/unity-illustrations": "2.48.11"
+    "@payfit/unity-illustrations": "2.48.12"
   },
   "peerDependencies": {
     "@hookform/devtools": "^4",
@@ -104,8 +104,8 @@
     "react-hook-form": "^7",
     "react-router-dom": "^5",
     "zod": "^3 || ^4",
-    "@payfit/unity-icons": "2.48.11",
-    "@payfit/unity-themes": "2.48.11"
+    "@payfit/unity-icons": "2.48.12",
+    "@payfit/unity-themes": "2.48.12"
   },
   "devDependencies": {
     "@figma/code-connect": "1.4.8",
@@ -153,11 +153,11 @@
     "@payfit/hr-app-eslint": "0.0.0-use.local",
     "@payfit/hr-apps-tsconfigs": "0.0.0-use.local",
     "@payfit/storybook-addon-console-errors": "0.0.0-use.local",
-    "@payfit/unity-icons": "2.48.11",
-    "@payfit/storybook-config": "0.0.0-use.local",
-    "@payfit/unity-illustrations": "2.48.11",
+    "@payfit/unity-icons": "2.48.12",
+    "@payfit/unity-illustrations": "2.48.12",
+    "@payfit/unity-themes": "2.48.12",
     "@payfit/vite-configs": "0.0.0-use.local",
-    "@payfit/unity-themes": "2.48.11"
+    "@payfit/storybook-config": "0.0.0-use.local"
   },
   "peerDependenciesMeta": {
     "@hookform/devtools": {

package/skills/unity-data-table/SKILL.md

@@ -1,13 +1,9 @@
 ---
 name: unity-data-table
 description: >
-  Render tabular data in @payfit/unity-components. Pick between the composite
-  DataTable (Tanstack Table integration with sorting, filtering, pagination,
-  virtualization, bulk actions, F6 focus trap) and the primitive Table
-  (TableHeader/TableBody/TableRow/TableCell/TableEmptyState). Filter and
-  FilterToolbar orchestrate the AppliedFilter[] contract; Filter.renderControl
-  accepts arbitrary controls (not select-only). Columns AND data MUST be
-  memoized. manualPagination requires re-slicing data.
+  Load when rendering tabular data with Unity. Use it to choose DataTable for
+  managed table state or primitive Table for static/custom markup, including
+  filtering, pagination, virtualization, or bulk actions.
 type: core
 library: '@payfit/unity-components'
 library_version: '2.x'

package/skills/unity-find-component/SKILL.md

@@ -1,14 +1,9 @@
 ---
 name: unity-find-component
 description: >
-  Find or build the right Unity component. Catalog of ~226 named exports
-  in @payfit/unity-components grouped by purpose (layout: Flex/Grid/Card,
-  navigation: RawLink/Nav/Tabs/Breadcrumbs/Pagination, form fields:
-  TextField/SelectField/NumberField/CheckboxField/etc., buttons: Button/
-  IconButton/RawLinkButton, overlays: Dialog/Popover/Menu/Tooltip,
-  content: Pill/Badge/Alert/DataTable/Carousel). Decision tree: prefer
-  Unity → fall back to React Aria + uy:* classes → Midnight as last resort.
-  Typed UnityIcon src convention. RHF deprecated; Tanstack Form everywhere.
+  Load before choosing or creating Unity UI. Use it to map a UI need to an
+  existing @payfit/unity-components export, then fall back to React Aria plus
+  uy: classes only when Unity has no fit.
 type: core
 library: '@payfit/unity-components'
 library_version: '2.x'

package/skills/unity-layout-and-styling/SKILL.md

@@ -1,15 +1,9 @@
 ---
 name: unity-layout-and-styling
 description: >
-  Compose layouts and apply styles in @payfit/unity-components. Flex (1D)
-  and Grid (12-col 2D). Every utility class MUST use the uy: prefix
-  (uy:flex, uy:gap-100). Modifier order is uy:md:gap-200, uy:hover:bg-…,
-  uy:data-[hovered=true]:bg-… (preferred when components expose state
-  attributes). Merge classes with uyMerge, build variants with uyTv,
-  conditional class strings with cn/classNames/clsx — all from
-  @payfit/unity-themes. Use <Text variant> for typography. Verify token
-  names exist in the @theme block; do not hallucinate (uy:bg-primary-500
-  is NOT a Unity token).
+  Load when composing Unity layouts or styling with uy: Tailwind utilities.
+  Use it for Flex/Grid/Text choices, class merging/variants, and validating
+  Unity token names before adding styles.
 type: core
 library: '@payfit/unity-components, @payfit/unity-themes'
 library_version: '2.x'

package/skills/unity-migrate-from-midnight/SKILL.md

@@ -1,13 +1,9 @@
 ---
 name: unity-migrate-from-midnight
 description: >
-  Migrate a legacy screen from @payfit/midnight to Unity. Component
-  equivalency map (Button, Box→Flex, Modal→Dialog, Link→RawLink,
-  Heading→Text). Prop renames (visual→color; onClick→onPress).
-  A11y deltas Unity enforces (tooltip-on-disabled-control is rejected at
-  the library level). RHF was used in Midnight-era code; replace with
-  Tanstack Form (see unity-tanstack-form). Full ~85-row component map
-  in references/midnight-component-map.md.
+  Load when replacing @payfit/midnight UI with Unity. Use it to choose Unity
+  equivalents, avoid obsolete Midnight patterns, and route unclear component
+  mappings to unity-find-component.
 type: lifecycle
 library: '@payfit/unity-components'
 library_version: '2.x'

package/skills/unity-navigation/SKILL.md

@@ -1,16 +1,9 @@
 ---
 name: unity-navigation
 description: >
-  Pick between router-agnostic Raw* components (RawLink, RawNavItem,
-  RawBreadcrumbLink, RawPaginationLink, RawTab) in the @payfit/unity-components
-  base entry and router-aware components (Link, NavItem, BreadcrumbLink,
-  PaginationLink, Tabs) in @payfit/unity-components/integrations/tanstack-router.
-  Compositional patterns: Breadcrumbs > Breadcrumb > BreadcrumbLink;
-  Pagination > PaginationContent > PaginationItem > RawPaginationLink;
-  Tabs > TabList > RawTab + TabPanel. RouterProvider is needed for Raw*
-  components in non-Tanstack apps; the tanstack-router integration uses
-  Tanstack hooks directly. The v1 monolithic Pagination no longer exists
-  publicly — ClientSidePagination is now internal to DataTable only.
+  Load when building Unity links, tabs, breadcrumbs, nav, or pagination. Use it
+  to choose router-aware Tanstack Router components versus Raw* href
+  primitives.
 type: core
 library: '@payfit/unity-components'
 library_version: '2.x'

package/skills/unity-overlays/SKILL.md

@@ -1,13 +1,9 @@
 ---
 name: unity-overlays
 description: >
-  Use the right overlay in @payfit/unity-components. Modal (Dialog,
-  SidePanel, BottomSheet, PromoDialog) — focus trap, scroll lock, backdrop,
-  Escape closes. Non-modal (Tooltip, Popover, DefinitionTooltip, Menu) —
-  no focus trap, can coexist with page. Unity ENFORCES "no tooltip on
-  disabled control" at the library level (a11y rule that Midnight allowed).
-  PromoDialog asserts PromoDialogHero; Popover requires title; Tooltip
-  children must accept ref.
+  Load when adding Unity dialogs, side panels, bottom sheets, tooltips,
+  popovers, or menus. Use it to choose modal versus non-modal overlays and keep
+  disabled-control tooltip behavior accessible.
 type: core
 library: '@payfit/unity-components'
 library_version: '2.x'

package/skills/unity-tanstack-form/SKILL.md

@@ -1,15 +1,9 @@
 ---
 name: unity-tanstack-form
 description: >
-  Build any form in @payfit/unity-components with useTanstackUnityForm + Zod
-  (dynamic, translated). Layered wrapping: form.AppForm → form.Form →
-  form.AppField → field component. Composed API by default (TanstackTextField,
-  SelectField, NumberField, DatePickerField, CheckboxField, …); Atomic API
-  (field.Field + field.FieldLabel + field.TextInput) only when customizing
-  layout or parts. Schema adapters: StandardSchemaAdapter, ZodV3SchemaAdapter,
-  ZodV4SchemaAdapter. validators.onBlur is the default;
-  fieldRevalidateLogic for blur-then-change UX. React Hook Form
-  (useUnityForm + RHF *-field wrappers) is deprecated and will be REMOVED.
+  Load when building or migrating Unity forms. Use useTanstackUnityForm with
+  schema validation and prefer Tanstack Form field APIs for composed fields,
+  custom layouts, and validation behavior.
 type: core
 library: '@payfit/unity-components'
 library_version: '2.x'