@stylexjs/babel-plugin 0.11.1 → 0.13.0

package/lib/shared/utils/convert-to-className.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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, StyleRule, StyleXOptions } from '../common-types';
+export declare function convertStyleToClassName(
+  objEntry: Readonly<[string, TRawValue]>,
+  pseudos: ReadonlyArray<string>,
+  atRules: ReadonlyArray<string>,
+  constRules: ReadonlyArray<string>,
+  options: StyleXOptions,
+): StyleRule;
+declare function variableFallbacks(
+  values: ReadonlyArray<string>,
+): ReadonlyArray<string>;
+export default variableFallbacks;

package/lib/shared/utils/convert-to-className.js.flow

@@ -0,0 +1,29 @@
+/**
+ * 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, StyleRule, StyleXOptions } from '../common-types';
+
+// This function takes a single style rule and transforms it into a CSS rule.
+// [color: 'red'] => ['color', 'classname-for-color-red', CSSRULE{ltr, rtl, priority}]
+//
+// It converts the camelCased style key to a dash-separated key.
+// Handles RTL-flipping
+// Hashes to get a className
+// Returns the final key, className a CSS Rule
+declare export function convertStyleToClassName(
+  objEntry: $ReadOnly<[string, TRawValue]>,
+  pseudos: $ReadOnlyArray<string>,
+  atRules: $ReadOnlyArray<string>,
+  constRules: $ReadOnlyArray<string>,
+  options: StyleXOptions,
+): StyleRule;
+
+declare export default function variableFallbacks(
+  values: $ReadOnlyArray<string>,
+): $ReadOnlyArray<string>;

package/lib/shared/utils/dashify.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ *
+ *
+ */
+
+declare function dashify(str: string): string;
+export default dashify;

package/lib/shared/utils/dashify.js.flow

@@ -0,0 +1,10 @@
+/**
+ * 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 default function dashify(str: string): string;

package/lib/shared/utils/default-options.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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';
+export declare const defaultOptions: StyleXOptions;

package/lib/shared/utils/default-options.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 { StyleXOptions } from '../common-types';
+
+declare export const defaultOptions: StyleXOptions;

package/lib/shared/utils/file-based-identifier.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.
+ *
+ *
+ */
+
+declare function genFileBasedIdentifier($$PARAM_0$$: {
+  readonly fileName: string;
+  readonly exportName: string;
+  readonly key?: string;
+}): string;
+export default genFileBasedIdentifier;

package/lib/shared/utils/file-based-identifier.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+declare export default function genFileBasedIdentifier({
+  +fileName: string,
+  +exportName: string,
+  +key?: string,
+}): string;

package/lib/shared/utils/generate-css-rule.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 { InjectableStyle } from '../common-types';
+export declare function generateCSSRule(
+  className: string,
+  key: string,
+  value: string | ReadonlyArray<string>,
+  pseudos: ReadonlyArray<string>,
+  atRules: ReadonlyArray<string>,
+  constRules: ReadonlyArray<string>,
+): InjectableStyle;

package/lib/shared/utils/generate-css-rule.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 { InjectableStyle } from '../common-types';
+
+declare export function generateCSSRule(
+  className: string,
+  key: string,
+  value: string | $ReadOnlyArray<string>,
+  pseudos: $ReadOnlyArray<string>,
+  atRules: $ReadOnlyArray<string>,
+  constRules: $ReadOnlyArray<string>,
+): InjectableStyle;

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

@@ -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.
+ *
+ *
+ */
+
+import type { StyleXOptions } from '../common-types';
+declare function normalizeValue(
+  value: string,
+  key: string,
+  $$PARAM_2$$: StyleXOptions,
+): string;
+export default normalizeValue;

package/lib/shared/utils/normalize-value.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
+ */
+
+import type { StyleXOptions } from '../common-types';
+
+declare export default function normalizeValue(
+  value: string,
+  key: string,
+  StyleXOptions,
+): string;

package/lib/shared/utils/normalizers/convert-camel-case-values.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.
+ *
+ *
+ */
+
+declare function convertCamelCasedValues(
+  ast: PostCSSValueAST,
+  key: string,
+): PostCSSValueAST;
+export default convertCamelCasedValues;

package/lib/shared/utils/normalizers/convert-camel-case-values.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 default function convertCamelCasedValues(
+  ast: PostCSSValueAST,
+  key: string,
+): PostCSSValueAST;

package/lib/shared/utils/normalizers/detect-unclosed-fns.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.
+ *
+ *
+ */
+
+/**
+ * Remove leading zeros from numbers
+ */
+declare function detectUnclosedFns(
+  ast: PostCSSValueAST,
+  _: unknown,
+): PostCSSValueAST;
+export default detectUnclosedFns;

package/lib/shared/utils/normalizers/detect-unclosed-fns.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
+ */
+
+/**
+ * Remove leading zeros from numbers
+ */
+declare export default function detectUnclosedFns(
+  ast: PostCSSValueAST,
+  _: mixed,
+): PostCSSValueAST;

package/lib/shared/utils/normalizers/font-size-px-to-rem.d.ts

@@ -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.
+ *
+ *
+ */
+
+/**
+ * Convert font sizes from absolute unit `px` to relative unit `rem`.
+ * This will allow developers to continue thinking and using what's familiar
+ * while we output font sizes that are adjustable
+ */
+declare function convertFontSizeToRem(
+  ast: PostCSSValueAST,
+  key: string,
+): PostCSSValueAST;
+export default convertFontSizeToRem;

package/lib/shared/utils/normalizers/font-size-px-to-rem.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+/**
+ * Convert font sizes from absolute unit `px` to relative unit `rem`.
+ * This will allow developers to continue thinking and using what's familiar
+ * while we output font sizes that are adjustable
+ */
+declare export default function convertFontSizeToRem(
+  ast: PostCSSValueAST,
+  key: string,
+): PostCSSValueAST;

package/lib/shared/utils/normalizers/leading-zero.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.
+ *
+ *
+ */
+
+/**
+ * Remove leading zeros from numbers
+ */
+declare function normalizeLeadingZero(
+  ast: PostCSSValueAST,
+  _: unknown,
+): PostCSSValueAST;
+export default normalizeLeadingZero;

package/lib/shared/utils/normalizers/leading-zero.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
+ */
+
+/**
+ * Remove leading zeros from numbers
+ */
+declare export default function normalizeLeadingZero(
+  ast: PostCSSValueAST,
+  _: mixed,
+): PostCSSValueAST;

package/lib/shared/utils/normalizers/quotes.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.
+ *
+ *
+ */
+
+/**
+ * Make empty strings use consistent double quotes
+ */
+
+declare function normalizeQuotes(
+  ast: PostCSSValueAST,
+  _: unknown,
+): PostCSSValueAST;
+export default normalizeQuotes;

package/lib/shared/utils/normalizers/quotes.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+/**
+ * Make empty strings use consistent double quotes
+ */
+
+declare export default function normalizeQuotes(
+  ast: PostCSSValueAST,
+  _: mixed,
+): PostCSSValueAST;

package/lib/shared/utils/normalizers/timings.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.
+ *
+ *
+ */
+
+/**
+ * Turn millisecond values to seconds (shorter), except when < 10ms
+ */
+
+declare function normalizeTimings(
+  ast: PostCSSValueAST,
+  _: unknown,
+): PostCSSValueAST;
+export default normalizeTimings;

package/lib/shared/utils/normalizers/timings.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+/**
+ * Turn millisecond values to seconds (shorter), except when < 10ms
+ */
+
+declare export default function normalizeTimings(
+  ast: PostCSSValueAST,
+  _: mixed,
+): PostCSSValueAST;

package/lib/shared/utils/normalizers/whitespace.d.ts

@@ -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.
+ *
+ *
+ */
+
+/**
+ * Use single spaces and remove spaces when not needed: around functions,
+ * commas. But preserve space around + and - as they are required in calc()
+ */
+
+declare function normalizeWhitespace(
+  ast: PostCSSValueAST,
+  _: unknown,
+): PostCSSValueAST;
+export default normalizeWhitespace;

package/lib/shared/utils/normalizers/whitespace.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+/**
+ * Use single spaces and remove spaces when not needed: around functions,
+ * commas. But preserve space around + and - as they are required in calc()
+ */
+
+declare export default function normalizeWhitespace(
+  ast: PostCSSValueAST,
+  _: mixed,
+): PostCSSValueAST;

package/lib/shared/utils/normalizers/zero-dimensions.d.ts

@@ -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.
+ *
+ *
+ */
+
+/**
+ * Remove units in zero values, except when required: in angles, timings, fractions, and percentages,
+ * in which case make them consistent 0deg, 0s, 0fr, and 0%.
+ */
+
+declare function normalizeZeroDimensions(
+  ast: PostCSSValueAST,
+  _: unknown,
+): PostCSSValueAST;
+export default normalizeZeroDimensions;

package/lib/shared/utils/normalizers/zero-dimensions.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+/**
+ * Remove units in zero values, except when required: in angles, timings, fractions, and percentages,
+ * in which case make them consistent 0deg, 0s, 0fr, and 0%.
+ */
+
+declare export default function normalizeZeroDimensions(
+  ast: PostCSSValueAST,
+  _: mixed,
+): PostCSSValueAST;

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

@@ -0,0 +1,66 @@
+/**
+ * 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 { CompiledStyles } from '../common-types';
+type AnyObject = { readonly [$$Key$$: string]: unknown };
+export declare function isPlainObject(obj: unknown): obj is AnyObject;
+export declare function flattenObject(obj: CompiledStyles): {
+  readonly [$$Key$$: string]: null | string;
+};
+type _ObjectEntries<Obj extends { readonly [$$Key$$: string]: unknown }> = {
+  [Key in keyof Obj]: [Key, Obj[Key]];
+};
+type ObjectEntries<Obj extends { readonly [$$Key$$: string]: unknown }> =
+  _ObjectEntries<Obj>[keyof _ObjectEntries<Obj>];
+export declare function objEntries<
+  Obj extends { readonly [$$Key$$: string]: unknown },
+>(obj: Obj): ReadonlyArray<ObjectEntries<Obj>>;
+export declare function objValues<
+  Obj extends { readonly [$$Key$$: string]: unknown },
+>(obj: Obj): ReadonlyArray<Obj[keyof Obj]>;
+export declare function objFromEntries<K extends string | number, V>(
+  entries: ReadonlyArray<Readonly<[K, V]>>,
+): { [$$Key$$: K]: V };
+export declare function objMapKeys<
+  V,
+  K1 extends string = string,
+  K2 extends string = string,
+>(
+  obj: { readonly [$$Key$$: K1]: V },
+  mapper: ($$PARAM_0$$: K1) => K2,
+): { readonly [$$Key$$: K2]: V };
+export declare function objMapEntry<
+  V,
+  V2,
+  K1 extends string = string,
+  K2 extends string = string,
+>(
+  obj: { readonly [$$Key$$: K1]: V },
+  mapper: ($$PARAM_0$$: Readonly<[K1, V]>) => Readonly<[K2, V2]>,
+): { readonly [$$Key$$: K2]: V2 };
+export declare function objMap<V, V2, K extends string = string>(
+  obj: { readonly [$$Key$$: K]: V },
+  mapper: ($$PARAM_0$$: V, $$PARAM_1$$: K) => V2,
+): { readonly [$$Key$$: K]: V2 };
+export declare class Pipe<T> {
+  value: T;
+  constructor(val: T);
+  pipe<T2>(mapper: ($$PARAM_0$$: T) => T2): Pipe<T2>;
+  done(): T;
+  static create(val: T): Pipe<T>;
+}
+export declare const arraySort: <T>(
+  arr: ReadonlyArray<T>,
+  fn?: ($$PARAM_0$$: T, $$PARAM_1$$: T) => number,
+) => ReadonlyArray<T>;
+export declare const arrayEquals: <T>(
+  arr1: ReadonlyArray<T>,
+  arr2: ReadonlyArray<T>,
+  equals: ($$PARAM_0$$: T, $$PARAM_1$$: T) => boolean,
+) => boolean;

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): implies 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;