[PF-2005] Create Code Connect config Component Library V2

.changeset/accordion-base-ui-migration.md

@@ -0,0 +1,10 @@
+---
+'@toptal/picasso-accordion': patch
+---
+
+### Accordion
+
+- Re-implement on `@base-ui/react/accordion` + Tailwind with behavioral parity for `children`, `content`, `expanded`, `defaultExpanded`, `disabled`, `expandIcon`, `borders`, `onChange`, `testIds` and `transitionProps`
+- The expand/collapse animation is now CSS-driven. `transitionProps.timeout` (number, or `enter`/`exit`) sets the transition duration in ms (the previous height-dependent `timeout: 'auto'` default is approximated by a fixed 300ms); `transitionProps.onExited` still fires after the collapse transition completes
+- Drop the vestigial `classes` prop (a no-op since the `@mui/base` / `@material-ui/core` internals were removed) — style overrides go through `className` / `style`
+- Remove the `@material-ui/core` peer dependency and lift the React `< 19.0.0` peer cap

.changeset/accordion-migration.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-page': patch
+---
+
+### Page
+
+- `SidebarItemAccordion` routes its Accordion slot styling through `className` instead of the removed `classes` prop; no visual change

.changeset/backdrop-migration.md

@@ -0,0 +1,8 @@
+---
+'@toptal/picasso-backdrop': patch
+---
+
+### Backdrop
+
+- Replace `@mui/base/Modal` `ModalBackdropSlotProps` import with a local `React.HTMLAttributes<HTMLDivElement>`-based Props type; public Props surface and runtime behavior unchanged
+- Lift React peer-dependency cap (drop `< 19.0.0`)

.changeset/badge-migration.md

@@ -0,0 +1,17 @@
+---
+'@toptal/picasso-badge': major
+---
+
+### Badge
+
+- Replace the `@mui/base/Badge` wrapper with a plain `<span>` composition (no `@base-ui/react` equivalent — Picasso was already mostly custom; see migration plan v3 §9.9)
+- Lift React peer-dependency cap (drop `< 19.0.0`)
+
+## Intentional visual changes
+
+Storybook Happo: clean (all Badge stories byte-identical to master).
+
+Cypress Happo diffs are not Badge regressions — neither component below imports `@toptal/picasso-badge`. The shifts are environmental/render variability triggered by the dependency-graph change (dropping `@mui/base`):
+
+- `PageTopBarMenu / width-1441` — `color-delta: 0.01377`, `ssim: 0.00035`. Sub-perceptual (well under Happo's compare-threshold). PageTopBarMenu composes `Page.TopBar` + `UserBadge`; no `Badge` consumer chain.
+- `CategoriesChart / default/with-column-hover` — `color-delta: 0.69023`, `ssim: 0.05961`. Recharts SVG tooltip hover screenshot; the test file already documents existing flakiness ("sometimes the screenshot was taken with mouse over the bar and it triggered tooltip"). CategoriesChart lives under `topkit-analytics-charts` and has no Badge reference anywhere in its module graph.

.changeset/container-migration.md

@@ -0,0 +1,9 @@
+---
+'@toptal/picasso-container': patch
+---
+
+### Container
+
+- Drop residual `@material-ui/core` type import (`PropTypes.Alignment`) in favor of an explicit literal union on the `align` prop. Public API and behavior unchanged.
+- Migrate the props interface to `extends BaseProps`, dropping the vestigial `classes` prop from the public type. The prop was inherited from `StandardProps` but was never read in source and had zero internal / external consumer usage per the cross-tier audit.
+- Lift `react` peer cap to `>=16.12.0` so the package is compatible with React 19.

.changeset/container-tier1-mui-cleanup.md

@@ -0,0 +1,11 @@
+---
+'@toptal/picasso-container': patch
+---
+
+### Container
+
+Duplicate of `container-migration.md` (orchestrator expected that filename). Safe to delete during release cleanup — version coalesces to a single patch bump and the CHANGELOG entry below is the same.
+
+- Drop residual `@material-ui/core` type import (`PropTypes.Alignment`) in favor of an explicit literal union on the `align` prop. Public API and behavior unchanged.
+- Migrate the props interface to `extends BaseProps`, dropping the vestigial `classes` prop from the public type. The prop was inherited from `StandardProps` but was never read in source and had zero internal / external consumer usage per the cross-tier audit.
+- Lift `react` peer cap to `>=16.12.0` so the package is compatible with React 19.

.changeset/drawer-migration.md

@@ -0,0 +1,8 @@
+---
+'@toptal/picasso-drawer': patch
+---
+
+### Drawer
+
+- Re-implement on `@base-ui/react/dialog` (`Dialog.Root` + `Dialog.Portal` + `Dialog.Backdrop` + `Dialog.Popup`), replacing the `@mui/base/Modal` backing. The Dialog primitive (not `@base-ui/react/drawer`) backs Picasso's Drawer because Drawer has no swipe affordance and `@base-ui/react/drawer` always enables swipe-to-dismiss. The public Props API and behavior are unchanged — backdrop-click and Escape dismissal are preserved; `disableBackdrop` keeps page content interactive and disables outside-press dismissal.
+- Slide/backdrop transitions are now driven by `@base-ui/react` `data-[starting-style]`/`data-[ending-style]` instead of `@toptal/picasso-slide` and `@toptal/picasso-backdrop`. The rendered DOM changes from the `@mui/base` Modal shape; internal `base-Modal-*` markup (never part of the public API) is gone, so tests asserting on it need new selectors.

.changeset/dropdown-migration.md

@@ -0,0 +1,10 @@
+---
+'@toptal/picasso-dropdown': patch
+---
+
+### Dropdown
+- Remove the `@mui/base` (`ClickAwayListener`) and `@material-ui/core` (`Grow`, `PopperPlacementType`) dependencies; public API and behavioral parity unchanged.
+- Click-away dismissal now uses the shared `@toptal/picasso-utils` `ClickAwayListener` (the MUI-free replacement already used by DatePicker and Menu), instead of `@mui/base`'s listener.
+- The open grow transition moves from MUI `Grow` to a CSS `@starting-style` entry animation (`transition-[opacity,scale]` + `starting:scale-75 starting:opacity-0`), resting at `scale-100`.
+- The `placement` prop type is now imported from `@toptal/picasso-popper` (`PopperPlacementType`) instead of being redefined locally — same 12 members as `@material-ui/core`'s, no removed values, no consumer-visible narrowing.
+- The locally narrowed `classes?: { popper?, content? }` surface is preserved unchanged (used by external consumers).

.changeset/file-input-migration.md

@@ -0,0 +1,11 @@
+---
+'@toptal/picasso-file-input': patch
+---
+
+### FileInput
+
+- re-implement FileInput, FileList, FileListItem and ProgressBar on plain
+  `<input type="file">` + Tailwind; remove `@material-ui/core` JSS
+  (`makeStyles` / `createStyles`) and drop the `@material-ui/core` peer
+  dependency. Public prop API and behavior are unchanged.
+- widen the `react` peer range (drop the `< 19.0.0` upper bound).

.changeset/form-label-migration.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-form-label': patch
+---
+
+### FormLabel
+
+- Drop `@material-ui/core` from `peerDependencies`; widen React peer range to `>=16.12.0` (drop `<19.0.0` upper bound). Replace the lone `import type { FormControlLabelProps } from '@material-ui/core/FormControlLabel'` with a local `onChange` type. Public API unchanged; `FormControlLabel`'s narrowed `classes?: { root?, label? }` slot surface preserved for Switch/Radio/Checkbox consumers.

.changeset/form-layout-migration.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-form-layout': patch
+---
+
+### FormLayout
+
+- Drop `@material-ui/core` peer dependency and lift the `react` peer cap to `>=16.12.0`. Source was already MUI-free; public API unchanged, behavioral parity preserved.

.changeset/form-migration.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-form': patch
+---
+
+### Form
+
+- Drop `@material-ui/core` from `peerDependencies`; widen React peer range to `>=16.12.0` (drop `<19.0.0` upper bound). Source already MUI-clean; public API unchanged.

.changeset/grid-migration.md

@@ -0,0 +1,8 @@
+---
+'@toptal/picasso-grid': patch
+---
+
+### Grid
+
+- Replace the MUI v4 `GridSize` type re-export with the Picasso-native `GridSize` union; public API unchanged, behavioral parity preserved.
+- Drop `@material-ui/core` peer dependency and widen the React peer range to `>=16.12.0`.

.changeset/modal-context-migration.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-modal-context': patch
+---
+
+### ModalContext
+
+- Drop the vestigial `@material-ui/core` peer-dependency (source is a React context provider that imports nothing from MUI) and lift the `react` peer cap to `>=16.12.0`. Public API unchanged; behavioral parity.

.changeset/modal-migration.md

@@ -0,0 +1,10 @@
+---
+'@toptal/picasso-modal': patch
+---
+
+### Modal
+
+- re-implement on `@base-ui/react`'s `Dialog` (`Dialog.Root` + `Dialog.Portal` + `Dialog.Backdrop` + `Dialog.Popup`), replacing `@mui/base/Modal`. Public Props API is unchanged — `open`, `onClose`, `onOpen`, `onBackdropClick`, `disableBackdropClick`, `hideBackdrop`, `container`, `size`, `align`, `transitionProps`, `transitionDuration`, `paperProps`, `testIds` and the narrowed `classes?: { closeButton }` are all preserved, with behavioral parity (custom focus management, page scroll lock, multi-modal coexistence, backdrop-click and escape close).
+- internally the dim overlay is now a `Dialog.Backdrop` element instead of the composed `@toptal/picasso-backdrop` component, and the open/close fade is driven by `data-starting-style`/`data-ending-style` Tailwind transitions instead of `@toptal/picasso-fade`.
+- the `@mui/base`, `@toptal/picasso-backdrop` and `@toptal/picasso-fade` are dropped from dependencies; the `react` peer cap is lifted to `>=16.12.0`.
+- the `ModalContent` scroll shades now fade in and out via CSS opacity (`data-active` + `transition-opacity`) instead of being conditionally mounted; no API change.

.changeset/note-migration.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-note': patch
+---
+
+### Note
+
+- Drop `@material-ui/core` from `peerDependencies`; widen React peer range to `>=16.12.0` (drop `<19.0.0` upper bound). Source already MUI-clean; public API unchanged.

.changeset/notification-migration.md

@@ -0,0 +1,8 @@
+---
+'@toptal/picasso-notification': major
+---
+
+### Notification
+- Replace the `@material-ui/core/Snackbar` `SnackbarOrigin` type import with a Picasso-native structural type; behavioral parity, `notistack` integration unchanged.
+- Drop the vestigial public `classes` prop (audit-verified 0 internal/external usage) via `Omit<StandardProps, 'classes'>`. Removing the prop from the public type is the breaking surface.
+- Widen the `react` peer range to `>=16.12.0` (drop the `< 19.0.0` upper bound).

.changeset/outlined-input-migration.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-outlined-input': patch
+---
+
+### OutlinedInput
+- Re-implement on native elements + `react-textarea-autosize`, removing `@mui/base` (`Input` / `TextareaAutosize`) and the `@material-ui/core` `InputBaseComponentProps` type; public API unchanged.
+- Behavioral parity: outline root, `startAdornment` / `endAdornment`, `inputComponent`, `multiline` (`rows` / `rowsMax`), `error` / `warning` / `success` states, the narrowed `classes?: { input?, root? }` slots, and root-click-to-focus are all preserved.

.changeset/page-migration.md

@@ -0,0 +1,9 @@
+---
+'@toptal/picasso-page': patch
+---
+
+### Page
+
+- Re-implement the `Page` root shell styling on Tailwind; behavioral parity with the JSS implementation, public Props API unchanged
+- Remove `@material-ui/core` from `peerDependencies` — consumers no longer need it installed for this package
+- Widen the `react` peer range to `>=16.12.0` (React 19 cap lifted)

.changeset/picasso-charts-migration.md

@@ -0,0 +1,9 @@
+---
+'@toptal/picasso-charts': major
+---
+
+### LineChart
+
+- Re-implement styling without `@material-ui/core` + JSS; behavioral and visual parity preserved. The bottom-Y-axis-label rule now lives in `LineChart`'s self-contained `<style>` block, scoped to a per-instance marker class, replacing the `makeStyles`/`createStyles` JSS hook.
+- **Breaking**: remove `@material-ui/core` from `peerDependencies` — `@toptal/picasso-charts` no longer requires consumers to install MUI v4. The styles are no longer registered as a themeable MUI hook (`makeStyles(…, { name: 'LineChart' })`), so any `PicassoProvider.override`/MUI-theme override targeting `LineChart` no longer applies.
+- Widen the `react` peer range to `>=16.12.0` (drop the `<19.0.0` upper bound).

.changeset/picasso-menu-drop-mui-base.md

@@ -0,0 +1,8 @@
+---
+'@toptal/picasso-menu': patch
+---
+
+### Menu
+
+- Drop the stale `@mui/base` dependency declaration; source already runs on `@toptal/picasso-popper` + `@toptal/picasso-paper`. Public API unchanged, behavioral parity preserved.
+- Lift the `react` peer cap to `>=16.12.0`.

.changeset/picasso-rich-text-editor-migration.md

@@ -0,0 +1,9 @@
+---
+'@toptal/picasso-rich-text-editor': major
+---
+
+### RichTextEditor
+
+- Re-implement styling on Tailwind; remove the `@material-ui/core` dependency (JSS `makeStyles`/`createStyles` → static Tailwind class maps and arbitrary variants). Public component API is unchanged and behavioral parity is the goal.
+- **Breaking**: editor content is no longer styled through MUI/JSS-generated class names (`makeStyles` `name:`-prefixed classes such as `LexicalEditor-editorContainer-*`, `PicassoCode-*`, etc.). Consumers that targeted those generated class names from their own stylesheets must migrate to the Tailwind-based markup.
+- `@material-ui/core` removed from `peerDependencies` and `devDependencies`; the `react`/`react-dom` peer cap is widened to `>=16.12.0` (React 19 unblocked).

.changeset/picasso-shared-react-event-bind.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-shared': patch
+---
+
+### picasso-shared
+
+- Fix `toReactEvent` / `toReactChangeEvent`: bind forwarded native event methods (`preventDefault`, `stopPropagation`, …) to the underlying native event. Without binding they were invoked with the Proxy as `this`, throwing "Illegal invocation" in real browsers when a consumer `onChange` called e.g. `event.stopPropagation()`.

.changeset/picasso-shared-react-event-helpers.md

@@ -0,0 +1,8 @@
+---
+'@toptal/picasso-shared': minor
+---
+
+### picasso-shared
+
+- add `toReactEvent<R>(event)` boundary-cast helper for bridging native DOM `Event` to React.SyntheticEvent variants at the `@base-ui/react` ↔ Picasso form-component interface. Proxy-based: preserves native event identity, synthesizes the four React-SyntheticEvent shim methods (`nativeEvent`, `persist`, `isDefaultPrevented`, `isPropagationStopped`).
+- add `toReactChangeEvent<T>(event)` specialized helper for form-input `onChange` adapters. Constrains `T` to `HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement` and dev-warns when the event target is not a DOM element. Delegates to `toReactEvent` for the Proxy machinery.

.changeset/popper-export-placement-type.md

@@ -0,0 +1,6 @@
+---
+'@toptal/picasso-popper': patch
+---
+
+### Popper
+- Surface `PopperPlacementType` from the package entry so consumers can import it instead of redefining the placement union locally. Type-only and additive — no runtime or behavioral change.

.changeset/slider-migration.md

@@ -0,0 +1,19 @@
+---
+'@toptal/picasso-slider': patch
+---
+
+### Slider
+
+- Re-implement on `@base-ui/react/slider`; public API unchanged.
+
+## Intentional visual changes
+
+Slider now matches the current Figma design-of-record (diverged from the legacy
+`@mui/base` pixels). Pre-authorized in `docs/migration/components/Slider.md`
+§"Approved visual deltas":
+
+- Thumb diameter `15px` → `19px` (2px white border retained).
+- Rail fill: translucent `bg-gray-500` @ `opacity-[0.24]` → solid `bg-gray-500`.
+- Disabled track (under `disableTrackHighlight`): `bg-gray-200` → `bg-gray-500`.
+- Mark: `6px` + 2px white border → `9px` solid fill, no border.
+- Container vertical rhythm: `my-[6px]` → `mt-[5px] mb-[4px]` + `h-[15px]`.

.changeset/switch-migration.md

@@ -0,0 +1,10 @@
+---
+'@toptal/picasso-switch': patch
+---
+
+### Switch
+
+- Re-implement on `@base-ui/react` (behavioral parity); compound parts (`Switch.Root` + `Switch.Thumb`) replace the single `@mui/base/Switch` slot system
+- Adapt the public `onChange(event, checked)` callback over base-ui's `onCheckedChange` so consumer signatures are preserved
+- Public API unchanged: `Props` and `ref` keep master's `HTMLButtonElement` typing
+- Lift the `react` peer-dependency upper bound to `>=16.12.0` (drop the `< 19.0.0` cap)

.changeset/tabs-migration.md

@@ -0,0 +1,10 @@
+---
+'@toptal/picasso-tabs': patch
+---
+
+### Tabs
+
+- Re-implement on `@base-ui/react`; public API unchanged (behavioral parity).
+- Swap `@mui/base/Tabs` + `@mui/base/TabsList` + `@mui/base/Tab` for `@base-ui/react/tabs` (`Tabs.Root` + `Tabs.List` + `Tabs.Tab`).
+- Restore MUI v4's sliding active-tab underline on horizontal tabs via `Tabs.Indicator` (the Tailwind migration had replaced it with a static per-tab box-shadow). Vertical tabs keep the static per-tab active bar — no slide.
+- Lift the `react` peer cap to `>=16.12.0`.

.changeset/typography-migration.md

@@ -0,0 +1,7 @@
+---
+'@toptal/picasso-typography': major
+---
+
+### Typography
+- Drop `@material-ui/core` peer dependency; widen React peer range to `>=16.12.0`.
+- Remove vestigial `classes` prop from the public type via `Omit<StandardProps, 'classes'>`; runtime backstop discards any inherited value. Behavioral parity verified by snapshot + unit tests; public API unchanged for real consumers (audit-verified: 0 internal, 0 external usages).

.changeset/typography-mui-cleanup.md

@@ -0,0 +1,3 @@
+---
+'@toptal/picasso-typography': patch
+---

.changeset/utils-migration.md

@@ -0,0 +1,11 @@
+---
+'@toptal/picasso-utils': patch
+---
+
+### Utils
+
+- Re-implement off `@material-ui/core`; public API unchanged (behavioral parity).
+- `capitalize` is now a local implementation (identical output to MUI's, including the throw on non-string input).
+- `ClickAwayListener` is now a local Picasso component (same `onClickAway` / `mouseEvent` / `touchEvent` / `disableReactTree` surface).
+- `Rotate180` transition migrated from JSS to Tailwind (`transition-transform duration-150 ease-in-out` + `rotate-180`); animation timing/curve unchanged.
+- Drop `@material-ui/core` peer dependency; widen the `react` peer to `>=16.12.0`.

.claude/settings.json

@@ -0,0 +1,20 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pnpm davinci-syntax *)",
+      "Bash(pnpm davinci-qa *)",
+      "Bash(pnpm eslint *)",
+      "Bash(pnpm exec tsc --noEmit *)",
+      "Bash(pnpm typecheck *)",
+      "Bash(gh search *)",
+      "Bash(bash -n *)",
+      "Bash(pnpm tsc --noEmit *)",
+      "Bash(pnpm changeset status)",
+      "Bash(pnpm changeset status *)",
+      "mcp__playwright__browser_navigate",
+      "mcp__playwright__browser_snapshot",
+      "mcp__playwright__browser_console_messages",
+      "mcp__playwright__browser_take_screenshot"
+    ]
+  }
+}

.envrc.example

@@ -0,0 +1,47 @@
+# Picasso migration orchestrator — environment template.
+#
+# Copy to `.envrc` (repo root, gitignored) OR `~/Projects/.envrc`, fill in,
+# then run `direnv allow`. The orchestrator's loadEnvrcUpwards() walks up from
+# the repo and auto-loads the nearest .envrc via direnv.
+#
+# No direnv? Either `source` this file before `pnpm orchestrate`, or pass the
+# vars inline:  HAPPO_API_KEY=… HAPPO_API_SECRET=… pnpm orchestrate --component=Note
+#
+# NOTE: claude / gh / ssh auth are NOT set here — they're CLI/agent-managed.
+#   See docs/migration/ORCHESTRATOR.md §"First-time setup".
+#   Verify your whole setup at once with: pnpm orchestrate --component=<X> --dry-run
+#   (reads the prerequisite report without starting a real run).
+
+# --- Required for the Happo visual gate ---------------------------------
+# Your personal Happo API credentials, with access to the Picasso Happo org
+# (account 675). Get them from https://happo.io account settings.
+# To run WITHOUT Happo instead, leave these unset and pass
+# MIGRATION_GATE_HAPPO=skip (sandbox / smoke runs only).
+export HAPPO_API_KEY=
+export HAPPO_API_SECRET=
+
+# --- Required for correct pnpm node_modules layout ----------------------
+# Any value works (e.g. `dummy`) — only used to authenticate registry fetches,
+# not for layout. Without it pnpm falls back to the isolated linker and tsc
+# can't resolve React types.
+export NPM_TOKEN=dummy
+
+# --- Optional: model preset (fable | opus) ------------------------------
+# Default: fable (current config — claude-fable-5[1m]). opus is claude-opus-4-8[1m]
+# at the same effort, ≈half fable's per-token cost. Override per-run with
+# `--preset=opus`; `--model` / `--effort` / `--thinking-tokens` override fields.
+# export MIGRATION_MODEL_PRESET=fable
+
+# --- Optional: gate / behavior knobs (env-only) -------------------------
+# Defaults are sensible; uncomment to override per-clone (e.g. a sandbox clone
+# that always skips the visual gate). Full list + effects:
+# docs/migration/ORCHESTRATOR.md §"Environment knobs".
+# export MIGRATION_GATE_HAPPO=skip               # bypass Happo visual gate (sandbox/smoke)
+# export MIGRATION_GATE_CHANGESET=skip           # bypass changeset validation
+# export MIGRATION_GATE_DOCTRINE=skip            # bypass code-doctrine check
+# export MIGRATION_GATE_HAPPO_CYPRESS_STRICT=1   # make Cypress visual diffs gate (default: advisory)
+# export MIGRATION_GATE_HAPPO_CYPRESS=skip       # disable the Cypress visual suite
+
+# --- Optional: Confluence status sync (silently skipped if unset) -------
+# export ATLASSIAN_EMAIL=
+# export ATLASSIAN_API_TOKEN=