@yahoo/uds-create-config 1.9.0 → 1.11.0-v3-import.1

package/dist/types.d.ts

@@ -1,7 +1,8 @@
-import { ComponentRef, CompositeRef, ModeRef, TagRef, TokenGroupRef, TokenRef } from "./refs.js";
+import { AssetRef, ComponentRef as ComponentRef$1, CompositeRef, ModeRef, TagRef, TokenGroupRef, TokenRef } from "./refs.js";
 import { ColorExpression } from "./colorExpressions.js";
 import { CssPropertyName, CssPropertyValues } from "./types/css-properties.js";
 import { IconAssetMetadata } from "./defineAssetGroup.js";
+import { ComponentRef, JSX } from "react";
 
 //#region src/types.d.ts
 /**
@@ -21,7 +22,7 @@ type TokenType = string;
  *   expression to a CSS function call (`color-mix(...)`,
  *   `linear-gradient(...)`) via `resolveColorExpression`.
  */
-type TokenValue = string | number | boolean | TokenRef | ColorExpression;
+type TokenValue = string | number | boolean | TokenRef | AssetRef | ColorExpression;
 type TokenModifierKey = `_${string}`;
 type TokenModifierValue = TokenValue | TokenDefinition;
 /**
@@ -143,11 +144,16 @@ interface ValueAlias {
  *    (e.g. `'transparent'` for `border-color`).
  *  - `number` — bare numeric values where CSS itself accepts numbers
  *    (e.g. `line-clamp: 3`).
+ *  - `boolean` — a toggle value. `true` emits the bare class prefix as a
+ *    hook (the runtime `boolAlias` path), `false` emits nothing (off);
+ *    combine with string entries for a `boolean | 'first' | 'last'`-style
+ *    surface (e.g. `nestedBorderRadius`). The accompanying `cssProperty`
+ *    is typically a custom property used only as the class carrier.
  *  - `ValueAlias<P>` — `{ alias, value }` pair for Tailwind-style
  *    shorthands; the alias appears at the JSX value site and resolves
  *    to the underlying CSS keyword at emit time.
  */
-type ValuesEntry<P extends StylePropProperty = StylePropProperty> = TokenGroupRef | LiteralFor<P> | number | ValueAlias;
+type ValuesEntry<P extends StylePropProperty = StylePropProperty> = TokenGroupRef | LiteralFor<P> | number | boolean | ValueAlias;
 interface ArbitrarySpec {
   type?: TokenType;
 }
@@ -302,7 +308,7 @@ interface StylePropDefinition<P extends StylePropProperty> {
 interface AnyStylePropDefinition {
   cssProperty: StylePropProperty | readonly StylePropProperty[];
   classPrefix: string;
-  values?: readonly (TokenGroupRef | string | number | ValueAlias)[];
+  values?: readonly (TokenGroupRef | string | number | boolean | ValueAlias)[];
   arbitrary?: ArbitraryInput;
   /** See {@link StylePropDefinition.negative} — emit `calc(<value> * -1)`. */
   negative?: boolean;
@@ -362,7 +368,7 @@ type MotionDefinitionInput = CssMotionDefinition | JsMotionDefinition;
  * code because they round-trip cleanly through JSON.
  */
 interface LayerWithOverrides {
-  tag: string | TagRef | ComponentRef;
+  tag: string | TagRef | ComponentRef$1;
   defaultProps?: Record<string, unknown>;
   base?: Record<string, unknown>;
   [key: string]: unknown;
@@ -387,7 +393,7 @@ interface LayerWithOverrides {
  *    `Layer.tag` and leaves the remaining fields on the layer entry
  *    for codegen to read.
  */
-type LayerInput = string | TagRef | ComponentRef | ComponentDefinition | LayerWithOverrides;
+type LayerInput = string | TagRef | ComponentRef$1 | ComponentDefinition | LayerWithOverrides;
 type BaseStyles = Record<string, Record<string, unknown>>;
 interface CompoundPropsEntry {
   when: Record<string, unknown>;
@@ -467,6 +473,22 @@ type RootTag<TLayers> = TLayers extends {
  * the narrow forms only kick in when authoring chains thread literal
  * generics through (`defineComponent('div')` → `TTag = 'div'`).
  */
+/**
+ * HTML or SVG tag name used to declare a component's forwarded-ref target
+ * element via `.config({ ref: 'button' })`. Opt-in by design: a component that
+ * omits `ref` exposes no `ref` prop at all, rather than a guessed default.
+ *
+ * Sourced from React's `JSX.IntrinsicElements` (not the DOM lib's
+ * `HTMLElementTagNameMap`) so it resolves under the Bun tsconfig, whose `lib`
+ * omits the DOM tag-name maps.
+ */
+type RefTag = keyof JSX.IntrinsicElements;
+/**
+ * Map a {@link RefTag} to its DOM element interface via React's `ComponentRef`
+ * — `'div'` → `HTMLDivElement`, `'svg'` → `SVGSVGElement`. Falls back to
+ * `HTMLElement` for anything that isn't a known intrinsic tag.
+ */
+type RefElement<Tag> = Tag extends keyof JSX.IntrinsicElements ? ComponentRef<Tag> : HTMLElement;
 interface ComponentDefinition<TLayers extends Record<string, LayerInput> = Record<string, LayerInput>, TProps extends Record<string, PropBinding> = Record<string, PropBinding>, TTag extends string | undefined = string | undefined> {
   layers: TLayers;
   props?: TProps;
@@ -474,6 +496,13 @@ interface ComponentDefinition<TLayers extends Record<string, LayerInput> = Recor
   defaultProps?: Record<string, unknown>;
   compoundProps?: readonly CompoundPropsEntry[];
   motion?: ComponentMotionValue;
+  /**
+   * Opt-in forwarded-ref target — an HTML/SVG tag name declaring which DOM
+   * element a consumer `ref` lands on. Drives the typed `ref?: Ref<...>` on the
+   * component's JSX surface and the `ref` arg handed to its render fn. Omit it
+   * and the component exposes no `ref` prop (no guessed default element).
+   */
+  ref?: RefTag;
   /**
    * Phantom slot — populated only as a type marker (never read at
    * runtime) so `RootTag<TLayers>` callers can fall back to this when
@@ -607,6 +636,13 @@ interface FontAssetMember {
    * JSON the browser loader derives `@font-face` rules from.
    */
   readonly declarations: readonly Record<string, unknown>[];
+  /**
+   * Governance flag stamped at registration from the group's `deprecated`
+   * FontID list. Deprecated fonts stay fully selectable (no hard block) —
+   * this only lets the picker surface a badge. Rides the open index, so it
+   * round-trips through serialization with the rest of the record.
+   */
+  readonly deprecated?: boolean;
   readonly [key: string]: unknown;
 }
 /**
@@ -725,4 +761,4 @@ interface SerializedConfig {
   providers?: Record<string, Record<string, never>>;
 }
 //#endregion
-export { AnyStylePropDefinition, ArbitraryEntry, ArbitrarySpec, BaseStyles, BuildOptions, ComponentDefinition, ComponentGroupDefinition, ComponentMetadata, ComponentMotionValue, CompositeStyleDefinition, CompositeStyleObject, CompoundPropsEntry, CssMotionDefinition, FontAssetMember, GlobalStylesDef, JsMotionDefinition, LayerInput, LiteralFor, ModeDefinition, ModeOptionDefinition, ModifierDefinition, MotionDefinitionInput, MotionKeyframes, MotionStateKeyframe, MotionTransition, OpacityPairSpec, PreviewDefinition, PropBinding, RootTag, SerializedAssetGroup, SerializedComponent, SerializedComponentGroup, SerializedConfig, SerializedFontAssetGroup, SerializedIconAssetGroup, SerializedTokenGroup, SlotMotion, StylePropDefinition, StylePropMetadata, StylePropProperty, TokenDefinition, TokenGroupDefinition, TokenModifierKey, TokenModifierValue, TokenType, TokenValue, ValuesEntry };
+export { AnyStylePropDefinition, ArbitraryEntry, ArbitrarySpec, BaseStyles, BuildOptions, ComponentDefinition, ComponentGroupDefinition, ComponentMetadata, ComponentMotionValue, CompositeStyleDefinition, CompositeStyleObject, CompoundPropsEntry, CssMotionDefinition, FontAssetMember, GlobalStylesDef, JsMotionDefinition, LayerInput, LiteralFor, ModeDefinition, ModeOptionDefinition, ModifierDefinition, MotionDefinitionInput, MotionKeyframes, MotionStateKeyframe, MotionTransition, OpacityPairSpec, PreviewDefinition, PropBinding, RefElement, RefTag, RootTag, SerializedAssetGroup, SerializedComponent, SerializedComponentGroup, SerializedConfig, SerializedFontAssetGroup, SerializedIconAssetGroup, SerializedTokenGroup, SlotMotion, StylePropDefinition, StylePropMetadata, StylePropProperty, TokenDefinition, TokenGroupDefinition, TokenModifierKey, TokenModifierValue, TokenType, TokenValue, ValuesEntry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahoo/uds-create-config",
-  "version": "1.9.0",
+  "version": "1.11.0-v3-import.1",
   "type": "module",
   "private": false,
   "files": [
@@ -68,7 +68,7 @@
   "dependencies": {
     "@babel/parser": "^7.29.0",
     "motion": "^12.35.0",
-    "@yahoo/uds-create-utils": "1.9.0"
+    "@yahoo/uds-create-utils": "1.11.0-v3-import.1"
   },
   "devDependencies": {
     "@babel/types": "^7.29.0",