@yahoo/uds-create-config 2.45.0 → 3.0.1

package/dist/native/components.d.ts

@@ -1,139 +0,0 @@
-import { TokenRef } from "../refs.js";
-import { BooleanMarker, NumberMarker, RequiredBrand, SlotMarker, StringMarker, VariantMarkerArray } from "../markers.js";
-import { NativeTokenValue } from "./types.js";
-import { ReactNode } from "react";
-
-//#region src/native/components.d.ts
-type RequiredBuilder<T extends {
-  readonly __required?: boolean;
-}> = T & {
-  required(): T & RequiredBrand;
-};
-type NativeStringSlotMarker = Omit<SlotMarker, 'required'> & {
-  readonly __valueType: 'string';
-  required(): NativeStringSlotMarker & RequiredBrand;
-};
-type NativeComponentPropMarker = SlotMarker | BooleanMarker | StringMarker | NumberMarker | VariantMarkerArray;
-interface NativeComponentPropHelpers {
-  slot(): SlotMarker;
-  slot(options: {
-    type: 'string';
-  }): NativeStringSlotMarker;
-  boolean(): RequiredBuilder<BooleanMarker>;
-  string(): RequiredBuilder<StringMarker>;
-  number(): RequiredBuilder<NumberMarker>;
-  variant<const TValues extends readonly (string | number)[]>(values: TValues): RequiredBuilder<VariantMarkerArray<TValues>>;
-}
-type NativeSlotValue<TMarker extends SlotMarker> = TMarker['__valueType'] extends 'string' ? string : ReactNode;
-type NativePropValue<TMarker> = TMarker extends SlotMarker ? NativeSlotValue<TMarker> : TMarker extends BooleanMarker ? boolean : TMarker extends StringMarker ? string : TMarker extends NumberMarker ? number : TMarker extends VariantMarkerArray<infer TValues> ? TValues[number] : never;
-type RequiredNativePropKeys<TProps> = { [K in keyof TProps]: TProps[K] extends {
-  readonly __required: true;
-} ? K : never }[keyof TProps];
-type NativeComponentPropsFromMarkers<TProps> = { [K in RequiredNativePropKeys<TProps>]-?: NativePropValue<TProps[K]> } & { [K in Exclude<keyof TProps, RequiredNativePropKeys<TProps>>]?: NativePropValue<TProps[K]> };
-type ResolvedNativeComponentProps<TProps extends Record<string, NativeComponentPropMarker>, TDefaults> = { [K in keyof TProps as K extends keyof TDefaults ? K : TProps[K] extends {
-  readonly __required: true;
-} ? K : never]-?: NativePropValue<TProps[K]> } & { [K in keyof TProps as K extends keyof TDefaults ? never : TProps[K] extends {
-  readonly __required: true;
-} ? never : K]?: NativePropValue<TProps[K]> };
-type NativeLayerKind = 'view' | 'text' | 'image';
-interface NativeLayerDefinition<TKind extends NativeLayerKind = NativeLayerKind, TPublicStyle extends string | undefined = string | undefined> {
-  readonly kind: TKind;
-  readonly styleProp?: TPublicStyle;
-}
-interface NativeLayerBuilder<TKind extends NativeLayerKind> extends NativeLayerDefinition<TKind, undefined> {
-  publicStyle<const TName extends string = 'style'>(name?: TName): NativeLayerDefinition<TKind, TName>;
-}
-/** Define a React Native style target. */
-declare function nativeLayer<const TKind extends NativeLayerKind>(kind: TKind): NativeLayerBuilder<TKind>;
-type NativeStyleValue = NativeTokenValue | readonly NativeStyleValue[] | {
-  readonly [key: string]: NativeStyleValue;
-};
-type NativeLayerStyle = Readonly<Record<string, NativeStyleValue>>;
-type NativeLayerStyles = Readonly<Record<string, NativeLayerStyle>>;
-type NativeLayerNames<TLayers> = keyof TLayers & string;
-type LayerStylesFor<TLayers> = Partial<Record<NativeLayerNames<TLayers>, NativeLayerStyle>>;
-interface NativeComponentStyles<TLayers extends Record<string, NativeLayerDefinition> = Record<string, NativeLayerDefinition>> {
-  readonly base?: LayerStylesFor<TLayers>;
-  readonly variants?: Readonly<Record<string, Readonly<Record<string, LayerStylesFor<TLayers>>>>>;
-  readonly booleans?: Readonly<Record<string, Readonly<{
-    true?: LayerStylesFor<TLayers>;
-    false?: LayerStylesFor<TLayers>;
-  }>>>;
-  readonly runtimeStates?: Readonly<Record<string, LayerStylesFor<TLayers>>>;
-  /** Scalar design values exposed to render code through `values.*()`. */
-  readonly values?: Readonly<Record<string, NativeTokenValue>>;
-}
-interface NativeComponentStyleHelpers {
-  token(name: string): TokenRef;
-}
-/** Serializable design data for one first-class native component. */
-interface NativeComponentDefinition<TId extends string = string, TLayers extends Record<string, NativeLayerDefinition> = Record<string, NativeLayerDefinition>, TProps extends Record<string, NativeComponentPropMarker> = Record<string, NativeComponentPropMarker>, TDefaults extends Partial<NativeComponentPropsFromMarkers<TProps>> = Partial<NativeComponentPropsFromMarkers<TProps>>, TStyles extends NativeComponentStyles<TLayers> = NativeComponentStyles<TLayers>> {
-  readonly id: TId;
-  readonly layers: TLayers;
-  readonly props: TProps;
-  readonly defaultProps?: TDefaults;
-  readonly label?: string;
-  readonly description?: string;
-  readonly styles: TStyles;
-}
-type RegisteredNativeComponent<TId extends string = string, TLayers extends Record<string, NativeLayerDefinition> = Record<string, NativeLayerDefinition>, TProps extends Record<string, NativeComponentPropMarker> = Record<string, NativeComponentPropMarker>, TDefaults extends Partial<NativeComponentPropsFromMarkers<TProps>> = Partial<NativeComponentPropsFromMarkers<TProps>>, TStyles extends NativeComponentStyles<TLayers> = NativeComponentStyles<TLayers>> = NativeComponentDefinition<TId, TLayers, TProps, TDefaults, TStyles> & {
-  readonly __nativeComponent: true;
-  readonly __renderPath: string;
-};
-type RuntimeStateNames<TComponent> = TComponent extends NativeComponentDefinition<string, Record<string, NativeLayerDefinition>, Record<string, NativeComponentPropMarker>, Partial<NativeComponentPropsFromMarkers<Record<string, NativeComponentPropMarker>>>, infer TStyles> ? TStyles extends {
-  runtimeStates: infer TStates;
-} ? keyof TStates & string : string : string;
-type NamedValues<TComponent> = TComponent extends NativeComponentDefinition<string, Record<string, NativeLayerDefinition>, Record<string, NativeComponentPropMarker>, Partial<NativeComponentPropsFromMarkers<Record<string, NativeComponentPropMarker>>>, infer TStyles> ? TStyles extends {
-  values: infer TValues;
-} ? keyof TValues & string : never : never;
-type LayersOf<TComponent> = TComponent extends {
-  readonly layers: infer TLayers extends Record<string, NativeLayerDefinition>;
-} ? TLayers : never;
-type PropMarkersOf<TComponent> = TComponent extends {
-  readonly props: infer TProps extends Record<string, NativeComponentPropMarker>;
-} ? TProps : never;
-type DefaultsOf<TComponent> = TComponent extends {
-  readonly defaultProps?: infer TDefaults;
-} ? TDefaults : Record<never, never>;
-type NativeComponentProps<TComponent> = NativeComponentPropsFromMarkers<PropMarkersOf<TComponent>>;
-type NativeGeneratedRenderProps<TComponent, TStyleByLayer extends Record<NativeLayerNames<LayersOf<TComponent>>, unknown>> = ResolvedNativeComponentProps<PropMarkersOf<TComponent>, DefaultsOf<TComponent>> & {
-  styles: { [K in NativeLayerNames<LayersOf<TComponent>>]: (state?: Partial<Record<RuntimeStateNames<TComponent>, boolean>>) => TStyleByLayer[K] };
-  values: { [K in NamedValues<TComponent>]: () => string | number | boolean };
-};
-/** Props the copied native render receives from its generated wrapper. */
-type NativeRenderProps<TComponent, TStyleByLayer extends Record<NativeLayerNames<LayersOf<TComponent>>, unknown>, TRuntimeProps extends object = Record<never, never>> = TRuntimeProps extends unknown ? Omit<TRuntimeProps, keyof NativeComponentProps<TComponent>> & NativeGeneratedRenderProps<TComponent, TStyleByLayer> : never;
-interface NativeComponentStyledBuilder<TId extends string, TLayers extends Record<string, NativeLayerDefinition>, TProps extends Record<string, NativeComponentPropMarker>, TDefaults extends Partial<NativeComponentPropsFromMarkers<TProps>>, TStyles extends NativeComponentStyles<TLayers>> extends NativeComponentDefinition<TId, TLayers, TProps, TDefaults, TStyles> {
-  render(path: string): RegisteredNativeComponent<TId, TLayers, TProps, TDefaults, TStyles>;
-}
-interface NativeComponentBuilder<TId extends string, TLayers extends Record<string, NativeLayerDefinition>, TProps extends Record<string, NativeComponentPropMarker>, TDefaults extends Partial<NativeComponentPropsFromMarkers<TProps>>> {
-  styles<const TStyles extends NativeComponentStyles<TLayers>>(callback: (helpers: NativeComponentStyleHelpers) => TStyles): NativeComponentStyledBuilder<TId, TLayers, TProps, TDefaults, TStyles>;
-}
-/**
- * Define a first-class React Native component. The render path remains a
- * build-only source pointer and is never serialized into native config data.
- */
-declare function defineNativeComponent<const TId extends string, const TLayers extends Record<string, NativeLayerDefinition>, const TProps extends Record<string, NativeComponentPropMarker>, const TDefaults extends Partial<NativeComponentPropsFromMarkers<TProps>> = Record<never, never>>(definition: {
-  id: TId;
-  layers: TLayers;
-  props: (helpers: NativeComponentPropHelpers) => TProps;
-  defaultProps?: TDefaults;
-  label?: string;
-  description?: string;
-}): NativeComponentBuilder<TId, TLayers, TProps, TDefaults>;
-interface NativeComponentGroupDefinition<TComponents extends Record<string, RegisteredNativeComponent> = Record<string, RegisteredNativeComponent>> {
-  readonly components: TComponents;
-  readonly label?: string;
-  readonly description?: string;
-}
-declare function defineNativeComponentGroup<const TComponents extends Record<string, RegisteredNativeComponent>>(definition: {
-  components: TComponents;
-  label?: string;
-  description?: string;
-}): NativeComponentGroupDefinition<TComponents>;
-interface SerializedNativeComponentGroup {
-  readonly components: readonly string[];
-  readonly label?: string;
-  readonly description?: string;
-}
-//#endregion
-export { NativeComponentBuilder, NativeComponentDefinition, NativeComponentGroupDefinition, NativeComponentPropMarker, NativeComponentProps, NativeComponentPropsFromMarkers, NativeComponentStyleHelpers, NativeComponentStyledBuilder, NativeComponentStyles, NativeLayerDefinition, NativeLayerKind, NativeLayerStyle, NativeLayerStyles, NativeRenderProps, NativeStyleValue, RegisteredNativeComponent, SerializedNativeComponentGroup, defineNativeComponent, defineNativeComponentGroup, nativeLayer };

package/dist/native/components.js

@@ -1,67 +0,0 @@
-import { attachSourcePath, captureCallerPath } from "../captureCallerPath.js";
-import { token } from "../refs.js";
-import { boolean, number, slot, string, variant } from "../factories.js";
-//#region src/native/components.ts
-function nativeSlot(options) {
-	return options === void 0 ? slot() : slot(options);
-}
-const nativeComponentPropHelpers = {
-	slot: nativeSlot,
-	boolean,
-	string,
-	number,
-	variant
-};
-/** Define a React Native style target. */
-function nativeLayer(kind) {
-	const layer = { kind };
-	Object.defineProperty(layer, "publicStyle", {
-		enumerable: false,
-		configurable: true,
-		value(name = "style") {
-			Object.defineProperty(layer, "styleProp", {
-				enumerable: true,
-				configurable: true,
-				value: name
-			});
-			return layer;
-		}
-	});
-	return layer;
-}
-/**
-* Define a first-class React Native component. The render path remains a
-* build-only source pointer and is never serialized into native config data.
-*/
-function defineNativeComponent(definition) {
-	const sourcePath = captureCallerPath();
-	const props = definition.props(nativeComponentPropHelpers);
-	return { styles(callback) {
-		const component = attachSourcePath({
-			id: definition.id,
-			layers: definition.layers,
-			props,
-			...definition.defaultProps !== void 0 ? { defaultProps: definition.defaultProps } : {},
-			...definition.label !== void 0 ? { label: definition.label } : {},
-			...definition.description !== void 0 ? { description: definition.description } : {},
-			styles: callback({ token })
-		}, sourcePath);
-		Object.defineProperty(component, "render", {
-			enumerable: false,
-			configurable: true,
-			value(renderPath) {
-				Object.defineProperties(component, {
-					__nativeComponent: { value: true },
-					__renderPath: { value: renderPath }
-				});
-				return component;
-			}
-		});
-		return component;
-	} };
-}
-function defineNativeComponentGroup(definition) {
-	return attachSourcePath(definition, captureCallerPath());
-}
-//#endregion
-export { defineNativeComponent, defineNativeComponentGroup, nativeLayer };

package/dist/native/index.d.ts

@@ -1,18 +0,0 @@
-import { AssetRef, TokenRef, asset, token } from "../refs.js";
-import { ColorSpace, MixExpr, alpha, mix } from "../colorExpressions.js";
-import { SystemLink, TokenType } from "../types.js";
-import { DefinedTokenGroupValue } from "../factories.js";
-import { NativeComponentBuilder, NativeComponentDefinition, NativeComponentGroupDefinition, NativeComponentProps, NativeComponentStyleHelpers, NativeComponentStyledBuilder, NativeComponentStyles, NativeLayerDefinition, NativeLayerKind, NativeLayerStyle, NativeLayerStyles, NativeRenderProps, NativeStyleValue, RegisteredNativeComponent, SerializedNativeComponentGroup, defineNativeComponent, defineNativeComponentGroup, nativeLayer } from "./components.js";
-import { ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeDefaultModes, NativeDependencyPolicy, NativeDependencyPolicyEntry, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeSelectableValue, NativeStyleEngine, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig } from "./types.js";
-import { NativeAssetGroupBuilder, NativeFontAssetGroupConfig, defineAssetGroup } from "./assets.js";
-import { defineMode } from "./modes.js";
-import { NativeConfigDiagnostic, NativeConfigDiagnosticCode, validateSerializedNativeConfig } from "./validation.js";
-import { NativeConfig, NativeConfigValidationError } from "./NativeConfig.js";
-import { isOperatingSystemValue, operatingSystem } from "./values.js";
-
-//#region src/native/index.d.ts
-type DefinedNativeTokenGroup<T extends Record<string, NativeTokenDefinition>> = DefinedTokenGroupValue<T>;
-/** Native and web use the same token-group factory implementation. */
-declare function defineTokenGroup<const T extends Record<string, NativeTokenDefinition>>(tokens: T): DefinedNativeTokenGroup<T>;
-//#endregion
-export { DefinedNativeTokenGroup, defineTokenGroup };

package/dist/native/index.js

@@ -1,17 +0,0 @@
-import "../refs.js";
-import "../colorExpressions.js";
-import { defineTokenGroupValue } from "../factories.js";
-import "./assets.js";
-import "./components.js";
-import "./modes.js";
-import "./values.js";
-import "./validation.js";
-import "./NativeConfig.js";
-//#region src/native/index.ts
-/** Native / React Native authoring entry point over shared config concepts. */
-/** Native and web use the same token-group factory implementation. */
-function defineTokenGroup(tokens) {
-	return defineTokenGroupValue(tokens);
-}
-//#endregion
-export { defineTokenGroup };

package/dist/native/modes.d.ts

@@ -1,10 +0,0 @@
-import { NativeModeDefinition } from "./types.js";
-
-//#region src/native/modes.d.ts
-/**
- * Native mode authoring uses the shared option/modifier model while requiring
- * each option to describe the application condition that activates it.
- */
-declare function defineMode<const T extends NativeModeDefinition>(modes: T): T;
-//#endregion
-export { defineMode };

package/dist/native/modes.js

@@ -1,11 +0,0 @@
-import { attachSourcePath, captureCallerPath } from "../captureCallerPath.js";
-//#region src/native/modes.ts
-/**
-* Native mode authoring uses the shared option/modifier model while requiring
-* each option to describe the application condition that activates it.
-*/
-function defineMode(modes) {
-	return attachSourcePath(modes, captureCallerPath());
-}
-//#endregion
-export { defineMode };

package/dist/native/types.d.ts

@@ -1,95 +0,0 @@
-import { AssetRef, TokenRef } from "../refs.js";
-import { MixExpr } from "../colorExpressions.js";
-import { LinkedSystemPin, TokenDefinitionFor, TokenGroupDefinitionFor, TokenModifierKey } from "../types.js";
-import { NativeComponentDefinition, SerializedNativeComponentGroup } from "./components.js";
-
-//#region src/native/types.d.ts
-type NativeLiteral = string | number | boolean;
-/** Shared scalar color expression whose result can be emitted as an RN color. */
-type NativeColorExpression = MixExpr;
-/** A native value that can appear inside one iOS/Android branch. */
-type NativeSelectableValue = NativeLiteral | TokenRef | AssetRef | NativeColorExpression;
-type OperatingSystemInput = {
-  default: NativeSelectableValue;
-  ios?: NativeSelectableValue;
-  android?: NativeSelectableValue;
-} | {
-  default?: never;
-  ios: NativeSelectableValue;
-  android: NativeSelectableValue;
-};
-/** Serializable selection marker; selection occurs in generated app code. */
-interface OperatingSystemValue {
-  readonly __kind: 'operatingSystem';
-  readonly default?: NativeSelectableValue;
-  readonly ios?: NativeSelectableValue;
-  readonly android?: NativeSelectableValue;
-}
-type NativeTokenValue = NativeSelectableValue | OperatingSystemValue;
-type NativeTokenDefinition = TokenDefinitionFor<NativeTokenValue>;
-type NativeTokenGroupDefinition = TokenGroupDefinitionFor<NativeTokenDefinition>;
-interface NativeModeOptionBase {
-  /** Modifier contributed by this option. Defaults to `_${optionName}`. */
-  modifier?: TokenModifierKey;
-  label?: string;
-  description?: string;
-}
-/** An option driven by the React Native color-scheme condition. */
-type NativeAppearanceModeOption = NativeModeOptionBase & {
-  appearance: 'light' | 'dark';
-  minWidth?: never;
-};
-/** An option driven by the current React Native window width. */
-type NativeViewportModeOption = NativeModeOptionBase & {
-  minWidth: number;
-  appearance?: never;
-};
-type NativeModeOptionDefinition = NativeAppearanceModeOption | NativeViewportModeOption;
-type NativeModeDefinition = Record<string, NativeModeOptionDefinition>;
-/** Native-entry compatibility name for the platform-specific mode shape. */
-type ModeDefinition = NativeModeDefinition;
-/** Registered mode selections used when resolveTheme() receives no override. */
-type NativeDefaultModes = Record<string, string>;
-/** Styling runtime selected for generated native component and adapter files. */
-type NativeStyleEngine = 'react-native' | 'unistyles';
-interface NativeBuildOptions {
-  /** Trusted root containing native component definitions and render source. */
-  componentsDir?: string;
-}
-/** Where a consuming project must make a native component dependency available. */
-interface NativeDependencyPolicyEntry {
-  providedBy: 'consumer' | 'registry';
-  /** Semver range accepted by the system that authored the components. */
-  version: string;
-}
-type NativeDependencyPolicy = Record<string, NativeDependencyPolicyEntry>;
-interface NativeFontAssetMember {
-  /** Family identifier React Native consumes after the app registers the font. */
-  fontFamily: string;
-}
-interface NativeFontAssetGroupDefinition {
-  assetKind: 'font';
-  members: Record<string, NativeFontAssetMember>;
-  label?: string;
-  description?: string;
-}
-type NativeAssetGroupDefinition = NativeFontAssetGroupDefinition;
-interface SerializedNativeConfig {
-  schemaVersion: number;
-  platform: 'native';
-  builtAt?: string;
-  namespace?: string;
-  styleEngine?: NativeStyleEngine;
-  buildOptions?: NativeBuildOptions;
-  dependencyPolicy?: NativeDependencyPolicy;
-  defaultModes?: NativeDefaultModes;
-  modes?: Record<string, NativeModeDefinition>;
-  tokenGroups?: Record<string, NativeTokenGroupDefinition>;
-  assetGroups?: Record<string, NativeAssetGroupDefinition>;
-  components?: Record<string, NativeComponentDefinition>;
-  componentGroups?: Record<string, SerializedNativeComponentGroup>;
-  /** Source-system pins, same contract as the web `SerializedConfig`. */
-  linkedSystems?: Record<string, LinkedSystemPin>;
-}
-//#endregion
-export { ModeDefinition, NativeAppearanceModeOption, NativeAssetGroupDefinition, NativeBuildOptions, NativeColorExpression, NativeDefaultModes, NativeDependencyPolicy, NativeDependencyPolicyEntry, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeModeDefinition, NativeModeOptionDefinition, NativeSelectableValue, NativeStyleEngine, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, NativeViewportModeOption, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig };

package/dist/native/validation.d.ts

@@ -1,8 +0,0 @@
-import { ConfigDiagnostic } from "../config-diagnostics.js";
-
-//#region src/native/validation.d.ts
-type NativeConfigDiagnosticCode = 'INVALID_SCHEMA' | 'UNSUPPORTED_SCHEMA_VERSION' | 'PLATFORM_MISMATCH' | 'INVALID_NAMESPACE' | 'INVALID_NATIVE_VALUE' | 'UNSUPPORTED_NATIVE_FIELD' | 'INCOMPLETE_OS_VALUE' | 'NESTED_OS_VALUE' | 'INVALID_REFERENCE' | 'UNRESOLVED_TOKEN_REFERENCE' | 'TOKEN_REFERENCE_CYCLE' | 'UNRESOLVED_ASSET_REFERENCE' | 'UNOWNED_MODIFIER' | 'DUPLICATE_MODIFIER' | 'INVALID_DEFAULT_MODE' | 'INVALID_DEPENDENCY_POLICY' | 'INVALID_MODE_CONDITION' | 'INVALID_MODE_COMBINATION' | 'UNSUPPORTED_COLOR_EXPRESSION';
-type NativeConfigDiagnostic = ConfigDiagnostic<NativeConfigDiagnosticCode>;
-declare function validateSerializedNativeConfig(input: unknown, expectedSchemaVersion?: number): NativeConfigDiagnostic[];
-//#endregion
-export { NativeConfigDiagnostic, NativeConfigDiagnosticCode, validateSerializedNativeConfig };