@pingux/astro 2.70.0 → 2.71.0-alpha.1

package/lib/cjs/components/SelectFieldBase/SelectFieldBase.js

@@ -83,7 +83,7 @@ var SelectFieldBase = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     variant: "forms.select"
   }, triggerProps, ariaProps, {
     "aria-describedby": helperText && helperTextId
-  }), (0, _react2.jsx)(_Box["default"], (0, _extends2["default"])({
+  }), slots === null || slots === void 0 ? void 0 : slots.leftOfData, (0, _react2.jsx)(_Box["default"], (0, _extends2["default"])({
     as: "span",
     variant: "forms.select.currentValue"
   }, valueProps), state.selectedItem ? state.selectedItem.rendered : (0, _react2.jsx)(_Text["default"], {
@@ -158,6 +158,8 @@ SelectFieldBase.propTypes = _objectSpread(_objectSpread({
   }),
   /** Provides a way to insert markup in specified places. */
   slots: _propTypes["default"].shape({
+    /** The given node will be inserted before the text in field container. */
+    leftOfData: _propTypes["default"].node,
     /** The given node will be inserted into the field container. */
     inContainer: _propTypes["default"].node
   }),

package/lib/cjs/components/TimeField/TimeField.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { Time } from '@internationalized/date';
+import type { TimeValue } from '@react-types/datepicker';
+import { TimeFieldProps } from '../../types';
+export declare const parseTimeIfString: (value: TimeValue | string) => TimeValue | Time;
+declare const TimeField: React.ForwardRefExoticComponent<TimeFieldProps & React.RefAttributes<HTMLDivElement>>;
+export default TimeField;

package/lib/cjs/components/TimeField/TimeField.js

@@ -0,0 +1,105 @@
+"use strict";
+
+var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _Object$keys = require("@babel/runtime-corejs3/core-js-stable/object/keys");
+var _Object$getOwnPropertySymbols = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols");
+var _filterInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/filter");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+var _forEachInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/for-each");
+var _Object$getOwnPropertyDescriptors = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors");
+var _Object$defineProperties = require("@babel/runtime-corejs3/core-js-stable/object/define-properties");
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _WeakMap = require("@babel/runtime-corejs3/core-js-stable/weak-map");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.parseTimeIfString = exports["default"] = void 0;
+var _map = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/map"));
+var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/objectWithoutProperties"));
+var _react = _interopRequireWildcard(require("react"));
+var _reactAria = require("react-aria");
+var _date = require("@internationalized/date");
+var _datepicker = require("@react-aria/datepicker");
+var _i18n = require("@react-aria/i18n");
+var _datepicker2 = require("@react-stately/datepicker");
+var _hooks = require("../../hooks");
+var _index = require("../../index");
+var _TimeSegment = _interopRequireDefault(require("./TimeSegment"));
+var _react2 = require("@emotion/react");
+var _excluded = ["className", "isDisabled", "isReadOnly"];
+function _getRequireWildcardCache(nodeInterop) { if (typeof _WeakMap !== "function") return null; var cacheBabelInterop = new _WeakMap(); var cacheNodeInterop = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = _Object$defineProperty && _Object$getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? _Object$getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { _Object$defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+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) { (0, _defineProperty2["default"])(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; }
+var parseTimeIfString = function parseTimeIfString(value) {
+  return typeof value === 'string' ? (0, _date.parseTime)(value) : value;
+};
+exports.parseTimeIfString = parseTimeIfString;
+var TimeField = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
+  var _state$value, _context;
+  var className = props.className,
+    isDisabled = props.isDisabled,
+    isReadOnly = props.isReadOnly,
+    others = (0, _objectWithoutProperties2["default"])(props, _excluded);
+  var _useLocale = (0, _i18n.useLocale)(),
+    locale = _useLocale.locale;
+  var timeFieldRef = (0, _hooks.useLocalOrForwardRef)(ref);
+  var fieldRef = (0, _react.useRef)(null);
+  var labelRef = (0, _react.useRef)(null);
+  var parsedTimes = {
+    value: props.value && parseTimeIfString(props.value),
+    defaultValue: props.defaultValue ? parseTimeIfString(props.defaultValue) : new _date.Time(),
+    placeholderValue: props.placeholderValue && parseTimeIfString(props.placeholderValue),
+    minValue: props.minValue && parseTimeIfString(props.minValue),
+    maxValue: props.maxValue && parseTimeIfString(props.maxValue)
+  };
+  var state = (0, _datepicker2.useTimeFieldState)(_objectSpread(_objectSpread(_objectSpread({}, props), parsedTimes), {}, {
+    locale: locale
+  }));
+  var _useStatusClasses = (0, _hooks.useStatusClasses)(className, {
+      isDisabled: isDisabled,
+      isReadOnly: isReadOnly,
+      is24Hour: props.hourCycle === 24
+    }),
+    classNames = _useStatusClasses.classNames;
+  var _useTimeField = (0, _datepicker.useTimeField)(_objectSpread(_objectSpread({}, props), parsedTimes), state, fieldRef),
+    fieldProps = _useTimeField.fieldProps;
+  var _useField = (0, _hooks.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 (0, _react2.jsx)(_index.Box, (0, _extends2["default"])({
+    variant: "forms.input.fieldContainer"
+  }, fieldContainerProps, {
+    ref: timeFieldRef
+  }), (0, _react2.jsx)(_index.Label, (0, _extends2["default"])({}, fieldLabelProps, {
+    ref: labelRef
+  })), (0, _react2.jsx)(_index.Box, {
+    isRow: true,
+    variant: "forms.input.fieldControlWrapper",
+    className: classNames
+  }, (0, _react2.jsx)(_index.Box, (0, _extends2["default"])({
+    isRow: true,
+    variant: "forms.timeField.inputField"
+  }, fieldProps, {
+    ref: fieldRef,
+    className: classNames,
+    role: "group"
+  }), (0, _react2.jsx)(_reactAria.FocusScope, null, (0, _map["default"])(_context = state.segments).call(_context, function (segment, i) {
+    return (0, _react2.jsx)(_TimeSegment["default"]
+    // eslint-disable-next-line react/no-array-index-key
+    , {
+      key: i,
+      segment: segment,
+      state: state,
+      segments: state.segments,
+      segmentIndex: i
+    });
+  })))));
+});
+var _default = TimeField;
+exports["default"] = _default;

package/lib/cjs/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/cjs/components/TimeField/TimeField.stories.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import { StoryFn } from '@storybook/react';
+import { TimeFieldProps } from '../../types';
+declare const _default: {
+    title: string;
+    component: React.ForwardRefExoticComponent<TimeFieldProps & React.RefAttributes<HTMLDivElement>>;
+    parameters: {
+        actions: {
+            argTypesRegex: string;
+        };
+        docs: {
+            source: {
+                type: string;
+            };
+            page: () => React.JSX.Element;
+        };
+    };
+    argTypes: {};
+};
+export default _default;
+export declare const Default: StoryFn<TimeFieldProps>;
+export declare const DefaultValue: StoryFn<TimeFieldProps>;
+export declare const Controlled: StoryFn<TimeFieldProps>;
+export declare const Disabled: StoryFn<TimeFieldProps>;
+export declare const ReadOnly: StoryFn<TimeFieldProps>;
+export declare const Required: StoryFn<TimeFieldProps>;
+export declare const WithLabel: StoryFn<TimeFieldProps>;

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

@@ -0,0 +1,96 @@
+"use strict";
+
+var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _WeakMap = require("@babel/runtime-corejs3/core-js-stable/weak-map");
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.WithLabel = exports.Required = exports.ReadOnly = exports.Disabled = exports.DefaultValue = exports.Default = exports.Controlled = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/slicedToArray"));
+var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
+var _react = _interopRequireWildcard(require("react"));
+var _storybookDocsLayout = _interopRequireDefault(require("../../../.storybook/storybookDocsLayout"));
+var _index = require("../../index");
+var _TimeField = _interopRequireDefault(require("./TimeField.mdx"));
+var _react2 = require("@emotion/react");
+function _getRequireWildcardCache(nodeInterop) { if (typeof _WeakMap !== "function") return null; var cacheBabelInterop = new _WeakMap(); var cacheNodeInterop = new _WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = _Object$defineProperty && _Object$getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? _Object$getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { _Object$defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+var _default = {
+  title: 'Experimental/TimeField',
+  component: _index.TimeField,
+  parameters: {
+    actions: {
+      argTypesRegex: '^on.*'
+    },
+    docs: {
+      source: {
+        type: 'code'
+      },
+      page: function page() {
+        return (0, _react2.jsx)(_react["default"].Fragment, null, (0, _react2.jsx)(_TimeField["default"], null), (0, _react2.jsx)(_storybookDocsLayout["default"], null));
+      }
+    }
+  },
+  argTypes: {}
+};
+exports["default"] = _default;
+var Default = function Default(args) {
+  return (0, _react2.jsx)(_index.TimeField, (0, _extends2["default"])({}, args, {
+    "aria-label": "timefield-default"
+  }));
+};
+exports.Default = Default;
+var DefaultValue = function DefaultValue(args) {
+  return (0, _react2.jsx)(_index.TimeField, (0, _extends2["default"])({}, args, {
+    "aria-label": "timefield-default",
+    defaultValue: "12:30"
+  }));
+};
+exports.DefaultValue = DefaultValue;
+var Controlled = function Controlled(args) {
+  var _useState = (0, _react.useState)('12:30'),
+    _useState2 = (0, _slicedToArray2["default"])(_useState, 2),
+    time = _useState2[0],
+    setTime = _useState2[1];
+  var onChangeHandler = function onChangeHandler(value) {
+    return setTime(value.toString());
+  };
+  return (0, _react2.jsx)(_index.TimeField, (0, _extends2["default"])({}, args, {
+    "aria-label": "timefield-default",
+    value: time,
+    onChange: onChangeHandler
+  }));
+};
+exports.Controlled = Controlled;
+var Disabled = function Disabled(args) {
+  return (0, _react2.jsx)(_index.TimeField, (0, _extends2["default"])({}, args, {
+    "aria-label": "timefield-default",
+    isDisabled: true
+  }));
+};
+exports.Disabled = Disabled;
+var ReadOnly = function ReadOnly(args) {
+  return (0, _react2.jsx)(_index.TimeField, (0, _extends2["default"])({}, args, {
+    "aria-label": "timefield-default",
+    isReadOnly: true
+  }));
+};
+exports.ReadOnly = ReadOnly;
+var Required = function Required(args) {
+  return (0, _react2.jsx)(_index.TimeField, (0, _extends2["default"])({}, args, {
+    "aria-label": "timefield-default",
+    isRequired: true,
+    label: "Example label"
+  }));
+};
+exports.Required = Required;
+var WithLabel = function WithLabel(args) {
+  return (0, _react2.jsx)(_index.TimeField, (0, _extends2["default"])({}, args, {
+    label: "Loren Ipsum",
+    "aria-label": "timefield-default"
+  }));
+};
+exports.WithLabel = WithLabel;