colibri-ui 0.8.92 → 0.8.94

package/Datepicker/components/DatePicker/index.js

@@ -39,6 +39,7 @@ const DatePicker = _a => {
   var _b;
   var {
       className,
+      disabled = false,
       endPlaceholder,
       hasError,
       hint,
@@ -55,7 +56,7 @@ const DatePicker = _a => {
       onChangeDate,
       onChangeRange
     } = _a,
-    calendarProps = tslib.__rest(_a, ["className", "endPlaceholder", "hasError", "hint", "label", "placeholder", "required", "selectedDate", "selectedRange", "selectionMode", "size", "defaultVisibleMonth", "monthsToShow", "startPlaceholder", "onChangeDate", "onChangeRange"]);
+    calendarProps = tslib.__rest(_a, ["className", "disabled", "endPlaceholder", "hasError", "hint", "label", "placeholder", "required", "selectedDate", "selectedRange", "selectionMode", "size", "defaultVisibleMonth", "monthsToShow", "startPlaceholder", "onChangeDate", "onChangeRange"]);
   const [date, setDate] = React.useState(selectedDate);
   const [range, setRange] = React.useState(selectedRange);
   const [isOpen, setIsOpen] = React.useState(false);
@@ -64,6 +65,7 @@ const DatePicker = _a => {
   const calendarSize = calendarSizeByDatepickerSize[size];
   const visibleMonth = (_b = calendarValue !== null && calendarValue !== void 0 ? calendarValue : calendarRangeValue[0]) !== null && _b !== void 0 ? _b : new Date();
   const isRangeMode = selectionMode === "range";
+  const isCalendarOpen = isOpen && !disabled;
   React.useEffect(() => {
     setDate(selectedDate);
   }, [selectedDate]);
@@ -73,12 +75,14 @@ const DatePicker = _a => {
     setRange([selectedRangeStart, selectedRangeEnd]);
   }, [isRangeMode, selectedRangeStart, selectedRangeEnd]);
   const handleDateChange = nextDate => {
+    if (disabled) return;
     const nextValue = index.toISODate(nextDate);
     setDate(nextValue);
     setIsOpen(false);
     onChangeDate === null || onChangeDate === void 0 ? void 0 : onChangeDate(nextValue);
   };
   const handleRangeChange = nextRange => {
+    if (disabled) return;
     const nextValue = [nextRange[0] ? index.toISODate(nextRange[0]) : "", nextRange[1] ? index.toISODate(nextRange[1]) : ""];
     setRange(nextValue);
     if (nextValue[0] && nextValue[1]) setIsOpen(false);
@@ -110,14 +114,15 @@ const DatePicker = _a => {
     className: styles__default.default["range-input"]
   }, /*#__PURE__*/React__default.default.createElement(index$1.InputRoot, {
     className: styles__default.default["range-control-start"],
-    disabled: false,
+    disabled: disabled,
     hasError: hasError,
     size: size
   }, /*#__PURE__*/React__default.default.createElement(index$2.BaseInput, {
-    "aria-expanded": isOpen,
+    "aria-expanded": isCalendarOpen,
     "aria-haspopup": "true",
     "aria-invalid": hasError,
     autoComplete: "off",
+    disabled: disabled,
     maxLength: 10,
     placeholder: startPlaceholder !== null && startPlaceholder !== void 0 ? startPlaceholder : placeholder,
     readOnly: true,
@@ -125,15 +130,16 @@ const DatePicker = _a => {
     value: index.toDMYDate(range[0])
   })), /*#__PURE__*/React__default.default.createElement(index$1.InputRoot, {
     className: styles__default.default["range-control-end"],
-    disabled: false,
+    disabled: disabled,
     endIcon: /*#__PURE__*/React__default.default.createElement(CalendarIcon, null),
     hasError: hasError,
     size: size
   }, /*#__PURE__*/React__default.default.createElement(index$2.BaseInput, {
-    "aria-expanded": isOpen,
+    "aria-expanded": isCalendarOpen,
     "aria-haspopup": "true",
     "aria-invalid": hasError,
     autoComplete: "off",
+    disabled: disabled,
     maxLength: 10,
     placeholder: endPlaceholder !== null && endPlaceholder !== void 0 ? endPlaceholder : placeholder,
     readOnly: true,
@@ -146,7 +152,8 @@ const DatePicker = _a => {
     hint: hint,
     hasError: hasError
   }, /*#__PURE__*/React__default.default.createElement(index$4.Dropdown, {
-    visible: isOpen,
+    disabled: disabled,
+    visible: isCalendarOpen,
     onVisibleChange: setIsOpen,
     placement: "bottom",
     preventAutoClose: true,
@@ -155,13 +162,16 @@ const DatePicker = _a => {
       className: styles__default.default["calendar-popup"]
     }, renderCalendar())
   }, /*#__PURE__*/React__default.default.createElement("div", {
-    className: styles__default.default.trigger
+    "aria-disabled": disabled || undefined,
+    className: styles__default.default.trigger,
+    tabIndex: disabled ? -1 : 0
   }, isRangeMode ? renderRangeInput() : (/*#__PURE__*/React__default.default.createElement(index$5.Input, {
     className: styles__default.default.input,
-    "aria-expanded": isOpen,
+    "aria-expanded": isCalendarOpen,
     "aria-haspopup": "true",
     "aria-invalid": hasError,
     autoComplete: "off",
+    disabled: disabled,
     endIcon: /*#__PURE__*/React__default.default.createElement(CalendarIcon, null),
     hasError: hasError,
     maxLength: 10,

package/Datepicker/components/DatePicker/index.props.d.ts

@@ -1,6 +1,7 @@
 import type { DatepickerSize, DatepickerCalendarProps, Props as DatepickerProps } from "../../index.props";
 export type DatePickerProps = DatepickerCalendarProps & {
     className?: string;
+    disabled?: boolean;
     endPlaceholder?: string;
     hasError?: boolean;
     hint?: DatepickerProps["hint"];

package/Datepicker/index.d.ts

@@ -1,3 +1,3 @@
 import React from "react";
 import type { Props } from "./index.props";
-export declare const Datepicker: ({ className, endPlaceholder, hasError, hint, label, placeholder, required, selectedDate, selectedRange, selectionMode, size, startPlaceholder, onChangeDate, onChangeRange, ...calendarProps }: Props) => React.JSX.Element;
+export declare const Datepicker: ({ className, disabled, endPlaceholder, hasError, hint, label, placeholder, required, selectedDate, selectedRange, selectionMode, size, startPlaceholder, onChangeDate, onChangeRange, ...calendarProps }: Props) => React.JSX.Element;

package/Datepicker/index.js

@@ -15,6 +15,7 @@ var styles__default = /*#__PURE__*/_interopDefault(styles);
 const Datepicker = _a => {
   var {
       className,
+      disabled,
       endPlaceholder,
       hasError,
       hint,
@@ -29,10 +30,11 @@ const Datepicker = _a => {
       onChangeDate,
       onChangeRange
     } = _a,
-    calendarProps = tslib.__rest(_a, ["className", "endPlaceholder", "hasError", "hint", "label", "placeholder", "required", "selectedDate", "selectedRange", "selectionMode", "size", "startPlaceholder", "onChangeDate", "onChangeRange"]);
+    calendarProps = tslib.__rest(_a, ["className", "disabled", "endPlaceholder", "hasError", "hint", "label", "placeholder", "required", "selectedDate", "selectedRange", "selectionMode", "size", "startPlaceholder", "onChangeDate", "onChangeRange"]);
   return /*#__PURE__*/React__default.default.createElement("div", {
     className: clsx__default.default(styles__default.default.root, className)
   }, /*#__PURE__*/React__default.default.createElement(index.DatePicker, Object.assign({}, calendarProps, {
+    disabled: disabled,
     endPlaceholder: endPlaceholder,
     hasError: hasError,
     hint: hint,

package/Datepicker/index.props.d.ts

@@ -6,6 +6,7 @@ export type DatepickerRangeValue = [string, string];
 export type DatepickerCalendarProps = Omit<CalendarCommonProps, "className" | "size">;
 export type Props = DatepickerCalendarProps & {
     className?: string;
+    disabled?: boolean;
     endPlaceholder?: string;
     hasError?: boolean;
     hint?: ReactNode;

package/MultiSelect/index.js

@@ -39,9 +39,14 @@ const MultiSelect = ({
   name,
   value = [],
   type,
-  onChange
+  onChange,
+  "aria-label": ariaLabel
 }) => {
   const [isOpen, setIsOpen] = React.useState(false);
+  const id = React.useId();
+  const labelId = label ? `${id}-label` : undefined;
+  const valueId = `${id}-value`;
+  const hintId = hint ? `${id}-hint` : undefined;
   const internalSelectedKeys = React.useMemo(() => value.map(index.toKey), [value]);
   const preparedGroups = React.useMemo(() => groups.map(group => Object.assign(Object.assign({}, group), {
     options: group.options.map(option => Object.assign(Object.assign({}, option), {
@@ -80,7 +85,9 @@ const MultiSelect = ({
     }, className),
     required: required,
     label: label,
+    labelId: labelId,
     hint: hint,
+    hintId: hintId,
     hasError: hasError
   }, /*#__PURE__*/React__default.default.createElement(index$2.Dropdown, {
     placement: "bottom-start",
@@ -96,7 +103,11 @@ const MultiSelect = ({
     }),
     samewidth: true
   }, /*#__PURE__*/React__default.default.createElement("div", {
-    tabIndex: 0,
+    "aria-describedby": hintId,
+    "aria-disabled": disabled || undefined,
+    "aria-label": labelId ? undefined : ariaLabel,
+    "aria-labelledby": labelId ? `${labelId} ${valueId}` : undefined,
+    tabIndex: disabled ? -1 : 0,
     role: "button",
     style: {
       width: fullWidth ? "100%" : "fit-content"
@@ -118,6 +129,7 @@ const MultiSelect = ({
     }),
     disabled: Boolean(disabled)
   }, /*#__PURE__*/React__default.default.createElement("div", {
+    id: valueId,
     className: clsx__default.default(styles__default.default["base-input"], styles__default.default[type === "chip" ? "base-input-flex" : "base-input-text"])
   }, preparedLabel.length ? type === "chip" ?
   // eslint-disable-next-line @typescript-eslint/no-shadow

package/MultiSelect/index.props.d.ts

@@ -20,7 +20,9 @@ export type SelectedItem = {
     group: string;
     option: string;
 };
-export interface MultiSelectProps extends Omit<FormFieldProps, "children"> {
+export interface MultiSelectProps extends Omit<FormFieldProps, "children" | "labelId"> {
+    /** Accessible name of the trigger when no visible `label` is passed. */
+    "aria-label"?: string;
     groups: GroupProps[];
     className?: string;
     zIndex?: number;

package/Pagination/Pagination.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+import type { PaginationProps } from "./index.props";
+export declare const Pagination: ({ totalPages, page, defaultPage, onPageChange, siblingCount, boundaryCount, disabledPages, disabled, mode, size, pageSize, defaultPageSize, pageSizeOptions, onPageSizeChange, showPageSize, showQuickJump, helperText, previousLabel, nextLabel, pageLabel, quickJumpLabel, pageSizeLabel, className, ref, "aria-label": ariaLabel, ...props }: PaginationProps) => React.JSX.Element;

package/Pagination/Pagination.js

@@ -0,0 +1,162 @@
+'use strict';
+
+var tslib = require('tslib');
+var React = require('react');
+var clsx = require('clsx');
+var Chevron = require('../Icons/Chevron.js');
+var index = require('../Input/index.js');
+var index$1 = require('../Select/index.js');
+var helpers = require('./helpers.js');
+var styles = require('./Pagination.module.css');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+var clsx__default = /*#__PURE__*/_interopDefault(clsx);
+var styles__default = /*#__PURE__*/_interopDefault(styles);
+
+const NO_PAGES = [];
+const DEFAULT_PAGE_SIZE_OPTIONS = [20, 50, 100];
+const defaultPageLabel = page => `Page ${page}`;
+const Pagination = _a => {
+  var {
+      totalPages,
+      page,
+      defaultPage = 1,
+      onPageChange,
+      siblingCount = 1,
+      boundaryCount = 1,
+      disabledPages = NO_PAGES,
+      disabled = false,
+      mode = "default",
+      size = "m",
+      pageSize,
+      defaultPageSize = 20,
+      pageSizeOptions = DEFAULT_PAGE_SIZE_OPTIONS,
+      onPageSizeChange,
+      showPageSize = false,
+      showQuickJump = false,
+      helperText,
+      previousLabel = "Previous page",
+      nextLabel = "Next page",
+      pageLabel = defaultPageLabel,
+      quickJumpLabel = "Go to page",
+      pageSizeLabel = "Per page",
+      className,
+      ref,
+      "aria-label": ariaLabel = "Pagination"
+    } = _a,
+    props = tslib.__rest(_a, ["totalPages", "page", "defaultPage", "onPageChange", "siblingCount", "boundaryCount", "disabledPages", "disabled", "mode", "size", "pageSize", "defaultPageSize", "pageSizeOptions", "onPageSizeChange", "showPageSize", "showQuickJump", "helperText", "previousLabel", "nextLabel", "pageLabel", "quickJumpLabel", "pageSizeLabel", "className", "ref", "aria-label"]);
+  const total = helpers.toTotalPages(totalPages);
+  const [internalPage, setInternalPage] = React.useState(() => helpers.clamp(defaultPage, 1, total));
+  const currentPage = helpers.clamp(page !== null && page !== void 0 ? page : internalPage, 1, total);
+  const [internalPageSize, setInternalPageSize] = React.useState(defaultPageSize);
+  const currentPageSize = pageSize !== null && pageSize !== void 0 ? pageSize : internalPageSize;
+  const [quickJumpDraft, setQuickJumpDraft] = React.useState(null);
+  const disabledSet = React.useMemo(() => new Set(disabledPages), [disabledPages]);
+  const items = React.useMemo(() => helpers.getPaginationItems(total, currentPage, siblingCount, boundaryCount), [total, currentPage, siblingCount, boundaryCount]);
+  const pageSizeSelectOptions = React.useMemo(() => pageSizeOptions.map(option => ({
+    value: String(option),
+    label: option
+  })), [pageSizeOptions]);
+  const previousPage = helpers.findEnabledPage(currentPage, -1, total, disabledSet);
+  const nextPage = helpers.findEnabledPage(currentPage, 1, total, disabledSet);
+  const changePage = nextValue => {
+    const next = helpers.clamp(Math.floor(nextValue), 1, total);
+    if (disabled || disabledSet.has(next) || next === currentPage) return;
+    if (page === undefined) setInternalPage(next);
+    onPageChange === null || onPageChange === void 0 ? void 0 : onPageChange(next);
+  };
+  const commitQuickJump = () => {
+    if (quickJumpDraft === null) return;
+    const parsed = Number(quickJumpDraft);
+    if (quickJumpDraft.trim() !== "" && Number.isInteger(parsed)) {
+      changePage(parsed);
+    }
+    setQuickJumpDraft(null);
+  };
+  const changePageSize = next => {
+    if (pageSize === undefined) setInternalPageSize(next);
+    onPageSizeChange === null || onPageSizeChange === void 0 ? void 0 : onPageSizeChange(next);
+  };
+  const hasActions = showQuickJump || showPageSize || Boolean(helperText);
+  return /*#__PURE__*/React__default.default.createElement("nav", Object.assign({}, props, {
+    ref: ref,
+    "aria-label": ariaLabel,
+    className: clsx__default.default(styles__default.default.root, styles__default.default[`size_${size}`], {
+      [styles__default.default.root_disabled]: disabled
+    }, className)
+  }), /*#__PURE__*/React__default.default.createElement("div", {
+    className: styles__default.default.main
+  }, /*#__PURE__*/React__default.default.createElement("button", {
+    type: "button",
+    className: styles__default.default.arrow,
+    "aria-label": previousLabel,
+    disabled: disabled || previousPage === undefined,
+    onClick: () => {
+      if (previousPage !== undefined) changePage(previousPage);
+    }
+  }, /*#__PURE__*/React__default.default.createElement(Chevron.Chevron, {
+    className: styles__default.default.arrow_previous,
+    width: 16,
+    height: 16,
+    "aria-hidden": "true"
+  })), mode === "compact" ? (/*#__PURE__*/React__default.default.createElement("span", {
+    className: styles__default.default.counter,
+    "aria-live": "polite"
+  }, /*#__PURE__*/React__default.default.createElement("strong", null, currentPage), /*#__PURE__*/React__default.default.createElement("span", null, "/"), total)) : (/*#__PURE__*/React__default.default.createElement("div", {
+    className: styles__default.default.pages
+  }, items.map(item => typeof item === "number" ? (/*#__PURE__*/React__default.default.createElement("button", {
+    type: "button",
+    key: item,
+    className: clsx__default.default(styles__default.default.page, {
+      [styles__default.default.page_current]: item === currentPage
+    }),
+    "aria-label": pageLabel(item),
+    "aria-current": item === currentPage ? "page" : undefined,
+    disabled: disabled || disabledSet.has(item),
+    onClick: () => changePage(item)
+  }, item)) : (/*#__PURE__*/React__default.default.createElement("span", {
+    key: item,
+    className: styles__default.default.ellipsis,
+    "aria-hidden": "true"
+  }, "\u2026"))))), /*#__PURE__*/React__default.default.createElement("button", {
+    type: "button",
+    className: styles__default.default.arrow,
+    "aria-label": nextLabel,
+    disabled: disabled || nextPage === undefined,
+    onClick: () => {
+      if (nextPage !== undefined) changePage(nextPage);
+    }
+  }, /*#__PURE__*/React__default.default.createElement(Chevron.Chevron, {
+    className: styles__default.default.arrow_next,
+    width: 16,
+    height: 16,
+    "aria-hidden": "true"
+  }))), hasActions && (/*#__PURE__*/React__default.default.createElement("div", {
+    className: styles__default.default.actions
+  }, showQuickJump && (/*#__PURE__*/React__default.default.createElement(index.Input, {
+    className: styles__default.default.jump,
+    size: size,
+    label: quickJumpLabel,
+    inputMode: "numeric",
+    value: quickJumpDraft !== null && quickJumpDraft !== void 0 ? quickJumpDraft : String(currentPage),
+    disabled: disabled,
+    onChange: (_, value) => setQuickJumpDraft(value),
+    onBlur: commitQuickJump,
+    onKeyDown: event => {
+      if (event.key === "Enter") commitQuickJump();
+    }
+  })), showPageSize && (/*#__PURE__*/React__default.default.createElement(index$1.Select, {
+    size: size,
+    label: pageSizeLabel,
+    options: pageSizeSelectOptions,
+    value: String(currentPageSize),
+    disabled: disabled,
+    onChange: value => changePageSize(Number(value))
+  })), helperText && /*#__PURE__*/React__default.default.createElement("div", {
+    className: styles__default.default.helper
+  }, helperText))));
+};
+
+exports.Pagination = Pagination;

package/Pagination/Pagination.module.css

@@ -0,0 +1,118 @@
+.root {
+  --pagination-item-size: var(--component-input-height-m);
+  --pagination-font-size: var(--font-size-text-md);
+  color: var(--component-pagination-text);
+  display: inline-flex;
+  flex-direction: column;
+  font-family: var(--font-family-ui);
+  gap: var(--space-3);
+  max-inline-size: 100%;
+}
+.root_disabled {
+  opacity: 0.55;
+}
+
+.size_s {
+  --pagination-item-size: var(--component-input-height-s);
+  --pagination-font-size: var(--font-size-text-sm);
+}
+.size_l {
+  --pagination-item-size: var(--component-input-height-l);
+}
+
+.main,
+.pages {
+  align-items: center;
+  display: flex;
+  gap: var(--space-1);
+}
+
+.page,
+.arrow {
+  align-items: center;
+  background: transparent;
+  block-size: var(--pagination-item-size);
+  border: none;
+  border-radius: var(--radius-sm);
+  box-sizing: border-box;
+  color: inherit;
+  cursor: pointer;
+  display: inline-flex;
+  font: inherit;
+  font-size: var(--pagination-font-size);
+  justify-content: center;
+  min-inline-size: var(--pagination-item-size);
+  padding: 0 var(--space-2);
+}
+.page:disabled,
+.arrow:disabled {
+  color: var(--color-text-disabled);
+  cursor: not-allowed;
+}
+.page:focus-visible,
+.arrow:focus-visible {
+  outline: var(--focus-ring-width) solid var(--component-pagination-focus-ring);
+  outline-offset: var(--focus-ring-width);
+}
+.page:hover:not(:disabled),
+.arrow:hover:not(:disabled) {
+  background: var(--component-pagination-bg-hover);
+}
+
+.page_current,
+.page_current:hover:not(:disabled) {
+  background: var(--component-pagination-bg-current);
+  color: var(--component-pagination-text-current);
+  cursor: default;
+}
+
+.arrow_previous {
+  transform: rotate(90deg);
+}
+
+.arrow_next {
+  transform: rotate(-90deg);
+}
+
+.ellipsis {
+  align-items: center;
+  block-size: var(--pagination-item-size);
+  color: var(--color-text-secondary);
+  display: inline-flex;
+  font-size: var(--pagination-font-size);
+  justify-content: center;
+  min-inline-size: var(--space-6);
+  -webkit-user-select: none;
+          user-select: none;
+}
+
+.counter {
+  align-items: center;
+  display: flex;
+  font-size: var(--pagination-font-size);
+  gap: var(--space-1);
+  justify-content: center;
+  min-inline-size: var(--space-20);
+}
+
+.actions {
+  align-items: flex-end;
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--space-4);
+  min-inline-size: 0;
+}
+
+.jump {
+  inline-size: var(--space-20);
+}
+
+.helper {
+  color: var(--color-text-secondary);
+  font-size: var(--font-size-text-sm);
+  line-height: var(--pagination-item-size);
+  min-inline-size: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}

package/Pagination/helpers.d.ts

@@ -0,0 +1,5 @@
+import type { PaginationItem } from "./index.props";
+export declare const clamp: (value: number, min: number, max: number) => number;
+export declare const toTotalPages: (totalPages: number) => number;
+export declare const getPaginationItems: (totalPages: number, page: number, siblingCount?: number, boundaryCount?: number) => PaginationItem[];
+export declare const findEnabledPage: (from: number, direction: -1 | 1, total: number, disabledPages: ReadonlySet<number>) => number | undefined;

package/Pagination/helpers.js

@@ -0,0 +1,36 @@
+'use strict';
+
+const range = (start, end) => Array.from({
+  length: Math.max(0, end - start + 1)
+}, (_, index) => start + index);
+const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
+const toTotalPages = totalPages => Math.max(1, Math.floor(totalPages) || 1);
+const getPaginationItems = (totalPages, page, siblingCount = 1, boundaryCount = 1) => {
+  const total = toTotalPages(totalPages);
+  const current = clamp(Math.floor(page) || 1, 1, total);
+  const siblings = Math.max(0, Math.floor(siblingCount));
+  const boundaries = Math.max(0, Math.floor(boundaryCount));
+  const pages = [...new Set([...range(1, Math.min(boundaries, total)), ...range(Math.max(1, current - siblings), Math.min(total, current + siblings)), ...range(Math.max(1, total - boundaries + 1), total)])].sort((left, right) => left - right);
+  return pages.flatMap((visiblePage, index) => {
+    const previous = pages[index - 1];
+    if (previous === undefined) return [visiblePage];
+    if (visiblePage - previous === 2) return [previous + 1, visiblePage];
+    if (visiblePage - previous > 2) {
+      const ellipsis = visiblePage > current ? "end-ellipsis" : "start-ellipsis";
+      return [ellipsis, visiblePage];
+    }
+    return [visiblePage];
+  });
+};
+const findEnabledPage = (from, direction, total, disabledPages) => {
+  let candidate = from + direction;
+  while (candidate >= 1 && candidate <= total && disabledPages.has(candidate)) {
+    candidate += direction;
+  }
+  return candidate >= 1 && candidate <= total ? candidate : undefined;
+};
+
+exports.clamp = clamp;
+exports.findEnabledPage = findEnabledPage;
+exports.getPaginationItems = getPaginationItems;
+exports.toTotalPages = toTotalPages;

package/Pagination/index.d.ts

@@ -0,0 +1,3 @@
+export { Pagination } from "./Pagination";
+export { getPaginationItems } from "./helpers";
+export type { PaginationItem, PaginationMode, PaginationProps, PaginationSize, } from "./index.props";

package/Pagination/index.js

@@ -0,0 +1,9 @@
+'use strict';
+
+var Pagination = require('./Pagination.js');
+var helpers = require('./helpers.js');
+
+
+
+exports.Pagination = Pagination.Pagination;
+exports.getPaginationItems = helpers.getPaginationItems;

package/Pagination/index.props.d.ts

@@ -0,0 +1,31 @@
+import type { HTMLAttributes, ReactNode, Ref } from "react";
+export type PaginationSize = "s" | "m" | "l";
+export type PaginationMode = "default" | "compact";
+export type PaginationItem = number | "start-ellipsis" | "end-ellipsis";
+export interface PaginationProps extends Omit<HTMLAttributes<HTMLElement>, "onChange" | "defaultValue"> {
+    totalPages: number;
+    page?: number;
+    defaultPage?: number;
+    onPageChange?: (page: number) => void;
+    /** Pages shown on each side of the current page. */
+    siblingCount?: number;
+    /** Pages always shown at the start and at the end. */
+    boundaryCount?: number;
+    disabledPages?: readonly number[];
+    disabled?: boolean;
+    mode?: PaginationMode;
+    size?: PaginationSize;
+    pageSize?: number;
+    defaultPageSize?: number;
+    pageSizeOptions?: readonly number[];
+    onPageSizeChange?: (pageSize: number) => void;
+    showPageSize?: boolean;
+    showQuickJump?: boolean;
+    helperText?: ReactNode;
+    previousLabel?: string;
+    nextLabel?: string;
+    pageLabel?: (page: number) => string;
+    quickJumpLabel?: ReactNode;
+    pageSizeLabel?: ReactNode;
+    ref?: Ref<HTMLElement>;
+}

package/Pagination/package.json

@@ -0,0 +1,9 @@
+{
+  "sideEffects": [
+    "**/*.css",
+    "**/*.scss"
+  ],
+  "module": "../esm/Pagination/index.js",
+  "main": "./index.js",
+  "types": "./index.d.ts"
+}

package/README.md

@@ -196,6 +196,57 @@ const css = `@media ${media.down("sm")} { … }`;
 
 Returns `false` on the server and during hydration. Use it to decide whether to mount a heavy component; to show/hide markup use CSS media queries, otherwise the wrong variant renders until hydration.
 
+## Development Commands
+
+Run these commands from the repository root after installing dependencies with `yarn install`.
+
+### Checks and Fixes
+
+| Command                | Purpose                                                                                                                |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `yarn lint`            | Run both ESLint and Stylelint.                                                                                         |
+| `yarn lint:ts`         | Check JavaScript and TypeScript with ESLint.                                                                           |
+| `yarn lint:ts:fix`     | Apply automatic ESLint fixes.                                                                                          |
+| `yarn lint:css`        | Check SCSS with Stylelint.                                                                                             |
+| `yarn lint:css:fix`    | Apply automatic Stylelint fixes.                                                                                       |
+| `yarn lint:deps`       | Check component dependency boundaries.                                                                                 |
+| `yarn test`            | Run Jest tests and collect coverage in `.coverage/`.                                                                   |
+| `yarn test:coverage`   | Explicitly enable coverage; currently equivalent to `yarn test` because coverage is enabled in the Jest configuration. |
+| `yarn audit:dead-code` | Check for unused files, exports and dependencies with Knip.                                                            |
+
+`./verify.sh` runs lint, dependency boundary checks, tests and the dead code audit in sequence, stopping at the first failure.
+
+### Storybook
+
+| Command                | Purpose                                                 |
+| ---------------------- | ------------------------------------------------------- |
+| `yarn storybook`       | Start the Storybook development server on port 6006.    |
+| `yarn build-storybook` | Build the static Storybook site in `storybook-static/`. |
+
+### Package Build
+
+| Command                    | Purpose                                                                                                               |
+| -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `yarn build`               | Clean `dist/`, build CommonJS and ESM output with Rollup, run all build stages below and check the resulting exports. |
+| `yarn clean`               | Delete `dist/`.                                                                                                       |
+| `yarn build:sass`          | Compile SCSS to CSS and apply Autoprefixer for both package formats.                                                  |
+| `yarn build:updateImports` | Replace SCSS import paths with CSS paths in the built JavaScript.                                                     |
+| `yarn build:variables`     | Generate CSS variables files for Buenos Aires and Jaipur.                                                             |
+| `yarn build:postbuild`     | Copy package metadata and README, and generate component package manifests.                                           |
+| `yarn build:check`         | Check that built CommonJS and ESM entry points provide the runtime exports declared in their types.                   |
+
+Use `yarn build` for a complete build. Individual build stages operate on existing output and are mainly useful when diagnosing the build pipeline.
+
+### Audits
+
+| Command              | Purpose                                                                                                          |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `yarn run audit`     | Check production and development dependencies for known vulnerabilities using Yarn's audit command.              |
+| `yarn audit:snyk`    | Check dependencies with Snyk; requires Snyk authentication.                                                      |
+| `yarn audit:package` | Check the built package with Publint and Are the Types Wrong using the `node16` profile. Run after `yarn build`. |
+
+Dependency security audits require network access. To check for available dependency updates, run `yarn outdated` directly.
+
 ## License
 
 MIT

package/Select/index.d.ts

@@ -1,3 +1,3 @@
 import type { JSX } from "react";
 import type { SelectProps } from "./index.props";
-export declare const Select: <T extends string>({ options, value, name, zIndex, fontSize, label, hint, hasError, required, placeholder, disabled, size, fullWidth, customInputRoot, className, onChange, }: SelectProps<T>) => JSX.Element;
+export declare const Select: <T extends string>({ options, value, name, zIndex, fontSize, label, hint, hasError, required, placeholder, disabled, size, fullWidth, customInputRoot, className, onChange, "aria-label": ariaLabel, }: SelectProps<T>) => JSX.Element;