pixelize-native-library 1.2.1 → 1.3.0

package/lib/typescript/modules/stage-progress/StageProgress.variants.d.ts

@@ -1,13 +1,20 @@
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, Theme } from "../../theme/hooks";
-export type StageProgressVariant = "pills" | "bar" | "stepper";
+export type StageProgressVariant = "pills" | "bar" | "stepper" | "chevron";
+export type StageProgressSize = "sm" | "md" | "lg";
+export type StageProgressColorScheme = "default" | "neutral";
 export type StageState = "completed" | "active" | "upcoming";
+export { MIN_TOUCH_TARGET };
+export declare const STAGE_PROGRESS_SIZES: Record<StageProgressSize, {
+    readonly labelFontSize: number;
+    readonly stepLabelFontSize: number;
+    readonly pillMinWidth: number;
+}>;
 export interface StageProgressStage {
     readonly id: string;
     readonly label: string;
     readonly disabled?: boolean;
 }
-/** WCAG 2.5.5 target size, the library-wide floor (`Tabs`/`Pagination`/`Reorder` all pin the same 44). */
-export declare const MIN_TOUCH_TARGET = 44;
 /**
  * Floor for the pill's height. The pill sizes itself from padding + its label's font metrics, so
  * without a floor there is no number the touch-target maths can be proven against; pinned here at
@@ -81,8 +88,13 @@ export interface StageProgressColors {
     readonly upcomingFill: string;
     readonly upcomingText: string;
 }
-export declare function resolveStageProgressColors(colors: RoleColors): StageProgressColors;
+export declare function resolveStageProgressColors(colors: RoleColors, colorScheme?: StageProgressColorScheme): StageProgressColors;
 export declare const stageProgressRowStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
+export declare function resolveStagePillLayout(theme: Theme, size: StageProgressSize, minStageWidth?: number): {
+    paddingHorizontal: number;
+    paddingVertical: number;
+    minWidth: number;
+};
 export declare const stagePillStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
 /**
  * The keyboard/AT focus ring for an interactive stage, drawn INSIDE the stage's own bounds:

package/lib/typescript/modules/stage-progress/StageProgressProps.d.ts

@@ -0,0 +1,22 @@
+import type { LayoutStyle } from "../../core/style";
+import type { StageProgressColorScheme, StageProgressSize, StageProgressStage, StageProgressVariant } from "./StageProgress.variants";
+/** Horizontal pipeline stages, rendered as pills, a bar, or a stepper. */
+export interface StageProgressProps {
+    stages: readonly StageProgressStage[];
+    value: string;
+    variant?: StageProgressVariant;
+    size?: StageProgressSize;
+    /** Alternate fill palette; `neutral` uses ink-on-surface instead of accent/success ramps. */
+    colorScheme?: StageProgressColorScheme;
+    /** Replaces the active stage label with a spinner and sets `aria-busy` on the row. */
+    isLoading?: boolean;
+    /** Minimum pill width; defaults from `size`. */
+    minStageWidth?: number;
+    readOnly?: boolean;
+    /** Stages render plain, non-focusable `View`s whenever this is omitted, regardless of `readOnly`. */
+    onStagePress?: (stageId: string) => void;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=StageProgressProps.d.ts.map

package/lib/typescript/modules/stage-progress/index.d.ts

@@ -1,4 +1,4 @@
 export { StageProgress } from "./StageProgress";
-export type { StageProgressProps } from "./StageProgress";
+export type { StageProgressProps } from "./StageProgressProps";
 export type { StageProgressStage, StageProgressVariant, StageState, } from "./StageProgress.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/stat-grid/StatGrid.d.ts

@@ -0,0 +1,3 @@
+import type { StatGridProps } from "./StatGridProps";
+export declare const StatGrid: import("react").NamedExoticComponent<StatGridProps>;
+//# sourceMappingURL=StatGrid.d.ts.map

package/lib/typescript/modules/stat-grid/StatGridProps.d.ts

@@ -0,0 +1,15 @@
+import type { LayoutStyle } from "../../core/style";
+/** One KPI cell in a stat grid. */
+export interface StatGridItem {
+    readonly label: string;
+    readonly value: string | number;
+}
+/** Responsive grid of labeled metrics. */
+export interface StatGridProps {
+    items: readonly StatGridItem[];
+    /** Number of columns on wide layouts; defaults to 2. */
+    columns?: 2 | 3;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=StatGridProps.d.ts.map

package/lib/typescript/modules/stat-grid/index.d.ts

@@ -0,0 +1,3 @@
+export { StatGrid } from "./StatGrid";
+export type { StatGridItem, StatGridProps } from "./StatGridProps";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/stat-tile/StatTile.d.ts

@@ -2,19 +2,6 @@
  * StatTile — a labelled metric. The value fades back in whenever it changes, so a live-updating
  * dashboard reads as a transition rather than a silent swap; the first render never animates.
  */
-import type { ReactNode } from "react";
-import type { LayoutStyle } from "../../core/style";
-import type { StatTileTone } from "./StatTile.variants";
-export interface StatTileProps {
-    label: string;
-    value: string | number;
-    icon?: ReactNode;
-    tone?: StatTileTone;
-    onPress?: () => void;
-    loading?: boolean;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { StatTileProps } from "./StatTileProps";
 export declare const StatTile: import("react").NamedExoticComponent<StatTileProps>;
 //# sourceMappingURL=StatTile.d.ts.map

package/lib/typescript/modules/stat-tile/StatTile.variants.d.ts

@@ -4,6 +4,9 @@
  */
 import type { RoleColors, StatusRole, Theme } from "../../theme/hooks";
 export type StatTileTone = "accent" | "neutral" | StatusRole;
+export type StatTileTrend = "up" | "down" | "flat";
+export type StatTileGoodDirection = "up" | "down";
+export declare function resolveStatTileDeltaColor(colors: RoleColors, trend: StatTileTrend, goodDirection: StatTileGoodDirection): string;
 export interface StatTileColors {
     readonly background: string;
     readonly pressed: string;

package/lib/typescript/modules/stat-tile/StatTileProps.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from "react";
+import type { LayoutStyle } from "../../core/style";
+import type { StatTileTone, StatTileTrend, StatTileGoodDirection } from "./StatTile.variants";
+/** A labelled metric card. */
+export interface StatTileProps {
+    label: string;
+    value: string | number;
+    icon?: ReactNode;
+    /** Defaults to "accent". */
+    tone?: StatTileTone;
+    /** Renders the tile as a `Pressable` instead of a plain `View` when set. */
+    onPress?: () => void;
+    /** Shows a skeleton in place of `value`; `delta` is hidden while true. */
+    loading?: boolean;
+    /** Change vs prior period, e.g. "+12%". */
+    delta?: string;
+    /** Colours `delta` against `goodDirection`. Defaults to "flat" (neutral colour). */
+    trend?: StatTileTrend;
+    /** Whether an upward trend is good (revenue) or bad (churn). */
+    goodDirection?: StatTileGoodDirection;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=StatTileProps.d.ts.map

package/lib/typescript/modules/stat-tile/index.d.ts

@@ -4,6 +4,6 @@
  * through its props, never by importing its internals.
  */
 export { StatTile } from "./StatTile";
-export type { StatTileProps } from "./StatTile";
+export type { StatTileProps } from "./StatTileProps";
 export type { StatTileTone } from "./StatTile.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/state-block/StateBlock.d.ts

@@ -18,38 +18,7 @@
  * loading → error → content is a transition rather than a jump cut. `useEnterExit` skips the enter
  * for a block that mounts already visible, so the default is behaviourally unchanged.
  */
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-import type { SpinnerSize, SpinnerTone } from "../spinner/Spinner.variants";
-export interface LoadingStateProps {
-    message?: string;
-    size?: SpinnerSize;
-    tone?: SpinnerTone;
-    /** Expands to fill and centre in a flex parent (e.g. a list empty slot). */
-    fill?: boolean;
-    /** Fades and slides the block out when set to `false`, then unmounts it. */
-    visible?: boolean;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
-export interface ErrorStateAction {
-    readonly label: string;
-    readonly onPress: () => void;
-}
-export interface ErrorStateProps {
-    icon?: IconName;
-    title: string;
-    description?: string;
-    action?: ErrorStateAction;
-    /** Expands to fill and centre in a flex parent (e.g. a list empty slot). */
-    fill?: boolean;
-    /** Fades and slides the block out when set to `false`, then unmounts it. */
-    visible?: boolean;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { ErrorStateProps, LoadingStateProps } from "./StateBlockProps";
 export declare const LoadingState: import("react").NamedExoticComponent<LoadingStateProps>;
 export declare const ErrorState: import("react").NamedExoticComponent<ErrorStateProps>;
 //# sourceMappingURL=StateBlock.d.ts.map

package/lib/typescript/modules/state-block/StateBlockProps.d.ts

@@ -0,0 +1,36 @@
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+import type { SpinnerSize, SpinnerTone } from "../spinner/Spinner.variants";
+/** Centred loading placeholder composing this library's own `Spinner`. */
+export interface LoadingStateProps {
+    message?: string;
+    size?: SpinnerSize;
+    tone?: SpinnerTone;
+    /** Expands to fill and centre in a flex parent (e.g. a list empty slot). */
+    fill?: boolean;
+    /** Fades and slides the block out when set to `false`, then unmounts it. */
+    visible?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+/** A single retry action rendered as a `Button`. */
+export interface ErrorStateAction {
+    readonly label: string;
+    readonly onPress: () => void;
+}
+/** Centred error placeholder with an optional icon, description and retry action. */
+export interface ErrorStateProps {
+    icon?: IconName;
+    title: string;
+    description?: string;
+    action?: ErrorStateAction;
+    /** Expands to fill and centre in a flex parent (e.g. a list empty slot). */
+    fill?: boolean;
+    /** Fades and slides the block out when set to `false`, then unmounts it. */
+    visible?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=StateBlockProps.d.ts.map

package/lib/typescript/modules/state-block/index.d.ts

@@ -4,7 +4,7 @@
  * their props, never by importing internals.
  */
 export { LoadingState, ErrorState } from "./StateBlock";
-export type { LoadingStateProps, ErrorStateProps, ErrorStateAction } from "./StateBlock";
+export type { LoadingStateProps, ErrorStateProps, ErrorStateAction } from "./StateBlockProps";
 export type { SpinnerSize, SpinnerTone } from "../spinner/Spinner.variants";
 export type { IconName } from "../../core/icon";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/stepper/Stepper.d.ts

@@ -11,20 +11,12 @@
  * label rather than centered between two circles' worth of connector.
  *
  * Advancing `activeStep` settles the newly-active circle with a small scale (`core/motion`). One
- * shared `Animated.Value` drives it — the connectors change colour, which cannot run on the native
- * driver, so they stay static.
+ * shared value drives it — the connectors change colour, which cannot run on the native driver, so
+ * they stay static.
  */
-import type { LayoutStyle } from "../../core/style";
+import type { StepperProps } from "./StepperProps";
 export interface StepperStep {
     readonly label: string;
 }
-export interface StepperProps {
-    steps: StepperStep[];
-    /** 0-indexed: `0` is the first step. */
-    activeStep: number;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
 export declare const Stepper: import("react").NamedExoticComponent<StepperProps>;
 //# sourceMappingURL=Stepper.d.ts.map

package/lib/typescript/modules/stepper/Stepper.variants.d.ts

@@ -16,7 +16,9 @@
  * Free of React and of any lucide import, so the WCAG + behaviour tests import it directly (mocking
  * only `react-native`'s `StyleSheet`, as `core/style` and `Button.variants.ts` do).
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, Theme } from "../../theme/hooks";
+export { MIN_TOUCH_TARGET };
 export type StepState = "completed" | "active" | "upcoming";
 /**
  * Visual diameter of a step's numbered circle, in dp. Not a touch target — Stepper is a v1

package/lib/typescript/modules/stepper/StepperProps.d.ts

@@ -0,0 +1,12 @@
+import type { LayoutStyle } from "../../core/style";
+import type { StepperStep } from "./Stepper";
+/** Horizontal, read-only, multi-step progress display. */
+export interface StepperProps {
+    steps: StepperStep[];
+    /** 0-indexed: `0` is the first step. */
+    activeStep: number;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=StepperProps.d.ts.map

package/lib/typescript/modules/stepper/index.d.ts

@@ -4,5 +4,6 @@
  * internal — a consumer configures a Stepper through its props, never by importing its internals.
  */
 export { Stepper } from "./Stepper";
-export type { StepperProps, StepperStep } from "./Stepper";
+export type { StepperStep } from "./Stepper";
+export type { StepperProps } from "./StepperProps";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/surface/Surface.d.ts

@@ -1,17 +1,4 @@
-import type { ReactNode } from "react";
-import type { LayoutStyle } from "../../core/style";
-import type { ElevationLevel } from "../../theme/tokens";
-import type { BgRole, BorderRole, RadiusToken, SpaceToken } from "./Surface.variants";
-export interface SurfaceProps {
-    background?: BgRole;
-    border?: BorderRole;
-    radius?: RadiusToken;
-    elevation?: ElevationLevel;
-    padding?: SpaceToken;
-    children?: ReactNode;
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { SurfaceProps } from "./SurfaceProps";
 declare function SurfaceImpl({ background, border, radius, elevation, padding, children, style, testID, }: SurfaceProps): import("react").JSX.Element;
 export declare const Surface: import("react").MemoExoticComponent<typeof SurfaceImpl>;
 export declare const Box: import("react").MemoExoticComponent<typeof SurfaceImpl>;

package/lib/typescript/modules/surface/SurfaceProps.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { LayoutStyle } from "../../core/style";
+import type { ElevationLevel } from "../../theme/tokens";
+import type { BgRole, BorderRole, RadiusToken, SpaceToken } from "./Surface.variants";
+/** Generic themed container; omit every prop for a plain, unstyled box. */
+export interface SurfaceProps {
+    background?: BgRole;
+    /** Also adds a themed border width; omit for no border. */
+    border?: BorderRole;
+    radius?: RadiusToken;
+    elevation?: ElevationLevel;
+    padding?: SpaceToken;
+    children?: ReactNode;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=SurfaceProps.d.ts.map

package/lib/typescript/modules/surface/index.d.ts

@@ -1,4 +1,4 @@
 export { Box, Surface } from "./Surface";
-export type { SurfaceProps } from "./Surface";
+export type { SurfaceProps } from "./SurfaceProps";
 export type { BgRole, BorderRole, RadiusToken, SpaceToken, } from "./Surface.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/swipeable-row/SwipeableRow.d.ts

@@ -12,24 +12,6 @@
  * carries an explicit `tabIndex={-1}`: without it a 20-row list costs three Tab presses per row,
  * two of them landing on a button the content is painted over.
  */
-import type { ReactNode } from "react";
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-import type { SwipeableActionTone } from "./SwipeableRow.variants";
-export interface SwipeableRowAction {
-    readonly id: string;
-    readonly label: string;
-    readonly icon?: IconName;
-    readonly tone?: SwipeableActionTone;
-    readonly onPress: () => void;
-}
-export interface SwipeableRowProps {
-    children: ReactNode;
-    leftActions?: readonly SwipeableRowAction[];
-    rightActions?: readonly SwipeableRowAction[];
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { SwipeableRowProps } from "./SwipeableRowProps";
 export declare const SwipeableRow: import("react").NamedExoticComponent<SwipeableRowProps>;
 //# sourceMappingURL=SwipeableRow.d.ts.map

package/lib/typescript/modules/swipeable-row/SwipeableRowProps.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from "react";
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+import type { SwipeableActionTone } from "./SwipeableRow.variants";
+/** One action revealed by a swipe, also exposed as an `accessibilityAction` on the row. */
+export interface SwipeableRowAction {
+    readonly id: string;
+    readonly label: string;
+    readonly icon?: IconName;
+    readonly tone?: SwipeableActionTone;
+    readonly onPress: () => void;
+}
+/** Row that reveals action buttons on horizontal swipe, with a tap-affordance fallback for a11y. */
+export interface SwipeableRowProps {
+    children: ReactNode;
+    leftActions?: readonly SwipeableRowAction[];
+    rightActions?: readonly SwipeableRowAction[];
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=SwipeableRowProps.d.ts.map

package/lib/typescript/modules/swipeable-row/index.d.ts

@@ -1,4 +1,4 @@
 export { SwipeableRow } from "./SwipeableRow";
-export type { SwipeableRowAction, SwipeableRowProps } from "./SwipeableRow";
+export type { SwipeableRowAction, SwipeableRowProps } from "./SwipeableRowProps";
 export type { SwipeableActionTone } from "./SwipeableRow.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/switch/Switch.d.ts

@@ -4,19 +4,6 @@
  * track/thumb), so this module re-themes its two colours from ROLE tokens and leaves sizing/shape
  * to RN — which is also why there is no `size` prop.
  */
-import type { LayoutStyle } from "../../core/style";
-export interface SwitchProps {
-    value: boolean;
-    onValueChange: (value: boolean) => void;
-    disabled?: boolean;
-    /**
-     * A switch never renders visible text, so this is the only accessible name a screen reader has
-     * — required at the type level, never optional (mirrors `Button`'s icon-only contract).
-     */
-    accessibilityLabel: string;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { SwitchProps } from "./SwitchProps";
 export declare const Switch: import("react").NamedExoticComponent<SwitchProps>;
 //# sourceMappingURL=Switch.d.ts.map

package/lib/typescript/modules/switch/Switch.variants.d.ts

@@ -3,6 +3,7 @@
  * lucide, same split as `Button.variants.ts`: the WCAG + behaviour tests import these directly,
  * measuring real palettes instead of eyeballing a hex.
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors } from "../../theme/hooks";
 export interface SwitchColors {
     /** Track fill when `value` is false. */
@@ -23,6 +24,7 @@ export interface SwitchColors {
  * non-text UI surface), while `bg.canvas` clears ≥3:1 against BOTH `trackOff` and `trackOn` on
  * every brand × mode — see `__tests__/Switch.test.ts`.
  */
+export { MIN_TOUCH_TARGET };
 export declare function resolveSwitchColors(colors: RoleColors): SwitchColors;
 export interface SwitchAccessibilityInput {
     readonly value: boolean;
@@ -49,8 +51,6 @@ export interface SwitchAccessibilityProps {
  * not allowed. Object on native, native input on web; no flat form belongs here.
  */
 export declare function resolveSwitchAccessibility(input: SwitchAccessibilityInput): SwitchAccessibilityProps;
-/** WCAG 2.5.5 (AAA) / HIG floor every interactive control is held to — same constant as `Button`. */
-export declare const MIN_TOUCH_TARGET = 44;
 /**
  * RN's `Switch` has no `size` prop (a native intrinsic control doesn't scale cleanly), so its
  * visual height is a platform constant rather than something this library chooses. 31 is iOS's

package/lib/typescript/modules/switch/SwitchProps.d.ts

@@ -0,0 +1,20 @@
+import type { LayoutStyle } from "../../core/style";
+/** Themed wrapper over React Native's own `<Switch>` — no `size` prop; RN owns sizing. */
+export interface SwitchProps {
+    value: boolean;
+    onValueChange: (value: boolean) => void;
+    disabled?: boolean;
+    /** A switch renders no visible text — this is its only accessible name. */
+    accessibilityLabel: string;
+    /** Visible label; defaults `accessibilityLabel` when omitted. */
+    label?: string;
+    /** Ignored unless `label` is also set. */
+    description?: string;
+    /** Ignored unless `label` is also set. */
+    errorText?: string;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    /** On the inner `<Switch>`; when `label` is set the row wrapper gets `${testID}-row` instead. */
+    testID?: string;
+}
+//# sourceMappingURL=SwitchProps.d.ts.map

package/lib/typescript/modules/switch/index.d.ts

@@ -4,5 +4,5 @@
  * internal — a consumer configures a Switch through its props, never by importing its internals.
  */
 export { Switch } from "./Switch";
-export type { SwitchProps } from "./Switch";
+export type { SwitchProps } from "./SwitchProps";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/tabs/Tabs.d.ts

@@ -12,22 +12,6 @@
  * That indicator marks SELECTION, not focus: a tab holding keyboard/AT focus draws its own inset
  * ring (WCAG 2.4.7), the same treatment `BottomNavTab` uses.
  */
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-import type { TabsSize } from "./Tabs.variants";
-export interface TabItem {
-    readonly label: string;
-    readonly value: string;
-    readonly icon?: IconName;
-}
-export interface TabsProps {
-    items: TabItem[];
-    value: string;
-    onValueChange: (value: string) => void;
-    size?: TabsSize;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { TabsProps } from "./TabsProps";
 export declare const Tabs: import("react").NamedExoticComponent<TabsProps>;
 //# sourceMappingURL=Tabs.d.ts.map

package/lib/typescript/modules/tabs/Tabs.variants.d.ts

@@ -8,11 +8,10 @@
  *  - `resolveTabAccessibility` derives the per-tab a11y surface purely, so the "selected" contract
  *    is unit-testable without rendering React Native.
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, Theme } from "../../theme/hooks";
+export { MIN_TOUCH_TARGET };
 export type TabsSize = "sm" | "md" | "lg";
-/** Same floor as Button/RadioGroup — 44dp (WCAG 2.5.5 / HIG). Duplicated, not imported: modules
- * stay isolated. */
-export declare const MIN_TOUCH_TARGET = 44;
 export interface TabsSizeSpec {
     /** Visual height in dp, per tab. */
     readonly height: number;

package/lib/typescript/modules/tabs/TabsProps.d.ts

@@ -0,0 +1,29 @@
+import type { ReactNode } from "react";
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+import type { TabsSize } from "./Tabs.variants";
+/** One tab in the strip. */
+export interface TabItem {
+    readonly label: string;
+    readonly value: string;
+    readonly icon?: IconName;
+    /** Optional count badge on the tab label. */
+    readonly count?: number;
+}
+/** Renders only the tab strip — content switching is the consumer's job unless `panels` is given. */
+export interface TabsProps {
+    items: TabItem[];
+    /** The selected tab's `value`, not an index. */
+    value: string;
+    onValueChange: (value: string) => void;
+    /** Defaults to "md". */
+    size?: TabsSize;
+    /** Panel content keyed by tab `value`; only the active panel renders unless `lazyPanels` is false. */
+    panels?: Readonly<Partial<Record<string, ReactNode>>>;
+    /** When true, a panel mounts on first visit and stays mounted (standard lazy tabs). */
+    lazyPanels?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=TabsProps.d.ts.map

package/lib/typescript/modules/tabs/index.d.ts

@@ -4,7 +4,7 @@
  * stay internal — a consumer configures Tabs through its props, never by importing its internals.
  */
 export { Tabs } from "./Tabs";
-export type { TabsProps, TabItem } from "./Tabs";
+export type { TabsProps, TabItem } from "./TabsProps";
 export type { TabsSize } from "./Tabs.variants";
 export type { IconName } from "../../core/icon";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/text/Text.d.ts

@@ -1,27 +1,4 @@
-import { type TextProps as RNTextProps } from 'react-native';
-import type { LayoutStyle } from '../../core/style';
-import type { FontWeightToken } from '../../theme/tokens';
-import type { HeadingVariant, TextColorRole, TextVariant } from './Text.variants';
-export interface TextProps {
-    variant?: TextVariant;
-    children: RNTextProps['children'];
-    color?: TextColorRole;
-    numberOfLines?: number;
-    align?: 'auto' | 'left' | 'right' | 'center' | 'justify';
-    weight?: FontWeightToken;
-    style?: LayoutStyle;
-    testID?: string;
-}
-export interface HeadingProps {
-    variant?: HeadingVariant;
-    children: RNTextProps['children'];
-    color?: TextColorRole;
-    numberOfLines?: number;
-    align?: 'auto' | 'left' | 'right' | 'center' | 'justify';
-    weight?: FontWeightToken;
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { TextProps, HeadingProps } from './TextProps';
 export declare const Text: import("react").NamedExoticComponent<TextProps>;
 export declare const Heading: import("react").NamedExoticComponent<HeadingProps>;
 //# sourceMappingURL=Text.d.ts.map

package/lib/typescript/modules/text/TextProps.d.ts

@@ -0,0 +1,35 @@
+import type { TextProps as RNTextProps } from 'react-native';
+import type { LayoutStyle } from '../../core/style';
+import type { FontWeightToken } from '../../theme/tokens';
+import type { HeadingVariant, TextColorRole, TextVariant } from './Text.variants';
+/** Themed body/label text; see `HeadingProps` for the semantic-heading counterpart. */
+export interface TextProps {
+    /** Defaults to "body". */
+    variant?: TextVariant;
+    children: RNTextProps['children'];
+    /** Defaults to the variant's own color role ("muted" for caption/overline, "default" otherwise). */
+    color?: TextColorRole;
+    numberOfLines?: number;
+    /** Defaults to RN's own "auto" when omitted. */
+    align?: 'auto' | 'left' | 'right' | 'center' | 'justify';
+    /** Overrides the variant's own font weight. */
+    weight?: FontWeightToken;
+    style?: LayoutStyle;
+    testID?: string;
+}
+/** Renders `accessibilityRole="header"` with `aria-level` derived from `variant`. */
+export interface HeadingProps {
+    /** Defaults to "h2"; also sets the announced heading level (h1-h4). */
+    variant?: HeadingVariant;
+    children: RNTextProps['children'];
+    /** Defaults to the mapped text variant's own color role. */
+    color?: TextColorRole;
+    numberOfLines?: number;
+    /** Defaults to RN's own "auto" when omitted. */
+    align?: 'auto' | 'left' | 'right' | 'center' | 'justify';
+    /** Overrides the variant's own font weight. */
+    weight?: FontWeightToken;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=TextProps.d.ts.map