@stylexjs/shared 0.2.0-beta.8 → 0.3.0

package/lib/preprocess-rules/application-order.js.flow

@@ -0,0 +1,241 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ */
+
+import type { TStyleValue } from '../common-types';
+
+/**
+ * Shorthand properties:
+ * - [x] all - Should be banned
+ * - [x] animation
+ * - [x] background
+ * - [x] border
+ * - [x] border-block-end
+ * - [x] border-block-start
+ * - [x] border-bottom
+ * - [x] border-color
+ * - [x] border-image
+ * - [x] border-inline-end
+ * - [x] border-inline-start
+ * - [x] border-left
+ * - [x] border-radius
+ * - [x] border-right
+ * - [x] border-style
+ * - [x] border-top
+ * - [x] border-width
+ * - [x] column-rule
+ * - [x] columns
+ * - [x] container
+ * - [x] flex
+ * - [x] flex-flow
+ * - [x] font
+ * - [x] gap
+ * - [x] grid
+ * - [x] grid-area
+ * - [x] grid-column
+ * - [x] grid-row
+ * - [x] grid-template
+ * - [x] inset
+ * - [x] inset-block
+ * - [x] inset-inline
+ * - [x] list-style
+ * - [x] margin
+ * - [x] mask
+ * - [x] offset
+ * - [x] outline
+ * - [x] overflow
+ * - [x] padding
+ * - [x] place-content
+ * - [x] place-items
+ * - [x] place-self
+ * - [x] scroll-margin
+ * - [x] scroll-padding
+ * - [x] text-decoration
+ * - [x] text-emphasis
+ * - [x] transition
+ */
+
+type TReturn = $ReadOnlyArray<[string, TStyleValue]>;
+
+declare const shorthands: {
+  all: (_: TStyleValue) => TReturn,
+  animation: (value: TStyleValue) => Array<[string, TStyleValue]>,
+  animationRange: (value: TStyleValue) => TReturn,
+  background: (value: TStyleValue) => TReturn,
+  backgroundPosition: (value: TStyleValue) => TReturn,
+  border: (rawValue: TStyleValue) => TReturn,
+  borderInline: (rawValue: TStyleValue) => TReturn,
+  borderBlock: (rawValue: TStyleValue) => TReturn,
+  borderTop: (rawValue: TStyleValue) => TReturn,
+  borderInlineEnd: (rawValue: TStyleValue) => TReturn,
+  borderRight: (rawValue: TStyleValue) => TReturn,
+  borderBottom: (rawValue: TStyleValue) => TReturn,
+  borderInlineStart: (_rawValue: TStyleValue) => TReturn,
+  borderLeft: (_rawValue: TStyleValue) => TReturn,
+  borderInlineWidth: (rawValue: TStyleValue) => TReturn,
+  borderInlineStyle: (rawValue: TStyleValue) => TReturn,
+  borderInlineColor: (rawValue: TStyleValue) => TReturn,
+  borderBlockWidth: (rawValue: TStyleValue) => TReturn,
+  borderBlockStyle: (rawValue: TStyleValue) => TReturn,
+  borderBlockColor: (rawValue: TStyleValue) => TReturn,
+  borderColor: (value: TStyleValue) => TReturn,
+  borderStyle: (value: TStyleValue) => TReturn,
+  borderWidth: (value: TStyleValue) => TReturn,
+  borderInlineStartColor: (value: TStyleValue) => TReturn,
+  borderInlineEndColor: (value: TStyleValue) => TReturn,
+  borderInlineStartStyle: (value: TStyleValue) => TReturn,
+  borderInlineEndStyle: (value: TStyleValue) => TReturn,
+  borderInlineStartWidth: (value: TStyleValue) => TReturn,
+  borderInlineEndWidth: (value: TStyleValue) => TReturn,
+  borderLeftColor: (value: TStyleValue) => TReturn,
+  borderRightColor: (value: TStyleValue) => TReturn,
+  borderLeftStyle: (value: TStyleValue) => TReturn,
+  borderRightStyle: (value: TStyleValue) => TReturn,
+  borderLeftWidth: (value: TStyleValue) => TReturn,
+  borderRightWidth: (value: TStyleValue) => TReturn,
+  borderRadius: (value: TStyleValue) => TReturn,
+  borderStartStartRadius: (value: TStyleValue) => TReturn,
+  borderStartEndRadius: (value: TStyleValue) => TReturn,
+  borderEndStartRadius: (value: TStyleValue) => TReturn,
+  borderEndEndRadius: (value: TStyleValue) => TReturn,
+  borderTopLeftRadius: (value: TStyleValue) => TReturn,
+  borderTopRightRadius: (value: TStyleValue) => TReturn,
+  borderBottomLeftRadius: (value: TStyleValue) => TReturn,
+  borderBottomRightRadius: (value: TStyleValue) => TReturn,
+  borderImage: (value: TStyleValue) => TReturn,
+  columnRule: (value: TStyleValue) => TReturn,
+  columns: (value: TStyleValue) => TReturn,
+  container: (value: TStyleValue) => TReturn,
+  containIntrinsicSize: (value: TStyleValue) => TReturn,
+  flex: (value: TStyleValue) => TReturn,
+  flexFlow: (value: TStyleValue) => TReturn,
+  font: (value: TStyleValue) => TReturn,
+  fontVariant: (value: TStyleValue) => TReturn,
+  gap: (value: TStyleValue) => TReturn,
+  grid: (value: TStyleValue) => TReturn,
+  gridArea: (value: TStyleValue) => TReturn,
+  gridRow: (value: TStyleValue) => TReturn,
+  gridColumn: (value: TStyleValue) => TReturn,
+  gridTemplate: (value: TStyleValue) => TReturn,
+  inset: (value: TStyleValue) => TReturn,
+  insetInline: (value: TStyleValue) => TReturn,
+  insetBlock: (value: TStyleValue) => TReturn,
+  insetInlineStart: (value: TStyleValue) => TReturn,
+  insetInlineEnd: (value: TStyleValue) => TReturn,
+  left: (value: TStyleValue) => TReturn,
+  right: (value: TStyleValue) => TReturn,
+  listStyle: (value: TStyleValue) => TReturn,
+  margin: (value: TStyleValue) => TReturn,
+  marginInline: (value: TStyleValue) => TReturn,
+  marginBlock: (value: TStyleValue) => TReturn,
+  marginInlineStart: (value: TStyleValue) => TReturn,
+  marginInlineEnd: (value: TStyleValue) => TReturn,
+  marginLeft: (value: TStyleValue) => TReturn,
+  marginRight: (value: TStyleValue) => TReturn,
+  mask: (value: TStyleValue) => TReturn,
+  maskBorder: (value: TStyleValue) => TReturn,
+  offset: (value: TStyleValue) => TReturn,
+  outline: (value: TStyleValue) => TReturn,
+  overflow: (value: TStyleValue) => TReturn,
+  padding: (rawValue: TStyleValue) => TReturn,
+  paddingInline: (rawValue: TStyleValue) => TReturn,
+  paddingBlock: (rawValue: TStyleValue) => TReturn,
+  paddingInlineStart: (value: TStyleValue) => TReturn,
+  paddingInlineEnd: (value: TStyleValue) => TReturn,
+  paddingLeft: (value: TStyleValue) => TReturn,
+  paddingRight: (value: TStyleValue) => TReturn,
+  placeContent: (value: TStyleValue) => TReturn,
+  placeItems: (value: TStyleValue) => TReturn,
+  placeSelf: (value: TStyleValue) => TReturn,
+  scrollMargin: (value: TStyleValue) => TReturn,
+  scrollMarginBlock: (value: TStyleValue) => TReturn,
+  scrollMarginInline: (value: TStyleValue) => TReturn,
+  scrollMarginInlineStart: (value: TStyleValue) => TReturn,
+  scrollMarginInlineEnd: (value: TStyleValue) => TReturn,
+  scrollMarginLeft: (value: TStyleValue) => TReturn,
+  scrollMarginRight: (value: TStyleValue) => TReturn,
+  scrollPadding: (value: TStyleValue) => TReturn,
+  scrollPaddingBlock: (value: TStyleValue) => TReturn,
+  scrollPaddingInline: (value: TStyleValue) => TReturn,
+  scrollPaddingInlineStart: (value: TStyleValue) => TReturn,
+  scrollPaddingInlineEnd: (value: TStyleValue) => TReturn,
+  scrollPaddingLeft: (value: TStyleValue) => TReturn,
+  scrollPaddingRight: (value: TStyleValue) => TReturn,
+  scrollSnapType: (value: TStyleValue) => TReturn,
+  scrollTimeline: (value: TStyleValue) => TReturn,
+  textDecoration: (value: TStyleValue) => TReturn,
+  textEmphasis: (value: TStyleValue) => TReturn,
+  transition: (value: TStyleValue) => TReturn,
+};
+
+declare const aliases: {
+  borderHorizontal: $FlowFixMe,
+  borderVertical: $FlowFixMe,
+  borderBlockStart: $FlowFixMe,
+  borderEnd: $FlowFixMe,
+  borderBlockEnd: $FlowFixMe,
+  borderStart: $FlowFixMe,
+  blockSize: (val: TStyleValue) => TReturn,
+  inlineSize: (val: TStyleValue) => TReturn,
+  minBlockSize: (val: TStyleValue) => TReturn,
+  minInlineSize: (val: TStyleValue) => TReturn,
+  maxBlockSize: (val: TStyleValue) => TReturn,
+  maxInlineSize: (val: TStyleValue) => TReturn,
+  borderHorizontalWidth: $FlowFixMe,
+  borderHorizontalStyle: $FlowFixMe,
+  borderHorizontalColor: $FlowFixMe,
+  borderVerticalWidth: $FlowFixMe,
+  borderVerticalStyle: $FlowFixMe,
+  borderVerticalColor: $FlowFixMe,
+  borderBlockStartColor: (value: TStyleValue) => TReturn,
+  borderBlockEndColor: (value: TStyleValue) => TReturn,
+  borderBlockStartStyle: (value: TStyleValue) => TReturn,
+  borderBlockEndStyle: (value: TStyleValue) => TReturn,
+  borderBlockStartWidth: (value: TStyleValue) => TReturn,
+  borderBlockEndWidth: (value: TStyleValue) => TReturn,
+  borderStartColor: $FlowFixMe,
+  borderEndColor: $FlowFixMe,
+  borderStartStyle: $FlowFixMe,
+  borderEndStyle: $FlowFixMe,
+  borderStartWidth: $FlowFixMe,
+  borderEndWidth: $FlowFixMe,
+  borderTopStartRadius: (value: TStyleValue) => TReturn,
+  borderTopEndRadius: (value: TStyleValue) => TReturn,
+  borderBottomStartRadius: (value: TStyleValue) => TReturn,
+  borderBottomEndRadius: (value: TStyleValue) => TReturn,
+  containIntrinsicBlockSize: (value: TStyleValue) => TReturn,
+  containIntrinsicInlineSize: (value: TStyleValue) => TReturn,
+  gridGap: $FlowFixMe,
+  gridRowGap: (value: TStyleValue) => TReturn,
+  gridColumnGap: (value: TStyleValue) => TReturn,
+  marginBlockStart: (value: TStyleValue) => TReturn,
+  marginBlockEnd: (value: TStyleValue) => TReturn,
+  marginStart: $FlowFixMe,
+  marginEnd: $FlowFixMe,
+  marginHorizontal: $FlowFixMe,
+  marginVertical: $FlowFixMe,
+  overflowBlock: (value: TStyleValue) => TReturn,
+  overflowInline: (value: TStyleValue) => TReturn,
+  paddingBlockStart: (rawValue: TStyleValue) => TReturn,
+  paddingBlockEnd: (rawValue: TStyleValue) => TReturn,
+  paddingStart: $FlowFixMe,
+  paddingEnd: $FlowFixMe,
+  paddingHorizontal: $FlowFixMe,
+  paddingVertical: $FlowFixMe,
+  scrollMarginBlockStart: (value: TStyleValue) => TReturn,
+  scrollMarginBlockEnd: (value: TStyleValue) => TReturn,
+  insetBlockStart: (value: TStyleValue) => TReturn,
+  insetBlockEnd: (value: TStyleValue) => TReturn,
+  start: $FlowFixMe,
+  end: $FlowFixMe,
+};
+
+declare export default $ReadOnly<{
+  ...typeof shorthands,
+  ...typeof aliases,
+}>;

package/lib/preprocess-rules/basic-validation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ */
+
+export declare function validateNamespace(
+  namespace: unknown,
+  conditions: ReadonlyArray<string>,
+): void;

package/lib/preprocess-rules/basic-validation.js

@@ -0,0 +1,83 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.validateNamespace = validateNamespace;
+var _stylexInclude = require("../stylex-include");
+var messages = _interopRequireWildcard(require("../messages"));
+var _objectUtils = require("../utils/object-utils");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (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 validateNamespace(namespace) {
+  let conditions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  if (!(0, _objectUtils.isPlainObject)(namespace)) {
+    throw new Error(messages.ILLEGAL_NAMESPACE_VALUE);
+  }
+  const ns = namespace;
+  for (const key in ns) {
+    const val = ns[key];
+    if (val === null || typeof val === 'string' || typeof val === 'number') {
+      continue;
+    }
+    if (Array.isArray(val)) {
+      for (const v of val) {
+        if (v === null || typeof v === 'string' || typeof v === 'number') {
+          continue;
+        }
+        throw new Error(messages.ILLEGAL_PROP_ARRAY_VALUE);
+      }
+      continue;
+    }
+    if (val instanceof _stylexInclude.IncludedStyles) {
+      if (conditions.length === 0) {
+        continue;
+      }
+      throw new Error(messages.ONLY_TOP_LEVEL_INLCUDES);
+    }
+    if ((0, _objectUtils.isPlainObject)(val)) {
+      if (key.startsWith('@') || key.startsWith(':')) {
+        if (conditions.includes(key)) {
+          throw new Error(messages.DUPLICATE_CONDITIONAL);
+        }
+        validateNamespace(val, [...conditions, key]);
+      } else {
+        validateConditionalStyles(val);
+      }
+      continue;
+    }
+    throw new Error(messages.ILLEGAL_PROP_VALUE);
+  }
+}
+function validateConditionalStyles(val) {
+  let conditions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  for (const key in val) {
+    const v = val[key];
+    if (!(key.startsWith('@') || key.startsWith(':') || key === 'default')) {
+      throw new Error(messages.INVALID_PSEUDO_OR_AT_RULE);
+    }
+    if (conditions.includes(key)) {
+      throw new Error(messages.DUPLICATE_CONDITIONAL);
+    }
+    if (v === null || typeof v === 'string' || typeof v === 'number') {
+      continue;
+    }
+    if (Array.isArray(v)) {
+      for (const vv of v) {
+        if (vv === null || typeof vv === 'string' || typeof vv === 'number') {
+          continue;
+        }
+        throw new Error(messages.ILLEGAL_PROP_VALUE);
+      }
+      continue;
+    }
+    if (v instanceof _stylexInclude.IncludedStyles) {
+      throw new Error(messages.ONLY_TOP_LEVEL_INLCUDES);
+    }
+    if ((0, _objectUtils.isPlainObject)(v)) {
+      validateConditionalStyles(v, [...conditions, key]);
+      continue;
+    }
+    throw new Error(messages.ILLEGAL_PROP_VALUE);
+  }
+}

package/lib/preprocess-rules/basic-validation.js.flow

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ */
+
+declare export function validateNamespace(
+  namespace: mixed,
+  conditions: $ReadOnlyArray<string>,
+): void;

package/lib/preprocess-rules/flatten-raw-style-obj.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ */
+
+import type { RawStyles, StyleXOptions } from '../common-types';
+import {
+  type AnyPreRule,
+  type IPreRule,
+  PreIncludedStylesRule,
+} from './PreRule';
+export declare function flattenRawStyleObject(
+  style: RawStyles,
+  options: StyleXOptions,
+): ReadonlyArray<Readonly<[string, IPreRule]>>;
+export declare function _flattenRawStyleObject(
+  style: RawStyles,
+  pseudos: ReadonlyArray<string>,
+  atRules: ReadonlyArray<string>,
+  options: StyleXOptions,
+): Array<Readonly<[string, AnyPreRule | PreIncludedStylesRule]>>;

package/lib/preprocess-rules/flatten-raw-style-obj.js

@@ -0,0 +1,120 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports._flattenRawStyleObject = _flattenRawStyleObject;
+exports.flattenRawStyleObject = flattenRawStyleObject;
+var _index = _interopRequireDefault(require("./index"));
+var _PreRule = require("./PreRule");
+var _stylexInclude = require("../stylex-include");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function flattenRawStyleObject(style, options) {
+  return _flattenRawStyleObject(style, [], [], options);
+}
+function _flattenRawStyleObject(style, pseudos, atRules, options) {
+  const flattened = [];
+  for (const _key in style) {
+    const value = style[_key];
+    const key = _key.match(/var\(--[a-z0-9]+\)/) ? _key.slice(4, -1) : _key;
+    if (typeof value === 'object' && value instanceof _stylexInclude.IncludedStyles) {
+      flattened.push([key, new _PreRule.PreIncludedStylesRule(value)]);
+      continue;
+    }
+    if (value === null || typeof value === 'string' || typeof value === 'number') {
+      const pairs = (0, _index.default)([key, value], options);
+      for (const [property, value] of pairs) {
+        if (value === null) {
+          flattened.push([property, new _PreRule.NullPreRule()]);
+        } else {
+          flattened.push([property, new _PreRule.PreRule(property, value, pseudos, atRules)]);
+        }
+      }
+      continue;
+    }
+    if (Array.isArray(value)) {
+      const equivalentPairs = {};
+      for (const eachVal of value) {
+        const pairs = (0, _index.default)([key, eachVal], options);
+        for (const [property, val] of pairs) {
+          if (Array.isArray(val)) {
+            if (equivalentPairs[property] == null) {
+              equivalentPairs[property] = [...val];
+            } else {
+              equivalentPairs[property].push(...val);
+            }
+          } else if (equivalentPairs[property] == null) {
+            equivalentPairs[property] = [val];
+          } else {
+            equivalentPairs[property].push(val);
+          }
+        }
+      }
+      Object.entries(equivalentPairs).map(_ref => {
+        let [property, values] = _ref;
+        return [property, [...new Set(values.filter(Boolean))]];
+      }).map(_ref2 => {
+        let [property, values] = _ref2;
+        return [property, values.length === 0 ? null : values.length === 1 ? values[0] : values];
+      }).forEach(_ref3 => {
+        let [property, value] = _ref3;
+        if (value === null) {
+          flattened.push([property, new _PreRule.NullPreRule()]);
+        } else {
+          flattened.push([property, new _PreRule.PreRule(property, value, pseudos, atRules)]);
+        }
+      });
+      continue;
+    }
+    if (typeof value === 'object' && !key.startsWith(':') && !key.startsWith('@')) {
+      const equivalentPairs = {};
+      for (const condition in value) {
+        const innerValue = value[condition];
+        const pseudosToPassDown = [...pseudos];
+        const atRulesToPassDown = [...atRules];
+        if (condition.startsWith(':')) {
+          pseudosToPassDown.push(condition);
+        } else if (condition.startsWith('@')) {
+          atRulesToPassDown.push(condition);
+        }
+        const pairs = _flattenRawStyleObject({
+          [key]: innerValue
+        }, pseudosToPassDown, atRulesToPassDown, options);
+        for (const [property, preRule] of pairs) {
+          if (preRule instanceof _PreRule.PreIncludedStylesRule) {
+            throw new Error('stylex.include can only be used at the top-level');
+          }
+          if (equivalentPairs[property] == null) {
+            equivalentPairs[property] = {
+              [condition]: preRule
+            };
+          } else {
+            equivalentPairs[property][condition] = preRule;
+          }
+        }
+      }
+      for (const [property, obj] of Object.entries(equivalentPairs)) {
+        const sortedKeys = Object.keys(obj);
+        const rules = [];
+        for (const condition of sortedKeys) {
+          rules.push(obj[condition]);
+        }
+        flattened.push([property, _PreRule.PreRuleSet.create(rules)]);
+      }
+    }
+    if (typeof value === 'object' && (key.startsWith(':') || key.startsWith('@'))) {
+      const pseudosToPassDown = [...pseudos];
+      const atRulesToPassDown = [...atRules];
+      if (key.startsWith(':')) {
+        pseudosToPassDown.push(key);
+      } else if (key.startsWith('@')) {
+        atRulesToPassDown.push(key);
+      }
+      const pairs = _flattenRawStyleObject(value, pseudosToPassDown, atRulesToPassDown, options);
+      for (const [property, preRule] of pairs) {
+        flattened.push([key + '_' + property, preRule]);
+      }
+    }
+  }
+  return flattened;
+}

package/lib/preprocess-rules/flatten-raw-style-obj.js.flow

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ */
+
+import type { RawStyles, StyleXOptions } from '../common-types';
+
+import {
+  type AnyPreRule,
+  type IPreRule,
+  PreIncludedStylesRule,
+} from './PreRule';
+declare export function flattenRawStyleObject(
+  style: RawStyles,
+  options: StyleXOptions,
+): $ReadOnlyArray<$ReadOnly<[string, IPreRule]>>;
+
+declare export function _flattenRawStyleObject(
+  style: RawStyles,
+  pseudos: $ReadOnlyArray<string>,
+  atRules: $ReadOnlyArray<string>,
+  options: StyleXOptions,
+): Array<$ReadOnly<[string, AnyPreRule | PreIncludedStylesRule]>>;

package/lib/preprocess-rules/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ */
+
+import type { StyleXOptions, TStyleValue } from '../common-types';
+export declare function getExpandedKeys(
+  options: StyleXOptions,
+): ReadonlyArray<string>;
+declare function flatMapExpandedShorthands(
+  objEntry: Readonly<[string, TStyleValue]>,
+  options: StyleXOptions,
+): ReadonlyArray<[string, TStyleValue]>;
+export default flatMapExpandedShorthands;

package/lib/preprocess-rules/index.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = flatMapExpandedShorthands;
+exports.getExpandedKeys = getExpandedKeys;
+var _applicationOrder = _interopRequireDefault(require("./application-order"));
+var _legacyExpandShorthands = _interopRequireDefault(require("./legacy-expand-shorthands"));
+var _propertySpecificity = _interopRequireDefault(require("./property-specificity"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+const expansions = {
+  'application-order': _applicationOrder.default,
+  'property-specificity': _propertySpecificity.default,
+  'legacy-expand-shorthands': _legacyExpandShorthands.default
+};
+function getExpandedKeys(options) {
+  return Object.keys(expansions[options.styleResolution ?? 'application-order']);
+}
+function flatMapExpandedShorthands(objEntry, options) {
+  const [key, value] = objEntry;
+  const expansion = expansions[options.styleResolution ?? 'application-order'][key];
+  if (expansion) {
+    if (Array.isArray(value)) {
+      throw new Error('Cannot use fallbacks for shorthands. Use the expansion instead.');
+    }
+    return expansion(value);
+  }
+  return [[key, value]];
+}

package/lib/preprocess-rules/index.js.flow

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ */
+
+import type { StyleXOptions, TStyleValue } from '../common-types';
+
+declare export function getExpandedKeys(
+  options: StyleXOptions,
+): $ReadOnlyArray<string>;
+
+declare export default function flatMapExpandedShorthands(
+  objEntry: $ReadOnly<[string, TStyleValue]>,
+  options: StyleXOptions,
+): $ReadOnlyArray<[string, TStyleValue]>;