@cwellt_software/cwellt-reactjs-lib 1.4.1 → 1.4.3

package/dist/index.d.ts

@@ -936,6 +936,7 @@ interface CwTableServerSideProps<T = any> {
     totalItems: number;
     pagination?: boolean;
     pageSizeOptions?: number[];
+    pageLabel?: string;
     expandedRowRender?: (record: T) => React__default.ReactNode;
     onExpand?: (record: T) => void;
     classNameContainer?: string;
@@ -1011,7 +1012,7 @@ interface CwTableServerSideProps<T = any> {
  *
  * @returns React component
  */
-declare function CwTableServerSide<T = any>({ columns, data, totalItems, pagination, pageSizeOptions, expandedRowRender, onExpand, className, classNameRow, style, classNameContainer, id, testId, textNoData, rowKey, loading, scrollHeight, stickyHeader, rowSelection, onChange, serverState, }: Readonly<CwTableServerSideProps<T>>): react_jsx_runtime.JSX.Element;
+declare function CwTableServerSide<T = any>({ columns, data, totalItems, pagination, pageSizeOptions, pageLabel, expandedRowRender, onExpand, className, classNameRow, style, classNameContainer, id, testId, textNoData, rowKey, loading, scrollHeight, stickyHeader, rowSelection, onChange, serverState, }: Readonly<CwTableServerSideProps<T>>): react_jsx_runtime.JSX.Element;
 
 interface Tab {
     key: string;
@@ -2025,6 +2026,57 @@ interface CwSelectProps extends DetailedHTMLProps<SelectHTMLAttributes<HTMLSelec
  */
 declare function CwSelect(props: CwSelectProps): react_jsx_runtime.JSX.Element;
 
+/** A single selectable option in a {@link CwDropdown}. */
+interface CwDropdownOption {
+    /** Unique option identifier passed to `onChange`. */
+    value: string | number;
+    /** Display text shown in the trigger and option list. */
+    label: string;
+    /** Optional background color (any valid CSS value). Shown as a small dot next to the label. */
+    color?: string;
+    /** When `true` the option is rendered but cannot be selected. */
+    disabled?: boolean;
+}
+/** Props for {@link CwDropdown}. */
+interface CwDropdownProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Array of options to display */
+    options: CwDropdownOption[];
+    /** Current selected value */
+    value?: string | number;
+    /** Callback when value changes */
+    onChange?: (value: string | number | undefined) => void;
+    /** Props for label component */
+    labelProps?: CwLabelProps;
+    /** Props for alignment */
+    alignProps?: CwAlignProps;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Show search input (optional) */
+    allowSearch?: boolean;
+    /** Is disabled */
+    disabled?: boolean;
+    /** Is required */
+    required?: boolean;
+    /** Feedback messages */
+    feedback?: CwInputFeedback | CwInputFeedback[];
+}
+/**
+ * Custom dropdown component with colour-coded options, optional search filter, and full
+ * keyboard navigation (↑ ↓ Enter Esc Tab).
+ *
+ * Use `CwDropdown` instead of the native `<select>` when options need colour indicators or
+ * when inline search filtering is required.
+ *
+ * @example
+ * <CwDropdown
+ *   options={[{ value: 'a', label: 'Option A', color: '#1976D2' }]}
+ *   value={selected}
+ *   onChange={setSelected}
+ *   labelProps={{ text: 'My Label' }}
+ * />
+ */
+declare function CwDropdown({ options, value, onChange, labelProps, alignProps, placeholder, allowSearch, disabled, required, feedback, className, style, ...otherProps }: CwDropdownProps): react_jsx_runtime.JSX.Element;
+
 interface CwOptionProps extends Omit<HTMLProps<PropsWithChildren<HTMLOptionElement>>, "className"> {
     text?: string;
     /** Background color for the option (hex or CSS color). Renders as a colored bar on the left of the option text. */
@@ -2370,19 +2422,41 @@ type TreeViewProps<T> = {
 };
 declare function CwTreeView<T>({ data, onSelect, allowParentSelection, selectedId: initialSelectedId }: TreeViewProps<T>): react_jsx_runtime.JSX.Element;
 
+/** Props for {@link CwSearchInput}. */
 interface CwSearchInputProps extends HTMLProps<HTMLDivElement> {
+    /** List of items to search through. Each item must be a `CwSelectList` instance. */
     selectList: Array<CwSelectList>;
+    /** Props forwarded to the internal `CwLabel`. */
     labelProps?: CwLabelProps;
+    /** Props forwarded to the optional leading icon. */
     iconProps?: CwIconProps;
+    /** Props forwarded to the `CwAlign` layout wrapper. */
     alignProps?: CwAlignProps;
+    /** Called with the `id` of the selected `CwSelectList` item. */
     handleChange?: (value: any) => void;
+    /** Input placeholder text. Defaults to `"Search…"`. */
     placeholder?: string;
     className?: string;
     style?: React__default.CSSProperties;
+    /** Disables the input when `true`. */
     disabled?: boolean;
+    /** Renders the input in error state when `true`. */
     error?: boolean;
+    /** Custom renderer for each suggestion item. Receives the matching `CwSelectList` entry. */
     renderOption?: (option: CwSelectList) => React__default.ReactNode;
 }
+/**
+ * Text input with a live-filtered suggestion dropdown backed by a local `CwSelectList` array.
+ * Use `CwFindAirport` or `CwFindCrewmember` for API-backed search inputs.
+ *
+ * @example
+ * <CwSearchInput
+ *   selectList={myItems}
+ *   handleChange={(id) => console.log('selected', id)}
+ *   labelProps={{ text: 'Employee' }}
+ *   placeholder="Search by name…"
+ * />
+ */
 declare function CwSearchInput(optionsProps: React__default.PropsWithChildren<CwSearchInputProps>): react_jsx_runtime.JSX.Element;
 
 type Placement = 'bottom' | 'top' | 'left' | 'right';
@@ -2501,7 +2575,7 @@ declare function CwBtnEdit({ cw_btnOnclick, cw_btn_disabled, onClick, disabled,
  */
 declare function CwBtnDelete({ cw_btnOnclick, cw_btn_disabled, onClick, disabled, ...rest }: cw_btnProps): react_jsx_runtime.JSX.Element;
 
-type DateMatcher$2 = Matcher;
+type DateMatcher$3 = Matcher;
 interface CwDatePickerProps {
     /** Current selected date */
     value?: Date;
@@ -2514,7 +2588,7 @@ interface CwDatePickerProps {
     /** Array of specific dates to disable */
     disabledDates?: Date[];
     /** Function to determine if a date should be disabled */
-    disabledMatcher?: DateMatcher$2;
+    disabledMatcher?: DateMatcher$3;
     /** Default month to display when calendar opens */
     defaultMonth?: Date;
     /** Props for label component */
@@ -2557,7 +2631,7 @@ interface DateRangePreset {
     };
 }
 
-type DateMatcher$1 = Matcher;
+type DateMatcher$2 = Matcher;
 interface DateRangeValue {
     from: Date | undefined;
     to: Date | undefined;
@@ -2574,7 +2648,7 @@ interface CwDateRangePickerProps {
     /** Array of specific dates to disable */
     disabledDates?: Date[];
     /** Function to determine if a date should be disabled */
-    disabledMatcher?: DateMatcher$1;
+    disabledMatcher?: DateMatcher$2;
     /** Maximum number of days allowed in range (optional) */
     maxRangeDays?: number;
     /** Default month to display when calendar opens */
@@ -2630,7 +2704,7 @@ interface CwDateTimePickerProps {
     /** Array of specific dates to disable */
     disabledDates?: Date[];
     /** Function to determine if a date should be disabled */
-    disabledMatcher?: DateMatcher$2;
+    disabledMatcher?: DateMatcher$3;
     /** Interval in minutes for time selection (default: 15) */
     timeInterval?: 5 | 10 | 15 | 30 | 60;
     /** Minimum selectable time in format "HH:mm" */
@@ -2668,7 +2742,7 @@ interface CwDateTimePickerProps {
 }
 declare function CwDateTimePicker({ value, onChange, minDateTime, maxDateTime, disabledDates, disabledMatcher, timeInterval, minTime, maxTime, labelProps, alignProps, datePlaceholder, timePlaceholder, disabled, required, className, showClear, popupPosition, numberOfMonths, showNowButton, nowLabel, locale, timezoneOffset, }: Readonly<CwDateTimePickerProps>): react_jsx_runtime.JSX.Element;
 
-type DateMatcher = Matcher;
+type DateMatcher$1 = Matcher;
 interface CwDateTimePickerCompactProps {
     /** Current selected datetime */
     value?: Date;
@@ -2681,7 +2755,7 @@ interface CwDateTimePickerCompactProps {
     /** Array of specific dates to disable */
     disabledDates?: Date[];
     /** Function to determine if a date should be disabled */
-    disabledMatcher?: DateMatcher;
+    disabledMatcher?: DateMatcher$1;
     /** Interval in minutes for time selection (default: 15) */
     timeInterval?: 5 | 10 | 15 | 30 | 60;
     /** Minimum selectable time in format "HH:mm" */
@@ -2752,6 +2826,49 @@ interface CwTimePickerProps {
 }
 declare function CwTimePicker({ value, onChange, interval, minTime, maxTime, labelProps, alignProps, placeholder, disabled, required, className, showClear, popupPosition, useNative, }: CwTimePickerProps): react_jsx_runtime.JSX.Element;
 
+type DateMatcher = Matcher;
+interface CwDatePickerTemporalProps {
+    /** Current selected date */
+    value?: Temporal.PlainDate;
+    /** Callback when date changes */
+    onChange: (date: Temporal.PlainDate | undefined) => void;
+    /** Minimum selectable date */
+    minDate?: Temporal.PlainDate;
+    /** Maximum selectable date */
+    maxDate?: Temporal.PlainDate;
+    /** Array of specific dates to disable */
+    disabledDates?: Temporal.PlainDate[];
+    /** Function to determine if a date should be disabled */
+    disabledMatcher?: DateMatcher;
+    /** Default month to display when calendar opens */
+    defaultMonth?: Temporal.PlainYearMonth;
+    /** Props for label component */
+    labelProps?: CwLabelProps;
+    /** Props for alignment */
+    alignProps?: CwAlignProps;
+    /** Placeholder text for input */
+    placeholder?: string;
+    /** Display format for the input (default: dd/MM/yyyy) */
+    displayFormat?: string;
+    /** Is the input disabled */
+    disabled?: boolean;
+    /** Is the input required */
+    required?: boolean;
+    /** Additional CSS class for container */
+    className?: string;
+    /** Show clear button */
+    showClear?: boolean;
+    /** Pop Up Position */
+    popupPosition?: "left-bottom" | "left-top" | "right-top" | "right-bottom";
+    /** Number of months to display (default: 1) */
+    numberOfMonths?: number;
+    showTodayButton?: boolean;
+    todayLabel?: string;
+    /** Feedback messages shown below the input */
+    feedback?: CwInputFeedback | CwInputFeedback[];
+}
+declare function CwDatePickerTemporal({ value, onChange, minDate, maxDate, disabledDates, disabledMatcher, defaultMonth, labelProps, alignProps, placeholder, displayFormat, disabled, required, className, showClear, popupPosition, numberOfMonths, showTodayButton, todayLabel, feedback, }: Readonly<CwDatePickerTemporalProps>): react_jsx_runtime.JSX.Element;
+
 declare class cblEvent {
     id: string;
     start: Date;
@@ -3137,36 +3254,97 @@ declare class OnClearPinned implements UiEvent {
 }
 
 type DisplayMode = "default" | "icao-only" | "iata-only" | "full-text";
+/** Props for {@link CwFindAirport}. */
 interface CwFindAirportProps {
+    /** Called with the selected airport's `AptKey` when a result is chosen. */
     handleChange: (value: number) => void;
+    /** API search mode passed to the WinOps backend. Defaults to `"OnlyDatabase"`. */
     searchType?: string;
+    /** Input placeholder text. Defaults to `"Search airport…"`. */
     placeHolder?: string;
+    /** Marks the field as required (visual indicator only). */
     required?: boolean;
+    /** Base URL of the WinOps backend, e.g. `"https://localhost:44300"`. */
     cblConfig: string;
     className?: string;
+    /** Pre-select an airport by its `AptKey`. Triggers an initial fetch to resolve the display text. */
     value?: number;
     disabled?: boolean;
-    displayMode?: DisplayMode;
+    /**
+     * Controls what part of the airport name is shown in the input after selection.
+     * - `"default"` — short `ICAO(IATA)` code format
+     * - `"icao-only"` — only the 4-letter ICAO code
+     * - `"iata-only"` — only the 3-letter IATA code
+     * - `"full-text"` — full `DisplayAirportText` from the API
+     */
+    displayMode?: DisplayMode; /** Fixed CSS width for the input wrapper, e.g. `"400px"`. */
     width?: string;
+    /** Text shown in the input on first render before any API data is loaded. */
     initialDisplayText?: string;
+    /** Props forwarded to the internal `CwLabel`. */
     labelProps?: CwLabelProps;
+    /** Props forwarded to the `CwAlign` layout wrapper. */
     alignProps?: CwAlignProps;
 }
+/**
+ * API-backed airport search input for WinOps.
+ *
+ * Fetches matching airports from the WinOps backend as the user types (debounced).
+ * Renders results in a shared `cw-choice-dropdown` styled panel with keyboard navigation.
+ * Supports pre-selecting an airport by `value` (AptKey) and customising the displayed text
+ * format via `displayMode`.
+ *
+ * Requires a running WinOps backend — set `cblConfig` to its base URL.
+ *
+ * @example
+ * <CwFindAirport
+ *   cblConfig="https://localhost:44300"
+ *   handleChange={(key) => setAirportKey(key)}
+ *   labelProps={{ text: 'Departure Airport' }}
+ *   displayMode="iata-only"
+ * />
+ */
 declare const CwFindAirport: React__default.FC<CwFindAirportProps>;
 
+/** Props for {@link CwFindCrewmember}. */
 interface CwFindCrewmemberProps {
+    /** Called with the selected crewmember's numeric ID when a result is chosen. */
     handleChange: (value: number) => void;
+    /** Input placeholder text. Defaults to `"Search crew…"`. */
     placeHolder?: string;
+    /** Marks the field as required (visual indicator only). */
     required?: boolean;
+    /** Base URL of the WinOps backend, e.g. `"https://localhost:44300"`. */
     cblConfig: string;
     className?: string;
+    /** Pre-select a crewmember by their numeric ID. Triggers an initial fetch to resolve the display text. */
     value?: number;
     disabled?: boolean;
+    /** Fixed CSS width for the input wrapper, e.g. `"400px"`. */
     width?: string;
+    /** Text shown in the input on first render before any API data is loaded. */
     initialDisplayText?: string;
+    /** Props forwarded to the internal `CwLabel`. */
     labelProps?: CwLabelProps;
+    /** Props forwarded to the `CwAlign` layout wrapper. */
     alignProps?: CwAlignProps;
 }
+/**
+ * API-backed crewmember search input for WinOps.
+ *
+ * Fetches matching crewmembers from the WinOps backend as the user types (debounced).
+ * Renders results in a shared `cw-choice-dropdown` styled panel with keyboard navigation.
+ * Supports pre-selecting a crewmember by numeric `value` (ID).
+ *
+ * Requires a running WinOps backend — set `cblConfig` to its base URL.
+ *
+ * @example
+ * <CwFindCrewmember
+ *   cblConfig="https://localhost:44300"
+ *   handleChange={(id) => setCrewId(id)}
+ *   labelProps={{ text: 'Crew Member' }}
+ * />
+ */
 declare const CwFindCrewmember: React__default.FC<CwFindCrewmemberProps>;
 
 declare class OnClickEvent implements UiEvent {
@@ -3246,5 +3424,5 @@ declare class OnClickContextMenu implements UiEvent {
     constructor(id: string, clickedMenu: string);
 }
 
-export { CblDragAndDrop$1 as CblDragAndDrop, CwAccordionContainer, CwAlign, CwAnchoredMenu, CwBtnDelete, CwBtnEdit, CwBtnSave, CwButton, CwCard, CwCardList, CwCheck, CwCheckbox, CwCheckboxGroup, CwChip, CwColorPicker, CwConfirmationPopup, CwContextMenu, CwDatePicker, CwDateRangePicker, CwDateTimePicker, CwDateTimePickerCompact, CwDialog, CwDialogManager, CwDigit, CwDisplayMessage, CwDropdownFilter, CwExpandable, CwFileUpload, CwFileUploadMultiple, CwFindAirport, CwFindCrewmember, CwGenericTooltip, CwHeadingMain, CwHeadingSecond, CwIcon, CwImageArea, CwImageGallery, CwImageZoom, CwInput, CwInputColor, CwInputDate, CwInputDatePicker, CwInputDateText, CwInputDatetime, CwInputImage, CwInputNumber, CwInputPhone, CwInputText, CwKeyValueList, CwLabel, CwLoading, CwLoadingSmall, CwMasterDetail, CwMessage, CwMessageManager, CwMessageType, CwModal, CwModalHover, CwModalReportFunctional, CwMultiFilter, CwMultiFilterTag, CwNote, CwOption, CwPopoverButton, CwReportModal, CwScheduler, CwSearchInput, CwSelect, CwSelectList, CwSelectListItems, CwSortableList, CwSortableTable, CwSuperScheduler, CwTable, CwTableGrouped, CwTableServerSide, CwTabs, CwTagSelector, CwTextArea, CwTime, CwTimePicker, CwToggle, CwTooltipManager, CwTooltipNew, CwTreeView, CwWeekdaySelector, DefaultRowHeader, OnClearPinned, OnClickContextMenu, OnClickEvent, OnClickRowEvent, OnClickRowHeader, OnClickUtc, OnDoubleClickEvent, OnDoubleClickRowEvent, OnDragEvent, OnDropCtrlEvent, OnDropEvent, OnEndClickHeaderEvent, OnLeftDragStart, OnMultiClickEvent, OnPinRow, OnRangeClickEvent, OnRightClickEvent, OnRightClickRow, OnRightDragStart, OnStartClickHeaderEvent, OnUnpinRow, PinRowHeader, Resource, Scheduler, SchedulerEvent, SuperScheduler, UiEvent, Weekdays, cblEvent, eventIsVisible, filterVisibleEvents, getDefaultDivisions, getEventSizes, itemsToMultiFilterTags, useCwMessage, useSortableList, useSortableTable };
-export type { BackgroundEventDm, CardChip, ChipColorScheme, ChipVariant, Column$1 as Column, ConfirmationPopupProps, CwAlignProps, CwCardListProps, CwCardProps, CwChipProps, CwDialogProps, CwExpandableProps, CwImageAreaMethods, CwImageAreaProps, CwInputDatePickerProps, CwInputDateProps, CwInputDateTextProps, CwInputDatetimeProps, CwInputImageProps, CwInputNumberProps, CwInputPhoneProps, CwInputTextProps, CwInputTimeProps, CwKeyValueListProps, CwLabelProps, CwMasterDetailItem, CwMasterDetailProps, CwMessageProps, CwModalHoverProps, CwMultiFilterProps, CwMultiFilterTagProps, CwNoteProps, CwPopoverButtonProps, CwReportModalFunctionalProps, CwSelectListProps, CwSortableListProps, CwSortableTableProps, CwTableGroupedData, CwTableGroupedData_Group, CwTableGroupedData_Row, CwTableGroupedProps, CwTagSelectorOption, CwTagSelectorProps, CwTextAreaProps, CwTreeNode, DataItem, DateRangeValue, ICwMultiFilterTag, ImageItem, IndicatorRowDm, MenuOption, OnEvent, PinRowHeaderProps, RowHeaderDm, RowHeaderProps, SchedulerEventDm, SchedulerEventState, SchedulerRowProps, SchedulerState, ServerSideTableState, SortableColumn, SortableTableDragState, SuperSchedulerProps, Tab, UseSortableTableReturn, Weekday, ZoomImageItem, cblEventCompProps, resourceCompProps2 };
+export { CblDragAndDrop$1 as CblDragAndDrop, CwAccordionContainer, CwAlign, CwAnchoredMenu, CwBtnDelete, CwBtnEdit, CwBtnSave, CwButton, CwCard, CwCardList, CwCheck, CwCheckbox, CwCheckboxGroup, CwChip, CwColorPicker, CwConfirmationPopup, CwContextMenu, CwDatePicker, CwDatePickerTemporal, CwDateRangePicker, CwDateTimePicker, CwDateTimePickerCompact, CwDialog, CwDialogManager, CwDigit, CwDisplayMessage, CwDropdown, CwDropdownFilter, CwExpandable, CwFileUpload, CwFileUploadMultiple, CwFindAirport, CwFindCrewmember, CwGenericTooltip, CwHeadingMain, CwHeadingSecond, CwIcon, CwImageArea, CwImageGallery, CwImageZoom, CwInput, CwInputColor, CwInputDate, CwInputDatePicker, CwInputDateText, CwInputDatetime, CwInputImage, CwInputNumber, CwInputPhone, CwInputText, CwKeyValueList, CwLabel, CwLoading, CwLoadingSmall, CwMasterDetail, CwMessage, CwMessageManager, CwMessageType, CwModal, CwModalHover, CwModalReportFunctional, CwMultiFilter, CwMultiFilterTag, CwNote, CwOption, CwPopoverButton, CwReportModal, CwScheduler, CwSearchInput, CwSelect, CwSelectList, CwSelectListItems, CwSortableList, CwSortableTable, CwSuperScheduler, CwTable, CwTableGrouped, CwTableServerSide, CwTabs, CwTagSelector, CwTextArea, CwTime, CwTimePicker, CwToggle, CwTooltipManager, CwTooltipNew, CwTreeView, CwWeekdaySelector, DefaultRowHeader, OnClearPinned, OnClickContextMenu, OnClickEvent, OnClickRowEvent, OnClickRowHeader, OnClickUtc, OnDoubleClickEvent, OnDoubleClickRowEvent, OnDragEvent, OnDropCtrlEvent, OnDropEvent, OnEndClickHeaderEvent, OnLeftDragStart, OnMultiClickEvent, OnPinRow, OnRangeClickEvent, OnRightClickEvent, OnRightClickRow, OnRightDragStart, OnStartClickHeaderEvent, OnUnpinRow, PinRowHeader, Resource, Scheduler, SchedulerEvent, SuperScheduler, UiEvent, Weekdays, cblEvent, eventIsVisible, filterVisibleEvents, getDefaultDivisions, getEventSizes, itemsToMultiFilterTags, useCwMessage, useSortableList, useSortableTable };
+export type { BackgroundEventDm, CardChip, ChipColorScheme, ChipVariant, Column$1 as Column, ConfirmationPopupProps, CwAlignProps, CwCardListProps, CwCardProps, CwChipProps, CwDialogProps, CwDropdownOption, CwDropdownProps, CwExpandableProps, CwImageAreaMethods, CwImageAreaProps, CwInputDatePickerProps, CwInputDateProps, CwInputDateTextProps, CwInputDatetimeProps, CwInputImageProps, CwInputNumberProps, CwInputPhoneProps, CwInputTextProps, CwInputTimeProps, CwKeyValueListProps, CwLabelProps, CwMasterDetailItem, CwMasterDetailProps, CwMessageProps, CwModalHoverProps, CwMultiFilterProps, CwMultiFilterTagProps, CwNoteProps, CwPopoverButtonProps, CwReportModalFunctionalProps, CwSelectListProps, CwSortableListProps, CwSortableTableProps, CwTableGroupedData, CwTableGroupedData_Group, CwTableGroupedData_Row, CwTableGroupedProps, CwTagSelectorOption, CwTagSelectorProps, CwTextAreaProps, CwTreeNode, DataItem, DateRangeValue, ICwMultiFilterTag, ImageItem, IndicatorRowDm, MenuOption, OnEvent, PinRowHeaderProps, RowHeaderDm, RowHeaderProps, SchedulerEventDm, SchedulerEventState, SchedulerRowProps, SchedulerState, ServerSideTableState, SortableColumn, SortableTableDragState, SuperSchedulerProps, Tab, UseSortableTableReturn, Weekday, ZoomImageItem, cblEventCompProps, resourceCompProps2 };