pixelize-design-library 2.4.2-beta.46 → 2.4.2-beta.48

package/CHANGELOG.md

@@ -63,6 +63,59 @@ next major.
 
 ### Fixed
 
+- **`Table` — a column search only ever matched the page you were looking at.** The per-column
+  search ran on `filteredData`, which `useTable` had already sliced to the current page, so a match
+  on page 3 was invisible from page 1 and the pager still counted every row. The search now runs
+  before the slice: page count, the `1 - 20 of N` readout and the rendered rows all come from the
+  matched set, and typing a new search returns to page 1. Grouped mode already searched the whole
+  source and is unchanged; server pagination still searches only the loaded page, since the client
+  cannot see the rest.
+- **`Table` — an empty page was a dead end, and a page-size change left the body scrolled.** The
+  pager's step controls were hidden whenever the loaded rows were empty, so a server page that came
+  back with nothing stranded the user with no way back; stepping back now survives an empty result
+  and only stepping forward is disabled. A narrowing client-side result also clamps the current page
+  instead of leaving it past the end. Changing the page size at page 0 swaps the rows without moving
+  `startRow`, which used to leave the virtualized body scrolled into the old page — the scroll reset
+  now keys on the page size too.
+- **`Table` — a full-bleed status cell ignored `columns[].align`.** `align` is documented as aligning
+  the header label and the cells together, but a bleed status cell hardcoded centre. It now follows
+  `align` when the column sets one, and still centres when it does not, so existing tables look the
+  same.
+- **`Select` — the popup's filter field did not line up with the options under it.** Its wrapper
+  used a hardcoded `p={2}` while option rows inset by the size spec's `mx` (6px at `sm`, 4px at
+  `xs`), so the field's edges sat 2-4px inside the list's, and its text origin 2px further in. The
+  field was also fixed at `size="sm"` whatever the `Select`'s own size, so a `lg` picker got a small
+  search box. Both now follow the active size spec; measured edge- and text-aligned at every size.
+- **`Select` — a multi-select with chips rendered 2px taller than every other field.** The chip row's
+  vertical padding was computed against the control height without allowing for the trigger's own
+  1px rule top and bottom, which a border-box trigger adds on top. The sizing now lives in one
+  shared helper (`Common/chipTriggerSize`) that `Select` and the deprecated `SelectV2` both read.
+- **`SearchSelect` — infinite-scroll paging could duplicate a page, loop forever on an
+  exact-multiple total, leak a pending fetch into a closed/unmounted menu, and never scrolled the
+  keyboard-highlighted row into view.** `handleScroll` now reads the live option count at fire
+  time instead of the value captured when its 200ms debounce was scheduled, and won't re-request a
+  `startIndex` it already asked for. `hasMore` takes new optional `pagination.hasMore` /
+  `pagination.totalRecords` overrides, defaults `limit` to 10 (it used to never update when `limit`
+  was omitted), and stops after one page that doesn't grow `options`. The pending page timer is
+  cleared on close/unmount, and the active row now scrolls into view with `block: "nearest"`.
+- **`Table` — frozen columns sat at the wrong offset, and the pagination bar was misaligned.** The
+  sticky `left` was passed as a bare number, which Chakra reads off the space scale: a 48px offset
+  rendered as `12rem` (192px), and any cumulative frozen-column width landing on the scale jumped
+  4x. It stayed hidden because the old `CHECKBOX_SLOT_OFFSET = 50` is not a scale value — but 50
+  also missed the real 48px select-all cell by 2px, leaving a slit that scrolled content bled
+  through, and was wrong outright for `variant="studio"`'s 56px slot. The slot is now measured with
+  a `ResizeObserver`, and both offsets interpolate explicit pixels. The pager is one 24px row: the
+  `mt={3}` that faked centring is gone, the steps are `size="xs"` with 16px icons instead of
+  Chakra's 40px default, and the page-size select no longer fights `justify="flex-end"` with
+  `w="100%"`.
+- **`Table` — virtualized body jumped to the top on an appended page, and never scrolled on a real
+  page change below the virtualize threshold.** The scroll-reset effect now keys on `startRow`
+  actually changing instead of on the 30-row virtualize threshold flipping, so infinite-scroll and
+  grouped `groupLoadMore` appends no longer yank the user to the top, while a real page change
+  resets correctly at any size. A shrinking `data` set no longer strands the window past the end,
+  the offset-lookup binary-searches instead of scanning from 0, and measured row heights are
+  pruned per page instead of growing forever.
+
 - **`SegmentedControl` / `Switch` guessed the backdrop it was drawn on.** `brandSlide` painted an
   8% brand tint composited over `backgroundColor.main` and lifted its unselected-label ink against
   that same assumed canvas, so on a brand-filled bar the tint sank into the bar and the label
@@ -70,9 +123,29 @@ next major.
   on a `primary[700]` bar was unreadable. The track is now an opaque plate on every backdrop: rest
   ink 7.58–18.39:1, plate-vs-bar 6.31–19.0:1, with no change required at the call site. `surface`
   is now only a refinement for the plate's hairline edge, and a test gates the invariant.
-- **A selected `Select` option stacked brand ink on a brand-tinted row.** Bold `accentText` on
-  `listRowBackgrounds().selected` read as muddy, and the row cleared the panel by only 1.16–1.29:1.
-  The label is now `text[900]` with the brand carried by a trailing check, matching `OrgSwitcher`.
+- **A selected `Select`/`SearchSelect`/`SelectSearch`/`CompactSelect` option stacked brand ink on a
+  brand-tinted row** — `CompactSelect` had no selected styling at all. The label is now `text[900]`
+  at weight 500 with the brand carried by a trailing check, matching `OrgSwitcher`. The row tint
+  itself is also settled to one perceptible step off the panel instead of taking the raw token
+  (`selected` 1.16–1.29:1 → 1.151–1.191:1; the pressed-and-selected state above it 1.34–1.52:1 →
+  1.259–1.340:1), so a too-saturated tint is pulled down as reliably as a too-faint one is lifted.
+- **Every dropdown row is now one size.** `Select`, `SearchSelect`, `SelectSearch`,
+  `CompactSelect`'s filter, `DropDown`'s menu items and every themed `Menu` item shared six
+  different paddings for the same row; `sm` is now 30px tall everywhere (`padding: 4px 10px`,
+  `font-size: 13px`) instead of `SearchSelect` alone rendering ~34px with a 16px font. Row
+  content — including a `SearchSelect` `option.view` or `Select` `renderOption` node — now inherits
+  its font size from the row, so consumer-rendered row content is no longer stuck at the page's
+  16px body font.
+- **A dropdown row's description sub-line fell under AA in dark mode.** Settling the selected rung
+  left `textMuted` at **4.00–4.22:1** on the hovered-selected row across 6 of 9 brands (dark
+  `surfaceRaised` carries only ~0.86 of headroom, so any lighter rung eats it). The sub-line ink is
+  now derived once per palette against that busiest rung, clearing 4.5:1 everywhere; light mode is
+  unchanged because it already cleared.
+- **`Switch` no longer forces a 200px-wide track when it has no labels.** The width floor now only
+  applies once a label is set, so an unlabelled instance — the wrong component for a boolean field,
+  but one that shipped live in a 120px table cell — shrinks to fit instead of overflowing by 80px.
+  Use `ToggleSwitch` for an on/off field; swapping it in trades `role="radiogroup"` for
+  `role="switch"`, the same `getByRole` break the `InputSwitch` → `ToggleSwitch` migration caused.
 
 - **`SegmentedControl`'s pill bulged past the plate's corners.** The pill and the segments carried
   the track's own `lg` radius while sitting 2px inside it, so the plate's band stayed even along the

package/COMPONENT-GOTCHAS.md

@@ -127,7 +127,7 @@ is now the library's own themed component, with a real dual-thumb mode and a `ma
 | One of 2-5 named options | `SegmentedControl` | `role="radiogroup"`, keyboard-navigable, supports per-option disabling |
 | Switching between views or panels | `Tabs` | `role="tablist"` + `aria-controls`, count badges, lazy panels, vertical orientation |
 | *(avoid)* | `InputSwitch` | `@deprecated` — now a thin wrapper that renders `ToggleSwitch` |
-| *(avoid)* | `Switch` | `@deprecated` — a mouse-only two-label segmented control (`leftText`/`rightText`); use `SegmentedControl` |
+| *(avoid)* | `Switch` | `@deprecated` — a two-label segmented control (`leftText`/`rightText`), not a boolean; for a single on/off field use `ToggleSwitch` instead |
 
 **Apply:** "on vs off" is always `ToggleSwitch`; 2+ named options is always `SegmentedControl`.
 
@@ -434,6 +434,37 @@ set the required state on your own wrapping `FormControl`. Note the obvious one-
 component is not neutral: Chakra's `useFormControl` also emits native `required`, which would add
 browser validation to a *filter* input that was never submitted before.
 
+### `Select` with `onSearchChange` no longer filters locally (beta.48)
+
+Passing `onSearchChange` means the server owns matching, so `Select` stops applying its own
+substring filter to `options`. Before this, a fuzzy or ranked server result whose label did not
+literally contain the typed text was fetched and then hidden. Pass `filterOptions={true}` to keep
+the local pass on top, or `filterOptions={false}` to drop it even without `onSearchChange`.
+
+**Apply:** if a server-backed `Select` suddenly shows more rows than it used to, that is this fix,
+not a regression. Paged `Select`s should also pass `hasMore={false}` once the last page lands —
+without it, `onLoadMore` fires again every time the user reaches the bottom.
+
+### `Select` with `isMulti` keeps picks that leave `options` (beta.48)
+
+`onChange` used to be built from the options currently in the list, so replacing `options` with a
+server-search result silently dropped every earlier pick the new page did not contain — the chips
+vanished and the next selection emitted a truncated array. Selected options are now remembered
+independently of `options`.
+
+**Apply:** nothing to change. If you worked around this by merging the old selection back in
+yourself, that workaround is now redundant.
+
+### `Table`'s column search covers every page (beta.48)
+
+The per-column search box used to run after the page slice, so it matched only the rows on screen
+while the pager still counted the whole data set. It now runs first: the page count, the
+`1 - 20 of N` readout and the rows all come from the matched set, and a new search returns to page
+1. Under `paginationMode="server"` the client still only sees the loaded page — filter on the
+server there.
+
+**Apply:** a client-side table that looked like it had "no matches" past page 1 now finds them.
+
 ### `Select`'s `onChange` never fires for the built-in placeholder
 
 `Select` resolves the changed value against its `options` list and calls `onChange` only on a hit.
@@ -1219,14 +1250,16 @@ configured has no visible effect at all.
 **Apply:** to change the main field's height, change `size`; `height` only matters when
 `insideSelect` is also passed.
 
-### `SearchSelect`'s `pagination.limit` also drives a "has more" guess, not just page size
+### `SearchSelect`'s `pagination` now takes an explicit "has more" signal — prefer it at an exact-multiple total
 
-`hasMore` is computed as `options.length % pagination.limit === 0` — there is no real end-of-data
-signal from the consumer. A total result count that happens to be an exact multiple of `limit`
-looks indistinguishable from "more pages exist," firing one extra, empty `onScroll` call.
+Without `pagination.hasMore`/`pagination.totalRecords`, `hasMore` still falls back to guessing from
+`options.length % (pagination.limit ?? 10) === 0`. A total that's an exact multiple of `limit`
+(30 items, limit 10) still looks like "more pages exist" for the *first* extra scroll, firing one
+empty `onScroll` call — after that empty response, `SearchSelect` stops asking (it no longer loops
+forever the way earlier versions did).
 
-**Apply:** if exact pagination boundaries matter, pad or report a real "no more results" state some
-other way; don't rely on `hasMore` being accurate at a page boundary.
+**Apply:** pass `pagination.hasMore` (a boolean) or `pagination.totalRecords` (a count) so the field
+never fires that one avoidable empty request; both take precedence over the `limit` guess.
 
 ### `RolesPermission`'s `RoleData.permission`/`designation`/`makeSuperAdmin`/`automation`/`trackLocation`/`show_records` are dead weight in this component
 
@@ -1343,3 +1376,39 @@ Not just the columns — the select/edit/create header bar disappears too, since
 returns `null` before rendering anything.
 
 **Apply:** there's no prop for hiding only the board body while keeping header actions visible.
+
+### `Switch` was forced to 200px even with no labels — it overflowed a narrow cell
+
+`Switch` (`leftText`/`rightText`) kept a 12.5rem minimum width regardless of whether any label was
+set. Used as a boolean toggle — the wrong component for that, but the mistake shipped live in
+tickets' project custom-fields page — an unlabelled instance rendered as two unlabelled brand-filled
+pills at 200px inside a 120px table cell, overflowing by 80px. The width floor now only applies once
+`leftText`/`rightText` is actually set; an unlabelled instance shrinks to fit (~58px measured).
+
+**Apply:** for a single on/off field use `ToggleSwitch`, not `Switch`, even now that it no longer
+overflows — a two-option segmented control still announces as `role="radiogroup"`, not
+`role="switch"`. Swapping `Switch` for `ToggleSwitch` changes `getByRole("radio", …)` queries to
+`getByRole("switch", …)` — the same test break the `InputSwitch` → `ToggleSwitch` migration caused.
+
+### A `SearchSelect`/`Select` custom row node inherits the row's font size and padding — don't restate them
+
+`SearchSelect`'s `option.view` and `Select`'s `renderOption` render straight inside the option row,
+which now carries its own `fontSize`/`px`/`py` so a plain-text row is legible with no extra markup.
+A custom node that also sets its own `px`/`py`/`fontSize` stacks on top of the row's rather than
+replacing it — this is what made rows in crm-frontend render 57–75px tall instead of the ~30px every
+other row uses.
+
+**Apply:** size a custom `option.view`/`renderOption` node yourself only when it needs something
+*different* from the row default — inherit by default, don't restate it.
+
+### A custom option row's sub-line must not use `colors.textMuted` directly
+
+A selected row sits on a tinted fill, and the hovered-selected rung is the busiest one in the
+ladder. In dark mode `surfaceRaised` carries only ~0.86 of contrast headroom above AA, so raw
+`textMuted` on that rung measures **4.00–4.22:1** in 6 of 9 brands — under the 4.5:1 a 12px
+sub-line needs. The library's own rows no longer use it.
+
+**Apply:** in a `SearchSelect` `option.view` or `Select` `renderOption` node, read the sub-line ink
+from `optionRowDescriptionInk(theme.colors)` (exported from the package root) rather than
+`theme.colors.textMuted`. It is a no-op in light mode. The row's main label is
+`optionRowInk(theme.colors, isSelected)` with `optionRowWeight(isSelected)` — never brand ink.

package/dist/Components/Common/chipTriggerSize.d.ts

@@ -0,0 +1,10 @@
+import { type ControlSize } from "../../Theme/tokens/primitives/controlSizes";
+export type ChipSize = "xs" | "sm";
+/** Sizes a select trigger so a chip row lands on the same height as a plain one. */
+export declare const chipTriggerSizeStyles: (size: ControlSize, hasChips: boolean, chipSize?: ChipSize) => {
+    minH: string;
+    fontSize: string;
+    px: string;
+    h?: string;
+    py?: string;
+};

package/dist/Components/Common/chipTriggerSize.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chipTriggerSizeStyles = void 0;
+const controlSizes_1 = require("../../Theme/tokens/primitives/controlSizes");
+const CHIP_TAG_HEIGHT_PX = { xs: 20, sm: 24 };
+const CONTROL_BORDER_PX = 2;
+const controlHeightPx = (size) => parseFloat(controlSizes_1.CONTROL_SIZES[size].height) * 16;
+const chipRowPaddingY = (size, chipSize) => `${(controlHeightPx(size) - CHIP_TAG_HEIGHT_PX[chipSize] - CONTROL_BORDER_PX) / 2 / 16}rem`;
+/** Sizes a select trigger so a chip row lands on the same height as a plain one. */
+const chipTriggerSizeStyles = (size, hasChips, chipSize = "sm") => {
+    const spec = controlSizes_1.CONTROL_SIZES[size];
+    const base = { minH: spec.height, fontSize: spec.fontSize, px: spec.paddingX };
+    return hasChips ? { ...base, py: chipRowPaddingY(size, chipSize) } : { ...base, h: spec.height };
+};
+exports.chipTriggerSizeStyles = chipTriggerSizeStyles;

package/dist/Components/Dropdown/DropDown.js

@@ -11,16 +11,17 @@ const useExclusiveOverlay_1 = require("../../Hooks/useExclusiveOverlay");
 const lucide_react_1 = require("lucide-react");
 const rafThrottle_1 = require("../../Utils/rafThrottle");
 const controlSizes_1 = require("../../Theme/tokens/primitives/controlSizes");
+const optionRowSizes_1 = require("../../Theme/tokens/primitives/optionRowSizes");
 const motion_1 = require("../../Theme/tokens/primitives/motion");
 const motion_2 = require("../../Theme/chakra/motion");
 const focusRing_styles_1 = require("../../Theme/chakra/focusRing.styles");
 const MotionBox = (0, framer_motion_1.motion)((0, react_1.forwardRef)((props, ref) => ((0, jsx_runtime_1.jsx)(react_2.Box, { ref: ref, ...props }))));
 const SIZE_MAP = {
-    xs: { btn: "xs", fontSize: controlSizes_1.CONTROL_SIZES.xs.fontSize, py: 1, px: 2.5, img: "1rem", chevron: controlSizes_1.CONTROL_SIZES.xs.iconSize, minW: "8rem", gap: 1.5 },
-    sm: { btn: "sm", fontSize: controlSizes_1.CONTROL_SIZES.sm.fontSize, py: 1.5, px: 3, img: "1rem", chevron: controlSizes_1.CONTROL_SIZES.sm.iconSize, minW: "9rem", gap: 2 },
-    md: { btn: "md", fontSize: controlSizes_1.CONTROL_SIZES.md.fontSize, py: 2, px: 3, img: "1.125rem", chevron: controlSizes_1.CONTROL_SIZES.md.iconSize, minW: "11rem", gap: 2 },
-    lg: { btn: "lg", fontSize: controlSizes_1.CONTROL_SIZES.lg.fontSize, py: 2.5, px: 3.5, img: "1.25rem", chevron: controlSizes_1.CONTROL_SIZES.lg.iconSize, minW: "12rem", gap: 2.5 },
-    xl: { btn: "lg", fontSize: "1.0625rem", py: 3, px: 4, img: "1.4rem", chevron: 20, minW: "13rem", gap: 3 },
+    xs: { btn: "xs", img: "1rem", chevron: controlSizes_1.CONTROL_SIZES.xs.iconSize, minW: "8rem", gap: 1.5, rowSize: "xs" },
+    sm: { btn: "sm", img: "1rem", chevron: controlSizes_1.CONTROL_SIZES.sm.iconSize, minW: "9rem", gap: 2, rowSize: "sm" },
+    md: { btn: "md", img: "1.125rem", chevron: controlSizes_1.CONTROL_SIZES.md.iconSize, minW: "11rem", gap: 2, rowSize: "md" },
+    lg: { btn: "lg", img: "1.25rem", chevron: controlSizes_1.CONTROL_SIZES.lg.iconSize, minW: "12rem", gap: 2.5, rowSize: "lg" },
+    xl: { btn: "lg", img: "1.4rem", chevron: 20, minW: "13rem", gap: 3, rowSize: "lg" },
 };
 const TRIGGER_TRANSITION = (0, motion_1.transitionFor)(["background-color", "border-color", "color", "box-shadow"]);
 const ROW_TRANSITION = (0, motion_1.transitionFor)(["background-color", "color"]);
@@ -37,6 +38,7 @@ const Dropdown = (0, react_1.forwardRef)(({ dropDownButtonStyle, ButtonText, opt
     const menuRef = (0, react_1.useRef)(null);
     const [menuPos, setMenuPos] = (0, react_1.useState)({ top: 0, left: 0, width: 0 });
     const s = SIZE_MAP[(_a = size !== null && size !== void 0 ? size : optionsSize) !== null && _a !== void 0 ? _a : "sm"];
+    const rowSpec = (0, optionRowSizes_1.optionRowSpec)(s.rowSize);
     const prefersReducedMotion = (0, framer_motion_1.useReducedMotion)();
     const menuId = (0, react_1.useId)();
     // Roving-tabindex keyboard nav for the menu (ARIA APG menu-button pattern):
@@ -232,7 +234,7 @@ const Dropdown = (0, react_1.forwardRef)(({ dropDownButtonStyle, ButtonText, opt
     const Chevron = isVisibleIconShow ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", transition: CHEVRON_TRANSITION, transform: isOpen ? "rotate(180deg)" : "rotate(0deg)", sx: (0, motion_2.reducedMotionSx)(), children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: s.chevron }) })) : undefined;
     const dropDownToggleOption = () => {
         const ButtonToggle = ((0, jsx_runtime_1.jsx)(react_2.Button, { ref: buttonTriggerRef, onClick: handleToggle, onKeyDown: handleTriggerKeyDown, size: s.btn, colorScheme: "primary", borderRadius: "lg", fontWeight: 600, "aria-haspopup": "menu", "aria-expanded": isOpen, "aria-controls": menuId, "aria-label": ariaLabel !== null && ariaLabel !== void 0 ? ariaLabel : (ButtonText ? undefined : "Open menu"), rightIcon: Chevron, sx: { transition: TRIGGER_TRANSITION, ...(0, motion_2.reducedMotionSx)(), ...dropDownButtonStyle }, ...buttonProps, children: (0, jsx_runtime_1.jsxs)(react_2.Box, { as: "span", display: "inline-flex", alignItems: "center", gap: DropdownIcon && ButtonText ? s.gap : 0, children: [DropdownIcon, ButtonText] }) }));
-        const TextToggle = ((0, jsx_runtime_1.jsxs)(react_2.Flex, { ref: textTriggerRef, onClick: handleToggle, onKeyDown: handleTriggerKeyDown, align: "center", gap: 1.5, cursor: "pointer", fontSize: s.fontSize, fontWeight: 500, color: theme.colors.text[700], borderRadius: "md", transition: ROW_TRANSITION, _hover: { color: theme.colors.accentText }, sx: { ...(0, focusRing_styles_1.focusVisibleStyles)(theme.colors), ...(0, motion_2.reducedMotionSx)() }, style: dropDownButtonStyle, role: "button", tabIndex: 0, "aria-haspopup": "menu", "aria-expanded": isOpen, "aria-controls": menuId, "aria-label": ariaLabel !== null && ariaLabel !== void 0 ? ariaLabel : (text ? undefined : "Open menu"), children: [DropdownIcon, text, Chevron] }));
+        const TextToggle = ((0, jsx_runtime_1.jsxs)(react_2.Flex, { ref: textTriggerRef, onClick: handleToggle, onKeyDown: handleTriggerKeyDown, align: "center", gap: 1.5, cursor: "pointer", fontSize: rowSpec.fontSize, fontWeight: 500, color: theme.colors.text[700], borderRadius: "md", transition: ROW_TRANSITION, _hover: { color: theme.colors.accentText }, sx: { ...(0, focusRing_styles_1.focusVisibleStyles)(theme.colors), ...(0, motion_2.reducedMotionSx)() }, style: dropDownButtonStyle, role: "button", tabIndex: 0, "aria-haspopup": "menu", "aria-expanded": isOpen, "aria-controls": menuId, "aria-label": ariaLabel !== null && ariaLabel !== void 0 ? ariaLabel : (text ? undefined : "Open menu"), children: [DropdownIcon, text, Chevron] }));
         return dropdownType === "button" ? ButtonToggle : TextToggle;
     };
     const DropdownContentRender = () => {
@@ -242,7 +244,7 @@ const Dropdown = (0, react_1.forwardRef)(({ dropDownButtonStyle, ButtonText, opt
                 }, role: "menuitem", tabIndex: index === activeIndex ? 0 : -1, onClick: () => {
                     handleListItemClick(option.id, option.label);
                     focusTrigger();
-                }, onKeyDown: (e) => handleItemKeyDown(e, option.id, option.label), mx: 1.5, px: s.px, py: s.py, borderRadius: "md", display: "flex", alignItems: "center", gap: 2, cursor: "pointer", color: theme.colors.text[700], transition: ROW_TRANSITION, _hover: {
+                }, onKeyDown: (e) => handleItemKeyDown(e, option.id, option.label), mx: rowSpec.mx, px: rowSpec.px, py: rowSpec.py, minH: rowSpec.minH, borderRadius: optionRowSizes_1.OPTION_ROW_RADIUS, display: "flex", alignItems: "center", gap: rowSpec.gap, fontSize: rowSpec.fontSize, cursor: "pointer", color: theme.colors.text[700], transition: ROW_TRANSITION, _hover: {
                     bg: hoverTint,
                     color: theme.colors.accentText,
                 }, _focus: {
@@ -255,7 +257,7 @@ const Dropdown = (0, react_1.forwardRef)(({ dropDownButtonStyle, ButtonText, opt
                     boxShadow: `inset 0 0 0 2px ${theme.colors.focusRing.ring}`,
                 }, borderBottom: divider
                     ? `0.063rem solid ${theme.colors.boxborder[200]}`
-                    : undefined, sx: { "&:last-child": { borderBottom: "none" }, ...(0, motion_2.reducedMotionSx)() }, style: ItemStyle, fontWeight: 500, children: [option.image && ((0, jsx_runtime_1.jsx)(react_2.Box, { as: option.image, boxSize: s.img, flexShrink: 0, color: theme.colors.textMuted, style: ImageStyle })), (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", fontSize: s.fontSize, isTruncated: true, style: LabelStyle, children: option.label })] }, option.id))) }));
+                    : undefined, sx: { "&:last-child": { borderBottom: "none" }, ...(0, motion_2.reducedMotionSx)() }, style: ItemStyle, fontWeight: 500, children: [option.image && ((0, jsx_runtime_1.jsx)(react_2.Box, { as: option.image, boxSize: s.img, flexShrink: 0, color: theme.colors.textMuted, style: ImageStyle })), (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", fontSize: rowSpec.fontSize, isTruncated: true, style: LabelStyle, children: option.label })] }, option.id))) }));
     };
     return ((0, jsx_runtime_1.jsxs)(react_2.Box, { ref: dropdownRef, position: "relative", display: "inline-block", children: [dropDownToggleOption(), isOpen && ((0, jsx_runtime_1.jsx)(react_2.Portal, { children: (0, jsx_runtime_1.jsx)(MotionBox, { ref: setMenuRef, position: "fixed", top: `${menuPos.top}px`, left: `${menuPos.left}px`, minW: `${menuPos.width}px`, zIndex: 1500, initial: prefersReducedMotion ? false : { opacity: 0, y: -6 }, animate: { opacity: 1, y: 0 }, exit: { opacity: 0, y: -6 }, style: headStyle, children: DropdownContentRender() }) }))] }));
 });

package/dist/Components/SearchSelect/SearchSelect.js

@@ -44,6 +44,8 @@ const FormLabel_1 = require("../Common/FormLabel");
 const Tag_1 = __importDefault(require("../Tag/Tag"));
 const useCustomTheme_1 = require("../../Theme/useCustomTheme");
 const rowStates_1 = require("../../Theme/tokens/builders/rowStates");
+const optionRowSizes_1 = require("../../Theme/tokens/primitives/optionRowSizes");
+const optionRowInk_1 = require("../Select/optionRowInk");
 const useExclusiveOverlay_1 = require("../../Hooks/useExclusiveOverlay");
 const FieldMessage_1 = __importDefault(require("../Common/FieldMessage"));
 const useFieldIds_1 = require("../Common/useFieldIds");
@@ -75,6 +77,7 @@ const normalizeMultiValue = (val) => {
 const SearchSelect = ({ id, label, options, onChange, onSelect, onSearch, isOptionLoading = false, isLoading = false, loadingText = "Loading...", placeholder = "Select", value, searchQuery = "", isMultiple = false, isRequired = false, error = false, errorMessage, helperText, width = "100%", height, size = "sm", isDisabled = false, chip, information, isInformation, informationMessage, rightIcon, addNew, isSelectAll = false, pagination, insideSelect, isRemoveAllIcon, "aria-label": ariaLabel, }) => {
     var _a, _b, _c, _d, _e;
     const s = (0, searchSelectSize_1.getSearchSelectSizeStyles)(size);
+    const spec = (0, optionRowSizes_1.optionRowSpec)(size);
     const emitChange = onChange !== null && onChange !== void 0 ? onChange : onSelect;
     const insideSelectBoxHeight = height !== null && height !== void 0 ? height : s.insideSelectDefaultHeight;
     const [inputValue, setInputValue] = (0, react_1.useState)(searchQuery);
@@ -88,6 +91,9 @@ const SearchSelect = ({ id, label, options, onChange, onSelect, onSearch, isOpti
     const dropdownMenuRef = (0, react_1.useRef)(null);
     const [dropdownPos, setDropdownPos] = (0, react_1.useState)({ top: 0, left: 0, width: 0 });
     const scrollTimeoutRef = (0, react_1.useRef)(null);
+    const optionsLengthRef = (0, react_1.useRef)(options.length);
+    const lastPageStartRef = (0, react_1.useRef)(null);
+    const optionsListRef = (0, react_1.useRef)(null);
     const [focused, setFocused] = (0, react_1.useState)(false);
     const [customSelectOpen, setCustomSelectOpen] = (0, react_1.useState)(false);
     const customSelectRef = (0, react_1.useRef)(null);
@@ -138,10 +144,22 @@ const SearchSelect = ({ id, label, options, onChange, onSelect, onSearch, isOpti
         return () => clearTimeout(delayDebounce);
     }, [inputValue]);
     (0, react_1.useEffect)(() => {
-        if (pagination === null || pagination === void 0 ? void 0 : pagination.limit) {
-            setHasMore(options.length % pagination.limit === 0);
+        optionsLengthRef.current = options.length;
+    }, [options.length]);
+    (0, react_1.useEffect)(() => {
+        if ((pagination === null || pagination === void 0 ? void 0 : pagination.hasMore) !== undefined) {
+            setHasMore(pagination.hasMore);
+            return;
+        }
+        if ((pagination === null || pagination === void 0 ? void 0 : pagination.totalRecords) !== undefined) {
+            setHasMore(options.length < pagination.totalRecords);
+            return;
         }
-    }, [options.length, pagination === null || pagination === void 0 ? void 0 : pagination.limit]);
+        if (!(pagination === null || pagination === void 0 ? void 0 : pagination.onScroll))
+            return;
+        const limit = pagination.limit || 10;
+        setHasMore(options.length % limit === 0);
+    }, [options.length, pagination === null || pagination === void 0 ? void 0 : pagination.hasMore, pagination === null || pagination === void 0 ? void 0 : pagination.totalRecords, pagination === null || pagination === void 0 ? void 0 : pagination.limit, pagination === null || pagination === void 0 ? void 0 : pagination.onScroll]);
     const handleSelect = (option) => {
         var _a;
         if (isMultiple && insideSelect) {
@@ -321,6 +339,13 @@ const SearchSelect = ({ id, label, options, onChange, onSelect, onSearch, isOpti
         }
         setActiveIndex((prev) => (prev >= 0 && prev < filteredOptions.length ? prev : -1));
     }, [isOpen, filteredOptions.length]);
+    (0, react_1.useEffect)(() => {
+        var _a, _b;
+        if (!isOpen || activeIndex < 0 || !optionsListRef.current)
+            return;
+        (_b = (_a = optionsListRef.current
+            .querySelector(`[data-index="${activeIndex}"]`)) === null || _a === void 0 ? void 0 : _a.scrollIntoView) === null || _b === void 0 ? void 0 : _b.call(_a, { block: "nearest" });
+    }, [isOpen, activeIndex]);
     // NOTE: only restores focus when a keyboard close actually unmounted Input and dropped focus to body.
     (0, react_1.useEffect)(() => {
         var _a, _b, _c, _d;
@@ -351,11 +376,30 @@ const SearchSelect = ({ id, label, options, onChange, onSelect, onSearch, isOpti
                 clearTimeout(scrollTimeoutRef.current);
             scrollTimeoutRef.current = setTimeout(() => {
                 var _a;
-                const startIndex = options.length + 1;
+                scrollTimeoutRef.current = null;
+                const startIndex = optionsLengthRef.current + 1;
+                if (lastPageStartRef.current === startIndex) {
+                    setHasMore(false);
+                    return;
+                }
+                lastPageStartRef.current = startIndex;
                 (_a = pagination.onScroll) === null || _a === void 0 ? void 0 : _a.call(pagination, startIndex, pagination.limit || 10, inputValue);
             }, 200);
         }
-    }, [pagination, options.length, inputValue, hasMore]);
+    }, [pagination, inputValue, hasMore]);
+    (0, react_1.useEffect)(() => {
+        if (isOpen)
+            return;
+        if (scrollTimeoutRef.current) {
+            clearTimeout(scrollTimeoutRef.current);
+            scrollTimeoutRef.current = null;
+        }
+        lastPageStartRef.current = null;
+    }, [isOpen]);
+    (0, react_1.useEffect)(() => () => {
+        if (scrollTimeoutRef.current)
+            clearTimeout(scrollTimeoutRef.current);
+    }, []);
     (0, react_2.useOutsideClick)({
         ref: customSelectRef,
         handler: (e) => {
@@ -494,16 +538,14 @@ const SearchSelect = ({ id, label, options, onChange, onSelect, onSearch, isOpti
                                 }, children: [(0, jsx_runtime_1.jsxs)(react_2.Box, { minW: "4.5rem", cursor: "pointer", display: "flex", justifyContent: "space-between", alignItems: "center", gap: 1, width: insideSelect.width, height: insideSelectBoxHeight, pl: "0.5rem", pr: "0.375rem", children: [insideLabel ? ((0, jsx_runtime_1.jsx)(SelectTruncatedLabel_1.default, { label: insideLabel, maxWidth: insideSelect.width || "6rem", fontSize: s.fieldFontSize })) : ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: s.fieldFontSize, fontWeight: 500, color: theme.colors.textMuted, isTruncated: true, maxW: insideSelect.width || "6rem", children: insidePlaceholder })), (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexShrink: 0, color: customSelectOpen ? theme.colors.accentText : theme.colors.textMuted, transition: CHEVRON_TRANSITION, transform: customSelectOpen ? "rotate(180deg)" : "rotate(0deg)", children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: s.chevronSize }) })] }), customSelectOpen && ((0, jsx_runtime_1.jsx)(react_2.Portal, { children: (0, jsx_runtime_1.jsx)(react_2.Box, { ref: setInsideSelectMenuRef, id: insideSelectPortalId, position: "fixed", top: `${customSelectPos.top}px`, left: `${customSelectPos.left}px`, zIndex: 1510, bg: theme.colors.surfaceRaised, border: "0.063rem solid", borderColor: theme.colors.boxborder[200], borderRadius: "xl", boxShadow: theme.shadows.lg, minW: `${customSelectPos.width}px`, maxW: "20rem", py: 1, overflow: "hidden", children: (_c = insideSelect.option) === null || _c === void 0 ? void 0 : _c.map((item) => {
                                                 var _a;
                                                 const selected = ((_a = insideSelect.value) === null || _a === void 0 ? void 0 : _a.id) === item.id;
-                                                return ((0, jsx_runtime_1.jsxs)(react_2.Box, { display: "flex", alignItems: "center", justifyContent: "space-between", gap: 2, minH: s.optionRowMinH, py: s.optionRowPy, px: "0.75rem", fontSize: s.dropdownTextFontSize, fontWeight: selected ? 600 : 500, color: selected
-                                                        ? theme.colors.accentText
-                                                        : theme.colors.text[700], bg: selected ? rowBackgrounds.selected : "transparent", _hover: {
+                                                return ((0, jsx_runtime_1.jsxs)(react_2.Box, { display: "flex", alignItems: "center", justifyContent: "space-between", gap: spec.gap, minH: spec.minH, py: spec.py, px: spec.px, fontSize: spec.fontSize, fontWeight: (0, optionRowInk_1.optionRowWeight)(selected), color: (0, optionRowInk_1.optionRowInk)(theme.colors, selected), bg: selected ? rowBackgrounds.selected : "transparent", _hover: {
                                                         bg: selected
                                                             ? rowBackgrounds.selectedActive
                                                             : rowBackgrounds.active,
                                                     }, cursor: "pointer", onClick: (e) => {
                                                         e.stopPropagation();
                                                         handleCustomSelect(item);
-                                                    }, children: [(0, jsx_runtime_1.jsx)(react_2.Text, { isTruncated: true, children: item.label }), selected && ((0, jsx_runtime_1.jsx)(lucide_react_1.Check, { size: s.chevronSize - 2, color: theme.colors.accentText }))] }, item.id));
+                                                    }, children: [(0, jsx_runtime_1.jsx)(react_2.Text, { isTruncated: true, children: item.label }), selected && ((0, jsx_runtime_1.jsx)(lucide_react_1.Check, { size: spec.iconSize, color: theme.colors.accentText }))] }, item.id));
                                             }) }) }))] }));
                         })(), isMultiple
                             ? selectedValues
@@ -535,16 +577,20 @@ const SearchSelect = ({ id, label, options, onChange, onSelect, onSearch, isOpti
                                         else {
                                             openMenu();
                                         }
-                                    }, "aria-label": "toggle-dropdown", display: "flex", alignItems: "center", borderRadius: "sm", color: theme.colors.textMuted, cursor: isDisabled ? "not-allowed" : "pointer", sx: (0, focusRing_styles_1.focusVisibleStyles)(theme.colors), children: isOpen ? ((0, jsx_runtime_1.jsx)(lucide_react_1.ChevronUp, { size: s.chevronSize })) : ((0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: s.chevronSize })) }))] })] }) }), isOpen && ((0, jsx_runtime_1.jsx)(react_2.Portal, { children: (0, jsx_runtime_1.jsxs)(react_2.Box, { ref: setDropdownMenuRef, id: listboxId, role: "listbox", "aria-multiselectable": isMultiple || undefined, position: "fixed", top: `${dropdownPos.top}px`, left: `${dropdownPos.left}px`, width: `${dropdownPos.width}px`, zIndex: 1500, maxH: "20rem", borderWidth: 1, borderColor: theme.colors.boxborder[200], borderRadius: "xl", overflow: "hidden", bg: theme.colors.surfaceRaised, boxShadow: theme.shadows.lg, display: "flex", flexDirection: "column", children: [isMultiple && isSelectAll && ((0, jsx_runtime_1.jsxs)(react_2.Box, { py: s.optionRowPy, px: 3, cursor: "pointer", onClick: handleSelectAll, display: "flex", alignItems: "center", gap: 2, color: theme.colors.text[700], borderBottom: `0.063rem solid ${theme.colors.boxborder[200]}`, children: [(0, jsx_runtime_1.jsx)(Checkbox_1.default, { isChecked: allFilteredSelected, sx: { pointerEvents: "none" }, size: s.checkboxSize }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: s.dropdownTextFontSize, children: allFilteredSelected ? "Unselect All" : "Select All" })] })), (0, jsx_runtime_1.jsx)(react_2.Box, { flex: "1", overflowY: "auto", onScroll: handleScroll, maxH: "15rem", borderBottom: "0.063rem solid", borderColor: theme.colors.boxborder[200], children: isOptionLoading && filteredOptions.length === 0 ? ((0, jsx_runtime_1.jsxs)(react_2.Box, { py: s.optionRowPy, px: 3, display: "flex", alignItems: "center", gap: 2, minH: s.optionRowMinH, color: theme.colors.textMuted, children: [(0, jsx_runtime_1.jsx)(react_2.Spinner, { size: s.spinnerSize }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: s.dropdownTextFontSize, children: loadingText })] })) : !isOptionLoading && filteredOptions.length === 0 ? ((0, jsx_runtime_1.jsx)(react_2.Text, { p: 3, fontSize: s.dropdownTextFontSize, color: theme.colors.textMuted, children: "No results found" })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [filteredOptions.map((option, index) => ((0, jsx_runtime_1.jsxs)(react_2.Box, { id: getOptionId(index), role: "option", "aria-selected": isSelected(option.id), py: s.optionRowPy, px: 3, minH: s.optionRowMinH, cursor: "pointer", bg: isSelected(option.id)
-                                            ? index === activeIndex
-                                                ? rowBackgrounds.selectedActive
-                                                : rowBackgrounds.selected
-                                            : index === activeIndex
-                                                ? rowBackgrounds.active
-                                                : "transparent", _hover: {
-                                            bg: isSelected(option.id)
-                                                ? rowBackgrounds.selectedActive
-                                                : rowBackgrounds.active,
-                                        }, onClick: () => handleSelect(option), onMouseEnter: () => setActiveIndex(index), display: "flex", alignItems: "center", gap: 2, color: isSelected(option.id) ? theme.colors.accentText : theme.colors.text[700], fontWeight: isSelected(option.id) ? 600 : 400, borderBottom: `0.063rem solid ${theme.colors.boxborder[200]}`, children: [isMultiple && ((0, jsx_runtime_1.jsx)(Checkbox_1.default, { isChecked: isSelected(option.id), sx: { pointerEvents: "none" }, size: s.checkboxSize })), option.view ? ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: option.view })) : ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: s.dropdownTextFontSize, children: option.label }))] }, option.id))), ((pagination === null || pagination === void 0 ? void 0 : pagination.scrollLoading) || (isOptionLoading && filteredOptions.length > 0)) && ((0, jsx_runtime_1.jsxs)(react_2.Box, { py: s.optionRowPy, px: 3, display: "flex", alignItems: "center", justifyContent: "center", gap: 2, minH: s.optionRowMinH, color: theme.colors.textMuted, children: [(0, jsx_runtime_1.jsx)(react_2.Spinner, { size: s.spinnerSize }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: s.dropdownTextFontSize, children: loadingText })] }))] })) }), (addNew === null || addNew === void 0 ? void 0 : addNew.enabled) && ((0, jsx_runtime_1.jsxs)(react_2.Box, { py: s.optionRowPy, px: 3, borderTop: "0.063rem solid", borderColor: theme.colors.boxborder[200], bg: theme.colors.surfaceRaised, display: "flex", alignItems: "center", gap: 2, color: theme.colors.accentText, fontWeight: 500, minH: s.optionRowMinH, cursor: "pointer", onClick: addNew.onClick, _hover: { bg: rowBackgrounds.active }, children: [addNew.icon || (0, jsx_runtime_1.jsx)(lucide_react_1.Plus, { size: s.addNewIconSize }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: s.dropdownTextFontSize, children: addNew.text || "Add New" })] }))] }) })), (0, jsx_runtime_1.jsx)(FieldMessage_1.default, { error: error, errorMessage: errorMessage, helperText: helperText, helperId: ids.helperId, errorId: ids.errorId })] }));
+                                    }, "aria-label": "toggle-dropdown", display: "flex", alignItems: "center", borderRadius: "sm", color: theme.colors.textMuted, cursor: isDisabled ? "not-allowed" : "pointer", sx: (0, focusRing_styles_1.focusVisibleStyles)(theme.colors), children: isOpen ? ((0, jsx_runtime_1.jsx)(lucide_react_1.ChevronUp, { size: s.chevronSize })) : ((0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: s.chevronSize })) }))] })] }) }), isOpen && ((0, jsx_runtime_1.jsx)(react_2.Portal, { children: (0, jsx_runtime_1.jsxs)(react_2.Box, { ref: setDropdownMenuRef, id: listboxId, role: "listbox", "aria-multiselectable": isMultiple || undefined, position: "fixed", top: `${dropdownPos.top}px`, left: `${dropdownPos.left}px`, width: `${dropdownPos.width}px`, zIndex: 1500, maxH: "20rem", borderWidth: 1, borderColor: theme.colors.boxborder[200], borderRadius: "xl", overflow: "hidden", bg: theme.colors.surfaceRaised, boxShadow: theme.shadows.lg, display: "flex", flexDirection: "column", children: [isMultiple && isSelectAll && ((0, jsx_runtime_1.jsxs)(react_2.Box, { py: spec.py, px: spec.px, minH: spec.minH, cursor: "pointer", onClick: handleSelectAll, display: "flex", alignItems: "center", gap: spec.gap, color: theme.colors.text[700], borderBottom: `0.063rem solid ${theme.colors.boxborder[200]}`, children: [(0, jsx_runtime_1.jsx)(Checkbox_1.default, { isChecked: allFilteredSelected, sx: { pointerEvents: "none" }, size: s.checkboxSize }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: spec.fontSize, children: allFilteredSelected ? "Unselect All" : "Select All" })] })), (0, jsx_runtime_1.jsx)(react_2.Box, { ref: optionsListRef, flex: "1", overflowY: "auto", onScroll: handleScroll, maxH: "15rem", borderBottom: "0.063rem solid", borderColor: theme.colors.boxborder[200], children: isOptionLoading && filteredOptions.length === 0 ? ((0, jsx_runtime_1.jsxs)(react_2.Box, { py: spec.py, px: spec.px, display: "flex", alignItems: "center", gap: spec.gap, minH: spec.minH, color: theme.colors.textMuted, children: [(0, jsx_runtime_1.jsx)(react_2.Spinner, { size: s.spinnerSize }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: spec.fontSize, children: loadingText })] })) : !isOptionLoading && filteredOptions.length === 0 ? ((0, jsx_runtime_1.jsx)(react_2.Text, { p: 3, fontSize: spec.fontSize, color: theme.colors.textMuted, children: "No results found" })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [filteredOptions.map((option, index) => {
+                                        const selected = isSelected(option.id);
+                                        const singleSelected = selected && !isMultiple;
+                                        return ((0, jsx_runtime_1.jsxs)(react_2.Box, { id: getOptionId(index), "data-index": index, role: "option", "aria-selected": selected, py: spec.py, px: spec.px, minH: spec.minH, cursor: "pointer", bg: selected
+                                                ? index === activeIndex
+                                                    ? rowBackgrounds.selectedActive
+                                                    : rowBackgrounds.selected
+                                                : index === activeIndex
+                                                    ? rowBackgrounds.active
+                                                    : "transparent", _hover: {
+                                                bg: selected ? rowBackgrounds.selectedActive : rowBackgrounds.active,
+                                            }, onClick: () => handleSelect(option), onMouseEnter: () => setActiveIndex(index), display: "flex", alignItems: "center", gap: spec.gap, color: (0, optionRowInk_1.optionRowInk)(theme.colors, singleSelected), 
+                                            // `view` is consumer JSX with no size of its own; it inherited the 16px body font.
+                                            fontSize: spec.fontSize, fontWeight: (0, optionRowInk_1.optionRowWeight)(singleSelected), borderBottom: `0.063rem solid ${theme.colors.boxborder[200]}`, children: [isMultiple && ((0, jsx_runtime_1.jsx)(Checkbox_1.default, { isChecked: selected, sx: { pointerEvents: "none" }, size: s.checkboxSize })), option.view ? ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: option.view })) : ((0, jsx_runtime_1.jsx)(react_2.Text, { isTruncated: true, children: option.label })), singleSelected && ((0, jsx_runtime_1.jsx)(react_2.Box, { as: lucide_react_1.Check, size: spec.iconSize, color: theme.colors.accentText, flexShrink: 0 }))] }, option.id));
+                                    }), ((pagination === null || pagination === void 0 ? void 0 : pagination.scrollLoading) || (isOptionLoading && filteredOptions.length > 0)) && ((0, jsx_runtime_1.jsxs)(react_2.Box, { py: spec.py, px: spec.px, display: "flex", alignItems: "center", justifyContent: "center", gap: spec.gap, minH: spec.minH, color: theme.colors.textMuted, children: [(0, jsx_runtime_1.jsx)(react_2.Spinner, { size: s.spinnerSize }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: spec.fontSize, children: loadingText })] }))] })) }), (addNew === null || addNew === void 0 ? void 0 : addNew.enabled) && ((0, jsx_runtime_1.jsxs)(react_2.Box, { py: spec.py, px: spec.px, borderTop: "0.063rem solid", borderColor: theme.colors.boxborder[200], bg: theme.colors.surfaceRaised, display: "flex", alignItems: "center", gap: spec.gap, color: theme.colors.accentText, fontWeight: 500, minH: spec.minH, cursor: "pointer", onClick: addNew.onClick, _hover: { bg: rowBackgrounds.active }, children: [addNew.icon || (0, jsx_runtime_1.jsx)(lucide_react_1.Plus, { size: s.addNewIconSize }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: spec.fontSize, children: addNew.text || "Add New" })] }))] }) })), (0, jsx_runtime_1.jsx)(FieldMessage_1.default, { error: error, errorMessage: errorMessage, helperText: helperText, helperId: ids.helperId, errorId: ids.errorId })] }));
 };
 exports.default = SearchSelect;

package/dist/Components/SearchSelect/SearchSelectProps.d.ts

@@ -81,10 +81,14 @@ export type SearchSelectProps = {
     pagination?: {
         /** startIndex is 1-based (current options.length + 1), not a 0-based offset. */
         onScroll?: (startIndex: number, limit: number, query: string) => void;
-        /** Also used to guess whether more pages exist (options.length % limit === 0) — an exact-multiple total triggers one extra scroll fetch. */
+        /** Also used to guess whether more pages exist (options.length % limit === 0, refined once a page returns no new rows). Defaults to 10 when omitted. */
         limit?: number;
         /** Set this synchronously while a page request is in flight, or fast scrolling can re-fire onScroll for the same page. */
         scrollLoading?: boolean;
+        /** Explicit stop signal; overrides the limit-based heuristic when set. */
+        hasMore?: boolean;
+        /** Total row count; when set, hasMore is derived as options.length < totalRecords instead of the limit heuristic. */
+        totalRecords?: number;
     };
     /** Not implemented — the option list always renders unvirtualized; use `pagination` to page in large datasets instead. */
     virtualization?: boolean;

package/dist/Components/SearchSelect/searchSelectSize.d.ts

@@ -19,11 +19,6 @@ export type SearchSelectSizeStyles = {
     addNewIconSize: number;
     /** Offset for the nested select segment (aligns with field padding). */
     insideSelectMarginLeft: string;
-    /** “Select all” / option row text in the dropdown. */
-    dropdownTextFontSize: "xs" | "sm" | "md";
-    /** Min row height for main option list items. */
-    optionRowMinH: string;
-    optionRowPy: number;
     /** Chakra `Checkbox` only supports sm | md | lg. */
     checkboxSize: "sm" | "md" | "lg";
     /** Chakra `Input` font token per `size` (unstyled still needs explicit fontSize). */

package/dist/Components/SearchSelect/searchSelectSize.js

@@ -21,9 +21,6 @@ const SIZE_STYLES = {
         clearIconSize: 10,
         addNewIconSize: 14,
         insideSelectMarginLeft: "-0.5rem",
-        dropdownTextFontSize: "xs",
-        optionRowMinH: "1.5rem",
-        optionRowPy: 1.5,
         checkboxSize: "sm",
     },
     sm: {
@@ -42,9 +39,6 @@ const SIZE_STYLES = {
         clearIconSize: 12,
         addNewIconSize: 16,
         insideSelectMarginLeft: "-0.625rem",
-        dropdownTextFontSize: "sm",
-        optionRowMinH: "2rem",
-        optionRowPy: 2,
         checkboxSize: "sm",
     },
     md: {
@@ -63,9 +57,6 @@ const SIZE_STYLES = {
         clearIconSize: 12,
         addNewIconSize: 16,
         insideSelectMarginLeft: "-0.75rem",
-        dropdownTextFontSize: "sm",
-        optionRowMinH: "2.5rem",
-        optionRowPy: 2,
         checkboxSize: "md",
     },
     lg: {
@@ -84,9 +75,6 @@ const SIZE_STYLES = {
         clearIconSize: 14,
         addNewIconSize: 18,
         insideSelectMarginLeft: "-0.875rem",
-        dropdownTextFontSize: "md",
-        optionRowMinH: "2.75rem",
-        optionRowPy: 2.5,
         checkboxSize: "lg",
     },
 };

package/dist/Components/Select/SelectNative.d.ts

@@ -38,12 +38,14 @@ declare const SelectNative: React.ForwardRefExoticComponent<{
     defaultSearchValue?: string;
     onSearchChange?: (query: string) => void;
     searchDebounceMs?: number;
+    filterOptions?: boolean;
     isClearable?: boolean;
     onClear?: () => void;
     isLoading?: boolean;
     loadingText?: string;
     noOptionsMessage?: React.ReactNode;
     onLoadMore?: () => void;
+    hasMore?: boolean;
     renderOption?: (option: OptionProp, state: {
         isSelected: boolean;
         isActive: boolean;