@stylexjs/stylex 0.18.2 → 0.19.0

package/lib/cjs/stylex.d.ts

@@ -8,10 +8,14 @@
  */
 
 import type {
+  CSSProperties,
   CompiledStyles,
   InlineStyles,
   Keyframes,
   MapNamespaces,
+  NestedConstsValue,
+  NestedStringValue,
+  NestedVarsValue,
   StaticStyles,
   StaticStylesWithout,
   StyleX$Create,
@@ -35,6 +39,7 @@ import type {
 import type { ValueWithDefault } from './types/StyleXUtils';
 import * as Types from './types/VarTypes';
 export type {
+  CSSProperties,
   CompiledStyles,
   InlineStyles,
   Keyframes,
@@ -59,6 +64,32 @@ export declare const defineConsts: StyleX$DefineConsts;
 export declare type defineConsts = typeof defineConsts;
 export declare const defineVars: StyleX$DefineVars;
 export declare type defineVars = typeof defineVars;
+export declare const unstable_conditional: <
+  T extends { readonly default: unknown; readonly [$$Key$$: string]: unknown },
+>(
+  _value: T,
+) => T;
+export declare type unstable_conditional = typeof unstable_conditional;
+export declare const unstable_defineVarsNested: <
+  T extends { readonly [$$Key$$: string]: NestedVarsValue },
+>(
+  _styles: T,
+) => T;
+export declare type unstable_defineVarsNested =
+  typeof unstable_defineVarsNested;
+export declare const unstable_defineConstsNested: <
+  T extends { readonly [$$Key$$: string]: NestedConstsValue },
+>(
+  _styles: T,
+) => T;
+export declare type unstable_defineConstsNested =
+  typeof unstable_defineConstsNested;
+export declare const unstable_createThemeNested: (
+  _baseTokens: { readonly [$$Key$$: string]: NestedStringValue },
+  _overrides: { readonly [$$Key$$: string]: NestedVarsValue },
+) => CompiledStyles;
+export declare type unstable_createThemeNested =
+  typeof unstable_createThemeNested;
 export declare const defineMarker: StyleX$DefineMarker;
 export declare type defineMarker = typeof defineMarker;
 export declare const firstThatWorks: <T extends string | number>(
@@ -192,6 +223,28 @@ type IStyleX = {
   viewTransitionClass: (viewTransitionClass: ViewTransitionClass) => string;
   types: typeof types;
   when: typeof when;
+  unstable_conditional: <
+    T extends {
+      readonly default: unknown;
+      readonly [$$Key$$: string]: unknown;
+    },
+  >(
+    value: T,
+  ) => T;
+  unstable_defineVarsNested: <
+    T extends { readonly [$$Key$$: string]: NestedVarsValue },
+  >(
+    tokens: T,
+  ) => T;
+  unstable_defineConstsNested: <
+    T extends { readonly [$$Key$$: string]: NestedConstsValue },
+  >(
+    tokens: T,
+  ) => T;
+  unstable_createThemeNested: (
+    baseTokens: { readonly [$$Key$$: string]: NestedStringValue },
+    overrides: { readonly [$$Key$$: string]: NestedVarsValue },
+  ) => CompiledStyles;
   __customProperties?: { [$$Key$$: string]: unknown };
 };
 export declare const legacyMerge: IStyleX;

package/lib/cjs/stylex.js

@@ -146,6 +146,18 @@ const defineConsts = function stylexDefineConsts(_styles) {
 const defineVars = function stylexDefineVars(_styles) {
   throw errorForFn('defineVars');
 };
+const unstable_conditional = function stylexConditional(_value) {
+  throw errorForFn('unstable_conditional');
+};
+const unstable_defineVarsNested = function stylexDefineVarsNested(_styles) {
+  throw errorForFn('unstable_defineVarsNested');
+};
+const unstable_defineConstsNested = function stylexDefineConstsNested(_styles) {
+  throw errorForFn('unstable_defineConstsNested');
+};
+const unstable_createThemeNested = (_baseTokens, _overrides) => {
+  throw errorForFn('unstable_createThemeNested');
+};
 const defineMarker = () => {
   throw errorForFn('defineMarker');
 };
@@ -256,26 +268,32 @@ const types = {
     throw errorForType('transformList');
   }
 };
-function _legacyMerge(...styles) {
-  const [className] = styleqExports.styleq(styles);
-  return className;
-}
-_legacyMerge.create = create;
-_legacyMerge.createTheme = createTheme;
-_legacyMerge.defineConsts = defineConsts;
-_legacyMerge.defineMarker = defineMarker;
-_legacyMerge.defineVars = defineVars;
-_legacyMerge.defaultMarker = defaultMarker;
-_legacyMerge.firstThatWorks = firstThatWorks;
-_legacyMerge.keyframes = keyframes;
-_legacyMerge.positionTry = positionTry;
-_legacyMerge.props = props;
-_legacyMerge.attrs = attrs;
-_legacyMerge.types = types;
-_legacyMerge.when = when;
-_legacyMerge.viewTransitionClass = viewTransitionClass;
-_legacyMerge.env = env;
-const legacyMerge = _legacyMerge;
+const legacyMerge = /*@__PURE__*/ function () {
+  function _legacyMerge(...styles) {
+    const [className] = styleqExports.styleq(styles);
+    return className;
+  }
+  _legacyMerge.create = create;
+  _legacyMerge.createTheme = createTheme;
+  _legacyMerge.defineConsts = defineConsts;
+  _legacyMerge.defineMarker = defineMarker;
+  _legacyMerge.defineVars = defineVars;
+  _legacyMerge.defaultMarker = defaultMarker;
+  _legacyMerge.firstThatWorks = firstThatWorks;
+  _legacyMerge.keyframes = keyframes;
+  _legacyMerge.positionTry = positionTry;
+  _legacyMerge.props = props;
+  _legacyMerge.attrs = attrs;
+  _legacyMerge.types = types;
+  _legacyMerge.when = when;
+  _legacyMerge.viewTransitionClass = viewTransitionClass;
+  _legacyMerge.env = env;
+  _legacyMerge.unstable_conditional = unstable_conditional;
+  _legacyMerge.unstable_defineVarsNested = unstable_defineVarsNested;
+  _legacyMerge.unstable_defineConstsNested = unstable_defineConstsNested;
+  _legacyMerge.unstable_createThemeNested = unstable_createThemeNested;
+  return _legacyMerge;
+}();
 
 exports.attrs = attrs;
 exports.create = create;
@@ -291,5 +309,9 @@ exports.legacyMerge = legacyMerge;
 exports.positionTry = positionTry;
 exports.props = props;
 exports.types = types;
+exports.unstable_conditional = unstable_conditional;
+exports.unstable_createThemeNested = unstable_createThemeNested;
+exports.unstable_defineConstsNested = unstable_defineConstsNested;
+exports.unstable_defineVarsNested = unstable_defineVarsNested;
 exports.viewTransitionClass = viewTransitionClass;
 exports.when = when;

package/lib/cjs/stylex.js.flow

@@ -8,10 +8,14 @@
  */
 
 import type {
+  CSSProperties,
   CompiledStyles,
   InlineStyles,
   Keyframes,
   MapNamespaces,
+  NestedConstsValue,
+  NestedStringValue,
+  NestedVarsValue,
   StaticStyles,
   StaticStylesWithout,
   StyleX$Create,
@@ -36,6 +40,7 @@ import type { ValueWithDefault } from './types/StyleXUtils';
 import * as Types from './types/VarTypes';
 
 export type {
+  CSSProperties,
   CompiledStyles,
   InlineStyles,
   Keyframes,
@@ -61,9 +66,32 @@ declare export const defineConsts: StyleX$DefineConsts;
 
 declare export const defineVars: StyleX$DefineVars;
 
+declare export const unstable_conditional: <
+  const T extends { readonly default: unknown, readonly [string]: unknown },
+>(
+  _value: T,
+) => T;
+
+declare export const unstable_defineVarsNested: <
+  const T extends { readonly [string]: NestedVarsValue },
+>(
+  _styles: T,
+) => T;
+
+declare export const unstable_defineConstsNested: <
+  const T extends { readonly [string]: NestedConstsValue },
+>(
+  _styles: T,
+) => T;
+
+declare export const unstable_createThemeNested: (
+  _baseTokens: { readonly [string]: NestedStringValue },
+  _overrides: { readonly [string]: NestedVarsValue },
+) => CompiledStyles;
+
 declare export const defineMarker: StyleX$DefineMarker;
 
-declare export const firstThatWorks: <T: string | number>(
+declare export const firstThatWorks: <T extends string | number>(
   ..._styles: ReadonlyArray<T>
 ) => ReadonlyArray<T>;
 
@@ -112,31 +140,35 @@ declare export const when: StyleX$When;
 declare export const env: StyleX$Env;
 
 declare export const types: {
-  angle: <T: string | 0 = string | 0>(
+  angle: <T extends string | 0 = string | 0>(
     _v: ValueWithDefault<T>,
   ) => Types.Angle<T>,
-  color: <T: string = string>(_v: ValueWithDefault<T>) => Types.Color<T>,
-  url: <T: string = string>(_v: ValueWithDefault<T>) => Types.Url<T>,
-  image: <T: string = string>(_v: ValueWithDefault<T>) => Types.Image<T>,
-  integer: <T: number = number>(_v: ValueWithDefault<T>) => Types.Integer<T>,
-  lengthPercentage: <T: number | string = number | string>(
+  color: <T extends string = string>(_v: ValueWithDefault<T>) => Types.Color<T>,
+  url: <T extends string = string>(_v: ValueWithDefault<T>) => Types.Url<T>,
+  image: <T extends string = string>(_v: ValueWithDefault<T>) => Types.Image<T>,
+  integer: <T extends number = number>(
+    _v: ValueWithDefault<T>,
+  ) => Types.Integer<T>,
+  lengthPercentage: <T extends number | string = number | string>(
     _v: ValueWithDefault<T>,
   ) => Types.LengthPercentage<T>,
-  length: <T: number | string = number | string>(
+  length: <T extends number | string = number | string>(
     _v: ValueWithDefault<T>,
   ) => Types.Length<T>,
-  percentage: <T: number | string = number | string>(
+  percentage: <T extends number | string = number | string>(
     _v: ValueWithDefault<T>,
   ) => Types.Percentage<T>,
-  number: <T: number = number>(_v: ValueWithDefault<T>) => Types.Num<T>,
-  resolution: <T: string = string>(
+  number: <T extends number = number>(_v: ValueWithDefault<T>) => Types.Num<T>,
+  resolution: <T extends string = string>(
     _v: ValueWithDefault<T>,
   ) => Types.Resolution<T>,
-  time: <T: string | 0 = string | 0>(_v: ValueWithDefault<T>) => Types.Time<T>,
-  transformFunction: <T: string = string>(
+  time: <T extends string | 0 = string | 0>(
+    _v: ValueWithDefault<T>,
+  ) => Types.Time<T>,
+  transformFunction: <T extends string = string>(
     _v: ValueWithDefault<T>,
   ) => Types.TransformFunction<T>,
-  transformList: <T: string = string>(
+  transformList: <T extends string = string>(
     _v: ValueWithDefault<T>,
   ) => Types.TransformList<T>,
 };
@@ -158,7 +190,7 @@ type IStyleX = {
     }>,
   >,
   defineMarker: StyleX$DefineMarker,
-  firstThatWorks: <T: string | number>(
+  firstThatWorks: <T extends string | number>(
     ...v: ReadonlyArray<T>
   ) => ReadonlyArray<T>,
   keyframes: (keyframes: Keyframes) => string,
@@ -190,6 +222,25 @@ type IStyleX = {
   viewTransitionClass: (viewTransitionClass: ViewTransitionClass) => string,
   types: typeof types,
   when: typeof when,
+  unstable_conditional: <
+    const T extends { readonly default: unknown, readonly [string]: unknown },
+  >(
+    value: T,
+  ) => T,
+  unstable_defineVarsNested: <
+    const T extends { readonly [string]: NestedVarsValue },
+  >(
+    tokens: T,
+  ) => T,
+  unstable_defineConstsNested: <
+    const T extends { readonly [string]: NestedConstsValue },
+  >(
+    tokens: T,
+  ) => T,
+  unstable_createThemeNested: (
+    baseTokens: { readonly [string]: NestedStringValue },
+    overrides: { readonly [string]: NestedVarsValue },
+  ) => CompiledStyles,
   __customProperties?: { [string]: unknown },
   ...
 };

package/lib/cjs/types/StyleXCSSTypes.d.ts

@@ -1461,7 +1461,7 @@ export type CSSProperties = Readonly<{
   textTransform?: all | textTransform;
   textUnderlineOffset?: all | number | string;
   textUnderlinePosition?: all | textUnderlinePosition;
-  textWrap?: all | 'wrap' | 'nowrap' | 'balance';
+  textWrap?: all | 'wrap' | 'nowrap' | 'balance' | 'pretty' | 'stable';
   timelineScope?: all | string;
   top?: all | top;
   touchAction?: all | touchAction;

package/lib/cjs/types/StyleXCSSTypes.js.flow

@@ -1548,7 +1548,7 @@ export type CSSProperties = Readonly<{
   textTransform?: all | textTransform,
   textUnderlineOffset?: all | number | string,
   textUnderlinePosition?: all | textUnderlinePosition,
-  textWrap?: all | 'wrap' | 'nowrap' | 'balance',
+  textWrap?: all | 'wrap' | 'nowrap' | 'balance' | 'pretty' | 'stable',
 
   timelineScope?: all | string,
   top?: all | top,

package/lib/cjs/types/StyleXOpaqueTypes.js.flow

@@ -11,6 +11,6 @@
 //   value: T;
 // }
 // This is the type for the variables object
-declare export opaque type StyleXVar<+_Val: unknown>: string;
+declare export opaque type StyleXVar<out _Val extends unknown>: string;
 
-declare export opaque type StyleXClassNameFor<+_K, +_V>: string;
+declare export opaque type StyleXClassNameFor<out _K, out _V>: string;

package/lib/cjs/types/StyleXTypes.d.ts

@@ -8,6 +8,8 @@
 import type { CSSType } from './VarTypes';
 import type { CSSProperties } from './StyleXCSSTypes';
 
+export type { CSSProperties } from './StyleXCSSTypes';
+
 // Using an opaque type to declare ClassNames generated by stylex.
 declare const StyleXClassNameTag: unique symbol;
 export type StyleXClassNameFor<K, V> = string & {
@@ -252,12 +254,17 @@ export type IDFromVarGroup<T extends VarGroup<{}>> = T['__opaqueId'];
 
 type TTokens = Readonly<{
   [key: string]:
-    | NestedVarObject<null | string | number>
-    | StyleXVar<null | string | number>
+    | NestedVarObject<
+        null | string | number | StyleXVar<null | string | number>
+      >
     | CSSType<null | string | number>;
 }>;
 
-type UnwrapVars<T> = T extends StyleXVar<infer U> ? U : T;
+type UnwrapVars<T> = T extends () => infer U
+  ? UnwrapVars<U>
+  : T extends StyleXVar<infer U>
+    ? U
+    : T;
 export type FlattenTokens<T extends TTokens> = Readonly<{
   [Key in keyof T]: T[Key] extends { [key: string]: infer X }
     ? UnwrapVars<X>
@@ -266,6 +273,7 @@ export type FlattenTokens<T extends TTokens> = Readonly<{
 
 type NestedVarObject<T> =
   | T
+  | (() => T)
   | Readonly<{
       default: NestedVarObject<T>;
       [key: AtRuleStr]: NestedVarObject<T>;
@@ -306,10 +314,8 @@ export type StyleX$CreateTheme = <
   overrides: OverridesForTokenType<TokensFromVarGroup<TVars>>,
 ) => Theme<TVars, ThemeID>;
 
-declare const StyleXMarkerTag: unique symbol;
-
 export type StyleX$DefineMarker = () => MapNamespace<{
-  readonly marker: typeof StyleXMarkerTag;
+  readonly marker: symbol;
 }>;
 
 export type StyleX$When = {
@@ -360,3 +366,50 @@ export interface Register {}
 export type StyleX$Env = Register extends { env: infer TEnv }
   ? TEnv
   : Readonly<{ [key: string]: unknown }>;
+
+// === Nested API Types ===
+
+export type NestedVarsValue =
+  | string
+  | CSSType<string | number>
+  | { readonly [key: string]: NestedVarsValue };
+
+export type NestedConstsValue =
+  | string
+  | number
+  | { readonly [key: string]: NestedConstsValue };
+
+export type NestedStringValue =
+  | string
+  | { readonly [key: string]: NestedStringValue };
+
+// unstable_defineVarsNested: preserves nested key structure in output.
+// Uses generic <T> to give consumers key-level autocomplete.
+// Leaf values are replaced with var(--hash) strings at compile time.
+export type StyleX$DefineVarsNested = <
+  const T extends { [key: string]: NestedVarsValue },
+>(
+  tokens: T,
+) => T;
+
+// unstable_defineConstsNested: same as input — values inlined at compile time.
+export type StyleX$DefineConstsNested = <
+  const T extends { [key: string]: NestedConstsValue },
+>(
+  tokens: T,
+) => T;
+
+// unstable_createThemeNested: returns a flat theme object like createTheme.
+export type StyleX$CreateThemeNested = (
+  baseTokens: { readonly [key: string]: NestedStringValue },
+  overrides: { readonly [key: string]: NestedVarsValue },
+) => CompiledStyles;
+
+// unstable_conditional: identity function for type disambiguation.
+// Marks a conditional @media/@supports value so the type system can
+// distinguish it from namespace objects in nested token definitions.
+export type StyleX$Conditional = <
+  const T extends { default: unknown; [key: `@${string}`]: unknown },
+>(
+  value: T,
+) => T;