@stylexjs/babel-plugin 0.16.3 → 0.17.1

package/lib/utils/state-manager.d.ts

@@ -45,31 +45,32 @@ type ModuleResolution =
 export type StyleXOptions = Readonly<
   Omit<
     RuntimeOptions,
-    keyof ({
-      aliases?:
-        | null
-        | undefined
-        | Readonly<{ [$$Key$$: string]: string | ReadonlyArray<string> }>;
-      enableDebugClassNames?: boolean;
-      enableDebugDataProp?: boolean;
-      enableDevClassNames?: boolean;
-      enableInlinedConditionalMerge?: boolean;
-      enableMediaQueryOrder?: boolean;
-      enableLegacyValueFlipping?: boolean;
-      enableLogicalStylesPolyfill?: boolean;
-      enableLTRRTLComments?: boolean;
-      enableMinifiedKeys?: boolean;
-      importSources: ReadonlyArray<
-        string | Readonly<{ from: string; as: string }>
-      >;
-      rewriteAliases?: boolean;
-      runtimeInjection:
-        | boolean
-        | (null | undefined | string)
-        | Readonly<{ from: string; as: string }>;
-      treeshakeCompensation?: boolean;
-      unstable_moduleResolution?: null | undefined | ModuleResolution;
-    })
+    | keyof {
+        aliases?:
+          | null
+          | undefined
+          | Readonly<{ [$$Key$$: string]: string | ReadonlyArray<string> }>;
+        enableDebugClassNames?: boolean;
+        enableDebugDataProp?: boolean;
+        enableDevClassNames?: boolean;
+        enableInlinedConditionalMerge?: boolean;
+        enableMediaQueryOrder?: boolean;
+        enableLegacyValueFlipping?: boolean;
+        enableLogicalStylesPolyfill?: boolean;
+        enableLTRRTLComments?: boolean;
+        enableMinifiedKeys?: boolean;
+        importSources: ReadonlyArray<
+          string | Readonly<{ from: string; as: string }>
+        >;
+        rewriteAliases?: boolean;
+        runtimeInjection:
+          | boolean
+          | (null | undefined | string)
+          | Readonly<{ from: string; as: string }>;
+        treeshakeCompensation?: boolean;
+        unstable_moduleResolution?: null | undefined | ModuleResolution;
+        debugFilePath?: (filePath: string) => string;
+      }
   > & {
     aliases?:
       | null
@@ -94,21 +95,22 @@ export type StyleXOptions = Readonly<
       | Readonly<{ from: string; as: string }>;
     treeshakeCompensation?: boolean;
     unstable_moduleResolution?: null | undefined | ModuleResolution;
+    debugFilePath?: (filePath: string) => string;
   }
 >;
 type StyleXStateOptions = Readonly<
   Omit<
     StyleXOptions,
-    keyof ({
-      runtimeInjection:
-        | (null | undefined | string)
-        | Readonly<{ from: string; as: null | undefined | string }>;
-      aliases?:
-        | null
-        | undefined
-        | Readonly<{ [$$Key$$: string]: ReadonlyArray<string> }>;
-      rewriteAliases: boolean;
-    })
+    | keyof {
+        runtimeInjection:
+          | (null | undefined | string)
+          | Readonly<{ from: string; as: null | undefined | string }>;
+        aliases?:
+          | null
+          | undefined
+          | Readonly<{ [$$Key$$: string]: ReadonlyArray<string> }>;
+        rewriteAliases: boolean;
+      }
   > & {
     runtimeInjection:
       | (null | undefined | string)
@@ -132,6 +134,7 @@ declare class StateManager {
   readonly stylexKeyframesImport: Set<string>;
   readonly stylexPositionTryImport: Set<string>;
   readonly stylexDefineVarsImport: Set<string>;
+  readonly stylexDefineMarkerImport: Set<string>;
   readonly stylexDefineConstsImport: Set<string>;
   readonly stylexCreateThemeImport: Set<string>;
   readonly stylexTypesImport: Set<string>;
@@ -217,8 +220,11 @@ export declare const filePathResolver: (
   sourceFilePath: string,
   aliases: StyleXStateOptions['aliases'],
 ) => null | undefined | string;
+export declare type filePathResolver = typeof filePathResolver;
 export declare const EXTENSIONS: any;
+export declare type EXTENSIONS = typeof EXTENSIONS;
 export declare const matchesFileSuffix: (
   $$PARAM_0$$: string,
 ) => ($$PARAM_0$$: string) => boolean;
+export declare type matchesFileSuffix = typeof matchesFileSuffix;
 export declare function getRelativePath(from: string, to: string): string;

package/lib/utils/state-manager.js.flow

@@ -63,6 +63,7 @@ export type StyleXOptions = $ReadOnly<{
   runtimeInjection: boolean | ?string | $ReadOnly<{ from: string, as: string }>,
   treeshakeCompensation?: boolean,
   unstable_moduleResolution?: ?ModuleResolution,
+  debugFilePath?: (filePath: string) => string,
   ...
 }>;
 
@@ -76,6 +77,7 @@ type StyleXStateOptions = $ReadOnly<{
 
 declare export default class StateManager {
   +_state: PluginPass;
+  // Imports
   +importPaths: Set<string>;
   +stylexImport: Set<string>;
   +stylexPropsImport: Set<string>;
@@ -86,6 +88,7 @@ declare export default class StateManager {
   +stylexKeyframesImport: Set<string>;
   +stylexPositionTryImport: Set<string>;
   +stylexDefineVarsImport: Set<string>;
+  +stylexDefineMarkerImport: Set<string>;
   +stylexDefineConstsImport: Set<string>;
   +stylexCreateThemeImport: Set<string>;
   +stylexTypesImport: Set<string>;
@@ -93,8 +96,10 @@ declare export default class StateManager {
   +stylexDefaultMarkerImport: Set<string>;
   +stylexWhenImport: Set<string>;
   injectImportInserted: ?t.Identifier;
+  // `stylex.create` calls
   +styleMap: Map<string, CompiledNamespaces>;
   +styleVars: Map<string, NodePath<>>;
+  // results of `stylex.create` calls that should be kept
   +styleVarsToKeep: Set<[string, true | string, true | Array<string>]>;
   inStyleXCreate: boolean;
   +options: StyleXStateOptions;

package/lib/utils/validate.d.ts

@@ -19,18 +19,27 @@ export type InferCheckType<T> =
 type Msg = (value: unknown, name?: string) => string;
 type PrimitiveChecker<T> = (message?: Msg) => Check<T>;
 export declare const string: PrimitiveChecker<string>;
+export declare type string = typeof string;
 export declare const nullish: PrimitiveChecker<null | void>;
+export declare type nullish = typeof nullish;
+export declare const optional: <T>($$PARAM_0$$: Check<T>) => Check<void | T>;
+export declare type optional = typeof optional;
 export declare const boolean: PrimitiveChecker<boolean>;
+export declare type boolean = typeof boolean;
 export declare const number: PrimitiveChecker<number>;
+export declare type number = typeof number;
 export declare const func: <T extends Function>(msg?: Msg) => Check<T>;
+export declare type func = typeof func;
 export declare const literal: <T extends string | number | boolean>(
   $$PARAM_0$$: T,
   msg?: Msg,
 ) => Check<T>;
+export declare type literal = typeof literal;
 export declare const array: <T>(
   $$PARAM_0$$: Check<T>,
   msg?: Msg,
 ) => Check<ReadonlyArray<T>>;
+export declare type array = typeof array;
 type ObjOfChecks<T extends { readonly [$$Key$$: string]: Check<unknown> }> =
   Readonly<{ [K in keyof T]: InferCheckType<T[K]> }>;
 export declare const object: <
@@ -39,31 +48,37 @@ export declare const object: <
   $$PARAM_0$$: T,
   msg?: Msg,
 ) => Check<ObjOfChecks<T>>;
+export declare type object = typeof object;
 export declare const objectOf: <T>(
   $$PARAM_0$$: Check<T>,
   message?: Msg,
 ) => Check<{ readonly [$$Key$$: string]: T }>;
+export declare type objectOf = typeof objectOf;
 export declare const unionOf: <A, B>(
   a: Check<A>,
   b: Check<B>,
-  message: Msg,
+  message?: Msg,
 ) => Check<A | B>;
+export declare type unionOf = typeof unionOf;
 export declare const unionOf3: <A, B, C>(
   a: Check<A>,
   b: Check<B>,
   c: Check<C>,
-  message: Msg,
+  message?: Msg,
 ) => Check<A | B | C>;
+export declare type unionOf3 = typeof unionOf3;
 export declare const unionOf4: <A, B, C, D>(
   a: Check<A>,
   b: Check<B>,
   c: Check<C>,
   d: Check<D>,
-  message: Msg,
+  message?: Msg,
 ) => Check<A | B | C | D>;
+export declare type unionOf4 = typeof unionOf4;
 export declare const logAndDefault: <T>(
   check: Check<T>,
   value: unknown,
   def: T,
   name?: string,
 ) => T;
+export declare type logAndDefault = typeof logAndDefault;

package/lib/utils/validate.js.flow

@@ -17,6 +17,8 @@ declare export const string: PrimitiveChecker<string>;
 
 declare export const nullish: PrimitiveChecker<null | void>;
 
+declare export const optional: <T>(Check<T>) => Check<void | T>;
+
 declare export const boolean: PrimitiveChecker<boolean>;
 
 declare export const number: PrimitiveChecker<number>;
@@ -50,14 +52,14 @@ declare export const objectOf: <T>(
 declare export const unionOf: <A, B>(
   a: Check<A>,
   b: Check<B>,
-  message: Msg,
+  message?: Msg,
 ) => Check<A | B>;
 
 declare export const unionOf3: <A, B, C>(
   a: Check<A>,
   b: Check<B>,
   c: Check<C>,
-  message: Msg,
+  message?: Msg,
 ) => Check<A | B | C>;
 
 declare export const unionOf4: <A, B, C, D>(
@@ -65,7 +67,7 @@ declare export const unionOf4: <A, B, C, D>(
   b: Check<B>,
   c: Check<C>,
   d: Check<D>,
-  message: Msg,
+  message?: Msg,
 ) => Check<A | B | C | D>;
 
 declare export const logAndDefault: <T>(

package/lib/visitors/parse-stylex-create-arg.d.ts

@@ -27,7 +27,7 @@ type DynamicFns = {
 export declare function evaluateStyleXCreateArg(
   path: NodePath,
   traversalState: StateManager,
-  functions: FunctionConfig,
+  functions?: FunctionConfig,
 ): Readonly<{
   confident: boolean;
   value: any;

package/lib/visitors/parse-stylex-create-arg.js.flow

@@ -32,7 +32,7 @@ type DynamicFns = {
 declare export function evaluateStyleXCreateArg(
   path: NodePath<>,
   traversalState: StateManager,
-  functions: FunctionConfig,
+  functions?: FunctionConfig,
 ): $ReadOnly<{
   confident: boolean,
   value: any,

package/lib/visitors/stylex-default-target.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.
+ *
+ *
+ */
+
+import type { NodePath } from '@babel/traverse';
+import type StateManager from '../utils/state-manager';
+import * as t from '@babel/types';
+/**
+ * Transform `stylex.defaultTarget` calls and property access to use the configured classNamePrefix
+ */
+declare function transformStyleXDefaultTarget(
+  path: NodePath<t.CallExpression | t.MemberExpression>,
+  state: StateManager,
+): void;
+export default transformStyleXDefaultTarget;

package/lib/visitors/stylex-default-target.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
+ */
+
+import type { NodePath } from '../../flow_modules/@babel/traverse';
+import type StateManager from '../utils/state-manager';
+
+import * as t from '../../flow_modules/@babel/types';
+
+/**
+ * Transform `stylex.defaultTarget` calls and property access to use the configured classNamePrefix
+ */
+declare export default function transformStyleXDefaultTarget(
+  path: NodePath<t.CallExpression | t.MemberExpression>,
+  state: StateManager,
+): void;

package/lib/visitors/stylex-define-marker.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 { NodePath } from '@babel/traverse';
+import * as t from '@babel/types';
+import StateManager from '../utils/state-manager';
+/**
+ * Transforms calls to `stylex.defineMarker()` (or imported `defineMarker()`)
+ * into an object: { $$css: true, [hash]: hash } where `hash` is generated from
+ * the file path and the export name.
+ */
+declare function transformStyleXDefineMarker(
+  path: NodePath<t.CallExpression>,
+  state: StateManager,
+): void;
+export default transformStyleXDefineMarker;

package/lib/visitors/stylex-define-marker.js.flow

@@ -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.
+ *
+ * @flow strict
+ */
+
+import type { NodePath } from '@babel/traverse';
+
+import * as t from '@babel/types';
+import StateManager from '../utils/state-manager';
+/**
+ * Transforms calls to `stylex.defineMarker()` (or imported `defineMarker()`)
+ * into an object: { $$css: true, [hash]: hash } where `hash` is generated from
+ * the file path and the export name.
+ */
+declare export default function transformStyleXDefineMarker(
+  path: NodePath<t.CallExpression>,
+  state: StateManager,
+): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stylexjs/babel-plugin",
-  "version": "0.16.3",
+  "version": "0.17.1",
   "description": "StyleX babel plugin.",
   "main": "lib/index.js",
   "repository": {
@@ -21,7 +21,8 @@
     "@babel/traverse": "^7.26.8",
     "@babel/types": "^7.26.8",
     "@dual-bundle/import-meta-resolve": "^4.1.0",
-    "@stylexjs/stylex": "0.16.3",
+    "@stylexjs/shared": "0.17.1",
+    "@stylexjs/stylex": "0.17.1",
     "postcss-value-parser": "^4.1.0"
   },
   "devDependencies": {
@@ -31,9 +32,9 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.3.0",
     "@rollup/plugin-replace": "^6.0.1",
-    "babel-plugin-syntax-hermes-parser": "^0.26.0",
+    "babel-plugin-syntax-hermes-parser": "^0.32.1",
     "rollup": "^4.24.0",
-    "scripts": "0.16.3"
+    "scripts": "0.17.1"
   },
   "files": [
     "flow_modules/*",