@atlaskit/datetime-picker 15.4.3 → 15.5.1

package/dist/es2019/components/date-time-picker-fc.js

@@ -0,0 +1,363 @@
+/**
+ * @jsxRuntime classic
+ * @jsx jsx
+ */
+import React, { forwardRef, useCallback, useEffect, useState } from 'react';
+
+// eslint-disable-next-line @atlaskit/ui-styling-standard/use-compiled -- Ignored via go/DSP-18766
+import { css, jsx } from '@emotion/react';
+import { format, isValid, parseISO } from 'date-fns';
+import { usePlatformLeafEventHandler } from '@atlaskit/analytics-next';
+import SelectClearIcon from '@atlaskit/icon/glyph/select-clear';
+import { fg } from '@atlaskit/platform-feature-flags';
+import { mergeStyles } from '@atlaskit/select';
+import { N500, N70 } from '@atlaskit/theme/colors';
+import { formatDateTimeZoneIntoIso } from '../internal';
+import { DateTimePickerContainer } from '../internal/date-time-picker-container';
+import { componentWithCondition } from '../internal/ff-component';
+import { convertTokens } from '../internal/parse-tokens';
+import DatePickerOld from './date-picker-class';
+import DatePickerNew from './date-picker-fc';
+import TimePicker from './time-picker';
+const DatePicker = componentWithCondition(() => fg('dst-date-picker-use-functional-component'), DatePickerNew, DatePickerOld);
+const packageName = "@atlaskit/datetime-picker";
+const packageVersion = "15.5.1";
+const analyticsAttributes = {
+  componentName: 'dateTimePicker',
+  packageName,
+  packageVersion
+};
+
+// Make DatePicker 50% the width of DateTimePicker
+// If rendering an icon container, shrink the TimePicker
+const datePickerContainerStyles = css({
+  flexBasis: '50%',
+  flexGrow: 1,
+  flexShrink: 0
+});
+const timePickerContainerStyles = css({
+  flexBasis: '50%',
+  flexGrow: 1
+});
+const iconContainerStyles = css({
+  display: 'flex',
+  margin: "var(--ds-border-width, 1px)",
+  alignItems: 'center',
+  flexBasis: 'inherit',
+  backgroundColor: 'inherit',
+  border: 'none',
+  color: `var(--ds-text-subtlest, ${N70})`,
+  paddingBlockEnd: "var(--ds-space-075, 6px)",
+  paddingBlockStart: "var(--ds-space-075, 6px)",
+  paddingInlineEnd: "var(--ds-space-100, 8px)",
+  paddingInlineStart: "var(--ds-space-050, 4px)",
+  transition: `color 150ms`,
+  '&:hover': {
+    color: `var(--ds-text-subtle, ${N500})`
+  }
+});
+
+// react-select overrides (via @atlaskit/select).
+const styles = {
+  control: style => ({
+    ...style,
+    backgroundColor: 'transparent',
+    border: 2,
+    borderRadius: 0,
+    paddingLeft: 0,
+    ':hover': {
+      backgroundColor: 'transparent',
+      cursor: 'inherit'
+    }
+  })
+};
+export const datePickerDefaultAriaLabel = 'Date';
+export const timePickerDefaultAriaLabel = 'Time';
+
+/**
+ * __Date time picker__
+ *
+ * A date time picker allows the user to select an associated date and time.
+ *
+ * - [Examples](https://atlassian.design/components/datetime-picker/examples)
+ * - [Code](https://atlassian.design/components/datetime-picker/code)
+ * - [Usage](https://atlassian.design/components/datetime-picker/usage)
+ */
+const DateTimePicker = /*#__PURE__*/forwardRef(({
+  'aria-describedby': ariaDescribedBy,
+  appearance = 'default',
+  autoFocus = false,
+  clearControlLabel = 'clear',
+  datePickerProps: datePickerPropsWithSelectProps = {},
+  defaultValue = '',
+  id = '',
+  innerProps = {},
+  isDisabled = false,
+  isInvalid = false,
+  isRequired = false,
+  name = '',
+  // These disables are here for proper typing when used as defaults. They
+  // should *not* use the `noop` function.
+  /* eslint-disable @repo/internal/react/use-noop */
+  onBlur = _event => {},
+  onChange: onChangeProp = _value => {},
+  onFocus = _event => {},
+  /* eslint-enable @repo/internal/react/use-noop */
+  parseValue: providedParseValue,
+  spacing = 'default',
+  locale = 'en-US',
+  testId,
+  timePickerProps: timePickerPropsWithSelectProps = {},
+  value: providedValue
+}, ref) => {
+  const [dateValue, setDateValue] = useState((datePickerPropsWithSelectProps === null || datePickerPropsWithSelectProps === void 0 ? void 0 : datePickerPropsWithSelectProps.defaultValue) || '');
+  const [isFocused, setIsFocused] = useState(false);
+  const [timeValue, setTimeValue] = useState((timePickerPropsWithSelectProps === null || timePickerPropsWithSelectProps === void 0 ? void 0 : timePickerPropsWithSelectProps.defaultValue) || '');
+  const [value, setValue] = useState(defaultValue || '');
+  const [zoneValue, setZoneValue] = useState('');
+  useEffect(() => {
+    if (providedValue) {
+      setValue(providedValue);
+    }
+  }, [providedValue]);
+  const parseValue = useCallback((value, providedDateValue, providedTimeValue, providedZoneValue) => {
+    if (providedParseValue) {
+      const parsedFromFn = providedParseValue(value, providedDateValue, providedTimeValue, providedZoneValue);
+      // This handles cases found in Jira where the parse function actually does
+      // nothing and returns undefined. The previous `getSafeState` function
+      // just spread the values over the state, but if it returned `undefined`,
+      // it would just rely on the previous state values. Considering this is
+      // what is input to this function anyway, this is a safe way to handle
+      // this, colocate the behavior, and not rely on `getSafeState`.
+      return parsedFromFn || {
+        dateValue: providedDateValue,
+        timeValue: providedTimeValue,
+        zoneValue: providedZoneValue
+      };
+    }
+    const parsed = parseISO(value);
+    return isValid(parsed) ? {
+      dateValue: format(parsed, convertTokens('YYYY-MM-DD')),
+      timeValue: format(parsed, convertTokens('HH:mm')),
+      zoneValue: format(parsed, convertTokens('ZZ'))
+    } : {
+      dateValue,
+      timeValue,
+      zoneValue
+    };
+  }, [providedParseValue, dateValue, timeValue, zoneValue]);
+  useEffect(() => {
+    const parsedValues = parseValue(value, dateValue, timeValue, zoneValue);
+    setDateValue(parsedValues.dateValue);
+    setTimeValue(parsedValues.timeValue);
+    setZoneValue(parsedValues.zoneValue);
+  }, [value, dateValue, timeValue, zoneValue, parseValue]);
+  const onDateBlur = event => {
+    setIsFocused(false);
+    onBlur(event);
+    if (datePickerPropsWithSelectProps !== null && datePickerPropsWithSelectProps !== void 0 && datePickerPropsWithSelectProps.onBlur) {
+      datePickerPropsWithSelectProps.onBlur(event);
+    }
+  };
+  const onTimeBlur = event => {
+    setIsFocused(false);
+    onBlur(event);
+    if (timePickerPropsWithSelectProps !== null && timePickerPropsWithSelectProps !== void 0 && timePickerPropsWithSelectProps.onBlur) {
+      timePickerPropsWithSelectProps.onBlur(event);
+    }
+  };
+  const onDateFocus = event => {
+    setIsFocused(false);
+    onFocus(event);
+    if (datePickerPropsWithSelectProps !== null && datePickerPropsWithSelectProps !== void 0 && datePickerPropsWithSelectProps.onFocus) {
+      datePickerPropsWithSelectProps.onFocus(event);
+    }
+  };
+  const onTimeFocus = event => {
+    setIsFocused(false);
+    onFocus(event);
+    if (timePickerPropsWithSelectProps !== null && timePickerPropsWithSelectProps !== void 0 && timePickerPropsWithSelectProps.onFocus) {
+      timePickerPropsWithSelectProps.onFocus(event);
+    }
+  };
+  const onDateChange = dateValue => {
+    const parsedValues = parseValue(value, dateValue, timeValue, zoneValue);
+    onValueChange({
+      providedDateValue: dateValue,
+      providedTimeValue: parsedValues.timeValue,
+      providedZoneValue: parsedValues.zoneValue
+    });
+    if (datePickerPropsWithSelectProps !== null && datePickerPropsWithSelectProps !== void 0 && datePickerPropsWithSelectProps.onChange) {
+      datePickerPropsWithSelectProps.onChange(dateValue);
+    }
+  };
+  const onTimeChange = timeValue => {
+    const parsedValues = parseValue(value, dateValue, timeValue, zoneValue);
+    onValueChange({
+      providedDateValue: parsedValues.dateValue,
+      providedTimeValue: timeValue,
+      providedZoneValue: parsedValues.zoneValue
+    });
+    if (timePickerPropsWithSelectProps !== null && timePickerPropsWithSelectProps !== void 0 && timePickerPropsWithSelectProps.onChange) {
+      timePickerPropsWithSelectProps.onChange(timeValue);
+    }
+  };
+  const onClear = () => {
+    const parsedValues = parseValue(value, dateValue, timeValue, zoneValue);
+    onValueChange({
+      providedDateValue: '',
+      providedTimeValue: '',
+      providedZoneValue: parsedValues.zoneValue
+    });
+    if (datePickerPropsWithSelectProps !== null && datePickerPropsWithSelectProps !== void 0 && datePickerPropsWithSelectProps.onChange) {
+      datePickerPropsWithSelectProps.onChange('');
+    }
+    if (timePickerPropsWithSelectProps !== null && timePickerPropsWithSelectProps !== void 0 && timePickerPropsWithSelectProps.onChange) {
+      timePickerPropsWithSelectProps.onChange('');
+    }
+  };
+  const onChangePropWithAnalytics = usePlatformLeafEventHandler({
+    fn: onChangeProp,
+    action: 'selectedDate',
+    actionSubject: 'datePicker',
+    ...analyticsAttributes
+  });
+  const onValueChange = ({
+    providedDateValue,
+    providedTimeValue,
+    providedZoneValue
+  }) => {
+    setDateValue(providedDateValue);
+    setTimeValue(providedTimeValue);
+    setZoneValue(providedZoneValue);
+    if (providedDateValue && providedTimeValue) {
+      const value = formatDateTimeZoneIntoIso(providedDateValue, providedTimeValue, providedZoneValue);
+      const {
+        zoneValue: parsedZone
+      } = parseValue(value, providedDateValue, providedTimeValue, providedZoneValue);
+      const valueWithValidZone = formatDateTimeZoneIntoIso(providedDateValue, providedTimeValue, parsedZone);
+      setValue(valueWithValidZone);
+      onChangePropWithAnalytics(valueWithValidZone);
+      // If the date or time value was cleared when there is an existing datetime value, then clear the value.
+    } else if (value) {
+      setValue('');
+      onChangePropWithAnalytics('');
+    }
+  };
+  const {
+    selectProps: datePickerSelectProps,
+    ...datePickerProps
+  } = datePickerPropsWithSelectProps;
+  const datePickerAriaDescribedBy = datePickerProps['aria-describedby'] || ariaDescribedBy;
+  const datePickerLabel = datePickerProps.label || datePickerDefaultAriaLabel;
+  const mergedDatePickerSelectProps = {
+    ...datePickerSelectProps,
+    styles: mergeStyles(styles, datePickerSelectProps === null || datePickerSelectProps === void 0 ? void 0 : datePickerSelectProps.styles)
+  };
+  const {
+    selectProps: timePickerSelectProps,
+    ...timePickerProps
+  } = timePickerPropsWithSelectProps;
+  const timePickerAriaDescribedBy = timePickerProps['aria-describedby'] || ariaDescribedBy;
+  const timePickerLabel = timePickerProps.label || timePickerDefaultAriaLabel;
+  const mergedTimePickerSelectProps = {
+    ...timePickerSelectProps,
+    styles: mergeStyles(styles, timePickerSelectProps === null || timePickerSelectProps === void 0 ? void 0 : timePickerSelectProps.styles)
+  };
+
+  // Render DateTimePicker's IconContainer when a value has been filled
+  // Don't use Date or TimePicker's because they can't be customised
+  const isClearable = Boolean(dateValue || timeValue);
+  return jsx(DateTimePickerContainer, {
+    appearance: appearance,
+    isDisabled: isDisabled,
+    isFocused: isFocused,
+    isInvalid: isInvalid,
+    testId: testId,
+    innerProps: innerProps
+  }, jsx("input", {
+    name: name,
+    type: "hidden",
+    value: value,
+    "data-testid": testId && `${testId}--input`
+  }), jsx("div", {
+    css: datePickerContainerStyles
+  }, jsx(DatePicker, {
+    appearance: appearance,
+    "aria-describedby": datePickerAriaDescribedBy,
+    autoFocus: datePickerProps.autoFocus || autoFocus,
+    dateFormat: datePickerProps.dateFormat,
+    defaultIsOpen: datePickerProps.defaultIsOpen,
+    defaultValue: datePickerProps.defaultValue,
+    disabled: datePickerProps.disabled,
+    disabledDateFilter: datePickerProps.disabledDateFilter,
+    formatDisplayLabel: datePickerProps.formatDisplayLabel,
+    hideIcon: datePickerProps.hideIcon || true,
+    icon: datePickerProps.icon,
+    id: datePickerProps.id || id,
+    innerProps: datePickerProps.innerProps,
+    isDisabled: datePickerProps.isDisabled || isDisabled,
+    isInvalid: datePickerProps.isInvalid || isInvalid,
+    isOpen: datePickerProps.isOpen,
+    isRequired: datePickerProps.isRequired || isRequired,
+    label: datePickerLabel,
+    locale: datePickerProps.locale || locale,
+    maxDate: datePickerProps.maxDate,
+    minDate: datePickerProps.minDate,
+    name: datePickerProps.name,
+    nextMonthLabel: datePickerProps.nextMonthLabel,
+    onBlur: onDateBlur,
+    onChange: onDateChange,
+    onFocus: onDateFocus,
+    parseInputValue: datePickerProps.parseInputValue,
+    placeholder: datePickerProps.placeholder,
+    previousMonthLabel: datePickerProps.previousMonthLabel,
+    selectProps: mergedDatePickerSelectProps,
+    spacing: datePickerProps.spacing || spacing,
+    testId: testId && `${testId}--datepicker` || datePickerProps.testId,
+    value: dateValue,
+    weekStartDay: datePickerProps.weekStartDay
+  })), jsx("div", {
+    css: timePickerContainerStyles
+  }, jsx(TimePicker, {
+    appearance: timePickerProps.appearance || appearance,
+    "aria-describedby": timePickerAriaDescribedBy,
+    autoFocus: timePickerProps.autoFocus,
+    defaultIsOpen: timePickerProps.defaultIsOpen,
+    defaultValue: timePickerProps.defaultValue,
+    formatDisplayLabel: timePickerProps.formatDisplayLabel,
+    hideIcon: timePickerProps.hideIcon || true,
+    id: timePickerProps.id,
+    innerProps: timePickerProps.innerProps,
+    isDisabled: timePickerProps.isDisabled || isDisabled,
+    isInvalid: timePickerProps.isInvalid || isInvalid,
+    isOpen: timePickerProps.isOpen,
+    isRequired: timePickerProps.isRequired || isRequired,
+    label: timePickerLabel,
+    locale: timePickerProps.locale || locale,
+    name: timePickerProps.name,
+    onBlur: onTimeBlur,
+    onChange: onTimeChange,
+    onFocus: onTimeFocus,
+    parseInputValue: timePickerProps.parseInputValue,
+    placeholder: timePickerProps.placeholder,
+    selectProps: mergedTimePickerSelectProps,
+    spacing: timePickerProps.spacing || spacing,
+    testId: timePickerProps.testId || testId && `${testId}--timepicker`,
+    timeFormat: timePickerProps.timeFormat,
+    timeIsEditable: timePickerProps.timeIsEditable,
+    times: timePickerProps.times,
+    value: timeValue
+  })), isClearable && !isDisabled ? jsx("button", {
+    css: iconContainerStyles,
+    onClick: onClear,
+    "data-testid": testId && `${testId}--icon--container`,
+    tabIndex: -1,
+    type: "button"
+  }, jsx(SelectClearIcon, {
+    size: "small",
+    primaryColor: "inherit",
+    label: clearControlLabel
+  })) : null);
+});
+export default DateTimePicker;