uikit-react-public 0.11.16 → 0.11.24

package/dist/components/Calendar/Calendar.d.ts

@@ -0,0 +1,3 @@
+import { CalendarProps } from './Calendar.types';
+declare const Calendar: ({ pickedDate, onDatePick, minDate, maxDate, events, showAcademicWeeks, academicWeeks, testId, className, }: CalendarProps) => import("react/jsx-runtime").JSX.Element;
+export default Calendar;

package/dist/components/Calendar/Calendar.stories.d.ts

@@ -0,0 +1,42 @@
+import { StoryObj } from '@storybook/react';
+declare const meta: {
+    title: string;
+    component: ({ pickedDate, onDatePick, minDate, maxDate, events, showAcademicWeeks, academicWeeks, testId, className, }: import('./Calendar.types').CalendarProps) => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+    argTypes: {
+        pickedDate: {
+            control: {
+                type: "date";
+            };
+        };
+        minDate: {
+            control: {
+                type: "date";
+            };
+        };
+        maxDate: {
+            control: {
+                type: "date";
+            };
+        };
+        showAcademicWeeks: {
+            control: {
+                type: "boolean";
+            };
+        };
+        testId: {
+            control: {
+                type: "text";
+            };
+        };
+    };
+    tags: string[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Default: Story;
+export declare const WithEvents: Story;
+export declare const WithAcademicWeeks: Story;
+export declare const MinMaxDates: Story;

package/dist/components/Calendar/Calendar.types.d.ts

@@ -0,0 +1,18 @@
+export type CalendarEvent = {
+    date: string;
+};
+export type AcademicWeek = {
+    start: string;
+    number: number;
+};
+export interface CalendarProps {
+    pickedDate?: Date | null;
+    onDatePick?: (date: Date | null, event?: React.SyntheticEvent) => void;
+    minDate?: string | null;
+    maxDate?: string | null;
+    events?: CalendarEvent[];
+    showAcademicWeeks?: boolean;
+    academicWeeks?: AcademicWeek[];
+    testId?: string;
+    className?: string;
+}

package/dist/components/Calendar/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './Calendar';
+export type { CalendarProps, CalendarEvent, AcademicWeek, } from './Calendar.types';

package/dist/components/Calendar/subcomponents/AcademicWeek.d.ts

@@ -0,0 +1,5 @@
+interface AcademicWeekProps {
+    weekNumber?: number | null;
+}
+declare const AcademicWeek: ({ weekNumber }: AcademicWeekProps) => import("react/jsx-runtime").JSX.Element;
+export default AcademicWeek;

package/dist/components/Calendar/subcomponents/AcademicWeeks.d.ts

@@ -0,0 +1,7 @@
+import { AcademicWeek as AcademicWeekType } from '../Calendar.types';
+interface AcademicWeeksProps {
+    date: Date;
+    weeks: AcademicWeekType[];
+}
+declare const AcademicWeeks: ({ date, weeks }: AcademicWeeksProps) => import("react/jsx-runtime").JSX.Element;
+export default AcademicWeeks;

package/dist/components/Calendar/subcomponents/ColumnHeading.d.ts

@@ -0,0 +1,7 @@
+interface ColumnHeadingProps {
+    index: number;
+    day: string;
+    isWeekend: boolean;
+}
+declare const ColumnHeading: ({ index, day, isWeekend }: ColumnHeadingProps) => import("react/jsx-runtime").JSX.Element;
+export default ColumnHeading;

package/dist/components/Calendar/subcomponents/Controls.d.ts

@@ -0,0 +1,6 @@
+interface ControlsProps {
+    month: Date;
+    changeMonth: (change: number) => void;
+}
+declare const Controls: ({ month, changeMonth }: ControlsProps) => import("react/jsx-runtime").JSX.Element;
+export default Controls;

package/dist/components/Calendar/subcomponents/Day.d.ts

@@ -0,0 +1,12 @@
+import { CalendarEvent } from '../Calendar.types';
+export interface DayProps {
+    date: Date;
+    onPick?: (date: Date, event: React.SyntheticEvent) => void;
+    isSelected?: boolean;
+    isToday?: boolean;
+    isInCurrentMonth?: boolean;
+    isDisabled?: boolean;
+    events?: CalendarEvent[];
+}
+declare const Day: ({ date, onPick, isSelected, isToday, isInCurrentMonth, isDisabled, events, }: DayProps) => import("react/jsx-runtime").JSX.Element;
+export default Day;

package/dist/components/{Datepicker/subcomponents/Day → Calendar/subcomponents}/Day.stories.d.ts

@@ -1,7 +1,14 @@
 import { StoryObj } from '@storybook/react';
 declare const meta: {
     title: string;
-    component: ({ date, isSelected, isToday, isInCurrentMonth, isDisabled, onPick, }: import('./Day').DayProps) => import("react/jsx-runtime").JSX.Element;
+    component: ({ date, onPick, isSelected, isToday, isInCurrentMonth, isDisabled, events, }: import('./Day').DayProps) => import("react/jsx-runtime").JSX.Element;
+    argTypes: {
+        events: {
+            table: {
+                disable: true;
+            };
+        };
+    };
 };
 export default meta;
 type Story = StoryObj<typeof meta>;
@@ -10,4 +17,5 @@ export declare const Selected: Story;
 export declare const Today: Story;
 export declare const Disabled: Story;
 export declare const NotInCurrentMonth: Story;
+export declare const WithEventDots: Story;
 export declare const AlertOnPick: Story;

package/dist/components/Calendar/subcomponents/EventDot.d.ts

@@ -0,0 +1,6 @@
+interface EventDotProps {
+    inverted: boolean;
+    inCurrentMonth: boolean;
+}
+declare const EventDot: ({ inverted, inCurrentMonth }: EventDotProps) => import("react/jsx-runtime").JSX.Element;
+export default EventDot;

package/dist/components/Calendar/subcomponents/Grid.d.ts

@@ -0,0 +1,11 @@
+import { CalendarEvent } from '../Calendar.types';
+interface GridProps {
+    month: Date;
+    pickedDate: Date | null;
+    onDatePick?: (date: Date, event: React.SyntheticEvent) => void;
+    minDate: Date | null;
+    maxDate: Date | null;
+    events: CalendarEvent[];
+}
+declare const Grid: ({ month, pickedDate, onDatePick, minDate, maxDate, events, }: GridProps) => import("react/jsx-runtime").JSX.Element;
+export default Grid;

package/dist/components/Calendar/subcomponents/index.d.ts

@@ -0,0 +1,7 @@
+export { default as Controls } from './Controls';
+export { default as AcademicWeeks } from './AcademicWeeks';
+export { default as AcademicWeek } from './AcademicWeek';
+export { default as Grid } from './Grid';
+export { default as ColumnHeading } from './ColumnHeading';
+export { default as Day } from './Day';
+export { default as EventDot } from './EventDot';

package/dist/components/Calendar/utils/getAcademicWeekNumbers/getAcademicWeekNumbers.d.ts

@@ -0,0 +1,24 @@
+import { AcademicWeek } from '../../';
+/**
+ * Returns the Monday for the week of the given date.
+ * For example:
+ * - If the input date is a Wednesday, it returns the Monday of that week.
+ * - If the input date is already a Monday, it returns that date.
+ * @param {Date} d - The input date.
+ * @returns {Date} The Monday of the week of the input date.
+ */
+export declare const getMonday: (d: Date) => Date;
+/**
+ * Calculates the academic week numbers for each week displayed in a calendar month.
+ * Used by `<AcademicWeeks />` component in the Datepicker.
+ * It determines the Mondays of each week shown in the calendar for the `targetDate`'s month.
+ * Then, it maps these Mondays to the corresponding academic week number from the `academicWeeks` array.
+ * If an academic week is not found for a given Monday, `undefined` is used, in place in the returned array.
+ *
+ * @param {AcademicWeek[]} academicWeeks - An array of academic week objects, each with a `start` date and `number`.
+ * @param {Date} targetDate - The date used to generate the calendar display.
+ * @returns {(number | undefined)[]} An array of academic week numbers or `undefined` for each week in the calendar display.
+ * Returns an empty array if `academicWeeks` is empty or `targetDate` is invalid, with console warnings, in the interest of safe usage.
+ */
+declare const getAcademicWeekNumbers: (academicWeeks: AcademicWeek[], targetDate: Date) => (number | undefined)[];
+export default getAcademicWeekNumbers;

package/dist/components/Calendar/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { default as normaliseMonth } from './normaliseMonth/normaliseMonth';
+export { default as parseDateFromString } from './parseDateFromString/parseDateFromString';
+export { default as getAcademicWeekNumbers } from './getAcademicWeekNumbers/getAcademicWeekNumbers';
+export { default as getDatesForCalendarGrid } from './getDatesForCalendarGrid/getDatesForCalendarGrid';

package/dist/components/Calendar/utils/normaliseMonth/normaliseMonth.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Normalises a given date to the first day of its month (with the time set to midnight).
+ * If the input date is undefined, it returns null.
+ * Used in <Calendar> to track the displayed month.
+ * @param date The date to normalise.
+ * @returns A new Date object set to the first day of the month with the time at midnight, or null if the input was null or undefined.
+ */
+declare const normaliseMonth: (date: Date | null | undefined) => Date | null;
+export default normaliseMonth;

package/dist/components/Calendar/utils/normaliseMonth/normaliseMonth.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Calendar/utils/parseDateFromString/parseDateFromString.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Parses a date string into a Date object.
+ * Returns null if the input is invalid.
+ *
+ * @param dateString - The date string to parse (can be in ISO format or UNIX timestamp).
+ * @returns A Date object, or null if invalid.
+ */
+declare const parseDateFromString: (dateString: string) => Date | null;
+export default parseDateFromString;

package/dist/components/Calendar/utils/parseDateFromString/parseDateFromString.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Datepicker/Datepicker.d.ts

@@ -1,12 +1,3 @@
-import { InputHTMLAttributes } from 'react';
-export declare const NAME = "ucl-datepicker";
-export interface DatepickerProps extends InputHTMLAttributes<HTMLInputElement> {
-    date: Date | null | undefined;
-    minDate?: Date | null | undefined;
-    maxDate?: Date | null | undefined;
-    onDateChange: (date: Date | null | undefined) => void;
-    native?: boolean;
-    testId?: string;
-}
-declare const _default: import('react').MemoExoticComponent<({ date, minDate, maxDate, onDateChange, native, testId, className, ...props }: DatepickerProps) => import("react/jsx-runtime").JSX.Element>;
-export default _default;
+import { DatepickerProps } from './Datepicker.types';
+declare const Datepicker: ({ value, onValueChange, minDate, maxDate, disabled, className, native, nativeRef, nativeHTMLAttributes, ...props }: DatepickerProps) => import("react/jsx-runtime").JSX.Element;
+export default Datepicker;

package/dist/components/Datepicker/Datepicker.stories.d.ts

@@ -1,12 +1,12 @@
 import { StoryObj } from '@storybook/react';
 declare const meta: {
     title: string;
-    component: import('react').MemoExoticComponent<({ date, minDate, maxDate, onDateChange, native, testId, className, ...props }: import('./Datepicker').DatepickerProps) => import("react/jsx-runtime").JSX.Element>;
+    component: ({ value, onValueChange, minDate, maxDate, disabled, className, native, nativeRef, nativeHTMLAttributes, ...props }: import('./Datepicker.types').DatepickerProps) => import("react/jsx-runtime").JSX.Element;
     parameters: {
         layout: string;
     };
     argTypes: {
-        date: {
+        value: {
             control: {
                 type: "date";
             };
@@ -21,15 +21,28 @@ declare const meta: {
                 type: "date";
             };
         };
+        disabled: {
+            control: {
+                type: "boolean";
+            };
+        };
         native: {
             control: {
                 type: "boolean";
             };
         };
+        showAcademicWeeks: {
+            control: {
+                type: "boolean";
+            };
+        };
     };
     tags: string[];
 };
 export default meta;
 type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
-export declare const AsNative: Story;
+export declare const WithEvents: Story;
+export declare const WithAcademicWeeks: Story;
+export declare const MinMaxDates: Story;
+export declare const Native: Story;

package/dist/components/Datepicker/Datepicker.types.d.ts

@@ -0,0 +1,23 @@
+import { InputHTMLAttributes, HTMLAttributes, RefObject } from 'react';
+import { CalendarEvent, AcademicWeek } from '../Calendar';
+export type DatepickerValue = Date | null;
+interface BaseDatepickerProps {
+    value?: DatepickerValue;
+    onValueChange?: (value: DatepickerValue, event?: React.SyntheticEvent) => void;
+    minDate?: string | null;
+    maxDate?: string | null;
+    events?: CalendarEvent[];
+    showAcademicWeeks?: boolean;
+    academicWeeks?: AcademicWeek[];
+    testId?: string;
+    disabled?: boolean;
+    ref?: RefObject<HTMLDivElement>;
+    inputRef?: RefObject<HTMLInputElement>;
+}
+type NativeDatepickerAttributeProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'min' | 'max' | 'className' | 'disabled'>;
+export interface DatepickerProps extends BaseDatepickerProps, HTMLAttributes<HTMLDivElement> {
+    native?: boolean;
+    nativeHTMLAttributes?: NativeDatepickerAttributeProps;
+    nativeRef?: RefObject<HTMLInputElement>;
+}
+export {};

package/dist/components/Datepicker/index.d.ts

@@ -1,2 +1,2 @@
 export { default } from './Datepicker';
-export type { DatepickerProps } from './Datepicker';
+export type { DatepickerProps } from './Datepicker.types';

package/dist/components/Datepicker/subcomponents/CustomDatepicker.d.ts

@@ -0,0 +1,17 @@
+import { DatepickerValue } from '../Datepicker.types';
+import { CalendarEvent, AcademicWeek } from '../../Calendar';
+interface CustomDatepickerProps extends React.HTMLAttributes<HTMLDivElement> {
+    value?: DatepickerValue;
+    onValueChange?: (value: DatepickerValue, event?: React.SyntheticEvent) => void;
+    minDate?: string | null;
+    maxDate?: string | null;
+    disabled?: boolean;
+    events?: CalendarEvent[];
+    showAcademicWeeks?: boolean;
+    academicWeeks?: AcademicWeek[];
+    testId?: string;
+    ref?: React.RefObject<HTMLDivElement>;
+    inputRef?: React.RefObject<HTMLInputElement>;
+}
+declare const CustomDatepicker: ({ value, onValueChange, minDate, maxDate, disabled, events, showAcademicWeeks, academicWeeks, testId, className, ref, inputRef, ...props }: CustomDatepickerProps) => import("react/jsx-runtime").JSX.Element;
+export default CustomDatepicker;

package/dist/components/Datepicker/subcomponents/DatepickerInput.d.ts

@@ -0,0 +1,10 @@
+interface DatepickerInputProps {
+    value: string;
+    onChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
+    onKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+    onFocus: () => void;
+    disabled: boolean;
+    ref: React.RefObject<HTMLInputElement | null>;
+}
+declare const DatepickerInput: ({ value, onChange, onKeyDown, onFocus, disabled, ref, }: DatepickerInputProps) => import("react/jsx-runtime").JSX.Element;
+export default DatepickerInput;

package/dist/components/Datepicker/subcomponents/NativeDatepicker.d.ts

@@ -0,0 +1,6 @@
+interface NativeDatepickerProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    testId?: string;
+    ref?: React.RefObject<HTMLInputElement>;
+}
+declare const NativeDatepicker: ({ value, onChange, min, max, className, disabled, testId, ref, ...props }: NativeDatepickerProps) => import("react/jsx-runtime").JSX.Element;
+export default NativeDatepicker;

package/dist/components/Datepicker/subcomponents/Panel.d.ts

@@ -0,0 +1,6 @@
+interface PanelProps {
+    zIndex?: number;
+    children: React.ReactNode;
+}
+declare const Panel: ({ zIndex, children }: PanelProps) => import("react/jsx-runtime").JSX.Element;
+export default Panel;

package/dist/components/Datepicker/subcomponents/VisibleField.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+interface VisibleFieldProps {
+    inputValue: string;
+    onInputChange: (event: React.ChangeEvent<HTMLInputElement>) => void;
+    onInputKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+    onInputFocus: () => void;
+    onButtonClick: () => void;
+    disabled: boolean;
+    inputRef: React.RefObject<HTMLInputElement | null>;
+}
+declare const VisibleField: ({ inputValue, onInputChange, onInputKeyDown, onInputFocus, onButtonClick, disabled, inputRef, }: VisibleFieldProps) => import("react/jsx-runtime").JSX.Element;
+export default VisibleField;

package/dist/components/Datepicker/subcomponents/index.d.ts

@@ -1,7 +1,5 @@
-export { default as CalendarGrid } from './CalendarGrid';
-export { default as CalendarMenu } from './CalendarMenu';
-export { default as ColumnHeadings } from './ColumnHeadings';
-export { default as DateField } from './DateField';
-export { default as Day } from './Day';
-export { default as Native } from './Native';
-export { default as MonthSelector } from './MonthSelector';
+export { default as CustomDatepicker } from './CustomDatepicker';
+export { default as NativeDatepicker } from './NativeDatepicker';
+export { default as VisibleField } from './VisibleField';
+export { default as DatepickerInput } from './DatepickerInput';
+export { default as Panel } from './Panel';

package/dist/components/Datepicker/utils/dateToLocaleISOString/dateToLocaleISOString.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts a Date object to a `YYYY-MM-DD` string based on the user's local timezone.
+ *
+ * Used for passing dates to <NativeDatepicker> in `Datepicker.tsx`
+ *
+ * This function uses the Swedish (`sv-SE`) locale with `toLocaleDateString`
+ * as it conveniently defaults to the ISO 8601 `YYYY-MM-DD` format, while respecting
+ * the local date. This avoids timezone conversion issues that can arise from
+ * using `toISOString()`.
+ *
+ * This implementation should handle daylight saving time, etc, correctly.
+ *
+ * @param date The date to convert.
+ * @returns A string in `YYYY-MM-DD` format, or `null` if the input is `null`.
+ */
+declare const dateToLocaleISOString: (date: Date | null | undefined) => string | null;
+export default dateToLocaleISOString;

package/dist/components/Datepicker/utils/dateToLocaleISOString/dateToLocaleISOString.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Datepicker/utils/index.d.ts

@@ -1,2 +1,2 @@
-export { default as getDatesForCalendarGrid } from './getDatesForCalendarGrid/getDatesForCalendarGrid';
-export { default as parseDate } from './parseDateForDateField/parseDateForDateField';
+export { default as dateToLocaleISOString } from './dateToLocaleISOString/dateToLocaleISOString';
+export { default as parseInputValue } from './parseInputValue/parseInputValue';

package/dist/components/Datepicker/utils/parseInputValue/parseInputValue.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parses a date string into a Date object.
+ * Used in <VisibleField> to parse user input into the controlled <input> field.
+ *
+ * @param {string} value The date string to parse.  Expected format is DD/MM/YYYY, DD-MM-YYYY, or DD MM YYYY.
+ * @param {string} [minDate] Optional minimum date string in YYYY-MM-DD format. If the parsed date is before this date, the function returns null.
+ * @param {string} [maxDate] Optional maximum date string in YYYY-MM-DD format. If the parsed date is after this date, the function returns null.
+ * @returns {Date | null} A Date object representing the parsed date, or null if the input is invalid or out of range.
+ */
+declare const parseInputValue: (value: string, minDate?: string | null, maxDate?: string | null) => Date | null;
+export default parseInputValue;

package/dist/components/Datepicker/utils/parseInputValue/parseInputValue.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Footer/Footer.d.ts

@@ -2,7 +2,7 @@ import { HTMLAttributes } from 'react';
 import { default as FooterColumn } from './FooterColumn';
 import { default as FooterNavLink } from './FooterNavLink';
 export declare const NAME = "ucl-uikit-footer";
-export interface FooterProps extends HTMLAttributes<HTMLDivElement> {
+export interface FooterProps extends HTMLAttributes<HTMLElement> {
     testId?: string;
     disclaimer?: string;
     freedomOfInformation?: string;

package/dist/components/Header/Header.d.ts

@@ -1,14 +1,15 @@
-import { default as React, HTMLAttributes } from 'react';
+import { HTMLAttributes } from 'react';
 import { default as HeaderMenu } from './HeaderMenu';
 export declare const NAME = "ucl-uikit-header";
-export declare const HEADER_TOP_HEIGHT = 72;
-export declare const Z_INDEX = 3;
+export declare const HEADER_DESKTOP_HEIGHT_PX = 72;
+export declare const HEADER_MOBILE_HEIGHT_PX = 48;
+export declare const DEFAULT_Z_INDEX = 3;
 export interface HeaderProps extends HTMLAttributes<HTMLElement> {
     title?: string;
     fixed?: boolean;
     testId?: string;
 }
-declare const MemoAppHeader: React.MemoExoticComponent<({ title, fixed, testId, className, children, ...props }: HeaderProps) => import("react/jsx-runtime").JSX.Element>;
+declare const MemoAppHeader: import('react').MemoExoticComponent<({ title, fixed, testId, className, children, ...props }: HeaderProps) => import("react/jsx-runtime").JSX.Element>;
 export interface IHeaderSubComponents {
     Menu: typeof HeaderMenu;
 }

package/dist/components/Header/index.d.ts

@@ -1,3 +1,3 @@
 export { default } from './Header';
-export { HEADER_TOP_HEIGHT } from './Header';
+export { HEADER_DESKTOP_HEIGHT_PX, HEADER_MOBILE_HEIGHT_PX, DEFAULT_Z_INDEX, } from './Header';
 export type { HeaderProps } from './Header';

package/dist/components/Menu/Menu.d.ts

@@ -7,11 +7,12 @@ export interface MenuProps extends HTMLAttributes<HTMLDivElement> {
     title?: string;
     menuId?: string;
     testId?: string;
+    position?: 'left' | 'right';
 }
 export interface IMenuSubComponents {
     Section: typeof MenuSection;
     Item: typeof MenuItem;
 }
-declare const MemoMenu: import('react').MemoExoticComponent<({ defaultOpen, title, menuId, testId, children, className, ...props }: MenuProps) => import("react/jsx-runtime").JSX.Element>;
+declare const MemoMenu: import('react').MemoExoticComponent<({ defaultOpen, title, position, menuId, testId, children, className, ...props }: MenuProps) => import("react/jsx-runtime").JSX.Element>;
 declare const MenuWithSubComponents: typeof MemoMenu & IMenuSubComponents;
 export default MenuWithSubComponents;

package/dist/components/Menu/MenuContent.d.ts

@@ -3,6 +3,7 @@ export declare const NAME = "ucl-uikit-menu__content";
 export interface MenuContentProps extends HTMLAttributes<HTMLDivElement> {
     title?: string;
     testId?: string;
+    position?: 'left' | 'right';
 }
 declare const _default: React.NamedExoticComponent<MenuContentProps>;
 export default _default;

package/dist/components/Select/Select.stories.d.ts

@@ -41,7 +41,7 @@ declare const meta: {
         value: undefined;
         onChange: () => void;
         options: {
-            text: string;
+            label: string;
             value: string;
         }[];
     };

package/dist/components/Select/Select.types.d.ts

@@ -7,7 +7,7 @@ export type OptionData = {
     /**
      * Display text shown to the user
      */
-    text: string;
+    label: string;
     /**
      * Data-friendly value that is returned when the option is selected
      * We assume this will be submitted to a server or used in some other way
@@ -20,12 +20,6 @@ export type OptionData = {
      */
     icon?: React.ReactNode;
 };
-/**
- * Utility type we expose to developers
- * We expect this to be used in typing event handlers
- * This only applies to the top-level <Select> component
- */
-export type SelectEvent = React.ChangeEvent<HTMLSelectElement> | React.MouseEvent | React.KeyboardEvent;
 /**
  * Top level props that <Select> accepts when implemented
  */
@@ -34,20 +28,6 @@ interface BaseSelectProps {
      * An array of option data, to be rendered either natively or custom
      */
     options: OptionData[];
-    /**
-     * The currently selected value
-     * This determines which option is shown when the select is closed
-     */
-    value: string | undefined | null;
-    /**
-     * Generic onChange that splits into native and custom versions
-     * The original event is exposed, and the value always returns the value of the selected option
-     */
-    onChange: (event: SelectEvent, value: string) => void;
-    /**
-     * Prevents use, including focus events
-     */
-    disabled?: boolean | undefined;
     /**
      * Placeholder text shown when no option is selected
      * Displayed in visible field of custom implementation
@@ -64,51 +44,31 @@ interface BaseSelectProps {
      * as `data-testid`
      */
     testId?: string;
-    /**
-     * Optional className for styling
-     * This is passed to the root element of the component
-     * for additional CSS styling via Emotion.
-     */
-    className?: string;
     /**
      * Native flag determines which implementation to use
      */
     native?: boolean;
 }
-export type SelectProps = BaseSelectProps & (({
-    native: true;
-    ref?: React.RefObject<HTMLSelectElement | null>;
-} & Omit<React.SelectHTMLAttributes<HTMLSelectElement>, keyof BaseSelectProps>) | ({
-    native?: false;
-    ref?: React.RefObject<HTMLDivElement | null>;
-} & Omit<React.HTMLAttributes<HTMLDivElement>, keyof BaseSelectProps>));
 /**
  * Internal props for the custom implementation, with <div> as root element
  * onChange already exists on <div>. We override it.
  */
-export interface CustomSelectProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
-    options: OptionData[];
-    value: string | undefined | null;
-    onChange: (event: React.MouseEvent | React.KeyboardEvent, value: string) => void;
+export type CustomSelectProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> & BaseSelectProps & {
+    native?: false;
+    value?: string | number;
     disabled?: boolean;
-    placeholder?: string;
-    width?: number;
-    testId?: string;
-    className?: string;
+    onValueChange?: (value: string, ev: React.UIEvent) => void;
     ref?: React.RefObject<HTMLDivElement | null>;
-}
+};
 /**
  * Internal props for native implementation, with <select> as root element
  * Default props like value and onChange are passed to the <select> element automatically
  */
-export interface NativeSelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {
-    options: OptionData[];
-    placeholder?: string;
-    width?: number;
-    testId?: string;
-    className?: string;
+export type NativeSelectProps = React.SelectHTMLAttributes<HTMLSelectElement> & BaseSelectProps & {
+    native: true;
     ref?: React.RefObject<HTMLSelectElement | null>;
-}
+};
+export type SelectProps = NativeSelectProps | CustomSelectProps;
 /**
  * Each option as displayed in the Panel of <CustomSelect>
  * Roughly equivalent to a custom version of <option>

package/dist/components/Select/index.d.ts

@@ -1,2 +1,2 @@
 export { default } from './Select';
-export type { SelectProps, OptionData, SelectEvent } from './Select.types';
+export type { SelectProps, OptionData } from './Select.types';

package/dist/components/Select/subcomponents/CustomSelect.d.ts

@@ -1,3 +1,4 @@
 import { CustomSelectProps } from '../Select.types';
-declare const CustomSelect: ({ value, options, onChange, disabled, placeholder, width, testId, className, ref, ...props }: CustomSelectProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DEFAULT_WIDTH_PX = 200;
+declare const CustomSelect: ({ value, options, onValueChange, disabled, placeholder, width, testId, className, ref, ...props }: CustomSelectProps) => import("react/jsx-runtime").JSX.Element;
 export default CustomSelect;

package/dist/components/index.d.ts

@@ -77,3 +77,5 @@ export { default as Radio, LabelledRadio } from './Radio';
 export type { RadioProps, LabelledRadioProps } from './Radio';
 export { default as Datepicker } from './Datepicker';
 export type { DatepickerProps } from './Datepicker';
+export { default as Calendar } from './Calendar';
+export type { CalendarProps } from './Calendar';