react-native-terra-ui 0.1.0

package/lib/typescript/src/theme/tokens/light.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Light-scheme color tokens — flat, dotted-key data (no imports, no types).
+ *
+ * Convention: [category].[context].[property?].[variant].[state]
+ *   - property is omitted when the context implies it (surface → bg, text → fg, border → border-color)
+ *   - property is required when a context carries multiple attributes (action, status)
+ *
+ * Values use {palette.key} reference notation, resolved against primitives at
+ * build time via resolveRefs() in theme.ts. Raw hex is used only where no
+ * palette step matches exactly.
+ *
+ * GENERATED-STYLE SOURCE: intended to be replaced by the Figma / design-sync export.
+ */
+export declare const light: {
+    'color.background': string;
+    'color.surface.default': string;
+    'color.surface.raised': string;
+    'color.surface.sunken': string;
+    'color.surface.overlay': string;
+    'color.surface.accent': string;
+    'color.surface.accent.subtle': string;
+    'color.text.default': string;
+    'color.text.muted': string;
+    'color.text.subtle': string;
+    'color.text.disabled': string;
+    'color.text.inverse': string;
+    'color.text.link': string;
+    'color.text.accent': string;
+    'color.text.on-accent': string;
+    'color.text.on-accent-subtle': string;
+    'color.border.subtle': string;
+    'color.border.default': string;
+    'color.border.strong': string;
+    'color.border.focus': string;
+    'color.border.accent': string;
+    'color.action.bg.primary': string;
+    'color.action.bg.primary.hover': string;
+    'color.action.bg.primary.active': string;
+    'color.action.bg.primary.disabled': string;
+    'color.action.fg.primary': string;
+    'color.action.bg.subtle': string;
+    'color.action.bg.subtle.hover': string;
+    'color.action.bg.subtle.active': string;
+    'color.action.bg.subtle.disabled': string;
+    'color.action.fg.subtle': string;
+    'color.action.bg.neutral': string;
+    'color.action.bg.neutral.hover': string;
+    'color.action.bg.neutral.active': string;
+    'color.action.bg.neutral.disabled': string;
+    'color.action.fg.neutral': string;
+    'color.status.bg.success': string;
+    'color.status.bg.success.subtle': string;
+    'color.status.border.success': string;
+    'color.status.border.success.subtle': string;
+    'color.status.fg.success': string;
+    'color.status.fg.success.subtle': string;
+    'color.status.bg.warning': string;
+    'color.status.bg.warning.subtle': string;
+    'color.status.border.warning': string;
+    'color.status.border.warning.subtle': string;
+    'color.status.fg.warning': string;
+    'color.status.fg.warning.subtle': string;
+    'color.status.bg.danger': string;
+    'color.status.bg.danger.subtle': string;
+    'color.status.border.danger': string;
+    'color.status.border.danger.subtle': string;
+    'color.status.fg.danger': string;
+    'color.status.fg.danger.subtle': string;
+    'color.status.bg.info': string;
+    'color.status.bg.info.subtle': string;
+    'color.status.border.info': string;
+    'color.status.border.info.subtle': string;
+    'color.status.fg.info': string;
+    'color.status.fg.info.subtle': string;
+    'elevation.none.shadowColor': string;
+    'elevation.none.shadowOpacity': number;
+    'elevation.none.shadowRadius': number;
+    'elevation.none.shadowOffset.width': number;
+    'elevation.none.shadowOffset.height': number;
+    'elevation.none.elevation': number;
+    'elevation.sm.shadowColor': string;
+    'elevation.sm.shadowOpacity': number;
+    'elevation.sm.shadowRadius': number;
+    'elevation.sm.shadowOffset.width': number;
+    'elevation.sm.shadowOffset.height': number;
+    'elevation.sm.elevation': number;
+    'elevation.md.shadowColor': string;
+    'elevation.md.shadowOpacity': number;
+    'elevation.md.shadowRadius': number;
+    'elevation.md.shadowOffset.width': number;
+    'elevation.md.shadowOffset.height': number;
+    'elevation.md.elevation': number;
+    'elevation.lg.shadowColor': string;
+    'elevation.lg.shadowOpacity': number;
+    'elevation.lg.shadowRadius': number;
+    'elevation.lg.shadowOffset.width': number;
+    'elevation.lg.shadowOffset.height': number;
+    'elevation.lg.elevation': number;
+    'elevation.xl.shadowColor': string;
+    'elevation.xl.shadowOpacity': number;
+    'elevation.xl.shadowRadius': number;
+    'elevation.xl.shadowOffset.width': number;
+    'elevation.xl.shadowOffset.height': number;
+    'elevation.xl.elevation': number;
+};
+//# sourceMappingURL=light.d.ts.map

package/lib/typescript/src/theme/tokens/light.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light.d.ts","sourceRoot":"","sources":["../../../../../src/theme/tokens/light.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6GjB,CAAC"}

package/lib/typescript/src/theme/tokens/primitives.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Scheme-agnostic primitive tokens — flat, dotted-key data.
+ *
+ * GENERATED-STYLE SOURCE: this file is plain data (no imports, no types).
+ * It is intended to be replaced by the Figma design-system export. Keys use a
+ * fully-flat `a.b.c` path; the runtime theme is rebuilt from these via
+ * `unflatten()` in `theme.ts`. Scalar leaves only.
+ *
+ * `palette.*` is kept for Figma parity / authoring reference; the runtime theme
+ * consumes already-resolved semantic colors (see `light.ts` / `dark.ts`) and
+ * does not read the palette directly.
+ */
+export declare const primitives: {
+    'palette.slate.50': string;
+    'palette.slate.100': string;
+    'palette.slate.200': string;
+    'palette.slate.300': string;
+    'palette.slate.400': string;
+    'palette.slate.500': string;
+    'palette.slate.600': string;
+    'palette.slate.700': string;
+    'palette.slate.800': string;
+    'palette.slate.900': string;
+    'palette.slate.950': string;
+    'palette.emerald.50': string;
+    'palette.emerald.100': string;
+    'palette.emerald.200': string;
+    'palette.emerald.300': string;
+    'palette.emerald.400': string;
+    'palette.emerald.500': string;
+    'palette.emerald.600': string;
+    'palette.emerald.700': string;
+    'palette.emerald.800': string;
+    'palette.emerald.900': string;
+    'palette.emerald.950': string;
+    'palette.red.50': string;
+    'palette.red.100': string;
+    'palette.red.200': string;
+    'palette.red.300': string;
+    'palette.red.400': string;
+    'palette.red.500': string;
+    'palette.red.600': string;
+    'palette.red.700': string;
+    'palette.red.800': string;
+    'palette.red.900': string;
+    'palette.red.950': string;
+    'palette.amber.50': string;
+    'palette.amber.100': string;
+    'palette.amber.200': string;
+    'palette.amber.300': string;
+    'palette.amber.400': string;
+    'palette.amber.500': string;
+    'palette.amber.600': string;
+    'palette.amber.700': string;
+    'palette.amber.800': string;
+    'palette.amber.900': string;
+    'palette.amber.950': string;
+    'palette.green.50': string;
+    'palette.green.100': string;
+    'palette.green.200': string;
+    'palette.green.300': string;
+    'palette.green.400': string;
+    'palette.green.500': string;
+    'palette.green.600': string;
+    'palette.green.700': string;
+    'palette.green.800': string;
+    'palette.green.900': string;
+    'palette.green.950': string;
+    'palette.blue.50': string;
+    'palette.blue.100': string;
+    'palette.blue.200': string;
+    'palette.blue.300': string;
+    'palette.blue.400': string;
+    'palette.blue.500': string;
+    'palette.blue.600': string;
+    'palette.blue.700': string;
+    'palette.blue.800': string;
+    'palette.blue.900': string;
+    'palette.blue.950': string;
+    'palette.sky.50': string;
+    'palette.sky.100': string;
+    'palette.sky.200': string;
+    'palette.sky.300': string;
+    'palette.sky.400': string;
+    'palette.sky.500': string;
+    'palette.sky.600': string;
+    'palette.sky.700': string;
+    'palette.sky.800': string;
+    'palette.sky.900': string;
+    'palette.sky.950': string;
+    'palette.black': string;
+    'palette.white': string;
+    'palette.neutral.50': string;
+    'palette.neutral.100': string;
+    'palette.neutral.200': string;
+    'palette.neutral.300': string;
+    'palette.neutral.400': string;
+    'palette.neutral.500': string;
+    'palette.neutral.600': string;
+    'palette.neutral.700': string;
+    'palette.neutral.800': string;
+    'palette.neutral.900': string;
+    'palette.neutral.950': string;
+    'spacing.0': number;
+    'spacing.1': number;
+    'spacing.2': number;
+    'spacing.3': number;
+    'spacing.4': number;
+    'spacing.5': number;
+    'spacing.6': number;
+    'spacing.7': number;
+    'spacing.8': number;
+    'spacing.9': number;
+    'spacing.10': number;
+    'spacing.12': number;
+    'spacing.14': number;
+    'spacing.16': number;
+    'spacing.20': number;
+    'spacing.24': number;
+    'spacing.32': number;
+    'radius.base': number;
+    'typography.fonts.regular': string;
+    'typography.fonts.medium': string;
+    'typography.fonts.semibold': string;
+    'typography.fonts.bold': string;
+    'typography.variants.display-lg.fontSize': number;
+    'typography.variants.display-lg.lineHeight': number;
+    'typography.variants.display-lg.fontWeight': string;
+    'typography.variants.display-lg.letterSpacing': number;
+    'typography.variants.display-lg.maxFontSizeMultiplier': number;
+    'typography.variants.display-md.fontSize': number;
+    'typography.variants.display-md.lineHeight': number;
+    'typography.variants.display-md.fontWeight': string;
+    'typography.variants.display-md.letterSpacing': number;
+    'typography.variants.display-md.maxFontSizeMultiplier': number;
+    'typography.variants.display-sm.fontSize': number;
+    'typography.variants.display-sm.lineHeight': number;
+    'typography.variants.display-sm.fontWeight': string;
+    'typography.variants.display-sm.letterSpacing': number;
+    'typography.variants.display-sm.maxFontSizeMultiplier': number;
+    'typography.variants.headline-lg.fontSize': number;
+    'typography.variants.headline-lg.lineHeight': number;
+    'typography.variants.headline-lg.fontWeight': string;
+    'typography.variants.headline-lg.letterSpacing': number;
+    'typography.variants.headline-lg.maxFontSizeMultiplier': number;
+    'typography.variants.headline-md.fontSize': number;
+    'typography.variants.headline-md.lineHeight': number;
+    'typography.variants.headline-md.fontWeight': string;
+    'typography.variants.headline-md.letterSpacing': number;
+    'typography.variants.headline-md.maxFontSizeMultiplier': number;
+    'typography.variants.headline-sm.fontSize': number;
+    'typography.variants.headline-sm.lineHeight': number;
+    'typography.variants.headline-sm.fontWeight': string;
+    'typography.variants.headline-sm.letterSpacing': number;
+    'typography.variants.headline-sm.maxFontSizeMultiplier': number;
+    'typography.variants.title-lg.fontSize': number;
+    'typography.variants.title-lg.lineHeight': number;
+    'typography.variants.title-lg.fontWeight': string;
+    'typography.variants.title-lg.letterSpacing': number;
+    'typography.variants.title-lg.maxFontSizeMultiplier': number;
+    'typography.variants.title-md.fontSize': number;
+    'typography.variants.title-md.lineHeight': number;
+    'typography.variants.title-md.fontWeight': string;
+    'typography.variants.title-md.letterSpacing': number;
+    'typography.variants.title-md.maxFontSizeMultiplier': number;
+    'typography.variants.title-sm.fontSize': number;
+    'typography.variants.title-sm.lineHeight': number;
+    'typography.variants.title-sm.fontWeight': string;
+    'typography.variants.title-sm.letterSpacing': number;
+    'typography.variants.title-sm.maxFontSizeMultiplier': number;
+    'typography.variants.body-lg.fontSize': number;
+    'typography.variants.body-lg.lineHeight': number;
+    'typography.variants.body-lg.fontWeight': string;
+    'typography.variants.body-lg.letterSpacing': number;
+    'typography.variants.body-lg.maxFontSizeMultiplier': number;
+    'typography.variants.body-md.fontSize': number;
+    'typography.variants.body-md.lineHeight': number;
+    'typography.variants.body-md.fontWeight': string;
+    'typography.variants.body-md.letterSpacing': number;
+    'typography.variants.body-md.maxFontSizeMultiplier': number;
+    'typography.variants.body-sm.fontSize': number;
+    'typography.variants.body-sm.lineHeight': number;
+    'typography.variants.body-sm.fontWeight': string;
+    'typography.variants.body-sm.letterSpacing': number;
+    'typography.variants.body-sm.maxFontSizeMultiplier': number;
+    'typography.variants.label-lg.fontSize': number;
+    'typography.variants.label-lg.lineHeight': number;
+    'typography.variants.label-lg.fontWeight': string;
+    'typography.variants.label-lg.letterSpacing': number;
+    'typography.variants.label-lg.maxFontSizeMultiplier': number;
+    'typography.variants.label-md.fontSize': number;
+    'typography.variants.label-md.lineHeight': number;
+    'typography.variants.label-md.fontWeight': string;
+    'typography.variants.label-md.letterSpacing': number;
+    'typography.variants.label-md.maxFontSizeMultiplier': number;
+    'typography.variants.label-sm.fontSize': number;
+    'typography.variants.label-sm.lineHeight': number;
+    'typography.variants.label-sm.fontWeight': string;
+    'typography.variants.label-sm.letterSpacing': number;
+    'typography.variants.label-sm.maxFontSizeMultiplier': number;
+    'typography.variants.caption.fontSize': number;
+    'typography.variants.caption.lineHeight': number;
+    'typography.variants.caption.fontWeight': string;
+    'typography.variants.caption.letterSpacing': number;
+    'typography.variants.caption.maxFontSizeMultiplier': number;
+    'opacity.disabled': number;
+    'opacity.pressed': number;
+    'layout.screen.margin.x': number;
+    'layout.screen.margin.y': number;
+    'layout.header.height': number;
+};
+//# sourceMappingURL=primitives.d.ts.map

package/lib/typescript/src/theme/tokens/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../../../src/theme/tokens/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2NtB,CAAC"}

package/lib/typescript/src/theme/types.d.ts

@@ -0,0 +1,273 @@
+/**
+ * Theme typing — the single source of truth for every consumer-facing and
+ * structural theme type. The token DATA (tokens/*.ts) is intentionally
+ * untyped (Figma-generated); these types describe the runtime theme that the
+ * data is unflattened into, plus the public configuration surface.
+ */
+import type { ComponentType } from 'react';
+import type { ImageStyle, StyleProp } from 'react-native';
+import type { DeepPartial } from '#utils/deep-merge';
+/** Spacing scale keys (dp, 4dp base unit). Read as `gap={3}` → string '3'. */
+export type SpacingKey = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '12' | '14' | '16' | '20' | '24' | '32';
+/** Border-radius scale keys. */
+export type RadiusKey = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full';
+/**
+ * The radius tokens offered as a component default. Excludes the extreme/rare
+ * steps (`xs`, `2xl`, `3xl`).
+ */
+export type DefaultRadiusToken = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+/** Components whose default appearance can be configured. */
+export type RadiusComponent = 'button' | 'surface';
+/** Elevation preset — platform-aware shadow + Android elevation. */
+export interface ElevationStyle {
+    shadowColor: string;
+    shadowOpacity: number;
+    shadowRadius: number;
+    shadowOffset: {
+        width: number;
+        height: number;
+    };
+    /** Android elevation. */
+    elevation: number;
+}
+export type ElevationKey = 'none' | 'sm' | 'md' | 'lg' | 'xl';
+export type ElevationScale = Record<ElevationKey, ElevationStyle>;
+export type RoleTextVariant = 'display-lg' | 'display-md' | 'display-sm' | 'headline-lg' | 'headline-md' | 'headline-sm' | 'title-lg' | 'title-md' | 'title-sm' | 'body-lg' | 'body-md' | 'body-sm' | 'label-lg' | 'label-md' | 'label-sm' | 'caption';
+export type HeadingTextVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+export type TextVariant = RoleTextVariant | HeadingTextVariant;
+export type FontWeightToken = 'regular' | 'medium' | 'semibold' | 'bold';
+export interface TypeStyle {
+    fontSize: number;
+    lineHeight: number;
+    fontWeight: FontWeightToken;
+    /** Tracking, dp. */
+    letterSpacing: number;
+    /** Cap OS Dynamic Type scaling to protect layout. */
+    maxFontSizeMultiplier: number;
+}
+export interface Typography {
+    /**
+     * Weight token → font-family name. Defaults to the system font.
+     * For custom fonts, point each weight at its own family
+     * (e.g. { regular: 'Inter-Regular', semibold: 'Inter-SemiBold' }).
+     */
+    fonts: Record<FontWeightToken, string>;
+    variants: Record<RoleTextVariant, TypeStyle>;
+}
+/**
+ * Flat color token map — keys are dotted paths matching the token schema
+ * (category prefix `color.` stripped). Accessed as `theme.color['text.default']`.
+ */
+export interface ThemeColor {
+    background: string;
+    'surface.default': string;
+    'surface.raised': string;
+    'surface.sunken': string;
+    'surface.overlay': string;
+    'surface.accent': string;
+    'surface.accent.subtle': string;
+    'text.default': string;
+    'text.muted': string;
+    'text.subtle': string;
+    'text.disabled': string;
+    'text.inverse': string;
+    'text.link': string;
+    'text.accent': string;
+    'text.on-accent': string;
+    'text.on-accent-subtle': string;
+    'border.subtle': string;
+    'border.default': string;
+    'border.strong': string;
+    'border.focus': string;
+    'border.accent': string;
+    'action.bg.primary': string;
+    'action.bg.primary.hover': string;
+    'action.bg.primary.active': string;
+    'action.bg.primary.disabled': string;
+    'action.fg.primary': string;
+    'action.bg.subtle': string;
+    'action.bg.subtle.hover': string;
+    'action.bg.subtle.active': string;
+    'action.bg.subtle.disabled': string;
+    'action.fg.subtle': string;
+    'action.bg.neutral': string;
+    'action.bg.neutral.hover': string;
+    'action.bg.neutral.active': string;
+    'action.bg.neutral.disabled': string;
+    'action.fg.neutral': string;
+    'status.bg.success': string;
+    'status.bg.success.subtle': string;
+    'status.border.success': string;
+    'status.border.success.subtle': string;
+    'status.fg.success': string;
+    'status.fg.success.subtle': string;
+    'status.bg.warning': string;
+    'status.bg.warning.subtle': string;
+    'status.border.warning': string;
+    'status.border.warning.subtle': string;
+    'status.fg.warning': string;
+    'status.fg.warning.subtle': string;
+    'status.bg.danger': string;
+    'status.bg.danger.subtle': string;
+    'status.border.danger': string;
+    'status.border.danger.subtle': string;
+    'status.fg.danger': string;
+    'status.fg.danger.subtle': string;
+    'status.bg.info': string;
+    'status.bg.info.subtle': string;
+    'status.border.info': string;
+    'status.border.info.subtle': string;
+    'status.fg.info': string;
+    'status.fg.info.subtle': string;
+}
+/** State-layer opacities for disabled / pressed feedback. */
+export interface OpacityTokens {
+    disabled: number;
+    pressed: number;
+}
+/** Screen-level layout tokens. */
+export interface LayoutTokens {
+    screen: {
+        /** Margin between content and the screen edge (applied as container padding). */
+        margin: {
+            x: number;
+            y: number;
+        };
+    };
+    header: {
+        /** Height of the header bar (compact nav bar / collapsed large-title bar), dp. */
+        height: number;
+    };
+}
+/** The full resolved theme. `light` and `dark` are both `TerraTheme`. */
+export interface TerraTheme {
+    color: ThemeColor;
+    spacing: Record<SpacingKey, number>;
+    radius: Record<RadiusKey, number>;
+    typography: Typography;
+    elevation: ElevationScale;
+    opacity: OpacityTokens;
+    layout: LayoutTokens;
+}
+export type BackgroundColorToken = 'background';
+export type SurfaceColorToken = Extract<keyof ThemeColor, `surface.${string}`>;
+export type TextColorToken = Extract<keyof ThemeColor, `text.${string}`>;
+export type BorderColorToken = Extract<keyof ThemeColor, `border.${string}`>;
+export type ActionColorToken = Extract<keyof ThemeColor, `action.${string}`>;
+export type StatusColorToken = Extract<keyof ThemeColor, `status.${string}`>;
+/** @deprecated Use {@link TextColorToken} — renamed to reflect the `text.*` token namespace. */
+export type ContentColorToken = TextColorToken;
+/**
+ * Any color value a component accepts:
+ * semantic token (`text.default`, `surface.raised`, `action.bg.primary`),
+ * or a raw CSS color literal (`#fff`, `rgb(...)`, `transparent`).
+ */
+export type ColorToken = BackgroundColorToken | SurfaceColorToken | TextColorToken | BorderColorToken | ActionColorToken | StatusColorToken | (string & {});
+export type Scheme = 'light' | 'dark';
+/** A hue shorthand per scheme — expands to primary + accent token patches. */
+export interface AccentShorthand {
+    light: string;
+    dark: string;
+}
+/** A full partial-theme override per scheme. */
+export interface AccentOverride {
+    light?: DeepPartial<TerraTheme>;
+    dark?: DeepPartial<TerraTheme>;
+}
+/** A named, runtime-switchable theme override. */
+export type Accent = AccentShorthand | AccentOverride;
+/** An accent input normalized to per-scheme partial-theme overrides. */
+export interface NormalizedAccent {
+    light: DeepPartial<TerraTheme>;
+    dark: DeepPartial<TerraTheme>;
+}
+export interface TerraIconProps {
+    size?: number;
+    color?: string;
+    strokeWidth?: number;
+}
+export type TerraIconComponent = ComponentType<TerraIconProps>;
+export type TerraImageContentFit = 'cover' | 'contain' | 'fill';
+export interface TerraImageProps {
+    source: {
+        uri: string;
+    } | number;
+    style?: StyleProp<ImageStyle>;
+    accessibilityLabel?: string;
+    contentFit?: TerraImageContentFit;
+    onError?: () => void;
+}
+export type TerraImageComponent = ComponentType<TerraImageProps>;
+declare global {
+    namespace TerraUI {
+        interface IconRegistry {
+        }
+    }
+}
+export interface TerraIconRegistry extends TerraUI.IconRegistry {
+}
+export type TerraSemanticIconName = 'navigation.back' | 'navigation.forward' | 'navigation.close' | 'status.info' | 'status.success' | 'status.warning' | 'status.danger' | 'person';
+export type TerraConfiguredIconName = keyof TerraIconRegistry & string;
+export type TerraIconName = TerraSemanticIconName | TerraConfiguredIconName;
+export type ThemeRadiusOverride = DeepPartial<TerraTheme['radius']> & {
+    /**
+     * Base corner radius in dp — the `lg` (×1) step. The rest of the scale is
+     * derived by fixed multipliers (`xs` ×0.25, `sm` ×0.5, `md` ×0.75,
+     * `xl` ×1.5, `2xl` ×2, `3xl` ×3); `none` (0) and `full` (9999) are
+     * constant. Per-token radius overrides still win over the derived value.
+     */
+    base?: number;
+};
+/** Theme override accepted at configure time. */
+export type TerraThemeOverride = DeepPartial<Omit<TerraTheme, 'radius'>> & {
+    radius?: ThemeRadiusOverride;
+};
+/** Default props for the Button component. A per-instance prop still wins. */
+export interface ButtonDefaults {
+    /** Default corner radius. Defaults to `'md'`. */
+    radius?: DefaultRadiusToken;
+}
+/** Default props for the Surface component. A per-instance prop still wins. */
+export interface SurfaceDefaults {
+    /** Default corner radius. Defaults to `'md'`. */
+    radius?: DefaultRadiusToken;
+    /** Default drop-shadow depth (`'none'` = no shadow). Defaults to `'none'`. */
+    elevation?: ElevationKey;
+}
+/** Per-component default props applied at configure time. */
+export interface ComponentDefaults {
+    button?: ButtonDefaults;
+    surface?: SurfaceDefaults;
+}
+export interface TerraConfig {
+    /** Scheme-agnostic token overrides, applied to both light and dark themes. */
+    shared?: TerraThemeOverride;
+    /** Per-scheme token overrides, applied after `shared`. */
+    schemes?: {
+        light?: TerraThemeOverride;
+        dark?: TerraThemeOverride;
+    };
+    /** Runtime-switchable named overrides (hue shorthand or full partial). */
+    accents?: Record<string, Accent>;
+    /**
+     * App-provided icon overrides. Semantic icons (`navigation.*`, `status.*`)
+     * fall back to the built-in defaults when omitted; app icons (`add`, etc.)
+     * must be registered here.
+     */
+    icons?: Partial<Record<TerraIconName, TerraIconComponent>>;
+    /**
+     * Custom image renderer (e.g. `expo-image`, `react-native-fast-image`).
+     * Defaults to React Native's built-in `Image` with `contentFit` mapped to
+     * `resizeMode`. Wrap third-party components to match `TerraImageProps`.
+     */
+    image?: TerraImageComponent;
+    /** Name of the accent (from `accents`) to apply by default. */
+    defaultAccent?: string;
+    /** Per-component default props (e.g. `{ button: { radius: 'full' } }`). */
+    components?: ComponentDefaults;
+    /** Follow the system color scheme. Default `true`. */
+    adaptiveThemes?: boolean;
+    /** Force a starting scheme (disables adaptive theming). */
+    initialScheme?: Scheme;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/theme/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,4 @@
+export type Mutable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}

package/lib/typescript/src/utils/accent-utils.d.ts

@@ -0,0 +1,4 @@
+import type { Accent, NormalizedAccent } from '#theme/types';
+/** Normalizes any accent input into per-scheme partial-theme overrides. */
+export declare function normalizeAccent(accent: Accent): NormalizedAccent;
+//# sourceMappingURL=accent-utils.d.ts.map

package/lib/typescript/src/utils/accent-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accent-utils.d.ts","sourceRoot":"","sources":["../../../../src/utils/accent-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EAEN,gBAAgB,EAEjB,MAAM,cAAc,CAAC;AA2CtB,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAQhE"}

package/lib/typescript/src/utils/color-utils.d.ts

@@ -0,0 +1,11 @@
+/** Small color helpers for deriving accent shades from a single hue. */
+/**
+ * Shifts a hex color toward black (negative `amount`) or white (positive),
+ * by a fraction in [-1, 1]. Returns the input unchanged if not a 6-digit hex.
+ */
+export declare function shade(hex: string, amount: number): string;
+/** Returns an `rgba(...)` string for a hex color at the given alpha. */
+export declare function withAlpha(hex: string, alpha: number): string;
+/** Picks black or white for legible text/icons on top of `hex`. */
+export declare function readableOn(hex: string): string;
+//# sourceMappingURL=color-utils.d.ts.map

package/lib/typescript/src/utils/color-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.d.ts","sourceRoot":"","sources":["../../../../src/utils/color-utils.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAoBxE;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM9C"}

package/lib/typescript/src/utils/deep-merge.d.ts

@@ -0,0 +1,11 @@
+/** Recursively makes every property (and nested property) optional. */
+export type DeepPartial<T> = T extends (infer U)[] ? DeepPartial<U>[] : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * Deep-merges `override` onto `base`, returning a new object.
+ * Plain objects merge recursively; all other values (and arrays) replace.
+ * Neither input is mutated.
+ */
+export declare function deepMerge<T>(base: T, override?: DeepPartial<T>): T;
+//# sourceMappingURL=deep-merge.d.ts.map