@assure-one/design-system 1.37.0 → 1.39.0

package/README.md

@@ -16,6 +16,7 @@ The single source of truth for visual design across all Assure products.
 - [**`docs/integration/css.md`**](./docs/integration/css.md) — how an application loads our CSS: layer order, import sequence, the compatibility preset, removing `@source`, runtime brand theming.
 - [**`docs/testing.md`**](./docs/testing.md) — rendering the real package in your app's Jest tests (`@assure-one/design-system/testing`, experimental).
 - [**`docs/forms.md`**](./docs/forms.md) — building a form: `Field` + design-system controls + a Server Action + zod, reset and `required`, what each control submits, and testing it with `fillField` / `selectOption` / `pickDate`.
+- [**`docs/data-tables.md`**](./docs/data-tables.md) — building a data table: the headless `useDataTable` controller (sorting, pagination, search, selection, column visibility, filters — each controllable), server `manual` mode, and the URL-state recipe.
 - [**`docs/design-system/icons.md`**](./docs/design-system/icons.md) — the icon catalogue and its server-safe entry (`@assure-one/design-system/icons`, experimental): import an icon in a Server Component without a client boundary.
 - [**`docs/adr/010-design-system-provider.md`**](./docs/adr/010-design-system-provider.md) — the optional `DesignSystemProvider` (messages, locale, link adapter) and the `/next` entry; the quick start is [below](#the-provider-and-the-next-entry-experimental).
 - [**`claude-skills/`**](./claude-skills) — drop-in Claude Code skill for consuming projects.
@@ -52,14 +53,14 @@ Alongside it, the package now also publishes the individual stylesheets the new
 CSS mode is built from. They are **experimental**: nothing requires them yet,
 no component reads them, and importing them changes nothing on its own.
 
-| Subpath | What it is |
-| --- | --- |
-| `./css/tokens.css` | The `--ds-*` design tokens: `:root`, the colour scheme scope and the brand scopes. Usable without any component. |
-| `./css/legacy-aliases.css` | Read-aliases from today's token names to the namespaced ones (`--color-surface: var(--ds-color-surface)`), for as long as your own CSS reads design-system token names. |
-| `./css/tailwind.css` | A Tailwind `@theme` bridge, so `bg-surface/40`, `hover:text-fg-3` and `rounded-control` compile in *your* build instead of silently producing nothing. |
-| `./css/shadcn.css` | The app-vocabulary bridge: `background`, `foreground`, `primary`, `muted`, `destructive`, the radius scale and the rest, each reading one `--app-*` input you can override. |
-| `./css/base.css` | Optional document defaults: body background, ink, font and `color-scheme`. Ships no preflight, no element rules and no font import. |
-| `./css/components.css` | The component utilities compiled with Tailwind's `ds` prefix (`ds:flex`, `ds:bg-surface`), inside `@layer ds` and bound to the `--ds-*` tokens. **Unused until the class-vocabulary flip (W1-11):** no component emits a prefixed class yet, so importing it styles nothing. Published so the file, its size and its hygiene can be reviewed before the flip. |
+| Subpath                    | What it is                                                                                                                                                                                                                                                                                                                                                    |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `./css/tokens.css`         | The `--ds-*` design tokens: `:root`, the colour scheme scope and the brand scopes. Usable without any component.                                                                                                                                                                                                                                              |
+| `./css/legacy-aliases.css` | Read-aliases from today's token names to the namespaced ones (`--color-surface: var(--ds-color-surface)`), for as long as your own CSS reads design-system token names.                                                                                                                                                                                       |
+| `./css/tailwind.css`       | A Tailwind `@theme` bridge, so `bg-surface/40`, `hover:text-fg-3` and `rounded-control` compile in _your_ build instead of silently producing nothing.                                                                                                                                                                                                        |
+| `./css/shadcn.css`         | The app-vocabulary bridge: `background`, `foreground`, `primary`, `muted`, `destructive`, the radius scale and the rest, each reading one `--app-*` input you can override.                                                                                                                                                                                   |
+| `./css/base.css`           | Optional document defaults: body background, ink, font and `color-scheme`. Ships no preflight, no element rules and no font import.                                                                                                                                                                                                                           |
+| `./css/components.css`     | The component utilities compiled with Tailwind's `ds` prefix (`ds:flex`, `ds:bg-surface`), inside `@layer ds` and bound to the `--ds-*` tokens. **Unused until the class-vocabulary flip (W1-11):** no component emits a prefixed class yet, so importing it styles nothing. Published so the file, its size and its hygiene can be reviewed before the flip. |
 
 Import order is `tokens.css` → `legacy-aliases.css` (optional) → `tailwind.css`
 → `shadcn.css` (optional) → `base.css` (optional) → `components.css`, after your own
@@ -88,6 +89,21 @@ canvas, and guarantees WCAG AA for every foreground it emits. The seed shape is
 gated by decision D7 and may change while that decision is open — see
 [`docs/integration/css.md`](./docs/integration/css.md#5-runtime-brand-theming).
 
+### Brand artwork
+
+The Assure wordmarks and marks `Logo` renders ship inside the package, under
+`public/brand/`. They are served by your app, not imported, so copy them once
+into your public folder:
+
+```sh
+cp -R node_modules/@assure-one/design-system/public/brand public/brand
+```
+
+An app served from a subpath calls `setAssetBasePath("/my-base")` once before
+first render instead of (or as well as) moving the files. A `Logo` whose
+artwork does not load falls back to the brand glyph + text lockup, so nothing
+is required to get a readable lockup.
+
 ### The provider and the `/next` entry (experimental)
 
 Nothing requires a provider: every component renders English strings, formats
@@ -119,11 +135,11 @@ export default function RootLayout({ children }) {
 
 - **`messages`** — any subset of the typed catalogue `DsMessages`, by component
   namespace (`select`, `searchInput`, `combobox`, `field`, `fileUpload`; more
-  join as the overlays adopt it). Resolution is always *component prop >
-  provider > English default*, per key. The full English list is
+  join as the overlays adopt it). Resolution is always _component prop >
+  provider > English default_, per key. The full English list is
   `src/foundation/messages/en.json`; parameterised messages are functions
   (`combobox.create: (query) => string`).
-- **`locale`** — a BCP 47 tag, default `"en-US"` on the server *and* the client.
+- **`locale`** — a BCP 47 tag, default `"en-US"` on the server _and_ the client.
   Pass the locale your app already knows server-side; the design system never
   reads `navigator.language` during render, so server and client HTML agree.
 - **`linkComponent` / `imageComponent`** — what `LinkButton` and `Logo` render
@@ -136,6 +152,34 @@ export default function RootLayout({ children }) {
   the props. `toasts` mounts the toast region for `useToast()`; leave it off if
   you already render `ToastProvider`.
 
+## Lint configs for consumers
+
+Two shareable configs ship with the package (**experimental**, W7-18) so a
+product lints for the same things this repository ratchets on itself. Every
+rule is a **warning**: adopt it on the code you have, record the count, and
+ratchet it down.
+
+```js
+// eslint.config.mjs
+import ds from "@assure-one/design-system/eslint-config";
+export default [...ds.configs.recommended];
+
+// stylelint.config.mjs  (stylelint is yours — an optional peer dependency here)
+export { default } from "@assure-one/design-system/stylelint-config";
+```
+
+| Rule                                     | Reports                                                                                  |
+| ---------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `ds/no-raw-controls`                     | raw `<button>`, `<input>`, `<select>`, `<textarea>` where a design-system control exists |
+| `ds/no-radix-imports`                    | a direct `@radix-ui/*` import instead of the primitive that wraps it                     |
+| `ds/no-deep-imports`                     | an import past the published entries (`dist/…`, `src/…` — ADR-011)                       |
+| `ds/no-ds-token-redefinition`            | a `--ds-*` token set inline, outside a file under `presets/`                             |
+| `assure-ds/no-ds-token-redefinition`     | the same in CSS (stylelint; `presets/` and `*.preset.css` are exempt)                    |
+| `assure-ds/no-important-on-ds-selectors` | `!important` on a `ds:`/`data-slot` selector — pass `className`/`classNames` instead     |
+
+Raise a rule to `"error"` in your own config once you are clean. Adoption per
+app is tracked as W7-19.
+
 ## Develop
 
 ```bash
@@ -153,11 +197,11 @@ See [`CONTRIBUTING.md`](./CONTRIBUTING.md) for the full dev loop, including iter
 3-tier token system, authored as DTCG JSON in [`tokens/src`](./tokens/README.md)
 and generated into `src/tokens/` and the `./css/*` entries (ADR-003):
 
-| Tier | Example (namespaced name → value) | Reads |
-| --- | --- | --- |
-| reference | `--ds-ref-brand-pro-fg: #6c42f8` | a literal; the raw ramps, one per brand |
-| system (semantic) | `--ds-color-action-brand-bg: var(--ds-ref-brand-pro-fg)` | the reference tier; **this is the public contract** |
-| component | `--ds-menu-item-hover-bg: var(--ds-color-canvas-sunken)` | the system tier; only where a component must be themable on its own |
+| Tier              | Example (namespaced name → value)                        | Reads                                                               |
+| ----------------- | -------------------------------------------------------- | ------------------------------------------------------------------- |
+| reference         | `--ds-ref-brand-pro-fg: #6c42f8`                         | a literal; the raw ramps, one per brand                             |
+| system (semantic) | `--ds-color-action-brand-bg: var(--ds-ref-brand-pro-fg)` | the reference tier; **this is the public contract**                 |
+| component         | `--ds-menu-item-hover-bg: var(--ds-color-canvas-sunken)` | the system tier; only where a component must be themable on its own |
 
 Components consume **system tokens**, never reference values directly. Themes
 (colour scheme, per-product brand, a runtime brand from `createBrandTheme()`)

package/codemods/README.md

@@ -107,27 +107,62 @@ the list a human has to pick up — spread props, dynamic expressions, conflicti
 
 ## Codemods
 
-| Id    | Class | What it does                                                                                                                                                                  |
-| ----- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| CM-05 | A     | Button family `iconLeft` / `iconRight` → `iconStart` / `iconEnd` (pure rename; both names of one slot, spreads → "could not be transformed")                                  |
-| CM-13 | A     | `Tooltip delayMs` → `delayDuration` (pure rename, literal or dynamic value; both names, spreads → "could not be transformed")                                                 |
-| CM-07 | A     | `inputSize` → `size` on `Input`, `Textarea`, `SearchInput` (pure rename, literal or dynamic value; both names, spreads → "could not be transformed")                          |
-| CM-02 | A     | Button explicit default size: `size="md"` on every `Button`, `SubmitButton` and `LinkButton` that passes no `size` (pixel-neutral)                                            |
-| CM-04 | R     | Button family legacy `variant` → `variant` + `intent` pair (`primary` → `solid`, `destructive` → `solid` + `danger`, …); `accent`, `dashed`, dynamic → report                 |
-| CM-06 | R     | `tone` → `intent` on StatusDot, IconTile, Spinner, SegmentedProgress, SuiteProgress (`pro` → `brand`, listed for review); product hues → report                               |
-| CM-19 | R     | ProgressBar/ProgressRing: `variant` → `intent`, and the value → colour rule written down as an explicit `intent` where the value is a literal; dynamic values → report        |
-| CM-12 | R     | Button `type="submit"` where the intent is evident (inside `<form>` in the same file, no `onClick`); everything else untyped → report                                         |
-| CM-10 | R     | `DatePicker onChange={e => f(e.target.value)}` → `onValueChange={value => f(value)}` for the recognisable arrow shapes; handlers by reference, other shapes → report          |
-| CM-08 | R     | `SearchSelect` → `Combobox`: single-mode call sites rewritten (tag, import, `{id,label}` accessors, placeholder → `aria-label`); multi API, extras and unnamed sites → report |
+| Id    | Class | What it does                                                                                                                                                                                                                                                                                      |
+| ----- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| CM-01 | R     | Root imports of suite, legacy and product-owned names → `@assure-one/design-system/suite` and `/legacy` (same references, pure path change); `import * as DS` → report                                                                                                                            |
+| CM-05 | A     | Button family `iconLeft` / `iconRight` → `iconStart` / `iconEnd` (pure rename; both names of one slot, spreads → "could not be transformed")                                                                                                                                                      |
+| CM-13 | A     | `Tooltip delayMs` → `delayDuration` (pure rename, literal or dynamic value; both names, spreads → "could not be transformed")                                                                                                                                                                     |
+| CM-07 | A     | `inputSize` → `size` on `Input`, `Textarea`, `SearchInput` (pure rename, literal or dynamic value; both names, spreads → "could not be transformed")                                                                                                                                              |
+| CM-02 | A     | Button explicit default size: `size="md"` on every `Button`, `SubmitButton` and `LinkButton` that passes no `size` (pixel-neutral)                                                                                                                                                                |
+| CM-04 | R     | Button family legacy `variant` → `variant` + `intent` pair (`primary` → `solid`, `destructive` → `solid` + `danger`, …); `accent`, `dashed`, dynamic → report                                                                                                                                     |
+| CM-06 | R     | `tone` → `intent` on StatusDot, IconTile, Spinner, SegmentedProgress, SuiteProgress (`pro` → `brand`, listed for review); product hues → report                                                                                                                                                   |
+| CM-19 | R     | ProgressBar/ProgressRing: `variant` → `intent`, and the value → colour rule written down as an explicit `intent` where the value is a literal; dynamic values → report                                                                                                                            |
+| CM-12 | R     | Button `type="submit"` where the intent is evident (inside `<form>` in the same file, no `onClick`); everything else untyped → report                                                                                                                                                             |
+| CM-10 | R     | `DatePicker onChange={e => f(e.target.value)}` → `onValueChange={value => f(value)}` for the recognisable arrow shapes; handlers by reference, other shapes → report                                                                                                                              |
+| CM-08 | R     | `SearchSelect` → `Combobox`: single-mode call sites rewritten (tag, import, `{id,label}` accessors, placeholder → `aria-label`); multi API, extras and unnamed sites → report                                                                                                                     |
 | CM-09 | R     | `SideDrawer` → `Sheet`: drawers with a `SideDrawer.Header` rewritten (root → `Sheet` + `SheetContent side size`, `onClose` → `onOpenChange`, header → `SheetHeader`/`SheetTitle`/`SheetDescription`, Body/Footer → `SheetBody`/`SheetFooter`, import); no header, dynamic width, spreads → report |
-| CM-14 | X     | hidden-input mirror finder: hidden `<input name>` a consumer added because a design-system control posts nothing                                                              |
-| CM-15 | X     | DOM-selector finder: consumer code that depends on the internal DOM of design-system components, mapped to registry `C-DOM-*` ids                                             |
-| CM-16 | X     | `globals.css` analyser: `@source` into the package, duplicate preflight, colliding `@theme` keys, unlayered globals, legacy `var()`                                           |
-| CM-20 | X     | Select sentinel finder: option values standing in for "no value", and the line where each is converted back                                                                   |
+| CM-18 | A     | `DataTable*` presentational parts → `Table*` (`DataTableHead` → `TableHeader`, `Body`, `Row`, `Cell`, `DataTableHeader` → `TableHead`) where the mapping is 1:1; uncontrolled sorting, a dynamic `sortable` and spreads → "could not be transformed"                                              |
+| CM-14 | X     | hidden-input mirror finder: hidden `<input name>` a consumer added because a design-system control posts nothing                                                                                                                                                                                  |
+| CM-15 | X     | DOM-selector finder: consumer code that depends on the internal DOM of design-system components, mapped to registry `C-DOM-*` ids                                                                                                                                                                 |
+| CM-16 | X     | `globals.css` analyser: `@source` into the package, duplicate preflight, colliding `@theme` keys, unlayered globals, legacy `var()`                                                                                                                                                               |
+| CM-20 | X     | Select sentinel finder: option values standing in for "no value", and the line where each is converted back                                                                                                                                                                                       |
 
 The remaining ids of plan §29 land with the waves that ship their replacement
 APIs.
 
+### CM-01 — root imports → `/suite` and `/legacy`
+
+Class R. W8-02 gave the shared Assure patterns the `/suite` entry and the
+frozen and product-owned modules `/legacy`. Both are re-export barrels over the
+same module instances the root exports, so moving an import is a pure path
+change: no duplicated React context, no behaviour difference. The root keeps
+every name through 1.x (registry `C-ROOT-SUITE`) and drops them in 2.0, so
+running this codemod early costs nothing and running it late is a 2.0 blocker.
+
+```tsx
+import { Button, AgreementViewer, TimeLogger } from "@assure-one/design-system";
+// becomes
+import { Button } from "@assure-one/design-system";
+import { AgreementViewer } from "@assure-one/design-system/suite";
+import { TimeLogger } from "@assure-one/design-system/legacy";
+```
+
+A declaration whose names all move keeps its shape and only its module
+specifier changes. `import type`, per-specifier `type` prefixes, aliases,
+quote style and a default import are preserved; the default import stays on the
+root.
+
+| rule               | action  | severity | meaning                                                                           |
+| ------------------ | ------- | -------- | --------------------------------------------------------------------------------- |
+| `moved-to-suite`   | applied | low      | shared Assure patterns now import from `/suite`                                   |
+| `moved-to-legacy`  | applied | low      | frozen modules with no known consumer now import from `/legacy`                   |
+| `product-owned`    | applied | medium   | the import moved to `/legacy`, but the module is leaving for a product repository |
+| `namespace-import` | review  | high     | `import * as DS` cannot be split; import the moved members by name first          |
+
+Which entry owns which name comes from `codemods/lib/entry-map.mjs`, generated
+from `architecture/entry-map.json` by `pnpm entry-map`, so an installed copy of
+the codemod always carries the map of its own design-system version.
+
 ### CM-05 — Button family `iconLeft` / `iconRight` → `iconStart` / `iconEnd`
 
 Class A. W3-07 named the two icon slots of `Button`, `LinkButton` and
@@ -493,6 +528,45 @@ Not touched: elements already on `Sheet` (idempotency), local components with
 the same name, test files. The rewritten children are re-indented one level;
 run the project's formatter afterwards.
 
+### CM-18 — `DataTable*` parts → `Table*`
+
+Class A. W6-03 made the `DataTable*` table parts aliases of the `Table*` parts
+(contract C-DT-PARTS, removed in 3.0): one styling source, the same props. The
+1:1 parts are a pure rename — tag, closing tag and the named import:
+
+| from              | to            |
+| ----------------- | ------------- |
+| `DataTableHead`   | `TableHeader` |
+| `DataTableBody`   | `TableBody`   |
+| `DataTableRow`    | `TableRow`    |
+| `DataTableCell`   | `TableCell`   |
+| `DataTableHeader` | `TableHead`   |
+
+`DataTableHeader sortable sort={…} onSortChange={…}` loses the `sortable`
+attribute: `TableHead` sorts whenever `sort` is passed (`null` = sortable, not
+sorted). What changes in the DOM is the `data-slot` value (`table-*` instead of
+`data-table-*`) and the dropped `scope="col"` — a `<th>` in a `<thead>` is a
+column header already. Classes and pixels are the same, because since W6-03 the
+`DataTable*` parts render the `Table*` parts.
+
+| rule           | Contract   | What happens                                                   |
+| -------------- | ---------- | -------------------------------------------------------------- |
+| `part-renamed` | C-DT-PARTS | tag, closing tag and the named import rewritten (applied, low) |
+
+Reported under "could not be transformed": `DataTableHeader sortable` with no
+controlled `sort`, or with `defaultSort` (`uncontrolled-sort` — `TableHead` has
+no uncontrolled sort state; wire `sort` + `onSortChange`, e.g. from
+`useDataTable`); `sortable={expr}` (`dynamic-sortable`); a spread on the header
+(`spread-props`).
+
+Not touched: the parts that are not parallel copies of a `Table*` part —
+`DataTable` (the card frame), `DataTableToolbar`, `DataTableSearch`,
+`DataTableSpacer`, `DataTableResultsCount`, `DataTableCellName` / `CellMono` /
+`CellId` / `CellDue`, `DataTableCheckbox`, `DataTablePagination` — an aliased
+import (`DataTableCell as Cell`), a namespace import, local components with the
+same names, and test files. A file that still refers to the old name as a value
+(`typeof DataTableCell`) keeps its import and gains the new name next to it.
+
 ### CM-15 — DOM-selector finder
 
 Report-only. It never modifies a file; the runner throws if it tries. What it

package/codemods/lib/entry-map.mjs

@@ -0,0 +1,315 @@
+/**
+ * GENERATED by scripts/architecture/entry-map.mjs from architecture/entry-map.json
+ * — do not edit. `pnpm entry-map` rewrites it; `pnpm entry-map:check` fails
+ * when it is stale.
+ *
+ * The half of the entry map CM-01 needs, published inside the package so a
+ * consumer runs the codemod that matches its design-system version (W8-01/02).
+ */
+export const ENTRY_SPECIFIER = {
+  suite: "@assure-one/design-system/suite",
+  legacy: "@assure-one/design-system/legacy",
+};
+
+/** Public root export → the entry that owns it. Root-owned names are absent. */
+export const ENTRY_BY_SYMBOL = {
+  AgreementFirm: "suite",
+  AgreementPaneHeading: "suite",
+  AgreementPaneHeadingProps: "suite",
+  AgreementStatus: "suite",
+  AgreementStep: "suite",
+  AgreementViewer: "suite",
+  AgreementViewerProps: "suite",
+  ProposalAddOn: "suite",
+  ProposalAddOnProps: "suite",
+  ProposalBillingMode: "suite",
+  ProposalBillingRow: "suite",
+  ProposalBillingTerms: "suite",
+  ProposalBillingTermsProps: "suite",
+  ProposalConsentGate: "suite",
+  ProposalConsentGateProps: "suite",
+  ProposalCustomPage: "suite",
+  ProposalCustomPageKind: "suite",
+  ProposalCustomPageProps: "suite",
+  ProposalNote: "suite",
+  ProposalNoteProps: "suite",
+  ProposalPackageCard: "suite",
+  ProposalPackageCardProps: "suite",
+  ProposalPackageMode: "suite",
+  ProposalPaymentCapture: "suite",
+  ProposalPaymentCaptureProps: "suite",
+  ProposalPricingSummary: "suite",
+  ProposalPricingSummaryProps: "suite",
+  ProposalServiceRow: "suite",
+  ProposalServiceRowProps: "suite",
+  ProposalSignatureBlock: "suite",
+  ProposalSignatureBlockProps: "suite",
+  ProposalSigner: "suite",
+  ProposalSignerList: "suite",
+  ProposalSignerListProps: "suite",
+  ProposalSignerStatus: "suite",
+  Grid: "suite",
+  GridColumn: "suite",
+  GridInputType: "suite",
+  GridProps: "suite",
+  GridRow: "suite",
+  GridValue: "suite",
+  QUESTION_TYPES: "suite",
+  QUESTION_TYPE_CONTRACT_VERSION: "suite",
+  QuestionAddressValue: "suite",
+  QuestionFileValue: "suite",
+  QuestionHelp: "suite",
+  QuestionLabeledColumn: "suite",
+  QuestionLabeledRow: "suite",
+  QuestionLabeledValue: "suite",
+  QuestionNameValue: "suite",
+  QuestionOption: "suite",
+  QuestionTableColumn: "suite",
+  QuestionTableRow: "suite",
+  QuestionType: "suite",
+  Questions: "suite",
+  QuestionsProps: "suite",
+  DocumentDetailActions: "suite",
+  DocumentDetailActionsProps: "suite",
+  DocumentDetailBody: "suite",
+  DocumentDetailBodyProps: "suite",
+  DocumentDetailHeader: "suite",
+  DocumentDetailHeaderProps: "suite",
+  DocumentDetailMetaRow: "suite",
+  DocumentDetailMetaRowProps: "suite",
+  DocumentDetailPanel: "suite",
+  DocumentDetailPanelProps: "suite",
+  DocumentDetailRequester: "suite",
+  DocumentDetailRequesterProps: "suite",
+  DocumentDetailTitle: "suite",
+  DocumentDetailTitleProps: "suite",
+  DocumentList: "suite",
+  DocumentListProps: "suite",
+  DocumentListSection: "suite",
+  DocumentListSectionProps: "suite",
+  DocumentRow: "suite",
+  DocumentRowProps: "suite",
+  ClientSelect: "suite",
+  ClientSelectOption: "suite",
+  AssureAuditBrandIcon: "suite",
+  AssureBooksBrandIcon: "suite",
+  AssureProBrandIcon: "suite",
+  AssureTaxBrandIcon: "suite",
+  BRAND_PRODUCTS: "suite",
+  BrandIconProps: "suite",
+  BrandProduct: "suite",
+  Logo: "suite",
+  SidebarBrandSwitcher: "suite",
+  SidebarBrandSwitcherExtra: "suite",
+  SidebarBrandSwitcherItem: "suite",
+  SidebarBrandSwitcherProps: "suite",
+  SidebarBrandSwitcherTile: "suite",
+  brandLabel: "suite",
+  ComingSoon: "suite",
+  ComingSoonProps: "suite",
+  TimeLogger: "legacy",
+  TimeLoggerActions: "legacy",
+  TimeLoggerActionsProps: "legacy",
+  TimeLoggerBillable: "legacy",
+  TimeLoggerBillableProps: "legacy",
+  TimeLoggerContextRow: "legacy",
+  TimeLoggerContextRowProps: "legacy",
+  TimeLoggerEntry: "legacy",
+  TimeLoggerEntryList: "legacy",
+  TimeLoggerEntryListProps: "legacy",
+  TimeLoggerEntryProps: "legacy",
+  TimeLoggerField: "legacy",
+  TimeLoggerFieldProps: "legacy",
+  TimeLoggerFooter: "legacy",
+  TimeLoggerFooterProps: "legacy",
+  TimeLoggerHeader: "legacy",
+  TimeLoggerHeaderProps: "legacy",
+  TimeLoggerNotes: "legacy",
+  TimeLoggerNotesProps: "legacy",
+  TimeLoggerPhase: "legacy",
+  TimeLoggerProps: "legacy",
+  TimeLoggerTier: "legacy",
+  TimeLoggerTimer: "legacy",
+  TimeLoggerTimerProps: "legacy",
+  UseStopwatchReturn: "legacy",
+  formatClock: "legacy",
+  formatCurrency: "legacy",
+  formatDuration: "legacy",
+  parseDuration: "legacy",
+  useStopwatch: "legacy",
+  ClientRailGroupHeader: "legacy",
+  ClientRailGroupHeaderProps: "legacy",
+  ClientRailItem: "legacy",
+  ClientRailItemProps: "legacy",
+  DocumentFileCard: "legacy",
+  DocumentFileCardProps: "legacy",
+  DocumentFileLine: "legacy",
+  DocumentFileLineProps: "legacy",
+  DocumentFileRow: "legacy",
+  DocumentFileRowProps: "legacy",
+  DocumentRequestActivityKind: "legacy",
+  DocumentRequestAssigneeOption: "legacy",
+  DocumentRequestCard: "legacy",
+  DocumentRequestCardProps: "legacy",
+  DocumentRequestDetail: "legacy",
+  DocumentRequestDetailActivityEvent: "legacy",
+  DocumentRequestDetailComment: "legacy",
+  DocumentRequestDetailDoc: "legacy",
+  DocumentRequestDetailProps: "legacy",
+  DocumentRequestDetailTab: "legacy",
+  DocumentRequestItemSummary: "legacy",
+  DocumentRequestRequestedItem: "legacy",
+  DocumentRequestReviewStatusOption: "legacy",
+  DocumentRequestTone: "legacy",
+  Blockquote: "legacy",
+  Section: "legacy",
+  SectionHead: "legacy",
+  SectionHeader: "legacy",
+  Stat: "legacy",
+  PillStatus: "legacy",
+  StatusPill: "legacy",
+  StatusPillProps: "legacy",
+  Assignee: "legacy",
+  Dash: "legacy",
+  MoneyCell: "legacy",
+  StagePill: "legacy",
+  TagsCell: "legacy",
+  AIReceiptPanel: "legacy",
+  AIReceiptPanelProps: "legacy",
+  AIReceiptResult: "legacy",
+  AiDraftCard: "legacy",
+  AiDraftCardProps: "legacy",
+  AiDraftState: "legacy",
+  AttentionItem: "legacy",
+  AttentionItemProps: "legacy",
+  AttentionUrgency: "legacy",
+  BottomNav: "legacy",
+  BottomNavProps: "legacy",
+  BottomNavTab: "legacy",
+  CategoryDivider: "legacy",
+  CategoryDividerProps: "legacy",
+  CategoryTag: "legacy",
+  CategoryTagProps: "legacy",
+  CategoryTone: "legacy",
+  ChannelTabItem: "legacy",
+  ChannelTabs: "legacy",
+  ChannelTabsProps: "legacy",
+  ChannelTone: "legacy",
+  DashGrid: "legacy",
+  DashGridProps: "legacy",
+  DashWidget: "legacy",
+  DocumentChecklist: "legacy",
+  DocumentChecklistFile: "legacy",
+  DocumentChecklistItem: "legacy",
+  DocumentChecklistProps: "legacy",
+  DocumentChecklistStatus: "legacy",
+  DocumentItemState: "legacy",
+  DocumentRequestField: "legacy",
+  DocumentRequestFieldProps: "legacy",
+  DocumentRequestUpload: "legacy",
+  DocumentRequestUploadFile: "legacy",
+  DocumentRequestUploadProps: "legacy",
+  DocumentSource: "legacy",
+  DocumentSourceFilter: "legacy",
+  DocumentSourceFilterProps: "legacy",
+  DocumentSourceFilterValue: "legacy",
+  DocumentSourceTag: "legacy",
+  DocumentSourceTagProps: "legacy",
+  DocumentsWorkspaceLayout: "legacy",
+  DocumentsWorkspaceLayoutProps: "legacy",
+  EmailMessageCard: "legacy",
+  EmailMessageCardProps: "legacy",
+  EngagementCard: "legacy",
+  EngagementCardProps: "legacy",
+  EngagementTimeline: "legacy",
+  EngagementTimelineProps: "legacy",
+  EngagementTimelineStep: "legacy",
+  EngagementTimelineStepProps: "legacy",
+  IntentBadge: "legacy",
+  IntentBadgeProps: "legacy",
+  IntentTone: "legacy",
+  MissingDocumentItem: "legacy",
+  MissingDocumentsPanel: "legacy",
+  MissingDocumentsPanelProps: "legacy",
+  NewMenu: "legacy",
+  NewMenuAction: "legacy",
+  NewMenuGroup: "legacy",
+  NewMenuProps: "legacy",
+  SignatureEditor: "legacy",
+  SignatureEditorProps: "legacy",
+  SuggestionPills: "legacy",
+  SuggestionPillsProps: "legacy",
+  TeamMemberSelect: "legacy",
+  TimelineState: "legacy",
+};
+
+/** Product-owned names → the repository they are moving to (reported, never written). */
+export const PRODUCT_TARGET = {
+  TimeLogger: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerActions: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerActionsProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerBillable: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerBillableProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerContextRow: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerContextRowProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerEntry: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerEntryList: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerEntryListProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerEntryProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerField: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerFieldProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerFooter: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerFooterProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerHeader: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerHeaderProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerNotes: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerNotesProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerPhase: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerTier: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerTimer: "assure-pro/frontend/src/components/billing/time-logger/*",
+  TimeLoggerTimerProps: "assure-pro/frontend/src/components/billing/time-logger/*",
+  UseStopwatchReturn: "assure-pro/frontend/src/components/billing/time-logger/*",
+  formatClock: "assure-pro/frontend/src/components/billing/time-logger/*",
+  formatCurrency: "assure-pro/frontend/src/components/billing/time-logger/*",
+  formatDuration: "assure-pro/frontend/src/components/billing/time-logger/*",
+  parseDuration: "assure-pro/frontend/src/components/billing/time-logger/*",
+  useStopwatch: "assure-pro/frontend/src/components/billing/time-logger/*",
+  ClientRailGroupHeader: "assure-pro (documents feature)",
+  ClientRailGroupHeaderProps: "assure-pro (documents feature)",
+  ClientRailItem: "assure-pro (documents feature)",
+  ClientRailItemProps: "assure-pro (documents feature)",
+  DocumentFileCard: "assure-pro (documents feature)",
+  DocumentFileCardProps: "assure-pro (documents feature)",
+  DocumentFileLine: "assure-pro (documents feature)",
+  DocumentFileLineProps: "assure-pro (documents feature)",
+  DocumentFileRow: "assure-pro (documents feature)",
+  DocumentFileRowProps: "assure-pro (documents feature)",
+  DocumentRequestActivityKind: "assure-pro (documents feature)",
+  DocumentRequestAssigneeOption: "assure-pro (documents feature)",
+  DocumentRequestCard: "assure-pro (documents feature)",
+  DocumentRequestCardProps: "assure-pro (documents feature)",
+  DocumentRequestDetail: "assure-pro (documents feature)",
+  DocumentRequestDetailActivityEvent: "assure-pro (documents feature)",
+  DocumentRequestDetailComment: "assure-pro (documents feature)",
+  DocumentRequestDetailDoc: "assure-pro (documents feature)",
+  DocumentRequestDetailProps: "assure-pro (documents feature)",
+  DocumentRequestDetailTab: "assure-pro (documents feature)",
+  DocumentRequestItemSummary: "assure-pro (documents feature)",
+  DocumentRequestRequestedItem: "assure-pro (documents feature)",
+  DocumentRequestReviewStatusOption: "assure-pro (documents feature)",
+  DocumentRequestTone: "assure-pro (documents feature)",
+  Blockquote: "assure-pro (landing pages)",
+  Section: "assure-pro (landing pages)",
+  SectionHead: "assure-pro (landing pages)",
+  SectionHeader: "assure-pro (landing pages)",
+  Stat: "assure-pro (landing pages)",
+  PillStatus: "assure-pro status map over core `StatusBadge`",
+  StatusPill: "assure-pro status map over core `StatusBadge`",
+  StatusPillProps: "assure-pro status map over core `StatusBadge`",
+  Assignee: "assure-tax `table-cells.tsx`",
+  Dash: "assure-tax `table-cells.tsx`",
+  MoneyCell: "assure-tax `table-cells.tsx`",
+  StagePill: "assure-tax `table-cells.tsx`",
+  TagsCell: "assure-tax `table-cells.tsx`",
+};

package/codemods/lib/registry.mjs

@@ -3,6 +3,7 @@
  * codemods listed here can be run by id; the sequence is the plan's.
  */
 export const CODEMODS = [
+  { id: "CM-01", module: "../transforms/cm-01-entry-imports.mjs" },
   { id: "CM-05", module: "../transforms/cm-05-button-icon-slots.mjs" },
   { id: "CM-13", module: "../transforms/cm-13-tooltip-delay.mjs" },
   { id: "CM-07", module: "../transforms/cm-07-input-size.mjs" },
@@ -14,6 +15,7 @@ export const CODEMODS = [
   { id: "CM-10", module: "../transforms/cm-10-date-picker-value-change.mjs" },
   { id: "CM-08", module: "../transforms/cm-08-search-select-to-combobox.mjs" },
   { id: "CM-09", module: "../transforms/cm-09-side-drawer-to-sheet.mjs" },
+  { id: "CM-18", module: "../transforms/cm-18-data-table-parts.mjs" },
   { id: "CM-14", module: "../transforms/cm-14-hidden-mirrors.mjs" },
   { id: "CM-15", module: "../transforms/cm-15-dom-selectors.mjs" },
   { id: "CM-16", module: "../transforms/cm-16-globals-css.mjs" },