@yahoo/uds-v5-wip 1.61.0 → 1.62.0

package/dist/config/dist/component-config.js

@@ -1,163 +0,0 @@
-//#region ../config/dist/component-config.js
-/**
-* Marker for a boolean JSX prop. Use inside the `props` block:
-*
-*     props: {
-*       loading: bool(),
-*       disabled: bool(),
-*     }
-*
-* Drives both the TS type (consumer sees `loading?: boolean`) and the
-* Studio design panel control (toggle).
-*/
-function bool() {
-	return { __kind: "bool" };
-}
-/**
-* Marker for a string-valued JSX prop. Parallel to `bool()` — emits
-* `data-<kebab-name>="<value>"` on each layer's bundle so CSS can
-* target the rendered value. Use inside the `props` block:
-*
-*     props: {
-*       kind: string(),
-*       tone: string(),
-*     }
-*
-* Drives both the TS type (consumer sees `kind?: string`) and the
-* Studio design panel control (text input).
-*/
-function string() {
-	return { __kind: "string" };
-}
-/**
-* Bind a registered style prop. Single string arg defaults to the
-* root layer; chain `.on(layerName)` to target a non-root layer:
-*
-*     props: {
-*       bg:        styleProp('bg'),                  // root layer
-*       textColor: styleProp('color').on('label'),   // label layer
-*     }
-*
-* The `__kind: 'styleProp'` discriminator lets the design panel render
-* a color/token picker (driven by the registered style prop's value
-* space) and lets codegen scan props uniformly off the marker shape.
-*/
-function styleProp(ref) {
-	return buildStylePropMarker("root", ref);
-}
-function buildStylePropMarker(layer, ref) {
-	return {
-		__kind: "styleProp",
-		layer,
-		ref,
-		on(name) {
-			return buildStylePropMarker(name, ref);
-		}
-	};
-}
-/**
-* Token-reference marker for style values. Use inside `base`, enum
-* entries, and `compoundProps` overrides:
-*
-*     base: { root: { bg: token('bg/brand') } }
-*     props: {
-*       variant: enums({
-*         brand: { root: { color: token('color/on-brand') } },
-*       }),
-*     }
-*
-* Codegen and runtime detect the `__kind: 'token'` discriminator and
-* resolve the `ref` to `var(--<prefix>-<ns>-<name>)`. The design
-* panel uses the same discriminator to offer a token picker.
-*/
-function token(ref) {
-	return {
-		__kind: "token",
-		ref
-	};
-}
-/**
-* Token-group reference for `defineStyleProp({ values: [...] })`. Pulls
-* every token in the named namespace into the style prop's accepted
-* value set. The resolver expands the group at registration time:
-*
-*     defineStyleProp({
-*       cssProperty: 'padding',
-*       classPrefix: 'p',
-*       values: [tokenGroup('spacing')],   // → p-1, p-2, p-3, …
-*     })
-*
-* The `__kind: 'tokenGroup'` discriminator lets codegen and the design
-* panel branch on group references without parsing strings.
-*/
-function tokenGroup(group) {
-	return {
-		__kind: "tokenGroup",
-		group
-	};
-}
-/**
-* Marker for an enum-valued JSX prop. Each value maps to a per-layer
-* style override. Use inside the `props` block:
-*
-*     props: {
-*       variant: enums({
-*         brand: { root: { bg: '{bg/brand}', color: '{color/on-brand}' } },
-*         ghost: { root: { color: '{color/on-primary}' } },
-*       }),
-*     }
-*
-* The shape of each value mirrors a partial layer-style map keyed by
-* the component's own layer names.
-*/
-function enums(values) {
-	return {
-		__kind: "enum",
-		values
-	};
-}
-function composite(ref) {
-	return {
-		__kind: "composite",
-		ref
-	};
-}
-function slot(path, options) {
-	if (path === void 0) return {
-		__kind: "slot",
-		layer: "",
-		prop: "children"
-	};
-	if (options) return {
-		__kind: "slot",
-		layer: path,
-		prop: options.prop
-	};
-	const slashIdx = path.indexOf("/");
-	if (slashIdx === -1) return {
-		__kind: "slot",
-		layer: path,
-		prop: "children"
-	};
-	return {
-		__kind: "slot",
-		layer: path.slice(0, slashIdx),
-		prop: path.slice(slashIdx + 1)
-	};
-}
-/**
-* Marker factory — use inside `compoundProps[].layers.<layer>` to hide
-* a layer entirely when the entry's `when` clause matches.
-*
-*     compoundProps: [
-*       {
-*         when: { variant: 'compact' },
-*         layers: { endIcon: hidden() },
-*       },
-*     ]
-*/
-function hidden() {
-	return { __kind: "hidden" };
-}
-//#endregion
-export { bool, composite, enums, hidden, slot, string, styleProp, token, tokenGroup };

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

@@ -1,121 +0,0 @@
-//#region ../config/dist/component-refs.d.ts
-//#region src/component-refs.d.ts
-/**
- * Augmentable registries + ref types for the component-API surface.
- *
- * Codegen runs `uds build` and populates the four interfaces below in
- * each consumer app's `.uds/uds-env.d.ts`. The ref types derived from
- * them narrow helper arguments against what's actually registered —
- * `composite('elevation')` typechecks only if `elevation` is a real
- * `RegisteredComposites` key, `styleProp('bg')` only if `bg` is a real
- * `RegisteredStyleProps` key, etc.
- *
- * Without the augmentation loaded (e.g. inside `@uds/config`'s own
- * test files), each registry is `{}` and the corresponding ref type
- * falls open to `string`. Helpers downstream are expected to fail
- * open in that case so package-internal authoring sites don't all
- * error.
- */
-/**
- * Registered components. Each key is the registered component name
- * (e.g. `Box`, `Text`); each value is the component's resolved prop
- * shape, e.g.
- *
- *     export interface RegisteredComponents {
- *       Box2: {
- *         backgroundColor: RegisteredStyleProps['bg'];
- *         color: RegisteredStyleProps['color'];
- *       };
- *       Spinner: {};
- *     }
- *
- * Composed layers use `Partial<RegisteredComponents[K]>` on
- * `defaultProps` for type-safe completion when nesting components
- * inside other components' configs.
- *
- * Populated by codegen from `uds.config.ts`'s `.registerComponents({...})`
- * call.
- */
-interface RegisteredComponents {}
-/**
- * Registered style props. Key is the JSX prop name; value is the
- * string-literal union of allowed token names for that prop, e.g.
- *
- *     export interface RegisteredStyleProps {
- *       bg: 'brand' | 'accent' | 'primary';
- *       color: 'brand' | 'on-brand';
- *     }
- *
- * Components reference these directly when wiring JSX-prop types:
- * `bg?: RegisteredStyleProps['bg']`. Downstream `Props<TConfig>`
- * resolves `styleProp('bg')` markers against this map.
- *
- * Populated by codegen from `uds.config.ts`'s `.registerStyleProps({...})`
- * call. A `never` value means the prop registered no tokens
- * (arbitrary-only); the consumer should widen those to `string`.
- */
-interface RegisteredStyleProps {}
-/**
- * Registered composite-style names. Each key is the composite
- * identifier (e.g. `elevation`, `severity`); value is `void`.
- *
- * Populated by codegen from `uds.config.ts`'s `.registerComposites({...})`
- * call.
- */
-interface RegisteredComposites {}
-/**
- * Registered motion-preset names. Each key is the preset identifier
- * (e.g. `fadeIn`); value is `void`.
- *
- * Populated by codegen from `uds.config.ts`'s `.defineMotion({...})`
- * (motion has no separate `.registerMotion` step today; the entries
- * come directly from `defineMotion` keys).
- */
-interface RegisteredMotion {}
-/**
- * Registered `_<modifier>` props (`_hover`, `_focus`, `_dark`,
- * `_pressed`, `_ariaSelected`, …). Each key is the modifier name; the
- * value is `Partial<T>` so authoring sites get autocomplete against
- * the component's own prop surface inside the modifier block:
- *
- *     <Box _hover={{ bg: 'brand', color: 'on-brand' }} />
- *
- * Populated by codegen — `BUILT_IN_PSEUDO` from
- * `style-prop-runtime.ts` (all standard pseudo classes) merged with
- * config-defined mode modifiers (`_dark`, `_sm`, …) and any custom
- * modifiers registered via `.defineModifiers({...})`. The base
- * interface here stays empty so without the augmentation loaded
- * (inside `@uds/config`'s own tests) the modifier surface
- * gracefully collapses to nothing — same fail-open pattern as the
- * other registries above.
- *
- * Referenced by `Props<TConfig>` to narrow modifier keys; the
- * codegen-emitted `Registered${Name}Props` type aliases reference
- * this interface directly for the same narrowing.
- */
-interface RegisteredModifiers<T> {}
-/**
- * Brace-wrapped reference to a registered React component. Falls open
- * to `'{${string}}'` when the registry is unaugmented (e.g. inside
- * `@uds/config`'s own tests, where codegen hasn't populated the
- * interface). Consumer apps load the codegen-emitted augmentation and
- * get narrow `'{Box}' | '{Text}' | …` autocomplete.
- */
-type ComponentRef = [keyof RegisteredComponents] extends [never] ? `{${string}}` : `{${Extract<keyof RegisteredComponents, string>}}`;
-/**
- * Brace-wrapped reference to a registered style prop. Falls open when
- * unaugmented (see {@link ComponentRef}).
- */
-type StylePropRef = [keyof RegisteredStyleProps] extends [never] ? `{${string}}` : `{${Extract<keyof RegisteredStyleProps, string>}}`;
-/**
- * Brace-wrapped reference to a registered composite style. Falls open
- * when unaugmented.
- */
-type CompositeRef = [keyof RegisteredComposites] extends [never] ? `{${string}}` : `{${Extract<keyof RegisteredComposites, string>}}`;
-/**
- * Brace-wrapped reference to a registered motion preset. Falls open
- * when unaugmented.
- */
-type MotionRef = [keyof RegisteredMotion] extends [never] ? `{${string}}` : `{${Extract<keyof RegisteredMotion, string>}}`; //#endregion
-//#endregion
-export { ComponentRef, CompositeRef, MotionRef, RegisteredComponents, RegisteredComposites, RegisteredModifiers, RegisteredMotion, RegisteredStyleProps, StylePropRef };