uikit-react-public 0.11.20 → 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/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/{Datepicker/subcomponents/Day → Calendar/subcomponents}/Day.d.ts

@@ -1,7 +1,7 @@
-import { CalendarEvent } from '../../Datepicker.types';
+import { CalendarEvent } from '../Calendar.types';
 export interface DayProps {
-    date: Date | null | undefined;
-    onPick?: (date: Date) => void;
+    date: Date;
+    onPick?: (date: Date, event: React.SyntheticEvent) => void;
     isSelected?: boolean;
     isToday?: boolean;
     isInCurrentMonth?: boolean;

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

@@ -1,6 +1,6 @@
-type EventDotProps = {
+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/{Datepicker → Calendar}/utils/getAcademicWeekNumbers/getAcademicWeekNumbers.d.ts

@@ -1,4 +1,4 @@
-import { AcademicWeek } from '../../Datepicker.types';
+import { AcademicWeek } from '../../';
 /**
  * Returns the Monday for the week of the given date.
  * For example:

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/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,16 +1,3 @@
-import { InputHTMLAttributes } from 'react';
-import { CalendarEvent, AcademicWeek } from './Datepicker.types';
-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;
-    events?: CalendarEvent[];
-    showAcademicWeeks?: boolean;
-    academicWeeks?: AcademicWeek[];
-    testId?: string;
-}
-declare const _default: import('react').MemoExoticComponent<({ date, minDate, maxDate, onDateChange, native, events, showAcademicWeeks, academicWeeks, 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, events, showAcademicWeeks, academicWeeks, 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,6 +21,11 @@ declare const meta: {
                 type: "date";
             };
         };
+        disabled: {
+            control: {
+                type: "boolean";
+            };
+        };
         native: {
             control: {
                 type: "boolean";
@@ -37,6 +42,7 @@ declare const meta: {
 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

@@ -1,7 +1,23 @@
-export type CalendarEvent = {
-    date: string;
-};
-export type AcademicWeek = {
-    start: string;
-    number: number;
-};
+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,3 +1,2 @@
 export { default } from './Datepicker';
-export type { DatepickerProps } from './Datepicker';
-export type { CalendarEvent, AcademicWeek } from './Datepicker.types';
+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,3 +1,2 @@
-export { default as getDatesForCalendarGrid } from './getDatesForCalendarGrid/getDatesForCalendarGrid';
-export { default as parseDate } from './parseDateForDateField/parseDateForDateField';
-export { default as getAcademicWeekNumbers } from './getAcademicWeekNumbers/getAcademicWeekNumbers';
+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/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/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';