@stylexjs/shared 0.1.0-beta.7 → 0.2.0-beta.11

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

@@ -0,0 +1,259 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _splitCssValue = _interopRequireDefault(require("../utils/split-css-value"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 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.
+ *
+ * 
+ */
+
+const shorthands = {
+  all: _ => {
+    throw new Error('all is not supported');
+  },
+  animation: value => [['animation', value], ['animationName', null], ['animationDuration', null], ['animationTimingFunction', null], ['animationDelay', null], ['animationIterationCount', null], ['animationDirection', null], ['animationFillMode', null], ['animationPlayState', null]],
+  background: value => [['background', value], ['backgroundAttachment', null], ['backgroundClip', null], ['backgroundColor', null], ['backgroundImage', null], ['backgroundOrigin', null], ['backgroundPosition', null], ['backgroundRepeat', null], ['backgroundSize', null]],
+  // These will be removed later, matching the properties with React Native.
+  // For now, we're compiling them to the React Native properties.
+  // @Deprecated
+  border: rawValue => {
+    if (typeof rawValue === 'number') {
+      return shorthands.borderWidth(rawValue);
+    }
+    const [width, style, color] = (0, _splitCssValue.default)(rawValue);
+    return [...shorthands.borderWidth(width), ...shorthands.borderStyle(style), ...shorthands.borderColor(color)];
+  },
+  // @Deprecated
+  borderInline: rawValue => {
+    if (typeof rawValue === 'number') {
+      return [['borderInlineWidth', rawValue], ['borderInlineStartWidth', null], ['borderInlineEndWidth', null]];
+    }
+    const [width, style, color] = (0, _splitCssValue.default)(rawValue);
+    return [...shorthands.borderInlineWidth(width), ...shorthands.borderInlineStyle(style), ...shorthands.borderInlineColor(color)];
+  },
+  // @Deprecated
+  borderBlock: rawValue => {
+    if (typeof rawValue === 'number') {
+      return [['borderBlockWidth', rawValue], ['borderTopWidth', null], ['borderBottomWidth', null]];
+    }
+    const [width, style, color] = (0, _splitCssValue.default)(rawValue);
+    return [...shorthands.borderBlockWidth(width), ...shorthands.borderBlockStyle(style), ...shorthands.borderBlockColor(color)];
+  },
+  // @Deprecated
+  borderTop: rawValue => {
+    if (typeof rawValue === 'number') {
+      return [['borderTopWidth', rawValue]];
+    }
+    const [width, style, color] = (0, _splitCssValue.default)(rawValue);
+    return [['borderTopWidth', width], ['borderTopStyle', style], ['borderTopColor', color]];
+  },
+  // @Deprecated
+  borderInlineEnd: rawValue => {
+    if (typeof rawValue === 'number') {
+      return [['borderInlineEndWidth', rawValue]];
+    }
+    const [width, style, color] = (0, _splitCssValue.default)(rawValue);
+    return [['borderInlineEndWidth', width], ['borderInlineEndStyle', style], ['borderInlineEndColor', color]];
+  },
+  // @Deprecated
+  borderRight: _rawValue => {
+    throw new Error(['`borderRight` is not supported.', 'You could use `borderRightWidth`, `borderRightStyle` and `borderRightColor`,', 'but it is preferable to use `borderInlineEndWidth`, `borderInlineEndStyle` and `borderInlineEndColor`.'].join(' '));
+  },
+  // @Deprecated
+  borderBottom: rawValue => {
+    if (typeof rawValue === 'number') {
+      return [['borderBottomWidth', rawValue]];
+    }
+    const [width, style, color] = (0, _splitCssValue.default)(rawValue);
+    return [['borderBottomWidth', width], ['borderBottomStyle', style], ['borderBottomColor', color]];
+  },
+  // @Deprecated
+  borderInlineStart: rawValue => {
+    if (typeof rawValue === 'number') {
+      return [['borderInlineStartWidth', rawValue]];
+    }
+    const [width, style, color] = (0, _splitCssValue.default)(rawValue);
+    return [['borderInlineStartWidth', width], ['borderInlineStartStyle', style], ['borderInlineStartColor', color]];
+  },
+  // @Deprecated
+  borderLeft: _rawValue => {
+    throw new Error(['`borderLeft` is not supported.', 'You could use `borderLeftWidth`, `borderLeftStyle` and `borderLeftColor`,', 'but it is preferable to use `borderInlineStartWidth`, `borderInlineStartStyle` and `borderInlineStartColor`.'].join(' '));
+  },
+  borderInlineWidth: rawValue => [['borderInlineWidth', rawValue], ['borderInlineStartWidth', null], ['borderLeftWidth', null], ['borderInlineEndWidth', null], ['borderRightWidth', null]],
+  borderInlineStyle: rawValue => [['borderInlineStyle', rawValue], ['borderInlineStartStyle', null], ['borderLeftStyle', null], ['borderInlineEndStyle', null], ['borderRightStyle', null]],
+  borderInlineColor: rawValue => [['borderInlineColor', rawValue], ['borderInlineStartColor', null], ['borderLeftColor', null], ['borderInlineEndColor', null], ['borderRightColor', null]],
+  borderBlockWidth: rawValue => [['borderBlockWidth', rawValue], ['borderTopWidth', null], ['borderBottomWidth', null]],
+  borderBlockStyle: rawValue => [['borderBlockStyle', rawValue], ['borderTopStyle', null], ['borderBottomStyle', null]],
+  borderBlockColor: rawValue => [['borderBlockColor', rawValue], ['borderTopColor', null], ['borderBottomColor', null]],
+  borderColor: value => [['borderColor', value], ['borderTopColor', null], ['borderInlineEndColor', null], ['borderRightColor', null], ['borderBottomColor', null], ['borderInlineStartColor', null], ['borderLeftColor', null]],
+  borderStyle: value => [['borderStyle', value], ['borderTopStyle', null], ['borderInlineEndStyle', null], ['borderRightStyle', null], ['borderBottomStyle', null], ['borderInlineStartStyle', null], ['borderLeftStyle', null]],
+  borderWidth: value => [['borderWidth', value], ['borderTopWidth', null], ['borderInlineEndWidth', null], ['borderRightWidth', null], ['borderBottomWidth', null], ['borderInlineStartWidth', null], ['borderLeftWidth', null]],
+  borderInlineStartColor: value => [['borderInlineStartColor', value], ['borderLeftColor', null], ['borderRightColor', null]],
+  borderInlineEndColor: value => [['borderInlineEndColor', value], ['borderLeftColor', null], ['borderRightColor', null]],
+  borderInlineStartStyle: value => [['borderInlineStartStyle', value], ['borderLeftStyle', null], ['borderRightStyle', null]],
+  borderInlineEndStyle: value => [['borderInlineEndStyle', value], ['borderLeftStyle', null], ['borderRightStyle', null]],
+  borderInlineStartWidth: value => [['borderInlineStartWidth', value], ['borderLeftWidth', null], ['borderRightWidth', null]],
+  borderInlineEndWidth: value => [['borderInlineEndWidth', value], ['borderLeftWidth', null], ['borderRightWidth', null]],
+  borderLeftColor: value => [['borderLeftColor', value], ['borderInlineStartColor', null], ['borderInlineEndColor', null]],
+  borderRightColor: value => [['borderRightColor', value], ['borderInlineStartColor', null], ['borderInlineEndColor', null]],
+  borderLeftStyle: value => [['borderLeftStyle', value], ['borderInlineStartStyle', null], ['borderInlineEndStyle', null]],
+  borderRightStyle: value => [['borderRightStyle', value], ['borderInlineStartStyle', null], ['borderInlineEndStyle', null]],
+  borderLeftWidth: value => [['borderLeftWidth', value], ['borderInlineStartWidth', null], ['borderInlineEndWidth', null]],
+  borderRightWidth: value => [['borderRightWidth', value], ['borderInlineStartWidth', null], ['borderInlineEndWidth', null]],
+  borderRadius: value => {
+    const values = typeof value === 'number' ? [value] : (0, _splitCssValue.default)(value);
+    if (values.length === 1) {
+      return [['borderRadius', value],
+      // // logical constituents
+      ['borderStartStartRadius', null], ['borderStartEndRadius', null], ['borderEndStartRadius', null], ['borderEndEndRadius', null],
+      // physical constituents
+      ['borderTopLeftRadius', null], ['borderTopRightRadius', null], ['borderBottomLeftRadius', null], ['borderBottomRightRadius', null]];
+    }
+
+    // @Deprecated
+    const [startStart, startEnd = startStart, endEnd = startStart, endStart = startEnd] = values;
+    return [
+    // split into logical consituents
+    ['borderStartStartRadius', startStart], ['borderStartEndRadius', startEnd], ['borderEndEndRadius', endEnd], ['borderEndStartRadius', endStart],
+    // unset physical consituents
+    ['borderTopLeftRadius', null], ['borderTopRightRadius', null], ['borderBottomLeftRadius', null], ['borderBottomRightRadius', null]];
+  },
+  borderStartStartRadius: value => [['borderStartStartRadius', value], ['borderTopLeftRadius', null], ['borderTopRightRadius', null]],
+  borderStartEndRadius: value => [['borderStartEndRadius', value], ['borderTopLeftRadius', null], ['borderTopRightRadius', null]],
+  borderEndStartRadius: value => [['borderEndStartRadius', value], ['borderBottomLeftRadius', null], ['borderBottomRightRadius', null]],
+  borderEndEndRadius: value => [['borderEndEndRadius', value], ['borderBottomLeftRadius', null], ['borderBottomRightRadius', null]],
+  borderTopLeftRadius: value => [['borderTopLeftRadius', value], ['borderStartStartRadius', null], ['borderStartEndRadius', null]],
+  borderTopRightRadius: value => [['borderTopRightRadius', value], ['borderStartStartRadius', null], ['borderStartEndRadius', null]],
+  borderBottomLeftRadius: value => [['borderBottomLeftRadius', value], ['borderEndStartRadius', null], ['borderEndEndRadius', null]],
+  borderBottomRightRadius: value => [['borderBottomRightRadius', value], ['borderEndStartRadius', null], ['borderEndEndRadius', null]],
+  columnRule: value => [['columnRule', value], ['columnRuleWidth', null], ['columnRuleStyle', null], ['columnRuleColor', null]],
+  columns: value => [['columns', value], ['columnCount', null], ['columnWidth', null]],
+  container: value => [['container', value], ['containerName', null], ['containerType', null]],
+  flex: value => [['flex', value], ['flexGrow', null], ['flexShrink', null], ['flexBasis', null]],
+  flexFlow: value => [['flexFlow', value], ['flexDirection', null], ['flexWrap', null]],
+  // @Deprecated ?
+  font: value => [['font', value], ['fontFamily', null], ['fontSize', null], ['fontStretch', null], ['fontStyle', null], ['fontVariant', null], ['fontWeight', null], ['lineHeight', null]],
+  gap: value => [['gap', value], ['rowGap', null], ['columnGap', null]],
+  grid: value => [['grid', value], ['gridTemplate', null], ['gridTemplateAreas', null], ['gridTemplateColumns', null], ['gridTemplateRows', null], ['gridAutoRows', null], ['gridAutoColumns', null], ['gridAutoFlow', null]],
+  gridArea: value => [['gridArea', value], ['gridRow', null], ['gridRowStart', null], ['gridRowEnd', null], ['gridColumn', null], ['gridColumnStart', null], ['gridColumnEnd', null]],
+  gridRow: value => [['gridRow', value], ['gridRowStart', null], ['gridRowEnd', null]],
+  gridColumn: value => [['gridColumn', value], ['gridColumnStart', null], ['gridColumnEnd', null]],
+  gridTemplate: value => [['gridTemplate', value], ['gridTemplateAreas', null], ['gridTemplateColumns', null], ['gridTemplateRows', null]],
+  inset: value => [['inset', value], ['insetInline', null], ['insetBlock', null], ['insetInlineStart', null], ['insetInlineEnd', null], ['top', null], ['right', null], ['bottom', null], ['left', null]],
+  insetInline: value => [['insetInline', value], ['insetInlineStart', null], ['insetInlineEnd', null], ['left', null], ['right', null]],
+  insetBlock: value => [['insetBlock', value], ['top', null], ['bottom', null]],
+  insetInlineStart: value => [['insetInlineStart', value], ['left', null], ['right', null]],
+  insetInlineEnd: value => [['insetInlineEnd', value], ['left', null], ['right', null]],
+  left: value => [['left', value], ['insetInlineStart', null], ['insetInlineEnd', null]],
+  right: value => [['right', value], ['insetInlineStart', null], ['insetInlineEnd', null]],
+  listStyle: value => [['listStyle', value], ['listStyleImage', null], ['listStylePosition', null], ['listStyleType', null]],
+  margin: value => {
+    const values = typeof value === 'number' ? [value] : (0, _splitCssValue.default)(value);
+    if (values.length === 1) {
+      return [['margin', values[0]], ['marginInlineStart', null], ['marginLeft', null], ['marginInlineEnd', null], ['marginRight', null], ['marginTop', null], ['marginBottom', null]];
+    }
+    // @Deprecated
+    const [top, right = top, bottom = top, left = right] = values;
+    return [['marginTop', top], ['marginInlineEnd', right], ['marginBottom', bottom], ['marginInlineStart', left], ['marginLeft', null], ['marginRight', null]];
+  },
+  marginInline: value => [['marginInline', value], ['marginInlineStart', null], ['marginLeft', null], ['marginInlineEnd', null], ['marginRight', null]],
+  marginBlock: value => [['marginBlock', value], ['marginTop', null], ['marginBottom', null]],
+  marginInlineStart: value => [['marginInlineStart', value], ['marginLeft', null], ['marginRight', null]],
+  marginInlineEnd: value => [['marginInlineEnd', value], ['marginLeft', null], ['marginRight', null]],
+  marginLeft: value => [['marginLeft', value], ['marginInlineStart', null], ['marginInlineEnd', null]],
+  marginRight: value => [['marginRight', value], ['marginInlineStart', null], ['marginInlineEnd', null]],
+  mask: value => [['mask', value], ['maskClip', null], ['maskComposite', null], ['maskImage', null], ['maskMode', null], ['maskOrigin', null], ['maskPosition', null], ['maskRepeat', null], ['maskSize', null]],
+  offset: value => [['offset', value], ['offsetAnchor', null], ['offsetDistance', null], ['offsetPath', null], ['offsetPosition', null], ['offsetRotate', null]],
+  outline: value => [['outline', value], ['outlineColor', null], ['outlineStyle', null], ['outlineWidth', null]],
+  overflow: value => [['overflow', value], ['overflowX', null], ['overflowY', null]],
+  padding: rawValue => {
+    const values = typeof rawValue === 'number' ? [rawValue] : (0, _splitCssValue.default)(rawValue);
+    if (values.length === 1) {
+      return [['padding', values[0]], ['paddingStart', null], ['paddingLeft', null], ['paddingEnd', null], ['paddingRight', null], ['paddingTop', null], ['paddingBottom', null]];
+    }
+    // @Deprecated
+    const [top, right = top, bottom = top, left = right] = values;
+    return [['paddingTop', top], ['paddingEnd', right], ['paddingBottom', bottom], ['paddingStart', left]];
+  },
+  paddingInline: rawValue => [['paddingInline', rawValue], ['paddingStart', null], ['paddingLeft', null], ['paddingEnd', null], ['paddingRight', null]],
+  paddingBlock: rawValue => [['paddingBlock', rawValue], ['paddingTop', null], ['paddingBottom', null]],
+  paddingInlineStart: value => [['paddingInlineStart', value], ['paddingLeft', null], ['paddingRight', null]],
+  paddingInlineEnd: value => [['paddingInlineEnd', value], ['paddingLeft', null], ['paddingRight', null]],
+  paddingLeft: value => [['paddingLeft', value], ['paddingInlineStart', null], ['paddingInlineEnd', null]],
+  paddingRight: value => [['paddingRight', value], ['paddingInlineStart', null], ['paddingInlineEnd', null]],
+  placeContent: value => [['placeContent', value], ['alignContent', null], ['justifyContent', null]],
+  placeItems: value => [['placeItems', value], ['alignItems', null], ['justifyItems', null]],
+  placeSelf: value => [['placeSelf', value], ['alignSelf', null], ['justifySelf', null]],
+  scrollMargin: value => [['scrollMargin', value], ['scrollMarginBottom', null], ['scrollMarginLeft', null], ['scrollMarginStart', null], ['scrollMarginRight', null], ['scrollMarginEnd', null], ['scrollMarginTop', null]],
+  scrollPadding: value => [['scrollPadding', value], ['scrollPaddingBottom', null], ['scrollPaddingLeft', null], ['scrollPaddingStart', null], ['scrollPaddingRight', null], ['scrollPaddingEnd', null], ['scrollPaddingTop', null]],
+  scrollTimeline: value => [['scrollTimeline', value], ['scrollTimelineName', null], ['scrollTimelineAxis', null]],
+  textDecoration: value => [['textDecoration', value], ['textDecorationColor', null], ['textDecorationLine', null], ['textDecorationStyle', null], ['textDecorationThickness', null]],
+  textEmphasis: value => [['textEmphasis', value], ['textEmphasisColor', null], ['textEmphasisStyle', null]],
+  transition: value => [['transition', value], ['transitionDelay', null], ['transitionDuration', null], ['transitionProperty', null], ['transitionTimingFunction', null]]
+};
+const aliases = {
+  // @Deprecated
+  borderHorizontal: shorthands.borderInline,
+  // @Deprecated
+  borderVertical: shorthands.borderBlock,
+  // @Deprecated
+  borderBlockStart: shorthands.borderTop,
+  // @Deprecated
+  borderEnd: shorthands.borderInlineEnd,
+  // @Deprecated
+  borderBlockEnd: shorthands.borderBottom,
+  // @Deprecated
+  borderStart: shorthands.borderInlineStart,
+  borderHorizontalWidth: shorthands.borderInlineWidth,
+  borderHorizontalStyle: shorthands.borderInlineStyle,
+  borderHorizontalColor: shorthands.borderInlineColor,
+  borderVerticalWidth: shorthands.borderBlockWidth,
+  borderVerticalStyle: shorthands.borderBlockStyle,
+  borderVerticalColor: shorthands.borderBlockColor,
+  borderBlockStartColor: value => [['borderTopColor', value]],
+  borderBlockEndColor: value => [['borderBottomColor', value]],
+  borderBlockStartStyle: value => [['borderTopStyle', value]],
+  borderBlockEndStyle: value => [['borderBottomStyle', value]],
+  borderBlockStartWidth: value => [['borderTopWidth', value]],
+  borderBlockEndWidth: value => [['borderBottomWidth', value]],
+  borderStartColor: shorthands.borderInlineStartColor,
+  borderEndColor: shorthands.borderInlineEndColor,
+  borderStartStyle: shorthands.borderInlineStartStyle,
+  borderEndStyle: shorthands.borderInlineEndStyle,
+  borderStartWidth: shorthands.borderInlineStartWidth,
+  borderEndWidth: shorthands.borderInlineEndWidth,
+  borderTopStartRadius: value => [['borderStartStartRadius', value]],
+  borderTopEndRadius: value => [['borderStartEndRadius', value]],
+  borderBottomStartRadius: value => [['borderEndStartRadius', value]],
+  borderBottomEndRadius: value => [['borderEndEndRadius', value]],
+  marginBlockStart: value => [['marginTop', value]],
+  marginBlockEnd: value => [['marginBottom', value]],
+  marginStart: shorthands.marginInlineStart,
+  marginEnd: shorthands.marginInlineEnd,
+  marginHorizontal: shorthands.marginInline,
+  marginVertical: shorthands.marginBlock,
+  paddingBlockStart: rawValue => [['paddingTop', rawValue]],
+  paddingBlockEnd: rawValue => [['paddingBottom', rawValue]],
+  paddingStart: shorthands.paddingInlineStart,
+  paddingEnd: shorthands.paddingInlineEnd,
+  paddingHorizontal: shorthands.paddingInline,
+  paddingVertical: shorthands.paddingBlock,
+  insetBlockStart: value => [['top', value]],
+  insetBlockEnd: value => [['bottom', value]],
+  start: shorthands.insetInlineStart,
+  end: shorthands.insetInlineEnd
+};
+const expansions = {
+  ...shorthands,
+  ...aliases
+};
+var _default = expansions;
+exports.default = _default;

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

@@ -0,0 +1,92 @@
+"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; }
+/**
+ * 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.
+ *
+ * 
+ */
+
+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/expand-shorthands.js

@@ -0,0 +1,156 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _splitCssValue = _interopRequireDefault(require("../utils/split-css-value"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 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.
+ *
+ * 
+ */
+
+// TODO: to be added later.
+// const aliases = {
+//   marginInlineStart: (rawValue) => [['marginStart', rawValue]],
+//   marginInlineEnd: (rawValue) => [['marginEnd', rawValue]],
+//   marginInline: (rawValue) => [
+//     ['marginStart', rawValue],
+//     ['marginEnd', rawValue],
+//   ],
+//   paddingInlineStart: (rawValue) => [['paddingStart', rawValue]],
+//   paddingInlineEnd: (rawValue) => [['paddingEnd', rawValue]],
+//   paddingInline: (rawValue) => [
+//     ['paddingStart', rawValue],
+//     ['paddingEnd', rawValue],
+//   ],
+//   // 'borderInlineStart': (rawValue) => [['borderStart', rawValue]],
+//   // 'borderInlineEnd': (rawValue) => [['borderEnd', rawValue]],
+//   // // This will need to change.
+//   // 'borderInline': (rawValue) => [
+//   //   ['borderStart', rawValue],
+//   //   ['borderEnd', rawValue],
+//   // ],
+// };
+
+/**
+ * Shorthand properties:
+ * - [x] all - Should be banned
+ * - [ ] animation
+ * - [ ] background
+ * - [-] border
+ * - [x] border-block-end
+ * - [x] border-block-start
+ * - [ ] border-bottom
+ * - [x] border-color
+ * - [x] border-image
+ * - [x] border-inline-end
+ * - [x] border-inline-start
+ * - [ ] border-left
+ * - [x] border-radius
+ * - [ ] border-right
+ * - [x] border-style
+ * - [ ] border-top
+ * - [x] border-width
+ * - [ ] column-rule
+ * - [ ] columns
+ * - [ ] flex
+ * - [ ] flex-flow
+ * - [ ] font
+ * - [ ] gap
+ * - [ ] grid
+ * - [ ] grid-area
+ * - [ ] grid-column
+ * - [ ] grid-row
+ * - [ ] grid-template
+ * - [ ] list-style
+ * - [x] margin
+ * - [ ] mask
+ * - [ ] offset
+ * - [ ] outline
+ * - [x] overflow
+ * - [x] padding
+ * - [ ] place-content
+ * - [ ] place-items
+ * - [ ] place-self
+ * - [ ] scroll-margin
+ * - [ ] scroll-padding
+ * - [ ] text-decoration
+ * - [ ] text-emphasis
+ * - [ ] transition
+ */
+
+const expansions = {
+  // ...aliases,
+  border: rawValue => {
+    return [['borderTop', rawValue], ['borderEnd', rawValue], ['borderBottom', rawValue], ['borderStart', rawValue]];
+  },
+  /*
+  // Add this later, as this will be a breaking change
+  border: (rawValue: string): Array<[string, string]> => {
+    if (typeof rawValue === 'number') {
+      return expansions.borderWidth(rawValue);
+    }
+    const [width, style, color] = splitValue(rawValue);
+    return [
+      ...expansions.borderWidth(width),
+      ...expansions.borderStyle(style),
+      ...expansions.borderColor(color),
+    ];
+  }
+  */
+  borderColor: rawValue => {
+    const [top, right = top, bottom = top, left = right] = (0, _splitCssValue.default)(rawValue);
+    return [['borderTopColor', top], ['borderEndColor', right], ['borderBottomColor', bottom], ['borderStartColor', left]];
+  },
+  borderHorizontal: rawValue => {
+    return [['borderStart', rawValue], ['borderEnd', rawValue]];
+  },
+  borderStyle: rawValue => {
+    const [top, right = top, bottom = top, left = right] = (0, _splitCssValue.default)(rawValue);
+    return [['borderTopStyle', top], ['borderEndStyle', right], ['borderBottomStyle', bottom], ['borderStartStyle', left]];
+  },
+  borderVertical: rawValue => {
+    return [['borderTop', rawValue], ['borderBottom', rawValue]];
+  },
+  borderWidth: rawValue => {
+    const [top, right = top, bottom = top, left = right] = typeof rawValue === 'number' ? [rawValue] : (0, _splitCssValue.default)(rawValue);
+    return [['borderTopWidth', top], ['borderEndWidth', right], ['borderBottomWidth', bottom], ['borderStartWidth', left]];
+  },
+  borderRadius: rawValue => {
+    const [top, right = top, bottom = top, left = right] = typeof rawValue === 'string' ? (0, _splitCssValue.default)(rawValue) : typeof rawValue === 'number' ? [rawValue] : rawValue; // remove
+
+    return [['borderTopStartRadius', top], ['borderTopEndRadius', right], ['borderBottomEndRadius', bottom], ['borderBottomStartRadius', left]];
+  },
+  margin: rawValue => {
+    const [top, right = top, bottom = top, left = right] = typeof rawValue === 'number' ? [rawValue] : (0, _splitCssValue.default)(rawValue);
+    return [['marginTop', top], ['marginEnd', right], ['marginBottom', bottom], ['marginStart', left]];
+  },
+  marginHorizontal: rawValue => {
+    return [['marginStart', rawValue], ['marginEnd', rawValue]];
+  },
+  marginVertical: rawValue => {
+    return [['marginTop', rawValue], ['marginBottom', rawValue]];
+  },
+  overflow: rawValue => {
+    const [x, y = x] = (0, _splitCssValue.default)(rawValue);
+    return [['overflowX', x], ['overflowY', y]];
+  },
+  padding: rawValue => {
+    const [top, right = top, bottom = top, left = right] = typeof rawValue === 'number' ? [rawValue] : (0, _splitCssValue.default)(rawValue);
+    return [['paddingTop', top], ['paddingEnd', right], ['paddingBottom', bottom], ['paddingStart', left]];
+  },
+  paddingHorizontal: rawValue => {
+    return [['paddingStart', rawValue], ['paddingEnd', rawValue]];
+  },
+  paddingVertical: rawValue => {
+    return [['paddingTop', rawValue], ['paddingBottom', rawValue]];
+  }
+};
+var _default = expansions;
+exports.default = _default;

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

@@ -0,0 +1,148 @@
+"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 }; }
+/**
+ * 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.
+ *
+ * 
+ */
+
+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];
+
+    // Included Styles
+    if (typeof value === 'object' && value instanceof _stylexInclude.IncludedStyles) {
+      flattened.push([key, new _PreRule.PreIncludedStylesRule(value)]);
+      continue;
+    }
+
+    // Default styles
+    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;
+    }
+
+    // Fallback Styles
+    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);
+          }
+        }
+      }
+      // Deduplicate
+      Object.entries(equivalentPairs)
+      // Remove Nulls
+      .map(_ref => {
+        let [property, values] = _ref;
+        return [property, [...new Set(values.filter(Boolean))]];
+      })
+      // Deduplicate and default to null when no values are found
+      .map(_ref2 => {
+        let [property, values] = _ref2;
+        return [property, values.length === 0 ? null : values.length === 1 ? values[0] : values];
+      })
+      // Push to flattened
+      .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;
+    }
+
+    // Object Values for propetiies. e.g. { color: { hover: 'red', default: 'blue' } }
+    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) {
+            // NOT POSSIBLE, but needed for Flow
+            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); //.sort();
+        const rules = [];
+        for (const condition of sortedKeys) {
+          rules.push(obj[condition]);
+        }
+        // If there are many conditions with `null` values, we will collapse them into a single `null` value.
+        // `PreRuleSet.create` takes care of that for us.
+        flattened.push([property, _PreRule.PreRuleSet.create(rules)]);
+      }
+    }
+
+    // Object Values for pseudos and at-rules. e.g. { ':hover': { color: 'red' } }
+    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;
+}