@stylexjs/stylex 0.18.1 → 0.18.3

package/lib/cjs/stylex.d.ts

@@ -12,6 +12,9 @@ import type {
   InlineStyles,
   Keyframes,
   MapNamespaces,
+  NestedConstsValue,
+  NestedStringValue,
+  NestedVarsValue,
   StaticStyles,
   StaticStylesWithout,
   StyleX$Create,
@@ -30,6 +33,7 @@ import type {
   StyleX$When,
   MapNamespace,
   StyleX$DefineMarker,
+  StyleX$Env,
 } from './types/StyleXTypes';
 import type { ValueWithDefault } from './types/StyleXUtils';
 import * as Types from './types/VarTypes';
@@ -58,6 +62,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>(
@@ -82,6 +112,16 @@ export declare function props(
   'data-style-src'?: string;
   style?: Readonly<{ [$$Key$$: string]: string | number }>;
 }>;
+export declare function attrs(
+  this: null | undefined | unknown,
+  ...styles: ReadonlyArray<
+    StyleXArray<
+      | (null | undefined | CompiledStyles)
+      | boolean
+      | Readonly<[CompiledStyles, InlineStyles]>
+    >
+  >
+): Readonly<{ class?: string; 'data-style-src'?: string; style?: string }>;
 export declare const viewTransitionClass: (
   _viewTransitionClass: ViewTransitionClass,
 ) => string;
@@ -92,7 +132,7 @@ export declare const defaultMarker: () => MapNamespace<
 export declare type defaultMarker = typeof defaultMarker;
 export declare const when: StyleX$When;
 export declare type when = typeof when;
-export declare const env: Readonly<{ [$$Key$$: string]: unknown }>;
+export declare const env: StyleX$Env;
 export declare type env = typeof env;
 export declare const types: {
   angle: <T extends string | 0 = string | 0>(
@@ -146,7 +186,7 @@ type IStyleX = {
   createTheme: StyleX$CreateTheme;
   defineConsts: StyleX$DefineConsts;
   defineVars: StyleX$DefineVars;
-  env: Readonly<{ [$$Key$$: string]: unknown }>;
+  env: StyleX$Env;
   defaultMarker: () => MapNamespace<Readonly<{ marker: 'default-marker' }>>;
   defineMarker: StyleX$DefineMarker;
   firstThatWorks: <T extends string | number>(
@@ -168,9 +208,41 @@ type IStyleX = {
     'data-style-src'?: string;
     style?: Readonly<{ [$$Key$$: string]: string | number }>;
   }>;
+  attrs: (
+    this: null | undefined | unknown,
+    ...styles: ReadonlyArray<
+      StyleXArray<
+        | (null | undefined | CompiledStyles)
+        | boolean
+        | Readonly<[CompiledStyles, InlineStyles]>
+      >
+    >
+  ) => Readonly<{ class?: string; 'data-style-src'?: string; style?: string }>;
   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');
 };
@@ -172,6 +184,25 @@ function props(...styles) {
   }
   return result;
 }
+const toKebabCase = str => str.replace(/([A-Z])/g, '-$1').toLowerCase();
+function attrs(...styles) {
+  const {
+    className,
+    style,
+    'data-style-src': dataStyleSrc
+  } = props.apply(this, styles);
+  const result = {};
+  if (className != null) {
+    result.class = className;
+  }
+  if (style != null) {
+    result.style = Object.entries(style).map(([key, value]) => `${toKebabCase(key)}:${value}`).join(';');
+  }
+  if (dataStyleSrc != null) {
+    result['data-style-src'] = dataStyleSrc;
+  }
+  return result;
+}
 const viewTransitionClass = _viewTransitionClass => {
   throw errorForFn('viewTransitionClass');
 };
@@ -237,26 +268,34 @@ 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.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;
 exports.createTheme = createTheme;
 exports.defaultMarker = defaultMarker;
@@ -270,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

@@ -12,6 +12,9 @@ import type {
   InlineStyles,
   Keyframes,
   MapNamespaces,
+  NestedConstsValue,
+  NestedStringValue,
+  NestedVarsValue,
   StaticStyles,
   StaticStylesWithout,
   StyleX$Create,
@@ -30,6 +33,7 @@ import type {
   StyleX$When,
   MapNamespace,
   StyleX$DefineMarker,
+  StyleX$Env,
 } from './types/StyleXTypes';
 import type { ValueWithDefault } from './types/StyleXUtils';
 import * as Types from './types/VarTypes';
@@ -60,9 +64,32 @@ declare export const defineConsts: StyleX$DefineConsts;
 
 declare export const defineVars: StyleX$DefineVars;
 
+declare export const unstable_conditional: <
+  const T extends { +default: unknown, +[string]: unknown },
+>(
+  _value: T,
+) => T;
+
+declare export const unstable_defineVarsNested: <
+  const T extends { +[string]: NestedVarsValue },
+>(
+  _styles: T,
+) => T;
+
+declare export const unstable_defineConstsNested: <
+  const T extends { +[string]: NestedConstsValue },
+>(
+  _styles: T,
+) => T;
+
+declare export const unstable_createThemeNested: (
+  _baseTokens: { +[string]: NestedStringValue },
+  _overrides: { +[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>;
 
@@ -83,6 +110,19 @@ declare export function props(
   style?: Readonly<{ [string]: string | number }>,
 }>;
 
+declare export function attrs(
+  this: ?unknown,
+  ...styles: ReadonlyArray<
+    StyleXArray<
+      ?CompiledStyles | boolean | Readonly<[CompiledStyles, InlineStyles]>,
+    >,
+  >
+): Readonly<{
+  class?: string,
+  'data-style-src'?: string,
+  style?: string,
+}>;
+
 declare export const viewTransitionClass: (
   _viewTransitionClass: ViewTransitionClass,
 ) => string;
@@ -95,34 +135,38 @@ declare export const defaultMarker: () => MapNamespace<
 
 declare export const when: StyleX$When;
 
-declare export const env: $ReadOnly<{ [string]: mixed }>;
+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>,
 };
@@ -137,14 +181,14 @@ type IStyleX = {
   createTheme: StyleX$CreateTheme,
   defineConsts: StyleX$DefineConsts,
   defineVars: StyleX$DefineVars,
-  env: $ReadOnly<{ [string]: mixed }>,
+  env: StyleX$Env,
   defaultMarker: () => MapNamespace<
     Readonly<{
       marker: 'default-marker',
     }>,
   >,
   defineMarker: StyleX$DefineMarker,
-  firstThatWorks: <T: string | number>(
+  firstThatWorks: <T extends string | number>(
     ...v: ReadonlyArray<T>
   ) => ReadonlyArray<T>,
   keyframes: (keyframes: Keyframes) => string,
@@ -161,9 +205,38 @@ type IStyleX = {
     'data-style-src'?: string,
     style?: Readonly<{ [string]: string | number }>,
   }>,
+  attrs: (
+    this: ?unknown,
+    ...styles: ReadonlyArray<
+      StyleXArray<
+        ?CompiledStyles | boolean | Readonly<[CompiledStyles, InlineStyles]>,
+      >,
+    >
+  ) => Readonly<{
+    class?: string,
+    'data-style-src'?: string,
+    style?: string,
+  }>,
   viewTransitionClass: (viewTransitionClass: ViewTransitionClass) => string,
   types: typeof types,
   when: typeof when,
+  unstable_conditional: <
+    const T extends { +default: unknown, +[string]: unknown },
+  >(
+    value: T,
+  ) => T,
+  unstable_defineVarsNested: <const T extends { +[string]: NestedVarsValue }>(
+    tokens: T,
+  ) => T,
+  unstable_defineConstsNested: <
+    const T extends { +[string]: NestedConstsValue },
+  >(
+    tokens: T,
+  ) => T,
+  unstable_createThemeNested: (
+    baseTokens: { +[string]: NestedStringValue },
+    overrides: { +[string]: NestedVarsValue },
+  ) => CompiledStyles,
   __customProperties?: { [string]: unknown },
   ...
 };

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<+_Val extends unknown>: string;
 
 declare export opaque type StyleXClassNameFor<+_K, +_V>: string;

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

@@ -252,12 +252,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 +271,7 @@ export type FlattenTokens<T extends TTokens> = Readonly<{
 
 type NestedVarObject<T> =
   | T
+  | (() => T)
   | Readonly<{
       default: NestedVarObject<T>;
       [key: AtRuleStr]: NestedVarObject<T>;
@@ -354,3 +360,56 @@ export type StyleX$When = {
     // @ts-expect-error - Trying to use a symbol in a string is not normally allowed
   ) => `:where-any-sibling(${Pseudo}, ${MarkerSymbol})`;
 };
+
+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;