pixelize-native-library 1.2.0 → 1.3.0

package/lib/typescript/modules/slider/SliderProps.d.ts

@@ -0,0 +1,27 @@
+import type { LayoutStyle } from "../../core/style";
+import type { SliderSize } from "./Slider.variants";
+/** Props for a draggable range control built on React Native's own `PanResponder`. */
+export interface SliderProps {
+    /** Controlled — the parent owns state and updates it via `onValueChange`. */
+    value: number;
+    /** Fires on every grant/move/release, and on an increment/decrement action. */
+    onValueChange: (value: number) => void;
+    /** Fires once, on release or an increment/decrement action — never mid-drag. */
+    onSlidingComplete?: (value: number) => void;
+    /** Defaults to 0. */
+    min?: number;
+    /** Defaults to 100. */
+    max?: number;
+    /** Drag-snap amount and increment/decrement step; defaults to 1. */
+    step?: number;
+    /** Blocks the gesture and accessibility actions; dims to 50% opacity. */
+    disabled?: boolean;
+    /** Closed union — drives track height + thumb diameter. */
+    size?: SliderSize;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    /** Required — the only accessible name, since the control never renders visible text. */
+    accessibilityLabel: string;
+    testID?: string;
+}
+//# sourceMappingURL=SliderProps.d.ts.map

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

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

package/lib/typescript/modules/spinner/Spinner.d.ts

@@ -4,16 +4,6 @@
  * spinner: the OUTER box carries the `progressbar` role, the accessible name, and `busy` state, so a
  * screen reader announces one "Loading" node — never the indicator as a second, redundant element.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { SpinnerSize, SpinnerTone } from "./Spinner.variants";
-export interface SpinnerProps {
-    size?: SpinnerSize;
-    tone?: SpinnerTone;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-    /** A Spinner renders no visible text, so this is its only accessible name. Defaults to "Loading". */
-    accessibilityLabel?: string;
-}
+import type { SpinnerProps } from "./SpinnerProps";
 export declare const Spinner: import("react").NamedExoticComponent<SpinnerProps>;
 //# sourceMappingURL=Spinner.d.ts.map

package/lib/typescript/modules/spinner/SpinnerProps.d.ts

@@ -0,0 +1,15 @@
+import type { LayoutStyle } from "../../core/style";
+import type { SpinnerSize, SpinnerTone } from "./Spinner.variants";
+/** A thin themed wrapper around RN's own ActivityIndicator. */
+export interface SpinnerProps {
+    /** Defaults to "md". */
+    size?: SpinnerSize;
+    /** Defaults to "accent". */
+    tone?: SpinnerTone;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+    /** A Spinner renders no visible text, so this is its only accessible name. Defaults to "Loading". */
+    accessibilityLabel?: string;
+}
+//# sourceMappingURL=SpinnerProps.d.ts.map

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

@@ -5,6 +5,6 @@
  * `icon` prop, so unlike `button/index.ts` there is no `IconName` re-export.
  */
 export { Spinner } from "./Spinner";
-export type { SpinnerProps } from "./Spinner";
+export type { SpinnerProps } from "./SpinnerProps";
 export type { SpinnerSize, SpinnerTone } from "./Spinner.variants";
 //# sourceMappingURL=index.d.ts.map

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

@@ -2,17 +2,6 @@
  * StageProgress — horizontal pipeline stages (pills, bar, or stepper). Read-only by default;
  * optional `onStagePress` when not `readOnly`.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { StageProgressStage, StageProgressVariant } from "./StageProgress.variants";
-export interface StageProgressProps {
-    stages: readonly StageProgressStage[];
-    value: string;
-    variant?: StageProgressVariant;
-    readOnly?: boolean;
-    onStagePress?: (stageId: string) => void;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { StageProgressProps } from "./StageProgressProps";
 export declare const StageProgress: import("react").NamedExoticComponent<StageProgressProps>;
 //# sourceMappingURL=StageProgress.d.ts.map

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
@@ -42,13 +49,21 @@ export declare function resolveActiveStageIndex(stages: readonly StageProgressSt
  */
 export declare function resolveStageAccessibilityLabel(label: string, state: StageState): string;
 export interface StageAccessibilityState {
-    readonly "aria-selected": boolean;
+    /** The WEB half of "this is the stage you're on". A stage is `role="button"` (or carries no role
+     *  at all when read-only) and `aria-selected` is valid on neither — `aria-current="step"` is the
+     *  WAI-ARIA signal for a step in a process, and unlike `aria-selected` it has no role restriction
+     *  (same fix `pagination` uses for "the page you're on", token `"page"` there vs `"step"` here). */
+    readonly "aria-current": "step" | undefined;
+    /** The NATIVE half — React Native has no "current" concept and react-native-web discards the
+     *  object form, so this never reaches the DOM; `selected` is the nearest native equivalent. */
+    readonly accessibilityState: {
+        readonly selected: boolean;
+    };
     readonly "aria-disabled": boolean;
 }
 /**
- * Flat `aria-*` rather than `accessibilityState={{…}}`: RN's `View`/`Pressable` fold the flat props
- * back into that object, while react-native-web forwards only the flat form — the object reaches
- * nothing at all on web.
+ * Flat `aria-current` for web + explicit `accessibilityState` for native — see the field comments
+ * above for why this pair (not a single flat prop) is required here specifically.
  */
 export declare function resolveStageAccessibilityState(state: StageState, disabled: boolean | undefined): StageAccessibilityState;
 export interface StageProgressAccessibilityProps {
@@ -72,10 +87,14 @@ export interface StageProgressColors {
     readonly completedText: string;
     readonly upcomingFill: string;
     readonly upcomingText: string;
-    readonly track: 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:
@@ -87,9 +106,11 @@ export declare const stageFocusRingStructure: import("../../core/style").ThemedV
     variant: {
         pill: {
             borderRadius: 9999;
+            borderCurve: "continuous";
         };
         stepper: {
-            borderRadius: 8;
+            borderRadius: 12;
+            borderCurve: "continuous";
         };
     };
 }, import("react-native").ViewStyle>;

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,34 +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;
-    /** 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;
-    /** 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/StateBlock.variants.d.ts

@@ -27,4 +27,5 @@ export declare function resolveErrorStateColors(colors: RoleColors): ErrorStateC
 export declare function resolveErrorStateAnnouncement(title: string, description: string | undefined): string;
 export declare const loadingStateStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
 export declare const errorStateStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
+export declare const stateBlockFillStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
 //# sourceMappingURL=StateBlock.variants.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

@@ -0,0 +1,6 @@
+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>;
+export {};
+//# sourceMappingURL=Surface.d.ts.map

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

@@ -0,0 +1,15 @@
+import type { ElevationLevel } from "../../theme/tokens";
+import type { RoleColors, Theme } from "../../theme/hooks";
+export type BgRole = keyof RoleColors["bg"];
+export type BorderRole = keyof RoleColors["border"];
+export type RadiusToken = keyof Theme["radii"];
+export type SpaceToken = keyof Theme["space"];
+export interface SurfaceColors {
+    readonly background?: string;
+    readonly border?: string;
+}
+export declare function resolveSurfaceColors(colors: RoleColors, background?: BgRole, border?: BorderRole): SurfaceColors;
+export declare function resolveSurfacePadding(theme: Theme, padding?: SpaceToken): number | undefined;
+export declare function resolveSurfaceElevation(theme: Theme, elevation?: ElevationLevel): Record<string, unknown> | undefined;
+export declare const surfaceStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
+//# sourceMappingURL=Surface.variants.d.ts.map

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

@@ -0,0 +1,4 @@
+export { Box, Surface } 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