@xaui/native 0.9.1-alpha.0 → 0.9.1-alpha.2

package/dist/system/index.d.ts

@@ -0,0 +1,174 @@
+import { g as XAUITheme, X as XAUIColors } from '../theme.type-B3ODSLbB.js';
+import { ViewStyle, TextStyle } from 'react-native';
+import * as react from 'react';
+import { ReactNode, Provider, Ref, RefCallback } from 'react';
+
+/**
+ * A slot is a view or a text node, and a recipe writes one object per slot, so the two
+ * RN style shapes are merged rather than discriminated per slot.
+ */
+type SlotStyle = ViewStyle & TextStyle;
+type SlotStyles<Slot extends string> = Partial<Record<Slot, SlotStyle>>;
+/** The roles a variant consumes. The variant names tokens; `paint` says where they land. */
+type VariantRole = 'bg' | 'bgPressed' | 'fg' | 'border';
+/** Token names per role — no colour value ever appears in a recipe. */
+type VariantTokens = Partial<Record<VariantRole, keyof XAUIColors>>;
+/** The same roles resolved: theme colours, or the slices of a raw `color`. */
+type VariantColors = Partial<Record<VariantRole, string>>;
+/**
+ * `disabled` is applied last of the three: a control that is both pressed and disabled
+ * has to read disabled.
+ */
+type StateName = 'focused' | 'pressed' | 'disabled';
+type States = Partial<Record<StateName, boolean>>;
+/** Reads the theme and the variant's resolved colours; returns one style per slot. */
+type StyleFn<Slot extends string> = (theme: XAUITheme, colors: VariantColors) => SlotStyles<Slot>;
+/** Named axes of finite token values — `{ size: { sm: fn, md: fn } }`. */
+type Axes<Slot extends string> = Record<string, Record<string, StyleFn<Slot>>>;
+/** One value per axis, plus the variant. Missing keys fall back to `defaultVariants`. */
+type Selection<Variant extends string, A extends Axes<string>> = {
+    variant?: Variant;
+} & {
+    [Axis in keyof A]?: Extract<keyof A[Axis], string>;
+};
+type CompoundVariant<Slot extends string, Variant extends string, A extends Axes<Slot>> = {
+    when: Selection<Variant, A>;
+    style: StyleFn<Slot>;
+};
+type RecipeConfig<Slot extends string, Variant extends string, A extends Axes<Slot>> = {
+    /** Every slot the component publishes. Slots a recipe never styles resolve to `{}`. */
+    slots: readonly Slot[];
+    base?: StyleFn<Slot>;
+    variantTokens?: Record<Variant, VariantTokens>;
+    /** Where the variant's colours land — written once, and it holds for every variant. */
+    paint?: StyleFn<Slot>;
+    variants?: A;
+    compoundVariants?: ReadonlyArray<CompoundVariant<Slot, Variant, A>>;
+    states?: Partial<Record<StateName, StyleFn<Slot>>>;
+    defaultVariants?: Selection<Variant, A>;
+};
+/** Stable references: the same object for the same tokens, for the app's lifetime. */
+type ResolvedStyles<Slot extends string> = Readonly<Record<Slot, SlotStyle>>;
+/** A selection with `defaultVariants` already folded in, keyed by axis name. */
+type ResolvedSelection = Readonly<Record<string, string | undefined>>;
+
+type ResolveArgs<Variant extends string, A extends Axes<string>> = {
+    theme: XAUITheme;
+    selection?: Selection<Variant, A>;
+    states?: States;
+};
+type TintArgs<Variant extends string, A extends Axes<string>> = ResolveArgs<Variant, A> & {
+    color: string;
+};
+type Recipe<Slot extends string, Variant extends string, A extends Axes<Slot>> = {
+    readonly slots: readonly Slot[];
+    /** The cached pass: stable `StyleSheet` references, keyed by tokens alone. */
+    resolve(args: ResolveArgs<Variant, A>): ResolvedStyles<Slot>;
+    /**
+     * The tint pass: the same functions run again with `color`'s slices in place of the
+     * theme's tokens. Uncached and allocating, and only ever called when `color` is set.
+     */
+    tint(args: TintArgs<Variant, A>): SlotStyles<Slot>;
+};
+/**
+ * A component's style, declared once. Resolution splits in two because the two halves
+ * have different lifetimes: everything keyed by a finite token is cached forever, and
+ * an arbitrary `color` is recomputed per render — which is what keeps the cache bounded
+ * by the number of token combinations rather than by the palette users invent.
+ *
+ *     const styles = buttonRecipe.resolve({ theme, selection: { variant, size }, states })
+ *     const tint = color ? buttonRecipe.tint({ theme, color, selection, states }) : undefined
+ *     <View style={[styles.root, tint?.root, style]} />
+ */
+declare function createRecipe<Slot extends string, Variant extends string, const A extends Axes<Slot>>(config: RecipeConfig<Slot, Variant, A>): Recipe<Slot, Variant, A>;
+
+/**
+ * R3: the string a root should wrap in its default text slot, or `null` when it should
+ * render its children as they are.
+ *
+ * The whole tree is stringified recursively rather than the first child inspected. That
+ * is what makes `<Button>{count} items</Button>` work — children there are the array
+ * `[3, ' items']`, and an `isValidElement` check on the first entry would call it an
+ * element-free tree only by accident, while a check for "is the first child a string"
+ * would miss it outright.
+ *
+ * `null` for an empty result as much as for a tree containing an element: in both cases
+ * there is nothing to wrap, and a root's fallback — render the children — is right for
+ * both. It also keeps `<Button>{false}</Button>` from mounting an empty text node.
+ */
+declare function childrenToString(children: ReactNode): string | null;
+
+/**
+ * A context a slot cannot read by accident. Every compound gets one, and it carries
+ * **resolved** values — style references the root already computed, not tokens for the
+ * slot to resolve again (R5).
+ *
+ * ```ts
+ * const [ButtonProvider, useButton] = createSlotContext<ButtonContext>('Button')
+ * ```
+ *
+ * The tuple is what lets each compound name its own hook, which R10 requires it to
+ * export. `name` gives both halves of the error, so there is one place to spell it.
+ */
+declare function createSlotContext<T>(name: string): readonly [Provider<T | null>, () => T];
+
+/** Anything React accepts as a ref, plus the absence of one. */
+type PossibleRef<T> = Ref<T> | undefined;
+/**
+ * The props `mergeProps` knows how to combine. Deliberately loose: it merges whatever a
+ * root hands to whatever child it was given, and neither side is knowable from here.
+ */
+type MergeableProps = Record<string, unknown>;
+type AsChildProps = {
+    /**
+     * Merge this component's props into its single child instead of rendering an element
+     * of its own — a navigation `Link` as a `Button`, a bespoke trigger as a `Select`.
+     */
+    asChild?: boolean;
+};
+
+/**
+ * Merges a root's own props into the child it renders through `asChild` (R12). Four
+ * rules, and the child wins wherever they do not apply — it is the more specific intent:
+ *
+ * - **Event handlers compose.** Both run, ours first: the component's own behaviour (the
+ *   press state that drives its styles) happens before the child's side effect (the
+ *   navigation). Replacing one with the other is the bug this exists to prevent.
+ * - **Styles stack**, ours under the child's, so the child can override.
+ * - **`ref`s merge** through `mergeRefs`. React 19 passes `ref` as an ordinary prop, so
+ *   it arrives here rather than beside the props, and dropping it would sever the root's
+ *   handle on the node.
+ * - **Everything else: the child's value wins**, and ours fills in what it left unset.
+ */
+declare function mergeProps(ours: MergeableProps, theirs: MergeableProps): MergeableProps;
+
+/**
+ * One callback that feeds several refs — what lets a root keep its own handle on a node
+ * while still honouring the ref its caller passed (R9), and what `asChild` needs to
+ * forward a ref into the child it merges into (R12).
+ *
+ * It returns nothing on purpose. React 19 reads a ref callback's return value as a
+ * cleanup function while React 18 ignores it, and this package supports both; letting
+ * a merged cleanup through would behave differently on each. React calls every ref with
+ * `null` on unmount anyway, which this forwards.
+ */
+declare function mergeRefs<T>(...refs: Array<PossibleRef<T>>): RefCallback<T>;
+
+type SlotProps = MergeableProps & {
+    children?: ReactNode;
+};
+/**
+ * The render branch behind `asChild` (R12). A root picks it instead of its own element:
+ *
+ * ```tsx
+ * const Root = asChild ? Slot : Pressable
+ * return <Root ref={ref} {...rootProps}>{children}</Root>
+ * ```
+ *
+ * One line per root, which is the point — forty-seven roots each hand-rolling a
+ * `cloneElement` and a ref merge would drift, and R12 has to hold uniformly from the
+ * first component or the ref signature of the whole core changes later.
+ */
+declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
+
+export { type AsChildProps, type Axes, type CompoundVariant, type MergeableProps, type PossibleRef, type Recipe, type RecipeConfig, type ResolveArgs, type ResolvedSelection, type ResolvedStyles, type Selection, Slot, type SlotProps, type SlotStyle, type SlotStyles, type StateName, type States, type StyleFn, type TintArgs, type VariantColors, type VariantRole, type VariantTokens, childrenToString, createRecipe, createSlotContext, mergeProps, mergeRefs };

package/dist/system/index.js

@@ -0,0 +1,17 @@
+import {
+  Slot,
+  childrenToString,
+  createRecipe,
+  createSlotContext,
+  mergeProps,
+  mergeRefs
+} from "../chunk-RCP3SD26.js";
+import "../chunk-RBNCR5KB.js";
+export {
+  Slot,
+  childrenToString,
+  createRecipe,
+  createSlotContext,
+  mergeProps,
+  mergeRefs
+};

package/dist/theme/index.cjs

@@ -13,9 +13,10 @@
 
 
 
-var _chunkJDS6KGCMcjs = require('../chunk-JDS6KGCM.cjs');
+var _chunkNHPQQQ7Pcjs = require('../chunk-NHPQQQ7P.cjs');
 
 
+var _chunkM7P46XKIcjs = require('../chunk-M7P46XKI.cjs');
 
 
 
@@ -29,4 +30,7 @@ var _chunkJDS6KGCMcjs = require('../chunk-JDS6KGCM.cjs');
 
 
 
-exports.ThemeContext = _chunkJDS6KGCMcjs.ThemeContext; exports.XAUIProvider = _chunkJDS6KGCMcjs.XAUIProvider; exports.buildRadius = _chunkJDS6KGCMcjs.buildRadius; exports.buildShadows = _chunkJDS6KGCMcjs.buildShadows; exports.createTheme = _chunkJDS6KGCMcjs.createTheme; exports.defaultTheme = _chunkJDS6KGCMcjs.defaultTheme; exports.deriveColors = _chunkJDS6KGCMcjs.deriveColors; exports.palette = _chunkJDS6KGCMcjs.palette; exports.primitives = _chunkJDS6KGCMcjs.primitives; exports.sourceKeys = _chunkJDS6KGCMcjs.sourceKeys; exports.tokens = _chunkJDS6KGCMcjs.tokens; exports.useColorMode = _chunkJDS6KGCMcjs.useColorMode; exports.useThemeColor = _chunkJDS6KGCMcjs.useThemeColor; exports.useXAUITheme = _chunkJDS6KGCMcjs.useXAUITheme;
+
+
+
+exports.ThemeContext = _chunkNHPQQQ7Pcjs.ThemeContext; exports.XAUIProvider = _chunkNHPQQQ7Pcjs.XAUIProvider; exports.buildRadius = _chunkNHPQQQ7Pcjs.buildRadius; exports.buildShadows = _chunkNHPQQQ7Pcjs.buildShadows; exports.createTheme = _chunkNHPQQQ7Pcjs.createTheme; exports.defaultTheme = _chunkNHPQQQ7Pcjs.defaultTheme; exports.deriveColors = _chunkNHPQQQ7Pcjs.deriveColors; exports.deriveTint = _chunkM7P46XKIcjs.deriveTint; exports.palette = _chunkNHPQQQ7Pcjs.palette; exports.primitives = _chunkNHPQQQ7Pcjs.primitives; exports.sourceKeys = _chunkNHPQQQ7Pcjs.sourceKeys; exports.tokens = _chunkNHPQQQ7Pcjs.tokens; exports.useColorMode = _chunkNHPQQQ7Pcjs.useColorMode; exports.useThemeColor = _chunkNHPQQQ7Pcjs.useThemeColor; exports.useXAUITheme = _chunkNHPQQQ7Pcjs.useXAUITheme;

package/dist/theme/index.d.cts

@@ -1,157 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-
-/** The source layer — the only surface a consumer writes by hand, per mode. */
-type XAUISourceColors = {
-    background: string;
-    foreground: string;
-    surface: string;
-    surfaceForeground: string;
-    surfaceSecondary: string;
-    surfaceSecondaryForeground: string;
-    surfaceTertiary: string;
-    surfaceTertiaryForeground: string;
-    overlay: string;
-    overlayForeground: string;
-    backdrop: string;
-    muted: string;
-    default: string;
-    defaultForeground: string;
-    accent: string;
-    accentForeground: string;
-    fieldBackground: string;
-    fieldForeground: string;
-    fieldPlaceholder: string;
-    fieldBorder: string;
-    success: string;
-    successForeground: string;
-    warning: string;
-    warningForeground: string;
-    danger: string;
-    dangerForeground: string;
-    segment: string;
-    segmentForeground: string;
-    border: string;
-    separator: string;
-    focus: string;
-    link: string;
-};
-/** The derived layer — computed by `deriveColors`, never written by hand. */
-type XAUIDerivedColors = {
-    accentPressed: string;
-    successPressed: string;
-    warningPressed: string;
-    dangerPressed: string;
-    defaultPressed: string;
-    surfacePressed: string;
-    defaultSoft: string;
-    defaultSoftForeground: string;
-    defaultSoftPressed: string;
-    accentSoft: string;
-    accentSoftForeground: string;
-    accentSoftPressed: string;
-    successSoft: string;
-    successSoftForeground: string;
-    successSoftPressed: string;
-    warningSoft: string;
-    warningSoftForeground: string;
-    warningSoftPressed: string;
-    dangerSoft: string;
-    dangerSoftForeground: string;
-    dangerSoftPressed: string;
-    backgroundSecondary: string;
-    backgroundTertiary: string;
-    backgroundInverse: string;
-    borderSecondary: string;
-    borderTertiary: string;
-    separatorSecondary: string;
-    separatorTertiary: string;
-    fieldPressed: string;
-    fieldFocus: string;
-    fieldBorderPressed: string;
-    fieldBorderFocus: string;
-};
-/** Constant across both modes. */
-type XAUIPrimitiveColors = {
-    white: string;
-    black: string;
-    snow: string;
-    eclipse: string;
-};
-/** Everything a component reads, flattened. */
-type XAUIColors = XAUISourceColors & XAUIDerivedColors & XAUIPrimitiveColors;
-type ColorMode = 'light' | 'dark';
-type Size = 'xs' | 'sm' | 'md' | 'lg';
-type RadiusKey = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | 'field' | 'full';
-type FontSizeKey = Size | 'xl' | '2xl' | '3xl' | '4xl';
-type FontWeightKey = 'regular' | 'medium' | 'semibold' | 'bold';
-type XAUIRadius = Record<RadiusKey, number>;
-type XAUIShadow = {
-    shadowColor: string;
-    shadowOffset: {
-        width: number;
-        height: number;
-    };
-    shadowOpacity: number;
-    shadowRadius: number;
-    elevation: number;
-};
-type XAUITheme = {
-    id: string;
-    mode: ColorMode;
-    colors: XAUIColors;
-    /** Base 4 — `spacing(3) === 12`. A function, so there is no "what do we call 12px". */
-    spacing: (steps: number) => number;
-    radius: XAUIRadius;
-    borderWidth: {
-        default: number;
-        field: number;
-    };
-    fontSizes: Record<FontSizeKey, number>;
-    lineHeights: Record<FontSizeKey, number>;
-    fontWeights: Record<FontWeightKey, string>;
-    fontFamilies: {
-        body: string;
-        heading: string;
-        mono: string;
-    };
-    /** Semantic roles, not a scale: dark mode drops the surface shadow entirely. */
-    shadows: {
-        surface: XAUIShadow;
-        overlay: XAUIShadow;
-        field: XAUIShadow;
-    };
-    opacity: {
-        disabled: number;
-    };
-    controlHeights: Record<Size, number>;
-};
-type XAUIThemeConfig = {
-    colors?: {
-        light?: Partial<XAUISourceColors & XAUIDerivedColors>;
-        dark?: Partial<XAUISourceColors & XAUIDerivedColors>;
-    };
-    /** The single base the whole radius scale derives from. */
-    radius?: number;
-    spacingUnit?: number;
-    borderWidth?: Partial<XAUITheme['borderWidth']>;
-    fontSizes?: Partial<XAUITheme['fontSizes']>;
-    lineHeights?: Partial<XAUITheme['lineHeights']>;
-    fontWeights?: Partial<XAUITheme['fontWeights']>;
-    fontFamilies?: Partial<XAUITheme['fontFamilies']>;
-    /** Per role, and `shadowOffset` is replaced whole — a half-set offset is not a shadow. */
-    shadows?: {
-        [K in keyof XAUITheme['shadows']]?: Partial<XAUIShadow>;
-    };
-    opacity?: Partial<XAUITheme['opacity']>;
-    controlHeights?: Partial<XAUITheme['controlHeights']>;
-};
-/** What `createTheme` returns: both modes, resolved, sharing one id. */
-type XAUIThemeSet = {
-    id: string;
-    light: XAUITheme;
-    dark: XAUITheme;
-};
+import { i as XAUIThemeSet, h as XAUIThemeConfig, f as XAUISourceColors, b as XAUIDerivedColors, g as XAUITheme, d as XAUIRadius, C as ColorMode, X as XAUIColors } from '../theme.type-B3ODSLbB.cjs';
+export { F as FontSizeKey, a as FontWeightKey, R as RadiusKey, S as Size, c as XAUIPrimitiveColors, e as XAUIShadow } from '../theme.type-B3ODSLbB.cjs';
 
 /** `'system'` follows the device; the resolved value is never `'system'`. */
 type ColorModePreference = 'light' | 'dark' | 'system';
@@ -196,6 +46,26 @@ declare const defaultTheme: XAUIThemeSet;
  */
 declare function deriveColors(s: XAUISourceColors): XAUIDerivedColors;
 
+/**
+ * A raw tint, expanded into the slices a variant consumes. One `color` gives the base;
+ * the other five come out of the same OKLab formulas as `deriveColors`, so a free tint
+ * behaves exactly like `accent` or `danger` — same ratios, same rendering — instead of
+ * following a parallel mechanic.
+ */
+type XAUITint = {
+    base: string;
+    foreground: string;
+    soft: string;
+    softForeground: string;
+    pressed: string;
+    softPressed: string;
+};
+/**
+ * Memoized per tint *and* theme: sRGB → OKLab → sRGB is not free per render, and
+ * `softForeground` mixes with the theme's `foreground`, which differs between modes.
+ */
+declare function deriveTint(tint: string, theme: XAUITheme): XAUITint;
+
 /**
  * The raw palette — Tailwind's scale, 22 families x 11 shades.
  *
@@ -666,4 +536,4 @@ declare function useColorMode(): ColorMode;
 declare function useThemeColor(token: keyof XAUIColors): string;
 declare function useThemeColor(tokens: Array<keyof XAUIColors>): string[];
 
-export { type ColorMode, type ColorModePreference, type FontSizeKey, type FontWeightKey, type PaletteFamily, type PaletteShade, type RadiusKey, type Size, ThemeContext, type XAUIColors, type XAUIDerivedColors, type XAUIPrimitiveColors, XAUIProvider, type XAUIProviderProps, type XAUIRadius, type XAUIShadow, type XAUISourceColors, type XAUITheme, type XAUIThemeConfig, type XAUIThemeSet, buildRadius, buildShadows, createTheme, defaultTheme, deriveColors, palette, primitives, sourceKeys, tokens, useColorMode, useThemeColor, useXAUITheme };
+export { ColorMode, type ColorModePreference, type PaletteFamily, type PaletteShade, ThemeContext, XAUIColors, XAUIDerivedColors, XAUIProvider, type XAUIProviderProps, XAUIRadius, XAUISourceColors, XAUITheme, XAUIThemeConfig, XAUIThemeSet, type XAUITint, buildRadius, buildShadows, createTheme, defaultTheme, deriveColors, deriveTint, palette, primitives, sourceKeys, tokens, useColorMode, useThemeColor, useXAUITheme };

package/dist/theme/index.d.ts

@@ -1,157 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-
-/** The source layer — the only surface a consumer writes by hand, per mode. */
-type XAUISourceColors = {
-    background: string;
-    foreground: string;
-    surface: string;
-    surfaceForeground: string;
-    surfaceSecondary: string;
-    surfaceSecondaryForeground: string;
-    surfaceTertiary: string;
-    surfaceTertiaryForeground: string;
-    overlay: string;
-    overlayForeground: string;
-    backdrop: string;
-    muted: string;
-    default: string;
-    defaultForeground: string;
-    accent: string;
-    accentForeground: string;
-    fieldBackground: string;
-    fieldForeground: string;
-    fieldPlaceholder: string;
-    fieldBorder: string;
-    success: string;
-    successForeground: string;
-    warning: string;
-    warningForeground: string;
-    danger: string;
-    dangerForeground: string;
-    segment: string;
-    segmentForeground: string;
-    border: string;
-    separator: string;
-    focus: string;
-    link: string;
-};
-/** The derived layer — computed by `deriveColors`, never written by hand. */
-type XAUIDerivedColors = {
-    accentPressed: string;
-    successPressed: string;
-    warningPressed: string;
-    dangerPressed: string;
-    defaultPressed: string;
-    surfacePressed: string;
-    defaultSoft: string;
-    defaultSoftForeground: string;
-    defaultSoftPressed: string;
-    accentSoft: string;
-    accentSoftForeground: string;
-    accentSoftPressed: string;
-    successSoft: string;
-    successSoftForeground: string;
-    successSoftPressed: string;
-    warningSoft: string;
-    warningSoftForeground: string;
-    warningSoftPressed: string;
-    dangerSoft: string;
-    dangerSoftForeground: string;
-    dangerSoftPressed: string;
-    backgroundSecondary: string;
-    backgroundTertiary: string;
-    backgroundInverse: string;
-    borderSecondary: string;
-    borderTertiary: string;
-    separatorSecondary: string;
-    separatorTertiary: string;
-    fieldPressed: string;
-    fieldFocus: string;
-    fieldBorderPressed: string;
-    fieldBorderFocus: string;
-};
-/** Constant across both modes. */
-type XAUIPrimitiveColors = {
-    white: string;
-    black: string;
-    snow: string;
-    eclipse: string;
-};
-/** Everything a component reads, flattened. */
-type XAUIColors = XAUISourceColors & XAUIDerivedColors & XAUIPrimitiveColors;
-type ColorMode = 'light' | 'dark';
-type Size = 'xs' | 'sm' | 'md' | 'lg';
-type RadiusKey = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | 'field' | 'full';
-type FontSizeKey = Size | 'xl' | '2xl' | '3xl' | '4xl';
-type FontWeightKey = 'regular' | 'medium' | 'semibold' | 'bold';
-type XAUIRadius = Record<RadiusKey, number>;
-type XAUIShadow = {
-    shadowColor: string;
-    shadowOffset: {
-        width: number;
-        height: number;
-    };
-    shadowOpacity: number;
-    shadowRadius: number;
-    elevation: number;
-};
-type XAUITheme = {
-    id: string;
-    mode: ColorMode;
-    colors: XAUIColors;
-    /** Base 4 — `spacing(3) === 12`. A function, so there is no "what do we call 12px". */
-    spacing: (steps: number) => number;
-    radius: XAUIRadius;
-    borderWidth: {
-        default: number;
-        field: number;
-    };
-    fontSizes: Record<FontSizeKey, number>;
-    lineHeights: Record<FontSizeKey, number>;
-    fontWeights: Record<FontWeightKey, string>;
-    fontFamilies: {
-        body: string;
-        heading: string;
-        mono: string;
-    };
-    /** Semantic roles, not a scale: dark mode drops the surface shadow entirely. */
-    shadows: {
-        surface: XAUIShadow;
-        overlay: XAUIShadow;
-        field: XAUIShadow;
-    };
-    opacity: {
-        disabled: number;
-    };
-    controlHeights: Record<Size, number>;
-};
-type XAUIThemeConfig = {
-    colors?: {
-        light?: Partial<XAUISourceColors & XAUIDerivedColors>;
-        dark?: Partial<XAUISourceColors & XAUIDerivedColors>;
-    };
-    /** The single base the whole radius scale derives from. */
-    radius?: number;
-    spacingUnit?: number;
-    borderWidth?: Partial<XAUITheme['borderWidth']>;
-    fontSizes?: Partial<XAUITheme['fontSizes']>;
-    lineHeights?: Partial<XAUITheme['lineHeights']>;
-    fontWeights?: Partial<XAUITheme['fontWeights']>;
-    fontFamilies?: Partial<XAUITheme['fontFamilies']>;
-    /** Per role, and `shadowOffset` is replaced whole — a half-set offset is not a shadow. */
-    shadows?: {
-        [K in keyof XAUITheme['shadows']]?: Partial<XAUIShadow>;
-    };
-    opacity?: Partial<XAUITheme['opacity']>;
-    controlHeights?: Partial<XAUITheme['controlHeights']>;
-};
-/** What `createTheme` returns: both modes, resolved, sharing one id. */
-type XAUIThemeSet = {
-    id: string;
-    light: XAUITheme;
-    dark: XAUITheme;
-};
+import { i as XAUIThemeSet, h as XAUIThemeConfig, f as XAUISourceColors, b as XAUIDerivedColors, g as XAUITheme, d as XAUIRadius, C as ColorMode, X as XAUIColors } from '../theme.type-B3ODSLbB.js';
+export { F as FontSizeKey, a as FontWeightKey, R as RadiusKey, S as Size, c as XAUIPrimitiveColors, e as XAUIShadow } from '../theme.type-B3ODSLbB.js';
 
 /** `'system'` follows the device; the resolved value is never `'system'`. */
 type ColorModePreference = 'light' | 'dark' | 'system';
@@ -196,6 +46,26 @@ declare const defaultTheme: XAUIThemeSet;
  */
 declare function deriveColors(s: XAUISourceColors): XAUIDerivedColors;
 
+/**
+ * A raw tint, expanded into the slices a variant consumes. One `color` gives the base;
+ * the other five come out of the same OKLab formulas as `deriveColors`, so a free tint
+ * behaves exactly like `accent` or `danger` — same ratios, same rendering — instead of
+ * following a parallel mechanic.
+ */
+type XAUITint = {
+    base: string;
+    foreground: string;
+    soft: string;
+    softForeground: string;
+    pressed: string;
+    softPressed: string;
+};
+/**
+ * Memoized per tint *and* theme: sRGB → OKLab → sRGB is not free per render, and
+ * `softForeground` mixes with the theme's `foreground`, which differs between modes.
+ */
+declare function deriveTint(tint: string, theme: XAUITheme): XAUITint;
+
 /**
  * The raw palette — Tailwind's scale, 22 families x 11 shades.
  *
@@ -666,4 +536,4 @@ declare function useColorMode(): ColorMode;
 declare function useThemeColor(token: keyof XAUIColors): string;
 declare function useThemeColor(tokens: Array<keyof XAUIColors>): string[];
 
-export { type ColorMode, type ColorModePreference, type FontSizeKey, type FontWeightKey, type PaletteFamily, type PaletteShade, type RadiusKey, type Size, ThemeContext, type XAUIColors, type XAUIDerivedColors, type XAUIPrimitiveColors, XAUIProvider, type XAUIProviderProps, type XAUIRadius, type XAUIShadow, type XAUISourceColors, type XAUITheme, type XAUIThemeConfig, type XAUIThemeSet, buildRadius, buildShadows, createTheme, defaultTheme, deriveColors, palette, primitives, sourceKeys, tokens, useColorMode, useThemeColor, useXAUITheme };
+export { ColorMode, type ColorModePreference, type PaletteFamily, type PaletteShade, ThemeContext, XAUIColors, XAUIDerivedColors, XAUIProvider, type XAUIProviderProps, XAUIRadius, XAUISourceColors, XAUITheme, XAUIThemeConfig, XAUIThemeSet, type XAUITint, buildRadius, buildShadows, createTheme, defaultTheme, deriveColors, deriveTint, palette, primitives, sourceKeys, tokens, useColorMode, useThemeColor, useXAUITheme };

package/dist/theme/index.js

@@ -13,7 +13,10 @@ import {
   useColorMode,
   useThemeColor,
   useXAUITheme
-} from "../chunk-T3ZI2PZ6.js";
+} from "../chunk-PBVPOX7D.js";
+import {
+  deriveTint
+} from "../chunk-RBNCR5KB.js";
 export {
   ThemeContext,
   XAUIProvider,
@@ -22,6 +25,7 @@ export {
   createTheme,
   defaultTheme,
   deriveColors,
+  deriveTint,
   palette,
   primitives,
   sourceKeys,