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

package/lib/stylex-create.js.flow

@@ -0,0 +1,30 @@
+/**
+ * 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 {
+  RawStyles,
+  InjectableStyle,
+  StyleXOptions,
+  FlatCompiledStyles,
+} from './common-types';
+
+// This takes the object of styles passed to `stylex.create` and transforms it.
+//   The transformation replaces style values with classNames.
+//
+// It also collects all injected styles along the way.
+// It then returns a tuple of the transformed style Object and an object of injected styles.
+//
+// This function does some basic validation, and then uses `styleXCreateNamespace` to transform
+// each namespace within,
+//
+// Before returning, it ensures that there are no duplicate styles being injected.
+declare export default function styleXCreateSet(
+  namespaces: { +[string]: RawStyles },
+  options?: StyleXOptions
+): [{ [string]: FlatCompiledStyles }, { [string]: InjectableStyle }];

package/lib/stylex-first-that-works.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 stylexFirstThatWorks<T>(
+  ...args: ReadonlyArray<T>
+): ReadonlyArray<T>;
+export default stylexFirstThatWorks;

package/lib/stylex-first-that-works.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 stylexFirstThatWorks<T>(
+  ...args: $ReadOnlyArray<T>
+): $ReadOnlyArray<T>;

package/lib/stylex-include.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.
+ *
+ *
+ *
+ */
+
+export declare class IncludedStyles {
+  astNode: any;
+  constructor(astNode: any);
+}
+declare function stylexInclude(
+  firstArg: any,
+  ...styles: any
+): { [key: string]: IncludedStyles };
+export default stylexInclude;

package/lib/stylex-include.js.flow

@@ -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.
+ *
+ * @flow strict
+ *
+ */
+
+declare export class IncludedStyles {
+  astNode: any;
+  constructor(astNode: any): void;
+}
+
+declare export default function stylexInclude(
+  firstArg: any,
+  ...styles: any
+): {
+  [key: string]: IncludedStyles,
+};

package/lib/stylex-keyframes.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.
+ *
+ *
+ */
+
+import type { InjectableStyle, StyleXOptions } from './common-types';
+declare function styleXKeyframes(
+  frames: {
+    readonly [$$Key$$: string]: { readonly [$$Key$$: string]: string | number };
+  },
+  options: StyleXOptions
+): [string, InjectableStyle];
+export default styleXKeyframes;

package/lib/stylex-keyframes.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+import type { InjectableStyle, StyleXOptions } from './common-types';
+
+// Similar to `stylex.create` it takes an object of keyframes
+// and returns a string after hashing it.
+//
+// It also expands shorthand properties to maintain parity with
+// `stylex.create`.
+declare export default function styleXKeyframes(
+  frames: { +[string]: { +[string]: string | number } },
+  options: StyleXOptions
+): [string, InjectableStyle];

package/lib/transform-value.d.ts

@@ -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.
+ *
+ */
+
+/**
+ * Convert a CSS value in JS to the final CSS string value
+ */
+declare function transformValue(key: string, rawValue: string | number): string;
+export default transformValue;

package/lib/transform-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
+ */
+
+/**
+ * Convert a CSS value in JS to the final CSS string value
+ */
+declare export default function transformValue(
+  key: string,
+  rawValue: string | number
+): string;

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;