@consta/uikit 3.21.2 → 3.23.1

package/__internal__/src/components/DatePickerCanary/DatePickerCanary.js

@@ -8,6 +8,8 @@ import { DatePickerTypeDate } from './DatePickerTypeDate/DatePickerTypeDate';
 import { DatePickerTypeDateRange } from './DatePickerTypeDateRange/DatePickerTypeDateRange';
 import { DatePickerTypeDateTime } from './DatePickerTypeDateTime/DatePickerTypeDateTime';
 import { DatePickerTypeDateTimeRange } from './DatePickerTypeDateTimeRange/DatePickerTypeDateTimeRange';
+import { DatePickerTypeMonth } from './DatePickerTypeMonth/DatePickerTypeMonth';
+import { DatePickerTypeMonthRange } from './DatePickerTypeMonthRange/DatePickerTypeMonthRange';
 import { DatePickerTypeTime } from './DatePickerTypeTime/DatePickerTypeTime';
 import { DatePickerTypeYear } from './DatePickerTypeYear/DatePickerTypeYear';
 import { DatePickerTypeYearRange } from './DatePickerTypeYearRange/DatePickerTypeYearRange';
@@ -20,7 +22,9 @@ var typeMap = {
     'date-time-range': DatePickerTypeDateTimeRange,
     'time': DatePickerTypeTime,
     'year': DatePickerTypeYear,
-    'year-range': DatePickerTypeYearRange
+    'year-range': DatePickerTypeYearRange,
+    'month': DatePickerTypeMonth,
+    'month-range': DatePickerTypeMonthRange
 };
 export var COMPONENT_NAME = 'DatePicker';
 export var DatePicker = forwardRef(function (props, ref) {

package/__internal__/src/components/DatePickerCanary/DatePickerFieldTypeMonth/DatePickerFieldTypeMonth.d.ts

@@ -0,0 +1,45 @@
+import React from 'react';
+export declare const DatePickerFieldTypeMonth: React.ForwardRefExoticComponent<{
+    className?: string | undefined;
+    value?: Date | null | undefined;
+    onChange?: ((props: {
+        e: Event;
+        value: Date | null;
+    }) => void) | undefined;
+    onError?: import("../types").DatePickerPropOnError | undefined;
+    id?: string | undefined;
+    name?: string | undefined;
+    disabled?: boolean | undefined;
+    size?: "xs" | "s" | "m" | "l" | undefined;
+    view?: "default" | "clear" | undefined;
+    form?: "default" | "round" | "brick" | "brickRound" | "roundBrick" | "brickDefault" | "defaultBrick" | "clearRound" | "roundClear" | "clearDefault" | "defaultClear" | "brickClear" | "clearBrick" | "clearClear" | undefined;
+    status?: "alert" | "success" | "warning" | undefined;
+    width?: "default" | "full" | undefined;
+    onFocus?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined;
+    onBlur?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined;
+    autoFocus?: boolean | undefined;
+    placeholder?: string | undefined;
+    leftSide?: string | React.FC<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributesAndRef<{
+        view?: "link" | "alert" | "brand" | "ghost" | "primary" | "secondary" | "success" | "warning" | "disabled" | undefined;
+        size?: "xs" | "s" | "m" | undefined;
+    }, HTMLSpanElement>> | undefined;
+    rightSide?: string | React.FC<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributesAndRef<{
+        view?: "link" | "alert" | "brand" | "ghost" | "primary" | "secondary" | "success" | "warning" | "disabled" | undefined;
+        size?: "xs" | "s" | "m" | undefined;
+    }, HTMLSpanElement>> | undefined;
+    readOnly?: boolean | undefined;
+    required?: boolean | undefined;
+    tabIndex?: number | undefined;
+    inputRef?: ((instance: HTMLInputElement | HTMLTextAreaElement | null) => void) | React.RefObject<HTMLInputElement | HTMLTextAreaElement> | null | undefined;
+    ariaLabel?: string | undefined;
+    iconSize?: "xs" | "s" | "m" | undefined;
+    children?: undefined;
+    format?: string | undefined;
+    separator?: string | undefined;
+    minDate?: Date | undefined;
+    maxDate?: Date | undefined;
+    focused?: boolean | undefined;
+    label?: string | undefined;
+    caption?: string | undefined;
+    labelPosition?: "left" | "top" | undefined;
+} & Pick<React.HTMLAttributes<HTMLDivElement>, "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "lang" | "slot" | "spellCheck" | "style" | "title" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlurCapture" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture"> & React.RefAttributes<HTMLDivElement>>;

package/__internal__/src/components/DatePickerCanary/DatePickerFieldTypeMonth/DatePickerFieldTypeMonth.js

@@ -0,0 +1,73 @@
+import { __assign, __read, __rest } from "tslib";
+import React, { useCallback, useEffect, useRef, useState } from 'react';
+import { format, isValid, isWithinInterval, parse } from 'date-fns';
+import { useForkRef } from '../../../hooks/useForkRef/useForkRef';
+import { useMutableRef } from '../../../hooks/useMutableRef/useMutableRef';
+import { maxDateDefault, minDateDefault } from '../../../utils/date';
+import { TextField } from '../../TextField/TextField';
+import { datePickerPropFormatTypeMonth, datePickerPropPlaceholderTypeMonth, datePickerPropSeparatorDefault, getPartsDate, } from '../helpers';
+import { datePickerErrorTypes } from '../types';
+import { useImask } from './helpers';
+export var DatePickerFieldTypeMonth = React.forwardRef(function (props, ref) {
+    var _a = props.format, formatProp = _a === void 0 ? datePickerPropFormatTypeMonth : _a, _b = props.separator, separator = _b === void 0 ? datePickerPropSeparatorDefault : _b, _c = props.placeholder, placeholder = _c === void 0 ? datePickerPropPlaceholderTypeMonth : _c, onChange = props.onChange, onError = props.onError, _d = props.minDate, minDate = _d === void 0 ? minDateDefault : _d, _e = props.maxDate, maxDate = _e === void 0 ? maxDateDefault : _e, value = props.value, inputRefProp = props.inputRef, otherProps = __rest(props, ["format", "separator", "placeholder", "onChange", "onError", "minDate", "maxDate", "value", "inputRef"]);
+    var inputRef = useRef(null);
+    var onChangeRef = useMutableRef(onChange);
+    var _f = __read(useState(value && isValid(value) ? format(value, formatProp) : null), 2), stringValue = _f[0], setStringValue = _f[1];
+    var handleChange = useCallback(function (e, stringValue) {
+        setStringValue(stringValue);
+        var onChange = onChangeRef.current;
+        if (onChange) {
+            if (!stringValue) {
+                onChange({ e: e, value: null });
+                return;
+            }
+            var _a = __read(getPartsDate(stringValue, formatProp, separator, false, ['MM', 'yyyy']), 2), MM = _a[0], yyyy = _a[1];
+            if (MM && yyyy) {
+                var date = parse("" + MM + datePickerPropSeparatorDefault + yyyy, datePickerPropFormatTypeMonth, new Date());
+                if (!isWithinInterval(date, { start: minDate, end: maxDate })) {
+                    onError &&
+                        onError({
+                            type: datePickerErrorTypes[0],
+                            stringValue: stringValue,
+                            MM: MM,
+                            yyyy: yyyy,
+                            date: date
+                        });
+                    onChange({ e: e, value: null });
+                    return;
+                }
+                onChange({ e: e, value: date });
+            }
+            else {
+                onChange({ e: e, value: null });
+            }
+        }
+    }, [minDate === null || minDate === void 0 ? void 0 : minDate.getTime(), maxDate === null || maxDate === void 0 ? void 0 : maxDate.getTime(), formatProp, separator]);
+    useImask(formatProp, separator, inputRef, stringValue, onError);
+    // при изменении value, нужно обновить stringValue
+    useEffect(function () {
+        if (value && isValid(value)) {
+            setStringValue(format(value, formatProp));
+        }
+        else if ((stringValue === null || stringValue === void 0 ? void 0 : stringValue.length) === formatProp.length) {
+            // если количество введенных символов меньше чем в формате маски
+            // то не нужно мешать вводу с клавиатуры
+            // если дата была введена полностью и value пришел null,
+            // то можно считать что поле нуждается в очистке
+            setStringValue('');
+        }
+    }, [value === null || value === void 0 ? void 0 : value.getTime()]);
+    // задаем маску и сохраняем обьект маски в ref
+    // обнавляем при смене формата
+    // задаем нативный oninput, так как с маской по другому не будет работать
+    // обнавляем oninput при смене handleChange
+    useEffect(function () {
+        if (inputRef.current) {
+            inputRef.current.oninput = function (e) {
+                var _a;
+                handleChange(e, ((_a = inputRef.current) === null || _a === void 0 ? void 0 : _a.value) || '');
+            };
+        }
+    }, [handleChange]);
+    return (React.createElement(TextField, __assign({}, otherProps, { type: "text", inputContainerRef: ref, inputRef: useForkRef([inputRef, inputRefProp]), value: stringValue, placeholder: placeholder })));
+});

package/__internal__/src/components/DatePickerCanary/DatePickerFieldTypeMonth/helpers.d.ts

@@ -0,0 +1,46 @@
+/// <reference types="react" />
+import { IconComponent, IconPropSize } from '../../../icons/Icon/Icon';
+import { PropsWithHTMLAttributes } from '../../../utils/types/PropsWithHTMLAttributes';
+import { TextFieldPropForm, TextFieldPropSize, TextFieldPropStatus, TextFieldPropView, TextFieldPropWidth } from '../../TextField/TextField';
+import { DatePickerPropOnError } from '../types';
+declare type DatePickerFieldTypeMonthPropOnChange = (props: {
+    e: Event;
+    value: Date | null;
+}) => void;
+export declare type DatePickerFieldTypeMonthProps = PropsWithHTMLAttributes<{
+    className?: string;
+    value?: Date | null;
+    onChange?: DatePickerFieldTypeMonthPropOnChange;
+    onError?: DatePickerPropOnError;
+    id?: string;
+    name?: string;
+    disabled?: boolean;
+    size?: TextFieldPropSize;
+    view?: TextFieldPropView;
+    form?: TextFieldPropForm;
+    status?: TextFieldPropStatus;
+    width?: TextFieldPropWidth;
+    onFocus?: React.FocusEventHandler<HTMLElement>;
+    onBlur?: React.FocusEventHandler<HTMLElement>;
+    autoFocus?: boolean;
+    placeholder?: string;
+    leftSide?: string | IconComponent;
+    rightSide?: string | IconComponent;
+    readOnly?: boolean;
+    required?: boolean;
+    tabIndex?: number;
+    inputRef?: React.Ref<HTMLTextAreaElement | HTMLInputElement>;
+    ariaLabel?: string;
+    iconSize?: IconPropSize;
+    children?: never;
+    format?: string;
+    separator?: string;
+    minDate?: Date;
+    maxDate?: Date;
+    focused?: boolean;
+    label?: string;
+    caption?: string;
+    labelPosition?: 'top' | 'left';
+}, HTMLDivElement>;
+export declare const useImask: (formatProp: string, separator: string, inputRef: React.RefObject<HTMLInputElement>, stringValue: string | null, onError: DatePickerPropOnError | undefined) => void;
+export {};

package/__internal__/src/components/DatePickerCanary/DatePickerFieldTypeMonth/helpers.js

@@ -0,0 +1,58 @@
+import { __read } from "tslib";
+import { useEffect, useRef } from 'react';
+import { format, isValid, parse } from 'date-fns';
+import IMask from 'imask';
+import { datePickerPropFormatTypeMonth, datePickerPropSeparatorDefault, getPartsDate, } from '../helpers';
+import { datePickerErrorTypes } from '../types';
+export var useImask = function (formatProp, separator, inputRef, stringValue, onError) {
+    var imaskRef = useRef(null);
+    // задаем маску и сохраняем обьект маски в ref
+    // обнавляем при смене формата
+    useEffect(function () {
+        if (inputRef.current) {
+            imaskRef.current = IMask(inputRef.current, {
+                mask: Date,
+                pattern: formatProp,
+                blocks: {
+                    yyyy: {
+                        mask: IMask.MaskedRange,
+                        from: 1,
+                        to: 9999
+                    },
+                    MM: {
+                        mask: IMask.MaskedRange,
+                        from: 1,
+                        to: 12
+                    }
+                },
+                lazy: true,
+                autofix: true,
+                format: function (date) { return format(date, formatProp); },
+                parse: function (string) { return parse(string, formatProp, new Date()); },
+                validate: function (string) {
+                    var _a = __read(getPartsDate(string, formatProp, separator, false, ['MM', 'yyyy']), 2), MM = _a[0], yyyy = _a[1];
+                    if (MM &&
+                        yyyy &&
+                        !isValid(parse("" + MM + datePickerPropSeparatorDefault + yyyy, datePickerPropFormatTypeMonth, new Date()))) {
+                        onError &&
+                            onError({
+                                type: datePickerErrorTypes[1],
+                                stringValue: string,
+                                MM: MM,
+                                yyyy: yyyy
+                            });
+                        return false;
+                    }
+                    return true;
+                }
+            });
+        }
+    }, [formatProp, separator]);
+    // Нужно для синхранизации value c Imask,
+    // так как value мы можем задать через пропс без самого ввода,
+    // и Imask требует ручной синхронихации в этом случае
+    useEffect(function () {
+        var _a;
+        (_a = imaskRef.current) === null || _a === void 0 ? void 0 : _a.updateValue();
+    }, [stringValue]);
+};

package/__internal__/src/components/DatePickerCanary/DatePickerFieldTypeMonthRange/DatePickerFieldTypeMonthRange.d.ts

@@ -0,0 +1,82 @@
+import React from 'react';
+export declare const DatePickerFieldTypeMonthRange: React.ForwardRefExoticComponent<Pick<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributes<{
+    className?: string | undefined;
+    value?: Date | null | undefined;
+    onChange?: ((props: {
+        e: Event;
+        value: Date | null;
+    }) => void) | undefined;
+    onError?: import("../types").DatePickerPropOnError | undefined;
+    id?: string | undefined;
+    name?: string | undefined;
+    disabled?: boolean | undefined;
+    size?: "xs" | "s" | "m" | "l" | undefined;
+    view?: "default" | "clear" | undefined;
+    form?: "default" | "round" | "brick" | "brickRound" | "roundBrick" | "brickDefault" | "defaultBrick" | "clearRound" | "roundClear" | "clearDefault" | "defaultClear" | "brickClear" | "clearBrick" | "clearClear" | undefined;
+    status?: "alert" | "success" | "warning" | undefined;
+    width?: "default" | "full" | undefined;
+    onFocus?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined;
+    onBlur?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined;
+    autoFocus?: boolean | undefined;
+    placeholder?: string | undefined;
+    leftSide?: string | React.FC<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributesAndRef<{
+        view?: "link" | "alert" | "brand" | "ghost" | "primary" | "secondary" | "success" | "warning" | "disabled" | undefined;
+        size?: "xs" | "s" | "m" | undefined;
+    }, HTMLSpanElement>> | undefined;
+    rightSide?: string | React.FC<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributesAndRef<{
+        view?: "link" | "alert" | "brand" | "ghost" | "primary" | "secondary" | "success" | "warning" | "disabled" | undefined;
+        size?: "xs" | "s" | "m" | undefined;
+    }, HTMLSpanElement>> | undefined;
+    readOnly?: boolean | undefined;
+    required?: boolean | undefined;
+    tabIndex?: number | undefined;
+    inputRef?: ((instance: HTMLInputElement | HTMLTextAreaElement | null) => void) | React.RefObject<HTMLInputElement | HTMLTextAreaElement> | null | undefined;
+    ariaLabel?: string | undefined;
+    iconSize?: "xs" | "s" | "m" | undefined;
+    children?: undefined;
+    format?: string | undefined;
+    separator?: string | undefined;
+    minDate?: Date | undefined;
+    maxDate?: Date | undefined;
+    focused?: boolean | undefined;
+    label?: string | undefined;
+    caption?: string | undefined;
+    labelPosition?: "left" | "top" | undefined;
+}, HTMLDivElement>, "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "lang" | "placeholder" | "slot" | "spellCheck" | "style" | "tabIndex" | "title" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlurCapture" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "disabled" | "view" | "size" | "caption" | "form" | "label" | "width" | "format" | "autoFocus" | "readOnly" | "required" | "status" | "focused" | "ariaLabel" | "labelPosition" | "iconSize" | "separator" | "minDate" | "maxDate"> & {
+    onChange?: ((props: {
+        e: Event;
+        value: import("../../../utils/types/Date").DateRange | null;
+    }) => void) | undefined;
+    value?: import("../../../utils/types/Date").DateRange | null | undefined;
+    startFieldInputRef?: ((instance: HTMLInputElement | null) => void) | React.RefObject<HTMLInputElement> | null | undefined;
+    endFieldInputRef?: ((instance: HTMLInputElement | null) => void) | React.RefObject<HTMLInputElement> | null | undefined;
+    startFieldLeftSide?: string | React.FC<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributesAndRef<{
+        view?: "link" | "alert" | "brand" | "ghost" | "primary" | "secondary" | "success" | "warning" | "disabled" | undefined;
+        size?: "xs" | "s" | "m" | undefined;
+    }, HTMLSpanElement>> | undefined;
+    startFieldRightSide?: string | React.FC<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributesAndRef<{
+        view?: "link" | "alert" | "brand" | "ghost" | "primary" | "secondary" | "success" | "warning" | "disabled" | undefined;
+        size?: "xs" | "s" | "m" | undefined;
+    }, HTMLSpanElement>> | undefined;
+    endFieldLeftSide?: string | React.FC<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributesAndRef<{
+        view?: "link" | "alert" | "brand" | "ghost" | "primary" | "secondary" | "success" | "warning" | "disabled" | undefined;
+        size?: "xs" | "s" | "m" | undefined;
+    }, HTMLSpanElement>> | undefined;
+    endFieldRightSide?: string | React.FC<import("../../../utils/types/PropsWithHTMLAttributes").PropsWithHTMLAttributesAndRef<{
+        view?: "link" | "alert" | "brand" | "ghost" | "primary" | "secondary" | "success" | "warning" | "disabled" | undefined;
+        size?: "xs" | "s" | "m" | undefined;
+    }, HTMLSpanElement>> | undefined;
+    startFieldRef?: ((instance: HTMLDivElement | null) => void) | React.RefObject<HTMLDivElement> | null | undefined;
+    endFieldRef?: ((instance: HTMLDivElement | null) => void) | React.RefObject<HTMLDivElement> | null | undefined;
+    startFieldOnFocus?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined;
+    endFieldOnFocus?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined;
+    startFieldOnBlur?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined;
+    endFieldOnBlur?: ((event: React.FocusEvent<HTMLElement>) => void) | undefined;
+    startFocused?: boolean | undefined;
+    endFocused?: boolean | undefined;
+    id?: string | undefined;
+    onChangeCurrentVisibleDate?: ((date: Date) => void) | undefined;
+    currentVisibleDate?: Date | undefined;
+    startFieldName?: string | undefined;
+    endFieldName?: string | undefined;
+} & React.RefAttributes<HTMLDivElement>>;

package/__internal__/src/components/DatePickerCanary/DatePickerFieldTypeMonthRange/DatePickerFieldTypeMonthRange.js

@@ -0,0 +1,95 @@
+import { __assign, __read, __rest } from "tslib";
+import React, { forwardRef, useEffect, useRef, useState } from 'react';
+import isBefore from 'date-fns/isBefore';
+import isEqual from 'date-fns/isEqual';
+import { FieldCaption } from '../../FieldCaption/FieldCaption';
+import { FieldLabel } from '../../FieldLabel/FieldLabel';
+import { DatePickerFieldTypeMonth } from '../DatePickerFieldTypeMonth/DatePickerFieldTypeMonth';
+import { cnDatePickerMixRangeField } from '../DatePickerMixRangeField/DatePickerMixRangeField';
+import { getFormForEnd, getFormForStart } from '../helpers';
+import { datePickerErrorTypes } from '../types';
+export var DatePickerFieldTypeMonthRange = forwardRef(function (props, ref) {
+    var _a, _b;
+    var className = props.className, _c = props.form, form = _c === void 0 ? 'default' : _c, startFieldInputRef = props.startFieldInputRef, startFieldLeftSide = props.startFieldLeftSide, startFieldRightSide = props.startFieldRightSide, endFieldInputRef = props.endFieldInputRef, endFieldLeftSide = props.endFieldLeftSide, endFieldRightSide = props.endFieldRightSide, _d = props.value, value = _d === void 0 ? [] : _d, onChange = props.onChange, onError = props.onError, startFieldName = props.startFieldName, endFieldName = props.endFieldName, disabled = props.disabled, size = props.size, view = props.view, status = props.status, autoFocus = props.autoFocus, placeholder = props.placeholder, readOnly = props.readOnly, required = props.required, tabIndex = props.tabIndex, ariaLabel = props.ariaLabel, iconSize = props.iconSize, format = props.format, separator = props.separator, minDate = props.minDate, maxDate = props.maxDate, startFieldOnBlur = props.startFieldOnBlur, startFieldOnFocus = props.startFieldOnFocus, endFieldOnBlur = props.endFieldOnBlur, endFieldOnFocus = props.endFieldOnFocus, startFieldRef = props.startFieldRef, endFieldRef = props.endFieldRef, startFocused = props.startFocused, endFocused = props.endFocused, label = props.label, labelPosition = props.labelPosition, caption = props.caption, width = props.width, otherProps = __rest(props, ["className", "form", "startFieldInputRef", "startFieldLeftSide", "startFieldRightSide", "endFieldInputRef", "endFieldLeftSide", "endFieldRightSide", "value", "onChange", "onError", "startFieldName", "endFieldName", "disabled", "size", "view", "status", "autoFocus", "placeholder", "readOnly", "required", "tabIndex", "ariaLabel", "iconSize", "format", "separator", "minDate", "maxDate", "startFieldOnBlur", "startFieldOnFocus", "endFieldOnBlur", "endFieldOnFocus", "startFieldRef", "endFieldRef", "startFocused", "endFocused", "label", "labelPosition", "caption", "width"]);
+    var commonProps = {
+        className: cnDatePickerMixRangeField('Field'),
+        disabled: disabled,
+        onError: onError,
+        size: size,
+        view: view,
+        status: status,
+        autoFocus: autoFocus,
+        placeholder: placeholder,
+        readOnly: readOnly,
+        required: required,
+        tabIndex: tabIndex,
+        ariaLabel: ariaLabel,
+        iconSize: iconSize,
+        format: format,
+        separator: separator,
+        minDate: minDate,
+        maxDate: maxDate
+    };
+    var _e = __read(useState(value === null || value === void 0 ? void 0 : value[0]), 2), startDate = _e[0], setStartDate = _e[1];
+    var _f = __read(useState(value === null || value === void 0 ? void 0 : value[1]), 2), endDate = _f[0], setEndDate = _f[1];
+    var eventRef = useRef();
+    var handleChange = function (e, ownStartDate, ownEndDate) {
+        var start = ownStartDate || startDate;
+        var end = ownEndDate || endDate;
+        if (!onChange) {
+            return;
+        }
+        if (start && end) {
+            if (isBefore(start, end) || isEqual(start, end)) {
+                onChange({ e: e, value: [start, end] });
+                return;
+            }
+            onChange({ e: e, value: [start, undefined] });
+            onError && onError({ type: datePickerErrorTypes[2], date: [start, end] });
+            return;
+        }
+        if (start) {
+            onChange({ e: e, value: [start, undefined] });
+            return;
+        }
+        if (end) {
+            onChange({ e: e, value: [undefined, end] });
+            return;
+        }
+        onChange({ e: e, value: null });
+    };
+    var handleStartDateChange = function (props) {
+        var _a;
+        if (((_a = props.value) === null || _a === void 0 ? void 0 : _a.getTime()) === (startDate === null || startDate === void 0 ? void 0 : startDate.getTime())) {
+            return;
+        }
+        eventRef.current = props.e;
+        setStartDate(props.value);
+    };
+    var handleEndDateChange = function (props) {
+        var _a;
+        if (((_a = props.value) === null || _a === void 0 ? void 0 : _a.getTime()) === (endDate === null || endDate === void 0 ? void 0 : endDate.getTime())) {
+            return;
+        }
+        eventRef.current = props.e;
+        setEndDate(props.value);
+    };
+    useEffect(function () {
+        if (eventRef.current) {
+            handleChange(eventRef.current, startDate, endDate);
+        }
+    }, [eventRef.current]);
+    useEffect(function () {
+        setStartDate(value === null || value === void 0 ? void 0 : value[0]);
+    }, [(_a = value === null || value === void 0 ? void 0 : value[0]) === null || _a === void 0 ? void 0 : _a.getTime()]);
+    useEffect(function () {
+        setEndDate(value === null || value === void 0 ? void 0 : value[1]);
+    }, [(_b = value === null || value === void 0 ? void 0 : value[1]) === null || _b === void 0 ? void 0 : _b.getTime()]);
+    return (React.createElement("div", __assign({}, otherProps, { className: cnDatePickerMixRangeField({ view: view, labelPosition: labelPosition, width: width, size: size }, [className]), ref: ref }),
+        label && (React.createElement(FieldLabel, { required: required, className: cnDatePickerMixRangeField('Label', { labelPosition: labelPosition }), size: size }, label)),
+        React.createElement("div", { className: cnDatePickerMixRangeField('Body') },
+            React.createElement("div", { className: cnDatePickerMixRangeField('Fields') },
+                React.createElement(DatePickerFieldTypeMonth, __assign({}, commonProps, { inputRef: startFieldInputRef, ref: startFieldRef, leftSide: startFieldLeftSide, rightSide: startFieldRightSide, form: getFormForStart(form), value: startDate, onChange: handleStartDateChange, onFocus: startFieldOnFocus, onBlur: startFieldOnBlur, focused: startFocused, name: startFieldName })),
+                React.createElement(DatePickerFieldTypeMonth, __assign({}, commonProps, { name: endFieldName, inputRef: endFieldInputRef, ref: endFieldRef, leftSide: endFieldLeftSide, rightSide: endFieldRightSide, form: getFormForEnd(form), value: endDate, onChange: handleEndDateChange, onFocus: endFieldOnFocus, onBlur: endFieldOnBlur, focused: endFocused }))),
+            caption && (React.createElement(FieldCaption, { className: cnDatePickerMixRangeField('Caption'), status: status }, caption)))));
+});

package/__internal__/src/components/DatePickerCanary/DatePickerFieldTypeMonthRange/helpers.d.ts

@@ -0,0 +1,32 @@
+/// <reference types="react" />
+import { IconComponent } from '../../../icons/Icon/Icon';
+import { DateRange } from '../../../utils/types/Date';
+import { DatePickerFieldTypeYearProps } from '../DatePickerFieldTypeYear/helpers';
+declare type DatePickerFieldTypeMonthRangePropOnChange = (props: {
+    e: Event;
+    value: DateRange | null;
+}) => void;
+export declare type DatePickerFieldTypeMonthRangeProps = Omit<DatePickerFieldTypeYearProps, 'onChange' | 'value' | 'inputRef' | 'leftSide' | 'rightSide' | 'id' | 'onFocus' | 'onBlur' | 'name'> & {
+    onChange?: DatePickerFieldTypeMonthRangePropOnChange;
+    value?: DateRange | null;
+    startFieldInputRef?: React.Ref<HTMLInputElement>;
+    endFieldInputRef?: React.Ref<HTMLInputElement>;
+    startFieldLeftSide?: string | IconComponent;
+    startFieldRightSide?: string | IconComponent;
+    endFieldLeftSide?: string | IconComponent;
+    endFieldRightSide?: string | IconComponent;
+    startFieldRef?: React.Ref<HTMLDivElement>;
+    endFieldRef?: React.Ref<HTMLDivElement>;
+    startFieldOnFocus?: React.FocusEventHandler<HTMLElement>;
+    endFieldOnFocus?: React.FocusEventHandler<HTMLElement>;
+    startFieldOnBlur?: React.FocusEventHandler<HTMLElement>;
+    endFieldOnBlur?: React.FocusEventHandler<HTMLElement>;
+    startFocused?: boolean;
+    endFocused?: boolean;
+    id?: string;
+    onChangeCurrentVisibleDate?: (date: Date) => void;
+    currentVisibleDate?: Date;
+    startFieldName?: string;
+    endFieldName?: string;
+};
+export {};

package/__internal__/src/components/DatePickerCanary/DatePickerTypeMonth/DatePickerTypeMonth.d.ts

@@ -0,0 +1,2 @@
+import { DatePickerTypeComponent } from '../types';
+export declare const DatePickerTypeMonth: DatePickerTypeComponent<'month'>;

package/__internal__/src/components/DatePickerCanary/DatePickerTypeMonth/DatePickerTypeMonth.js

@@ -0,0 +1,58 @@
+import { __assign, __read, __rest } from "tslib";
+import React, { forwardRef, useEffect, useRef, useState } from 'react';
+import { addMonths, startOfYear } from 'date-fns';
+import { useClickOutside } from '../../../hooks/useClickOutside/useClickOutside';
+import { useFlag } from '../../../hooks/useFlag/useFlag';
+import { setRef } from '../../../utils/setRef';
+import { DatePickerDropdown } from '../DatePickerDropdown/DatePickerDropdown';
+import { DatePickerFieldTypeMonth } from '../DatePickerFieldTypeMonth/DatePickerFieldTypeMonth';
+import { useCurrentVisibleDate } from '../useCurrentVisibleDate';
+export var DatePickerTypeMonth = forwardRef(function (props, ref) {
+    var events = props.events, dateTimeView = props.dateTimeView, locale = props.locale, dropdownForm = props.dropdownForm, onFocus = props.onFocus, currentVisibleDateProp = props.currentVisibleDate, onChangeCurrentVisibleDateProp = props.onChangeCurrentVisibleDate, renderAdditionalControls = props.renderAdditionalControls, style = props.style, otherProps = __rest(props, ["events", "dateTimeView", "locale", "dropdownForm", "onFocus", "currentVisibleDate", "onChangeCurrentVisibleDate", "renderAdditionalControls", "style"]);
+    var fieldRef = useRef(null);
+    var calendarRef = useRef(null);
+    var _a = __read(useFlag(false), 2), calendarVisible = _a[0], setCalendarVisible = _a[1];
+    var _b = __read(useCurrentVisibleDate(currentVisibleDateProp, onChangeCurrentVisibleDateProp), 2), currentVisibleDate = _b[0], setCurrentVisibleDate = _b[1];
+    var _c = __read(useState(), 2), calendarVisibleDate = _c[0], setCalendarVisibleDate = _c[1];
+    var onFocusHandler = function (e) {
+        onFocus && onFocus(e);
+        setCalendarVisible.on();
+    };
+    useEffect(function () {
+        if (ref) {
+            setRef(ref, fieldRef.current);
+        }
+    }, [ref, fieldRef]);
+    useEffect(function () {
+        if (props.value && props.dateTimeView === 'classic' && calendarVisibleDate) {
+            var newVisibleDate = startOfYear(props.value);
+            if (newVisibleDate.getTime() !== calendarVisibleDate.getTime()) {
+                setCurrentVisibleDate(newVisibleDate);
+            }
+            return;
+        }
+        if (props.value && props.dateTimeView !== 'classic' && calendarVisibleDate) {
+            var newVisibleDate = startOfYear(props.value);
+            if (newVisibleDate.getTime() !== calendarVisibleDate.getTime() &&
+                newVisibleDate.getTime() !== addMonths(calendarVisibleDate, 1).getTime()) {
+                setCurrentVisibleDate(newVisibleDate);
+            }
+        }
+    }, [props.value]);
+    var handleClose = function () {
+        setCalendarVisible.off();
+        setCurrentVisibleDate(props.value ? undefined : currentVisibleDateProp);
+    };
+    useClickOutside({
+        isActive: calendarVisible,
+        ignoreClicksInsideRefs: [fieldRef, calendarRef],
+        handler: handleClose
+    });
+    return (React.createElement(React.Fragment, null,
+        React.createElement(DatePickerFieldTypeMonth, __assign({}, otherProps, { ref: fieldRef, onFocus: onFocusHandler, style: style })),
+        React.createElement(DatePickerDropdown, { ref: calendarRef, anchorRef: fieldRef, isOpen: calendarVisible, value: props.value || undefined, type: "month", view: dateTimeView, events: events, locale: locale, minDate: props.minDate, maxDate: props.maxDate, currentVisibleDate: currentVisibleDate, form: dropdownForm, onChange: function (params) {
+                var _a;
+                (_a = props.onChange) === null || _a === void 0 ? void 0 : _a.call(props, params);
+                handleClose();
+            }, renderAdditionalControls: renderAdditionalControls, zIndex: typeof (style === null || style === void 0 ? void 0 : style.zIndex) === 'number' ? style.zIndex + 1 : undefined, onChangeCurrentVisibleDate: setCalendarVisibleDate })));
+});

package/__internal__/src/components/DatePickerCanary/DatePickerTypeMonthRange/DatePickerTypeMonthRange.d.ts

@@ -0,0 +1,2 @@
+import { DatePickerTypeComponent } from '../types';
+export declare const DatePickerTypeMonthRange: DatePickerTypeComponent<'month-range'>;