@airtable/blocks 0.0.0-experimental-20e3506bd-20250428

package/dist/cjs/base/ui/select_and_select_buttons_helpers.js

@@ -0,0 +1,85 @@
+"use strict";
+
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.symbol.description.js");
+require("core-js/modules/es.array.from.js");
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.array.slice.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.regexp.exec.js");
+require("core-js/modules/es.regexp.to-string.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isSelectOptionValue = isSelectOptionValue;
+exports.optionValueToString = optionValueToString;
+exports.selectOptionValuePropType = void 0;
+exports.stringToOptionValue = stringToOptionValue;
+exports.validateOptions = void 0;
+var _propTypes = _interopRequireDefault(require("prop-types"));
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; } /** @module @airtable/blocks/ui: Select */ /** */
+// JSON stringify the value so you can use any primitive.
+// Regular <select> coerces all values to string, which is confusing.
+/**
+ * Supported value types for {@link SelectOption}.
+ */
+
+/** @internal */
+function isSelectOptionValue(value) {
+  return value === null || value === undefined || typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';
+}
+
+/**
+ * A select option for {@link Select}, {@link TablePicker}, {@link ViewPicker}, {@link FieldPicker}, and their `Synced` counterparts.
+ */
+
+// We cast the following prop type because we allow `null` as a valid option.
+var selectOptionValuePropType = exports.selectOptionValuePropType = _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number, _propTypes.default.bool]);
+var validateOptions = options => {
+  if (options) {
+    var _iterator = _createForOfIteratorHelper(options),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var option = _step.value;
+        // These are hard errors because we can't guarantee that other values
+        // will be JSON-encodable. And undefined gets coerced to the string
+        // "undefined" which is confusing.
+        if (typeof option.value === 'object' && option.value !== null) {
+          return {
+            isValid: false,
+            reason: 'option value must be a string, number, boolean, null, or undefined. Got an object.'
+          };
+        }
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+  }
+  return {
+    isValid: true
+  };
+};
+
+/** @internal */
+exports.validateOptions = validateOptions;
+function optionValueToString(value) {
+  var valueJson = JSON.stringify(value === undefined ? {
+    isUndefined: true
+  } : {
+    notUndefinedValue: value
+  });
+  return valueJson;
+}
+/** @internal */
+function stringToOptionValue(valueJson) {
+  var parsed = JSON.parse(valueJson);
+  var value = parsed.isUndefined ? null : parsed.notUndefinedValue;
+  return value;
+}

package/dist/cjs/base/ui/select_buttons.js

@@ -0,0 +1,192 @@
+"use strict";
+
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.array.filter.js");
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.object.get-own-property-descriptors.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.weak-map.js");
+require("core-js/modules/web.dom-collections.for-each.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sharedSelectButtonsPropTypes = exports.selectButtonsStylePropTypes = exports.default = void 0;
+require("core-js/modules/es.array.concat.js");
+require("core-js/modules/es.array.map.js");
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _emotion = require("emotion");
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _core = require("@styled-system/core");
+var _error_utils = require("../../shared/error_utils");
+var _private_utils = require("../../shared/private_utils");
+var _select_and_select_buttons_helpers = require("./select_and_select_buttons_helpers");
+var _use_styled_system = _interopRequireDefault(require("./use_styled_system"));
+var _use_theme = _interopRequireDefault(require("./theme/use_theme"));
+var _css_helpers = _interopRequireDefault(require("./css_helpers"));
+var _system = require("./system");
+var _tooltip_anchor_props = require("./types/tooltip_anchor_props");
+var _control_sizes = require("./control_sizes");
+var _excluded = ["className", "style", "options", "disabled", "value", "size", "onChange", "onMouseEnter", "onMouseLeave", "onClick", "hasOnClick", "aria-describedby", "aria-labelledby"];
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /** @module @airtable/blocks/ui: SelectButtons */ /** */
+/** @internal */
+
+var SelectButtonsVariant = (0, _private_utils.createEnum)('default');
+
+/** @internal */
+function useSelectButtonsVariant() {
+  var variant = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : SelectButtonsVariant.default;
+  var _useTheme = (0, _use_theme.default)(),
+    selectButtonsVariants = _useTheme.selectButtonsVariants;
+  return selectButtonsVariants[variant];
+}
+
+/**
+ * Style props shared between the {@link SelectButtons} and {@link SelectButtonsSynced} components. Accepts:
+ * * {@link FlexItemSetProps}
+ * * {@link MarginProps}
+ * * {@link MaxWidthProps}
+ * * {@link MinWidthProps}
+ * * {@link PositionSetProps}
+ * * {@link WidthProps}
+ *
+ * @noInheritDoc
+ */
+
+var styleParser = (0, _core.compose)(_system.maxWidth, _system.minWidth, _system.width, _system.flexItemSet, _system.positionSet, _system.margin);
+var selectButtonsStylePropTypes = exports.selectButtonsStylePropTypes = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, _system.maxWidthPropTypes), _system.minWidthPropTypes), _system.widthPropTypes), _system.flexItemSetPropTypes), _system.positionSetPropTypes), _system.marginPropTypes);
+
+/**
+ * Props shared between the {@link SelectButtons} and {@link SelectButtonsSynced} components.
+ *
+ * @noInheritDoc
+ */
+
+var sharedSelectButtonsPropTypes = exports.sharedSelectButtonsPropTypes = _objectSpread(_objectSpread(_objectSpread({
+  // We do more strict checks in render.
+  options: _propTypes.default.arrayOf(_propTypes.default.shape({
+    value: _select_and_select_buttons_helpers.selectOptionValuePropType,
+    label: _propTypes.default.node.isRequired,
+    disabled: _propTypes.default.bool
+  }).isRequired).isRequired,
+  onChange: _propTypes.default.func,
+  disabled: _propTypes.default.bool,
+  size: _control_sizes.controlSizePropType,
+  className: _propTypes.default.string,
+  style: _propTypes.default.object,
+  'aria-labelledby': _propTypes.default.string,
+  'aria-describedby': _propTypes.default.string
+}, selectButtonsStylePropTypes), _tooltip_anchor_props.tooltipAnchorPropTypes), selectButtonsStylePropTypes);
+
+/**
+ * Props for the {@link SelectButtons} component. Also accepts:
+ * * {@link SelectButtonsStyleProps}
+ *
+ * @docsPath UI/components/SelectButtons
+ */
+
+/**
+ * A segmented control for selecting one value from a set of options.
+ *
+ * [[ Story id="selectbuttons--example" title="Select buttons example" ]]
+ *
+ * @docsPath UI/components/SelectButtons
+ * @component
+ */
+var SelectButtons = (props, ref) => {
+  var className = props.className,
+    style = props.style,
+    options = props.options,
+    disabled = props.disabled,
+    value = props.value,
+    _props$size = props.size,
+    size = _props$size === void 0 ? _control_sizes.ControlSize.default : _props$size,
+    onChange = props.onChange,
+    onMouseEnter = props.onMouseEnter,
+    onMouseLeave = props.onMouseLeave,
+    onClick = props.onClick,
+    hasOnClick = props.hasOnClick,
+    ariaDescribedBy = props['aria-describedby'],
+    ariaLabelledBy = props['aria-labelledby'],
+    styleProps = (0, _objectWithoutProperties2.default)(props, _excluded);
+  // There is only a single default variant.
+  var _useSelectButtonsVari = useSelectButtonsVariant(),
+    containerClassNameForVariant = _useSelectButtonsVari.containerClassNameForVariant,
+    optionClassNameForVariant = _useSelectButtonsVari.optionClassNameForVariant;
+  var containerClassNameForSize = (0, _control_sizes.useSelectButtonsSize)(size);
+  var classNameForStyleProps = (0, _use_styled_system.default)(_objectSpread({
+    width: '100%'
+  }, styleProps), styleParser);
+  var _useState = (0, _react.useState)((0, _private_utils.getLocallyUniqueId)('sb-')),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 1),
+    generatedId = _useState2[0];
+  var _useState3 = (0, _react.useState)(false),
+    _useState4 = (0, _slicedToArray2.default)(_useState3, 2),
+    isFocused = _useState4[0],
+    setIsFocused = _useState4[1];
+  (0, _react.useEffect)(() => {
+    // Check options here for a cleaner stack trace.
+    // Also, even though options are required, still check if it's set because
+    // the error is really ugly and covers up the prop type check.
+    var validationResult = (0, _select_and_select_buttons_helpers.validateOptions)(options);
+    if (!validationResult.isValid) {
+      throw (0, _error_utils.spawnError)('<SelectButtons> %s', validationResult.reason);
+    }
+  }, [options]);
+  function _onChange(newValue) {
+    if (onChange) {
+      if (newValue !== value) {
+        onChange(newValue);
+      }
+    }
+  }
+  return /*#__PURE__*/_react.default.createElement("div", {
+    // TODO (stephen): remove tooltip anchor props
+    ref: ref,
+    onMouseEnter: onMouseEnter,
+    onMouseLeave: onMouseLeave,
+    onClick: onClick,
+    onFocus: () => setIsFocused(true),
+    onBlur: () => setIsFocused(false),
+    className: (0, _emotion.cx)(containerClassNameForSize, containerClassNameForVariant, classNameForStyleProps, className),
+    style: style,
+    "data-disabled": disabled,
+    "data-focused": isFocused,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-describedby": ariaDescribedBy
+  }, options.map((option, index) => {
+    var isSelected = option.value === value;
+    var isOptionDisabled = disabled || option.disabled;
+    var radioId = "".concat(generatedId, "-").concat(index);
+    var valueJson = (0, _select_and_select_buttons_helpers.optionValueToString)(option.value);
+    return /*#__PURE__*/_react.default.createElement("div", {
+      key: "".concat(valueJson, "-").concat(option.label, "-").concat(index),
+      className: optionClassNameForVariant
+    }, /*#__PURE__*/_react.default.createElement("input", {
+      type: "radio",
+      onChange: isOptionDisabled ? undefined : () => _onChange(option.value),
+      disabled: !!isOptionDisabled,
+      checked: isSelected,
+      className: _css_helpers.default.VISUALLY_HIDDEN,
+      id: radioId,
+      name: generatedId
+    }), /*#__PURE__*/_react.default.createElement("label", {
+      htmlFor: radioId
+    }, /*#__PURE__*/_react.default.createElement("span", {
+      className: _css_helpers.default.TRUNCATE
+    }, option.label)));
+  }));
+};
+var ForwardedRefSelectButtons = /*#__PURE__*/_react.default.forwardRef(SelectButtons);
+ForwardedRefSelectButtons.propTypes = _objectSpread({
+  value: _select_and_select_buttons_helpers.selectOptionValuePropType
+}, sharedSelectButtonsPropTypes);
+ForwardedRefSelectButtons.displayName = 'SelectButtons';
+var _default = exports.default = ForwardedRefSelectButtons;

package/dist/cjs/base/ui/select_buttons_synced.js

@@ -0,0 +1,84 @@
+"use strict";
+
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.array.filter.js");
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.object.get-own-property-descriptors.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.weak-map.js");
+require("core-js/modules/web.dom-collections.for-each.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var React = _interopRequireWildcard(require("react"));
+var _error_utils = require("../../shared/error_utils");
+var _use_synced = _interopRequireDefault(require("../../shared/ui/use_synced"));
+var _global_config_synced_component_helpers = _interopRequireDefault(require("../../shared/ui/global_config_synced_component_helpers"));
+var _select_buttons = _interopRequireWildcard(require("./select_buttons"));
+var _excluded = ["globalConfigKey", "onChange", "disabled"];
+/** @module @airtable/blocks/ui: SelectButtons */
+/** */
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/**
+ * Props for the {@link SelectButtonsSynced} component. Also accepts:
+ * * {@link SelectButtonsStyleProps}
+ *
+ * @docsPath UI/components/SelectButtonsSynced
+ * @groupPath UI/components/SelectButtons
+ */
+
+/**
+ *  A wrapper around the {@link SelectButtons} component that syncs with {@link GlobalConfig}.
+ *
+ * [[ Story id="selectbuttons--synced-example" title="SelectButtonsSynced example" ]]
+ *
+ * @docsPath UI/components/SelectButtonsSynced
+ * @groupPath UI/components/SelectButtons
+ * @component
+ */
+var SelectButtonsSynced = (props, ref) => {
+  var globalConfigKey = props.globalConfigKey,
+    _onChange = props.onChange,
+    disabled = props.disabled,
+    restOfProps = (0, _objectWithoutProperties2.default)(props, _excluded);
+  var _useSynced = (0, _use_synced.default)(globalConfigKey),
+    _useSynced2 = (0, _slicedToArray2.default)(_useSynced, 3),
+    value = _useSynced2[0],
+    setValue = _useSynced2[1],
+    canSetValue = _useSynced2[2];
+  var selectValue;
+  if (value === null || value === undefined) {
+    selectValue = null;
+  } else if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+    selectValue = value;
+  } else {
+    throw (0, _error_utils.spawnError)('SelectButtonsSynced only works with a global config value that is a string, number, boolean, null or undefined.');
+  }
+  return /*#__PURE__*/React.createElement(_select_buttons.default, (0, _extends2.default)({}, restOfProps, {
+    ref: ref,
+    value: selectValue,
+    onChange: newValue => {
+      setValue(newValue);
+      if (_onChange) {
+        _onChange(newValue);
+      }
+    },
+    disabled: disabled || !canSetValue
+  }));
+};
+var ForwardedRefSelectButtonsSynced = /*#__PURE__*/React.forwardRef(SelectButtonsSynced);
+ForwardedRefSelectButtonsSynced.propTypes = _objectSpread({
+  globalConfigKey: _global_config_synced_component_helpers.default.globalConfigKeyPropType
+}, _select_buttons.sharedSelectButtonsPropTypes);
+ForwardedRefSelectButtonsSynced.displayName = 'SelectButtonsSynced';
+var _default = exports.default = ForwardedRefSelectButtonsSynced;

package/dist/cjs/base/ui/select_synced.js

@@ -0,0 +1,87 @@
+"use strict";
+
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.array.filter.js");
+require("core-js/modules/es.array.iterator.js");
+require("core-js/modules/es.object.get-own-property-descriptors.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/es.weak-map.js");
+require("core-js/modules/web.dom-collections.for-each.js");
+require("core-js/modules/web.dom-collections.iterator.js");
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var React = _interopRequireWildcard(require("react"));
+var _error_utils = require("../../shared/error_utils");
+var _use_synced = _interopRequireDefault(require("../../shared/ui/use_synced"));
+var _global_config_synced_component_helpers = _interopRequireDefault(require("../../shared/ui/global_config_synced_component_helpers"));
+var _select = _interopRequireWildcard(require("./select"));
+var _excluded = ["globalConfigKey", "disabled", "onChange"];
+/** @module @airtable/blocks/ui: Select */
+/** */
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/**
+ * Props for the {@link SelectSynced} component. Also accepts:
+ * * {@link SelectStyleProps}
+ *
+ * @docsPath UI/components/SelectSynced
+ * @groupPath UI/components/Select
+ */
+
+/**
+ * A wrapper around the {@link Select} component that syncs with {@link GlobalConfig}.
+ *
+ * [[ Story id="select--synced-example" title="Synced select example" ]]
+ *
+ * @docsPath UI/components/SelectSynced
+ * @groupPath UI/components/Select
+ * @component
+ */
+var SelectSynced = (props, ref) => {
+  var globalConfigKey = props.globalConfigKey,
+    disabled = props.disabled,
+    _onChange = props.onChange,
+    restOfProps = (0, _objectWithoutProperties2.default)(props, _excluded);
+  var _useSynced = (0, _use_synced.default)(globalConfigKey),
+    _useSynced2 = (0, _slicedToArray2.default)(_useSynced, 3),
+    value = _useSynced2[0],
+    setValue = _useSynced2[1],
+    canSetValue = _useSynced2[2];
+  var selectValue;
+  if (value === null || value === undefined) {
+    selectValue = null;
+  } else if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+    selectValue = value;
+  } else {
+    throw (0, _error_utils.spawnError)('SelectSynced only works with a global config value that is a string, number, boolean, null or undefined.');
+  }
+  return /*#__PURE__*/React.createElement(_select.default, (0, _extends2.default)({}, restOfProps, {
+    ref: ref,
+    value: selectValue,
+    onChange: newValue => {
+      if (newValue === undefined) {
+        newValue = null;
+      }
+      setValue(newValue);
+      if (_onChange) {
+        _onChange(newValue);
+      }
+    },
+    disabled: disabled || !canSetValue
+  }));
+};
+var ForwardedRefSelectSynced = /*#__PURE__*/React.forwardRef(SelectSynced);
+ForwardedRefSelectSynced.displayName = 'SelectSynced';
+ForwardedRefSelectSynced.propTypes = _objectSpread({
+  globalConfigKey: _global_config_synced_component_helpers.default.globalConfigKeyPropType
+}, _select.sharedSelectPropTypes);
+var _default = exports.default = ForwardedRefSelectSynced;

package/dist/cjs/base/ui/switch.js

@@ -0,0 +1,196 @@
+"use strict";
+
+require("core-js/modules/es.symbol.js");
+require("core-js/modules/es.array.filter.js");
+require("core-js/modules/es.object.get-own-property-descriptors.js");
+require("core-js/modules/es.object.to-string.js");
+require("core-js/modules/web.dom-collections.for-each.js");
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.switchStylePropTypes = exports.sharedSwitchPropTypes = exports.default = void 0;
+require("core-js/modules/es.array.includes.js");
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _emotion = require("emotion");
+var _react = _interopRequireDefault(require("react"));
+var _core = require("@styled-system/core");
+var _private_utils = require("../../shared/private_utils");
+var _use_styled_system = _interopRequireDefault(require("./use_styled_system"));
+var _system = require("./system");
+var _tooltip_anchor_props = require("./types/tooltip_anchor_props");
+var _use_theme = _interopRequireDefault(require("./theme/use_theme"));
+var _control_sizes = require("./control_sizes");
+var _enum_prop_type_utils = require("./system/utils/enum_prop_type_utils");
+var _excluded = ["disabled", "id", "label", "tabIndex", "variant", "size", "value", "onClick", "onChange", "onMouseEnter", "onMouseLeave", "className", "style", "aria-label", "aria-describedby", "aria-labelledby"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /** @module @airtable/blocks/ui: Switch */ /** */
+/**
+ * Variants for the {@link Switch} component:
+ *
+ * • **default**
+ *
+ * Green switch for toggling a setting or other boolean property.
+ *
+ * • **danger**
+ *
+ * Red switch for toggling a dangerous or infrequently-used setting.
+ */
+
+var SwitchVariant = (0, _private_utils.createEnum)('default', 'danger');
+var switchVariantPropType = (0, _enum_prop_type_utils.createPropTypeFromEnum)(SwitchVariant);
+
+/** @internal */
+function useSwitchVariant() {
+  var variant = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : SwitchVariant.default;
+  var _useTheme = (0, _use_theme.default)(),
+    switchVariants = _useTheme.switchVariants;
+  return switchVariants[variant];
+}
+
+/**
+ * Props shared between the {@link Switch} and {@link SwitchSynced} components.
+ *
+ * @noInheritDoc
+ */
+
+/**
+ * Props for the {@link Switch} component. Also accepts:
+ * * {@link SwitchStyleProps}
+ *
+ * @docsPath UI/components/Switch
+ */
+
+var switchStylePropTypes = exports.switchStylePropTypes = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, _system.maxWidthPropTypes), _system.minWidthPropTypes), _system.widthPropTypes), _system.flexItemSetPropTypes), _system.positionSetPropTypes), _system.spacingSetPropTypes), _system.backgroundColorPropTypes), _system.displayPropTypes);
+var sharedSwitchPropTypes = exports.sharedSwitchPropTypes = _objectSpread(_objectSpread({
+  disabled: _propTypes.default.bool,
+  id: _propTypes.default.string,
+  label: _propTypes.default.node,
+  onChange: _propTypes.default.func,
+  tabIndex: _propTypes.default.number,
+  variant: switchVariantPropType,
+  className: _propTypes.default.string,
+  style: _propTypes.default.object,
+  'aria-label': _propTypes.default.string,
+  'aria-labelledby': _propTypes.default.string,
+  'aria-describedby': _propTypes.default.string
+}, _tooltip_anchor_props.tooltipAnchorPropTypes), switchStylePropTypes);
+
+/**
+ * Style props for the {@link Switch} component. Also accepts:
+ * * {@link BackgroundColorProps}
+ * * {@link FlexItemSetProps}
+ * * {@link MinWidthProps}
+ * * {@link MaxWidthProps}
+ * * {@link PositionSetProps}
+ * * {@link SpacingSetProps}
+ * * {@link WidthProps}
+ *
+ * @noInheritDoc
+ */
+
+var styleParser = (0, _core.compose)(_system.maxWidth, _system.minWidth, _system.width, _system.flexItemSet, _system.positionSet, _system.spacingSet, _system.display, _system.backgroundColor);
+
+/**
+ * A toggle switch for controlling boolean values. Similar to a checkbox.
+ *
+ * [[ Story id="switch--example" title="Switch example" ]]
+ *
+ * By default, the Switch component is styled to be full-width (`width="100%"`) with a gray
+ * background to match other controls like Select, SelectButtons, Input, etc. This behavior can be
+ * overridden using style props. For example, you can set `backgroundColor="transparent"` on the
+ * Switch for a transparent background.
+ *
+ * @docsPath UI/components/Switch
+ * @component
+ */
+var Switch = (props, ref) => {
+  var disabled = props.disabled,
+    id = props.id,
+    label = props.label,
+    _props$tabIndex = props.tabIndex,
+    tabIndex = _props$tabIndex === void 0 ? 0 : _props$tabIndex,
+    _props$variant = props.variant,
+    variant = _props$variant === void 0 ? SwitchVariant.default : _props$variant,
+    _props$size = props.size,
+    size = _props$size === void 0 ? _control_sizes.ControlSize.default : _props$size,
+    value = props.value,
+    onClick = props.onClick,
+    onChange = props.onChange,
+    onMouseEnter = props.onMouseEnter,
+    onMouseLeave = props.onMouseLeave,
+    className = props.className,
+    style = props.style,
+    ariaLabel = props['aria-label'],
+    ariaDescribedBy = props['aria-describedby'],
+    ariaLabelledBy = props['aria-labelledby'],
+    styleProps = (0, _objectWithoutProperties2.default)(props, _excluded);
+  var classNameForStyleProps = (0, _use_styled_system.default)(_objectSpread({
+    display: 'flex',
+    width: '100%'
+  }, styleProps), styleParser);
+  var _useSwitchVariant = useSwitchVariant(variant),
+    classNameForVariant = _useSwitchVariant.baseClassName,
+    switchContainerClassName = _useSwitchVariant.switchContainerClassName,
+    switchClassName = _useSwitchVariant.switchClassName,
+    switchLabelClassName = _useSwitchVariant.switchLabelClassName;
+  var classNameForSize = (0, _control_sizes.useSwitchSize)(size);
+  if (!label && !ariaLabelledBy && !ariaLabel) {
+    // eslint-disable-next-line no-console
+    console.warn('<Switch> should be labeled using either the `label`, `ariaLabel`, or `ariaLabelledBy` prop');
+  }
+  function _onClick(e) {
+    // onClick should only be defined in the case of a tooltip
+    if (onClick) {
+      onClick(e);
+    }
+    _toggleValue();
+  }
+  function _onKeyDown(e) {
+    if (e.ctrlKey || e.altKey || e.metaKey) {
+      return;
+    }
+    if (['Enter', ' '].includes(e.key)) {
+      e.preventDefault();
+      _toggleValue();
+    }
+  }
+  function _toggleValue() {
+    if (onChange) {
+      onChange(!value);
+    }
+  }
+  return /*#__PURE__*/_react.default.createElement("div", {
+    ref: ref
+    // TODO (stephen): remove tooltip anchor props
+    ,
+    onMouseEnter: onMouseEnter,
+    onMouseLeave: onMouseLeave,
+    onClick: disabled ? undefined : _onClick,
+    onKeyDown: disabled ? undefined : _onKeyDown,
+    id: id,
+    className: (0, _emotion.cx)(classNameForVariant, classNameForSize, classNameForStyleProps, className),
+    style: style,
+    tabIndex: disabled ? undefined : tabIndex,
+    role: "checkbox",
+    "aria-disabled": disabled,
+    "aria-checked": !!value,
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-describedby": ariaDescribedBy
+  }, /*#__PURE__*/_react.default.createElement("div", {
+    className: switchContainerClassName
+  }, /*#__PURE__*/_react.default.createElement("div", {
+    className: switchClassName
+  })), label && /*#__PURE__*/_react.default.createElement("label", {
+    className: switchLabelClassName
+  }, label));
+};
+var ForwardedRefSwitch = /*#__PURE__*/_react.default.forwardRef(Switch);
+ForwardedRefSwitch.propTypes = _objectSpread({
+  value: _propTypes.default.bool.isRequired
+}, sharedSwitchPropTypes);
+ForwardedRefSwitch.displayName = 'Switch';
+var _default = exports.default = ForwardedRefSwitch;