react-native-terra-ui 0.7.2 → 0.8.0

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

@@ -1,85 +1,70 @@
 /**
- * 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. {palette.key}/NN resolves the
- * referenced #rrggbb hex with an NN% opacity byte appended (e.g.
- * {palette.amber.500}/15 -> '#fe9a0026'). Raw hex is used only where no
- * palette step matches exactly.
- *
- * GENERATED-STYLE SOURCE: intended to be replaced by the Figma / design-sync export.
+ * Light semantic colors. See docs/design-tokens.md for naming and references.
+ * Generated-style source; naming and contrast updates await the next design-sync export.
  */
 export declare const light: {
-    "color.background": string;
-    "color.shadow": string;
+    "color.surface.canvas": 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.primary": string;
+    "color.text.secondary": string;
+    "color.text.tertiary": 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.primary.subtle": string;
-    "color.action.bg.primary.subtle.hover": string;
-    "color.action.bg.primary.subtle.active": string;
-    "color.action.bg.primary.subtle.disabled": string;
-    "color.action.fg.primary.subtle": string;
-    "color.action.bg.secondary": string;
-    "color.action.fg.secondary": string;
-    "color.action.bg.secondary.subtle": string;
-    "color.action.bg.secondary.subtle.hover": string;
-    "color.action.bg.secondary.subtle.active": string;
-    "color.action.bg.secondary.subtle.disabled": string;
-    "color.action.fg.secondary.subtle": string;
-    "color.status.success": string;
-    "color.status.success.bg": string;
-    "color.status.success.bg.subtle": string;
-    "color.status.success.border": string;
-    "color.status.success.border.subtle": string;
-    "color.status.success.fg": string;
-    "color.status.success.fg.subtle": string;
-    "color.status.warning": string;
-    "color.status.warning.bg": string;
-    "color.status.warning.bg.subtle": string;
-    "color.status.warning.border": string;
-    "color.status.warning.border.subtle": string;
-    "color.status.warning.fg": string;
-    "color.status.warning.fg.subtle": string;
-    "color.status.danger": string;
-    "color.status.danger.bg": string;
-    "color.status.danger.bg.subtle": string;
-    "color.status.danger.border": string;
-    "color.status.danger.border.subtle": string;
-    "color.status.danger.fg": string;
-    "color.status.danger.fg.subtle": string;
-    "color.status.info": string;
-    "color.status.info.bg": string;
-    "color.status.info.bg.subtle": string;
-    "color.status.info.border": string;
-    "color.status.info.border.subtle": string;
-    "color.status.info.fg": string;
-    "color.status.info.fg.subtle": string;
+    "color.focus.ring": string;
+    "color.backdrop": string;
+    "color.shadow": string;
+    "color.accent.text": string;
+    "color.accent.border": string;
+    "color.accent.solid.bg": string;
+    "color.accent.solid.bg.hover": string;
+    "color.accent.solid.bg.pressed": string;
+    "color.accent.solid.bg.disabled": string;
+    "color.accent.solid.fg": string;
+    "color.accent.soft.bg": string;
+    "color.accent.soft.bg.hover": string;
+    "color.accent.soft.bg.pressed": string;
+    "color.accent.soft.bg.disabled": string;
+    "color.accent.soft.fg": string;
+    "color.neutral.solid.bg": string;
+    "color.neutral.solid.fg": string;
+    "color.neutral.soft.bg": string;
+    "color.neutral.soft.bg.hover": string;
+    "color.neutral.soft.bg.pressed": string;
+    "color.neutral.soft.bg.disabled": string;
+    "color.neutral.soft.fg": string;
+    "color.success.text": string;
+    "color.success.solid.bg": string;
+    "color.success.solid.fg": string;
+    "color.success.solid.border": string;
+    "color.success.soft.bg": string;
+    "color.success.soft.fg": string;
+    "color.success.soft.border": string;
+    "color.warning.text": string;
+    "color.warning.solid.bg": string;
+    "color.warning.solid.fg": string;
+    "color.warning.solid.border": string;
+    "color.warning.soft.bg": string;
+    "color.warning.soft.fg": string;
+    "color.warning.soft.border": string;
+    "color.danger.text": string;
+    "color.danger.solid.bg": string;
+    "color.danger.solid.fg": string;
+    "color.danger.solid.border": string;
+    "color.danger.soft.bg": string;
+    "color.danger.soft.fg": string;
+    "color.danger.soft.border": string;
+    "color.info.text": string;
+    "color.info.solid.bg": string;
+    "color.info.solid.fg": string;
+    "color.info.solid.border": string;
+    "color.info.soft.bg": string;
+    "color.info.soft.fg": string;
+    "color.info.soft.border": string;
 };
 //# sourceMappingURL=light.d.ts.map

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

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

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

@@ -1,6 +1,7 @@
 /**
  * Scheme-agnostic primitive tokens — flat, dotted-key data.
  *
+ * Naming migration: screen padding keys updated ahead of the next design-sync export.
  * 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
@@ -421,16 +422,16 @@ export declare const primitives: {
     "typography.variants.caption.maxFontSizeMultiplier": number;
     "opacity.disabled": number;
     "opacity.pressed": number;
-    "layout.screen.margin.x.xs": number;
-    "layout.screen.margin.x.sm": number;
-    "layout.screen.margin.x.md": number;
-    "layout.screen.margin.x.lg": number;
-    "layout.screen.margin.x.xl": number;
-    "layout.screen.margin.y.xs": number;
-    "layout.screen.margin.y.sm": number;
-    "layout.screen.margin.y.md": number;
-    "layout.screen.margin.y.lg": number;
-    "layout.screen.margin.y.xl": number;
+    "layout.screen.padding.x.xs": number;
+    "layout.screen.padding.x.sm": number;
+    "layout.screen.padding.x.md": number;
+    "layout.screen.padding.x.lg": number;
+    "layout.screen.padding.x.xl": number;
+    "layout.screen.padding.y.xs": number;
+    "layout.screen.padding.y.sm": number;
+    "layout.screen.padding.y.md": number;
+    "layout.screen.padding.y.lg": number;
+    "layout.screen.padding.y.xl": number;
     "layout.header.height": number;
 };
 //# sourceMappingURL=primitives.d.ts.map

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

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

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

@@ -0,0 +1,34 @@
+import type { Scheme } from "../../theme/types";
+/** Where an issue was found: one of the scheme files, or the shared primitives. */
+export type SchemeTokenSource = Scheme | "primitives";
+export interface SchemeTokenIssue {
+    source: SchemeTokenSource;
+    /** The authored key (e.g. `color.text.primary`), as written in the file. */
+    key: string;
+    /** The authored value, verbatim. */
+    value: unknown;
+    message: string;
+}
+/** The three raw token maps. Defaults to the real data; tests pass fixtures. */
+export interface SchemeTokenData {
+    light: Record<string, unknown>;
+    dark: Record<string, unknown>;
+    primitives: Record<string, unknown>;
+}
+export declare class SchemeTokenValidationError extends Error {
+    readonly issues: readonly SchemeTokenIssue[];
+    constructor(issues: readonly SchemeTokenIssue[]);
+}
+export declare function formatIssue(issue: SchemeTokenIssue): string;
+/**
+ * Collects every problem in the raw scheme data. Returns `[]` for valid data.
+ * Pass a partial {@link SchemeTokenData} to validate fixtures; omitted maps
+ * default to the real token files.
+ */
+export declare function collectSchemeTokenIssues(data?: Partial<SchemeTokenData>): SchemeTokenIssue[];
+/**
+ * Throws a {@link SchemeTokenValidationError} listing every issue (source,
+ * key, value, message) when the raw scheme data is invalid.
+ */
+export declare function validateSchemeTokens(data?: Partial<SchemeTokenData>): void;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../../src/theme/tokens/validate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAM3C,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;gBAEjC,MAAM,EAAE,SAAS,gBAAgB,EAAE;CAShD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAE3D;AA0LD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,gBAAgB,EAAE,CAiBhG;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,IAAI,CAG9E"}

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

@@ -8,6 +8,7 @@ import type { ComponentType } from "react";
 import type { ImageStyle, StyleProp } from "react-native";
 import type { DeepPartial } from "../utils/deep-merge";
 import type { BreakpointName } from "./breakpoints.js";
+import type { LegacyThemeColor } from "./legacy-tokens.js";
 /** 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. */
@@ -67,95 +68,128 @@ export interface Typography {
 }
 /**
  * Flat color token map — keys are dotted paths matching the token schema
- * (category prefix `color.` stripped). Accessed as `theme.color['text.default']`.
+ * (category prefix `color.` stripped). Accessed as `theme.color['text.primary']`.
  */
-export interface ThemeColor {
-    background: string;
+export interface CanonicalThemeColor {
+    "surface.canvas": string;
     shadow: 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;
+    backdrop: string;
+    "text.primary": string;
+    "text.secondary": string;
+    "text.tertiary": string;
     "text.disabled": string;
     "text.inverse": string;
     "text.link": string;
-    "text.accent": string;
-    "text.on-accent": string;
-    "text.on-accent-subtle": string;
+    "accent.text": 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.primary.subtle": string;
-    "action.bg.primary.subtle.hover": string;
-    "action.bg.primary.subtle.active": string;
-    "action.bg.primary.subtle.disabled": string;
-    "action.fg.primary.subtle": string;
-    "action.bg.secondary": string;
-    "action.fg.secondary": string;
-    "action.bg.secondary.subtle": string;
-    "action.bg.secondary.subtle.hover": string;
-    "action.bg.secondary.subtle.active": string;
-    "action.bg.secondary.subtle.disabled": string;
-    "action.fg.secondary.subtle": string;
-    "status.success": string;
-    "status.success.bg": string;
-    "status.success.bg.subtle": string;
-    "status.success.border": string;
-    "status.success.border.subtle": string;
-    "status.success.fg": string;
-    "status.success.fg.subtle": string;
-    "status.warning": string;
-    "status.warning.bg": string;
-    "status.warning.bg.subtle": string;
-    "status.warning.border": string;
-    "status.warning.border.subtle": string;
-    "status.warning.fg": string;
-    "status.warning.fg.subtle": string;
-    "status.danger": string;
-    "status.danger.bg": string;
-    "status.danger.bg.subtle": string;
-    "status.danger.border": string;
-    "status.danger.border.subtle": string;
-    "status.danger.fg": string;
-    "status.danger.fg.subtle": string;
-    "status.info": string;
-    "status.info.bg": string;
-    "status.info.bg.subtle": string;
-    "status.info.border": string;
-    "status.info.border.subtle": string;
-    "status.info.fg": string;
-    "status.info.fg.subtle": string;
+    "focus.ring": string;
+    "accent.border": string;
+    "accent.solid.bg": string;
+    "accent.solid.bg.hover": string;
+    "accent.solid.bg.pressed": string;
+    "accent.solid.bg.disabled": string;
+    "accent.solid.fg": string;
+    "accent.soft.bg": string;
+    "accent.soft.bg.hover": string;
+    "accent.soft.bg.pressed": string;
+    "accent.soft.bg.disabled": string;
+    "accent.soft.fg": string;
+    "neutral.solid.bg": string;
+    "neutral.solid.fg": string;
+    "neutral.soft.bg": string;
+    "neutral.soft.bg.hover": string;
+    "neutral.soft.bg.pressed": string;
+    "neutral.soft.bg.disabled": string;
+    "neutral.soft.fg": string;
+    "success.text": string;
+    "success.solid.bg": string;
+    "success.soft.bg": string;
+    "success.solid.border": string;
+    "success.soft.border": string;
+    "success.solid.fg": string;
+    "success.soft.fg": string;
+    "warning.text": string;
+    "warning.solid.bg": string;
+    "warning.soft.bg": string;
+    "warning.solid.border": string;
+    "warning.soft.border": string;
+    "warning.solid.fg": string;
+    "warning.soft.fg": string;
+    "danger.text": string;
+    "danger.solid.bg": string;
+    "danger.soft.bg": string;
+    "danger.solid.border": string;
+    "danger.soft.border": string;
+    "danger.solid.fg": string;
+    "danger.soft.fg": string;
+    "info.text": string;
+    "info.solid.bg": string;
+    "info.soft.bg": string;
+    "info.solid.border": string;
+    "info.soft.border": string;
+    "info.solid.fg": string;
+    "info.soft.fg": string;
 }
-/** State-layer opacities for disabled / pressed feedback. */
+declare global {
+    namespace TerraUI {
+        /**
+         * Augment to declare app-specific semantic color keys. Declared keys become
+         * valid in `shared` / `schemes` / accent overrides, `theme.color`, and
+         * component color props. Keys must not collide with built-in canonical or
+         * deprecated names. Type augmentation alone cannot prove a value exists at
+         * runtime — provide every declared color through `shared` or both `schemes`.
+         *
+         * @example
+         * declare global {
+         *   namespace TerraUI {
+         *     interface ColorRegistry {
+         *       "brand.highlight": string;
+         *     }
+         *   }
+         * }
+         */
+        interface ColorRegistry {
+        }
+    }
+}
+export interface TerraColorRegistry extends TerraUI.ColorRegistry {
+}
+/** App-declared custom color names (see {@link TerraUI.ColorRegistry}). */
+export type TerraCustomColorName = keyof TerraColorRegistry & string;
+/**
+ * Custom color keys that collide with a built-in canonical or deprecated name.
+ * Resolves to `never` for a valid registry; apps can assert
+ * `const ok: TerraColorRegistryCollision extends never ? true : never = true`.
+ */
+export type TerraColorRegistryCollision = Extract<keyof TerraUI.ColorRegistry, keyof CanonicalThemeColor | keyof LegacyThemeColor>;
+export interface ThemeColor extends CanonicalThemeColor, LegacyThemeColor, TerraColorRegistry {
+}
+/** Component opacity multipliers for disabled / pressed feedback. */
 export interface OpacityTokens {
     disabled: number;
     pressed: number;
 }
+export interface ScreenPaddingTokens {
+    x: Record<BreakpointName, number>;
+    y: Record<BreakpointName, number>;
+}
 /** Screen-level layout tokens. */
 export interface LayoutTokens {
     screen: {
         /**
-         * Margin between content and the screen edge (applied as container
-         * padding). Both axes scale with the viewport breakpoint — resolve with
-         * `resolveBreakpointValue(theme.layout.screen.margin.x, rt.breakpoint)`
+         * Internal space between content and the screen edge. Both axes scale with
+         * the viewport breakpoint — resolve with
+         * `resolveBreakpointValue(theme.layout.screen.padding.x, rt.breakpoint)`
          * (same for `y`).
          */
-        margin: {
-            x: Record<BreakpointName, number>;
-            y: Record<BreakpointName, number>;
-        };
+        padding: ScreenPaddingTokens;
+        /** @deprecated Use `padding`. */
+        margin: ScreenPaddingTokens;
     };
     header: {
         /** Height of the header bar (compact nav bar / collapsed large-title bar), dp. */
@@ -172,34 +206,64 @@ export interface TerraTheme {
     opacity: OpacityTokens;
     layout: LayoutTokens;
 }
-export type BackgroundColorToken = "background";
+export type BackgroundColorToken = "surface.canvas" | "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}`>;
+export type AccentColorToken = Extract<keyof CanonicalThemeColor, `accent.${string}`>;
+export type NeutralColorToken = Extract<keyof CanonicalThemeColor, `neutral.${string}`>;
+/** @deprecated Prefer AccentColorToken or NeutralColorToken. */
+export type ActionColorToken = AccentColorToken | NeutralColorToken | Extract<keyof ThemeColor, `action.${string}`>;
+export type StatusColorToken = Extract<keyof ThemeColor, `${"success" | "warning" | "danger" | "info"}.${string}` | `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`),
+ * semantic token (`text.primary`, `surface.raised`, `accent.solid.bg`),
  * or a raw CSS color literal (`#fff`, `rgb(...)`, `transparent`).
  */
-export type ColorToken = BackgroundColorToken | SurfaceColorToken | TextColorToken | BorderColorToken | ActionColorToken | StatusColorToken | (string & {});
+export type ColorToken = keyof ThemeColor | (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>;
+/**
+ * How the active scheme is chosen. `system` follows the OS appearance;
+ * `light` / `dark` pin a scheme and stop following the system.
+ */
+export type ThemeMode = "system" | "light" | "dark";
+/**
+ * A seed-generated accent with local exceptions. The seed is a starting color
+ * for the accent family, not a promise that `accent.solid.bg` equals it — pin
+ * `accent.solid.bg` in `overrides` when an exact fill is required.
+ */
+export interface AccentSeed {
+    /** Opaque six-digit sRGB hex (`#rrggbb`). Other formats are rejected at configure time. */
+    seed: string;
+    /**
+     * Flat semantic color patch applied after generation. Within the patch a
+     * canonical name beats its deprecated alias; across layers an explicit
+     * override beats every generated value.
+     */
+    overrides?: Partial<ThemeColor>;
 }
-/** A named, runtime-switchable theme override. */
-export type Accent = AccentShorthand | AccentOverride;
-/** An accent input normalized to per-scheme partial-theme overrides. */
+/**
+ * One scheme's accent input:
+ * - a color string — equivalent to `{ seed: value }`;
+ * - `{ seed, overrides }` — generation with explicit exceptions;
+ * - a full {@link TerraThemeOverride} — skips generation (expert path).
+ */
+export type AccentSchemeInput = string | AccentSeed | TerraThemeOverride;
+/**
+ * A named, runtime-switchable overlay on each scheme. A missing scheme leaves
+ * that scheme unmodified; the other scheme's seed is never copied implicitly.
+ */
+export type Accent = Partial<Record<Scheme, AccentSchemeInput>>;
+/** @deprecated Use {@link Accent} — a color string per scheme. */
+export type AccentShorthand = Record<Scheme, string>;
+/** @deprecated Use {@link Accent} — a {@link TerraThemeOverride} per scheme. */
+export type AccentOverride = Partial<Record<Scheme, TerraThemeOverride>>;
+/**
+ * The compatibility output of `normalizeAccent`: per-scheme partial-theme
+ * overrides generated against the default themes.
+ */
 export interface NormalizedAccent {
     light: DeepPartial<TerraTheme>;
     dark: DeepPartial<TerraTheme>;
@@ -316,9 +380,25 @@ export interface TerraConfig {
     defaultAccent?: string;
     /** Per-component default props (e.g. `{ button: { radius: 'full' } }`). */
     components?: ComponentDefaults;
-    /** Follow the system color scheme. Default `true`. */
+    /**
+     * Initial theme mode. `system` follows the OS appearance; `light` / `dark`
+     * pin a scheme. Wins over the deprecated `initialScheme` / `adaptiveThemes`
+     * when supplied. Defaults to `system`.
+     */
+    mode?: ThemeMode;
+    /** @deprecated Use `mode`. Follow the system color scheme. Default `true`. */
     adaptiveThemes?: boolean;
-    /** Force a starting scheme (disables adaptive theming). */
+    /** @deprecated Use `mode`. Force a starting scheme (disables adaptive theming). */
     initialScheme?: Scheme;
 }
+/** The subset of {@link TerraConfig} that affects resolved theme tokens. */
+export type TerraThemeInput = Pick<TerraConfig, "shared" | "schemes" | "accents" | "defaultAccent">;
+/** Options for pure theme creation. */
+export interface CreateTerraThemesOptions {
+    /**
+     * Accent to overlay. Omitted → `defaultAccent`; `null` → the base themes
+     * with no accent. An unknown name throws.
+     */
+    accent?: string | null;
+}
 //# sourceMappingURL=types.d.ts.map

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

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

package/lib/typescript/src/theme/unistyles-adapter.d.ts

@@ -0,0 +1,33 @@
+import type { Scheme, TerraTheme, ThemeMode } from "./types.js";
+/** Whether `StyleSheet.configure` has run in this app. Exposed for tests. */
+export declare const hasConfiguredUnistyles: () => boolean;
+/**
+ * Registers themes, settings and breakpoints with Unistyles. This is a one-time
+ * startup call per app: calling `StyleSheet.configure` again leaves the themes
+ * it already registered in place, so a second call here is a programming error.
+ * Once configured, replace themes with {@link updateThemes} and change the mode
+ * with {@link applyMode} instead.
+ */
+export declare function configureUnistyles({ themes, mode, }: {
+    themes: Record<Scheme, TerraTheme>;
+    mode: ThemeMode;
+}): void;
+/**
+ * Replaces both registered themes.
+ *
+ * NOT an atomic transaction: Unistyles exposes one `updateTheme` per scheme, so
+ * `light` is replaced first, then `dark`. If the second call throws, the native
+ * runtime holds the new `light` theme and the previous `dark` theme. Callers
+ * publish registry/selection state only after this returns, so on a throw Terra
+ * still reports the previous selection; calling the same command again with the
+ * previous selection (e.g. `applyAccent(getCurrentAccent() ?? null)`) rewrites
+ * both themes and restores consistency. No automatic rollback is attempted.
+ */
+export declare function updateThemes(themes: Record<Scheme, TerraTheme>): void;
+/**
+ * Applies a theme mode to the live runtime: `system` re-enables adaptive
+ * theming; a scheme disables it (so the next OS appearance change does not
+ * override the choice) and then selects that scheme.
+ */
+export declare function applyMode(mode: ThemeMode): void;
+//# sourceMappingURL=unistyles-adapter.d.ts.map

package/lib/typescript/src/theme/unistyles-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unistyles-adapter.d.ts","sourceRoot":"","sources":["../../../../src/theme/unistyles-adapter.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAS,CAAC;AAI7D,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,QAAO,OAAqB,CAAC;AAShE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,IAAI,GACL,EAAE;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,IAAI,EAAE,SAAS,CAAC;CACjB,GAAG,IAAI,CAQP;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI,CAGrE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAO/C"}