@stylexjs/shared 0.2.0-beta.10 → 0.2.0-beta.12

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * 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 spece around + and - as they are required in calc()
+ */
+
+declare function normalizeWhitespace(
+  ast: PostCSSValueAST,
+  _: unknown
+): PostCSSValueAST;
+export default normalizeWhitespace;

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

package/lib/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 and timings,
+ * in which case make them consistent 0deg and 0s.
+ */
+
+declare function normalizeZeroDimensions(
+  ast: PostCSSValueAST,
+  _: unknown
+): PostCSSValueAST;
+export default normalizeZeroDimensions;

package/lib/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 and timings,
+ * in which case make them consistent 0deg and 0s.
+ */
+
+declare export default function normalizeZeroDimensions(
+  ast: PostCSSValueAST,
+  _: mixed
+): PostCSSValueAST;

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

@@ -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.
+ *
+ *
+ */
+
+import type { CompiledStyles } from '../common-types';
+import { IncludedStyles } from '../stylex-include';
+export declare function isPlainObject(obj: unknown): boolean;
+export declare function flattenObject(obj: CompiledStyles): {
+  readonly [$$Key$$: string]: null | string | IncludedStyles;
+};
+export declare function objEntries<Obj extends {}>(
+  obj: Obj
+): ReadonlyArray<[keyof Obj, Obj[keyof Obj]]>;
+export declare function objValues<Obj extends {}>(
+  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 | number = string,
+  K2 extends string | number = string
+>(
+  obj: { readonly [$$Key$$: K1]: V },
+  mapper: ($$PARAM_0$$: K1) => K2
+): { readonly [$$Key$$: K2]: V };
+export declare function objMapEntry<
+  V,
+  V2,
+  K1 extends string | number = string,
+  K2 extends string | number = string
+>(
+  obj: { readonly [$$Key$$: K1]: V },
+  mapper: ($$PARAM_0$$: [K1, V]) => [K2, V2]
+): { readonly [$$Key$$: K2]: V2 };
+export declare function objMap<V, V2, K extends string | number = 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 var arraySort: <T>(
+  arr: ReadonlyArray<T>,
+  fn?: ($$PARAM_0$$: T, $$PARAM_1$$: T) => number
+) => ReadonlyArray<T>;
+export declare var arrayEquals: <T>(
+  arr1: ReadonlyArray<T>,
+  arr2: ReadonlyArray<T>,
+  equals: ($$PARAM_0$$: T, $$PARAM_1$$: T) => boolean
+) => boolean;

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

@@ -0,0 +1,81 @@
+/**
+ * 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';
+
+import { IncludedStyles } from '../stylex-include';
+
+declare export function isPlainObject(
+  obj: mixed
+): boolean %checks(typeof obj === 'object' &&
+  obj != null &&
+  !Array.isArray(obj) &&
+  obj?.constructor === Object);
+
+declare export function flattenObject(obj: CompiledStyles): {
+  +[string]: null | string | IncludedStyles,
+};
+
+declare export function objEntries<Obj: { ... }>(
+  obj: Obj
+): $ReadOnlyArray<[$Keys<Obj>, Obj[$Keys<Obj>]]>;
+
+declare export function objValues<Obj: { ... }>(
+  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 | number = string,
+  K2: string | number = string
+>(
+  obj: { +[K1]: V },
+  mapper: (K1) => K2
+): { +[K2]: V };
+
+declare export function objMapEntry<
+  V,
+  V2,
+  K1: string | number = string,
+  K2: string | number = string
+>(
+  obj: { +[K1]: V },
+  mapper: ([K1, V]) => [K2, V2]
+): { +[K2]: V2 };
+
+declare export function objMap<V, V2, K: string | number = 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 var arraySort: <T>(
+  arr: $ReadOnlyArray<T>,
+  fn?: (T, T) => number
+) => $ReadOnlyArray<T>;
+
+declare export var arrayEquals: <T>(
+  arr1: $ReadOnlyArray<T>,
+  arr2: $ReadOnlyArray<T>,
+  equals: (T, T) => boolean
+) => boolean;

package/lib/utils/property-priorities.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 getPriority(key: string): number;
+export default getPriority;

package/lib/utils/property-priorities.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 getPriority(key: string): number;

package/lib/utils/split-css-value.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.
+ *
+ *
+ *
+ */
+
+import type { TStyleValue } from '../common-types';
+declare function splitValue(
+  str: TStyleValue
+): ReadonlyArray<number | string | null>;
+export default splitValue;

package/lib/utils/split-css-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 { TStyleValue } from '../common-types';
+
+// Using split(' ') Isn't enough bcause of values like calc.
+declare export default function splitValue(
+  str: TStyleValue
+): $ReadOnlyArray<number | string | null>;

package/lib/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/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/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@stylexjs/shared",
-  "version": "0.2.0-beta.10",
-  "description": "Shared Code for Stylex compile and runtime.",
+  "version": "0.2.0-beta.12",
   "main": "lib/index.js",
-  "repository": "https://www.github.com/facebookexternal/stylex",
-  "author": "Naman Goel <nmn@fb.com>",
+  "repository": "https://www.github.com/facebook/stylex",
   "license": "MIT",
   "scripts": {
+    "prebuild": "gen-types -i src/ -o lib/",
     "build": "babel src/ --out-dir lib/ --copy-files",
     "test": "jest"
   },
@@ -14,6 +13,7 @@
     "postcss-value-parser": "^4.1.0"
   },
   "devDependencies": {
+    "@stylexjs/scripts": "0.2.0-beta.12",
     "typescript": "^4.7.4"
   },
   "jest": {

package/lib/expand-shorthands.d.ts

@@ -1,5 +0,0 @@
-export const BANNED_PROPERTIES: { [key: string]: string };
-export const expandedKeys: $ReadOnlyArray<string>;
-export default function flatMapExpandedShorthands<T>(
-  objEntry: [string, T]
-): Array<[string, T]>;