hisd3-ui-kit 5.2.2 → 5.3.1

package/README.md

@@ -141,7 +141,7 @@ const menuItems = [
 | `HISD3Provider` | Root theme provider (see above). |
 | `HISD3Sidebar` | App shell (see *Scrolling* below): brand block, grouped menu with accent bar on the active route, account dropdown (Settings / Logout with confirm), collapsible, optional top-nav mode (`layoutTop`). `menuItems` accept `{ key, path, name, icon, children, group, hideInMenu, disabled }`. `renderMenuLink` lets you plug in react-router's `<Link>`. Props `bareContent` + `hideHeaderBar` hand the header over to `HISD3PageHeader`. `collapseTrigger` places the collapse control: `"edge"` (default) floats a round chevron on the sidebar's right edge, level with the top bar — it works even when the top bar is hidden, and `collapseTriggerOffset` moves it down — `"header"` puts a square button in the shell's own top bar, `"none"` renders neither. |
 | `HISD3PageHeader` / `HISD3PageBody` | Top bar (breadcrumb left, actions right) that stays pinned while the page scrolls, plus a large title + subtitle that scrolls away; `HISD3PageBody` is the matching padded content area. |
-| `HISD3Table<T>` | antd `Table` restyled compactly — 45px rows, 14px cell text, uppercase 12px headers in the secondary text colour, hairline row rules. antd's own `size="small"` tightens it further with the HISD3 pagination bar: "Total N items", square page buttons, page-size toggle. Pass `pagination={{ current, pageSize, total, onChange, pageSizeOptions?, hidePageSize? }}` or `false`. Optional `footer` strip. Cell helper classes: `hisd3-cell-primary`, `hisd3-cell-link`, `hisd3-cell-muted`. |
+| `HISD3Table<T>` | antd `Table` restyled compactly — 45px rows, 14px cell text, uppercase 12px headers in the secondary text colour, hairline row rules. On the page it sits on a white panel with a hairline edge and its cells inset from it; inside a card, a drawer or a modal it lies flat on that surface. A fixed column takes the table's surface and ends in a 1px rule, not a shadow. antd's own `size="small"` tightens it further with the HISD3 pagination bar: "Total N items", square page buttons, page-size toggle. Pass `pagination={{ current, pageSize, total, onChange, pageSizeOptions?, hidePageSize? }}` or `false`. Optional `footer` strip. Cell helper classes: `hisd3-cell-primary`, `hisd3-cell-link`, `hisd3-cell-muted`. |
 | `HISD3Tabs` | Underlined filter tabs; each item may carry a `count`. |
 | `HISD3Tag` | Uppercase status pill, 12px on a 24px pill. `variant`: `neutral` (grey, e.g. ACTIVE / IN PATIENT), `soft` (primary tint, e.g. ER PATIENT), `outline` (2px primary border, e.g. OUT PATIENT), `solid`. `tone`: `primary` \| `success` \| `warning` \| `danger` \| `default`. |
 | `HISD3Button` | `variant`: `primary` (filled), `secondary` (default, dark 2px outline), `ghost`, `danger`. Accepts all antd `Button` props (`icon`, `size`, `loading`, …). |
@@ -403,6 +403,35 @@ again — and the instance unmounts once the animation finishes.
 
 ## Migrating
 
+### from 5.3.0
+
+Nothing to change. 5.3.1 makes the light-mode field fill white
+(`HISD3_NEUTRALS.bgField`, `--hisd3-input-bg`): since 5.3.0 forms sit on
+white panels, where the old warm tint was a hair darker than its surface.
+On a panel a field now sits flush and its edge defines it; on the ground
+it sits lighter than the page. Disabled, focus and dark mode are unchanged.
+
+### from 5.2.2
+
+Nothing to change in code; the look moves to two surfaces:
+
+- The ground — the sidebar, the top bar and the page — is one warm
+  near-white (`#F6F5F2`, was `#F3F2F0`), and cards and `HISD3Table` sit on
+  it in white with a hairline edge. In dark mode they lift to the elevated
+  grey the same way. An app that drew its own panels (a `--app-sidebar` /
+  `--app-surface` / `--app-panel` block, a `Card.colorBgContainer` or
+  `Segmented.trackBg` override) can drop them.
+- `HISD3Table` on the page: white panel, cells inset 24px from its edge,
+  14px heading row, fixed columns on the table's surface with a 1px rule at
+  their edge instead of a shadow. Inside a card, a drawer or a modal it is
+  unchanged except that the fixed-column rules apply there too.
+- The `Segmented` track is a step darker, so it reads as a control on the
+  ground.
+- The sidebar section that holds the current screen shows its title in the
+  text colour.
+- New: `HISD3_NEUTRALS.bgPanelRowHover`, `--hisd3-panel-bg`,
+  `--hisd3-panel-hover-bg`, `HISD3_LAYOUT.panelInset`.
+
 ### from 5.2.1
 
 Nothing to change. 5.2.2 makes the sign-in page's `variant="square"` flat: