@yahoo/uds-v5-wip 1.36.1 → 1.37.0

package/dist/config/dist/component-resolution.d.ts

@@ -1 +1 @@
-import { ComponentsConfig } from "@uds/types";
+export { };

package/dist/config/dist/consts/defaultColors.d.ts

@@ -1,4 +1,5 @@
 //#region ../config/dist/consts/defaultColors.d.ts
+//#region src/consts/defaultColors.d.ts
 declare const defaultColors: {
   inherit: string;
   current: string;
@@ -247,6 +248,6 @@ declare const defaultColors: {
   'rose-800': string;
   'rose-900': string;
   'rose-950': string;
-};
+}; //#endregion
 //#endregion
 export { defaultColors };

package/dist/config/dist/createConfig.d.ts

@@ -1,9 +1,10 @@
 import { AnyStyleProp } from "./defineStyleProp.js";
-import { ResolvedStyleProp } from "./resolveStyleProp.js";
 import { TokenType, VarsConfig } from "./types.js";
+import { ResolvedStyleProp } from "./resolveStyleProp.js";
 import { BaseModifierProp, ComponentsConfig, CompositeStylesConfig, ConfigurableProp, ModifierProp, MotionPreset, RemotionComponentDef, RemotionConfig, RemotionTransitionDef } from "@uds/types";
 
 //#region ../config/dist/createConfig.d.ts
+//#region src/createConfig.d.ts
 type MotionPresetsDef = Record<string, MotionPreset>;
 type MotionAliasValue<TMotion> = TMotion extends Record<string, infer V> ? Extract<V, string> : never;
 type EmptyMotion = {};
@@ -76,6 +77,12 @@ type GetModifierFromInput<I extends ModesInput> = { [SetKey in keyof I]: { [OptK
 } ? M extends ModifierNameShape ? M : never : OptKey extends string ? `_${OptKey}` : never }[keyof I[SetKey]['options']] }[keyof I];
 /** Reject any input whose derived/explicit modifiers collide with reserved names. */
 type CheckForReservedModifiersInput<I extends ModesInput> = true extends HasReservedModifier<GetModifierFromInput<I>> ? 'ERROR: Cannot use reserved modifier names from ModifierProp. Please use a different modifier name.' : I;
+/**
+ * Convert the authored object-keyed input into the internal `ModeGroup[]` shape.
+ * Derives `_${optionKey}` modifiers when no explicit `modifier` is provided.
+ * Never sets `default: true` — the new API has no concept of a default option;
+ * downstream consumers treat "no option active" as the implicit default.
+ */
 interface ModifierDef {
   modifier: ModifierNameShape;
   selector: string;
@@ -155,6 +162,7 @@ type VarsToTokens<TVars extends VarsConfig> = { [K in keyof TVars]: { [T in Excl
 type MergeTokens<A, B> = { [K in keyof A | keyof B]: K extends keyof B ? K extends keyof A ? A[K] & B[K] : B[K] : K extends keyof A ? A[K] : never };
 /** Build a structured token reference object from atomic tokens */
 declare function buildTokenReference(atomic: AtomicToken<ModifierNameShape>[], configPrefix: string): Record<string, Record<string, string>>;
+/** Build a structured composite-styles reference object for use in defineModifiers context */
 /** Global styles definition — CSS selector → style props */
 type GlobalStylesDef = Record<string, Record<string, any>>;
 /** CSS properties for the example wrapper element */
@@ -313,6 +321,10 @@ interface UdsConfig<TModifier extends ModifierNameShape = ModifierProp, TTokens
 type AnyUdsConfig = UdsConfig<ModifierNameShape, any, any, any, any, any, any>;
 /** Extract the raw config data from a builder instance */
 declare function resolveConfig(config: AnyUdsConfig): UdsConfigData;
+/**
+ * Resolve configuration with all token references replaced by their raw values.
+ * Useful for tools that need the actual values (e.g. anatomy generation).
+ */
 declare function createConfigBuilder<TModifier extends ModifierNameShape = ModifierProp, TTokens = EmptyTokens, TMotion = EmptyMotion, TExt extends Record<string, any> = {}, TCompositeStyles = EmptyCompositeStyles, TModeModifiers extends ModifierNameShape = never, TVars extends VarsConfig = EmptyVars>(data: UdsConfigData, extensions?: TExt): UdsConfig<TModifier, TTokens, TMotion, TExt, TCompositeStyles, TModeModifiers, TVars> & TExt;
 interface InterpolateMarker {
   __type: 'interpolate';

package/dist/config/dist/defineComponent.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/config/dist/defineStyleProp.d.ts

@@ -1,4 +1,4 @@
-import { CssValue, CssValueTypeName } from "./types/css-values.js";
+import { CssValueTypeName } from "./types/css-values.js";
 
 //#region ../config/dist/defineStyleProp.d.ts
 /** Runtime input type for `toCss` based on the entry's `type`. */
@@ -22,10 +22,20 @@ type ArbitraryEntry = { [T in CssValueTypeName]: {
  *  - An array of {@link ArbitraryEntry} for multi-shape acceptance.
  */
 type ArbitrarySpec = CssValueTypeName | readonly ArbitraryEntry[];
+/**
+ * The literal-keyword subset of values a property accepts, derived from
+ * {@link CssPropertyValues}[P]. For custom CSS properties (`--*`) the value
+ * type is governed by the required `cssType` field instead, so any string
+ * is accepted at the type level.
+ */
 type StylePropMetadata = {
   label?: string;
   description?: string;
 };
+/**
+ * A finalized style prop. Returned by `defineStyleProp(spec).metadata(meta)`.
+ * Consumers wrap these in `uds.registerStyleProps({ <propName>: ... })`.
+ */
 /**
  * Structurally-loose form of {@link StyleProp}. Any concrete `StyleProp<P>`
  * is assignable to this. Used at registration / resolution boundaries where
@@ -41,5 +51,6 @@ interface AnyStyleProp {
   readonly cssType?: CssValueTypeName;
   readonly metadata: StylePropMetadata;
 }
+/** Intermediate builder — the only callable method is `.metadata()`. */
 //#endregion
 export { AnyStyleProp, ArbitraryEntry, ArbitrarySpec, StylePropMetadata };

package/dist/config/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { defaultColors } from "./consts/defaultColors.js";
 import { ColorFn, ColorKeyword, CssAngle, CssColor, CssLength, CssPercentage, CssRatio, CssTime, CssValue, CssValueTypeName, HexColor, HslColor, RgbColor } from "./types/css-values.js";
 import { AnyStyleProp, ArbitraryEntry, ArbitrarySpec, StylePropMetadata } from "./defineStyleProp.js";
-import { ResolvedStyleProp, ResolvedToken } from "./resolveStyleProp.js";
 import { TokenType, VarGroupDef, VarTokenDef, VarsConfig } from "./types.js";
 import { AtomicToken, BuildOptions, CheckForReservedModifiersInput, ComponentConfig, DefineComponentInput, DefineComponentMotionInput, ExampleDef, ExampleEntryDef, ExampleLayoutStyles, GetModifierFromInput, GlobalStylesDef, InterpolateMarker, ModeGroup, ModeOption, ModeOptionInput, ModeSetInput, ModesInput, ModifierDef, MotionPresetsDef, UdsConfig, UdsConfigData, buildTokenReference, createConfigBuilder, darker, lighter, resolveConfig } from "./createConfig.js";
+import { ResolvedStyleProp, ResolvedToken } from "./resolveStyleProp.js";
 import { SerializedConfig, TokenRef, buildReverseMap, deserializeConfig, serializeConfig } from "./serialize.js";
 import { ComponentsConfig as ComponentsConfig$1 } from "@uds/types";
 export { type ComponentsConfig$1 as ComponentsConfig };

package/dist/config/dist/index.js

@@ -6,4 +6,5 @@ import "./resolveStyleProp.js";
 import "./createConfig.js";
 import "./defineStyleProp.js";
 import "./propertyGroups.js";
+import "./refs.js";
 import "./serialize.js";

package/dist/config/dist/refs.js

@@ -0,0 +1 @@
+import "../../utils/dist/index.js";

package/dist/config/dist/resolveStyleProp.d.ts

@@ -1,6 +1,7 @@
 import { CssValueTypeName } from "./types/css-values.js";
 import { ArbitrarySpec, StylePropMetadata } from "./defineStyleProp.js";
 //#region ../config/dist/resolveStyleProp.d.ts
+//#region src/resolveStyleProp.d.ts
 interface ResolvedToken {
   /** The token's raw key, e.g. `'brand'`. */
   readonly name: string;
@@ -51,5 +52,11 @@ interface ResolvedStyleProp {
   readonly arbitrary: ArbitrarySpec | undefined;
   readonly metadata: StylePropMetadata;
 }
+/**
+ * Structurally-loose input shape for the resolver. Any `StyleProp<P>` from
+ * `defineStyleProp` is assignable to this. Defined locally so the
+ * resolver's signature doesn't expand `ValuesEntry<P>` over the full CSS
+ * property union (TS2590).
+ */
 //#endregion
 export { ResolvedStyleProp, ResolvedToken };

package/dist/config/dist/serialize.d.ts

@@ -3,6 +3,7 @@ import { AtomicToken, ExampleDef, ModeGroup, ModifierDef, MotionPresetsDef, UdsC
 import { CompositeStylesConfig } from "@uds/types";
 
 //#region ../config/dist/serialize.d.ts
+//#region src/serialize.d.ts
 type ModifierNameShape = `_${string}`;
 type TokenRef = {
   $ref: string;
@@ -67,6 +68,6 @@ declare function serializeConfig(config: UdsConfig): SerializedConfig;
  * Resolves `$ref` markers back to `var()` strings using the atomic token
  * definitions, then reconstructs the builder chain.
  */
-declare function deserializeConfig(data: SerializedConfig): UdsConfig;
+declare function deserializeConfig(data: SerializedConfig): UdsConfig; //#endregion
 //#endregion
 export { SerializedConfig, TokenRef, buildReverseMap, deserializeConfig, serializeConfig };

package/dist/config/dist/types/css-values.d.ts

@@ -1,4 +1,5 @@
 //#region ../config/dist/types/css-values.d.ts
+//#region src/types/css-values.d.ts
 /**
  * CSS value-type primitives — building blocks used by {@link CssPropertyValues}
  * in `./css-properties` and by `defineStyleProp` to constrain authored values.
@@ -55,6 +56,6 @@ type CssValue = {
   ident: string;
   string: string;
 };
-type CssValueTypeName = keyof CssValue;
+type CssValueTypeName = keyof CssValue; //#endregion
 //#endregion
 export { ColorFn, ColorKeyword, CssAngle, CssColor, CssLength, CssPercentage, CssRatio, CssTime, CssValue, CssValueTypeName, HexColor, HslColor, RgbColor };

package/dist/config/dist/types.d.ts

@@ -1,4 +1,5 @@
 //#region ../config/dist/types.d.ts
+//#region src/types.d.ts
 /**
  * Scalar DTCG-aligned token types. Composite types (shadow, gradient,
  * typography, border, transition, cubicBezier) are intentionally deferred
@@ -59,6 +60,6 @@ type VarGroupDef<M extends `_${string}` = `_${string}`> = {
  *   spacing: { $type: 'dimension', 1: { value: '0.25rem' }, 2: { value: '0.5rem' } },
  * }
  */
-type VarsConfig<M extends `_${string}` = `_${string}`> = Record<string, VarGroupDef<M>>;
+type VarsConfig<M extends `_${string}` = `_${string}`> = Record<string, VarGroupDef<M>>; //#endregion
 //#endregion
 export { TokenType, VarGroupDef, VarTokenDef, VarsConfig };

package/dist/config.d.ts

@@ -35,9 +35,50 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
     };
   };
 }>, {
+  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;
+    1: string;
+    2: string;
+    3: string;
+    6: string;
+    12: string;
+    90: string;
+    45: string;
+    180: string;
+  };
   color: {
-    transparent: string;
     inherit: string;
+    transparent: string;
     current: string;
     "always/black": string;
     "always/white": string;
@@ -60,16 +101,22 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
     inverse: string;
     "on-inverse": string;
   };
-  shadow: {
-    none: string;
-    sm: string;
-    md: string;
-    lg: string;
-    xl: string;
-    "2xl": string;
-    xs: string;
-    "2xs": string;
-    inner: string;
+  borderColor: {
+    brand: string;
+    accent: string;
+    alert: string;
+    positive: string;
+    warning: string;
+    primary: string;
+    secondary: string;
+    tertiary: string;
+    inverse: string;
+    surface: string;
+    "brand-wash": string;
+    "accent-wash": string;
+    "alert-wash": string;
+    "positive-wash": string;
+    "warning-wash": string;
   };
   position: {
     auto: string;
@@ -81,111 +128,17 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
     "2/4": string;
     "3/4": string;
   };
-  flex: {
-    1: string;
-    initial: string;
-    auto: string;
-    none: string;
-  };
-  rotate: {
-    0: string;
-    1: string;
-    2: 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;
-  };
-  translate: {
-    0: string;
-    1: string;
-    full: string;
-    "1/2": string;
-    "1/3": string;
-    "2/3": string;
-    "1/4": string;
-    "3/4": string;
-    2: string;
-    4: string;
-    8: string;
-    0.5: string;
-    1.5: string;
-    2.5: string;
-    3: string;
-    3.5: string;
-    5: string;
-    6: string;
-    7: string;
-    9: string;
-    10: string;
-    11: string;
-    12: string;
-    14: string;
-    16: string;
-    20: string;
-    24: string;
-    28: string;
-    32: string;
-    36: string;
-    40: string;
-    44: string;
-    48: string;
-    52: string;
-    56: string;
-    60: string;
-    64: string;
-    72: string;
-    80: string;
-    96: string;
-  };
-  animation: {
-    none: string;
-    spin: string;
-    ping: string;
-  };
-  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;
-  };
   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;
-    min: string;
-    max: string;
     fit: string;
     "1/5": string;
     "2/5": string;
@@ -197,6 +150,11 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
     "4/6": string;
     "5/6": string;
   };
+  animation: {
+    none: string;
+    ping: string;
+    spin: string;
+  };
   bg: {
     overlay: string;
     brand: string;
@@ -218,32 +176,6 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
     "positive-wash": string;
     "warning-wash": string;
   };
-  radius: {
-    none: string;
-    sm: string;
-    md: string;
-    lg: string;
-    xl: string;
-    full: string;
-    xs: string;
-  };
-  borderColor: {
-    brand: string;
-    accent: string;
-    alert: string;
-    positive: string;
-    warning: string;
-    primary: string;
-    secondary: string;
-    tertiary: string;
-    inverse: string;
-    surface: string;
-    "brand-wash": string;
-    "accent-wash": string;
-    "alert-wash": string;
-    "positive-wash": string;
-    "warning-wash": string;
-  };
   borderWidth: {
     none: string;
     thin: string;
@@ -252,19 +184,16 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
   };
   divideWidth: {
     0: string;
+    4: string;
     reverse: string;
     2: string;
-    4: string;
     8: string;
   };
-  blur: {
+  flex: {
     none: string;
-    sm: string;
-    md: string;
-    lg: string;
-    xl: string;
-    "2xl": string;
-    "3xl": string;
+    initial: string;
+    auto: string;
+    1: string;
   };
   flexGrow: {
     0: string;
@@ -273,12 +202,29 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
   flexShrink: {
     0: string;
   };
+  aspectRatio: {
+    square: string;
+    landscape: string;
+    portrait: string;
+    widescreen: string;
+    ultrawide: string;
+    golden: string;
+  };
+  zIndex: {
+    0: string;
+    auto: string;
+    10: string;
+    20: string;
+    40: string;
+    30: string;
+    50: string;
+  };
   spacing: {
     0: string;
+    4: string;
     1: string;
     px: string;
     2: string;
-    4: string;
     8: string;
     0.5: string;
     1.5: string;
@@ -310,62 +256,57 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
     80: string;
     96: string;
   };
-  zIndex: {
+  w: {
+    screen: string;
+    svw: string;
+    lvw: string;
+    dvw: string;
+  };
+  outlineWidth: {
     0: string;
-    auto: string;
-    10: string;
-    20: string;
-    40: string;
-    30: string;
-    50: string;
+    4: string;
+    1: string;
+    2: string;
+    8: string;
   };
   outlineOffset: {
     0: string;
+    4: string;
     1: string;
     2: string;
-    4: string;
     8: string;
   };
   ringWidth: {
     0: string;
-    1: string;
+    4: string;
     inset: string;
+    1: string;
     2: string;
-    4: string;
     8: string;
   };
   ringOffsetWidth: {
     0: string;
+    4: string;
     1: string;
     2: string;
-    4: string;
     8: string;
   };
-  h: {
-    screen: string;
-    svh: string;
-    lvh: string;
-    dvh: string;
-  };
-  w: {
-    screen: string;
-    svw: string;
-    lvw: string;
-    dvw: string;
+  shadow: {
+    none: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    "2xl": string;
+    "2xs": string;
+    xs: string;
+    inner: string;
   };
   strokeWidth: {
     0: string;
     1: string;
     2: string;
   };
-  skew: {
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-    6: string;
-    12: string;
-  };
   fontFamily: {
     sans: string;
     serif: string;
@@ -373,8 +314,8 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
   };
   fontWeight: {
     normal: string;
-    bold: string;
     thin: string;
+    bold: string;
     medium: string;
     extralight: string;
     light: string;
@@ -391,8 +332,8 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
     widest: string;
   };
   lineHeight: {
-    normal: string;
     none: string;
+    normal: string;
     tight: string;
     relaxed: string;
   };
@@ -401,23 +342,82 @@ declare const defaultPreset: UdsConfig<_$_uds_types0.ModifierProp | GetModifierF
     sm: string;
     md: string;
     lg: string;
-    xs: string;
     "2xs": string;
+    xs: string;
   };
-  outlineWidth: {
+  blur: {
+    none: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    "2xl": string;
+    "3xl": string;
+  };
+  translate: {
     0: string;
+    4: string;
+    full: string;
     1: string;
+    "1/2": string;
+    "1/3": string;
+    "2/3": string;
+    "1/4": string;
+    "3/4": string;
     2: string;
-    4: string;
     8: string;
+    0.5: string;
+    1.5: string;
+    2.5: string;
+    3: string;
+    3.5: string;
+    5: string;
+    6: string;
+    7: string;
+    9: string;
+    10: string;
+    11: string;
+    12: string;
+    14: string;
+    16: string;
+    20: string;
+    24: string;
+    28: string;
+    32: string;
+    36: string;
+    40: string;
+    44: string;
+    48: string;
+    52: string;
+    56: string;
+    60: string;
+    64: string;
+    72: string;
+    80: string;
+    96: string;
   };
-  aspectRatio: {
-    square: string;
-    landscape: string;
-    portrait: string;
-    widescreen: string;
-    ultrawide: string;
-    golden: string;
+  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;
+    1: string;
+    2: string;
+    3: string;
+    6: string;
+    12: string;
   };
 }, {}, {}, {}, GetModifierFromInput<{
   readonly colorMode: {

package/dist/{_virtual → foundational-presets/dist/_virtual}/_rolldown/runtime.js

@@ -1,4 +1,4 @@
-//#region \0rolldown/runtime.js
+//#region ../foundational-presets/dist/_virtual/_rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};