@payfit/unity-components 3.6.10 → 3.6.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payfit/unity-components",
-  "version": "3.6.10",
+  "version": "3.6.12",
   "module": "./dist/esm/index.js",
   "type": "module",
   "sideEffects": false,
@@ -103,7 +103,7 @@
     "@formatjs/intl": "4.1.12",
     "@internationalized/date": "3.12.4",
     "minimatch": "10.2.5",
-    "@payfit/unity-illustrations": "3.6.10",
+    "@payfit/unity-illustrations": "3.6.12",
     "@radix-ui/react-avatar": "1.2.6",
     "@radix-ui/react-slot": "1.3.3",
     "@react-aria/interactions": "3.28.1",
@@ -132,8 +132,8 @@
     "zod": "4.6.5"
   },
   "peerDependencies": {
-    "@payfit/unity-icons": "3.6.10",
-    "@payfit/unity-themes": "3.6.10",
+    "@payfit/unity-icons": "3.6.12",
+    "@payfit/unity-themes": "3.6.12",
     "@storybook/react-vite": "^10",
     "@tanstack/react-query": "^5",
     "@tanstack/form-core": "1.33.5",
@@ -156,9 +156,9 @@
     "@payfit/storybook-addon-console-errors": "0.0.0-use.local",
     "@payfit/storybook-addon-datadog-rum": "0.0.0-use.local",
     "@payfit/storybook-config": "0.0.0-use.local",
-    "@payfit/unity-icons": "3.6.10",
-    "@payfit/unity-illustrations": "3.6.10",
-    "@payfit/unity-themes": "3.6.10",
+    "@payfit/unity-icons": "3.6.12",
+    "@payfit/unity-illustrations": "3.6.12",
+    "@payfit/unity-themes": "3.6.12",
     "@payfit/vite-configs": "0.0.0-use.local",
     "@storybook/addon-a11y": "10.6.0",
     "@storybook/addon-designs": "11.1.4",

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

@@ -7,17 +7,20 @@ description: >
 metadata:
   type: core
   library: '@payfit/unity-components'
-  library_version: '2.x'
+  library_version: '3.x'
 sources:
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/data-table/DataTable.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/data-table/parts/DataTableRoot.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/data-table/parts/DataTableBulkActions.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/table/Table.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/filter-toolbar/FilterToolbar.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/filter/Filter.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/docs/guides/data/Building Tables.mdx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-table/components/data-table/DataTable.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-table/components/data-table/parts/DataTableRoot.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-table/components/data-table-bulk-actions/DataTableBulkActions.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/table/Table.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/filter-toolbar/FilterToolbar.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/filter/Filter.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-table/docs/guides/Building Tables.mdx'
 ---
 
+This skill targets the current workspace Unity v3 API. Legacy examples are
+migration context.
+
 DataTable is the composite (Tanstack Table + Unity Table + pagination + empty
 states + virtualization). Table is the primitive — use only when you have no
 table state to manage.

package/skills/unity-layout/SKILL.md

@@ -8,16 +8,19 @@ description: >
 metadata:
   type: core
   library: '@payfit/unity-components'
-  library_version: '2.x'
+  library_version: '3.x'
 sources:
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/page/Page.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/page/parts/PageHeader.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/page/parts/PageHeading.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/flex/Flex.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/grid/Grid.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/text/Text.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/page/Page.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/page/parts/PageHeader.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/page/parts/PageHeading.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/flex/Flex.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/grid/Grid.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/text/Text.tsx'
 ---
 
+This skill targets the current workspace Unity v3 API. Legacy examples are
+migration context.
+
 Compose structure with the layout and typography primitives exported by
 `@payfit/unity-components`.
 

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

@@ -7,13 +7,16 @@ description: >
 metadata:
   type: lifecycle
   library: '@payfit/unity-components'
-  library_version: '2.x'
+  library_version: '3.x'
 sources:
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/tooltip/Tooltip.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/button/Button.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/tooltip/Tooltip.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/button/Button.tsx'
   - 'PayFit/hr-apps:AGENTS.md'
 ---
 
+This skill targets the current workspace Unity v3 API. Legacy examples are
+migration context.
+
 Convert a legacy `@payfit/midnight` screen to Unity. The table below
 covers the highest-traffic mappings; the exhaustive ~85-row map lives
 in `references/midnight-component-map.md`. When a Midnight component is
@@ -73,7 +76,8 @@ Unity enforces several WCAG rules that Midnight allowed:
 Midnight-era screens commonly use React Hook Form. When porting, replace
 the form with `useTanstackUnityForm` and the Tanstack-bound `*Field`
 components (`TextField`, `SelectField`, `NumberField`, etc.). The legacy RHF
-`useUnityForm` + `*Field` wrappers in the same package index are deprecated.
+`useUnityForm` + RHF `*Field` wrappers were removed in Unity v3. Import
+`useTanstackUnityForm` from `@payfit/unity-components/forms`.
 Do not pause on the RHF intermediate step. See `unity-tanstack-form`.
 
 ## Common Mistakes
@@ -106,7 +110,7 @@ rule that disabled controls must not have tooltips because they are not
 keyboard-focusable, so the tooltip is unreachable — Unity's `Tooltip`
 component rejects this pairing at the library level.
 
-Source: libs/shared/unity/components/src/components/tooltip/Tooltip.tsx
+Source: libs/shared/unity/components/src/core/components/tooltip/Tooltip.tsx
 
 ### HIGH Assume Midnight props map 1:1 to Unity
 
@@ -130,7 +134,7 @@ Correct:
 still type-checks on the underlying DOM node but bypasses React Aria's
 touch and keyboard press handling, so keyboard activations silently no-op.
 
-Source: libs/shared/unity/components/src/components/button/Button.tsx
+Source: libs/shared/unity/components/src/core/components/button/Button.tsx
 
 ### MEDIUM Leave Midnight + Unity side-by-side in the same screen
 

package/skills/unity-migrate-from-midnight/references/midnight-component-map.md

@@ -64,18 +64,19 @@ look like a link.
 
 ## Form structure
 
-| Midnight   | Unity       | Note                                                             |
-| ---------- | ----------- | ---------------------------------------------------------------- |
-| `Field`    | `FormField` | Wrapper with `FormLabel` / `FormHelperText` / `FormFeedbackText` |
-| `FieldSet` | `Fieldset`  | Casing change (`FieldSet` → `Fieldset`)                          |
-| `Form`     | `Form`      | Pair with `useTanstackUnityForm` — see `unity-tanstack-form`     |
+| Midnight   | Unity         | Note                                                                                        |
+| ---------- | ------------- | ------------------------------------------------------------------------------------------- |
+| `Field`    | `field.Field` | Bound wrapper with `field.FieldLabel` / `field.FieldHelperText` / `field.FieldFeedbackText` |
+| `FieldSet` | `Fieldset`    | Casing change (`FieldSet` → `Fieldset`)                                                     |
+| `Form`     | `form.Form`   | Inside `form.AppForm` — see `unity-tanstack-form`                                           |
 
 ## Form inputs
 
 > Form-bound usage is via Tanstack form (`useTanstackUnityForm`), where
 > Unity components are exposed as `<field.*>` after wiring the form
-> hook. Top-level `*Field` exports use the deprecated RHF binding and
-> will be removed — see `unity-tanstack-form` for the supported path.
+> hook imported from `@payfit/unity-components/forms`. The legacy RHF
+> hook and field wrappers were removed in v3 — see `unity-tanstack-form`
+> for the supported path.
 > The "Unity" column below names the component; how to bind it lives in
 > that skill.
 

package/skills/unity-navigation/SKILL.md

@@ -7,17 +7,20 @@ description: >
 metadata:
   type: core
   library: '@payfit/unity-components'
-  library_version: '2.x'
+  library_version: '3.x'
 sources:
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/link/RawLink.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/breadcrumbs/Breadcrumbs.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/pagination/Pagination.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/tabs/Tabs.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/integrations/tanstack-router/index.ts'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/providers/router/RouterProvider.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/docs/concepts/navigation/Navigation Patterns Explained.mdx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/link/RawLink.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/breadcrumbs/Breadcrumbs.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/pagination/Pagination.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/tabs/Tabs.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-router/index.ts'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/providers/router/RouterProvider.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-router/docs/concepts/Navigation Patterns Explained.mdx'
 ---
 
+This skill targets the current workspace Unity v3 API. Legacy examples are
+migration context.
+
 Two entry points expose the same components in two flavors. The base entry
 (`@payfit/unity-components`) ships router-agnostic `Raw*` primitives that take
 a plain `href`. The Tanstack integration entry
@@ -103,7 +106,7 @@ import { Link } from '@payfit/unity-components/integrations/tanstack-router'
 
 The base export "Link" does not exist; agents alias RawLink and pass to=. The prop is silently ignored and the link does not navigate.
 
-Source: integrations/tanstack-router/components/link/Link.tsx (createLink wraps RawLink)
+Source: src/modules/tanstack-router/components/link/Link.tsx (createLink wraps RawLink)
 
 ### HIGH Pass to= prop to RawLink
 
@@ -126,7 +129,7 @@ import { Link } from '@payfit/unity-components/integrations/tanstack-router'
 
 RawLink only accepts href. The to prop is silently ignored.
 
-Source: components/link/RawLink.tsx:113-163
+Source: src/core/components/link/RawLink.tsx
 
 ### HIGH Expect the v1 monolithic Pagination
 
@@ -156,7 +159,7 @@ import { Pagination, PaginationContent, PaginationItem, RawPaginationLink }
 
 v2 Pagination is compositional; passing currentPage/pageCount with no children renders an empty container. The old monolithic component (ClientSidePagination) now lives only inside DataTable as an internal — there is no public monolithic export. For standalone pagination, compose it yourself; for paginated tables, use DataTable which has it built in.
 
-Source: components/pagination/Pagination.tsx; index.ts
+Source: src/core/components/pagination/Pagination.tsx; index.ts
 
 ### MEDIUM Forget to wrap BreadcrumbLink in Breadcrumb
 
@@ -180,7 +183,7 @@ Correct:
 
 Breadcrumbs filters children to Breadcrumb type; loose BreadcrumbLinks are dropped silently.
 
-Source: components/breadcrumbs/Breadcrumbs.tsx:328-407
+Source: src/core/components/breadcrumbs/Breadcrumbs.tsx
 
 ### MEDIUM Use Raw\* components without RouterProvider in a non-Tanstack app
 
@@ -207,7 +210,7 @@ Correct:
 
 Raw\* components consume useRouter() context. Without RouterProvider, isActive checks return undefined and active-link styling is lost.
 
-Source: components/link/RawLink.tsx:186; providers/router/RouterProvider.tsx
+Source: src/core/components/link/RawLink.tsx; src/core/providers/router/RouterProvider.tsx
 
 ## See also
 

package/skills/unity-overlays/SKILL.md

@@ -7,17 +7,20 @@ description: >
 metadata:
   type: core
   library: '@payfit/unity-components'
-  library_version: '2.x'
+  library_version: '3.x'
 sources:
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/dialog/Dialog.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/side-panel/SidePanel.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/tooltip/Tooltip.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/popover/Popover.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/menu/Menu.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/promo-dialog/PromoDialog.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/bottom-sheet/BottomSheet.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/dialog/Dialog.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/side-panel/SidePanel.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/tooltip/Tooltip.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/popover/Popover.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/menu/Menu.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/promo-dialog/PromoDialog.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/core/components/bottom-sheet/BottomSheet.tsx'
 ---
 
+This skill targets the current workspace Unity v3 API. Legacy examples are
+migration context.
+
 ## Setup
 
 Overlays do not require a global provider. Each overlay owns its open state
@@ -103,7 +106,7 @@ Correct:
 
 Unity enforces the WCAG rule that disabled controls must not carry tooltips (the disabled element is not keyboard-focusable, so the tooltip is unreachable). This is enforced at the library level, not just policy.
 
-Source: components/tooltip/Tooltip.tsx
+Source: src/core/components/tooltip/Tooltip.tsx
 
 ### MEDIUM Use Dialog for a non-blocking hint
 
@@ -131,7 +134,7 @@ Correct:
 
 Dialog is modal (focus trap, scroll lock, backdrop) — heavy for a simple informational popover.
 
-Source: components/dialog/Dialog.tsx:162-196 (ModalOverlay)
+Source: src/core/components/dialog/Dialog.tsx (ModalOverlay)
 
 ### MEDIUM Use Tooltip for interactive content
 
@@ -166,7 +169,7 @@ Correct:
 
 Tooltip is display-only; placing interactive elements inside breaks focus and event handling.
 
-Source: components/tooltip/Tooltip.tsx (no interactive support); components/menu/Menu.tsx
+Source: src/core/components/tooltip/Tooltip.tsx (no interactive support); src/core/components/menu/Menu.tsx
 
 ### MEDIUM Fight the modal focus trap with custom useEffect focus moves
 
@@ -189,7 +192,7 @@ Correct:
 
 Dialog manages focus and restoration via React Aria. Calling triggerRef.focus() inside a useEffect produces unpredictable jumps.
 
-Source: components/dialog/Dialog.tsx:162-196
+Source: src/core/components/dialog/Dialog.tsx
 
 ### MEDIUM PromoDialog without PromoDialogHero
 
@@ -216,7 +219,7 @@ Correct:
 
 PromoDialog validates at render and console.errors if the hero is missing; dialog still renders but the layout breaks.
 
-Source: components/promo-dialog/PromoDialog.tsx:230-236 (console.error guard)
+Source: src/core/components/promo-dialog/PromoDialog.tsx (console.error guard)
 
 ## See also
 

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

@@ -7,23 +7,29 @@ description: >
 metadata:
   type: core
   library: '@payfit/unity-components'
-  library_version: '2.x'
+  library_version: '3.x'
 sources:
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/hooks/use-tanstack-form.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/hooks/use-form.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/form/TanstackForm.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/components/form-field/TanstackFormField.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/adapters/zodAdapter.ts'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/utils/field-revalidate-logic.ts'
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/docs/concepts/forms/Form Architecture Overview.mdx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-form/hooks/use-tanstack-form.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/docs/guides/migration/Migrating from 2.x to 3.x.mdx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-form/components/form/TanstackForm.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-form/components/form-field/TanstackFormField.tsx'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-form/adapters/zodAdapter.ts'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-form/utils/field-revalidate-logic.ts'
+  - 'PayFit/hr-apps:libs/shared/unity/components/src/modules/tanstack-form/docs/concepts/Form Architecture Overview.mdx'
 ---
 
-Build a Unity form with `useTanstackUnityForm` + Zod. RHF (`useUnityForm`) is deprecated and will be removed.
+This skill targets the current workspace Unity v3 API. Legacy examples are
+migration context.
+
+Build a Unity v3 form with `useTanstackUnityForm` + Zod. The legacy RHF
+integration (`useUnityForm`) was removed in v3; the wrong example below is
+historical migration context, not a supported API.
 
 ## Setup
 
 ```tsx
-import { Button, useTanstackUnityForm } from '@payfit/unity-components'
+import { Button } from '@payfit/unity-components'
+import { useTanstackUnityForm } from '@payfit/unity-components/forms'
 import { z } from 'zod'
 
 const schema = z.object({
@@ -86,17 +92,16 @@ const { methods, Form, FormField } = useUnityForm(schema)
 Correct:
 
 ```tsx
-import { useTanstackUnityForm } from '@payfit/unity-components'
+import { useTanstackUnityForm } from '@payfit/unity-components/forms'
 
 const form = useTanstackUnityForm({ validators: { onBlur: schema } })
 ```
 
-The legacy `use-form` hook is `@deprecated` but still exported; agents trained on older code reach for it and end up mixing RHF Controller with Tanstack field components, which breaks at runtime.
-
-The legacy hook remains exported for compatibility but is deprecated. Do not
-author new code with it.
+The legacy `useUnityForm` hook and RHF field wrappers were removed in v3.
+Replace them with `useTanstackUnityForm` and its bound `field.*` components;
+do not mix RHF Controller with Tanstack field components.
 
-Source: libs/shared/unity/components/src/hooks/use-form.tsx:79 (@deprecated JSDoc)
+Source: libs/shared/unity/components/src/docs/guides/migration/Migrating from 2.x to 3.x.mdx (React Hook Form removal)
 
 ### CRITICAL Omit form.AppForm or form.AppField wrapping
 
@@ -124,7 +129,7 @@ Correct:
 
 `useFormContext()` and `useFieldContext()` throw without their providers; Tanstack field components silently break (cannot read property of undefined).
 
-Source: TanstackForm.tsx:36; TanstackFormField.tsx:63 (useFormContext/useFieldContext)
+Source: src/modules/tanstack-form/components/form/TanstackForm.tsx; src/modules/tanstack-form/components/form-field/TanstackFormField.tsx (useFormContext/useFieldContext)
 
 ### HIGH Subscribe to whole form state instead of a selector
 
@@ -146,7 +151,7 @@ Correct:
 
 A selector-less subscription re-renders the children on every keystroke anywhere in the form; pass a narrowing selector to scope to the slice you need.
 
-Source: use-tanstack-form.stories.tsx:251 (StateIntegration story)
+Source: src/modules/tanstack-form/hooks/use-tanstack-form.stories.tsx (StateIntegration story)
 
 ### MEDIUM Pick the wrong validation timing
 
@@ -166,7 +171,7 @@ useTanstackUnityForm({ validators: { onBlur: schema } })
 
 `onChange` fires on every keystroke (jarring) and `onSubmit` waits until submit (errors arrive too late); `onBlur` is the usual default, with `fieldRevalidateLogic` reserved for "blur until first error, then change".
 
-Source: use-tanstack-form.stories.tsx:37-40; utils/field-revalidate-logic.ts
+Source: src/modules/tanstack-form/hooks/use-tanstack-form.stories.tsx; src/modules/tanstack-form/utils/field-revalidate-logic.ts
 
 ### HIGH Mix Composed and Atomic APIs in one field (or reach for Atomic by default)
 

package/skills/unity-tanstack-form/references/bound-field-components.md

@@ -1,6 +1,6 @@
 # Bound field components (Composed API)
 
-All 15 Tanstack-bound Composed field components, registered in `src/hooks/use-tanstack-form.tsx` via `createFormHook({ fieldComponents })`. They are exposed on the render-prop `field` object inside `<form.AppField>` WITHOUT the `Tanstack` prefix (e.g. the registered `TanstackTextField` is `field.TextField`).
+All 15 Tanstack-bound Composed field components, registered in `src/modules/tanstack-form/hooks/use-tanstack-form.tsx` via `createFormHook({ fieldComponents })`. They are exposed on the render-prop `field` object inside `<form.AppField>` WITHOUT the `Tanstack` prefix (e.g. the registered `TanstackTextField` is `field.TextField`).
 
 The form-usage pattern is identical for every component:
 
@@ -64,4 +64,4 @@ Available on `form` (not `field`):
 - `<form.Subscribe selector={…}>` — selector-scoped reactive subscription. Always pass `selector`.
 - `<form.InlineFieldGroup>`, `<form.InlineFieldGroupHeader>`, `<form.InlineFieldGroupReadView>`, `<form.InlineFieldGroupEditView>` — inline edition layout (read view ↔ edit view toggling for grouped fields).
 
-For the mapping source of truth see `src/hooks/use-tanstack-form.tsx` (the `createFormHook` call). The keys in `fieldComponents` and `formComponents` are exactly the names exposed on `field` / `form`.
+For the mapping source of truth see `src/modules/tanstack-form/hooks/use-tanstack-form.tsx` (the `createFormHook` call). The keys in `fieldComponents` and `formComponents` are exactly the names exposed on `field` / `form`.

package/skills/unity-tanstack-form/references/patterns.md

@@ -55,7 +55,7 @@ Reach for Atomic when you need to interleave custom content between the label an
 `validators.onBlur` is the default; use `onChange` only for fields that need live feedback (password strength meter, search-as-you-type). `fieldRevalidateLogic` gives "blur until first error, then change" UX without polluting form-level validators.
 
 ```tsx
-import { fieldRevalidateLogic, useTanstackUnityForm } from '@payfit/unity-components'
+import { fieldRevalidateLogic, useTanstackUnityForm } from '@payfit/unity-components/forms'
 
 const form = useTanstackUnityForm({
   defaultValues: { email: '', password: '' },

package/skills/unity-tanstack-form/references/schema-adapters.md

@@ -1,6 +1,6 @@
 # Schema adapters
 
-Schema adapters give the form-field organisms a uniform way to ask "is this path required?" across schemas authored in Zod 3, Zod 4, or any Standard Schema v1 implementation. Source: `src/adapters/`.
+Schema adapters give the form-field organisms a uniform way to ask "is this path required?" across schemas authored in Zod 3, Zod 4, or any Standard Schema v1 implementation. Source: `src/modules/tanstack-form/adapters/`.
 
 ## Common interface
 
@@ -31,7 +31,7 @@ new ZodV3SchemaAdapter(schema: z3.ZodObject<z3.ZodRawShape>)
 
 - Reads structure from `schema.shape` and `field._def.typeName`.
 - Detects optional with `field instanceof z3.ZodOptional`; unwraps via `field._def.innerType`.
-- Source: `src/adapters/zodAdapter.ts` (lines 6–60).
+- Source: `src/modules/tanstack-form/adapters/zodAdapter.ts` (lines 6–60).
 
 ### ZodV4SchemaAdapter
 
@@ -43,7 +43,7 @@ new ZodV4SchemaAdapter(schema: z4.ZodObject<z4.ZodRawShape>)
 
 - Same shape traversal as v3, but uses `field.def.innerType` and `field.def.typeName` (no underscore — Zod 4 renamed `_def` to `def`).
 - `field instanceof z4.ZodOptional` for optionality detection.
-- Source: `src/adapters/zodAdapter.ts` (lines 62–117).
+- Source: `src/modules/tanstack-form/adapters/zodAdapter.ts` (lines 62–117).
 
 ### StandardSchemaAdapter
 
@@ -55,14 +55,14 @@ new StandardSchemaAdapter(standardSchema: StandardSchemaV1)
 
 - Stub implementation: `getField()` returns `{ isOptional: false, type: 'unknown', shape: undefined }` for any non-null path. Standard Schema's spec does not expose enough internal structure for richer introspection.
 - Use this only for schemas that aren't Zod (e.g. Valibot, ArkType) — required-field inference will degrade to "always required".
-- Source: `src/adapters/standardSchemaAdapter.ts`.
+- Source: `src/modules/tanstack-form/adapters/standardSchemaAdapter.ts`.
 
 ## How adapters auto-select
 
-`createSchemaAdapter(schema)` (in `src/utils/createSchemaAdapter.ts`) picks an adapter from the schema's structural fingerprint:
+`createSchemaAdapter(schema)` (in `src/modules/tanstack-form/utils/createSchemaAdapter.ts`) picks an adapter from the schema's structural fingerprint:
 
 ```ts
-import { createSchemaAdapter } from '@payfit/unity-components'
+import { createSchemaAdapter } from '@payfit/unity-components/forms'
 
 const adapter = createSchemaAdapter(schema)
 // schema._def && 'def' in schema           → ZodV4SchemaAdapter