@pingux/astro 2.70.0 → 2.71.0-alpha.1

package/lib/cjs/types/index.js

@@ -1,6 +1,6 @@
 "use strict";
 
-var _context, _context2, _context3, _context4, _context5, _context6, _context7, _context8, _context9, _context10, _context11, _context12, _context13, _context14, _context15, _context16, _context17, _context18, _context19, _context20, _context21, _context22, _context23, _context24, _context25, _context26, _context27, _context28, _context29, _context30, _context31, _context32, _context33, _context34, _context35, _context36, _context37, _context38, _context39, _context40, _context41, _context42, _context43, _context44, _context45, _context46, _context47;
+var _context, _context2, _context3, _context4, _context5, _context6, _context7, _context8, _context9, _context10, _context11, _context12, _context13, _context14, _context15, _context16, _context17, _context18, _context19, _context20, _context21, _context22, _context23, _context24, _context25, _context26, _context27, _context28, _context29, _context30, _context31, _context32, _context33, _context34, _context35, _context36, _context37, _context38, _context39, _context40, _context41, _context42, _context43, _context44, _context45, _context46, _context47, _context48;
 var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
 var _forEachInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/for-each");
 var _Object$keys = require("@babel/runtime-corejs3/core-js-stable/object/keys");
@@ -513,8 +513,19 @@ _forEachInstanceProperty(_context46 = _Object$keys(_text)).call(_context46, func
     }
   });
 });
+var _timefield = require("./timefield");
+_forEachInstanceProperty(_context47 = _Object$keys(_timefield)).call(_context47, function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _timefield[key]) return;
+  _Object$defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _timefield[key];
+    }
+  });
+});
 var _tooltipTrigger = require("./tooltipTrigger");
-_forEachInstanceProperty(_context47 = _Object$keys(_tooltipTrigger)).call(_context47, function (key) {
+_forEachInstanceProperty(_context48 = _Object$keys(_tooltipTrigger)).call(_context48, function (key) {
   if (key === "default" || key === "__esModule") return;
   if (key in exports && exports[key] === _tooltipTrigger[key]) return;
   _Object$defineProperty(exports, key, {

package/lib/cjs/types/timefield.d.ts

@@ -0,0 +1,69 @@
+import React, { FocusEvent, KeyboardEvent } from 'react';
+import { CalendarDateTime, Time, ZonedDateTime } from '@internationalized/date';
+import type { DateSegment, TimeFieldState } from '@react-stately/datepicker';
+import type { TimeValue } from '@react-types/datepicker';
+import { DOMAttributes, StyleProps } from './shared';
+export type HourCycle = 12 | 24;
+export type Granularity = 'hour' | 'minute' | 'second';
+export type ValidationBehavior = 'native' | 'aria';
+export type MappedTimeValue<T> = T extends ZonedDateTime ? ZonedDateTime : T extends CalendarDateTime ? CalendarDateTime : T extends Time ? Time : never;
+export interface TimeFieldProps extends StyleProps, DOMAttributes {
+    /** Whether to display the time in 12 or 24 hour format. Default is determined by user's locale */
+    hourCycle?: HourCycle;
+    /** Determines the smallest unit that is displayed in the time picker. */
+    granularity?: Granularity;
+    /** Whether to always show leading zeros in the hour field. */
+    shouldForceLeadingZeros?: boolean;
+    /** A placeholder time that influences the format of
+     the placeholder shown when no value is selected. */
+    placeholderValue?: TimeValue | string;
+    /** The minimum allowed time that a user may select. */
+    minValue?: TimeValue | string;
+    /** The maximum allowed time that a user may select. */
+    maxValue?: TimeValue | string;
+    /** Whether the input is disabled. */
+    isDisabled?: boolean;
+    /** Whether the input can be selected but not changed by the user. */
+    isReadOnly?: boolean;
+    /** Whether user input is required on the input before form submission. */
+    isRequired?: boolean;
+    /** Whether the input value is invalid. */
+    isInvalid?: boolean;
+    /** Whether the element should receive focus on render. */
+    autoFocus?: boolean;
+    /** The current value (controlled). */
+    value?: TimeValue | string | null;
+    /** The default value (uncontrolled). */
+    defaultValue?: TimeValue | string | null;
+    /** The name of the input element, used when submitting an HTML form. */
+    name?: string;
+    /** Whether to use native HTML form validation to prevent form submission
+     when the value is missing or invalid, or mark the field as required or invalid via ARIA. */
+    validationBehavior?: ValidationBehavior;
+    /** The content to display as the label. */
+    label?: React.ReactNode;
+    /** Handler that is called when the element receives focus. */
+    onFocus?: (e: FocusEvent) => void;
+    /** Handler that is called when the element loses focus. */
+    onBlur?: (e: FocusEvent) => void;
+    /** Handler that is called when the element's focus status changes. */
+    onFocusChange?: (isFocused: boolean) => void;
+    /** Handler that is called when a key is pressed. */
+    onKeyDown?: (e: KeyboardEvent) => void;
+    /** Handler that is called when a key is released. */
+    onKeyUp?: (e: KeyboardEvent) => void;
+    /** Handler that is called when the value changes. */
+    onChange?: (value: MappedTimeValue<TimeValue>) => void;
+    /** A slot name for the component. Slots allow the component to receive props from a parent
+     * component. An explicit null value indicates that the local props completely
+     * override all props received from a parent. */
+    slot?: string | null;
+    /** The element's unique identifier. */
+    id?: string;
+}
+export interface TimeSegmentProps {
+    state: TimeFieldState;
+    segment: DateSegment;
+    segments: DateSegment[];
+    segmentIndex: number;
+}

package/lib/cjs/types/timefield.js

@@ -0,0 +1,6 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});

package/lib/cjs/utils/designUtils/figmaLinks.d.ts

@@ -79,6 +79,9 @@ export declare const FIGMA_LINKS: {
     countryPicker: {
         default: string;
     };
+    dateTimeRangePicker: {
+        default: string;
+    };
     helpHint: {
         default: string;
         withLink: string;

package/lib/cjs/utils/designUtils/figmaLinks.js

@@ -86,6 +86,9 @@ var FIGMA_LINKS = {
   countryPicker: {
     "default": 'https://www.figma.com/file/Oa6VYtJcUJzEJuuRp0p4ls/Astro?type=design&node-id=4568-7532&mode=design&t=eSfQYHRFNPf37J4C-0'
   },
+  dateTimeRangePicker: {
+    "default": 'https://www.figma.com/design/bpbEw54gTTcdIiZs4PKK1p/Astro-Specs?node-id=49152-4497&t=n7OkhpTOBBWW4rme-0'
+  },
   helpHint: {
     "default": 'https://www.figma.com/file/Oa6VYtJcUJzEJuuRp0p4ls/Astro?type=design&node-id=0%3A4534&t=We3h7LaaFJQnxdSy-1',
     withLink: 'https://www.figma.com/file/bpbEw54gTTcdIiZs4PKK1p/Astro-Specs?type=design&node-id=28958%3A40081&mode=design&t=WmSYPx1hR8kxFiXf-1'

package/lib/components/SelectFieldBase/SelectFieldBase.js

@@ -73,7 +73,7 @@ var SelectFieldBase = /*#__PURE__*/forwardRef(function (_ref, ref) {
     variant: "forms.select"
   }, triggerProps, ariaProps, {
     "aria-describedby": helperText && helperTextId
-  }), ___EmotionJSX(Box, _extends({
+  }), slots === null || slots === void 0 ? void 0 : slots.leftOfData, ___EmotionJSX(Box, _extends({
     as: "span",
     variant: "forms.select.currentValue"
   }, valueProps), state.selectedItem ? state.selectedItem.rendered : ___EmotionJSX(Text, {
@@ -148,6 +148,8 @@ SelectFieldBase.propTypes = _objectSpread(_objectSpread({
   }),
   /** Provides a way to insert markup in specified places. */
   slots: PropTypes.shape({
+    /** The given node will be inserted before the text in field container. */
+    leftOfData: PropTypes.node,
     /** The given node will be inserted into the field container. */
     inContainer: PropTypes.node
   }),

package/lib/components/TimeField/TimeField.js

@@ -0,0 +1,92 @@
+import _Object$keys from "@babel/runtime-corejs3/core-js-stable/object/keys";
+import _Object$getOwnPropertySymbols from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols";
+import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+import _Object$getOwnPropertyDescriptor from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor";
+import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import _Object$getOwnPropertyDescriptors from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors";
+import _Object$defineProperties from "@babel/runtime-corejs3/core-js-stable/object/define-properties";
+import _Object$defineProperty from "@babel/runtime-corejs3/core-js-stable/object/define-property";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+import _objectWithoutProperties from "@babel/runtime-corejs3/helpers/esm/objectWithoutProperties";
+var _excluded = ["className", "isDisabled", "isReadOnly"];
+import _mapInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/map";
+function ownKeys(object, enumerableOnly) { var keys = _Object$keys(object); if (_Object$getOwnPropertySymbols) { var symbols = _Object$getOwnPropertySymbols(object); enumerableOnly && (symbols = _filterInstanceProperty(symbols).call(symbols, function (sym) { return _Object$getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var _context2, _context3; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context2 = ownKeys(Object(source), !0)).call(_context2, function (key) { _defineProperty(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context3 = ownKeys(Object(source))).call(_context3, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
+import React, { forwardRef, useRef } from 'react';
+import { FocusScope } from 'react-aria';
+import { parseTime, Time } from '@internationalized/date';
+import { useTimeField } from '@react-aria/datepicker';
+import { useLocale } from '@react-aria/i18n';
+import { useTimeFieldState } from '@react-stately/datepicker';
+import { useField, useLocalOrForwardRef, useStatusClasses } from '../../hooks';
+import { Box, Label } from '../../index';
+import TimeSegment from './TimeSegment';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export var parseTimeIfString = function parseTimeIfString(value) {
+  return typeof value === 'string' ? parseTime(value) : value;
+};
+var TimeField = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _state$value, _context;
+  var className = props.className,
+    isDisabled = props.isDisabled,
+    isReadOnly = props.isReadOnly,
+    others = _objectWithoutProperties(props, _excluded);
+  var _useLocale = useLocale(),
+    locale = _useLocale.locale;
+  var timeFieldRef = useLocalOrForwardRef(ref);
+  var fieldRef = useRef(null);
+  var labelRef = useRef(null);
+  var parsedTimes = {
+    value: props.value && parseTimeIfString(props.value),
+    defaultValue: props.defaultValue ? parseTimeIfString(props.defaultValue) : new Time(),
+    placeholderValue: props.placeholderValue && parseTimeIfString(props.placeholderValue),
+    minValue: props.minValue && parseTimeIfString(props.minValue),
+    maxValue: props.maxValue && parseTimeIfString(props.maxValue)
+  };
+  var state = useTimeFieldState(_objectSpread(_objectSpread(_objectSpread({}, props), parsedTimes), {}, {
+    locale: locale
+  }));
+  var _useStatusClasses = useStatusClasses(className, {
+      isDisabled: isDisabled,
+      isReadOnly: isReadOnly,
+      is24Hour: props.hourCycle === 24
+    }),
+    classNames = _useStatusClasses.classNames;
+  var _useTimeField = useTimeField(_objectSpread(_objectSpread({}, props), parsedTimes), state, fieldRef),
+    fieldProps = _useTimeField.fieldProps;
+  var _useField = useField(_objectSpread(_objectSpread({}, others), {}, {
+      value: (state === null || state === void 0 || (_state$value = state.value) === null || _state$value === void 0 ? void 0 : _state$value.toString()) || ''
+    })),
+    fieldContainerProps = _useField.fieldContainerProps,
+    fieldLabelProps = _useField.fieldLabelProps;
+  return ___EmotionJSX(Box, _extends({
+    variant: "forms.input.fieldContainer"
+  }, fieldContainerProps, {
+    ref: timeFieldRef
+  }), ___EmotionJSX(Label, _extends({}, fieldLabelProps, {
+    ref: labelRef
+  })), ___EmotionJSX(Box, {
+    isRow: true,
+    variant: "forms.input.fieldControlWrapper",
+    className: classNames
+  }, ___EmotionJSX(Box, _extends({
+    isRow: true,
+    variant: "forms.timeField.inputField"
+  }, fieldProps, {
+    ref: fieldRef,
+    className: classNames,
+    role: "group"
+  }), ___EmotionJSX(FocusScope, null, _mapInstanceProperty(_context = state.segments).call(_context, function (segment, i) {
+    return ___EmotionJSX(TimeSegment
+    // eslint-disable-next-line react/no-array-index-key
+    , {
+      key: i,
+      segment: segment,
+      state: state,
+      segments: state.segments,
+      segmentIndex: i
+    });
+  })))));
+});
+export default TimeField;

package/lib/components/TimeField/TimeField.mdx

@@ -0,0 +1,35 @@
+import { Meta } from '@storybook/addon-docs';
+
+<Meta title="Experimental/TimeField/TimeField" />
+
+# TimeField
+
+The TimeField component allows users to enter and edit time values using a keyboard. Each part of the time is displayed in individual editable segments.
+
+When using strings as props for different TimeValues, ensure that they adhere to the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
+
+This component is built on [useTimeField](https://react-spectrum.adobe.com/react-aria/useTimeField.html) from React Aria
+and [useTimeFieldState](https://react-spectrum.adobe.com/react-stately/useTimeFieldState.html) from React Stately.
+
+### Required components 
+
+This component can be used independently and does not require additional components. 
+
+#### Keyboard Navigation
+
+These keys provide additional functionality to the component.
+
+| Keys | Functions |
+| ---- | --------- |
+| Tab | Focuses the field and follows the page tab sequence. |
+| Shift + Tab | Moves focus to the previous focusable component. |
+| Up and down Arrow keys | When segments are focused, it increments and decrements time values |
+| Left and right arrows | Moves focus between segments. |
+
+#### Screen Readers
+
+This component uses the following attributes to assist screen readers:
+
+- The **`aria-label`** attribute is used to provide an accessible name.
+- The hidden input, TimeField, and all spin buttons have an **`aria-labelledby`** attribute pointing to the label ID, along with the **`aria-label`** attribute for an accessible name.
+- Each spin button has an **`aria-valuenow`**, **`aria-valuemin`**, and **`aria-valuemax`** to represent the current value, minimum allowed value, and maximum allowed value.

package/lib/components/TimeField/TimeField.stories.js

@@ -0,0 +1,75 @@
+import _slicedToArray from "@babel/runtime-corejs3/helpers/esm/slicedToArray";
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import React, { useState } from 'react';
+import DocsLayout from '../../../.storybook/storybookDocsLayout';
+import { TimeField } from '../../index';
+import TimeFieldReadme from './TimeField.mdx';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export default {
+  title: 'Experimental/TimeField',
+  component: TimeField,
+  parameters: {
+    actions: {
+      argTypesRegex: '^on.*'
+    },
+    docs: {
+      source: {
+        type: 'code'
+      },
+      page: function page() {
+        return ___EmotionJSX(React.Fragment, null, ___EmotionJSX(TimeFieldReadme, null), ___EmotionJSX(DocsLayout, null));
+      }
+    }
+  },
+  argTypes: {}
+};
+export var Default = function Default(args) {
+  return ___EmotionJSX(TimeField, _extends({}, args, {
+    "aria-label": "timefield-default"
+  }));
+};
+export var DefaultValue = function DefaultValue(args) {
+  return ___EmotionJSX(TimeField, _extends({}, args, {
+    "aria-label": "timefield-default",
+    defaultValue: "12:30"
+  }));
+};
+export var Controlled = function Controlled(args) {
+  var _useState = useState('12:30'),
+    _useState2 = _slicedToArray(_useState, 2),
+    time = _useState2[0],
+    setTime = _useState2[1];
+  var onChangeHandler = function onChangeHandler(value) {
+    return setTime(value.toString());
+  };
+  return ___EmotionJSX(TimeField, _extends({}, args, {
+    "aria-label": "timefield-default",
+    value: time,
+    onChange: onChangeHandler
+  }));
+};
+export var Disabled = function Disabled(args) {
+  return ___EmotionJSX(TimeField, _extends({}, args, {
+    "aria-label": "timefield-default",
+    isDisabled: true
+  }));
+};
+export var ReadOnly = function ReadOnly(args) {
+  return ___EmotionJSX(TimeField, _extends({}, args, {
+    "aria-label": "timefield-default",
+    isReadOnly: true
+  }));
+};
+export var Required = function Required(args) {
+  return ___EmotionJSX(TimeField, _extends({}, args, {
+    "aria-label": "timefield-default",
+    isRequired: true,
+    label: "Example label"
+  }));
+};
+export var WithLabel = function WithLabel(args) {
+  return ___EmotionJSX(TimeField, _extends({}, args, {
+    label: "Loren Ipsum",
+    "aria-label": "timefield-default"
+  }));
+};

package/lib/components/TimeField/TimeField.styles.js

@@ -0,0 +1,39 @@
+import _Object$keys from "@babel/runtime-corejs3/core-js-stable/object/keys";
+import _Object$getOwnPropertySymbols from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols";
+import _filterInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/filter";
+import _Object$getOwnPropertyDescriptor from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor";
+import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import _Object$getOwnPropertyDescriptors from "@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors";
+import _Object$defineProperties from "@babel/runtime-corejs3/core-js-stable/object/define-properties";
+import _Object$defineProperty from "@babel/runtime-corejs3/core-js-stable/object/define-property";
+import _defineProperty from "@babel/runtime-corejs3/helpers/esm/defineProperty";
+function ownKeys(object, enumerableOnly) { var keys = _Object$keys(object); if (_Object$getOwnPropertySymbols) { var symbols = _Object$getOwnPropertySymbols(object); enumerableOnly && (symbols = _filterInstanceProperty(symbols).call(symbols, function (sym) { return _Object$getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var _context, _context2; var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? _forEachInstanceProperty(_context = ownKeys(Object(source), !0)).call(_context, function (key) { _defineProperty(target, key, source[key]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(target, _Object$getOwnPropertyDescriptors(source)) : _forEachInstanceProperty(_context2 = ownKeys(Object(source))).call(_context2, function (key) { _Object$defineProperty(target, key, _Object$getOwnPropertyDescriptor(source, key)); }); } return target; }
+import { defaultFocus, input } from '../Input/Input.styles';
+var inputField = _objectSpread(_objectSpread({}, input), {}, {
+  minWidth: '100px',
+  width: 'auto',
+  position: 'relative',
+  '&:focus-within:not(.is-read-only)': _objectSpread({}, defaultFocus),
+  ':hover': {
+    cursor: 'text'
+  },
+  '&.is-read-only': {
+    backgroundColor: 'accent.95',
+    border: 'none'
+  },
+  '&.is-24-hour': {
+    minWidth: '0px'
+  }
+});
+var segment = {
+  '&:focus-visible': {
+    outline: '1px solid',
+    outlineColor: 'active',
+    borderRadius: 4
+  }
+};
+export default {
+  inputField: inputField,
+  segment: segment
+};

package/lib/components/TimeField/TimeField.test.js

@@ -0,0 +1,191 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import _forEachInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/for-each";
+import React from 'react';
+import { Time } from '@internationalized/date';
+import { parseTimeIfString, TimeField } from '../../index';
+import { act, fireEvent, render, screen } from '../../utils/testUtils/testWrapper';
+import { universalComponentTests } from '../../utils/testUtils/universalComponentTest';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var getComponent = function getComponent() {
+  var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  return render(___EmotionJSX(TimeField, _extends({}, props, {
+    "aria-label": "TimeField"
+  })));
+};
+
+// Needs to be added to each components test file.
+universalComponentTests({
+  renderComponent: function renderComponent(props) {
+    return ___EmotionJSX(TimeField, _extends({}, props, {
+      "aria-label": "TimeField"
+    }));
+  }
+});
+test('renders TimeField component', function () {
+  getComponent();
+  expect(screen.getByRole('group')).toBeInTheDocument();
+});
+test('renders the correct number of time segments', function () {
+  getComponent();
+  var timeSegments = screen.getAllByRole('spinbutton');
+  expect(timeSegments.length).toBe(3);
+});
+test('renders the correct number of time segments when granularity is set to seconds', function () {
+  getComponent({
+    granularity: 'second'
+  });
+  var timeSegments = screen.getAllByRole('spinbutton');
+  expect(timeSegments.length).toBe(4);
+});
+test('renders the correct number of time segments when hourCycle is set to 24', function () {
+  getComponent({
+    hourCycle: 24
+  });
+  var timeSegments = screen.getAllByRole('spinbutton');
+  expect(timeSegments.length).toBe(2);
+});
+test('renders the correct number of time segments when hourCycle is set to 24 and granularity is set to seconds', function () {
+  getComponent({
+    hourCycle: 24,
+    granularity: 'second'
+  });
+  var timeSegments = screen.getAllByRole('spinbutton');
+  expect(timeSegments.length).toBe(3);
+});
+test('renders the correct time with defaultValue', function () {
+  var defaultValue = new Time(3);
+  getComponent({
+    defaultValue: defaultValue
+  });
+  var timeSegments = screen.getAllByRole('spinbutton');
+  expect(timeSegments[0]).toHaveTextContent('3');
+  expect(timeSegments[1]).toHaveTextContent('00');
+  expect(timeSegments[2]).toHaveTextContent('AM');
+});
+test('renders the correct time with controlled value', function () {
+  var value = new Time(3);
+  getComponent({
+    value: value
+  });
+  var timeSegments = screen.getAllByRole('spinbutton');
+  expect(timeSegments[0]).toHaveTextContent('3');
+  expect(timeSegments[1]).toHaveTextContent('00');
+  expect(timeSegments[2]).toHaveTextContent('AM');
+});
+test('renders TimeField component with isDisabled', function () {
+  getComponent({
+    isDisabled: true
+  });
+  var timeSegments = screen.getAllByRole('spinbutton');
+  _forEachInstanceProperty(timeSegments).call(timeSegments, function (segment) {
+    expect(segment).toHaveAttribute('aria-disabled', 'true');
+  });
+});
+test('renders TimeField component with isReadOnly', function () {
+  getComponent({
+    isReadOnly: true
+  });
+  var timeSegments = screen.getAllByRole('spinbutton');
+  _forEachInstanceProperty(timeSegments).call(timeSegments, function (segment) {
+    expect(segment).toHaveAttribute('aria-readonly', 'true');
+  });
+});
+test('should handle autofocus when deleting segments from left to right', function () {
+  var defaultValue = new Time(12, 30);
+  getComponent({
+    defaultValue: defaultValue
+  });
+  var timeSegments = screen.queryAllByRole('spinbutton');
+  var hour = timeSegments[0];
+  var minute = timeSegments[1];
+  var period = timeSegments[2];
+  expect(hour).toHaveTextContent('12');
+  expect(minute).toHaveTextContent('30');
+  expect(period).toHaveTextContent('PM');
+  act(function () {
+    hour.focus();
+  });
+  for (var i = 0; i < 2; i += 1) {
+    fireEvent.keyDown(hour, {
+      key: 'Backspace'
+    });
+    fireEvent.keyUp(hour, {
+      key: 'Backspace'
+    });
+  }
+  expect(minute).toHaveFocus();
+});
+test('should handle autofocus when deleting segments from right to left', function () {
+  var defaultValue = new Time(12, 30);
+  getComponent({
+    defaultValue: defaultValue
+  });
+  var timeSegments = screen.queryAllByRole('spinbutton');
+  var hour = timeSegments[0];
+  var minute = timeSegments[1];
+  var period = timeSegments[2];
+  expect(hour).toHaveTextContent('12');
+  expect(minute).toHaveTextContent('30');
+  expect(period).toHaveTextContent('PM');
+  act(function () {
+    minute.focus();
+  });
+  for (var i = 0; i < 2; i += 1) {
+    fireEvent.keyDown(minute, {
+      key: 'Backspace'
+    });
+    fireEvent.keyUp(minute, {
+      key: 'Backspace'
+    });
+  }
+  expect(hour).toHaveFocus();
+});
+describe('parseTimeIfString', function () {
+  it('should parse a time with only hours', function () {
+    var time = parseTimeIfString('14');
+    var expected = new Time(14);
+    expect(time).toEqual(expected);
+  });
+  it('should parse a padded time with only hours', function () {
+    var time = parseTimeIfString('04');
+    var expected = new Time(4);
+    expect(time).toEqual(expected);
+  });
+  it('should parse a time with hours and minutes', function () {
+    var time = parseTimeIfString('14:05');
+    var expected = new Time(14, 5);
+    expect(time).toEqual(expected);
+  });
+  it('should parse a time with hours, minutes, and seconds', function () {
+    var time = parseTimeIfString('14:05:25');
+    var expected = new Time(14, 5, 25);
+    expect(time).toEqual(expected);
+  });
+  it('should parse a time with hours, minutes, seconds, and milliseconds', function () {
+    var time = parseTimeIfString('14:05:25.1');
+    var expected = new Time(14, 5, 25, 100);
+    expect(time).toEqual(expected);
+    time = parseTimeIfString('14:05:25.12');
+    expected = new Time(14, 5, 25, 120);
+    expect(time).toEqual(expected);
+  });
+  it('should error if time is not padded', function () {
+    expect(function () {
+      return parseTimeIfString('1');
+    }).toThrow();
+    expect(function () {
+      return parseTimeIfString('01:4');
+    }).toThrow();
+  });
+  it('should error if components are out of range', function () {
+    expect(function () {
+      return parseTimeIfString('45:23');
+    }).toThrow();
+    expect(function () {
+      return parseTimeIfString('12:99');
+    }).toThrow();
+    expect(function () {
+      return parseTimeIfString('12:45:99');
+    }).toThrow();
+  });
+});

package/lib/components/TimeField/TimeSegment.js

@@ -0,0 +1,50 @@
+import _extends from "@babel/runtime-corejs3/helpers/esm/extends";
+import React, { useCallback, useRef } from 'react';
+import { useFocusManager } from 'react-aria';
+import { useDateSegment } from '@react-aria/datepicker';
+import { Box } from '../../index';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var TimeSegment = function TimeSegment(props) {
+  var state = props.state,
+    segment = props.segment,
+    segments = props.segments,
+    segmentIndex = props.segmentIndex;
+  var text = segment.text,
+    isPlaceholder = segment.isPlaceholder;
+  var ref = useRef(null);
+  var _useDateSegment = useDateSegment(segment, state, ref),
+    segmentProps = _useDateSegment.segmentProps;
+  delete segmentProps.role;
+  var focusManager = useFocusManager();
+  var handleKeyEvents = useCallback(function (e) {
+    var getSegmentValue = function getSegmentValue(seg) {
+      if (!seg) return false;
+      var isNumber = /^\d+$/.test(seg.text);
+      return isNumber;
+    };
+    if (e.key === 'Backspace' && isPlaceholder) {
+      var nextSegmentIndex = segmentIndex + 1;
+      while (segments[nextSegmentIndex] && segments[nextSegmentIndex].type === 'literal') {
+        nextSegmentIndex += 1;
+      }
+      var nextSegment = segments[nextSegmentIndex];
+      var previousSegmentIndex = segmentIndex - 1;
+      while (segments[previousSegmentIndex] && segments[previousSegmentIndex].type === 'literal') {
+        previousSegmentIndex -= 1;
+      }
+      var previousSegment = segments[previousSegmentIndex];
+      if (getSegmentValue(nextSegment)) return focusManager.focusNext();
+      if (!getSegmentValue(nextSegment) && getSegmentValue(previousSegment)) {
+        return focusManager.focusPrevious();
+      }
+    }
+    return null;
+  }, [focusManager, isPlaceholder, segments, segmentIndex]);
+  return ___EmotionJSX(Box, _extends({}, segmentProps, {
+    ref: ref,
+    variant: "forms.timeField.segment",
+    onKeyUp: handleKeyEvents,
+    role: "spinbutton"
+  }), text);
+};
+export default TimeSegment;

package/lib/components/TimeField/index.js

@@ -0,0 +1,2 @@
+export { default } from './TimeField';
+export * from './TimeField';

package/lib/index.js

@@ -180,6 +180,8 @@ export { default as TextAreaField } from './components/TextAreaField';
 export * from './components/TextAreaField';
 export { default as TextField } from './components/TextField';
 export * from './components/TextField';
+export { default as TimeField } from './components/TimeField';
+export * from './components/TimeField';
 export { default as TimeZonePicker } from './components/TimeZonePicker';
 export { default as TooltipTrigger } from './components/TooltipTrigger';
 export * from './components/TooltipTrigger';