@yahoo/uds-v5-wip 1.24.0 → 1.26.0

package/dist/config.d.ts

@@ -8,6 +8,47 @@ import * as _$_uds_types0 from "@uds/types";
 //#region src/config.d.ts
 declare const uds: UdsConfig<_$_uds_types0.ModifierProp, {}, {}, {}, {}, never, {}>;
 declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | "_light" | "_dark" | "_sm" | "_md" | "_lg" | "_xl" | "_2xl", {
+  opacity: {
+    0: string;
+    5: string;
+    10: string;
+    20: string;
+    40: string;
+    60: string;
+    80: string;
+    25: string;
+    30: string;
+    50: string;
+    70: string;
+    75: string;
+    90: string;
+    95: string;
+    100: string;
+  };
+  scale: {
+    0: string;
+    50: string;
+    75: string;
+    90: string;
+    95: string;
+    100: string;
+    105: string;
+    110: string;
+    125: string;
+    150: string;
+    200: string;
+  };
+  rotate: {
+    0: string;
+    2: string;
+    1: string;
+    3: string;
+    6: string;
+    12: string;
+    90: string;
+    45: string;
+    180: string;
+  };
   color: {
     inherit: string;
     current: string;
@@ -33,23 +74,7 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | "_light" | "
     inverse: string;
     "on-inverse": string;
   };
-  fontFamily: {
-    sans: string;
-    serif: string;
-    mono: string;
-  };
-  fontWeight: {
-    bold: string;
-    light: string;
-    thin: string;
-    medium: string;
-    extralight: string;
-    normal: string;
-    semibold: string;
-    extrabold: string;
-    black: string;
-  };
-  bg: {
+  borderColor: {
     brand: string;
     accent: string;
     alert: string;
@@ -60,17 +85,51 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | "_light" | "
     tertiary: string;
     inverse: string;
     surface: string;
-    "elevation-1": string;
-    "elevation-2": string;
-    "elevation-3": string;
     "brand-wash": string;
     "accent-wash": string;
     "alert-wash": string;
     "positive-wash": string;
     "warning-wash": string;
-    overlay: string;
   };
-  borderColor: {
+  position: {
+    auto: string;
+    full: string;
+    "1/2": string;
+    "1/3": string;
+    "2/3": string;
+    "1/4": string;
+    "2/4": string;
+    "3/4": string;
+  };
+  size: {
+    auto: string;
+    full: string;
+    max: string;
+    min: string;
+    "1/2": string;
+    "1/3": string;
+    "2/3": string;
+    "1/4": string;
+    "2/4": string;
+    "3/4": string;
+    fit: string;
+    "1/5": string;
+    "2/5": string;
+    "3/5": string;
+    "4/5": string;
+    "1/6": string;
+    "2/6": string;
+    "3/6": string;
+    "4/6": string;
+    "5/6": string;
+  };
+  animation: {
+    none: string;
+    ping: string;
+    spin: string;
+  };
+  bg: {
+    overlay: string;
     brand: string;
     accent: string;
     alert: string;
@@ -81,6 +140,9 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | "_light" | "
     tertiary: string;
     inverse: string;
     surface: string;
+    "elevation-1": string;
+    "elevation-2": string;
+    "elevation-3": string;
     "brand-wash": string;
     "accent-wash": string;
     "alert-wash": string;
@@ -93,63 +155,50 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | "_light" | "
     medium: string;
     thick: string;
   };
-  outlineWidth: {
+  divideWidth: {
     0: string;
-    2: string;
-    1: string;
     4: string;
-    8: string;
-  };
-  outlineOffset: {
-    0: string;
+    reverse: string;
     2: string;
-    1: string;
-    4: string;
     8: string;
   };
-  divideWidth: {
-    0: string;
-    2: string;
-    reverse: string;
-    4: string;
-    8: string;
+  flex: {
+    none: string;
+    initial: string;
+    auto: string;
+    1: string;
   };
-  ringWidth: {
+  flexGrow: {
     0: string;
-    2: string;
     1: string;
-    inset: string;
-    4: string;
-    8: string;
   };
-  ringOffsetWidth: {
+  flexShrink: {
     0: string;
-    2: string;
-    1: string;
-    4: string;
-    8: string;
   };
-  lineHeight: {
-    none: string;
-    normal: string;
-    tight: string;
-    relaxed: string;
+  aspectRatio: {
+    square: string;
+    landscape: string;
+    portrait: string;
+    widescreen: string;
+    ultrawide: string;
+    golden: string;
   };
-  letterSpacing: {
-    normal: string;
-    tight: string;
-    tighter: string;
-    wide: string;
-    wider: string;
-    widest: string;
+  zIndex: {
+    0: string;
+    auto: string;
+    10: string;
+    20: string;
+    40: string;
+    30: string;
+    50: string;
   };
   spacing: {
     0: string;
+    4: string;
     2: string;
     5: string;
     1: string;
     px: string;
-    4: string;
     8: string;
     0.5: string;
     1.5: string;
@@ -180,183 +229,116 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | "_light" | "
     80: string;
     96: string;
   };
-  position: {
-    auto: string;
-    full: string;
-    "1/2": string;
-    "1/3": string;
-    "2/3": string;
-    "1/4": string;
-    "2/4": string;
-    "3/4": string;
-  };
-  aspectRatio: {
-    square: string;
-    landscape: string;
-    portrait: string;
-    widescreen: string;
-    ultrawide: string;
-    golden: string;
+  w: {
+    screen: string;
+    svw: string;
+    lvw: string;
+    dvw: string;
   };
-  flex: {
+  outlineWidth: {
+    0: string;
+    4: string;
+    2: string;
     1: string;
-    none: string;
-    auto: string;
-    initial: string;
+    8: string;
   };
-  flexGrow: {
+  outlineOffset: {
     0: string;
+    4: string;
+    2: string;
     1: string;
+    8: string;
   };
-  flexShrink: {
+  ringWidth: {
     0: string;
+    4: string;
+    inset: string;
+    2: string;
+    1: string;
+    8: string;
   };
-  opacity: {
+  ringOffsetWidth: {
     0: string;
-    5: string;
-    10: string;
-    20: string;
-    40: string;
-    60: string;
-    80: string;
-    25: string;
-    30: string;
-    50: string;
-    70: string;
-    75: string;
-    90: string;
-    95: string;
-    100: string;
+    4: string;
+    2: string;
+    1: string;
+    8: string;
   };
-  radius: {
+  shadow: {
+    none: string;
     sm: string;
     md: string;
     lg: string;
     xl: string;
-    none: string;
-    full: string;
+    "2xl": string;
+    "2xs": string;
     xs: string;
+    inner: string;
   };
-  animation: {
+  strokeWidth: {
+    0: string;
+    2: string;
+    1: string;
+  };
+  fontFamily: {
+    sans: string;
+    serif: string;
+    mono: string;
+  };
+  fontWeight: {
+    normal: string;
+    thin: string;
+    bold: string;
+    light: string;
+    medium: string;
+    extralight: string;
+    semibold: string;
+    extrabold: string;
+    black: string;
+  };
+  letterSpacing: {
+    normal: string;
+    tight: string;
+    tighter: string;
+    wide: string;
+    wider: string;
+    widest: string;
+  };
+  lineHeight: {
     none: string;
-    spin: string;
-    ping: string;
+    normal: string;
+    tight: string;
+    relaxed: string;
   };
-  shadow: {
+  textShadow: {
+    none: string;
     sm: string;
     md: string;
     lg: string;
-    xl: string;
-    "2xl": string;
-    none: string;
-    xs: string;
     "2xs": string;
-    inner: string;
+    xs: string;
   };
   blur: {
+    none: string;
     sm: string;
     md: string;
     lg: string;
     xl: string;
     "2xl": string;
-    none: string;
     "3xl": string;
   };
-  textShadow: {
-    sm: string;
-    md: string;
-    lg: string;
-    none: string;
-    xs: string;
-    "2xs": string;
-  };
-  zIndex: {
-    0: string;
-    auto: string;
-    10: string;
-    20: string;
-    40: string;
-    30: string;
-    50: string;
-  };
-  size: {
-    auto: string;
-    full: string;
-    "1/2": string;
-    "1/3": string;
-    "2/3": string;
-    "1/4": string;
-    "2/4": string;
-    "3/4": string;
-    min: string;
-    max: string;
-    fit: string;
-    "1/5": string;
-    "2/5": string;
-    "3/5": string;
-    "4/5": string;
-    "1/6": string;
-    "2/6": string;
-    "3/6": string;
-    "4/6": string;
-    "5/6": string;
-  };
-  w: {
-    screen: string;
-    svw: string;
-    lvw: string;
-    dvw: string;
-  };
-  h: {
-    screen: string;
-    svh: string;
-    lvh: string;
-    dvh: string;
-  };
-  rotate: {
-    0: string;
-    2: string;
-    1: string;
-    3: string;
-    6: string;
-    12: string;
-    90: string;
-    45: string;
-    180: string;
-  };
-  scale: {
-    0: string;
-    50: string;
-    75: string;
-    90: string;
-    95: string;
-    100: string;
-    105: string;
-    110: string;
-    125: string;
-    150: string;
-    200: string;
-  };
-  skew: {
-    0: string;
-    2: string;
-    1: string;
-    3: string;
-    6: string;
-    12: string;
-  };
   translate: {
     0: string;
+    4: string;
+    full: string;
     2: string;
     5: string;
     1: string;
-    full: string;
     "1/2": string;
     "1/3": string;
     "2/3": string;
     "1/4": string;
     "3/4": string;
-    4: string;
     8: string;
     0.5: string;
     1.5: string;
@@ -387,10 +369,28 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | "_light" | "
     80: string;
     96: string;
   };
-  strokeWidth: {
+  radius: {
+    none: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    xs: string;
+    full: string;
+  };
+  h: {
+    screen: string;
+    svh: string;
+    lvh: string;
+    dvh: string;
+  };
+  skew: {
     0: string;
     2: string;
     1: string;
+    3: string;
+    6: string;
+    12: string;
   };
 }, {}, {}, {}, "_light" | "_dark" | "_sm" | "_md" | "_lg" | "_xl" | "_2xl", {
   readonly color: {

package/dist/config.js

@@ -10,7 +10,7 @@ const uds = createConfigBuilder({
 	atomic: [],
 	modes: [],
 	modifiers: [],
-	macros: {},
+	compositeStyles: {},
 	motion: {},
 	components: {},
 	globalStyles: {},

package/dist/core/dist/compositeStyles.d.ts

@@ -0,0 +1,22 @@
+import { CompositeStylesConfig } from "@uds/types";
+
+//#region ../core/dist/compositeStyles.d.ts
+//#region src/compositeStyles.d.ts
+/** Set the composite-styles config (called by loader at build time) */
+declare function setCompositeStylesConfig(config: CompositeStylesConfig): void;
+/** Get the current composite-styles config */
+declare function getCompositeStylesConfig(): CompositeStylesConfig;
+/**
+ * Expand composite-style props into their constituent style props + marker classes.
+ *
+ * - Composite styles are lowest priority: explicit props always win
+ * - Nested composite styles are supported (a style bag can reference another group)
+ * - Circular references are detected and throw
+ * - Marker classes (e.g. "elevation-0") are returned for modifier targeting
+ */
+declare function expandCompositeStyles(props: Record<string, unknown>, config?: CompositeStylesConfig): {
+  expanded: Record<string, unknown>;
+  markerClasses: string[];
+}; //#endregion
+//#endregion
+export { expandCompositeStyles, getCompositeStylesConfig, setCompositeStylesConfig };

package/dist/core/dist/compositeStyles.js

@@ -0,0 +1,51 @@
+import { safeTokenName } from "../../utils/dist/string-utils/cssVar.js";
+import "../../utils/dist/index.js";
+//#region ../core/dist/compositeStyles.js
+/**
+* Runtime composite-styles config — set by the loader/codegen at build time.
+* Maps composite-style group names to a `{ label, description?, styles }`
+* definition where `styles` holds variant id -> style bag.
+*/
+let compositeStylesConfig = {};
+/** Set the composite-styles config (called by loader at build time) */
+function setCompositeStylesConfig(config) {
+	compositeStylesConfig = config;
+}
+/** Get the current composite-styles config */
+function getCompositeStylesConfig() {
+	return compositeStylesConfig;
+}
+/**
+* Expand composite-style props into their constituent style props + marker classes.
+*
+* - Composite styles are lowest priority: explicit props always win
+* - Nested composite styles are supported (a style bag can reference another group)
+* - Circular references are detected and throw
+* - Marker classes (e.g. "elevation-0") are returned for modifier targeting
+*/
+function expandCompositeStyles(props, config = compositeStylesConfig) {
+	const expanded = {};
+	const markers = [];
+	const seen = /* @__PURE__ */ new Set();
+	function expand(key, value) {
+		const def = config[key];
+		if (def && typeof value === "string") {
+			if (seen.has(key)) throw new Error(`Circular composite style: ${[...seen, key].join(" → ")}`);
+			seen.add(key);
+			markers.push(`${key}-${safeTokenName(value)}`);
+			const bag = def.styles[value];
+			if (bag) {
+				for (const [k, v] of Object.entries(bag)) if (!(k in expanded)) expand(k, v);
+			}
+			seen.delete(key);
+		} else if (!(key in expanded)) expanded[key] = value;
+	}
+	for (const [key, value] of Object.entries(props)) if (key in config) expand(key, value);
+	for (const [key, value] of Object.entries(props)) if (!(key in config)) expanded[key] = value;
+	return {
+		expanded,
+		markerClasses: markers
+	};
+}
+//#endregion
+export { expandCompositeStyles, getCompositeStylesConfig, setCompositeStylesConfig };

package/dist/core/dist/createComponent.d.ts

@@ -1,6 +1,7 @@
 import { CreateComponentConfig, CreateComponentProps, CreateComponentRenderFn, CreateComponentSlotTagConfig, CreateComponentTypeInput } from "@uds/types";
 
 //#region ../core/dist/createComponent.d.ts
+//#region src/createComponent.d.ts
 type PrimitiveTag = keyof React.JSX.IntrinsicElements;
 type SpecConfig<TSpec> = TSpec extends {
   config: infer TConfig extends CreateComponentTypeInput;
@@ -51,6 +52,6 @@ declare function createComponent<TSpecOrProps = {}>(tag: PrimitiveTag): React.FC
   props: infer TOwnProps;
 } ? CreateComponentProps<TConfig, TOwnProps, PrimitiveTag> : PrimitiveOwnProps<TSpecOrProps>>;
 declare function createComponent<TSpec>(renderFn: CreateComponentRenderFn<SpecConfig<TSpec>, SpecOwnProps<TSpec>, SpecSlotConfig<TSpec>>): React.FC<CreateComponentProps<SpecConfig<TSpec>, SpecOwnProps<TSpec>, SpecSlotConfig<TSpec>>>;
-declare function createComponent(config: CreateComponentConfig<string>, renderFn: CreateComponentRenderFn<any, any, any>): React.FC<any>;
+declare function createComponent(config: CreateComponentConfig<string>, renderFn: CreateComponentRenderFn<any, any, any>): React.FC<any>; //#endregion
 //#endregion
 export { createComponent };

package/dist/core/dist/createComponentExample.d.ts

@@ -1,6 +1,7 @@
 import { ComponentProps, ComponentType } from "react";
 
 //#region ../core/dist/createComponentExample.d.ts
+//#region src/createComponentExample.d.ts
 /**
  * Extracts variant fixtures from a Component's props type.
  * If Button has `variant?: 'brand' | 'outline'` and `size?: 'sm' | 'md'`,
@@ -36,6 +37,6 @@ type ExamplesResult<TComponent extends ComponentType<any>> = {
  * }));
  * ```
  */
-declare function createComponentExample<TComponent extends ComponentType<any>, T extends Record<string, ExampleFn<TComponent>>>(Component: TComponent, examplesFn: (fixtures: VariantFixtures<TComponent>) => ExamplesResult<TComponent>): ComponentExample<T>;
+declare function createComponentExample<TComponent extends ComponentType<any>, T extends Record<string, ExampleFn<TComponent>>>(Component: TComponent, examplesFn: (fixtures: VariantFixtures<TComponent>) => ExamplesResult<TComponent>): ComponentExample<T>; //#endregion
 //#endregion
 export { ComponentExample, createComponentExample };

package/dist/core/dist/createProvider.d.ts

@@ -1,4 +1,5 @@
 //#region ../core/dist/createProvider.d.ts
+//#region src/createProvider.d.ts
 type ProviderRenderFn<TContext, TProps = Record<never, never>> = (props: {
   children: React.ReactNode;
 } & TProps) => {
@@ -7,6 +8,6 @@ type ProviderRenderFn<TContext, TProps = Record<never, never>> = (props: {
 };
 declare function createProvider<TContext, TProps = Record<never, never>>(name: string, renderFn: ProviderRenderFn<TContext, TProps>): [React.FC<{
   children: React.ReactNode;
-} & TProps>, () => TContext];
+} & TProps>, () => TContext]; //#endregion
 //#endregion
 export { createProvider };

package/dist/core/dist/generated/stylePropsTwMap.d.ts

@@ -1,4 +1,5 @@
 //#region ../core/dist/generated/stylePropsTwMap.d.ts
+//#region src/generated/stylePropsTwMap.d.ts
 declare const stylePropsTwMap: {
   readonly "border-boolean": {
     readonly border: "boolean";
@@ -1695,6 +1696,6 @@ declare const stylePropsTwMap: {
   readonly "hyphens-manual": {
     readonly hyphens: "manual";
   };
-};
+}; //#endregion
 //#endregion
 export { stylePropsTwMap };

package/dist/core/dist/getComponentStyles.d.ts

@@ -1,6 +1,7 @@
 import { ComponentRegistry, ComponentSlotsOf, ComponentVariantsOf } from "@uds/types";
 
 //#region ../core/dist/getComponentStyles.d.ts
+//#region src/getComponentStyles.d.ts
 type ResolveSlots<Name extends string> = Name extends keyof ComponentRegistry ? ComponentSlotsOf<Name> : string;
 type ResolveVariants<Name extends string> = Name extends keyof ComponentRegistry ? ComponentVariantsOf<Name> : Record<string, string>;
 interface UdsRuntimeMeta {
@@ -44,6 +45,6 @@ interface ComponentStyler<Name extends string> {
  * @param slots - Array of slot names
  * @param element - Optional HTML element tag for element-specific prop forwarding
  */
-declare function createComponentStyler<Name extends string>(componentName: Name, slots: readonly string[], element?: string, variants?: readonly string[]): ComponentStyler<Name>;
+declare function createComponentStyler<Name extends string>(componentName: Name, slots: readonly string[], element?: string, variants?: readonly string[]): ComponentStyler<Name>; //#endregion
 //#endregion
 export { createComponentStyler };

package/dist/core/dist/getStyles.d.ts

@@ -2,6 +2,7 @@ import { ClassValue } from "clsx";
 import { ModifierProp, ModifierProps, StyleAndModifierProps, StyleProps } from "@uds/types";
 
 //#region ../core/dist/getStyles.d.ts
+//#region src/getStyles.d.ts
 /** Convert kebab-case CSS property to camelCase for React inline styles.
  *  CSS custom properties (--*) are kept as-is since React supports them verbatim. */
 declare function toCamelCase(str: string): string;
@@ -37,6 +38,6 @@ interface GetStylesParams extends StyleProps, ModifierProps {
  *  so they can be included in the CSS safelist.
  */
 declare function getStyles(props: GetStylesParams): string;
-declare function getVariantClassName(componentName: string, variant: string | undefined): string;
+declare function getVariantClassName(componentName: string, variant: string | undefined): string; //#endregion
 //#endregion
 export { createVariants, cx, getStyles, getVariantClassName, processStyleProps, toCamelCase };