@stylexjs/babel-plugin 0.0.0-6e16619c

package/lib/shared/utils/object-utils.js.flow

@@ -0,0 +1,78 @@
+/**
+ * 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
+ */
+
+// A bunch of object utils with better Flow types
+
+import type { CompiledStyles } from '../common-types';
+
+// eslint-disable-next-line no-unused-vars
+type AnyObject = { +[string]: mixed };
+
+declare export function isPlainObject(obj: mixed): obj is AnyObject;
+
+declare export function flattenObject(obj: CompiledStyles): {
+  +[string]: null | string,
+};
+
+type _ObjectEntries<Obj: { +[string]: mixed }> = {
+  [Key in keyof Obj]: [Key, Obj[Key]],
+};
+type ObjectEntries<Obj: { +[string]: mixed }> = $Values<_ObjectEntries<Obj>>;
+
+declare export function objEntries<Obj: { +[string]: mixed }>(
+  obj: Obj,
+): $ReadOnlyArray<ObjectEntries<Obj>>;
+
+declare export function objValues<Obj: { +[string]: mixed }>(
+  obj: Obj,
+): $ReadOnlyArray<Obj[$Keys<Obj>]>;
+
+declare export function objFromEntries<K: string | number, V>(
+  entries: $ReadOnlyArray<$ReadOnly<[K, V]>>,
+): { [K]: V };
+
+declare export function objMapKeys<V, K1: string = string, K2: string = string>(
+  obj: { +[K1]: V },
+  mapper: (K1) => K2,
+): { +[K2]: V };
+
+declare export function objMapEntry<
+  V,
+  V2,
+  K1: string = string,
+  K2: string = string,
+>(
+  obj: { +[K1]: V },
+  mapper: ($ReadOnly<[K1, V]>) => $ReadOnly<[K2, V2]>,
+): { +[K2]: V2 };
+
+declare export function objMap<V, V2, K: string = string>(
+  obj: { +[K]: V },
+  mapper: (V, K) => V2,
+): { +[K]: V2 };
+
+declare export class Pipe<T> {
+  value: T;
+  constructor(val: T): void;
+  pipe<T2>(mapper: (T) => T2): Pipe<T2>;
+  done(): T;
+  static create(val: T): Pipe<T>;
+}
+
+// Function that sorts an array without mutating it and returns a new array
+declare export const arraySort: <T>(
+  arr: $ReadOnlyArray<T>,
+  fn?: (T, T) => number,
+) => $ReadOnlyArray<T>;
+
+declare export const arrayEquals: <T>(
+  arr1: $ReadOnlyArray<T>,
+  arr2: $ReadOnlyArray<T>,
+  equals: (T, T) => boolean,
+) => boolean;

package/lib/shared/utils/property-priorities.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 const PSEUDO_CLASS_PRIORITIES: Readonly<{
+  [$$Key$$: string]: number;
+}>;
+type AtRulePriorities = { '@supports': 30; '@media': 200; '@container': 300 };
+export declare const AT_RULE_PRIORITIES: Readonly<AtRulePriorities>;
+export declare const PSEUDO_ELEMENT_PRIORITY: number;
+declare function getPriority(key: string): number;
+export default getPriority;

package/lib/shared/utils/property-priorities.js.flow

@@ -0,0 +1,78 @@
+/**
+ * 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
+ */
+
+// type PseudoClassPriorities = {
+//   ':is': 40,
+//   ':where': 40,
+//   ':not': 40,
+//   ':has': 45,
+//   ':dir': 50,
+//   ':lang': 51,
+//   ':first-child': 52,
+//   ':first-of-type': 53,
+//   ':last-child': 54,
+//   ':last-of-type': 55,
+//   ':only-child': 56,
+//   ':only-of-type': 57,
+//   ':nth-child': 60,
+//   ':nth-last-child': 61,
+//   ':nth-of-type': 62,
+//   ':nth-last-of-type': 63, // 'nth-last-of-type' is the same priority as 'nth-of-type
+//   ':empty': 70,
+//   ':link': 80,
+//   ':any-link': 81,
+//   ':local-link': 82,
+//   ':target-within': 83,
+//   ':target': 84,
+//   ':visited': 85,
+//   ':enabled': 91,
+//   ':disabled': 92,
+//   ':required': 93,
+//   ':optional': 94,
+//   ':read-only': 95,
+//   ':read-write': 96,
+//   ':placeholder-shown': 97,
+//   ':in-range': 98,
+//   ':out-of-range': 99,
+//   ':default': 100,
+//   ':checked': 101,
+//   ':indeterminate': 101,
+//   ':blank': 102,
+//   ':valid': 103,
+//   ':invalid': 104,
+//   ':user-invalid': 105,
+//   ':autofill': 110,
+//   ':picture-in-picture': 120,
+//   ':modal': 121,
+//   ':fullscreen': 122,
+//   ':paused': 123,
+//   ':playing': 124,
+//   ':current': 125,
+//   ':past': 126,
+//   ':future': 127,
+//   ':hover': 130,
+//   ':focusWithin': 140,
+//   ':focus': 150,
+//   ':focusVisible': 160,
+//   ':active': 170,
+// };
+
+declare export const PSEUDO_CLASS_PRIORITIES: $ReadOnly<{ [string]: number }>;
+
+type AtRulePriorities = {
+  '@supports': 30,
+  '@media': 200,
+  '@container': 300,
+};
+
+declare export const AT_RULE_PRIORITIES: $ReadOnly<AtRulePriorities>;
+
+declare export const PSEUDO_ELEMENT_PRIORITY: number;
+
+declare export default function getPriority(key: string): number;

package/lib/shared/utils/rule-utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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 const sortPseudos: (
+  pseudos: ReadonlyArray<string>,
+) => ReadonlyArray<string>;
+export declare const sortAtRules: (
+  atRules: ReadonlyArray<string>,
+) => ReadonlyArray<string>;

package/lib/shared/utils/rule-utils.js.flow

@@ -0,0 +1,16 @@
+/**
+ * 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 const sortPseudos: (
+  pseudos: $ReadOnlyArray<string>,
+) => $ReadOnlyArray<string>;
+
+declare export const sortAtRules: (
+  atRules: $ReadOnlyArray<string>,
+) => $ReadOnlyArray<string>;

package/lib/shared/utils/split-css-value.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 { TStyleValue } from '../common-types';
+declare function splitValue(
+  str: TStyleValue,
+): ReadonlyArray<number | string | null>;
+export default splitValue;

package/lib/shared/utils/split-css-value.js.flow

@@ -0,0 +1,15 @@
+/**
+ * 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';
+
+// Using split(' ') Isn't enough because of values like calc.
+declare export default function splitValue(
+  str: TStyleValue,
+): $ReadOnlyArray<number | string | null>;

package/lib/shared/utils/transform-value.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 } from '../common-types';
+/**
+ * Convert a CSS value in JS to the final CSS string value
+ */
+declare function transformValue(
+  key: string,
+  rawValue: string | number,
+  options: StyleXOptions,
+): string;
+export default transformValue;
+export declare function getNumberSuffix(key: string): string;
+export declare const timeUnits: Set<string>;
+export declare const lengthUnits: Set<string>;

package/lib/shared/utils/transform-value.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+import type { StyleXOptions } from '../common-types';
+
+/**
+ * Convert a CSS value in JS to the final CSS string value
+ */
+declare export default function transformValue(
+  key: string,
+  rawValue: string | number,
+  options: StyleXOptions,
+): string;
+
+declare export function getNumberSuffix(key: string): string;
+
+declare export const timeUnits: Set<string>;
+
+declare export const lengthUnits: Set<string>;

package/lib/shared/validate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 { TRawValue } from './common-types';
+declare function validateEntry($$PARAM_0$$: [string, TRawValue]): void;
+export default validateEntry;

package/lib/shared/validate.js.flow

@@ -0,0 +1,12 @@
+/**
+ * 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 { TRawValue } from './common-types';
+
+declare export default function validateEntry([string, TRawValue]): void;

package/lib/utils/add-sourcemap-data.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 { NodePath } from '@babel/traverse';
+import type { CompiledNamespaces } from '../shared';
+import * as t from '@babel/types';
+import StateManager from './state-manager';
+/**
+ * Adds sourceMap data to objects created with stylex.create.
+ * Populates the '$$css' property, which the runtime uses to produce a
+ * debug string.
+ */
+export declare function addSourceMapData(
+  obj: CompiledNamespaces,
+  babelPath: NodePath<t.CallExpression>,
+  state: StateManager,
+): CompiledNamespaces;

package/lib/utils/add-sourcemap-data.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+import type { NodePath } from '../../flow_modules/@babel/traverse';
+import type { CompiledNamespaces } from '../shared';
+
+import * as t from '../../flow_modules/@babel/types';
+import StateManager from './state-manager';
+
+/**
+ * Adds sourceMap data to objects created with stylex.create.
+ * Populates the '$$css' property, which the runtime uses to produce a
+ * debug string.
+ */
+declare export function addSourceMapData(
+  obj: CompiledNamespaces,
+  babelPath: NodePath<t.CallExpression>,
+  state: StateManager,
+): CompiledNamespaces;

package/lib/utils/ast-helpers.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 { ImportOptions } from '@babel/helper-module-imports';
+import type { NodePath } from '@babel/traverse';
+type ImportAdditionOptions = Omit<
+  Partial<ImportOptions>,
+  'ensureLiveReference' | 'ensureNoContext'
+>;
+import * as t from '@babel/types';
+export declare function hoistExpression(
+  path: NodePath,
+  astExpression: t.Expression,
+): t.Expression;
+export declare function pathReplaceHoisted(
+  path: NodePath,
+  astExpression: t.Expression,
+): void;
+export declare function addNamedImport(
+  statementPath: NodePath,
+  as: string,
+  from: string,
+  options: ImportAdditionOptions,
+): t.Identifier;
+export declare function addDefaultImport(
+  statementPath: NodePath,
+  from: string,
+  options: ImportAdditionOptions,
+): t.Identifier;
+export declare function isProgramLevel(path: NodePath): boolean;
+export declare function getProgramStatement(path: NodePath): NodePath;

package/lib/utils/ast-helpers.js.flow

@@ -0,0 +1,44 @@
+/**
+ * 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 { ImportOptions } from '../../flow_modules/@babel/helper-module-imports';
+import type { NodePath } from '../../flow_modules/@babel/traverse';
+type ImportAdditionOptions = Omit<
+  Partial<ImportOptions>,
+  'ensureLiveReference' | 'ensureNoContext',
+>;
+
+import * as t from '../../flow_modules/@babel/types';
+
+declare export function hoistExpression(
+  path: NodePath<>,
+  astExpression: t.Expression,
+): t.Expression;
+
+declare export function pathReplaceHoisted(
+  path: NodePath<>,
+  astExpression: t.Expression,
+): void;
+
+declare export function addNamedImport(
+  statementPath: NodePath<>,
+  as: string,
+  from: string,
+  options: ImportAdditionOptions,
+): t.Identifier;
+
+declare export function addDefaultImport(
+  statementPath: NodePath<>,
+  from: string,
+  options: ImportAdditionOptions,
+): t.Identifier;
+
+declare export function isProgramLevel(path: NodePath<>): boolean;
+
+declare export function getProgramStatement(path: NodePath<>): NodePath<>;

package/lib/utils/dev-classname.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 { CompiledNamespaces } from '../shared';
+import StateManager from './state-manager';
+export declare function namespaceToDevClassName(
+  namespace: string,
+  varName: null | string,
+  filename: string,
+): string;
+export declare function injectDevClassNames(
+  obj: CompiledNamespaces,
+  varName: null | string,
+  state: StateManager,
+): CompiledNamespaces;
+export declare function convertToTestStyles(
+  obj: CompiledNamespaces,
+  varName: null | string,
+  state: StateManager,
+): CompiledNamespaces;

package/lib/utils/dev-classname.js.flow

@@ -0,0 +1,32 @@
+/**
+ * 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 { CompiledNamespaces } from '../shared';
+
+import StateManager from './state-manager';
+
+// TODO: We will need to maintain the full path to the file eventually
+// Perhaps this can be an option that is passed in.
+declare export function namespaceToDevClassName(
+  namespace: string,
+  varName: null | string,
+  filename: string,
+): string;
+
+declare export function injectDevClassNames(
+  obj: CompiledNamespaces,
+  varName: null | string,
+  state: StateManager,
+): CompiledNamespaces;
+
+declare export function convertToTestStyles(
+  obj: CompiledNamespaces,
+  varName: null | string,
+  state: StateManager,
+): CompiledNamespaces;

package/lib/utils/evaluate-path.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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.
+ *
+ *
+ */
+
+/**
+ * This is a extended version of the path evaluation code from Babel.
+ *
+ * The original can be found at:
+ * https://github.com/babel/babel/blob/main/packages/babel-traverse/src/path/evaluation.ts
+ *
+ * The following extensions were made:
+ * - It can accept a mapping from variable names to functions
+ *   which when encountered will be evaluated instead of deopting.
+ *   - The functions can be configured to accept the raw path instead of
+ *     static values to handle dynamic values.
+ * - It can handle object spreads when the spread value itself is statically evaluated.
+ */
+
+import type { NodePath } from '@babel/traverse';
+import * as t from '@babel/types';
+import StateManager from './state-manager';
+export type FunctionConfig = {
+  identifiers: { [fnName: string]: any };
+  memberExpressions: {
+    [key: string]: {
+      [memberName: string]: {
+        fn: (...args: any[]) => any;
+        takesPath?: boolean;
+      };
+    };
+  };
+};
+type Result =
+  | { resolved: true; value: any }
+  | { resolved: false; reason: string };
+export declare function evaluate(
+  path: NodePath,
+  traversalState: StateManager,
+  functions: FunctionConfig,
+  seen: Map<t.Node, Result>,
+): Readonly<{
+  confident: boolean;
+  value: any;
+  deopt?: null | NodePath;
+  reason?: string;
+}>;

package/lib/utils/evaluate-path.js.flow

@@ -0,0 +1,61 @@
+/**
+ * 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
+ */
+
+/**
+ * This is a extended version of the path evaluation code from Babel.
+ *
+ * The original can be found at:
+ * https://github.com/babel/babel/blob/main/packages/babel-traverse/src/path/evaluation.ts
+ *
+ * The following extensions were made:
+ * - It can accept a mapping from variable names to functions
+ *   which when encountered will be evaluated instead of deopting.
+ *   - The functions can be configured to accept the raw path instead of
+ *     static values to handle dynamic values.
+ * - It can handle object spreads when the spread value itself is statically evaluated.
+ */
+
+import type { NodePath } from '../../flow_modules/@babel/traverse';
+
+import * as t from '../../flow_modules/@babel/types';
+import StateManager from './state-manager';
+export type FunctionConfig = {
+  identifiers: {
+    [fnName: string]: $FlowFixMe,
+  },
+  memberExpressions: {
+    [key: string]: {
+      [memberName: string]: {
+        fn: (...args: $FlowFixMe[]) => $FlowFixMe,
+        takesPath?: boolean,
+      },
+    },
+  },
+};
+
+type Result =
+  | {
+      resolved: true,
+      value: any,
+    }
+  | {
+      resolved: false,
+      reason: string,
+    };
+declare export function evaluate(
+  path: NodePath<>,
+  traversalState: StateManager,
+  functions: FunctionConfig,
+  seen: Map<t.Node, Result>,
+): $ReadOnly<{
+  confident: boolean,
+  value: any,
+  deopt?: null | NodePath<>,
+  reason?: string,
+}>;

package/lib/utils/evaluation-errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 const IMPORT_FILE_PARSING_ERROR: any;
+export declare const IMPORT_FILE_EVAL_ERROR: any;
+export declare const DEFAULT_IMPORT: any;
+export declare const PATH_WITHOUT_NODE: any;
+export declare const UNEXPECTED_MEMBER_LOOKUP: any;
+export declare const IMPORT_PATH_RESOLUTION_ERROR: any;
+export declare const NON_CONSTANT: 'Referenced value is not a constant.\n\n';
+export declare const USED_BEFORE_DECLARATION: 'Referenced value is used before declaration.\n\n';
+export declare const UNINITIALIZED_CONST: 'Referenced constant is not initialized.\n\n';
+export declare const UNDEFINED_CONST: 'Referenced constant is not defined.';
+export declare const UNSUPPORTED_OPERATOR: (op: string) => string;
+export declare const OBJECT_METHOD: 'Unsupported object method.\n\n';
+export declare const UNSUPPORTED_EXPRESSION: (type: string) => string;

package/lib/utils/evaluation-errors.js.flow

@@ -0,0 +1,35 @@
+/**
+ * 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 const IMPORT_FILE_PARSING_ERROR: $FlowFixMe;
+
+// export const
+declare export const IMPORT_FILE_EVAL_ERROR: $FlowFixMe;
+
+declare export const DEFAULT_IMPORT: $FlowFixMe;
+
+declare export const PATH_WITHOUT_NODE: $FlowFixMe;
+
+declare export const UNEXPECTED_MEMBER_LOOKUP: $FlowFixMe;
+
+declare export const IMPORT_PATH_RESOLUTION_ERROR: $FlowFixMe;
+
+declare export const NON_CONSTANT: 'Referenced value is not a constant.\n\n';
+
+declare export const USED_BEFORE_DECLARATION: 'Referenced value is used before declaration.\n\n';
+
+declare export const UNINITIALIZED_CONST: 'Referenced constant is not initialized.\n\n';
+
+declare export const UNDEFINED_CONST: 'Referenced constant is not defined.';
+
+declare export const UNSUPPORTED_OPERATOR: (op: string) => string;
+
+declare export const OBJECT_METHOD: 'Unsupported object method.\n\n';
+
+declare export const UNSUPPORTED_EXPRESSION: (type: string) => string;