@golemui/gui-shared 1.0.2 → 1.1.0

package/lib/dx/shortcuts/scopes/scopeChain.d.ts

@@ -11,11 +11,21 @@ import { _gslCurrencies, _gslCurrencyByUid } from '../currency/register';
 import { _gslMarkdowns, _gslMarkdownByUid } from '../markdown/register';
 import { _gslLists, _gslListByUid } from '../list/register';
 import { _gslCalendars, _gslCalendarByUid } from '../calendar/register';
+import { _gslDateTimeCalendars, _gslDateTimeCalendarByUid } from '../date-time-calendar/register';
 import { _gslDateInputs, _gslDateInputByUid } from '../date-input/register';
 import { _gslDatePickers, _gslDatePickerByUid } from '../date-picker/register';
+import { _gslDateTimePickers, _gslDateTimePickerByUid } from '../date-time-picker/register';
 import { _gslRangeCalendars, _gslRangeCalendarByUid } from '../range-calendar/register';
 import { _gslRangeDateInputs, _gslRangeDateInputByUid } from '../range-date-input/register';
+import { _gslRangeDateTimeInputs, _gslRangeDateTimeInputByUid } from '../range-date-time-input/register';
+import { _gslRangeDateTimeCalendars, _gslRangeDateTimeCalendarByUid } from '../range-date-time-calendar/register';
+import { _gslRangeDateTimePickers, _gslRangeDateTimePickerByUid } from '../range-date-time-picker/register';
+import { _gslRangeTimeInputs, _gslRangeTimeInputByUid } from '../range-time-input/register';
+import { _gslTimeInputs, _gslTimeInputByUid } from '../time-input/register';
+import { _gslTimePickers, _gslTimePickerByUid } from '../time-picker/register';
+import { _gslDateTimeInputs, _gslDateTimeInputByUid } from '../date-time-input/register';
 import { _gslRangeDatePickers, _gslRangeDatePickerByUid } from '../range-date-picker/register';
+import { _gslRangeTimePickers, _gslRangeTimePickerByUid } from '../range-time-picker/register';
 import { _gslRepeaters, _gslRepeaterByUid } from '../repeater/register';
 import { _gslActions, _gslActionByUid } from '../actions/register';
 import { _gslLayouts, _gslLayoutByUid } from '../layouts/register';
@@ -64,16 +74,36 @@ export declare class ScopeChain {
     listByUid(uid: string, config: CfgByUid<typeof _gslListByUid>): GslLeafSelector;
     calendars(config: CfgGsl<typeof _gslCalendars>): GslLeafSelector;
     calendarByUid(uid: string, config: CfgByUid<typeof _gslCalendarByUid>): GslLeafSelector;
+    dateTimeCalendars(config: CfgGsl<typeof _gslDateTimeCalendars>): GslLeafSelector;
+    dateTimeCalendarByUid(uid: string, config: CfgByUid<typeof _gslDateTimeCalendarByUid>): GslLeafSelector;
     dateInputs(config: CfgGsl<typeof _gslDateInputs>): GslLeafSelector;
     dateInputByUid(uid: string, config: CfgByUid<typeof _gslDateInputByUid>): GslLeafSelector;
+    timeInputs(config: CfgGsl<typeof _gslTimeInputs>): GslLeafSelector;
+    timeInputByUid(uid: string, config: CfgByUid<typeof _gslTimeInputByUid>): GslLeafSelector;
+    timePickers(config: CfgGsl<typeof _gslTimePickers>): GslLeafSelector;
+    timePickerByUid(uid: string, config: CfgByUid<typeof _gslTimePickerByUid>): GslLeafSelector;
+    dateTimeInputs(config: CfgGsl<typeof _gslDateTimeInputs>): GslLeafSelector;
+    dateTimeInputByUid(uid: string, config: CfgByUid<typeof _gslDateTimeInputByUid>): GslLeafSelector;
     datePickers(config: CfgGsl<typeof _gslDatePickers>): GslLeafSelector;
     datePickerByUid(uid: string, config: CfgByUid<typeof _gslDatePickerByUid>): GslLeafSelector;
+    dateTimePickers(config: CfgGsl<typeof _gslDateTimePickers>): GslLeafSelector;
+    dateTimePickerByUid(uid: string, config: CfgByUid<typeof _gslDateTimePickerByUid>): GslLeafSelector;
     rangeCalendars(config: CfgGsl<typeof _gslRangeCalendars>): GslLeafSelector;
     rangeCalendarByUid(uid: string, config: CfgByUid<typeof _gslRangeCalendarByUid>): GslLeafSelector;
     rangeDateInputs(config: CfgGsl<typeof _gslRangeDateInputs>): GslLeafSelector;
     rangeDateInputByUid(uid: string, config: CfgByUid<typeof _gslRangeDateInputByUid>): GslLeafSelector;
+    rangeTimeInputs(config: CfgGsl<typeof _gslRangeTimeInputs>): GslLeafSelector;
+    rangeTimeInputByUid(uid: string, config: CfgByUid<typeof _gslRangeTimeInputByUid>): GslLeafSelector;
+    rangeDateTimeInputs(config: CfgGsl<typeof _gslRangeDateTimeInputs>): GslLeafSelector;
+    rangeDateTimeInputByUid(uid: string, config: CfgByUid<typeof _gslRangeDateTimeInputByUid>): GslLeafSelector;
+    rangeDateTimeCalendars(config: CfgGsl<typeof _gslRangeDateTimeCalendars>): GslLeafSelector;
+    rangeDateTimeCalendarByUid(uid: string, config: CfgByUid<typeof _gslRangeDateTimeCalendarByUid>): GslLeafSelector;
+    rangeDateTimePickers(config: CfgGsl<typeof _gslRangeDateTimePickers>): GslLeafSelector;
+    rangeDateTimePickerByUid(uid: string, config: CfgByUid<typeof _gslRangeDateTimePickerByUid>): GslLeafSelector;
     rangeDatePickers(config: CfgGsl<typeof _gslRangeDatePickers>): GslLeafSelector;
     rangeDatePickerByUid(uid: string, config: CfgByUid<typeof _gslRangeDatePickerByUid>): GslLeafSelector;
+    rangeTimePickers(config: CfgGsl<typeof _gslRangeTimePickers>): GslLeafSelector;
+    rangeTimePickerByUid(uid: string, config: CfgByUid<typeof _gslRangeTimePickerByUid>): GslLeafSelector;
     repeaters(config: CfgGsl<typeof _gslRepeaters>): GslLeafSelector;
     repeaterByUid(uid: string, config: CfgByUid<typeof _gslRepeaterByUid>): GslLeafSelector;
     actions(config: CfgGsl<typeof _gslActions>): GslLeafSelector;

package/lib/dx/shortcuts/time-input/guiTimeInput.impl.d.ts

@@ -0,0 +1,6 @@
+import { DxRuntimeParams } from '../../core/dxUtilityTypes';
+import { TimeInputDecorator, GuiTimeInputShortcut } from './timeInput.domain';
+export declare function _guiTimeInput(path: string): GuiTimeInputShortcut;
+export declare function _guiTimeInput(path: string, props: Partial<Omit<TimeInputDecorator, 'type'>>): GuiTimeInputShortcut;
+export declare function _guiTimeInput(path: string, props: Partial<Omit<TimeInputDecorator, 'type'>>, tags: string[]): GuiTimeInputShortcut;
+export declare function _guiTimeInput(path: string, callback: (params: DxRuntimeParams) => Partial<Omit<TimeInputDecorator, 'type'>>, tags?: string[]): GuiTimeInputShortcut;

package/lib/dx/shortcuts/time-input/register.d.ts

@@ -0,0 +1,2 @@
+import { TimeInputDecorator, GslTimeInputConfig } from './timeInput.domain';
+export declare const _gslTimeInputs: (config: GslTimeInputConfig, matcher?: ((decorator: TimeInputDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslTimeInputByUid: (uid: string, config: GslTimeInputConfig) => import('../../core/dx.domain').GslLeafSelector;

package/lib/dx/shortcuts/time-input/timeInput.domain.d.ts

@@ -0,0 +1,17 @@
+import { StringValidator } from '@golemui/gui-validators';
+import { TimeInputProps } from '../../../widget.props';
+import { DxCommonFields, DxInputBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+import { DxValidator } from '../../core/dxValidatorHelper';
+export interface TimeInputDecorator extends DxInputBase, DxCommonFields, Partial<TimeInputProps> {
+    type: 'timeInput';
+    validator?: DxValidator<StringValidator>;
+}
+export interface GslTimeInputConfig extends GslConfigBase<TimeInputDecorator> {
+    suppressAutomaticLabels?: boolean;
+}
+export type TimeInputEntry = {
+    key: string;
+    def: DefOrCallback<TimeInputDecorator>;
+};
+export type GuiTimeInputShortcut = GuiShortcutOf<'TIME_INPUT', TimeInputEntry>;

package/lib/dx/shortcuts/time-picker/guiTimePicker.impl.d.ts

@@ -0,0 +1,7 @@
+import { DxRuntimeParams } from '../../core/dxUtilityTypes';
+import { TimePickerDecorator, GuiTimePickerShortcut } from './timePicker.domain';
+type TimePickerFactoryProps = Omit<TimePickerDecorator, 'type'>;
+export declare function _guiTimePicker(path: string, props: TimePickerFactoryProps): GuiTimePickerShortcut;
+export declare function _guiTimePicker(path: string, props: TimePickerFactoryProps, tags: string[]): GuiTimePickerShortcut;
+export declare function _guiTimePicker(path: string, callback: (params: DxRuntimeParams) => TimePickerFactoryProps, tags?: string[]): GuiTimePickerShortcut;
+export {};

package/lib/dx/shortcuts/time-picker/register.d.ts

@@ -0,0 +1,2 @@
+import { TimePickerDecorator, GslTimePickerConfig } from './timePicker.domain';
+export declare const _gslTimePickers: (config: GslTimePickerConfig, matcher?: ((decorator: TimePickerDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslTimePickerByUid: (uid: string, config: GslTimePickerConfig) => import('../../core/dx.domain').GslLeafSelector;

package/lib/dx/shortcuts/time-picker/timePicker.domain.d.ts

@@ -0,0 +1,18 @@
+import { StringValidator } from '@golemui/gui-validators';
+import { TimePickerProps } from '../../../widget.props';
+import { DxCommonFields, DxInputBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+import { DxValidator } from '../../core/dxValidatorHelper';
+export interface TimePickerDecorator extends DxInputBase, DxCommonFields, Partial<TimePickerProps> {
+    type: 'timePicker';
+    validator?: DxValidator<StringValidator>;
+}
+export interface GslTimePickerConfig extends GslConfigBase<TimePickerDecorator> {
+    suppressAutomaticLabels?: boolean;
+    suppressAutomaticPlaceholders?: boolean;
+}
+export type TimePickerEntry = {
+    key: string;
+    def: DefOrCallback<TimePickerDecorator>;
+};
+export type GuiTimePickerShortcut = GuiShortcutOf<'TIME_PICKER', TimePickerEntry>;

package/lib/golem-form.d.ts

@@ -1,6 +1,6 @@
 import { ActionWidget, DisplayWidget, Form, FormWidget, FunctionWidgetParams, InputWidget, LayoutWidget, ReactiveExpression } from '@golemui/core';
 import { Validator } from '@golemui/gui-validators';
-import { AccordionProps, AlertProps, ButtonProps, CalendarProps, CheckboxProps, CurrencyProps, DatePickerProps, DateRange, DateinputProps, DropdownProps, FlexProps, GridProps, ListProps, MarkdownProps, MarkdownTextProps, NumberinputProps, OptionValue, PasswordProps, RadiogroupProps, RangeCalendarProps, RangeDateInputProps, RangeDatePickerProps, RepeaterProps, SelectProps, TabsProps, TextareaProps, TextinputProps, ToggleProps } from './widget.props';
+import { AccordionProps, AlertProps, ButtonProps, CalendarProps, CheckboxProps, CurrencyProps, DatePickerProps, DateTimeCalendarProps, DateTimePickerProps, DateRange, DateinputProps, DropdownProps, FlexProps, GridProps, ListProps, MarkdownProps, MarkdownTextProps, NumberinputProps, OptionValue, PasswordProps, RadiogroupProps, RangeCalendarProps, RangeDateInputProps, RangeDatePickerProps, RangeDateTimeInputProps, RangeDateTimeCalendarProps, RangeDateTimePickerProps, RangeTimeInputProps, RangeTimePickerProps, DateTimeRange, TimeRange, RepeaterProps, SelectProps, TabsProps, DateTimeInputProps, TextareaProps, TextinputProps, TimeInputProps, TimePickerProps, ToggleProps } from './widget.props';
 type ExtractStates<S> = S extends Record<string, ReactiveExpression> ? keyof S : never;
 /**
  * Make the uid propery optional on all widgets
@@ -92,7 +92,7 @@ declare class GolemFormBuilder<FormType extends Record<string, any>, CustomWidge
  * ```
  */
 export declare function golemForm<FormType extends Record<string, any>, CustomWidget extends FormWidget<any, FormType> = never>(): GolemFormBuilder<FormType, CustomWidget>;
-type GolemWidget<FormType extends Record<string, any>, States extends string, V, CustomWidget extends FormWidget<any, FormType> = never> = GuiAccordion<FormType, States, V, CustomWidget> | GuiAlert<FormType, States> | GuiButton<FormType, States> | GuiCalendar<FormType, States, V> | GuiCheckbox<FormType, States, V> | GuiCurrency<FormType, States, V> | GuiDateinput<FormType, States, V> | GuiDatePicker<FormType, States, V> | GuiDropdown<FormType, States, V> | GuiFunctionWidget<FormType, States, V, CustomWidget> | GuiList<FormType, States, V> | GuiMarkdown<FormType, States, V> | GuiMarkdownText<FormType, States> | GuiNumberinput<FormType, States, V> | GuiPassword<FormType, States, V> | GuiRadiogroup<FormType, States, V> | GuiRangeCalendar<FormType, States, V> | GuiRangeDateInput<FormType, States, V> | GuiRangeDatePicker<FormType, States, V> | GuiRepeater<FormType, States, V, CustomWidget> | GuiSelect<FormType, States, V> | GuiFlex<FormType, States, V, CustomWidget> | GuiGrid<FormType, States, V, CustomWidget> | GuiTabs<FormType, States, V, CustomWidget> | GuiTextarea<FormType, States, V> | GuiTextInput<FormType, States, V> | GuiToggle<FormType, States, V> | CustomWidget;
+type GolemWidget<FormType extends Record<string, any>, States extends string, V, CustomWidget extends FormWidget<any, FormType> = never> = GuiAccordion<FormType, States, V, CustomWidget> | GuiAlert<FormType, States> | GuiButton<FormType, States> | GuiCalendar<FormType, States, V> | GuiCheckbox<FormType, States, V> | GuiDateTimeCalendar<FormType, States, V> | GuiCurrency<FormType, States, V> | GuiDateinput<FormType, States, V> | GuiDatePicker<FormType, States, V> | GuiDateTimeInput<FormType, States, V> | GuiDateTimePicker<FormType, States, V> | GuiDropdown<FormType, States, V> | GuiFunctionWidget<FormType, States, V, CustomWidget> | GuiList<FormType, States, V> | GuiMarkdown<FormType, States, V> | GuiMarkdownText<FormType, States> | GuiNumberinput<FormType, States, V> | GuiPassword<FormType, States, V> | GuiRadiogroup<FormType, States, V> | GuiRangeCalendar<FormType, States, V> | GuiRangeDateInput<FormType, States, V> | GuiRangeDatePicker<FormType, States, V> | GuiRangeDateTimeInput<FormType, States, V> | GuiRangeDateTimeCalendar<FormType, States, V> | GuiRangeDateTimePicker<FormType, States, V> | GuiRangeTimeInput<FormType, States, V> | GuiRangeTimePicker<FormType, States, V> | GuiRepeater<FormType, States, V, CustomWidget> | GuiSelect<FormType, States, V> | GuiFlex<FormType, States, V, CustomWidget> | GuiGrid<FormType, States, V, CustomWidget> | GuiTabs<FormType, States, V, CustomWidget> | GuiTextarea<FormType, States, V> | GuiTextInput<FormType, States, V> | GuiTimeInput<FormType, States, V> | GuiTimePicker<FormType, States, V> | GuiToggle<FormType, States, V> | CustomWidget;
 type GuiAccordion<FormType extends Record<string, any>, States extends string, V, CustomWidget extends FormWidget<any, FormType>> = LayoutWidget<States, FormType, AccordionProps, GolemWidget<FormType, States, V, CustomWidget>[]> & {
     type: 'accordion';
 };
@@ -105,6 +105,9 @@ type GuiButton<FormType extends Record<string, any>, States extends string> = Ac
 type GuiCalendar<FormType extends Record<string, any>, States extends string, V> = InputWidget<string, States, FormType, CalendarProps, V> & {
     type: 'calendar';
 };
+type GuiDateTimeCalendar<FormType extends Record<string, any>, States extends string, V> = InputWidget<string, States, FormType, DateTimeCalendarProps, V> & {
+    type: 'dateTimeCalendar';
+};
 type GuiCheckbox<FormType extends Record<string, any>, States extends string, V> = InputWidget<boolean, States, FormType, CheckboxProps, V> & {
     type: 'checkbox';
 };
@@ -117,6 +120,9 @@ type GuiDateinput<FormType extends Record<string, any>, States extends string, V
 type GuiDatePicker<FormType extends Record<string, any>, States extends string, V> = InputWidget<string, States, FormType, DatePickerProps, V> & {
     type: 'datePicker';
 };
+type GuiDateTimePicker<FormType extends Record<string, any>, States extends string, V> = InputWidget<string, States, FormType, DateTimePickerProps, V> & {
+    type: 'dateTimePicker';
+};
 type GuiDropdown<FormType extends Record<string, any>, States extends string, V> = InputWidget<OptionValue, States, FormType, DropdownProps<unknown>, V> & {
     type: 'dropdown';
 };
@@ -142,9 +148,24 @@ type GuiRangeCalendar<FormType extends Record<string, any>, States extends strin
 type GuiRangeDateInput<FormType extends Record<string, any>, States extends string, V> = InputWidget<DateRange[], States, FormType, RangeDateInputProps, V> & {
     type: 'rangeDateInput';
 };
+type GuiRangeTimeInput<FormType extends Record<string, any>, States extends string, V> = InputWidget<TimeRange[], States, FormType, RangeTimeInputProps, V> & {
+    type: 'rangeTimeInput';
+};
+type GuiRangeDateTimeInput<FormType extends Record<string, any>, States extends string, V> = InputWidget<DateTimeRange[], States, FormType, RangeDateTimeInputProps, V> & {
+    type: 'rangeDateTimeInput';
+};
+type GuiRangeDateTimeCalendar<FormType extends Record<string, any>, States extends string, V> = InputWidget<DateTimeRange[], States, FormType, RangeDateTimeCalendarProps, V> & {
+    type: 'rangeDateTimeCalendar';
+};
+type GuiRangeDateTimePicker<FormType extends Record<string, any>, States extends string, V> = InputWidget<DateTimeRange[], States, FormType, RangeDateTimePickerProps, V> & {
+    type: 'rangeDateTimePicker';
+};
 type GuiRangeDatePicker<FormType extends Record<string, any>, States extends string, V> = InputWidget<DateRange[], States, FormType, RangeDatePickerProps, V> & {
     type: 'rangeDatePicker';
 };
+type GuiRangeTimePicker<FormType extends Record<string, any>, States extends string, V> = InputWidget<TimeRange[], States, FormType, RangeTimePickerProps, V> & {
+    type: 'rangeTimePicker';
+};
 type GuiRepeater<FormType extends Record<string, any>, States extends string, V, CustomWidget extends FormWidget<any, FormType>> = InputWidget<Record<string, unknown>[], States, FormType, RepeaterProps<LayoutWidget<States, FormType, AccordionProps, GolemWidget<FormType, States, V, CustomWidget>[]>>, V> & {
     type: 'repeater';
 };
@@ -169,6 +190,15 @@ type GuiTextInput<FormType extends Record<string, any>, States extends string, V
 type GuiPassword<FormType extends Record<string, any>, States extends string, V> = InputWidget<string, States, FormType, PasswordProps, V> & {
     type: 'password';
 };
+type GuiTimeInput<FormType extends Record<string, any>, States extends string, V> = InputWidget<string, States, FormType, TimeInputProps, V> & {
+    type: 'timeInput';
+};
+type GuiTimePicker<FormType extends Record<string, any>, States extends string, V> = InputWidget<string, States, FormType, TimePickerProps, V> & {
+    type: 'timePicker';
+};
+type GuiDateTimeInput<FormType extends Record<string, any>, States extends string, V> = InputWidget<string, States, FormType, DateTimeInputProps, V> & {
+    type: 'dateTimeInput';
+};
 type GuiToggle<FormType extends Record<string, any>, States extends string, V> = InputWidget<boolean, States, FormType, ToggleProps, V> & {
     type: 'toggle';
 };

package/lib/widget.props.d.ts

@@ -3,6 +3,14 @@ export interface DateRange {
     start: string;
     end?: string;
 }
+/**
+ * A selected date-time range value. Both ends are local ISO date-time strings
+ * (`YYYY-MM-DDTHH:mm:ss`).
+ */
+export interface DateTimeRange {
+    start: string;
+    end: string;
+}
 export type AccordionProps = {
     singleOpen?: boolean;
     defaultOpen?: {
@@ -181,6 +189,31 @@ export type CalendarProps = {
      */
     numberOfMonths?: number;
 };
+/**
+ * Calendar with an embedded time picker. The value is a local ISO date-time
+ * (YYYY-MM-DDTHH:mm:ss), emitted only when both the day and the time are
+ * selected; picking a different day clears the time and emits null. With
+ * numberOfMonths > 1 the time row and grid render on the first panel only.
+ */
+export type DateTimeCalendarProps = CalendarProps & {
+    /** '12' or '24'. Defaults to the locale's hour cycle. */
+    hourFormat?: '12' | '24';
+    /** Minutes between selectable slots. Defaults to 30. */
+    minuteStep?: number;
+    /** First selectable time (ISO time, inclusive). Defaults to '00:00:00'. */
+    minTime?: string;
+    /** Last selectable time (ISO time, inclusive). Defaults to '23:59:59'. */
+    maxTime?: string;
+    /** Times inside these ranges render disabled; entries can scope per day. */
+    disabledTimeRanges?: DisabledTimeRange[];
+    /** Allows typing a time in the input; when false (default) times come only from the grid. */
+    allowCustomTime?: boolean;
+    minTimeMessage?: Localizable;
+    maxTimeMessage?: Localizable;
+    disabledTimeRangeMessage?: Localizable;
+    /** Shown in the time grid when the bounds yield no slots. Defaults to 'No available times'. */
+    noAvailableTimesMessage?: Localizable;
+};
 export type RangeCalendarProps = {
     /**
      * An optional descriptive text providing guidance or information about the associated widget or functionality.
@@ -257,6 +290,13 @@ export type RangeCalendarProps = {
      * @type {DateRange[] | undefined}
      */
     disabledRanges?: DateRange[];
+    /**
+     * Error surfaced when a selected range spans one or more disabled days. The
+     * whole range is rejected (no pill added), rather than split around the
+     * disabled days — consistent with the time pickers. Defaults to
+     * "Invalid date: date is within a disabled range."
+     */
+    disabledDateRangeMessage?: Localizable;
     /**
      * Specifies the number of months to be displayed in the calendar.
      * Default is 1.
@@ -270,6 +310,67 @@ export type RangeCalendarProps = {
 export type DateinputProps = {
     hint?: string;
     icon?: string;
+    invalidDateMessage?: Localizable;
+    /** Earliest allowed date (ISO date, inclusive). */
+    minDate?: string;
+    /** Latest allowed date (ISO date, inclusive). */
+    maxDate?: string;
+    minDateMessage?: Localizable;
+    maxDateMessage?: Localizable;
+};
+export type DateTimeInputProps = {
+    hint?: string;
+    icon?: string;
+    hourFormat?: '12' | '24';
+    minuteStep?: number;
+    invalidDateMessage?: Localizable;
+    /** Earliest allowed date (ISO date, inclusive). */
+    minDate?: string;
+    /** Latest allowed date (ISO date, inclusive). */
+    maxDate?: string;
+    /** First allowed time (ISO time, inclusive). */
+    minTime?: string;
+    /** Last allowed time (ISO time, inclusive). */
+    maxTime?: string;
+    minDateMessage?: Localizable;
+    maxDateMessage?: Localizable;
+    minTimeMessage?: Localizable;
+    maxTimeMessage?: Localizable;
+};
+export type TimeInputProps = {
+    hint?: string;
+    icon?: string;
+    hourFormat?: '12' | '24';
+    minuteStep?: number;
+    /** First allowed time (ISO time, inclusive). */
+    minTime?: string;
+    /** Last allowed time (ISO time, inclusive). */
+    maxTime?: string;
+    minTimeMessage?: Localizable;
+    maxTimeMessage?: Localizable;
+};
+/**
+ * A time range value (also the base of {@link DisabledTimeRange}).
+ */
+export type TimeRange = {
+    start: string;
+    end: string;
+};
+export type DisabledTimeRange = TimeRange & {
+    /** ISO date (YYYY-MM-DD): the range only applies on that date. */
+    date?: string;
+    /** Weekday numbers as returned by Date.prototype.getDay(): 0=Sunday … 6=Saturday. */
+    weekdays?: number[];
+};
+export type TimePickerProps = TimeInputProps & {
+    /** Times inside these ranges (both ends inclusive) render disabled. */
+    disabledRanges?: TimeRange[];
+    /** Allows typing a time in the input; when false (default) values come only from the list. */
+    allowCustomTime?: boolean;
+    height?: number;
+    itemHeight?: number;
+    disabledRangeMessage?: Localizable;
+    noAvailableTimesMessage?: Localizable;
 };
 export type RangeDateInputProps = {
     hint?: string;
@@ -278,40 +379,107 @@ export type RangeDateInputProps = {
     removePillAriaLabel?: string;
     startDateAriaLabel?: string;
     endDateAriaLabel?: string;
+    invalidDateMessage?: Localizable;
+};
+export type DateBoundsMessageProps = {
+    minDateMessage?: Localizable;
+    maxDateMessage?: Localizable;
+    disabledDateRangeMessage?: Localizable;
+};
+export type DatePickerProps = CalendarProps & DateinputProps & DateBoundsMessageProps;
+export type DateTimePickerProps = DateTimeCalendarProps & DateTimeInputProps & DateBoundsMessageProps;
+export type RangeDatePickerProps = RangeCalendarProps & RangeDateInputProps & DateBoundsMessageProps;
+export type RangeDateTimeCalendarProps = Omit<RangeCalendarProps, 'minDate' | 'maxDate' | 'disabledRanges' | 'disabledDateRangeMessage'> & {
+    hourFormat?: '12' | '24';
+    minuteStep?: number;
+    /** Allows typing a time in each picker; when false (default) times come only from the grid. */
+    allowCustomTime?: boolean;
+    /** Visible heading on the start time picker. Defaults to "Start time". */
+    startTimeLabel?: Localizable;
+    /** Visible heading on the end time picker. Defaults to "End time". */
+    endTimeLabel?: Localizable;
+    /** Earliest allowed instant (ISO date-time, inclusive). */
+    minDateTime?: string;
+    /** Latest allowed instant (ISO date-time, inclusive). */
+    maxDateTime?: string;
+    minDateTimeMessage?: Localizable;
+    maxDateTimeMessage?: Localizable;
+    /** Disabled instant spans. Blocking a whole day is a span of 00:00:00–23:59:59. */
+    disabledRanges?: DateTimeRange[];
+    /** Error surfaced when a selected range steps over, or overlaps, a disabled span. */
+    disabledRangeMessage?: Localizable;
+    /** Shown in a time grid when the bounds yield no slots. Defaults to 'No available times'. */
+    noAvailableTimesMessage?: Localizable;
+    /**
+     * ARIA label template for the per-day count badge; a `{count}` token is
+     * substituted with the number of ranges on that day. Defaults to '{count} ranges'.
+     */
+    dayCountAriaLabel?: Localizable;
+    /**
+     * ARIA label template for the grey per-day disabled-spans badge shown on
+     * partially-blocked days; a `{count}` token is substituted with the number of
+     * disabled spans on that day. Defaults to '{count} disabled ranges'.
+     */
+    disabledDayCountAriaLabel?: Localizable;
 };
-export type DatePickerProps = {
+export type RangeTimeInputProps = {
     hint?: string;
     icon?: string;
-    prevMonthIcon?: string;
-    nextMonthIcon?: string;
-    prevMonthAriaLabel?: string;
-    nextMonthAriaLabel?: string;
-    dayFormat?: 'numeric' | '2-digit';
-    weekdayFormat?: 'short' | 'long' | 'narrow';
-    monthFormat?: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow';
-    minDate?: string;
-    maxDate?: string;
-    disabledRanges?: DateRange[];
-    numberOfMonths?: number;
+    separator?: string;
+    removePillAriaLabel?: string;
+    startTimeAriaLabel?: string;
+    endTimeAriaLabel?: string;
+    hourFormat?: '12' | '24';
+    minuteStep?: number;
+    /** First allowed time (ISO time, inclusive). */
+    minTime?: string;
+    /** Last allowed time (ISO time, inclusive). */
+    maxTime?: string;
+    minTimeMessage?: Localizable;
+    maxTimeMessage?: Localizable;
+    /** Shown when the entered "time out" is not strictly after "time in". */
+    rangeOrderMessage?: Localizable;
 };
-export type RangeDatePickerProps = {
+export type RangeDateTimeInputProps = {
     hint?: string;
     icon?: string;
     separator?: string;
     removePillAriaLabel?: string;
-    startDateAriaLabel?: string;
-    endDateAriaLabel?: string;
-    prevMonthIcon?: string;
-    nextMonthIcon?: string;
-    prevMonthAriaLabel?: string;
-    nextMonthAriaLabel?: string;
-    dayFormat?: 'numeric' | '2-digit';
-    weekdayFormat?: 'short' | 'long' | 'narrow';
-    monthFormat?: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow';
-    minDate?: string;
-    maxDate?: string;
-    disabledRanges?: DateRange[];
-    numberOfMonths?: number;
+    startDateTimeAriaLabel?: string;
+    endDateTimeAriaLabel?: string;
+    hourFormat?: '12' | '24';
+    minuteStep?: number;
+    invalidDateMessage?: Localizable;
+    /**
+     * Earliest allowed date-time (ISO date-time, inclusive). Each endpoint of the
+     * value is an instant, so the bound is an instant too: a date-only bound
+     * cannot say whether its last day is allowed until 00:00 or 23:59.
+     */
+    minDateTime?: string;
+    /** Latest allowed date-time (ISO date-time, inclusive). */
+    maxDateTime?: string;
+    minDateTimeMessage?: Localizable;
+    maxDateTimeMessage?: Localizable;
+};
+/**
+ * The date-time range picker is the calendar (instant-space bounds, disabled
+ * spans, two time pickers, per-day count badge) with the typed range input as
+ * its trigger.
+ */
+export type RangeDateTimePickerProps = RangeDateTimeCalendarProps & RangeDateTimeInputProps;
+export type RangeTimePickerProps = RangeTimeInputProps & {
+    /** Times inside these ranges (both ends inclusive) render disabled. */
+    disabledRanges?: TimeRange[];
+    /** Allows typing a time in the input; when false (default) values come only from the lists. */
+    allowCustomTime?: boolean;
+    height?: number;
+    itemHeight?: number;
+    /** Visible heading above the "time in" list in the popover. Defaults to "Start time". */
+    startTimeLabel?: Localizable;
+    /** Visible heading above the "time out" list in the popover. Defaults to "End time". */
+    endTimeLabel?: Localizable;
+    disabledRangeMessage?: Localizable;
+    noAvailableTimesMessage?: Localizable;
 };
 export type NumberinputProps = {
     placeholder?: string;
@@ -376,10 +544,13 @@ export type SelectProps = {
     placeholder?: string;
     labelField?: string;
     valueField?: string;
+    invalidOptionMessage?: Localizable;
 };
 export type ListItem<T> = {
     template: T;
     value: OptionValue;
+    /** Disabled items render greyed out, are skipped by keyboard navigation and cannot be selected */
+    disabled?: boolean;
 };
 type ItemKeys<T> = T extends Record<string, any> ? keyof T : string;
 export type DropdownProps<T> = {

package/lib/widgets.d.ts

@@ -1,8 +1,8 @@
-export declare const inputWidgets: readonly ["calendar", "checkbox", "currency", "dateInput", "datePicker", "dropdown", "list", "markdown", "number", "password", "radiogroup", "rangeCalendar", "rangeDateInput", "rangeDatePicker", "repeater", "select", "tags", "textarea", "textinput", "toggle"];
+export declare const inputWidgets: readonly ["calendar", "dateTimeCalendar", "checkbox", "currency", "dateInput", "datePicker", "dateTimeInput", "dateTimePicker", "dropdown", "list", "markdown", "number", "password", "radiogroup", "rangeCalendar", "rangeDateInput", "rangeDatePicker", "rangeDateTimeInput", "rangeDateTimeCalendar", "rangeDateTimePicker", "rangeTimeInput", "rangeTimePicker", "repeater", "select", "tags", "textarea", "textinput", "timeInput", "timePicker", "toggle"];
 export declare const layoutWidgets: readonly ["accordion", "flex", "grid", "tabs"];
 export declare const displayWidgets: readonly ["alert", "markdownText", "renderer"];
 export declare const actionWidgets: readonly ["button"];
-export declare const golemWidgets: ("number" | "button" | "repeater" | "flex" | "tags" | "password" | "checkbox" | "dateInput" | "currency" | "rangeCalendar" | "select" | "radiogroup" | "tabs" | "list" | "datePicker" | "dropdown" | "markdown" | "rangeDateInput" | "rangeDatePicker" | "textarea" | "calendar" | "grid" | "toggle" | "textinput" | "renderer" | "alert" | "markdownText" | "accordion")[];
+export declare const golemWidgets: ("number" | "button" | "repeater" | "flex" | "tags" | "password" | "checkbox" | "dateInput" | "currency" | "rangeCalendar" | "select" | "radiogroup" | "tabs" | "list" | "datePicker" | "dropdown" | "markdown" | "rangeDateInput" | "rangeDatePicker" | "textarea" | "calendar" | "dateTimeCalendar" | "dateTimePicker" | "rangeDateTimeInput" | "rangeDateTimeCalendar" | "rangeDateTimePicker" | "rangeTimeInput" | "rangeTimePicker" | "timeInput" | "timePicker" | "dateTimeInput" | "grid" | "toggle" | "textinput" | "renderer" | "alert" | "markdownText" | "accordion")[];
 export type GolemInputWidget = (typeof inputWidgets)[number];
 export type GolemLayoutWidget = (typeof layoutWidgets)[number];
 export type GolemDisplayWidget = (typeof displayWidgets)[number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@golemui/gui-shared",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "license": "MIT",
   "type": "module",
   "main": "./index.umd.cjs",
@@ -31,8 +31,8 @@
     "*.md"
   ],
   "dependencies": {
-    "@golemui/core": "1.0.2",
-    "@golemui/gui-validators": "1.0.2"
+    "@golemui/core": "1.1.0",
+    "@golemui/gui-validators": "1.1.0"
   },
   "repository": {
     "type": "git",