pixelize-design-library 2.4.2-beta.61 → 2.4.2-beta.63

package/CHANGELOG.md

@@ -18,6 +18,71 @@ next major.
 
 ### Added
 
+- **`Card variant="elevated"`**: borderless, `background[50]` lifted by `shadows.card`; declares a 0 border width so it
+  never inherits an outline parent's rule.
+- **`bandOn`, `recessOn`, `cardRule`**: plane-step helpers that return the input unchanged in light and a visible step
+  off the dark plane a fill or rule sits on (`raisedRule` now matches `cardRule`'s weight).
+- **`buildDarkPalette`** takes an optional `{ planes: "lifted" | "flat" }` and `buildSurfaceRaised` an optional list of
+  filled marks to keep at 3:1.
+- **`formatDate` / `formatDateTime` / `formatDateRange`**: Intl-based date text, en-IN by default ("09 Oct 2026"),
+  with `locale`, `timeZone`, `year: "never"`, `time: "12h" | "24h"` and a `fallback` (default "—") for null or
+  invalid input instead of "Invalid Date". A bare `YYYY-MM-DD` is that calendar day in every zone; ranges write a
+  shared month and year once. Output is the same across browser and Node ICU versions (no "Sept", no thin or
+  narrow spaces).
+- **`TimePicker`**: inline hour, minute and AM/PM selects as a field (label, required, error, helper), with
+  `use24Hour`, `minuteStep`, `baseDate` and `name`. Same look as DatePicker's time selects. `TimePickerProps` now
+  describes this component; the old `date`, `dateFormat` and `disabled` fields still type-check as deprecated
+  aliases.
+- **`TagInput`**: free-text chips. Enter or comma adds, Backspace removes the last, a pasted list splits on commas
+  and new lines; optional `validate`, `maxTags` and `allowDuplicates`. Same look as `MultiSelect`, without its
+  email lock.
+- **`IconButton`** is now owned: it renders exactly what the Chakra `IconButton` rendered (same props, theme,
+  sizes `xs 24 · sm 32 · md 40 · lg 48 · xl 56`, `isLoading` keeps the box) and, in development, warns once per
+  mount when it has neither `aria-label` nor `aria-labelledby`. `aria-label` is optional in its type.
+- **`FormField`**: label, required asterisk, helper text and error message around any one control. A single
+  child element receives `id`, `aria-labelledby`, `aria-describedby`, `aria-invalid` and `aria-required`, or pass
+  a function that places them on a composite. `TextInput` inside inherits the error and required state.
+  `layout="horizontal"` puts the label in a `labelWidth` column (default 12rem) from `md` up. Root attributes
+  and `ref` land on the root `div`.
+- **`VisuallyHidden`**: text for screen readers only, pinned to the viewport so a hidden live region can never
+  extend a scrolled page. It takes `as`, `ref`, every attribute and style prop.
+- **`SkipLink`**: a "Skip to main content" link that paints nothing until keyboard focus, then shows top-left on
+  the `skipLink` layer. Activating it focuses `#targetId` (default `main-content`) without changing the URL hash.
+- **`Pagination`**: standalone, controlled page navigation. Numbered pages collapse behind ellipses (first
+  and last always show, `siblingCount` defaults to 1), with previous and next buttons and an optional
+  rows-per-page picker (`pageSizeOptions` + `pageSize` + `onPageSizeChange`). `page` is 1-based; the count
+  comes from `pageCount` or from `totalItems` + `pageSize`. `size` follows the Button scale, `isDisabled`
+  disables the pager, `labels` overrides the names. It renders a named `nav` of real buttons and the
+  current page carries `aria-current="page"`. `Table` keeps its own pager unchanged.
+- **`ChoiceCard` / `ChoiceCardGroup`**: radio cards for picking one of a few options that each need a line of
+  explanation. Group: `value` / `defaultValue` / `onValueChange`; card: `label`, `description`, `icon`,
+  `disabled`. One tab stop; arrows, Home and End move focus and selection. Same look as `PaymentOption`.
+- **Plain HTML attributes on the page primitives**: `PageHeader`, `StatCard`, `SaveBar`, `EmptyState`,
+  `DescriptionList`, `FilterBar` and `Skeletons` pass `id`, `className`, `style`, `data-*`, `aria-*` and
+  event handlers to their root element; the component's own props still win and Chakra style props are
+  still not accepted.
+- **`ref` forwarding**: `Checkbox`, `RadioButton`, `ToggleSwitch` and `DatePicker` (single, range and time,
+  including the deep-imported `SingleDatePicker` / `RangeDatePicker` / `TimeOnlyPicker`) forward to their
+  native `<input>`; `SegmentedControl` to its `role="radiogroup"` root; `Tab` to its `role="tab"` button;
+  `Avatar` and `Tag` to their root element.
+- **`PinInput` `error`, `errorMessage`, `helperText` and `isDisabled`**: the message renders under the
+  cells and every digit gets `aria-invalid` / `aria-describedby`.
+- **`WizardDialog` / `Wizard` `finishDisabled` and `finishBlockedReason`**: disable Finish on the last
+  step (a pending upload, say) and show why beside it; the reason is Finish's `aria-describedby`.
+  Back and the stepper keep working; nothing changes when they are not passed.
+- **`CircularProgress` `size` takes a px number** (clamped to 24..160) as well as `sm | md | lg`; stroke
+  and label scale with it (`CircularProgressDiameter` type). The presets render exactly as before.
+- **Token foundation** (web premium/perf campaign; nothing changes on screen until you use them):
+  `RADIUS_ROLE` (radius by surface role), `BORDER_WIDTHS` (px hairline), `DISABLED_OPACITY` (0.5),
+  `NUMERIC_TEXT` (tabular figures), `zIndices.popoverNested` (1510), `fontSizes["xs-minus"]` (11px) and
+  `fontSizes["xs-plus"]` (13px), and `TEXT_STYLES` bound as Chakra `textStyles` (`title`, `heading`,
+  `subheading`, `body`, `ui`, `label`, `caption`, `overline`). Motion: `MOTION_MS.enter` / `.exit`
+  (200ms), `MOTION_BEZIER`, `MOTION_EASE_OUT`, `MOTION_EASE_IN`, `MOTION_LOOP_MS`, `motionTransition()`;
+  `transitionFor` takes an optional curve. `shadowsFor(mode)` returns the shadow ramp a theme carries.
+  Opt-in `reducedMotion="global"` on `PixelizeThemeProvider` and `createBrandTheme` adds one
+  document-wide `prefers-reduced-motion` rule; `pz-motion-keep` (`MOTION_KEEP_CLASS`) opts an element out.
+  The default is unchanged. `CustomThemeProps` gains `zIndices.popoverNested` and the two font sizes, so
+  code that hand-builds a full `CustomThemeProps` needs those keys.
 - **HRMS library requests** — a navigation launcher, key caps, a merge-field `Editor`, a wizard and
   smaller gaps found by the HRMS migration:
   - `NavLauncher` — full-height navigation launcher (browse modules, pins, Frequent, Recent, search
@@ -205,14 +270,60 @@ next major.
 
 ### Changed
 
+- **Performance, no visual change** (web premium/perf campaign):
+  - Theme colour math is memoised (`resolveFilledSurface`, `liftToContrast`, `softenToContrast`,
+    `resolveSoftTone`, luminance) in bounded, content-keyed caches: the hot calls are 5-20x faster and
+    restyling 50 `Button`s and 50 `Checkbox`es dropped from about 1.4 ms to 0.15 ms.
+  - Brand palettes (`lightPalettes`, `darkPalettes`, `palettes`, `<brand>Dark`) and the eight
+    non-default light themes are built on first read instead of at import; keys, key order, values and
+    object identity are unchanged, and importing the theme module is about 2x faster. The `ThemeSwitcher`
+    brand picker no longer builds every brand's Chakra theme when it mounts.
+  - Themes from `createBrandTheme` cache each component style function's output per theme, keyed on the
+    props that function reads: output is identical and style resolution per component render is about 2x
+    faster.
+  - Switching light/dark no longer blocks: the switcher repaints first and the app re-themes in an
+    interruptible render. Document `color-scheme`, `data-mode` and the `--color-*` variables follow the
+    new palette together, never ahead of it. `PixelizeThemeProvider` memoises its Chakra subtree, so the urgent
+    half of a switch re-renders only the switcher.
+  - `KanbanBoard` adopts a new `data` prop during render instead of in an effect, so a board whose data
+    follows the theme renders once per theme flip instead of twice.
+  - `Table`: passing an equal `columns` array again no longer re-renders every visible row; column
+    search popovers and row action menus mount their popover only while open (closed rows register no
+    global listeners); virtualised rows are measured through one shared `ResizeObserver` with no forced
+    layout read on mount.
+  - `ToolTip` mounts Chakra's tooltip only after the first hover or focus of its trigger; until then
+    (and while disabled or without a label) it renders just the child, with no document listeners.
+  - `SideBar`: the swipe-to-close drag no longer re-renders the sidebar or creates a CSS rule per
+    pointer move; row labels share one `ResizeObserver` and pause measuring while the rail width
+    animates, and their tooltips arm on first use. `useIsTruncated` uses a single shared
+    `ResizeObserver`; its signature is unchanged.
+  - `SearchSelect` option rows are memoised, so hovering, ArrowDown and toggling an option re-render only
+    the rows whose state changed (300 options: 300 row renders per hover to 1-2), and the menu's
+    scroll-driven position is an inline style instead of a new Emotion class per position.
+  - `KanbanBoard`: hovering a column and expanding a card no longer re-render the whole board (4 x 30
+    board, hover sweep: 960 card renders to 0); virtualized cards share one `ResizeObserver`.
+  - `Search` instances share one window `keydown` listener for Ctrl+K (it was one per instance);
+    with several on a page the last mounted still takes focus.
+  - `Dropdown` and `SelectSearch` add their outside-click `document` listener only while open, so closed
+    instances cost nothing on every page click.
+  - `MediaVideoPlayer` and `MediaAudioPlayer` no longer re-render the whole player on each `timeupdate`;
+    only the scrubber and the time readout update.
+  - `RangeSlider`, `MediaImageViewer` (pan/zoom), `FilterSidebar` (range slider), the media scrubber and
+    the `Dropdown` menu position apply per-frame values as inline styles, so dragging, panning and
+    scrolling no longer insert a CSS rule per value (40 slider moves used to leave 160 rules behind).
+  - `Notification` and `UpgradeButton`: the card and dismiss control transition named properties instead
+    of `all` (same 0.2s ease), and both drop their transitions, the shimmer sweep and the hover lift under
+    `prefers-reduced-motion`.
+  - `CalendarGrid` reuses `Intl.DateTimeFormat` instances per locale and options (was about 70 per
+    month render). `Toaster` cards no longer hold a permanent `will-change` layer.
 - **`PageHeader` `actionsLayout` defaults to `"auto"`**: at `md` and up the actions wrap below the
   title when they do not fit (before, they squeezed the title). Identical whenever title and
   actions fit on one row; pass `actionsLayout="inline"` for the old behaviour.
 - **`Card` `padding` is no longer Chakra's style prop** — it is omitted from the type and now takes
   the `CardPadding` steps. A consumer passing `padding={4}` gets a compile error; use `p` or `sx`.
   Staged for the next major (see Breaking); consumer blast radius not measured.
-- **`SideBar` default box-shadow transition is 260ms** (was 200ms) so it follows `collapseTransition`
-  `speed="slow"`. The width transition is unchanged.
+- **`SideBar` `collapseTransition` defaults to `{ speed: "base" }`** (200ms width and shadow, was 260ms).
+  Pass `{ speed: "slow" }` for the old pace.
 - **`StageProgress variant="stepper"` renders an `ol` of `li`** (`StepperStageProps.asListItem`).
   Visual layout is unchanged; selectors that expected a `div` list no longer match.
 - **`PdfViewer` `pdfUrl` is optional** — pass exactly one of `pdfUrl` / `getBlob`. In `getBlob` mode
@@ -268,8 +379,118 @@ next major.
   `aria-readonly`, and `m`/`mt`/`mb`/`ml`/`mr`/`mx`/`my` on the wrapper. `InputSwitch` is now a
   genuine thin wrapper — no prop it previously accepted is silently dropped.
 
+### Changed (visual)
+
+- **Elevation follows Pebble, per mode.** `shadows.sm`/`base`/`md`/`lg` are the Pebble card-press/
+  card/float/dialog stacks, with new `card`, `float`, `dialog` and `sheet` role keys. Light shadows are
+  softer and wider; dark mode gets its own heavier black ramp, so overlays cast a visible shadow on a
+  dark canvas. `xs`, `xl`, `2xl`, `inner`, `none`, `darkLg` and the focus `outline` are unchanged.
+- **`Menu` and `Popover` join the owned popup family:** radius `md` → `xl` (`RADIUS_ROLE.float`)
+  and shadow `sm` → `md` (float), like every other anchored popup. Their border stays.
+- **`fonts.mono` is a real monospace stack** (`ui-monospace, SFMono-Regular, Menlo, Consolas,
+  monospace`). It was Inter, so code and keyboard shortcuts never aligned.
+- **`Button` gray `ghost`/`outline` hover is visible.** Gray has no opacity ramp, so hover/active
+  take the list-row `active`/`selectedActive` steps (at least 1.15:1 on a card, all 9 brands x 2 modes)
+  instead of `gray.50` (1.04-1.08:1). `solid` and `gradient` hover no longer add a box-shadow; the
+  colour step carries hover.
+- **`Toaster` status-icon pulse** animates a pseudo-element's transform and opacity (scale 1 to 1.5,
+  faded out by 70%, the same 900 ms one-shot) instead of `box-shadow`, so it no longer repaints every
+  frame. The icon chip background is the same tint composited opaque over the toast surface.
+- **`Table` filter sidebar** opens on the 200 ms motion token (was 500 ms), does not animate on
+  mount, and is instant under reduced motion.
+- **`FileUpload` image thumbnails are a keyboard-operable "Preview <file name>" button**: a new tab
+  stop with the library focus ring; Enter or Space opens the preview. Each image row now has two
+  buttons (Preview and remove), so a test that queries an unnamed `getByRole("button")` inside a row
+  must name the one it means.
+- **`Menu` item highlight sits inside the menu.** A themed `MenuItem`/`MenuItemOption` is
+  `calc(100% - 2 * mx)` wide, so its hover/focus fill keeps the same 6px inset on both sides instead of
+  overhanging the menu's right edge by 6px. Menu size and row height are unchanged; a `MenuItem` given
+  its own `w`/`width` keeps that width.
+- **`Skeleton` shimmer is one depth on every brand and mode**: 1.35:1 between its two colours (the
+  mobile library's `SKELETON_SHIMMER_CONTRAST`), was 1.34-1.58:1 in light and 1.93-1.99:1 in dark. The
+  end colour is `gray[300]`'s tint settled against `gray[100]`; dark skeletons pulse much more gently.
+  An explicit `startColor`/`endColor` still wins.
+
+- **Motion comes from the tokens.** `SideBar`, `Notification`, `Toaster`, the Table settings sheet,
+  `ProfilePhotoViewer`, `TableToggle` and `StageProgress` take every duration and curve from the motion tokens
+  (colour fades 150ms, movement 200ms, enters on `MOTION_EASE_OUT`, exits on `MOTION_EASE_IN`). Most timings
+  move by under 60ms; the Table settings sheet goes from 400ms to 200ms. `Notification` cards no longer lift
+  2px on hover; the shadow still deepens.
+- **`Button` (solid, outline, ghost) and `IconButton` scale to 0.98 while pressed** (`MOTION_PRESS_SCALE`).
+  Never when disabled or loading, nor under `prefers-reduced-motion`.
+- **Dark planes carry the brand hue and separate by lift.** The dark canvas takes a faint brand tint and cards
+  (`background[50]`) sit one step (1.16:1) above it, with overlays (`surfaceRaised`) one step (1.15:1) above
+  the card; every filled mark keeps 3:1 on all three. Light mode is unchanged. A brand opts out with
+  `buildDarkPalette(light, { planes: "flat" })`. `meadow` and `rosewood` dark `accentText` move one rung
+  lighter so they clear AA on selected list rows.
+- **`zinc`:** muted text in light mode is `#515157` (was `#27272a`, 14.9:1), settled under a new 8:1 muted
+  ceiling; zinc's dark card is no longer darker than its canvas.
+- **A brand's primary never reads as danger.** `radiant`'s danger colour (`red` and `semantic.error`) is
+  crimson and `rosewood`'s primary rotates toward raspberry; a delta-E >= 10 gate in `brandIdentity.test.ts`
+  covers all 9 brands in both modes.
+- **`Button` solid primary paints `resolveFilledSurface`.** Only `zinc` dark moves: the primary fill goes from `#52525b` with
+  white ink (2.5:1 on the canvas) to `#e4e4e7` with black ink, matching `resolveFilledSurface`, the fill every other filled surface already paints.
+- **Dark mode: header strips, calendar off-days and in-card rules step visibly off the lifted planes.** Table header
+  strips (`CustomModulesTable`, `SignInActivityTable`), `DatePicker` weekly-off cells, and the rules inside cards and
+  dialogs (`Table`, `SettingRow`, `SettingsSection`, `StatCard`, `Drawer`, `Modal`, `ConfirmDialog` and the account
+  modals) now clear 1.15:1 (bands) and 1.31:1 (rules) off their plane. Light mode is unchanged.
+- **`Card` defaults to `variant="elevated"`** (borderless, `background[50]` lifted by `shadows.card`). Pass
+  `variant="outline"` for a Card that frames a table or a list of rows. Measured blast radius: 22 library `<Card>`
+  sites with no variant flip (hrms 18, account 1, tickets 3); 305 with an explicit variant are unchanged. The
+  `SettingsSection` danger zone keeps its red frame by taking `variant="outline"`.
+- **Light page canvas (`backgroundColor.base`) sits 1.09:1 below the card on all 9 brands**, so a borderless card keeps
+  its top edge (zinc and slate `#fafafa` to `#f5f5f5`, lavender `#fbfafd` to `#f5f4f8`). `main` and every other token
+  are unchanged.
+
 ### Fixed
 
+- **`Table` settings sheet** fades in place instead of dropping in when the user prefers reduced motion.
+- **`SearchSelect`**: the Select All and Add New rows are reachable from the keyboard. Arrow keys, Home and End walk
+  Select All, then the options, then Add New, and Enter runs them. Both are now `role="option"` rows, so a test that
+  counts `getAllByRole("option")` with either row shown sees one or two more.
+- **Field helper text no longer leaves a dangling `<id>-helptext` in `aria-describedby`** when a field with an
+  explicit `id` sits inside a consumer `FormControl` (`TextInput` and every field rendering
+  `FieldMessage`/`HelperText`).
+- **`SearchSelect` and `Select` (`native={false}`) multi rows**: the decorative checkbox is no longer a focusable,
+  unnamed control nested in the option; the row's `role="option"` with `aria-selected` is the single accessible
+  control. No visual change.
+- **`SearchSelect`'s open listbox and `Select`'s popup dialog have an accessible name**, from `label`, then
+  `aria-label`, then `placeholder`.
+- **`WorkspaceWindow`'s dialog is named by its visible title**; while a window is open the page behind it is
+  `aria-hidden`, as for any modal.
+- **`CustomModulesTable`'s edit-module field is named** by `labels.moduleNamePlaceholder`.
+- **`StageProgress` no longer scrolls the page when it mounts**: the active stage was revealed with
+  `scrollIntoView`, which also scrolled every ancestor, so a tracker below the fold pulled the page down
+  to it. The active stage is now centred inside the stage strip only (`scrollActiveIntoView` still
+  turns that off).
+- **`Tabs` no longer scrolls the page when it mounts**: the selected tab was revealed with
+  `scrollIntoView`, which also scrolled every scrolling ancestor, so a page with tabs below the fold
+  jumped to them on load. The first reveal now scrolls only the tab list; later focus and selection
+  moves behave as before.
+- **The legacy `DatePicker` behind Table's filter pane opens from the keyboard**: Enter or ArrowDown on the
+  focused field opens the calendar (it was mouse-only).
+- **Keyboard access for click-only elements** (WCAG 2.1.1): `NoteTextArea` (the collapsed placeholder and
+  the attach control, now a named button "Attach files"), `Notification` (the title when `onClick` is
+  passed; the dismiss control is announced as "Dismiss notification"), `OrganizationDetails` ("Set as
+  Default"), `UserDetails` (member rows, the selected one marked `aria-current`), `FileUploader` (the drop
+  target opens the picker from the keyboard; it was the only way to add files), `KanbanBoard` (both
+  add-column affordances) and the `SearchSelect` `insideSelect` prefix and menu (Enter/Space, arrow
+  keys, Home/End, Escape). Each takes Tab, activates on Enter and Space, and shows the library focus
+  ring on keyboard focus only; resting looks are unchanged.
+- **`ProductCard` no longer throws "Rendered more hooks than during the previous render"** when `isLoading`
+  goes from `true` to `false` (a hook sat below the loading early return).
+- **`KanbanBoard` no longer logs React's "Cannot update during an existing state transition"** when a
+  card is expanded in a virtualized column.
+- **`PhoneNumberInput` follows a changed `value`.** It used to read `value` once on mount; a form reset
+  or a loaded record now updates the field, and a leading dial code (the `onChange` shape) is stripped,
+  so echoing `onChange` back into `value` is safe.
+- **`CopyButton variant="menu-item"` is keyboard-operable** (focusable, Enter and Space copy, focus
+  ring), and every variant announces the copied label through a polite live region.
+- **`Slider` no longer auto-advances while hovered or focused, nor under reduced motion** (WCAG 2.2.2);
+  the slide transition is instant under reduced motion. The default interval is unchanged.
+- **`FileUpload` no longer leaks a blob URL per image thumbnail per render.** Each file gets one URL,
+  revoked when the file is removed or the component unmounts.
+- **`Table` column search shows the current search when reopened**, instead of stale text.
 - **`NavigationBar` right cluster no longer overflows onto the avatar at phone widths.** The title
   truncates first (overflow-only tooltip when it is a string); the `moreIcon` cluster can shrink, while
   the sidebar toggle, back button and avatar menu never do. (HRMS, beta.60 launcher trigger overflow)
@@ -517,6 +738,11 @@ next major.
 
 Nothing is removed yet — each of these still ships its full implementation.
 
+- `UploadedFile.type` (FileUploader) — never set; read the extension from `name`.
+- `ProfileCard` `color` — no visual effect; Card styles never read a colour scheme.
+- `NotificationData.status` — never read; the status dot colour comes from `dueDate`/`endDate`.
+- `CustomModulesTableLabels.loading` — never rendered; the loading state shows skeleton bars only.
+- `WorkspaceWindow` `onMedium` and `onMaximize` — never called; the window has no such controls.
 - `NavLauncher` `openShortcutHint` and `LauncherLabels.hintOpenMenu` — no longer rendered (the launcher
   is already open when its footer shows); bind the open chord in the app only.
 - `SelectV2` — use `Select` with `native={false}`; it is already a thin wrapper over it.

package/COMPONENT-GOTCHAS.md

@@ -157,7 +157,8 @@ visible at the call site, or declare the handler with both parameters. Grep for
 
 ### `Slider` is an image carousel, not a numeric range input
 
-`Slider` auto-advances a set of images/content on a timer — no numeric value, min/max, or step. The
+`Slider` auto-advances a set of images/content on a timer (paused while hovered or focused, never
+under reduced motion) — no numeric value, min/max, or step. The
 range-input slider is a separate component named `RangeSlider`, because this library's `Slider`
 already owns the name. `RangeSlider` used to be a Chakra passthrough on the `Primitives` barrel; it
 is now the library's own themed component, with a real dual-thumb mode and a `marks` prop.
@@ -214,7 +215,7 @@ and wires `aria-controls` to them. Pick by that, never by the picture. A screen
 
 | Need | Component | Why not the others |
 | --- | --- | --- |
-| Generic bordered/padded container, no commerce semantics | `Card` | Layout wrapper with `header`/`footer` slots and a padded body — see gotcha below |
+| Generic padded container (borderless by default; `variant="outline"` for a ruled one), no commerce semantics | `Card` | Layout wrapper with `header`/`footer` slots and a padded body — see gotcha below |
 | Product tile for a grid, list or rail (photo, price, rating, swatches, quick add) | `ProductCard` | Takes the same `axes` / `variants` as `ProductDetails`; for a whole page use `ProductDetails` |
 | A KPI figure with delta and sparkline | `StatCard` | Not a product or a container |
 | Subscription/pricing-tier card (plans, billing cycle, feature list) | `PaymentCard` | Takes a `Plan` object, unrelated to `options`/`productImage` |
@@ -319,6 +320,53 @@ not enough when the overlay sits inside a transition wrapper — the wrapper kee
 
 ## Known gotchas (silent failures)
 
+### `withTheme` mounts a full provider stack per wrapped instance
+
+Each wrapped component gets its own `ChakraProvider` (CSS reset, global styles, CSS variables), `ToasterProvider` and `ColorModeScript`. Wrap the app root once with `PixelizeThemeProvider`; never wrap list items or repeated rows.
+
+### `SearchSelect` with `insideSelect` shows a second `role="listbox"` while open
+
+A test that finds the main dropdown with `getByRole("listbox")` must now pick it by id (`<id>-listbox`).
+
+### `ChoiceCardGroup`'s children must be `ChoiceCard` elements, and the prop is `disabled`
+
+A wrapper component hides each card's `value` and `disabled` from the roving tab stop, so with nothing
+selected the group has no Tab stop at all (same rule as `PaymentOptionGroup` / `AddressCardGroup`). The
+card's prop is `disabled`, not `isDisabled`: the shared machinery reads `disabled` off the child element.
+The group is a column only.
+
+### `Pagination` never resets `page` for you
+
+An out-of-range `page` (a filter shrank the result) is displayed clamped but never reported, and changing
+rows per page does not reset `page` either. Reset it yourself, in `onPageSizeChange` and when the filters change.
+
+### Four components with a behaviour their props do not hint at
+
+- `WorkspaceTrayPreview` `onOpenChange(false)` also fires when the pointer leaves before the card ever opened; track your own open state from `true`.
+- `Notification`'s countdown is computed when its dates change and never ticks; remount or change a date to refresh it. Overdue labels read "overdue by N hours ago".
+- `NoteTextArea` checks `maxNoteWordCount` against the title only until the note is next edited, so a long title can be saved; `handleCancel` always receives `false`.
+- `VerifyEmailOtp` fields set `autocomplete="off"`, so browser or OS one-time-code autofill never offers the code.
+
+### Where `ref` lands, and what does not take one
+
+`Checkbox`, `RadioButton`, `ToggleSwitch` and `DatePicker` (every mode) forward to the native `<input>`.
+`SegmentedControl` forwards to the radiogroup `<div>`, not a segment; `Tab` to its tab `<button>` (`Tabs`
+itself takes no ref); `Avatar` to the outer box; `Tag` to its root, which is a `<button>` only for
+`display="dot"` with `onTagClick`, so type that ref as `HTMLElement`. `PinInput`, `FileUpload`,
+`SettingRow` and `Tabs` do not forward a ref.
+
+### Root attributes on the page primitives, and `Skeletons` props that are ignored
+
+`PageHeader`, `StatCard`, `SaveBar`, `EmptyState`, `DescriptionList`, `FilterBar` and `Skeletons` put
+`className`, `style`, `id`, `data-*` and `aria-*` on their outermost element. `StatCard` applies
+`aria-label` only when `onClick` makes it a button; `DescriptionList`'s loading grid keeps its own
+`aria-label="Loading"`. `Skeletons` still accepts `alignSelf` and `flexShrink` in its type but never
+applies them; wrap it in a `Box` to position it.
+
+### `Table` `HeaderActions` item with `customComponent` and `onClick` is mouse-only unless the custom component is focusable
+
+The wrapper is deliberately not a button; make the custom component a button, or the action cannot be reached from the keyboard.
+
 ### Defaults changed in 2.4.2-beta.44 — read this first when upgrading from beta.43
 
 | Component | beta.43 → beta.44 | Restore the old look |
@@ -353,7 +401,7 @@ not enough when the overlay sits inside a transition wrapper — the wrapper kee
 | `InputTextArea` / `FileUpload` / `TextInput` | Width 500px → 100% / `maxSizeKB` 5 → 5120 / no default "Placeholder" text | `width="500px"` / — (5 KB was a bug) / — |
 | `DatePicker` (no `pickerType`) | Inference is case-sensitive: `MM` is month, `mm` minutes. `dd/MM/yyyy` was misread as date+time and showed time selects; it is now date-only | `pickerType="datetime"` |
 | `EmptyState` | Title is an `h3`; image is decorative (`alt=""`, was the title) | `titleAs`, `imageAlt` |
-| Theme `Badge` / `Card` / field labels | Badge: pill, no uppercase, default `sm`. Card: default variant `outline`. Label colour `text[700]`; helper/error row 12px | `size`/`variant` props |
+| Theme `Badge` / `Card` / field labels | Badge: pill, no uppercase, default `sm`. Card: default variant `elevated` (borderless, `shadows.card`). Label colour `text[700]`; helper/error row 12px | `size`/`variant` props |
 | `Header` | `position: sticky; top: 0`, z-index `sticky` (1100, was 1000); `rightSlot` mounts once, not per layout | — |
 | `Table` | Radius `xl`; row height 32/40/52 by density; filter button is named "Filter {label}" (tests querying "Search" break); client pagination resets to page 1 when `data.length` changes | — |
 | `KanbanBoard` | `height`/`maxH` props replace the clipping wrapper; `height="100%"` needs a parent with a definite height | — |
@@ -465,12 +513,40 @@ so the two schemes were indistinguishable. It is now `primary`'s hue turned 60°
 which is near-grey and has almost no hue to turn — use a semantic scheme (`blue`, `teal`, `purple`)
 there if the two categories must read apart.
 
+### Brand palettes and non-default themes are lazy; library style functions may return cached objects
+
+Before its first read, a brand palette or a non-default light theme is an object of getters. Reading
+any key turns it into plain data; spread, `Object.keys`, JSON and assignment behave as before, but
+`Object.getOwnPropertyDescriptor` reports an accessor until then. Style functions in a library
+theme's `theme.components` receive props through a tracking Proxy and may return a cached object, so
+never mutate what they return.
+
+### Reduced motion is per component unless the app passes `reducedMotion="global"`
+
+The library's own animations honour `prefers-reduced-motion` one component at a time. For one
+document-wide rule, pass `reducedMotion="global"` to `PixelizeThemeProvider` (or `createBrandTheme`);
+transitions and animations then collapse to one near-instant pass. Add `pz-motion-keep`
+(`MOTION_KEEP_CLASS`) to any loop that is essential feedback; Chakra spinners and progress bars are
+kept automatically.
+
+A popup opened inside another popup takes `zIndex="popoverNested"` (1510), never `skipLink` (1600).
+`fontSize="xs-plus"` is 13px, the control size; use it instead of a `13px` literal.
+
 ### Your own overlay painted `background[50]` sinks into the dark canvas
 
-In dark mode `background[50]` equals the page canvas on 8 of 9 brands. Library dialogs, drawers,
-popovers and menus now paint `colors.surfaceRaised` — identical `#ffffff` in light, one elevation
-step up in dark. A custom panel, popover or `ModalContent bg=` in an app should read
-`surfaceRaised` too, and a divider inside it `raisedRule(colors)`.
+In dark mode `background[50]` is the card plane, one step above the canvas; an overlay painted with it
+merges into the cards under it. Library dialogs, drawers, popovers and menus paint `colors.surfaceRaised`,
+one step above the card in dark and identical `#ffffff` in light. A custom panel, popover or
+`ModalContent bg=` should read `surfaceRaised` too, and a divider inside it `raisedRule(colors)`.
+
+### Named fills nearly vanish on a dark card
+
+In dark mode `backgroundColor.light`, `tertiary`, `medium` and `tableHeader` sit only 1.01-1.05:1 off
+`background[50]`, `muted` 1.00-1.06:1 off `surfaceRaised`, and `boxborder[200]` 1.10-1.16:1 off a card and
+1.00-1.06:1 off `surfaceRaised`. Never paint a named canvas fill or raw `boxborder[200]` on a card or overlay:
+use `bandOn(fill, surface)` for a header strip, hover or selection tint, `recessOn(fill, surface)` for a shaded
+or off cell, `cardRule(colors)` for a rule inside a card and `raisedRule(colors)` for a rule inside an overlay.
+All four return the old value unchanged in light mode.
 
 ### `Drawer` / `Modal` / `ProfileCard` drop any child that isn't a named slot — use `portalChildren`
 
@@ -961,6 +1037,13 @@ only-when-truncated (the opposite of the prop's contract).
 **Apply:** give `overflowOnly`/`OverflowToolTip` exactly one real element as `children` (e.g. a
 single `Text noOfLines`), never a Fragment or bare text.
 
+### `ToolTip` mounts Chakra's tooltip only after the first hover or focus
+
+Until the trigger is hovered or focused (or `isOpen`/`defaultIsOpen` is set), `ToolTip` renders just the
+child, with no tooltip element and no document listeners. A test that mocks Chakra's `Tooltip` and
+expects it mounted at render time must hover or focus the trigger first
+(`fireEvent.pointerEnter(trigger)` or `userEvent.hover`).
+
 ### `Toaster`'s `showToast({ children })` is a dead prop, and its two `onClose`s are different functions
 
 `children` is `@deprecated` and never read — only `title`/`description`/`actions` render. The `onClose` you pass to `showToast` is wired to
@@ -1146,6 +1229,9 @@ wrong-type file. Exceeding `maxFiles` silently truncates the list with no error.
 
 **Apply:** need real file bytes or enforced validation → use `FileUpload`, not `FileUploader`.
 
+Each image's `previewUrl` is a `blob:` URL that `FileUploader` never revokes. Call
+`URL.revokeObjectURL` when you drop the entry or unmount. (`FileUpload` revokes its own thumbnail URLs.)
+
 ### `DatePicker`'s `pickerType` does nothing when `isRange` is set, and no variant has a seconds control
 
 `RangeDatePicker` never reads `pickerType` — whether time inputs show is controlled entirely by
@@ -1395,6 +1481,13 @@ It spreads after the built-in `bg`/`_hover` that encode `isExpanded` state — p
 **Apply:** style around the defaults via `customStyles` (merged through `sx`) when the highlight
 must survive.
 
+### `Table`: memoise `columns` if users can hide or reorder columns without `savePreferences`
+
+A new `columns` identity re-applies the column defaults and discards those local changes. Passing an
+equal array again no longer costs a re-render, but the reset still happens.
+
+**Apply:** define `columns` at module level or in `useMemo`.
+
 ### `Table`'s `LeftFilterPane` Clear All only re-applies filters in `"sidebar"` mode
 
 `handleClear` calls `onClear` unconditionally, but only calls `onApply(cleared)` when
@@ -1764,3 +1857,47 @@ text. Column widths come from the rendered DOM, never from label length, so sizi
 
 **Apply:** set `labelText` on every node label; put an `isTruncated` `Text` inside the node if it
 can outgrow the column.
+
+### `FormField`, `IconButton`, `SkipLink`: what their props do not hint at
+
+- **`FormField` + library fields:** `TextInput` inherits FormField's `error` and `isRequired` because it checks
+  for a parent `FormControl`. `InputTextArea`, `NumberInput`, `Select`, the date pickers and `PhoneNumberInput`
+  wrap themselves in their own and do **not**: pass `error`/`isRequired` to those directly, and never give a
+  wrapped field its own `label` as well, or it renders two.
+- **`FormField isRequired` sets native `required` on Chakra-based controls** (as Chakra's `FormControl` does), so
+  the browser blocks an empty submit. Add `noValidate` to the `<form>` if you validate yourself. Native children
+  get `aria-required` only.
+- **`FormField` children:** pass one element or a function. A Fragment is rendered untouched and gets no wiring.
+  `id` is the control's id (the root takes none); a child's own `id` is adopted when FormField has none.
+- **`IconButton` warns once per mount in development without `aria-label`/`aria-labelledby`.** `title` does not
+  count. Size the icon yourself (xs 12 · sm 14 · md 16 · lg 18): the button does not resize it.
+- **`SkipLink`** must be the first focusable element on the page. Its target gains `tabindex="-1"` if it is not
+  focusable, and keeps it. A missing target falls back to the browser's hash jump (and warns in development).
+
+### `formatDate`, `TimePicker`, `TagInput`: what their props do not hint at
+
+- `formatDate` reads a bare `YYYY-MM-DD` as that calendar day, not UTC midnight. Pass a `Date` only when you mean
+  an instant. Epoch *seconds* are not detected: multiply by 1000 first.
+- `TimePicker` fires `onChange` with a `Date` on the day of `value` (else `baseDate`, else today). It never clears
+  to `null`, so put a Clear action beside it if one is needed.
+- For free-text chips that are not email addresses use `TagInput`: same look as `MultiSelect`, any text, with
+  your own `validate`.
+- **Button press scale matches a real `:active` only.** A `MenuButton as={Button}` held open by Chakra's
+  `data-active` keeps the darker pressed fill but does not stay at 0.98. A consumer `_active={{ transform }}`
+  loses to the press rule while the pointer is down; use `variant="unstyled"` or an `sx` `&:active` with
+  `!important`.
+
+### `Card` is borderless by default (`elevated`)
+
+A Card that frames a table or a list of rows needs `variant="outline"`. `borderColor` alone shows nothing, because
+the default border width is 0, and the outline rule is Chakra `gray[200]`, not `boxborder[200]`. Paint the page with
+`backgroundColor.base`: on `backgroundColor.main` a borderless card can be white on white.
+
+### `Select` / `SearchSelect` multi rows have no checkbox role
+
+Query rows with `getAllByRole("option")` and check `aria-selected`. The row's checkbox is decorative and no longer
+exposes `role="checkbox"`, so `getByRole("checkbox")` finds nothing inside the popup.
+
+### Page behind an open `WorkspaceWindow` is `aria-hidden`
+
+While a window is open (not minimized) role queries for background elements need `{ hidden: true }` or a test id.

package/DESIGN-GUIDE.md

@@ -12,15 +12,21 @@ tickets `layoutDensity.ts`), use it — it encodes these same rules. Otherwise t
 
 Calm, dense, professional SaaS admin — Linear/Stripe-dashboard, not a landing page.
 
-- **Hierarchy comes from type and whitespace, not boxes.** One border per surface. Never nest a
-  bordered card inside a bordered card; inside a card, separate with spacing or a `Divider`.
+- **Hierarchy comes from type and whitespace, not boxes.** One surface per level. Never nest a
+  card inside a card; inside a card, separate with spacing or a `Divider`.
 - **One primary action per view.** One `variant="solid"` button in the page header; everything
   else `outline` or `ghost`. The only exception is a composer's Send button.
 - **Left-aligned, scannable.** Titles and forms left-aligned; numbers right-aligned in tables.
 - **Color means something.** Neutral by default; brand color for the primary action and selection;
   semantic color only for status. No decorative gradients, no colored section backgrounds.
-- **Borders, not shadows, for resting surfaces.** Shadows only on floating things (menus, popovers,
-  modals) and on hover of a card that is itself clickable.
+- **Content cards float, data surfaces are ruled.** `Card` is borderless by default
+  (`variant="elevated"`: `background[50]` lifted by the soft `shadows.card`). Tables, filter bars,
+  list panes and fields keep their 1px `boxborder[200]` rule; a `Card` that frames a table or a
+  list of rows takes `variant="outline"`. Heavier shadows only on floating things (menus,
+  popovers, modals) and on hover of a card that is itself clickable.
+- **Paint the page with `backgroundColor.base`.** In light mode it sits one step (1.09:1) below
+  the card, which is what gives a borderless card its top edge; `backgroundColor.main` is a
+  component surface and can be as white as the card.
 
 ## 2. Spacing (Chakra units, 1 = 4px)
 
@@ -228,7 +234,8 @@ hides its primary; when only one section is empty on a populated page, that sect
 - Reaching for `SelectV2`, `SearchSelect`, `SelectSearch` in new work — all `@deprecated`.
   One picker now: `Select` (`native={false}` for the themed, searchable, multi popup).
   `Dropdown` is the exception — it is an action menu, not a picker, and is not replaced.
-- A bordered card inside a bordered card; a shadow on a resting card.
+- A card inside a card; a border on a content `Card` (it is borderless by default), or any resting
+  shadow heavier than `shadows.card`.
 - Painting a whole table cell with a status color — use a `Tag` in the cell.
 - Centered page titles, hero-sized headings, `size="lg"` buttons, or `size` props restating the default.
 - More than one solid button in a view; a destructive action without `AlertDialog`.

package/dist/Components/Accordion/Accordion.js

@@ -22,13 +22,13 @@ const Accordion = ({ allowMultiple, allowToggle, index, onChange, reduceMotion,
             var _a;
             return ((0, jsx_runtime_1.jsx)(react_2.AccordionItem, { border: "1px solid", borderColor: border, borderRadius: "xl", bg: colors.background[50], boxShadow: "none", mb: 3, overflow: "hidden", _last: { mb: 0 }, ...item.itemProps, sx: (_a = item.customStyles) === null || _a === void 0 ? void 0 : _a.itemStyle, children: ({ isExpanded }) => {
                     var _a, _b, _c;
-                    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("h2", { children: (0, jsx_runtime_1.jsxs)(react_2.AccordionButton, { px: 4, py: 3, gap: 3, fontSize: "0.875rem", fontWeight: 600, color: headingColor, bg: isExpanded ? expandedBg : "transparent", transition: (0, motion_1.transitionFor)(["background-color"]), _hover: { bg: isExpanded ? expandedBg : softHover }, _focusVisible: focusRing, ...item.buttonProps, sx: {
+                    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("h2", { children: (0, jsx_runtime_1.jsxs)(react_2.AccordionButton, { px: 4, py: 3, gap: 3, fontSize: "sm", fontWeight: 600, color: headingColor, bg: isExpanded ? expandedBg : "transparent", transition: (0, motion_1.transitionFor)(["background-color"]), _hover: { bg: isExpanded ? expandedBg : softHover }, _focusVisible: focusRing, ...item.buttonProps, sx: {
                                         ...(0, motion_2.reducedMotionSx)(),
                                         ...(_a = item.customStyles) === null || _a === void 0 ? void 0 : _a.buttonStyle,
                                         "&:hover": {
                                             ...(_b = item.customStyles) === null || _b === void 0 ? void 0 : _b.hoverbuttonStyle,
                                         },
-                                    }, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", flex: "1", textAlign: "left", children: item.header }), (0, jsx_runtime_1.jsx)(react_2.Flex, { align: "center", justify: "center", boxSize: "1.5rem", flexShrink: 0, borderRadius: "lg", color: isExpanded ? colors.accentText : colors.textMuted, bg: isExpanded ? colors.primary.opacity[16] : "transparent", transform: isExpanded ? "rotate(180deg)" : "rotate(0deg)", transition: (0, motion_1.transitionFor)(["transform", "color", "background-color"], "base"), sx: (0, motion_2.reducedMotionSx)(), children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: 16 }) })] }) }), (0, jsx_runtime_1.jsx)(react_2.AccordionPanel, { px: 4, pt: 1, pb: 4, fontSize: "0.875rem", lineHeight: "1.5", color: bodyColor, ...item.panelProps, sx: (_c = item.customStyles) === null || _c === void 0 ? void 0 : _c.panelStyle, children: item.content })] }));
+                                    }, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", flex: "1", textAlign: "left", children: item.header }), (0, jsx_runtime_1.jsx)(react_2.Flex, { align: "center", justify: "center", boxSize: "1.5rem", flexShrink: 0, borderRadius: "lg", color: isExpanded ? colors.accentText : colors.textMuted, bg: isExpanded ? colors.primary.opacity[16] : "transparent", transform: isExpanded ? "rotate(180deg)" : "rotate(0deg)", transition: (0, motion_1.transitionFor)(["transform", "color", "background-color"], "base"), sx: (0, motion_2.reducedMotionSx)(), children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: 16 }) })] }) }), (0, jsx_runtime_1.jsx)(react_2.AccordionPanel, { px: 4, pt: 1, pb: 4, fontSize: "sm", lineHeight: "1.5", color: bodyColor, ...item.panelProps, sx: (_c = item.customStyles) === null || _c === void 0 ? void 0 : _c.panelStyle, children: item.content })] }));
                 } }, idx));
         }) }));
 };

package/dist/Components/AddressCard/AddressCard.js

@@ -7,6 +7,7 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const react_2 = require("@chakra-ui/react");
 const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const typography_1 = require("../../Theme/tokens/primitives/typography");
 const selectable_1 = require("../CheckoutKit/selectable");
 const Button_1 = __importDefault(require("../Button/Button"));
 const Tag_1 = __importDefault(require("../Tag/Tag"));
@@ -20,6 +21,6 @@ const AddressCard = ({ value, name, phone, lines, tag, isDefault = false, note,
     const copy = { ...DEFAULT_LABELS, ...labels };
     const { isSelected, interactive, inGroup, ringed, props } = (0, selectable_1.useSelectable)({ value, selected, disabled, onSelect });
     const selectable = inGroup || !!onSelect;
-    return ((0, jsx_runtime_1.jsxs)(react_2.Flex, { direction: "column", "data-testid": testId, "data-selected": isSelected || undefined, ...(0, selectable_1.selectableSurface)(colors, { selected: isSelected && selectable, disabled, interactive, ringed }), children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { ...props, "data-radio": true, "aria-disabled": selectable && disabled ? true : undefined, "aria-labelledby": props.role ? nameId : undefined, "aria-describedby": props.role ? bodyId : undefined, gap: 3, p: 4, pb: onEdit || onRemove ? 2 : 4, borderRadius: "1rem", cursor: interactive ? "pointer" : "default", outline: "none", align: "flex-start", children: [selectable && ((0, jsx_runtime_1.jsx)(react_2.Box, { mt: 0.5, children: (0, jsx_runtime_1.jsx)(selectable_1.RadioIndicator, { selected: isSelected }) })), (0, jsx_runtime_1.jsxs)(react_2.Flex, { direction: "column", gap: 1, flex: 1, minW: 0, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, wrap: "wrap", children: [(0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", id: nameId, fontSize: "sm", fontWeight: 700, lineHeight: 1.4, color: colors.header[900], children: name }), tag && (0, jsx_runtime_1.jsx)(Tag_1.default, { label: tag, size: "xs", tone: "neutral" }), isDefault && (0, jsx_runtime_1.jsx)(Tag_1.default, { label: copy.default, size: "xs", tone: "neutral" })] }), (0, jsx_runtime_1.jsxs)(react_2.Box, { id: bodyId, children: [lines.map((line) => ((0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", display: "block", fontSize: "sm", lineHeight: 1.5, color: colors.text[800], children: line }, line))), phone && ((0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", display: "block", mt: 1, fontSize: "xs", lineHeight: 1.4, color: colors.textMuted, sx: { fontVariantNumeric: "tabular-nums" }, children: phone })), note && ((0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", display: "block", mt: 1, fontSize: "xs", lineHeight: 1.4, color: colors.textMuted, children: note }))] })] })] }), (onEdit || onRemove) && ((0, jsx_runtime_1.jsxs)(react_2.Flex, { gap: 1, pl: selectable ? "2.75rem" : 1, pr: 2, pb: 2, children: [onEdit && ((0, jsx_runtime_1.jsx)(Button_1.default, { variant: "ghost", colorScheme: "gray", size: "sm", onClick: onEdit, "aria-label": `${copy.edit} address: ${name}`, children: copy.edit })), onRemove && ((0, jsx_runtime_1.jsx)(Button_1.default, { variant: "ghost", colorScheme: "gray", size: "sm", onClick: onRemove, "aria-label": `${copy.remove} address: ${name}`, children: copy.remove }))] }))] }));
+    return ((0, jsx_runtime_1.jsxs)(react_2.Flex, { direction: "column", "data-testid": testId, "data-selected": isSelected || undefined, ...(0, selectable_1.selectableSurface)(colors, { selected: isSelected && selectable, disabled, interactive, ringed }), children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { ...props, "data-radio": true, "aria-disabled": selectable && disabled ? true : undefined, "aria-labelledby": props.role ? nameId : undefined, "aria-describedby": props.role ? bodyId : undefined, gap: 3, p: 4, pb: onEdit || onRemove ? 2 : 4, borderRadius: "2xl", cursor: interactive ? "pointer" : "default", outline: "none", align: "flex-start", children: [selectable && ((0, jsx_runtime_1.jsx)(react_2.Box, { mt: 0.5, children: (0, jsx_runtime_1.jsx)(selectable_1.RadioIndicator, { selected: isSelected }) })), (0, jsx_runtime_1.jsxs)(react_2.Flex, { direction: "column", gap: 1, flex: 1, minW: 0, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, wrap: "wrap", children: [(0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", id: nameId, fontSize: "sm", fontWeight: 700, lineHeight: 1.4, color: colors.header[900], children: name }), tag && (0, jsx_runtime_1.jsx)(Tag_1.default, { label: tag, size: "xs", tone: "neutral" }), isDefault && (0, jsx_runtime_1.jsx)(Tag_1.default, { label: copy.default, size: "xs", tone: "neutral" })] }), (0, jsx_runtime_1.jsxs)(react_2.Box, { id: bodyId, children: [lines.map((line) => ((0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", display: "block", fontSize: "sm", lineHeight: 1.5, color: colors.text[800], children: line }, line))), phone && ((0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", display: "block", mt: 1, fontSize: "xs", lineHeight: 1.4, color: colors.textMuted, sx: typography_1.NUMERIC_TEXT, children: phone })), note && ((0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", display: "block", mt: 1, fontSize: "xs", lineHeight: 1.4, color: colors.textMuted, children: note }))] })] })] }), (onEdit || onRemove) && ((0, jsx_runtime_1.jsxs)(react_2.Flex, { gap: 1, pl: selectable ? "2.75rem" : 1, pr: 2, pb: 2, children: [onEdit && ((0, jsx_runtime_1.jsx)(Button_1.default, { variant: "ghost", colorScheme: "gray", size: "sm", onClick: onEdit, "aria-label": `${copy.edit} address: ${name}`, children: copy.edit })), onRemove && ((0, jsx_runtime_1.jsx)(Button_1.default, { variant: "ghost", colorScheme: "gray", size: "sm", onClick: onRemove, "aria-label": `${copy.remove} address: ${name}`, children: copy.remove }))] }))] }));
 };
 exports.default = AddressCard;

package/dist/Components/Apexcharts/ApexLineChart/ApexLineChart.js

@@ -137,7 +137,7 @@ const ApexLineChart = ({ data, labels, title, height, width, lineColors, titlePo
         showSeries,
         palette,
     ]);
-    return ((0, jsx_runtime_1.jsxs)("div", { ref: wrapperRef, children: [title && isSmall && ((0, jsx_runtime_1.jsx)(ToolTip_1.default, { label: title, placement: "top", hasArrow: true, fontSize: "0.75rem", isDisabled: !isTruncated, children: (0, jsx_runtime_1.jsx)("div", { ref: titleRef, style: {
+    return ((0, jsx_runtime_1.jsxs)("div", { ref: wrapperRef, children: [title && isSmall && ((0, jsx_runtime_1.jsx)(ToolTip_1.default, { label: title, placement: "top", hasArrow: true, fontSize: "xs", isDisabled: !isTruncated, children: (0, jsx_runtime_1.jsx)("div", { ref: titleRef, style: {
                         textAlign: "left",
                         color: resolvedTitleStyle === null || resolvedTitleStyle === void 0 ? void 0 : resolvedTitleStyle.color,
                         fontSize: computedFontSize,

package/dist/Components/AppSwitcher/AppSwitcher.js

@@ -229,7 +229,7 @@ const AppSwitcher = ({ apps, currentAppId, onSelect, onOpenChange, isSearchable,
                             return;
                         }
                         handlePanelKeyDown(e);
-                    }, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Grip, { size: s.icon + 1 }) }) }), (0, jsx_runtime_1.jsx)(react_2.PopoverContent, { w: width, maxW: "calc(100vw - 1.5rem)", textAlign: "start", onKeyDown: handlePanelKeyDown, bg: theme.colors.surfaceRaised, borderRadius: "xl", overflow: "hidden", boxShadow: `0 10px 30px ${theme.colors.boxShadow.default}`, _focus: { outline: "none", boxShadow: `0 10px 30px ${theme.colors.boxShadow.default}` }, children: (0, jsx_runtime_1.jsxs)(react_2.PopoverBody, { p: 0, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, px: 3, pt: 3, pb: showSearch ? 2 : 1, children: [(0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "0.6875rem", fontWeight: 600, letterSpacing: "0.08em", textTransform: "uppercase", color: theme.colors.textMuted, children: HEADING }), (0, jsx_runtime_1.jsx)(react_2.Box, { flex: "1" }), hint && (0, jsx_runtime_1.jsx)(Kbd_1.default, { size: "xs", children: hint })] }), showSearch && ((0, jsx_runtime_1.jsx)(react_2.Box, { px: 3, pb: 2, children: (0, jsx_runtime_1.jsxs)(react_2.InputGroup, { size: "sm", children: [(0, jsx_runtime_1.jsx)(react_2.InputLeftElement, { pointerEvents: "none", children: (0, jsx_runtime_1.jsx)(lucide_react_1.Search, { size: 15, color: theme.colors.textMuted }) }), (0, jsx_runtime_1.jsx)(react_2.Input, { ref: searchRef, value: query, onChange: (e) => setQuery(e.target.value), placeholder: "Search apps", borderRadius: "lg", "aria-label": "Search apps", onKeyDown: (e) => {
+                    }, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Grip, { size: s.icon + 1 }) }) }), (0, jsx_runtime_1.jsx)(react_2.PopoverContent, { w: width, maxW: "calc(100vw - 1.5rem)", textAlign: "start", onKeyDown: handlePanelKeyDown, bg: theme.colors.surfaceRaised, borderRadius: "xl", overflow: "hidden", boxShadow: `0 10px 30px ${theme.colors.boxShadow.default}`, _focus: { outline: "none", boxShadow: `0 10px 30px ${theme.colors.boxShadow.default}` }, children: (0, jsx_runtime_1.jsxs)(react_2.PopoverBody, { p: 0, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, px: 3, pt: 3, pb: showSearch ? 2 : 1, children: [(0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "xs-minus", fontWeight: 600, letterSpacing: "0.08em", textTransform: "uppercase", color: theme.colors.textMuted, children: HEADING }), (0, jsx_runtime_1.jsx)(react_2.Box, { flex: "1" }), hint && (0, jsx_runtime_1.jsx)(Kbd_1.default, { size: "xs", children: hint })] }), showSearch && ((0, jsx_runtime_1.jsx)(react_2.Box, { px: 3, pb: 2, children: (0, jsx_runtime_1.jsxs)(react_2.InputGroup, { size: "sm", children: [(0, jsx_runtime_1.jsx)(react_2.InputLeftElement, { pointerEvents: "none", children: (0, jsx_runtime_1.jsx)(lucide_react_1.Search, { size: 15, color: theme.colors.textMuted }) }), (0, jsx_runtime_1.jsx)(react_2.Input, { ref: searchRef, value: query, onChange: (e) => setQuery(e.target.value), placeholder: "Search apps", borderRadius: "lg", "aria-label": "Search apps", onKeyDown: (e) => {
                                             if (e.key === "ArrowDown" && visible.length > 0) {
                                                 e.preventDefault();
                                                 focusItem(0);

package/dist/Components/AppearanceSettings/AppearanceSettings.js

@@ -16,7 +16,7 @@ const useCustomTheme_1 = require("../../Theme/useCustomTheme");
 const SelectV2_1 = __importDefault(require("../SelectV2/SelectV2"));
 const FieldLabel = ({ children }) => {
     const { colors } = (0, useCustomTheme_1.useCustomTheme)();
-    return ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", fontWeight: "medium", color: colors.textMuted, mb: 2, children: children }));
+    return ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", fontWeight: 500, color: colors.textMuted, mb: 2, children: children }));
 };
 const brandSwatch = (name, colors) => ((0, jsx_runtime_1.jsx)(react_2.Box, { w: "14px", h: "14px", borderRadius: "full", bg: brands_1.lightPalettes[name].primary[500], border: "1px solid", borderColor: (0, outlineRung_1.ruleInk)(colors.boxborder[200], [colors.backgroundColor.light, colors.backgroundColor.tertiary], outlineRung_1.CHROME_RULE) }));
 const AppearanceSettings = ({ brand, fontSize, onBrandChange, onFontSizeChange, showBrand = true, showColorMode = true, showFontSize = true, size = "sm", labels, }) => {