@stylexjs/shared 0.2.0-beta.11 → 0.2.0-beta.13

package/lib/utils/Rule.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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 could be an interface, but we use a class so that we can
+ * use instanceof to check for it.
+ */
+export declare class Rule<V> {}
+/**
+ * This is a class that represents a raw style rule.
+ *
+ * It exists to track the actual CSS rule that should be compiled
+ * even as we transform the structure of the RawStyles object.
+ */
+export declare class RawRule<V> extends Rule<V> {
+  readonly key: string;
+  readonly value: V;
+  readonly psuedos: null | undefined | ReadonlyArray<string>;
+  readonly atRules: null | undefined | ReadonlyArray<string>;
+  constructor(
+    key: string,
+    value: V,
+    psuedos: null | undefined | ReadonlyArray<string>,
+    atRules: null | undefined | ReadonlyArray<string>
+  );
+}
+export declare class RawRuleList<V> extends Rule<V> {
+  readonly rules: ReadonlyArray<Rule<V>>;
+  constructor(rules: ReadonlyArray<Rule<V>>);
+}
+export declare class RawRuleRTLTuple<V1, V2> extends Rule<V1 | V2> {
+  readonly rules: [RawRule<V1>, RawRule<V2>];
+  constructor(rule1: RawRule<V1>, rule2: RawRule<V2>);
+}
+export declare class CompiledRule<V> extends Rule<V> {
+  readonly key: string;
+  readonly value: V;
+  readonly psuedos: null | undefined | ReadonlyArray<string>;
+  readonly atRules: null | undefined | ReadonlyArray<string>;
+  readonly className: string;
+  constructor(
+    key: string,
+    value: V,
+    psuedos: null | undefined | ReadonlyArray<string>,
+    atRules: null | undefined | ReadonlyArray<string>,
+    className: string
+  );
+}
+export declare class CompiledRuleTuple2<V1, V2> extends Rule<V1 | V2> {
+  readonly rules: [CompiledRule<V1>, CompiledRule<V2>];
+  constructor(rule1: CompiledRule<V1>, rule2: CompiledRule<V2>);
+}

package/lib/utils/Rule.js.flow

@@ -0,0 +1,64 @@
+/**
+ * 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 could be an interface, but we use a class so that we can
+ * use instanceof to check for it.
+ */
+// eslint-disable-next-line no-unused-vars
+declare export class Rule<+V> {}
+
+/**
+ * This is a class that represents a raw style rule.
+ *
+ * It exists to track the actual CSS rule that should be compiled
+ * even as we transform the structure of the RawStyles object.
+ */
+declare export class RawRule<V> extends Rule<V> {
+  +key: string;
+  +value: V;
+  +psuedos: ?$ReadOnlyArray<string>;
+  +atRules: ?$ReadOnlyArray<string>;
+  constructor(
+    key: string,
+    value: V,
+    psuedos: ?$ReadOnlyArray<string>,
+    atRules: ?$ReadOnlyArray<string>
+  ): void;
+}
+
+declare export class RawRuleList<V> extends Rule<V> {
+  +rules: $ReadOnlyArray<Rule<V>>;
+  constructor(rules: $ReadOnlyArray<Rule<V>>): void;
+}
+
+declare export class RawRuleRTLTuple<V1, V2> extends Rule<V1 | V2> {
+  +rules: [RawRule<V1>, RawRule<V2>];
+  constructor(rule1: RawRule<V1>, rule2: RawRule<V2>): void;
+}
+
+declare export class CompiledRule<V> extends Rule<V> {
+  +key: string;
+  +value: V;
+  +psuedos: ?$ReadOnlyArray<string>;
+  +atRules: ?$ReadOnlyArray<string>;
+  +className: string;
+  constructor(
+    key: string,
+    value: V,
+    psuedos: ?$ReadOnlyArray<string>,
+    atRules: ?$ReadOnlyArray<string>,
+    className: string
+  ): void;
+}
+
+declare export class CompiledRuleTuple2<V1, V2> extends Rule<V1 | V2> {
+  +rules: [CompiledRule<V1>, CompiledRule<V2>];
+  constructor(rule1: CompiledRule<V1>, rule2: CompiledRule<V2>): void;
+}

package/lib/utils/dashify.d.ts

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

package/lib/utils/dashify.js.flow

@@ -0,0 +1,9 @@
+/**
+ * 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/utils/default-options.d.ts

@@ -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.
+ *
+ */
+
+import type { StyleXOptions } from '../common-types';
+export declare var defaultOptions: StyleXOptions;

package/lib/utils/default-options.js.flow

@@ -0,0 +1,24 @@
+/**
+ * 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';
+
+// {
+//   ...options,
+//   dev: !!(options as any).dev,
+//   test: !!(options as any).test,
+//   stylexSheetName: (options as any).stylexSheetName ?? undefined,
+//   classNamePrefix: (options as any).classNamePrefix ?? 'x',
+//   importSources: (options as any).importSources ?? [name, 'stylex'],
+//   definedStylexCSSVariables:
+//     (options as any).definedStylexCSSVariables ?? {},
+//   genConditionalClasses: !!(options as any).genConditionalClasses,
+//   skipShorthandExpansion: !!(options as any).skipShorthandExpansion,
+// } as StyleXOptions;
+
+declare export var defaultOptions: StyleXOptions;

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

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

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = genFileBasedIdentifier;
+/**
+ * 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 genFileBasedIdentifier(_ref) {
+  let {
+    fileName,
+    exportName,
+    key
+  } = _ref;
+  return `${fileName}//${exportName}${key != null ? `.${key}` : ''}`;
+}

package/lib/utils/file-based-identifier.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 genFileBasedIdentifier({
+  +fileName: string,
+  +exportName: string,
+  +key?: string,
+}): string;

package/lib/utils/genCSSRule.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.
+ *
+ *
+ *
+ */
+
+export declare function genCSSRule(
+  className: string,
+  decls: string,
+  pseudos: ReadonlyArray<string>,
+  atRules: ReadonlyArray<string>
+): string;

package/lib/utils/genCSSRule.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 function genCSSRule(
+  className: string,
+  decls: string,
+  pseudos: $ReadOnlyArray<string>,
+  atRules: $ReadOnlyArray<string>
+): string;

package/lib/utils/normalize-value.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.
+ *
+ *
+ *
+ */
+
+declare function normalizeValue(value: string, key: string): string;
+export default normalizeValue;

package/lib/utils/normalize-value.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 normalizeValue(
+  value: string,
+  key: string
+): string;

package/lib/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/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/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/utils/normalizers/font-size-px-to-rem.js

@@ -9,7 +9,12 @@
 
 'use strict';
 
-const parser = require('postcss-value-parser');
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = convertFontSizeToRem;
+var _postcssValueParser = _interopRequireDefault(require("postcss-value-parser"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const ROOT_FONT_SIZE = 16;
 
 /**
@@ -17,7 +22,7 @@ const ROOT_FONT_SIZE = 16;
  * This will allow developers to continue thinking and using what's familiar
  * while we output font sizes that are adjustable
  */
-module.exports = function convertFontSizeToRem(ast, key) {
+function convertFontSizeToRem(ast, key) {
   if (key !== 'fontSize') {
     return ast;
   }
@@ -25,10 +30,10 @@ module.exports = function convertFontSizeToRem(ast, key) {
     if (node.type !== 'word') {
       return;
     }
-    const dimension = parser.unit(node.value);
+    const dimension = _postcssValueParser.default.unit(node.value);
     if (dimension && dimension.unit === 'px') {
       node.value = `${parseFloat(dimension.number) / ROOT_FONT_SIZE}rem`;
     }
   });
   return ast;
-};
+}

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

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

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;