@assure-one/design-system 1.38.0 → 1.40.0

package/README.md

@@ -27,13 +27,23 @@ The single source of truth for visual design across all Assure products.
 pnpm add @assure-one/design-system
 ```
 
-Import the consumer stylesheet once in your root layout. Its bundled component
-utilities intentionally live below your app's Tailwind `utilities` layer, so
-local classes and responsive variants remain authoritative even when a bundler
-reorders CSS chunks:
+Load the design system's CSS from your app's global stylesheet, as the split
+entries, under one layer statement (Tailwind 4 in your build):
 
-```ts
-import "@assure-one/design-system/styles.css";
+```css
+/* src/app/globals.css — the layer statement is the first line of the file */
+@layer theme, base, ds, components, utilities;
+
+@import "tailwindcss";
+
+@import "@assure-one/design-system/css/tokens.css";
+@import "@assure-one/design-system/css/legacy-aliases.css"; /* optional */
+@import "@assure-one/design-system/css/tailwind.css";
+@import "@assure-one/design-system/css/shadcn.css"; /* optional */
+@import "@assure-one/design-system/css/base.css"; /* optional */
+@import "@assure-one/design-system/css/components.css";
+
+@import "./ds-preset.css"; /* your app's preset, optional */
 ```
 
 Then use components:
@@ -46,32 +56,42 @@ export default function Page() {
 }
 ```
 
-### The split CSS entries (experimental)
+### The split CSS entries
 
-`styles.css` stays the supported way to consume the design system, unchanged.
-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.
+The split entries are the documented default CSS integration since 1.40. Every
+design-system class is `ds:`-prefixed and compiled into `css/components.css`
+inside `@layer ds`, so your own utilities always win over component styles and
+your Tailwind build never has to scan our package.
 
-| 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.                             |
 
 Import order is `tokens.css` → `legacy-aliases.css` (optional) → `tailwind.css`
 → `shadcn.css` (optional) → `base.css` (optional) → `components.css`, after your own
 `@import "tailwindcss"` and under the layer statement
 `@layer theme, base, ds, components, utilities;`.
 [**`docs/integration/css.md`**](./docs/integration/css.md) has the full
-sequence, where the per-app preset goes, when the `@source` into our package may
-be removed, and the fixture run behind each of those claims. The reasoning lives
+sequence, where the per-app preset goes, why no `@source` into our package is
+needed, and the fixture run behind each of those claims. The reasoning lives
 in [ADR-004](./docs/adr/004-css-delivery-cascade.md) and
 [ADR-005](./docs/adr/005-app-vocabulary-bridge.md).
 
+### `styles.css` (deprecated)
+
+`@assure-one/design-system/styles.css` — the all-in-one sheet with its own
+preflight, a Google Fonts `@import` and the frozen unprefixed legacy utilities —
+is **deprecated since 1.40** (registry `C-CSS-STYLES`). It still ships, unchanged,
+and is removed in 3.0; the built file opens with a deprecation
+banner. Moving to the split entries is a deliberate visual change (document font
+size, fonts, preflight): follow [`docs/integration/css.md`](./docs/integration/css.md)
+§6 and [`docs/migration/1.40.md`](./docs/migration/1.40.md).
+
 ### Runtime brand theming (experimental)
 
 For a tenant colour known only at runtime, `@assure-one/design-system/tokens`
@@ -89,11 +109,27 @@ 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
-with `en-US` and (for `LinkButton` / `Logo`) routes through `next/link` on its
-own. `DesignSystemProvider` is the one optional, thin, client-side provider
+with `en-US` and (for `LinkButton` / `Logo`) renders a plain `<a>` / `<img>`.
+On Next.js, render `NextDesignSystemProvider` to get `next/link` routing and
+`next/image`: the root imports no `next/*` since 2.0. `DesignSystemProvider` is the one optional, thin, client-side provider
 for what CSS cannot do — the generic strings, the locale, the text direction,
 the portal container, the link and image adapters, shared tooltip defaults and
 (opt-in) the toast region. It renders no DOM wrapper ([ADR-010](./docs/adr/010-design-system-provider.md)).
@@ -128,11 +164,10 @@ export default function RootLayout({ children }) {
   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
-  through. Without them the components keep their static `next/link` /
-  `next/image` imports until 2.0, so a Next.js app that renders no provider is
-  unchanged. A non-Next app passes its router's link; a Next.js app uses
-  `NextDesignSystemProvider` so it is ready for the 2.0 removal of the static
-  imports.
+  through. Without them the components render a plain `<a>` / `<img>` (full
+  page navigation). A non-Next app passes its router's link; a Next.js app uses
+  `NextDesignSystemProvider`. `next` is an optional peer, needed only by the
+  `/next` entry.
 - **`portalContainer`**, **`dir`**, **`tooltip`**, **`toasts`** — documented on
   the props. `toasts` mounts the toast region for `useToast()`; leave it off if
   you already render `ToastProvider`.

package/codemods/README.md

@@ -19,6 +19,9 @@ node node_modules/@assure-one/design-system/codemods/run.mjs CM-02 src --report
 
 # Everything this project is missing, in program order
 node node_modules/@assure-one/design-system/codemods/run.mjs upgrade --dry
+
+# Only what a project needs before 1.40 (docs/migration/1.40.md)
+node node_modules/@assure-one/design-system/codemods/run.mjs upgrade --to 1.40 --dry
 ```
 
 There is deliberately **no** `bin` entry and **no** `exports` entry for the
@@ -30,6 +33,7 @@ is `pnpm codemods <id> <paths>`.
 | Option                          | Effect                                                                         |
 | ------------------------------- | ------------------------------------------------------------------------------ |
 | `--dry`                         | report what would happen; write neither files nor the ledger                   |
+| `--to <version>`                | `upgrade` only: run the bundle that release needs (`--to 1.40`, see below)     |
 | `--root <dir>`                  | project root (default: the nearest `package.json` above the working directory) |
 | `--report <prefix>`             | write `<prefix>.json` and `<prefix>.md`                                        |
 | `--json <file>` / `--md <file>` | write one of the two                                                           |
@@ -96,6 +100,19 @@ entry. Report-only codemods and dry runs never touch it. The consumer scanner
 reads the file and the migration dashboard shows the applied ids
 (`migration-status/<app>.json` → `codemodLedger`).
 
+## `upgrade --to 1.40`
+
+`upgrade --to 1.40` runs, in program order, the codemods of the 1.40 bundle
+(`UPGRADE_TARGETS` in `lib/registry.mjs`): one per registry contract that 1.40
+removes or flips (plan §21.2) — CM-01, CM-04, CM-19, CM-12, and the finders
+CM-15 and CM-16. A transforming codemod already in the ledger is skipped, so
+the command is safe to repeat and safe from any 1.x; the report-only finders
+run every time. With `--report <prefix>` each codemod writes
+`<prefix>-<id>.json` and `.md`. The migration guide is
+[`docs/migration/1.40.md`](../docs/migration/1.40.md). `--to 2` (also `2.0`,
+`v2`) still works: it is the name the bundle had while Wave 9 was planned as
+2.0 (decision D11 shipped it as 1.40).
+
 ## Reports
 
 Every run produces the same report: a JSON document (`schema`, the codemod, the
@@ -107,28 +124,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-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                                                                   |
+| 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.39 (registry `C-ROOT-SUITE`) and drops them in 1.40, so
+running this codemod early costs nothing and running it late is a 1.40 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
@@ -272,7 +323,7 @@ components with the same names, test files.
 
 Class R. `ProgressBar` and `ProgressRing` colour themselves **by value** when
 no colour is passed (`< 50%` brand, `≥ 50%` warning, `≥ 80%` success) — a
-business mapping the design system should not own, which 2.0 switches off
+business mapping the design system should not own, which 1.40 switches off
 (W9-10, contract C-PROGRESS). W3-21 added `intent`; passing it disables the
 rule. CM-19 makes every call site say what it renders today, so the flip
 changes nothing a consumer did not write down: `variant="<legacy word>"`
@@ -304,7 +355,7 @@ gets `size="md"` — the value the component resolves today
 (`defaultVariants.size`, 40px), so nothing moves on screen. It exists because
 a size _meaning_ can only change once no call site depends on the default:
 after CM-02, the D5 size flip (CM-03 phase 2, W9-06) touches nothing a
-consumer did not write down, and 2.0 gate G6 counts exactly this.
+consumer did not write down, and gate G6 counts exactly this.
 
 The attribute goes after `variant` when there is one (the order the
 applications use) and first otherwise, on its own line when the element's
@@ -323,7 +374,7 @@ scanner that measures G6 counts production files only).
 ### CM-12 — Button `type="submit"` where evident
 
 Class R. An untyped `Button` renders `<button>` without a `type`, which the
-browser treats as `submit`; 2.0 flips the default to `"button"` (W9-05,
+browser treats as `submit`; 1.40 flips the default to `"button"` (W9-05,
 C-BTN-TYPE, gate G4). CM-12 writes down, before the flip, which Buttons submit
 on purpose — and only where the file itself makes that evident:
 
@@ -515,9 +566,9 @@ sorted). What changes in the DOM is the `data-slot` value (`table-*` instead of
 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)      |
+| 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
@@ -564,8 +615,8 @@ yet — those are the candidates for new registry entries. `confidence` is `high
 for a token on the component itself, `medium` for a wrapper or a heuristic,
 `low` for an unmapped wrapper.
 
-CM-15 feeds 2.0 gate G7 (`consumerSelectors = 0` for the freezes with removal
-target 2.0). Use `--fail-on-findings` to gate on it. The committed findings for
+CM-15 feeds gate G7 (`consumerSelectors = 0` for the freezes with registry
+removal target 2.0, which 1.40 lifts). Use `--fail-on-findings` to gate on it. The committed findings for
 the four consumer apps are in `docs/codemods/`.
 
 ### CM-16 — `globals.css` analyser

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`",
+};