@yahoo/uds-create-config 2.13.6 → 2.15.0

package/dist/Config.d.ts

@@ -62,6 +62,7 @@ type DependenciesQuery = { [K in DependencyKind]: {
 declare class Config {
   #private;
   static readonly SCHEMA_VERSION = 1;
+  readonly platform: "web";
   prefix: string;
   /**
    * Registry namespace — a stable, `package.json`-style identifier

package/dist/Config.js

@@ -33,6 +33,7 @@ function assertNever(value) {
 }
 var Config = class Config {
 	static SCHEMA_VERSION = 1;
+	platform = "web";
 	prefix = "uds";
 	/**
 	* Registry namespace — a stable, `package.json`-style identifier

package/dist/config-diagnostics.d.ts

@@ -0,0 +1,21 @@
+//#region src/config-diagnostics.d.ts
+/** A stable definition locator that UI, CLI, and migration callers can show. */
+interface ConfigDiagnosticDefinition {
+  kind: string;
+  name?: string;
+}
+/** Platform-neutral structured config diagnostic. */
+interface ConfigDiagnostic<TCode extends string = string> {
+  code: TCode;
+  severity: 'error' | 'warning';
+  path: readonly (string | number)[];
+  definition: ConfigDiagnosticDefinition;
+  reason: string;
+}
+/** Structured config failure shared by platform validators. */
+declare class ConfigValidationError<TDiagnostic extends ConfigDiagnostic = ConfigDiagnostic> extends Error {
+  readonly diagnostics: readonly TDiagnostic[];
+  constructor(diagnostics: readonly TDiagnostic[], message?: string);
+}
+//#endregion
+export { ConfigDiagnostic, ConfigDiagnosticDefinition, ConfigValidationError };

package/dist/config-diagnostics.js

@@ -0,0 +1,12 @@
+//#region src/config-diagnostics.ts
+/** Structured config failure shared by platform validators. */
+var ConfigValidationError = class extends Error {
+	diagnostics;
+	constructor(diagnostics, message = "Invalid config") {
+		super(diagnostics.length === 0 ? message : `${message}: ${diagnostics.map((diagnostic) => diagnostic.reason).join("; ")}`);
+		this.name = "ConfigValidationError";
+		this.diagnostics = diagnostics;
+	}
+};
+//#endregion
+export { ConfigValidationError };

package/dist/factories.d.ts

@@ -42,6 +42,15 @@ type DefinedTokenGroup<T extends Record<string, TokenDefinition>> = {
   description?: string;
   metadata(meta: TokenGroupMetadata): DefinedTokenGroup<T>;
 };
+/** Shared implementation shape used by platform-specific token definitions. */
+type DefinedTokenGroupValue<T extends Record<string, {
+  value: unknown;
+}>> = {
+  tokens: T;
+  label?: string;
+  description?: string;
+  metadata(meta: TokenGroupMetadata): DefinedTokenGroupValue<T>;
+};
 declare function defineTokenGroup<const T extends Record<string, TokenDefinition>>(t: T): DefinedTokenGroup<T>;
 declare function defineModifier<const T extends ModifierDefinition>(t: T): T;
 declare function defineMode<const T extends ModeDefinition>(t: T): T;
@@ -851,4 +860,4 @@ type ProviderComponent<TProps = Record<never, never>> = FC<{
  */
 type DefinedProvider<TContext = unknown, TProps = Record<never, never>> = readonly [ProviderComponent<TProps>, () => TContext];
 //#endregion
-export { BoundComponent, ComponentBuilder, ComponentBuilderMethods, ComponentRenderFn, ConfigCallbackHelpers, DefineComponentFn, DefinedComponent, DefinedMotion, DefinedProvider, DefinedStyleProp, DefinedTokenGroup, PreviewCallbackHelpers, ProviderComponent, ProviderRenderFn, RawToken, TokenGroupMetadata, TokenRawValue, TypedSlotRef, asChild, boolean, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineStyleProp, defineTokenGroup, motion, number, slot, string, variant };
+export { BoundComponent, ComponentBuilder, ComponentBuilderMethods, ComponentRenderFn, ConfigCallbackHelpers, DefineComponentFn, DefinedComponent, DefinedMotion, DefinedProvider, DefinedStyleProp, DefinedTokenGroup, DefinedTokenGroupValue, PreviewCallbackHelpers, ProviderComponent, ProviderRenderFn, RawToken, TokenGroupMetadata, TokenRawValue, TypedSlotRef, asChild, boolean, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineStyleProp, defineTokenGroup, motion, number, slot, string, variant };

package/dist/factories.js

@@ -3,7 +3,8 @@ import { composite, styleProp, tag, token } from "./refs.js";
 import { darken, lighten } from "./colorExpressions.js";
 import "./defineProvider.js";
 //#region src/factories.ts
-function defineTokenGroup(t) {
+/** @internal Platform-neutral implementation behind web and native factories. */
+function defineTokenGroupValue(t) {
 	const out = {
 		tokens: t,
 		metadata(meta) {
@@ -21,6 +22,9 @@ function defineTokenGroup(t) {
 	});
 	return out;
 }
+function defineTokenGroup(t) {
+	return defineTokenGroupValue(t);
+}
 function defineModifier(t) {
 	return attachSourcePath(t, captureCallerPath());
 }
@@ -468,4 +472,4 @@ defineComponentImpl.layers = function layersEntry(layers) {
 };
 const defineComponent = defineComponentImpl;
 //#endregion
-export { asChild, boolean, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineStyleProp, defineTokenGroup, motion, number, slot, string, variant };
+export { asChild, boolean, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineStyleProp, defineTokenGroup, defineTokenGroupValue, motion, number, slot, string, variant };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { ColorExpression, ColorSpace, ColorValue, GradientStop, GradientValue, L
 import { MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DRAG_AXES, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS } from "./motion-constants.js";
 import { CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, CssPropertyWithKeywords } from "./types/css-property-keywords.js";
 import { ColorCssProperty, CssGlobalKeyword, CssPropertyName, CssPropertyValues } from "./types/css-properties.js";
-import { AnyStylePropDefinition, ArbitrarySpec, BaseStyles, BuildOptions, CanvasRole, CanvasRoleEntry, CanvasRoleEntryInput, CanvasRolesDefinition, CanvasRolesDefinitionInput, CanvasRolesInputConstraint, ComponentDefinition, ComponentGroupDefinition, ComponentMetadata, CompositeStyleDefinition, CompositeStyleObject, CompoundPropsEntry, CssMotionDefinition, CssMotionFields, CssSlotMotion, FontAssetMember, GlobalStylesDef, JsMotionDefinition, JsMotionFields, JsSlotMotion, LayerInput, LinkedComponentsInput, LinkedSystemEntry, LiteralFor, ModeDefinition, ModeOptionDefinition, ModifierDefinition, MotionDefinitionInput, MotionDragBox, MotionKeyframes, MotionMetadata, MotionState, MotionStateKeyframe, MotionTransition, MotionVariants, MotionViewportOptions, OpacityPairSpec, PlaygroundOptions, PlaygroundPage, PlaygroundSpec, PreviewDefinition, PropBinding, SerializedAssetGroup, SerializedComponentGroup, SerializedConfig, SerializedFontAssetGroup, SerializedIconAssetGroup, SerializedPlaygroundOptions, SerializedTokenGroup, SlotMotion, StylePropDefinition, StylePropMetadata, StylePropProperty, SystemLink, TokenDefinition, TokenGroupDefinition, TokenModifierKey, TokenModifierValue, TokenType, TokenValue, ValuesEntry } from "./types.js";
+import { AnyStylePropDefinition, ArbitrarySpec, BaseStyles, BuildOptions, CanvasRole, CanvasRoleEntry, CanvasRoleEntryInput, CanvasRolesDefinition, CanvasRolesDefinitionInput, CanvasRolesInputConstraint, ComponentDefinition, ComponentGroupDefinition, ComponentMetadata, CompositeStyleDefinition, CompositeStyleObject, CompoundPropsEntry, CssMotionDefinition, CssMotionFields, CssSlotMotion, FontAssetMember, GlobalStylesDef, JsMotionDefinition, JsMotionFields, JsSlotMotion, LayerInput, LinkedComponentsInput, LinkedSystemEntry, LiteralFor, ModeDefinition, ModeOptionDefinition, ModifierDefinition, MotionDefinitionInput, MotionDragBox, MotionKeyframes, MotionMetadata, MotionState, MotionStateKeyframe, MotionTransition, MotionVariants, MotionViewportOptions, OpacityPairSpec, PlaygroundOptions, PlaygroundPage, PlaygroundSpec, PreviewDefinition, PropBinding, SerializedAssetGroup, SerializedComponentGroup, SerializedConfig, SerializedFontAssetGroup, SerializedIconAssetGroup, SerializedPlaygroundOptions, SerializedTokenGroup, SlotMotion, StylePropDefinition, StylePropMetadata, StylePropProperty, SystemLink, TokenDefinition, TokenDefinitionFor, TokenGroupDefinition, TokenGroupDefinitionFor, TokenModifierKey, TokenModifierValue, TokenType, TokenValue, ValuesEntry } from "./types.js";
 import { AssetGroupBuilder, AssetGroupConfig, AssetGroupDefinition, FontAssetGroupConfig, FontAssetGroupDefinition, IconAssetGroupConfig, IconAssetGroupDefinition, IconAssetMember, IconAssetMetadata, defineAssetGroup, defineAssetIcon } from "./defineAssetGroup.js";
 import { AssetGroup } from "./AssetGroup.js";
 import { resolveAssetRefCss, resolveFontStack } from "./asset-value.js";
@@ -28,6 +28,7 @@ import { TokenGroup } from "./TokenGroup.js";
 import { Config, DependenciesQuery, DependencyKind, DependencyRef, DependentsQuery, parseRegistryKey } from "./Config.js";
 import { SOURCE_PATH_KEY, attachSourcePath, captureCallerPath, readSourcePath } from "./captureCallerPath.js";
 import { findComponentReferrers } from "./component-referrers.js";
+import { ConfigDiagnostic, ConfigDiagnosticDefinition, ConfigValidationError } from "./config-diagnostics.js";
 import { ELEMENT_MARKER_KIND, ElementMarker, OpaqueLeafPredicate, hasElementMarkerDeep, isElementLikeValue, isElementMarker, reviveElementMarkersDeep, serializeElementsDeep } from "./element-marker.js";
 import { collectFontFaceCss, deriveFontFaceCss, familiesInRawCss } from "./font-face.js";
 import { interpolate } from "./interpolate.js";
@@ -35,4 +36,4 @@ import { resolveRegistryDir } from "./registry-dir.js";
 import { ModeBackedModifierDefinition, ModeBackedModifierInput, ModeBackedModifierLookup, OverrideModeRef, OverrideRow, buildModeBackedModifierLookup, buildNestedModifierUpdate, createModeBackedModifierLookup, mergeModifierUpdates, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, overrideRowsToModifierTree, resolveOverrideRowValue } from "./token-override-rows.js";
 import { rem } from "./units.js";
 import { EntityKind } from "@yahoo/uds-create-types/entity";
-export { ASSET_CLASS_CAPABILITIES, type AnyRef, type AnyStylePropDefinition, type ArbitrarySpec, AssetGroup, type AssetGroupBuilder, type AssetGroupConfig, type AssetGroupDefinition, type AssetGroupName, type AssetGroupRef, type AssetKind, type AssetName, type AssetRef, type BaseStyles, type BooleanMarker, type BoundComponent, type BuildOptions, CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, type CanvasRole, type CanvasRoleEntry, type CanvasRoleEntryInput, type CanvasRolesDefinition, type CanvasRolesDefinitionInput, type CanvasRolesInputConstraint, type ColorCssProperty, type ColorExpression, type ColorFn, type ColorKeyword, type ColorSpace, type ColorValue, Component, type ComponentBuilder, type ComponentBuilderMethods, type ComponentDefinition, ComponentGroup, type ComponentGroupDefinition, type ComponentKind, type ComponentMetadata, type ComponentName, type ComponentRef, type ComponentRenderFn, type CompositeInfo, type CompositeName, type CompositeRef, type CompositeRefBuilder, CompositeStyle, type CompositeStyleDefinition, type CompositeStyleObject, type CompoundPropsEntry, Config, type ConfigCallbackHelpers, type Css, type CssAngle, type CssClassName, type CssColor, type CssDeclaration, type CssGlobalKeyword, type CssLength, CssMotionDef, type CssMotionDefinition, type CssMotionFields, type CssPercentage, type CssPropertyName, type CssPropertyValues, type CssPropertyWithKeywords, type CssRatio, type CssSelector, type CssSlotMotion, type CssTime, type CssValue, type CssValueTypeName, type CssVar, type CssVarRef, type DataAttrs, type DefineComponentFn, type DefinedComponent, type DefinedMotion, type DefinedProvider, type DefinedStyleProp, type DefinedTokenGroup, type DependenciesQuery, type DependencyKind, type DependencyRef, type DependentsQuery, ELEMENT_MARKER_KIND, type ElementMarker, type EntityKind, type FontAssetGroupConfig, type FontAssetGroupDefinition, type FontAssetMember, type FunctionInfo, type GlobalStylesDef, type GradientStop, type GradientValue, type HexColor, type HslColor, type IconAssetGroupConfig, type IconAssetGroupDefinition, type IconAssetMember, type IconAssetMetadata, JsMotionDef, type JsMotionDefinition, type JsMotionFields, type JsSlotMotion, Layer, type LayerInput, type LayerMarker, type LayerPropsMap, type LengthOrPercent, type LineDirection, type LinearGradientExpr, type LinkedComponentsInput, type LinkedSystemEntry, type LiteralFor, MOTION_CSS_DEFINITION_KEYS, MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DEFINITION_KEYS, MOTION_JS_DRAG_AXES, MOTION_JS_FIELD_KEYS, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS, type MixExpr, Mode, type ModeBackedModifierDefinition, type ModeBackedModifierInput, type ModeBackedModifierLookup, type ModeDefinition, type ModeName, ModeOption, type ModeOptionDefinition, type ModeRef, Modifier, type ModifierDefinition, type MotionDef, type MotionDefinitionInput, type MotionDragBox, type MotionKeyframes, type MotionMarker, type MotionMetadata, type MotionName, type MotionState, type MotionStateKeyframe, type MotionTransition, type MotionVariants, type MotionViewportOptions, type NumberMarker, type OpacityPairSpec, type OpaqueLeafPredicate, type OverrideModeRef, type OverrideRow, PREVIEW_SEED_KEY, type PlaygroundOptions, type PlaygroundPage, type PlaygroundSpec, type PreviewAxisMarker, type PreviewCallbackHelpers, type PreviewDefinition, type PreviewPropsRule, type PrimitivePropKind, type PropBase, type PropBinding, type PropInfo, type PropKind, Provider, type RadialGradientExpr, type RadialSize, type RawToken, type RegisteredAssetGroups, type RegisteredComponents, type RegisteredCompositeStyles, type RegisteredModes, type RegisteredModifiers, type RegisteredMotion, type RegisteredStyleProps, type RegisteredTokenGroups, type RequiredBrand, type ResolvedCompoundOverrides, type ResolvedTokenLiteral, type RgbColor, SOURCE_PATH_KEY, type SerializedAssetGroup, type SerializedComponentGroup, type SerializedConfig, type SerializedFontAssetGroup, type SerializedIconAssetGroup, type SerializedPlaygroundOptions, type SerializedTokenGroup, type SlotInfo, type SlotMarker, type SlotMotion, type SlotRef, type SlotValueKind, type SlotValueType, type StringMarker, StyleProp, type StylePropDefinition, type StylePropInfo, type StylePropKeyword, type StylePropMetadata, type StylePropName, type StylePropProperty, type StylePropRef, type StylePropTokenUsage, type SystemLink, type TagName, type TagRef, Token, type TokenDefinition, TokenGroup, type TokenGroupDefinition, type TokenGroupMetadata, type TokenGroupName, type TokenGroupRef, type TokenModifierKey, type TokenModifierValue, type TokenName, type TokenQualifiedName, type TokenRawNameRegistry, type TokenRawValue, type TokenRef, type TokenRefToCss, type TokenType, type TokenValue, type TypedSlotRef, type ValuesEntry, type VariantInfo, type VariantMarker, type VariantMarkerArray, type VariantMarkerObject, alpha, asChild, asset, assetGroup, attachSourcePath, boolean, buildModeBackedModifierLookup, buildNestedModifierUpdate, captureCallerPath, collectFontFaceCss, component, composite, createModeBackedModifierLookup, cssClassName, cssDeclaration, cssSelector, cssVar, defineAssetGroup, defineAssetIcon, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineProvider, defineStyleProp, defineTokenGroup, deriveFontFaceCss, familiesInRawCss, findComponentReferrers, hasElementMarkerDeep, interpolate, isAssetGroupRef, isAssetRef, isBoolMarker, isColorExpression, isComponentRef, isCompositeRef, isElementLikeValue, isElementMarker, isLayerMarker, isLinearGradientExpr, isMixExpr, isModeRef, isMotionMarker, isNumberMarker, isPlaceable, isPreviewAxisMarker, isRadialGradientExpr, isSafeClassNameValue, isSlotMarker, isStringMarker, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, isVariantArrayMarker, isVariantMarker, linearGradient, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveFontStack, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, string, styleProp, tag, token, tokenGroup, variant };
+export { ASSET_CLASS_CAPABILITIES, type AnyRef, type AnyStylePropDefinition, type ArbitrarySpec, AssetGroup, type AssetGroupBuilder, type AssetGroupConfig, type AssetGroupDefinition, type AssetGroupName, type AssetGroupRef, type AssetKind, type AssetName, type AssetRef, type BaseStyles, type BooleanMarker, type BoundComponent, type BuildOptions, CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, type CanvasRole, type CanvasRoleEntry, type CanvasRoleEntryInput, type CanvasRolesDefinition, type CanvasRolesDefinitionInput, type CanvasRolesInputConstraint, type ColorCssProperty, type ColorExpression, type ColorFn, type ColorKeyword, type ColorSpace, type ColorValue, Component, type ComponentBuilder, type ComponentBuilderMethods, type ComponentDefinition, ComponentGroup, type ComponentGroupDefinition, type ComponentKind, type ComponentMetadata, type ComponentName, type ComponentRef, type ComponentRenderFn, type CompositeInfo, type CompositeName, type CompositeRef, type CompositeRefBuilder, CompositeStyle, type CompositeStyleDefinition, type CompositeStyleObject, type CompoundPropsEntry, Config, type ConfigCallbackHelpers, type ConfigDiagnostic, type ConfigDiagnosticDefinition, ConfigValidationError, type Css, type CssAngle, type CssClassName, type CssColor, type CssDeclaration, type CssGlobalKeyword, type CssLength, CssMotionDef, type CssMotionDefinition, type CssMotionFields, type CssPercentage, type CssPropertyName, type CssPropertyValues, type CssPropertyWithKeywords, type CssRatio, type CssSelector, type CssSlotMotion, type CssTime, type CssValue, type CssValueTypeName, type CssVar, type CssVarRef, type DataAttrs, type DefineComponentFn, type DefinedComponent, type DefinedMotion, type DefinedProvider, type DefinedStyleProp, type DefinedTokenGroup, type DependenciesQuery, type DependencyKind, type DependencyRef, type DependentsQuery, ELEMENT_MARKER_KIND, type ElementMarker, type EntityKind, type FontAssetGroupConfig, type FontAssetGroupDefinition, type FontAssetMember, type FunctionInfo, type GlobalStylesDef, type GradientStop, type GradientValue, type HexColor, type HslColor, type IconAssetGroupConfig, type IconAssetGroupDefinition, type IconAssetMember, type IconAssetMetadata, JsMotionDef, type JsMotionDefinition, type JsMotionFields, type JsSlotMotion, Layer, type LayerInput, type LayerMarker, type LayerPropsMap, type LengthOrPercent, type LineDirection, type LinearGradientExpr, type LinkedComponentsInput, type LinkedSystemEntry, type LiteralFor, MOTION_CSS_DEFINITION_KEYS, MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DEFINITION_KEYS, MOTION_JS_DRAG_AXES, MOTION_JS_FIELD_KEYS, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS, type MixExpr, Mode, type ModeBackedModifierDefinition, type ModeBackedModifierInput, type ModeBackedModifierLookup, type ModeDefinition, type ModeName, ModeOption, type ModeOptionDefinition, type ModeRef, Modifier, type ModifierDefinition, type MotionDef, type MotionDefinitionInput, type MotionDragBox, type MotionKeyframes, type MotionMarker, type MotionMetadata, type MotionName, type MotionState, type MotionStateKeyframe, type MotionTransition, type MotionVariants, type MotionViewportOptions, type NumberMarker, type OpacityPairSpec, type OpaqueLeafPredicate, type OverrideModeRef, type OverrideRow, PREVIEW_SEED_KEY, type PlaygroundOptions, type PlaygroundPage, type PlaygroundSpec, type PreviewAxisMarker, type PreviewCallbackHelpers, type PreviewDefinition, type PreviewPropsRule, type PrimitivePropKind, type PropBase, type PropBinding, type PropInfo, type PropKind, Provider, type RadialGradientExpr, type RadialSize, type RawToken, type RegisteredAssetGroups, type RegisteredComponents, type RegisteredCompositeStyles, type RegisteredModes, type RegisteredModifiers, type RegisteredMotion, type RegisteredStyleProps, type RegisteredTokenGroups, type RequiredBrand, type ResolvedCompoundOverrides, type ResolvedTokenLiteral, type RgbColor, SOURCE_PATH_KEY, type SerializedAssetGroup, type SerializedComponentGroup, type SerializedConfig, type SerializedFontAssetGroup, type SerializedIconAssetGroup, type SerializedPlaygroundOptions, type SerializedTokenGroup, type SlotInfo, type SlotMarker, type SlotMotion, type SlotRef, type SlotValueKind, type SlotValueType, type StringMarker, StyleProp, type StylePropDefinition, type StylePropInfo, type StylePropKeyword, type StylePropMetadata, type StylePropName, type StylePropProperty, type StylePropRef, type StylePropTokenUsage, type SystemLink, type TagName, type TagRef, Token, type TokenDefinition, type TokenDefinitionFor, TokenGroup, type TokenGroupDefinition, type TokenGroupDefinitionFor, type TokenGroupMetadata, type TokenGroupName, type TokenGroupRef, type TokenModifierKey, type TokenModifierValue, type TokenName, type TokenQualifiedName, type TokenRawNameRegistry, type TokenRawValue, type TokenRef, type TokenRefToCss, type TokenType, type TokenValue, type TypedSlotRef, type ValuesEntry, type VariantInfo, type VariantMarker, type VariantMarkerArray, type VariantMarkerObject, alpha, asChild, asset, assetGroup, attachSourcePath, boolean, buildModeBackedModifierLookup, buildNestedModifierUpdate, captureCallerPath, collectFontFaceCss, component, composite, createModeBackedModifierLookup, cssClassName, cssDeclaration, cssSelector, cssVar, defineAssetGroup, defineAssetIcon, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineProvider, defineStyleProp, defineTokenGroup, deriveFontFaceCss, familiesInRawCss, findComponentReferrers, hasElementMarkerDeep, interpolate, isAssetGroupRef, isAssetRef, isBoolMarker, isColorExpression, isComponentRef, isCompositeRef, isElementLikeValue, isElementMarker, isLayerMarker, isLinearGradientExpr, isMixExpr, isModeRef, isMotionMarker, isNumberMarker, isPlaceable, isPreviewAxisMarker, isRadialGradientExpr, isSafeClassNameValue, isSlotMarker, isStringMarker, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, isVariantArrayMarker, isVariantMarker, linearGradient, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveFontStack, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, string, styleProp, tag, token, tokenGroup, variant };

package/dist/index.js

@@ -21,6 +21,7 @@ import { Token } from "./Token.js";
 import { TokenGroup } from "./TokenGroup.js";
 import { Config, parseRegistryKey } from "./Config.js";
 import { findComponentReferrers } from "./component-referrers.js";
+import { ConfigValidationError } from "./config-diagnostics.js";
 import { defineProvider } from "./defineProvider.js";
 import { asChild, boolean, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineStyleProp, defineTokenGroup, motion, number, slot, string, variant } from "./factories.js";
 import { collectFontFaceCss, deriveFontFaceCss, familiesInRawCss } from "./font-face.js";
@@ -30,4 +31,4 @@ import { resolveRegistryDir } from "./registry-dir.js";
 import { buildModeBackedModifierLookup, buildNestedModifierUpdate, createModeBackedModifierLookup, mergeModifierUpdates, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, overrideRowsToModifierTree, resolveOverrideRowValue } from "./token-override-rows.js";
 import { CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS } from "./types/css-property-keywords.js";
 import { rem } from "./units.js";
-export { ASSET_CLASS_CAPABILITIES, AssetGroup, CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, Component, ComponentGroup, CompositeStyle, Config, CssMotionDef, ELEMENT_MARKER_KIND, JsMotionDef, Layer, MOTION_CSS_DEFINITION_KEYS, MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DEFINITION_KEYS, MOTION_JS_DRAG_AXES, MOTION_JS_FIELD_KEYS, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS, Mode, ModeOption, Modifier, PREVIEW_SEED_KEY, Provider, SOURCE_PATH_KEY, StyleProp, Token, TokenGroup, alpha, asChild, asset, assetGroup, attachSourcePath, boolean, buildModeBackedModifierLookup, buildNestedModifierUpdate, captureCallerPath, collectFontFaceCss, component, composite, createModeBackedModifierLookup, cssClassName, cssDeclaration, cssSelector, cssVar, defineAssetGroup, defineAssetIcon, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineProvider, defineStyleProp, defineTokenGroup, deriveFontFaceCss, familiesInRawCss, findComponentReferrers, hasElementMarkerDeep, interpolate, isAssetGroupRef, isAssetRef, isBoolMarker, isColorExpression, isComponentRef, isCompositeRef, isElementLikeValue, isElementMarker, isLayerMarker, isLinearGradientExpr, isMixExpr, isModeRef, isMotionMarker, isNumberMarker, isPlaceable, isPreviewAxisMarker, isRadialGradientExpr, isSafeClassNameValue, isSlotMarker, isStringMarker, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, isVariantArrayMarker, isVariantMarker, linearGradient, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveFontStack, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, string, styleProp, tag, token, tokenGroup, variant };
+export { ASSET_CLASS_CAPABILITIES, AssetGroup, CSS_GLOBAL_KEYWORDS, CSS_PROPERTY_KEYWORDS, Component, ComponentGroup, CompositeStyle, Config, ConfigValidationError, CssMotionDef, ELEMENT_MARKER_KIND, JsMotionDef, Layer, MOTION_CSS_DEFINITION_KEYS, MOTION_CSS_DIRECTIONS, MOTION_CSS_FILL_MODES, MOTION_CSS_PLAY_STATES, MOTION_CSS_PROPERTY_PREFIXES, MOTION_JS_DEFINITION_KEYS, MOTION_JS_DRAG_AXES, MOTION_JS_FIELD_KEYS, MOTION_JS_LAYOUT_MODES, MOTION_JS_REPEAT_TYPES, MOTION_JS_SPRING_FIELDS, MOTION_JS_TRANSITION_TYPES, MOTION_JS_TWEEN_FIELDS, Mode, ModeOption, Modifier, PREVIEW_SEED_KEY, Provider, SOURCE_PATH_KEY, StyleProp, Token, TokenGroup, alpha, asChild, asset, assetGroup, attachSourcePath, boolean, buildModeBackedModifierLookup, buildNestedModifierUpdate, captureCallerPath, collectFontFaceCss, component, composite, createModeBackedModifierLookup, cssClassName, cssDeclaration, cssSelector, cssVar, defineAssetGroup, defineAssetIcon, defineComponent, defineComponentGroup, defineCompositeStyle, defineMode, defineModifier, defineMotion, defineProvider, defineStyleProp, defineTokenGroup, deriveFontFaceCss, familiesInRawCss, findComponentReferrers, hasElementMarkerDeep, interpolate, isAssetGroupRef, isAssetRef, isBoolMarker, isColorExpression, isComponentRef, isCompositeRef, isElementLikeValue, isElementMarker, isLayerMarker, isLinearGradientExpr, isMixExpr, isModeRef, isMotionMarker, isNumberMarker, isPlaceable, isPreviewAxisMarker, isRadialGradientExpr, isSafeClassNameValue, isSlotMarker, isStringMarker, isStylePropRef, isTagRef, isTokenGroupRef, isTokenRef, isVariantArrayMarker, isVariantMarker, linearGradient, makeTokenRefToCss, matchesPreviewWhen, mergeModifierUpdates, mix, mode, modifierIdToPath, modifierPathToId, modifierTreeToOverrideRows, motion, number, overrideRowsToModifierTree, parseRegistryKey, radialGradient, readSourcePath, rem, resolveAssetRefCss, resolveColorExpression, resolveFontStack, resolveOverrideRowValue, resolvePreviewRules, resolveRegistryDir, reviveElementMarkersDeep, serializeElementsDeep, slot, string, styleProp, tag, token, tokenGroup, variant };

package/dist/native/NativeConfig.d.ts

@@ -0,0 +1,31 @@
+import { ModeDefinition } from "../types.js";
+import { ConfigValidationError } from "../config-diagnostics.js";
+import { NativeAssetGroupDefinition, NativeFontAssetGroupDefinition, NativeTokenGroupDefinition, SerializedNativeConfig } from "./types.js";
+import { NativeConfigDiagnostic } from "./validation.js";
+
+//#region src/native/NativeConfig.d.ts
+declare class NativeConfigValidationError extends ConfigValidationError<NativeConfigDiagnostic> {
+  constructor(diagnostics: readonly NativeConfigDiagnostic[]);
+}
+declare class NativeConfig {
+  #private;
+  static readonly SCHEMA_VERSION = 1;
+  readonly platform: "native";
+  namespace?: string;
+  readonly modes: Map<string, ModeDefinition>;
+  readonly tokenGroups: Map<string, NativeTokenGroupDefinition>;
+  readonly assetGroups: Map<string, NativeFontAssetGroupDefinition>;
+  configure(options: {
+    namespace?: string;
+  }): this;
+  registerModes(modes: Record<string, ModeDefinition>): this;
+  registerTokenGroups(groups: Record<string, NativeTokenGroupDefinition>): this;
+  registerAssetGroups(groups: Record<string, NativeAssetGroupDefinition>): this;
+  validate(): NativeConfigDiagnostic[];
+  toJSON(meta?: {
+    builtAt?: string;
+  }): SerializedNativeConfig;
+  static fromJSON(input: unknown): NativeConfig;
+}
+//#endregion
+export { NativeConfig, NativeConfigValidationError };

package/dist/native/NativeConfig.js

@@ -0,0 +1,75 @@
+import { ConfigValidationError } from "../config-diagnostics.js";
+import { validateSerializedNativeConfig } from "./validation.js";
+//#region src/native/NativeConfig.ts
+var NativeConfigValidationError = class extends ConfigValidationError {
+	constructor(diagnostics) {
+		super(diagnostics, "Invalid native config");
+		this.name = "NativeConfigValidationError";
+	}
+};
+var NativeConfig = class NativeConfig {
+	static SCHEMA_VERSION = 1;
+	platform = "native";
+	namespace;
+	modes = /* @__PURE__ */ new Map();
+	tokenGroups = /* @__PURE__ */ new Map();
+	assetGroups = /* @__PURE__ */ new Map();
+	configure(options) {
+		if (options.namespace !== void 0) {
+			const diagnostics = validateSerializedNativeConfig({
+				schemaVersion: NativeConfig.SCHEMA_VERSION,
+				platform: "native",
+				namespace: options.namespace
+			});
+			if (diagnostics.length > 0) throw new NativeConfigValidationError(diagnostics);
+			this.namespace = options.namespace;
+		}
+		return this;
+	}
+	registerModes(modes) {
+		for (const [name, definition] of Object.entries(modes)) this.modes.set(name, definition);
+		return this;
+	}
+	registerTokenGroups(groups) {
+		for (const [name, definition] of Object.entries(groups)) this.tokenGroups.set(name, definition);
+		return this;
+	}
+	registerAssetGroups(groups) {
+		for (const [name, definition] of Object.entries(groups)) this.assetGroups.set(name, definition);
+		return this;
+	}
+	validate() {
+		return validateSerializedNativeConfig(this.#serialize());
+	}
+	toJSON(meta) {
+		const out = this.#serialize(meta);
+		const diagnostics = validateSerializedNativeConfig(out);
+		if (diagnostics.length > 0) throw new NativeConfigValidationError(diagnostics);
+		return out;
+	}
+	static fromJSON(input) {
+		const diagnostics = validateSerializedNativeConfig(input, NativeConfig.SCHEMA_VERSION);
+		if (diagnostics.length > 0) throw new NativeConfigValidationError(diagnostics);
+		const json = input;
+		const config = new NativeConfig();
+		config.namespace = json.namespace;
+		for (const [name, mode] of Object.entries(json.modes ?? {})) config.modes.set(name, mode);
+		for (const [name, group] of Object.entries(json.tokenGroups ?? {})) config.tokenGroups.set(name, group);
+		for (const [name, group] of Object.entries(json.assetGroups ?? {})) config.assetGroups.set(name, group);
+		return config;
+	}
+	#serialize(meta) {
+		const out = {
+			schemaVersion: NativeConfig.SCHEMA_VERSION,
+			platform: "native"
+		};
+		if (meta?.builtAt !== void 0) out.builtAt = meta.builtAt;
+		if (this.namespace !== void 0) out.namespace = this.namespace;
+		if (this.modes.size > 0) out.modes = Object.fromEntries(this.modes);
+		if (this.tokenGroups.size > 0) out.tokenGroups = Object.fromEntries(this.tokenGroups);
+		if (this.assetGroups.size > 0) out.assetGroups = Object.fromEntries(this.assetGroups);
+		return out;
+	}
+};
+//#endregion
+export { NativeConfig, NativeConfigValidationError };

package/dist/native/assets.d.ts

@@ -0,0 +1,20 @@
+import { NativeFontAssetGroupDefinition, NativeFontAssetMember } from "./types.js";
+
+//#region src/native/assets.d.ts
+interface NativeFontAssetGroupConfig {
+  readonly type: 'font';
+  readonly label?: string;
+  readonly description?: string;
+}
+interface NativeAssetGroupBuilder<T extends Record<string, NativeFontAssetMember>> {
+  config(config: NativeFontAssetGroupConfig): NativeFontAssetGroupDefinition & {
+    members: T;
+  };
+}
+/**
+ * Native counterpart to the web asset-group factory. The registration and ref
+ * model are shared; only the platform member payload differs.
+ */
+declare function defineAssetGroup<const T extends Record<string, NativeFontAssetMember>>(members: T): NativeAssetGroupBuilder<T>;
+//#endregion
+export { NativeAssetGroupBuilder, NativeFontAssetGroupConfig, defineAssetGroup };

package/dist/native/assets.js

@@ -0,0 +1,17 @@
+//#region src/native/assets.ts
+/**
+* Native counterpart to the web asset-group factory. The registration and ref
+* model are shared; only the platform member payload differs.
+*/
+function defineAssetGroup(members) {
+	return { config(config) {
+		return {
+			assetKind: "font",
+			members,
+			...config.label !== void 0 ? { label: config.label } : {},
+			...config.description !== void 0 ? { description: config.description } : {}
+		};
+	} };
+}
+//#endregion
+export { defineAssetGroup };

package/dist/native/index.d.ts

@@ -0,0 +1,16 @@
+import { AssetRef, TokenRef, asset, token } from "../refs.js";
+import { ColorSpace, MixExpr, alpha, mix } from "../colorExpressions.js";
+import { ModeDefinition, SystemLink, TokenType } from "../types.js";
+import { DefinedTokenGroupValue, defineMode } from "../factories.js";
+import { NativeAssetGroupDefinition, NativeColorExpression, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeSelectableValue, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig } from "./types.js";
+import { NativeAssetGroupBuilder, NativeFontAssetGroupConfig, defineAssetGroup } from "./assets.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

@@ -0,0 +1,15 @@
+import "../refs.js";
+import "../colorExpressions.js";
+import { defineTokenGroupValue } from "../factories.js";
+import "./assets.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/types.d.ts

@@ -0,0 +1,51 @@
+import { AssetRef, TokenRef } from "../refs.js";
+import { MixExpr } from "../colorExpressions.js";
+import { ModeDefinition, TokenDefinitionFor, TokenGroupDefinitionFor } from "../types.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 NativeFontAssetMember {
+  /** Font-family value React Native consumes after the font is installed. */
+  postscriptName: 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;
+  modes?: Record<string, ModeDefinition>;
+  tokenGroups?: Record<string, NativeTokenGroupDefinition>;
+  assetGroups?: Record<string, NativeAssetGroupDefinition>;
+}
+//#endregion
+export { NativeAssetGroupDefinition, NativeColorExpression, NativeFontAssetGroupDefinition, NativeFontAssetMember, NativeLiteral, NativeSelectableValue, NativeTokenDefinition, NativeTokenGroupDefinition, NativeTokenValue, OperatingSystemInput, OperatingSystemValue, SerializedNativeConfig };

package/dist/native/validation.d.ts

@@ -0,0 +1,8 @@
+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' | 'UNSUPPORTED_COLOR_EXPRESSION';
+type NativeConfigDiagnostic = ConfigDiagnostic<NativeConfigDiagnosticCode>;
+declare function validateSerializedNativeConfig(input: unknown, expectedSchemaVersion?: number): NativeConfigDiagnostic[];
+//#endregion
+export { NativeConfigDiagnostic, NativeConfigDiagnosticCode, validateSerializedNativeConfig };