@assure-one/design-system 1.38.0 → 1.39.0

package/README.md

@@ -89,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

package/codemods/README.md

@@ -107,28 +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-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.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
@@ -515,9 +549,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

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" },

package/codemods/transforms/cm-01-entry-imports.mjs

@@ -0,0 +1,202 @@
+/**
+ * CM-01 — root imports → `/suite` and `/legacy` (class R; plan §29 seq 1,
+ * registry `C-ROOT-SUITE`, lands with W8-02).
+ *
+ * W8-02 gave the shared Assure patterns their own entry and put the frozen and
+ * product-owned modules behind `/legacy`. Both are re-export barrels over the
+ * very same module instances the root exports, so moving an import is a pure
+ * path change: no duplicated context, no behaviour difference, nothing to test
+ * afterwards. The root keeps the names through 1.x and drops them in 2.0.
+ *
+ * ## What it rewrites
+ *
+ * ```tsx
+ * import { Button, AgreementViewer, TimeLogger } from "@assure-one/design-system";
+ * ```
+ *
+ * becomes
+ *
+ * ```tsx
+ * 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` and per-specifier `type` prefixes, aliases
+ * (`X as Y`), quote style and a default import are preserved; the default
+ * import always stays on the root.
+ *
+ * Which entry owns which name comes from `codemods/lib/entry-map.mjs`, which
+ * `pnpm entry-map` generates from `architecture/entry-map.json` — so the
+ * installed copy of the codemod always knows the map of its own version.
+ *
+ * ## What it reports
+ *
+ * | rule               | action  | severity | why                                                                                     |
+ * | ------------------ | ------- | -------- | --------------------------------------------------------------------------------------- |
+ * | `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; the named members have to be imported one by one first |
+ *
+ * Imports already on `/suite` or `/legacy` are not touched (idempotency), and
+ * neither is a name the root still owns. Test files are skipped.
+ */
+import { ENTRY_BY_SYMBOL, ENTRY_SPECIFIER, PRODUCT_TARGET } from "../lib/entry-map.mjs";
+import { applyEdits } from "../lib/jsx-edit.mjs";
+import { analyseForms } from "../lib/forms.mjs";
+
+export const meta = {
+  id: "CM-01",
+  title: "Root imports of suite, legacy and product-owned names → /suite and /legacy",
+  class: "R",
+  oneShot: false,
+  requires: { codemods: [], dsVersion: null },
+  parses: ["code"],
+  includeTests: false,
+  usesTypeScript: true,
+  usesPostcss: false,
+  registryIds: ["C-ROOT-SUITE"],
+};
+
+export const RULES = {
+  "moved-to-suite": { action: "applied", severity: "low" },
+  "moved-to-legacy": { action: "applied", severity: "low" },
+  "product-owned": { action: "applied", severity: "medium" },
+  "namespace-import": { action: "review", severity: "high" },
+};
+
+const ROOT = "@assure-one/design-system";
+
+/** The entry that owns an imported name, or `null` when the root keeps it. */
+export const entryOf = (name) => ENTRY_BY_SYMBOL[name] ?? null;
+
+const ruleFor = (name, entry) =>
+  PRODUCT_TARGET[name] ? "product-owned" : entry === "suite" ? "moved-to-suite" : "moved-to-legacy";
+
+/** One `import …` statement built from the specifiers of the original one. */
+function declaration({ typeOnly, defaultName, specifiers, quote, semi }, specifier) {
+  const clause = [defaultName, specifiers.length ? `{ ${specifiers.join(", ")} }` : null].filter(
+    Boolean,
+  );
+  return `import ${typeOnly ? "type " : ""}${clause.join(", ")} from ${quote}${specifier}${quote}${semi}`;
+}
+
+export function transform(file, { ts }) {
+  const facts = analyseForms(ts, file.source, file.rel);
+  const sf = facts.sf;
+  const findings = [];
+  const edits = [];
+
+  for (const stmt of sf.statements) {
+    if (!ts.isImportDeclaration(stmt) || !ts.isStringLiteral(stmt.moduleSpecifier)) continue;
+    if (stmt.moduleSpecifier.text !== ROOT) continue;
+    const clause = stmt.importClause;
+    if (!clause) continue;
+
+    const line = sf.getLineAndCharacterOfPosition(stmt.getStart(sf)).line + 1;
+    const base = { line, registryId: "C-ROOT-SUITE", component: null, gate: null };
+
+    // `import * as DS` — the members are reached through the namespace, so the
+    // import cannot be split by name. Only worth reporting when the file
+    // actually reads a name that moved.
+    if (clause.namedBindings && ts.isNamespaceImport(clause.namedBindings)) {
+      const ns = clause.namedBindings.name.text;
+      const used = new Set();
+      const visit = (node) => {
+        if (
+          ts.isPropertyAccessExpression(node) &&
+          ts.isIdentifier(node.expression) &&
+          node.expression.text === ns &&
+          entryOf(node.name.text)
+        ) {
+          used.add(node.name.text);
+        }
+        if (ts.isQualifiedName(node) && ts.isIdentifier(node.left) && node.left.text === ns) {
+          if (entryOf(node.right.text)) used.add(node.right.text);
+        }
+        ts.forEachChild(node, visit);
+      };
+      ts.forEachChild(sf, visit);
+      if (used.size) {
+        findings.push({
+          ...base,
+          rule: "namespace-import",
+          ...RULES["namespace-import"],
+          match: `import * as ${ns}`,
+          detail: { namespace: ns, symbols: [...used].sort() },
+        });
+      }
+      continue;
+    }
+
+    const named = clause.namedBindings;
+    if (!named || !ts.isNamedImports(named)) continue;
+
+    const buckets = { root: [], suite: [], legacy: [] };
+    const movedNames = { suite: [], legacy: [] };
+    for (const element of named.elements) {
+      const imported = (element.propertyName ?? element.name).text;
+      const entry = entryOf(imported);
+      const bucket = entry ?? "root";
+      buckets[bucket].push(element.getText(sf));
+      if (entry) movedNames[entry].push(imported);
+    }
+    if (!movedNames.suite.length && !movedNames.legacy.length) continue;
+
+    const text = stmt.getText(sf);
+    const shape = {
+      typeOnly: clause.isTypeOnly,
+      defaultName: clause.name ? clause.name.text : null,
+      quote: stmt.moduleSpecifier.getText(sf)[0],
+      semi: text.endsWith(";") ? ";" : "",
+    };
+    const rows = [];
+    if (buckets.root.length || shape.defaultName) {
+      rows.push(declaration({ ...shape, specifiers: buckets.root }, ROOT));
+    }
+    for (const entry of ["suite", "legacy"]) {
+      if (!buckets[entry].length) continue;
+      rows.push(
+        declaration(
+          { ...shape, defaultName: null, specifiers: buckets[entry] },
+          ENTRY_SPECIFIER[entry],
+        ),
+      );
+    }
+    edits.push({ pos: stmt.getStart(sf), end: stmt.getEnd(), text: rows.join("\n") });
+
+    for (const entry of ["suite", "legacy"]) {
+      const byRule = new Map();
+      for (const name of movedNames[entry]) {
+        const rule = ruleFor(name, entry);
+        if (!byRule.has(rule)) byRule.set(rule, []);
+        byRule.get(rule).push(name);
+      }
+      for (const [rule, names] of byRule) {
+        findings.push({
+          ...base,
+          rule,
+          ...RULES[rule],
+          match: `{ ${names.sort().join(", ")} }`,
+          detail: {
+            from: ROOT,
+            to: ENTRY_SPECIFIER[entry],
+            symbols: names,
+            ...(rule === "product-owned"
+              ? { owners: [...new Set(names.map((n) => PRODUCT_TARGET[n]))].sort() }
+              : {}),
+          },
+        });
+      }
+    }
+  }
+
+  return {
+    output: edits.length ? applyEdits(file.source, edits) : file.source,
+    findings,
+    notTransformed: [],
+    parseErrors: facts.parseErrors,
+  };
+}