react-native-terra-ui 0.7.2 → 0.8.1

package/lib/typescript/src/components/screen/parts/ScreenSafeArea.d.ts

@@ -0,0 +1,6 @@
+import type { PropsWithChildren } from "react";
+import type { ScreenSafeAreaEdges } from "../types.js";
+export declare function ScreenSafeArea({ children, edges }: PropsWithChildren<{
+    edges: ScreenSafeAreaEdges;
+}>): import("react").JSX.Element;
+//# sourceMappingURL=ScreenSafeArea.d.ts.map

package/lib/typescript/src/components/screen/parts/ScreenSafeArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenSafeArea.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenSafeArea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAK/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAU,CAAC;AAEpD,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC,+BAUpG"}

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

@@ -1,41 +1,36 @@
 import type { ReactNode } from "react";
-/**
- * Which axes of the `layout.screen.margin` token a scroll container pads its
- * content with.
- *
- * `'y'` pads the top and bottom of the content area. It stacks on top of the
- * structural insets — the header height and the safe area — which apply
- * whether or not margins are on.
- */
-export type ScreenMargins = "all" | "x" | "y" | "none";
-/**
- * Props shared by `Screen.ScrollView`, `Screen.FlatList` and `Screen.List`, so
- * a screen can swap one container for another without relearning its API.
- */
+import type { ScrollHandlerProcessed } from "react-native-reanimated";
+/** Axes that receive the theme's screen content padding. */
+export type ScreenContentPadding = "all" | "x" | "y" | "none";
+/** @deprecated Use ScreenContentPadding. */
+export type ScreenMargins = ScreenContentPadding;
+/** Edges protected by the Screen root. An empty array is equivalent to `"none"`. */
+export type ScreenSafeArea = "auto" | "none" | readonly ("top" | "bottom" | "left" | "right")[];
+/** Shared content layout and placeholders. Native props retain React Native names. */
 export interface ScreenScrollableProps {
-    /** Lay content out along the x axis. Defaults to `false`. */
+    /** Scroll horizontally. @defaultValue false */
     horizontal?: boolean;
-    /**
-     * Renders a centred placeholder in the content area instead of the content —
-     * spares every screen from hand-rolling a loading branch while its data
-     * arrives. The `Screen.Header` still renders, so the chrome stays put.
-     */
+    /** Replace content with a loading placeholder; `refreshing` keeps list rows visible. */
+    isLoading?: boolean;
+    /** Loading element. Undefined uses a Spinner; null renders a blank placeholder. */
+    loadingContent?: ReactNode;
+    /** Empty-state element. Lists otherwise use their native ListEmptyComponent. */
+    emptyContent?: ReactNode;
+    /** Override the root's themed content-padding axes. */
+    contentPadding?: ScreenContentPadding;
+    /** Additional bottom padding in layout points, added to themed padding. @defaultValue 0 */
+    extraBottomPadding?: number;
+    /** UI-thread worklet composed with Screen tracking. Native onScroll runs on the JS thread. */
+    scrollHandler?: ScrollHandlerProcessed<Record<string, unknown>>;
+    /** @deprecated Use isLoading. Ignored when isLoading is supplied. */
     loading?: boolean;
-    /**
-     * Node shown while `loading`. Defaults to a `Spinner`; it is centred in the
-     * content area either way.
-     */
+    /** @deprecated Pass an element through loadingContent. */
     LoadingComponent?: ReactNode;
-    /**
-     * Node shown, centred, when there is nothing to render and `loading` is
-     * false — an empty `data` array on the list containers, no children on
-     * `Screen.ScrollView`. Omit it to render nothing.
-     */
+    /** @deprecated Pass an element through emptyContent. */
     EmptyComponent?: ReactNode;
-    /**
-     * Which axes get `layout.screen.margin` padding. Defaults to the enclosing
-     * `Screen`'s `margins`.
-     */
+    /** @deprecated Use contentPadding. */
     margins?: ScreenMargins;
 }
+/** Internal edge flags shared by the platform safe-area wrappers. */
+export type ScreenSafeAreaEdges = Record<"top" | "bottom" | "left" | "right", boolean>;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;AAC9D,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AACjD,oFAAoF;AACpF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;AAEhG,sFAAsF;AACtF,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mFAAmF;IACnF,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,gFAAgF;IAChF,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,uDAAuD;IACvD,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8FAA8F;IAC9F,aAAa,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,sCAAsC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC"}

package/lib/typescript/src/components/screen/utils.d.ts

@@ -1,10 +1,11 @@
 import { type ComponentType, type ReactElement } from "react";
-import type { ScreenMargins } from "./types.js";
-export type ListHeaderComponent = ComponentType | ReactElement | null | undefined;
-/** Renders a `ListHeaderComponent`-shaped prop (element, component, or nullish) into an element. */
-export declare function renderListHeader(ListHeaderComponent: ListHeaderComponent): ReactElement | null;
-/** Whether `margins` pads the horizontal axis. */
-export declare const hasXMargin: (margins: ScreenMargins) => boolean;
-/** Whether `margins` pads the vertical axis (the bottom of the content area). */
-export declare const hasYMargin: (margins: ScreenMargins) => boolean;
+import type { ScreenContentPadding, ScreenSafeArea, ScreenSafeAreaEdges } from "./types.js";
+export type ListComponent = ComponentType | ReactElement | null | undefined;
+/** Resolves a list header, footer, or empty component to an element. */
+export declare function renderListComponent(ListComponent: ListComponent): ReactElement | null;
+/** Whether `padding` pads the horizontal axis. */
+export declare const hasHorizontalPadding: (padding: ScreenContentPadding) => boolean;
+/** Whether `padding` pads the vertical axis (top and bottom). */
+export declare const hasVerticalPadding: (padding: ScreenContentPadding) => boolean;
+export declare function resolveSafeAreaEdges(safeArea: ScreenSafeArea): ScreenSafeAreaEdges;
 //# sourceMappingURL=utils.d.ts.map

package/lib/typescript/src/components/screen/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAiC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAE7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAS,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;AAElF,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,YAAY,GAAG,IAAI,CAI9F;AAED,kDAAkD;AAClD,eAAO,MAAM,UAAU,GAAI,SAAS,aAAa,KAAG,OAA+C,CAAC;AAEpG,iFAAiF;AACjF,eAAO,MAAM,UAAU,GAAI,SAAS,aAAa,KAAG,OAA+C,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAiC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAE7F,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAS,CAAC;AAEzF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5E,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAIrF;AAED,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,GAAI,SAAS,oBAAoB,KAAG,OAC/B,CAAC;AAEvC,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,GAAI,SAAS,oBAAoB,KAAG,OAC7B,CAAC;AAEvC,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,mBAAmB,CASlF"}

package/lib/typescript/src/components/text/Text.d.ts

@@ -4,7 +4,7 @@ export type TextAlign = "left" | "center" | "right" | "justify";
 export interface TextProps extends RNTextProps {
     /** Typographic role. Defaults to `body-md`. */
     variant?: TextVariant;
-    /** Semantic color token (e.g. `content.secondary`, `status.danger.solid`). */
+    /** Semantic color token (e.g. `text.secondary`, `danger.soft.fg`). */
     color?: ColorToken;
     /** Override the variant's default weight. */
     weight?: FontWeightToken;

package/lib/typescript/src/components/text/Text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../../../src/components/text/Text.tsx"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,SAAS,IAAI,WAAW,EAAkB,MAAM,cAAc,CAAC;AAI7F,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAGf,WAAW,EACZ,MAAM,cAAc,CAAC;AAKtB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAiBhE,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,+CAA+C;IAC/C,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,uLA6Df,CAAC"}
+{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../../../src/components/text/Text.tsx"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,SAAS,IAAI,WAAW,EAAkB,MAAM,cAAc,CAAC;AAI7F,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAGf,WAAW,EACZ,MAAM,cAAc,CAAC;AAKtB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAiBhE,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,+CAA+C;IAC/C,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,sEAAsE;IACtE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,uLA6Df,CAAC"}

package/lib/typescript/src/components/toolbar/Toolbar.d.ts

@@ -8,7 +8,7 @@ interface ToolbarButtonBaseProps extends Omit<PressableProps, "children" | "styl
     iconSize?: number;
     /**
      * Foreground token for the icon and label. Defaults to the group's `tint`,
-     * or `text.default` outside a group.
+     * or `text.primary` outside a group.
      */
     tint?: ColorToken;
     /**
@@ -58,7 +58,7 @@ export interface ToolbarGroupProps extends ViewProps {
     background?: ColorToken;
     /**
      * Foreground token inherited by every item's icon and label. Defaults to
-     * `text.default`; a per-item `tint` still wins.
+     * `text.primary`; a per-item `tint` still wins.
      */
     tint?: ColorToken;
     children?: ReactNode;

package/lib/typescript/src/context/ThemeProvider.d.ts

@@ -1,6 +1,6 @@
 import { type PropsWithChildren } from "react";
-import { type ResolvedScreenMargin } from "../theme/screen-margin.js";
-import type { Scheme, TerraTheme } from "../theme/types.js";
+import { type ResolvedScreenPadding } from "../theme/screen-padding.js";
+import type { Scheme, TerraTheme, ThemeMode } from "../theme/types.js";
 /**
  * Root provider for Terra UI. Wrap your app once near the root.
  *
@@ -13,25 +13,42 @@ export declare const TerraUIProvider: ({ children }: PropsWithChildren) => impor
 export interface UseThemeResult {
     /** The active resolved theme. */
     theme: TerraTheme;
-    /** Active color scheme. */
+    /**
+     * The currently resolved color scheme — what Unistyles is rendering right
+     * now. Under `mode: "system"` this follows the OS appearance.
+     */
     scheme: Scheme;
-    /** Switch scheme (disables system-adaptive theming). */
+    /** Pin a scheme (stops following the system). Same as `setMode(scheme)`. */
     setScheme: (scheme: Scheme) => void;
-    /** Active accent name, if any. */
+    /** Applied accent name, or `undefined` for the base themes. */
     accent: string | undefined;
-    /** Switch to a registered accent. */
-    setAccent: (name: string) => void;
+    /**
+     * Apply a registered accent; `null` restores the base themes. An unknown
+     * name warns in development and leaves the accent unchanged.
+     */
+    setAccent: (name: string | null) => void;
+    /**
+     * How the active scheme is chosen: `system` follows the OS appearance,
+     * `light` / `dark` pin a scheme. A system appearance change updates
+     * `scheme`, never `mode`.
+     */
+    mode: ThemeMode;
+    /** Change the theme mode; `setMode("system")` returns to the OS preference. */
+    setMode: (mode: ThemeMode) => void;
 }
 /**
- * Access the active theme and switch scheme / accent / radius.
- * Must be used under {@link TerraUIProvider}.
+ * Access the active theme and switch scheme / mode / accent. Selection state
+ * comes from the runtime store, so changes made imperatively (`applyAccent`,
+ * `setThemeMode`) and through this hook are observed by every consumer.
  */
 export declare function useTheme(): UseThemeResult;
 /**
- * Resolves `theme.layout.screen.margin` for the current runtime breakpoint.
+ * Resolves `theme.layout.screen.padding` for the current runtime breakpoint.
  * For use outside a `StyleSheet.create` factory (e.g. plain-JS layout maths);
- * inside one, call `resolveScreenMargin(theme, rt.breakpoint)` directly so
+ * inside one, call `resolveScreenPadding(theme, rt.breakpoint)` directly so
  * the value stays reactive without a React re-render.
  */
-export declare function useScreenMargin(): ResolvedScreenMargin;
+export declare function useScreenPadding(): ResolvedScreenPadding;
+/** @deprecated Use useScreenPadding. */
+export declare const useScreenMargin: typeof useScreenPadding;
 //# sourceMappingURL=ThemeProvider.d.ts.map

package/lib/typescript/src/context/ThemeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/context/ThemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,iBAAiB,EAA8C,MAAM,OAAO,CAAC;AAO1G,OAAO,EAAE,KAAK,oBAAoB,EAAuB,MAAM,2BAAwB,CAAC;AACxF,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAgB,CAAC;AAczD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,iBAAiB,gCAe9D,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,kCAAkC;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qCAAqC;IACrC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAezC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,oBAAoB,CAGtD"}
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/context/ThemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,OAAO,CAAC;AAarE,OAAO,EAAE,KAAK,qBAAqB,EAAwB,MAAM,4BAAyB,CAAC;AAC3F,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAgB,CAAC;AAOpE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,iBAAiB,gCAE9D,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,+DAA+D;IAC/D,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC;;;;OAIG;IACH,IAAI,EAAE,SAAS,CAAC;IAChB,+EAA+E;IAC/E,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAazC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAGxD;AAED,wCAAwC;AACxC,eAAO,MAAM,eAAe,yBAAmB,CAAC"}

package/lib/typescript/src/context/index.d.ts

@@ -1,3 +1,3 @@
 export type { UseThemeResult } from "./ThemeProvider.js";
-export { TerraUIProvider, useScreenMargin, useTheme } from "./ThemeProvider.js";
+export { TerraUIProvider, useScreenMargin, useScreenPadding, useTheme } from "./ThemeProvider.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/context/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/context/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAiB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/context/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAiB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAiB,CAAC"}

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

@@ -18,7 +18,7 @@ declare module "react-native-unistyles" {
     }
 }
 /**
- * Resolves a per-breakpoint record (e.g. `theme.layout.screen.margin.x`) to
+ * Resolves a per-breakpoint record (e.g. `theme.layout.screen.padding.x`) to
  * the value for the current runtime breakpoint (`rt.breakpoint`). A
  * `StyleSheet.create` factory re-runs on breakpoint change, so calling this
  * inside one keeps the resolved value reactive.

package/lib/typescript/src/theme/define-config.d.ts

@@ -0,0 +1,23 @@
+import type { TerraConfig } from "./types.js";
+/** The literal accent names declared in `T.accents`, or `never` when none are declared. */
+type DeclaredAccentNames<T> = T extends {
+    accents: infer A;
+} ? A extends Record<string, unknown> ? keyof A & string : never : never;
+/**
+ * Identity helper for authoring a {@link TerraConfig} with contextual typing.
+ * Has no side effects. With literal `accents`, `defaultAccent` must name one of
+ * them; a dynamic `Record<string, Accent>` keeps `defaultAccent` as `string`
+ * and defers to runtime validation.
+ *
+ * @example
+ * const config = defineTerraConfig({
+ *   accents: { indigo: { light: "#4f46e5", dark: "#818cf8" } },
+ *   defaultAccent: "indigo",
+ * });
+ * configureTerraUI(config);
+ */
+export declare function defineTerraConfig<const T extends TerraConfig>(config: T & {
+    defaultAccent?: DeclaredAccentNames<T>;
+}): T;
+export {};
+//# sourceMappingURL=define-config.d.ts.map

package/lib/typescript/src/theme/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../../../src/theme/define-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAS,CAAC;AAE3C,2FAA2F;AAC3F,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAC,CAAA;CAAE,GACxD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,GAAG,MAAM,GAChB,KAAK,GACP,KAAK,CAAC;AAEV;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EAC3D,MAAM,EAAE,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAAE,GACrD,CAAC,CAEH"}

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

@@ -0,0 +1,4 @@
+import type { ContrastDiagnostic } from "../utils/accent-generator";
+/** Reports each distinct contrast diagnostic once per resolution. */
+export declare function warnContrastDiagnostics(diagnostics: readonly ContrastDiagnostic[]): void;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../src/theme/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,CAOxF"}

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

@@ -0,0 +1,10 @@
+/**
+ * Thrown for invalid pure configuration input — before any registry, selection,
+ * or native state is touched. `path` points at the offending config entry, e.g.
+ * `accents.indigo.dark.seed` or `defaultAccent`.
+ */
+export declare class TerraConfigError extends Error {
+    readonly path: string;
+    constructor(path: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/theme/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C"}

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

@@ -1,3 +1,5 @@
+export type { AccentGenerationContext, AccentGenerationResult, AccentSurfaceRole, ContrastDiagnostic, ContrastDiagnosticKind, GeneratedAccentRole, } from "../utils/accent-generator";
+export { checkAccentContrast, generateAccentColors, isSupportedAccentSeed, } from "../utils/accent-generator";
 export { normalizeAccent } from "../utils/accent-utils";
 export { readableOn, shade, withAlpha } from "../utils/color-utils";
 export type { DeepPartial } from "../utils/deep-merge";
@@ -6,10 +8,16 @@ export { resolveThemeColor } from "../utils/resolve-theme-color";
 export { FONT_WEIGHT_VALUE, SYSTEM_FONT } from "../utils/typography";
 export type { AppBreakpoints, BreakpointName } from "./breakpoints.js";
 export { breakpoints, resolveBreakpointValue } from "./breakpoints.js";
+export { defineTerraConfig } from "./define-config.js";
+export { TerraConfigError } from "./errors.js";
 export { configureTerraUI, getAccentNames, getDefaultRadius, getIcon, getImageComponent, getIsConfigured, getRequiredIcon, getSurfaceElevation, resolveTheme, } from "./registry.js";
-export { applyAccent, applyScheme, getCurrentAccent } from "./runtime.js";
+export { createTerraThemes } from "./resolve-config.js";
+export type { ThemeSelection } from "./runtime.js";
+export { applyAccent, applyScheme, getCurrentAccent, getThemeMode, getThemeSelection, setThemeMode, } from "./runtime.js";
 export type { ResolvedScreenMargin } from "./screen-margin.js";
 export { resolveScreenMargin } from "./screen-margin.js";
+export type { ResolvedScreenPadding } from "./screen-padding.js";
+export { resolveScreenPadding } from "./screen-padding.js";
 export { defaultDarkTheme, defaultLightTheme } from "./theme.js";
-export type { Accent, AccentOverride, AccentShorthand, ActionColorToken, BackgroundColorToken, BorderColorToken, ButtonDefaults, ColorToken, ComponentDefaults, ContentColorToken, DefaultRadiusToken, ElevationKey, ElevationScale, ElevationStyle, FontWeightToken, LayoutTokens, OpacityTokens, RadiusComponent, RadiusKey, Scheme, SpacingKey, StatusColorToken, SurfaceColorToken, SurfaceDefaults, TerraConfig, TerraIconComponent, TerraIconName, TerraIconProps, TerraImageComponent, TerraImageContentFit, TerraImageProps, TerraSemanticIconName, TerraTheme, TerraThemeOverride, TextColorToken, TextVariant, ThemeColor, ThemeRadiusOverride, TypeStyle, Typography, } from "./types.js";
+export type { Accent, AccentColorToken, AccentOverride, AccentSchemeInput, AccentSeed, AccentShorthand, ActionColorToken, BackgroundColorToken, BorderColorToken, ButtonDefaults, CanonicalThemeColor, ColorToken, ComponentDefaults, ContentColorToken, CreateTerraThemesOptions, DefaultRadiusToken, ElevationKey, ElevationScale, ElevationStyle, FontWeightToken, LayoutTokens, NeutralColorToken, OpacityTokens, RadiusComponent, RadiusKey, Scheme, ScreenPaddingTokens, SpacingKey, StatusColorToken, SurfaceColorToken, SurfaceDefaults, TerraColorRegistry, TerraColorRegistryCollision, TerraConfig, TerraCustomColorName, TerraIconComponent, TerraIconName, TerraIconProps, TerraImageComponent, TerraImageContentFit, TerraImageProps, TerraSemanticIconName, TerraTheme, TerraThemeInput, TerraThemeOverride, TextColorToken, TextVariant, ThemeColor, ThemeMode, ThemeRadiusOverride, ThemeSpacingOverride, TypeStyle, Typography, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAe,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,kBAAe,CAAC;AAEpE,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,eAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAW,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAiB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAiB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAS,CAAC;AAE9D,YAAY,EACV,MAAM,EACN,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,SAAS,EACT,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,UAAU,GACX,MAAM,YAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.ts"],"names":[],"mappings":"AAQA,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAe,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,kBAAe,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAU,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,eAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAkB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAW,CAAC;AAChD,OAAO,EACL,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACb,MAAM,cAAW,CAAC;AACnB,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAiB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAiB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAkB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAkB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAS,CAAC;AAE9D,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,SAAS,EACT,MAAM,EACN,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,2BAA2B,EAC3B,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EACT,UAAU,GACX,MAAM,YAAS,CAAC"}

package/lib/typescript/src/theme/legacy-tokens.d.ts

@@ -0,0 +1,187 @@
+import type { CanonicalThemeColor, TerraTheme, TerraThemeOverride } from "./types.js";
+/** Legacy color names. Explicit action/status-property aliases come first to resolve synonyms. */
+export declare const legacyColorAliases: {
+    readonly "action.bg.primary": "accent.solid.bg";
+    readonly "action.bg.primary.active": "accent.solid.bg.pressed";
+    readonly "action.bg.primary.disabled": "accent.solid.bg.disabled";
+    readonly "action.bg.primary.hover": "accent.solid.bg.hover";
+    readonly "action.bg.primary.subtle": "accent.soft.bg";
+    readonly "action.bg.primary.subtle.active": "accent.soft.bg.pressed";
+    readonly "action.bg.primary.subtle.disabled": "accent.soft.bg.disabled";
+    readonly "action.bg.primary.subtle.hover": "accent.soft.bg.hover";
+    readonly "action.bg.secondary": "neutral.solid.bg";
+    readonly "action.bg.secondary.subtle": "neutral.soft.bg";
+    readonly "action.bg.secondary.subtle.active": "neutral.soft.bg.pressed";
+    readonly "action.bg.secondary.subtle.disabled": "neutral.soft.bg.disabled";
+    readonly "action.bg.secondary.subtle.hover": "neutral.soft.bg.hover";
+    readonly "action.fg.primary": "accent.solid.fg";
+    readonly "action.fg.primary.subtle": "accent.soft.fg";
+    readonly "action.fg.secondary": "neutral.solid.fg";
+    readonly "action.fg.secondary.subtle": "neutral.soft.fg";
+    readonly "status.danger.bg": "danger.solid.bg";
+    readonly "status.danger.bg.subtle": "danger.soft.bg";
+    readonly "status.danger.border": "danger.solid.border";
+    readonly "status.danger.border.subtle": "danger.soft.border";
+    readonly "status.danger.fg": "danger.solid.fg";
+    readonly "status.danger.fg.subtle": "danger.soft.fg";
+    readonly "status.info.bg": "info.solid.bg";
+    readonly "status.info.bg.subtle": "info.soft.bg";
+    readonly "status.info.border": "info.solid.border";
+    readonly "status.info.border.subtle": "info.soft.border";
+    readonly "status.info.fg": "info.solid.fg";
+    readonly "status.info.fg.subtle": "info.soft.fg";
+    readonly "status.success.bg": "success.solid.bg";
+    readonly "status.success.bg.subtle": "success.soft.bg";
+    readonly "status.success.border": "success.solid.border";
+    readonly "status.success.border.subtle": "success.soft.border";
+    readonly "status.success.fg": "success.solid.fg";
+    readonly "status.success.fg.subtle": "success.soft.fg";
+    readonly "status.warning.bg": "warning.solid.bg";
+    readonly "status.warning.bg.subtle": "warning.soft.bg";
+    readonly "status.warning.border": "warning.solid.border";
+    readonly "status.warning.border.subtle": "warning.soft.border";
+    readonly "status.warning.fg": "warning.solid.fg";
+    readonly "status.warning.fg.subtle": "warning.soft.fg";
+    readonly background: "surface.canvas";
+    readonly "border.accent": "accent.border";
+    readonly "border.focus": "focus.ring";
+    readonly "status.danger": "danger.solid.bg";
+    readonly "status.info": "info.solid.bg";
+    readonly "status.success": "success.solid.bg";
+    readonly "status.warning": "warning.solid.bg";
+    readonly "surface.accent": "accent.solid.bg";
+    readonly "surface.accent.subtle": "accent.soft.bg";
+    readonly "surface.overlay": "backdrop";
+    readonly "text.accent": "accent.text";
+    readonly "text.default": "text.primary";
+    readonly "text.muted": "text.secondary";
+    readonly "text.on-accent": "accent.solid.fg";
+    readonly "text.on-accent-subtle": "accent.soft.fg";
+    readonly "text.subtle": "text.tertiary";
+};
+export interface LegacyThemeColor {
+    /** @deprecated Use `accent.solid.bg`. */
+    "action.bg.primary": string;
+    /** @deprecated Use `accent.solid.bg.pressed`. */
+    "action.bg.primary.active": string;
+    /** @deprecated Use `accent.solid.bg.disabled`. */
+    "action.bg.primary.disabled": string;
+    /** @deprecated Use `accent.solid.bg.hover`. */
+    "action.bg.primary.hover": string;
+    /** @deprecated Use `accent.soft.bg`. */
+    "action.bg.primary.subtle": string;
+    /** @deprecated Use `accent.soft.bg.pressed`. */
+    "action.bg.primary.subtle.active": string;
+    /** @deprecated Use `accent.soft.bg.disabled`. */
+    "action.bg.primary.subtle.disabled": string;
+    /** @deprecated Use `accent.soft.bg.hover`. */
+    "action.bg.primary.subtle.hover": string;
+    /** @deprecated Use `neutral.solid.bg`. */
+    "action.bg.secondary": string;
+    /** @deprecated Use `neutral.soft.bg`. */
+    "action.bg.secondary.subtle": string;
+    /** @deprecated Use `neutral.soft.bg.pressed`. */
+    "action.bg.secondary.subtle.active": string;
+    /** @deprecated Use `neutral.soft.bg.disabled`. */
+    "action.bg.secondary.subtle.disabled": string;
+    /** @deprecated Use `neutral.soft.bg.hover`. */
+    "action.bg.secondary.subtle.hover": string;
+    /** @deprecated Use `accent.solid.fg`. */
+    "action.fg.primary": string;
+    /** @deprecated Use `accent.soft.fg`. */
+    "action.fg.primary.subtle": string;
+    /** @deprecated Use `neutral.solid.fg`. */
+    "action.fg.secondary": string;
+    /** @deprecated Use `neutral.soft.fg`. */
+    "action.fg.secondary.subtle": string;
+    /** @deprecated Use `danger.solid.bg`. */
+    "status.danger.bg": string;
+    /** @deprecated Use `danger.soft.bg`. */
+    "status.danger.bg.subtle": string;
+    /** @deprecated Use `danger.solid.border`. */
+    "status.danger.border": string;
+    /** @deprecated Use `danger.soft.border`. */
+    "status.danger.border.subtle": string;
+    /** @deprecated Use `danger.solid.fg`. */
+    "status.danger.fg": string;
+    /** @deprecated Use `danger.soft.fg`. */
+    "status.danger.fg.subtle": string;
+    /** @deprecated Use `info.solid.bg`. */
+    "status.info.bg": string;
+    /** @deprecated Use `info.soft.bg`. */
+    "status.info.bg.subtle": string;
+    /** @deprecated Use `info.solid.border`. */
+    "status.info.border": string;
+    /** @deprecated Use `info.soft.border`. */
+    "status.info.border.subtle": string;
+    /** @deprecated Use `info.solid.fg`. */
+    "status.info.fg": string;
+    /** @deprecated Use `info.soft.fg`. */
+    "status.info.fg.subtle": string;
+    /** @deprecated Use `success.solid.bg`. */
+    "status.success.bg": string;
+    /** @deprecated Use `success.soft.bg`. */
+    "status.success.bg.subtle": string;
+    /** @deprecated Use `success.solid.border`. */
+    "status.success.border": string;
+    /** @deprecated Use `success.soft.border`. */
+    "status.success.border.subtle": string;
+    /** @deprecated Use `success.solid.fg`. */
+    "status.success.fg": string;
+    /** @deprecated Use `success.soft.fg`. */
+    "status.success.fg.subtle": string;
+    /** @deprecated Use `warning.solid.bg`. */
+    "status.warning.bg": string;
+    /** @deprecated Use `warning.soft.bg`. */
+    "status.warning.bg.subtle": string;
+    /** @deprecated Use `warning.solid.border`. */
+    "status.warning.border": string;
+    /** @deprecated Use `warning.soft.border`. */
+    "status.warning.border.subtle": string;
+    /** @deprecated Use `warning.solid.fg`. */
+    "status.warning.fg": string;
+    /** @deprecated Use `warning.soft.fg`. */
+    "status.warning.fg.subtle": string;
+    /** @deprecated Use `surface.canvas`. */
+    "background": string;
+    /** @deprecated Use `accent.border`. */
+    "border.accent": string;
+    /** @deprecated Use `focus.ring`. */
+    "border.focus": string;
+    /** @deprecated Use `danger.solid.bg`. */
+    "status.danger": string;
+    /** @deprecated Use `info.solid.bg`. */
+    "status.info": string;
+    /** @deprecated Use `success.solid.bg`. */
+    "status.success": string;
+    /** @deprecated Use `warning.solid.bg`. */
+    "status.warning": string;
+    /** @deprecated Use `accent.solid.bg`. */
+    "surface.accent": string;
+    /** @deprecated Use `accent.soft.bg`. */
+    "surface.accent.subtle": string;
+    /** @deprecated Use `backdrop`. */
+    "surface.overlay": string;
+    /** @deprecated Use `accent.text`. */
+    "text.accent": string;
+    /** @deprecated Use `text.primary`. */
+    "text.default": string;
+    /** @deprecated Use `text.secondary`. */
+    "text.muted": string;
+    /** @deprecated Use `accent.solid.fg`. */
+    "text.on-accent": string;
+    /** @deprecated Use `accent.soft.fg`. */
+    "text.on-accent-subtle": string;
+    /** @deprecated Use `text.tertiary`. */
+    "text.subtle": string;
+}
+/** Normalize each authored layer before merging, so aliases respect layer precedence. */
+export declare function normalizeTokenOverride(override?: TerraThemeOverride): TerraThemeOverride | undefined;
+/** Materialize aliases for direct theme reads as well as component color props. */
+export declare function withLegacyTokens(theme: Omit<TerraTheme, "color" | "layout"> & {
+    color: CanonicalThemeColor;
+    layout: Omit<TerraTheme["layout"], "screen"> & {
+        screen: Pick<TerraTheme["layout"]["screen"], "padding">;
+    };
+}): TerraTheme;
+//# sourceMappingURL=legacy-tokens.d.ts.map

package/lib/typescript/src/theme/legacy-tokens.d.ts.map

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

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

@@ -1,25 +1,12 @@
-import type { DefaultRadiusToken, ElevationKey, NormalizedAccent, RadiusComponent, Scheme, TerraConfig, TerraIconComponent, TerraImageComponent, TerraSemanticIconName, TerraTheme } from "./types.js";
-type ResolvedRadius = Record<RadiusComponent, DefaultRadiusToken>;
+import type { DefaultRadiusToken, ElevationKey, RadiusComponent, Scheme, TerraConfig, TerraIconComponent, TerraImageComponent, TerraSemanticIconName, TerraTheme } from "./types.js";
 declare module "react-native-unistyles" {
     interface UnistylesThemes {
         light: TerraTheme;
         dark: TerraTheme;
     }
 }
-interface Registry {
-    baseLight: TerraTheme;
-    baseDark: TerraTheme;
-    accents: Record<string, NormalizedAccent>;
-    currentAccent?: string;
-    defaultRadius: ResolvedRadius;
-    surfaceElevation: ElevationKey;
-    icons: Record<string, TerraIconComponent>;
-    imageComponent: TerraImageComponent;
-    configured: boolean;
-}
-/** @internal */
-export declare const getRegistry: () => Registry;
 export declare const getIsConfigured: () => boolean;
+/** Names of the registered accents, in declaration order. Returns a fresh array. */
 export declare const getAccentNames: () => string[];
 export declare const getImageComponent: () => TerraImageComponent;
 export declare const getIcon: (name: string) => TerraIconComponent | undefined;
@@ -34,13 +21,22 @@ export declare const getDefaultRadius: (component: RadiusComponent) => DefaultRa
  * Set via {@link configureTerraUI}; defaults to `'none'`.
  */
 export declare const getSurfaceElevation: () => ElevationKey;
-/** Resolves a scheme's theme = base ⊕ the named accent's partial override. */
+/**
+ * Resolves one scheme's theme from the installed configuration with the named
+ * accent overlaid. Omitting `accentName` selects the base theme (no accent —
+ * not the configured `defaultAccent`). An unknown name warns in development
+ * and falls back to the base theme. Pure with respect to runtime state: it
+ * never changes the applied selection.
+ */
 export declare function resolveTheme(scheme: Scheme, accentName?: string): TerraTheme;
 /**
  * Configure Terra UI's themes. Call ONCE, as early as possible — before any
  * component renders (e.g. top of the app entry, imported from
  * `react-native-terra-ui/theme`). With no arguments it registers the default
  * theme; `<TerraUIProvider>` calls it for you if you haven't.
+ *
+ * Invalid input throws {@link TerraConfigError} before anything is installed,
+ * so a corrected retry is still the app's one configure call.
  */
 export declare function configureTerraUI(config?: TerraConfig): void;
 /**
@@ -56,5 +52,4 @@ export declare function configureTerraUI(config?: TerraConfig): void;
  * @internal
  */
 export declare function bootstrapTerraUI(): void;
-export {};
 //# sourceMappingURL=registry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/theme/registry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EAEX,MAAM,YAAS,CAAC;AASjB,KAAK,cAAc,GAAG,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;AASlE,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAiB,eAAe;QAC9B,KAAK,EAAE,UAAU,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC;KAClB;CACF;AAED,UAAU,QAAQ;IAChB,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,cAAc,CAAC;IAC9B,gBAAgB,EAAE,YAAY,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC1C,cAAc,EAAE,mBAAmB,CAAC;IACpC,UAAU,EAAE,OAAO,CAAC;CACrB;AAcD,gBAAgB;AAChB,eAAO,MAAM,WAAW,QAAO,QAAoB,CAAC;AAEpD,eAAO,MAAM,eAAe,QAAO,OAA8B,CAAC;AAElE,eAAO,MAAM,cAAc,QAAO,MAAM,EAAmC,CAAC;AAE5E,eAAO,MAAM,iBAAiB,QAAO,mBAA8C,CAAC;AAEpF,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,kBAAkB,GAAG,SACS,CAAC;AAEtE,eAAO,MAAM,eAAe,GAAI,MAAM,qBAAqB,KAAG,kBAClB,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,eAAe,KAAG,kBAC3B,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,YAAyC,CAAC;AAEjF,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAI5E;AAwCD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,WAAgB,GAAG,IAAI,CAY/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/theme/registry.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEV,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,MAAM,EACN,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EAGX,MAAM,YAAS,CAAC;AAmBjB,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAiB,eAAe;QAC9B,KAAK,EAAE,UAAU,CAAC;QAClB,IAAI,EAAE,UAAU,CAAC;KAClB;CACF;AA8BD,eAAO,MAAM,eAAe,QAAO,OAA0C,CAAC;AAE9E,oFAAoF;AACpF,eAAO,MAAM,cAAc,QAAO,MAAM,EAA2C,CAAC;AAEpF,eAAO,MAAM,iBAAiB,QAAO,mBAA8C,CAAC;AAEpF,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,kBAAkB,GAAG,SACS,CAAC;AAEtE,eAAO,MAAM,eAAe,GAAI,MAAM,qBAAqB,KAAG,kBAClB,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,eAAe,KAAG,kBAC3B,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,YAAyC,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAW5E;AAID;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,WAAgB,GAAG,IAAI,CAW/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC"}