pixelize-native-library 1.2.0 → 1.3.0

package/lib/typescript/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Import-only barrel. LIGHT primitives only.
  *
- * Heavy modules (charts, date-picker, table, editor) are deliberately ABSENT here and reachable
+ * Heavy modules (charts, date-picker, table, editor, bottom-nav, filter-sheet, reorder, …) are deliberately ABSENT here and reachable
  * only via their subpath — so a lazy barrel import cannot drag a chart engine into an app's
  * bundle, even with every optimizer turned off.
  *
@@ -16,18 +16,24 @@ export { AlertDialog } from "./modules/alert-dialog";
 export type { AlertDialogProps, AlertDialogTone } from "./modules/alert-dialog";
 export { AppBar } from "./modules/app-bar";
 export type { AppBarProps, AppBarAction, IconName } from "./modules/app-bar";
+export { AppSwitcher } from "./modules/app-switcher";
+export type { AppSwitcherApp, AppSwitcherProps } from "./modules/app-switcher";
+export { AppearanceSettings } from "./modules/appearance-settings";
+export type { AppearanceColorMode, AppearanceSettingsProps } from "./modules/appearance-settings";
 export { Avatar } from "./modules/avatar";
 export type { AvatarProps, AvatarShape, AvatarSize } from "./modules/avatar";
 export { AvatarGroup } from "./modules/avatar-group";
 export type { AvatarGroupProps, AvatarGroupItem } from "./modules/avatar-group";
+export { Backdrop } from "./modules/backdrop";
+export type { BackdropProps } from "./modules/backdrop";
 export { Badge } from "./modules/badge";
 export type { BadgeProps, BadgeTone, BadgeSize } from "./modules/badge";
 export { Banner } from "./modules/banner";
-export type { BannerProps, BannerAction, BannerTone, BannerVariant } from "./modules/banner";
-export { BottomNav } from "./modules/bottom-nav";
-export type { BottomNavProps, BottomNavActiveState, BottomNavDestination, BottomNavOverflowSection, BottomNavEditConfig, MenuItem } from "./modules/bottom-nav";
+export type { BannerAction, BannerProps, BannerTone, BannerVariant } from "./modules/banner";
 export { BottomSheet } from "./modules/bottom-sheet";
 export type { BottomSheetProps } from "./modules/bottom-sheet";
+export { Breadcrumbs } from "./modules/breadcrumbs";
+export type { BreadcrumbItem, BreadcrumbsProps } from "./modules/breadcrumbs";
 export { Button } from "./modules/button";
 export type { ButtonProps, ButtonVariant, ButtonSize, ButtonTone, IconPosition } from "./modules/button";
 export { ButtonGroup } from "./modules/button-group";
@@ -37,41 +43,51 @@ export type { CardProps, CardVariant } from "./modules/card";
 export { Checkbox } from "./modules/checkbox";
 export type { CheckboxProps, CheckboxSize } from "./modules/checkbox";
 export { Chip, ChipGroup } from "./modules/chip";
-export type { ChipProps, ChipGroupProps, ChipGroupGap, ChipSize, ChipTone, ChipVariant } from "./modules/chip";
+export type { ChipProps, ChipGroupProps, ChipGroupGap, ChipSize, ChipTone, ChipVariant, CustomToneColors } from "./modules/chip";
 export { Combobox } from "./modules/combobox";
 export type { ComboboxProps, ComboboxSingleProps, ComboboxMultipleProps, ComboboxOption } from "./modules/combobox";
 export { Composer } from "./modules/composer";
 export type { ComposerProps } from "./modules/composer";
 export { CopyButton } from "./modules/copy-button";
 export type { CopyButtonProps, CopyButtonSize, CopyButtonVariant } from "./modules/copy-button";
+export { DescriptionList } from "./modules/description-list";
+export type { DescriptionListItem, DescriptionListProps, DescriptionListColumns, DescriptionListLayout } from "./modules/description-list";
 export { Divider } from "./modules/divider";
 export type { DividerProps, DividerOrientation } from "./modules/divider";
+export { DocumentViewer } from "./modules/document-viewer";
+export type { DocumentViewerProps } from "./modules/document-viewer";
 export { Drawer } from "./modules/drawer";
 export type { DrawerProps } from "./modules/drawer";
 export { EmptyState } from "./modules/empty-state";
 export type { EmptyStateProps, EmptyStateAction } from "./modules/empty-state";
 export { Fab, FabGroup } from "./modules/fab";
 export type { FabProps, FabGroupProps, FabGroupAction, FabPosition, FabSize, FabTone } from "./modules/fab";
+export { FieldSelectModal } from "./modules/field-select-modal";
+export type { FieldSelectModalProps, FieldSelectOption } from "./modules/field-select-modal";
 export { FileGrid } from "./modules/file-grid";
 export type { FileGridItem, FileGridProps, FileGridColumns } from "./modules/file-grid";
 export { FileUpload } from "./modules/file-upload";
 export type { FileUploadProps, FileUploadResult, FileUploadSize, FileUploadSource } from "./modules/file-upload";
-export { FilterSheet, FilterChip, countActiveFilters } from "./modules/filter-sheet";
-export type { FilterSheetProps, FilterDimension, FilterDimensionKind, FilterOption, FilterValues, FilterChipProps } from "./modules/filter-sheet";
+export { FilterBar } from "./modules/filter-bar";
+export type { FilterBarProps } from "./modules/filter-bar";
 export { FolderRow } from "./modules/folder-row";
 export type { FolderRowProps } from "./modules/folder-row";
 export { FormField } from "./modules/form-field";
 export type { FormFieldProps, FormFieldStatus, FormFieldControlProps } from "./modules/form-field";
 export { Input } from "./modules/input";
 export type { InputProps, InputSize, InputStatus } from "./modules/input";
+export { KeyValue } from "./modules/key-value";
+export type { KeyValueProps } from "./modules/key-value";
 export { LimitReachedModal } from "./modules/limit-reached-modal";
 export type { LimitReachedModalProps, LimitKind } from "./modules/limit-reached-modal";
 export { ListItem } from "./modules/list-item";
 export type { ListItemProps } from "./modules/list-item";
+export { ListScreen } from "./modules/list-screen";
+export type { ListScreenProps } from "./modules/list-screen";
 export { Markdown, parseMarkdown } from "./modules/markdown";
 export type { MarkdownProps, MarkdownBlockNode, MarkdownInlineNode } from "./modules/markdown";
 export { Menu } from "./modules/menu";
-export type { MenuProps, MenuTriggerProps, MenuItemTone } from "./modules/menu";
+export type { MenuProps, MenuItem, MenuTriggerProps, MenuItemTone } from "./modules/menu";
 export { MessageBubble } from "./modules/message-bubble";
 export type { MessageBubbleProps, MessageBubbleVariant } from "./modules/message-bubble";
 export { Modal, ModalPortalProvider } from "./modules/modal";
@@ -80,20 +96,28 @@ export { MoreItems } from "./modules/more-items";
 export type { MoreItemsProps, MoreItemsEntry } from "./modules/more-items";
 export { MultiSelect } from "./modules/multi-select";
 export type { MultiSelectProps, MultiSelectOption, MultiSelectSize } from "./modules/multi-select";
+export { NotificationBell } from "./modules/notification-bell";
+export type { NotificationBellProps } from "./modules/notification-bell";
 export { NumberInput } from "./modules/number-input";
 export type { NumberInputProps, NumberInputSize, NumberInputStatus } from "./modules/number-input";
 export { OrgSwitcher } from "./modules/org-switcher";
 export type { OrgSwitcherProps, OrgSwitcherOption, OrgSwitcherSize } from "./modules/org-switcher";
 export { Pagination, buildPageRange, clampPage } from "./modules/pagination";
 export type { PaginationProps, PageItem, PaginationSize, PaginationVariant } from "./modules/pagination";
+export { PersonChip } from "./modules/person-chip";
+export type { PersonChipProps } from "./modules/person-chip";
 export { PinInput } from "./modules/pin-input";
 export type { PinInputProps, PinInputKeyboardType, PinInputSize, PinInputStatus } from "./modules/pin-input";
+export { PlanBadge } from "./modules/plan-badge";
+export type { PlanBadgeProps, PlanBadgeTier } from "./modules/plan-badge";
+export { PlanPill } from "./modules/plan-pill";
+export type { PlanPillProps } from "./modules/plan-pill";
 export { ProgressBar } from "./modules/progress-bar";
 export type { ProgressBarProps, ProgressBarSize, ProgressBarTone } from "./modules/progress-bar";
 export { RadioGroup } from "./modules/radio-group";
 export type { RadioGroupProps, RadioGroupOption, RadioGroupSize } from "./modules/radio-group";
-export { Reorder } from "./modules/reorder";
-export type { ReorderProps, ReorderItem } from "./modules/reorder";
+export { SaveBar } from "./modules/save-bar";
+export type { SaveBarProps } from "./modules/save-bar";
 export { Screen } from "./modules/screen";
 export type { ScreenProps, ScreenEdge, ScreenState } from "./modules/screen";
 export { SearchBar } from "./modules/search-bar";
@@ -105,7 +129,11 @@ export type { SectionListProps, SectionListSection } from "./modules/section-lis
 export { SegmentedControl } from "./modules/segmented-control";
 export type { SegmentedControlProps, SegmentedControlOption, SegmentedControlSize } from "./modules/segmented-control";
 export { Select } from "./modules/select";
-export type { SelectProps, SelectOption, SelectSize } from "./modules/select";
+export type { SelectOption, SelectProps, SelectOptionCustomColors, SelectOptionTone, SelectSize } from "./modules/select";
+export { SettingRow } from "./modules/setting-row";
+export type { SettingRowProps } from "./modules/setting-row";
+export { SettingsSection } from "./modules/settings-section";
+export type { SettingsSectionProps } from "./modules/settings-section";
 export { Skeleton } from "./modules/skeleton";
 export type { SkeletonProps, SkeletonShape } from "./modules/skeleton";
 export { Slider } from "./modules/slider";
@@ -114,12 +142,16 @@ export { Spinner } from "./modules/spinner";
 export type { SpinnerProps, SpinnerSize, SpinnerTone } from "./modules/spinner";
 export { StageProgress } from "./modules/stage-progress";
 export type { StageProgressProps, StageProgressStage, StageProgressVariant, StageState } from "./modules/stage-progress";
+export { StatGrid } from "./modules/stat-grid";
+export type { StatGridItem, StatGridProps } from "./modules/stat-grid";
 export { StatTile } from "./modules/stat-tile";
 export type { StatTileProps, StatTileTone } from "./modules/stat-tile";
 export { LoadingState, ErrorState } from "./modules/state-block";
 export type { LoadingStateProps, ErrorStateProps, ErrorStateAction } from "./modules/state-block";
 export { Stepper } from "./modules/stepper";
-export type { StepperProps, StepperStep } from "./modules/stepper";
+export type { StepperStep, StepperProps } from "./modules/stepper";
+export { Box, Surface } from "./modules/surface";
+export type { SurfaceProps, BgRole, BorderRole, RadiusToken, SpaceToken } from "./modules/surface";
 export { SwipeableRow } from "./modules/swipeable-row";
 export type { SwipeableRowAction, SwipeableRowProps, SwipeableActionTone } from "./modules/swipeable-row";
 export { Switch } from "./modules/switch";
@@ -140,4 +172,12 @@ export { TypingIndicator } from "./modules/typing-indicator";
 export type { TypingIndicatorProps, TypingIndicatorSize } from "./modules/typing-indicator";
 export { UnreadBadge } from "./modules/unread-badge";
 export type { UnreadBadgeProps, UnreadBadgeSize } from "./modules/unread-badge";
+export { UpgradeButton } from "./modules/upgrade-button";
+export type { UpgradeButtonProps } from "./modules/upgrade-button";
+export { setHapticsModule, hasHapticsModule, getHapticsModule } from "./core/haptics";
+export type { HapticsModule, HapticImpactStyle, HapticNotificationType } from "./core/haptics";
+export { setBlurModule, hasBlurModule, getBlurModule } from "./core/blur";
+export type { BlurViewComponent } from "./core/blur";
+export { setDocumentPicker, setImagePicker, getDocumentPicker, getImagePicker, setExpoImage, getExpoImage, hasExpoImage, } from "./core/media";
+export type { DocumentPickerModule, ImagePickerModule, ExpoImageComponent } from "./core/media";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/accordion/Accordion.d.ts

@@ -5,42 +5,7 @@
  * Content is conditionally mounted while expanded. Prefer `renderContent` over eager `content` so
  * collapsed sections never build heavy subtrees.
  */
-import type { ReactNode } from "react";
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-import type { AccordionSize } from "./Accordion.variants";
-export interface AccordionItem {
-    readonly value: string;
-    readonly title: string;
-    readonly subtitle?: string;
-    readonly icon?: IconName;
-    readonly badge?: string;
-    readonly disabled?: boolean;
-    /** Eager content — use `renderContent` when sections are heavy. */
-    readonly content?: ReactNode;
-    readonly renderContent?: () => ReactNode;
-}
-interface AccordionBaseProps {
-    items: AccordionItem[];
-    /** Blocks every header that is not individually `disabled`. */
-    disabled?: boolean;
-    size?: AccordionSize;
-    style?: LayoutStyle;
-    testID?: string;
-}
-interface AccordionSingleProps extends AccordionBaseProps {
-    type?: "single";
-    value?: string;
-    defaultValue?: string;
-    onValueChange?: (value: string) => void;
-}
-interface AccordionMultipleProps extends AccordionBaseProps {
-    type: "multiple";
-    value?: string[];
-    defaultValue?: string[];
-    onValueChange?: (value: string[]) => void;
-}
-export type AccordionProps = AccordionSingleProps | AccordionMultipleProps;
+import type { AccordionProps } from "./AccordionProps";
+export type { AccordionItem, AccordionProps } from "./AccordionProps";
 export declare const Accordion: import("react").NamedExoticComponent<AccordionProps>;
-export {};
 //# sourceMappingURL=Accordion.d.ts.map

package/lib/typescript/modules/accordion/Accordion.variants.d.ts

@@ -11,11 +11,10 @@
  *    "expanded tracks open state / disabled blocks the toggle" 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 AccordionSize = "sm" | "md" | "lg";
-/** Same floor as Button/Tabs/Select — 44dp (WCAG 2.5.5 AAA / HIG). Duplicated, not imported: modules
- * stay isolated. */
-export declare const MIN_TOUCH_TARGET = 44;
 export interface AccordionSizeSpec {
     /** Visual header row height in dp. */
     readonly headerMinHeight: number;
@@ -55,7 +54,7 @@ export interface AccordionColors {
     readonly title: string;
     /** The chevron glyph — a non-text state indicator, not a label. */
     readonly icon: string;
-    /** The hairline between items — decorative, never the interactive/focus rungs. */
+    /** The StyleSheet.hairlineWidth between items — decorative, never the interactive/focus rungs. */
     readonly divider: string;
     /** A header's background while pressed. */
     readonly pressedHeaderBg: string;
@@ -89,7 +88,7 @@ export interface AccordionHeaderAccessibilityProps {
  */
 export declare function resolveAccordionHeaderAccessibility(input: AccordionHeaderAccessibilityInput): AccordionHeaderAccessibilityProps;
 /**
- * One item's separator — a hairline on the bottom edge, theme-scaled border WIDTH. Colour
+ * One item's separator — a StyleSheet.hairlineWidth on the bottom edge, theme-scaled border WIDTH. Colour
  * (`divider`) is resolved separately and applied inline over this.
  */
 export declare const accordionItemStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;

package/lib/typescript/modules/accordion/AccordionProps.d.ts

@@ -0,0 +1,49 @@
+import type { ReactNode } from "react";
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+import type { AccordionSize } from "./Accordion.variants";
+/** One collapsible section: its trigger label and the body it reveals. */
+export interface AccordionItem {
+    readonly value: string;
+    readonly title: string;
+    readonly subtitle?: string;
+    readonly icon?: IconName;
+    readonly badge?: string;
+    readonly disabled?: boolean;
+    /** Eager content — use `renderContent` when sections are heavy. */
+    readonly content?: ReactNode;
+    /** Lazily-building alternative to `content`, preferred for heavy sections. */
+    readonly renderContent?: () => ReactNode;
+}
+interface AccordionBaseProps {
+    items: AccordionItem[];
+    /** Blocks every header that is not individually `disabled`. */
+    disabled?: boolean;
+    /** Defaults to "md". */
+    size?: AccordionSize;
+    style?: LayoutStyle;
+    testID?: string;
+}
+/** Single-select mode — `value` is one item id, or null when all are closed. */
+export interface AccordionSingleProps extends AccordionBaseProps {
+    /** Defaults to "single" — at most one section stays open. */
+    type?: "single";
+    /** Controlled open value; omit to let the accordion manage its own state. */
+    value?: string;
+    defaultValue?: string;
+    /** Fires with the open item's value, or "" when the section closes. */
+    onValueChange?: (value: string) => void;
+}
+/** Multi-select mode — `value` is the array of open item ids. */
+export interface AccordionMultipleProps extends AccordionBaseProps {
+    /** Every section toggles independently. */
+    type: "multiple";
+    /** Controlled open values; omit to let the accordion manage its own state. */
+    value?: string[];
+    defaultValue?: string[];
+    onValueChange?: (value: string[]) => void;
+}
+/** Single- or multi-select, discriminated by `type`. */
+export type AccordionProps = AccordionSingleProps | AccordionMultipleProps;
+export {};
+//# sourceMappingURL=AccordionProps.d.ts.map

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

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

package/lib/typescript/modules/alert-dialog/AlertDialog.d.ts

@@ -5,20 +5,7 @@
  * action's tone, press feedback, and touch target. This module's entire job is wiring: which two
  * actions appear, in what order, and which tone the confirm action carries.
  */
-import type { AlertDialogTone } from "./AlertDialog.variants";
-export interface AlertDialogProps {
-    visible: boolean;
-    onRequestClose: () => void;
-    title: string;
-    description?: string;
-    confirmLabel: string;
-    cancelLabel?: string;
-    onConfirm: () => void;
-    /** Defaults to `onRequestClose` — cancelling and dismissing mean the same thing unless overridden. */
-    onCancel?: () => void;
-    /** `"danger"` mirrors Button's own destructive-action tone on the confirm button. */
-    tone?: AlertDialogTone;
-    testID?: string;
-}
+import type { AlertDialogProps } from "./AlertDialogProps";
+export type { AlertDialogProps } from "./AlertDialogProps";
 export declare const AlertDialog: import("react").NamedExoticComponent<AlertDialogProps>;
 //# sourceMappingURL=AlertDialog.d.ts.map

package/lib/typescript/modules/alert-dialog/AlertDialog.variants.d.ts

@@ -26,4 +26,5 @@ export declare function resolveAlertDialogConfirmTone(tone: AlertDialogTone): Bu
  * each `Button`'s own tone-resolved fill, applied by Button itself.
  */
 export declare const alertDialogActionsStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
+export declare function alertDialogPanelDepth(theme: Theme): import("react-native").ViewStyle;
 //# sourceMappingURL=AlertDialog.variants.d.ts.map

package/lib/typescript/modules/alert-dialog/AlertDialogProps.d.ts

@@ -0,0 +1,20 @@
+import type { AlertDialogTone } from "./AlertDialog.variants";
+/** A small confirm/alert dialog composed from Modal + Button. */
+export interface AlertDialogProps {
+    visible: boolean;
+    onRequestClose: () => void;
+    title: string;
+    description?: string;
+    confirmLabel: string;
+    /** Defaults to "Cancel". */
+    cancelLabel?: string;
+    onConfirm: () => void;
+    /** Defaults to `onRequestClose` — cancelling and dismissing mean the same thing unless overridden. */
+    onCancel?: () => void;
+    /** `"danger"` mirrors Button's own destructive-action tone on the confirm button. */
+    tone?: AlertDialogTone;
+    /** When set, confirm stays disabled until the user types this string exactly (destructive guard). */
+    confirmationText?: string;
+    testID?: string;
+}
+//# sourceMappingURL=AlertDialogProps.d.ts.map

package/lib/typescript/modules/alert-dialog/index.d.ts

@@ -4,6 +4,6 @@
  * configures an AlertDialog through its props, never by importing its internals.
  */
 export { AlertDialog } from "./AlertDialog";
-export type { AlertDialogProps } from "./AlertDialog";
+export type { AlertDialogProps } from "./AlertDialogProps";
 export type { AlertDialogTone } from "./AlertDialog.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/app-bar/AppBar.d.ts

@@ -13,25 +13,6 @@
  * Its only motion is `useTitleCrossfade` below — opacity on the title box, nothing else. Elevation
  * on scroll would need a public scroll-offset prop, which the API contract does not justify here.
  */
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-export interface AppBarAction {
-    readonly icon: IconName;
-    readonly accessibilityLabel: string;
-    readonly onPress: () => void;
-}
-export interface AppBarProps {
-    title: string;
-    subtitle?: string;
-    /** Renders a ghost back button with `arrow-left` and an accessible name of "Back". */
-    onBack?: () => void;
-    /** Custom leading action when `onBack` is absent. */
-    leading?: AppBarAction;
-    /** One or more trailing icon actions. */
-    trailing?: AppBarAction | readonly AppBarAction[];
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { AppBarProps } from "./AppBarProps";
 export declare const AppBar: import("react").NamedExoticComponent<AppBarProps>;
 //# sourceMappingURL=AppBar.d.ts.map

package/lib/typescript/modules/app-bar/AppBar.variants.d.ts

@@ -8,6 +8,7 @@
  * Free of React and lucide, so the WCAG + behaviour tests import this directly (mocking only
  * `react-native`'s `StyleSheet`, as `core/style` and every sibling module's tests do).
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, Theme } from "../../theme/hooks";
 /** Matches `Button`'s `MIN_TOUCH_TARGET` — each side slot reserves at least 44dp for icon actions. */
 export declare const APP_BAR_SIDE_MIN_WIDTH = 44;
@@ -21,6 +22,7 @@ export interface AppBarColors {
  * Maps AppBar onto the theme's role colours. No `tone`/`color` prop to widen — every colour this
  * bar can show is one of these role lookups (same reasoning as `Divider`/`Card`).
  */
+export { MIN_TOUCH_TARGET };
 export declare function resolveAppBarColors(colors: RoleColors): AppBarColors;
 /**
  * Structural styles only — the header row, title box, and side slots. No colours (resolved
@@ -32,4 +34,6 @@ export declare const appBarSideStructure: import("../../core/style").ThemedVaria
 export declare const appBarSideTrailingStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
 export declare const appBarTitleBoxStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
 export declare const appBarActionsRowStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
+/** Scroll distance over which a `scrollEffect="collapse*"` AppBar eases subtitle/padding. */
+export declare const APP_BAR_SCROLL_COLLAPSE_RANGE = 64;
 //# sourceMappingURL=AppBar.variants.d.ts.map

package/lib/typescript/modules/app-bar/AppBarProps.d.ts

@@ -0,0 +1,25 @@
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+/** One icon action shown in the leading or trailing slot. */
+export interface AppBarAction {
+    readonly icon: IconName;
+    readonly accessibilityLabel: string;
+    readonly onPress: () => void;
+}
+/** A themed top bar for screen headers, with optional back/leading/trailing icon actions. */
+export interface AppBarProps {
+    /** Rendered as the screen's accessible heading (role "header", level 1). Crossfades when changed. */
+    title: string;
+    /** Muted second line under the title; also crossfades when changed. */
+    subtitle?: string;
+    /** Renders a ghost back button with `arrow-left` and an accessible name of "Back". */
+    onBack?: () => void;
+    /** Custom leading action when `onBack` is absent. */
+    leading?: AppBarAction;
+    /** One or more trailing icon actions. */
+    trailing?: AppBarAction | readonly AppBarAction[];
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=AppBarProps.d.ts.map

package/lib/typescript/modules/app-bar/index.d.ts

@@ -4,6 +4,6 @@
  * through its props, never by importing its internals.
  */
 export { AppBar } from "./AppBar";
-export type { AppBarProps, AppBarAction } from "./AppBar";
+export type { AppBarProps, AppBarAction } from "./AppBarProps";
 export type { IconName } from "../../core/icon";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/app-switcher/AppSwitcher.d.ts

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

package/lib/typescript/modules/app-switcher/AppSwitcherProps.d.ts

@@ -0,0 +1,17 @@
+import type { LayoutStyle } from "../../core/style";
+/** One app entry in the switcher grid. */
+export interface AppSwitcherApp {
+    readonly id: string;
+    readonly label: string;
+    readonly icon?: string;
+}
+/** Grid of apps with a single active selection. */
+export interface AppSwitcherProps {
+    apps: readonly AppSwitcherApp[];
+    /** Must match an app's `id`; that entry alone shows a "Current" subtitle. */
+    activeAppId: string;
+    onSelect: (appId: string) => void;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=AppSwitcherProps.d.ts.map

package/lib/typescript/modules/app-switcher/index.d.ts

@@ -0,0 +1,3 @@
+export { AppSwitcher } from "./AppSwitcher";
+export type { AppSwitcherApp, AppSwitcherProps } from "./AppSwitcherProps";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/appearance-settings/AppearanceSettings.d.ts

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

package/lib/typescript/modules/appearance-settings/AppearanceSettingsProps.d.ts

@@ -0,0 +1,15 @@
+import type { LayoutStyle } from "../../core/style";
+import type { ThemeName } from "../../theme/tokens/types";
+/** Light/dark preference for the appearance settings screen. */
+export type AppearanceColorMode = "light" | "dark";
+/** Brand + color-mode picker composed for settings flows. */
+export interface AppearanceSettingsProps {
+    /** Must be one of the library's registered `themeNames`; an unmatched value leaves every chip unselected. */
+    brand: ThemeName;
+    mode: AppearanceColorMode;
+    onBrandChange: (brand: ThemeName) => void;
+    onModeChange: (mode: AppearanceColorMode) => void;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=AppearanceSettingsProps.d.ts.map

package/lib/typescript/modules/appearance-settings/index.d.ts

@@ -0,0 +1,3 @@
+export { AppearanceSettings } from "./AppearanceSettings";
+export type { AppearanceColorMode, AppearanceSettingsProps } from "./AppearanceSettingsProps";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/avatar/Avatar.d.ts

@@ -13,38 +13,7 @@
  * deliberately not an `Animated.Value`. An avatar renders per list row, so it must add no JS-driven
  * animation, no mount animation and no loop; the fade is load-triggered and runs entirely natively.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { AvatarShape, AvatarSize } from "./Avatar.variants";
-export interface AvatarProps {
-    size?: AvatarSize;
-    shape?: AvatarShape;
-    /** A remote image. Wins over `initials` when present. */
-    source?: {
-        uri: string;
-    };
-    /** Shown when there is no `source`. Longer strings are clipped to the first two characters. */
-    initials?: string;
-    /**
-     * Tints the initials/placeholder with a stable colour hashed from this string (an org name, a
-     * user id — whatever identifies the subject). Absent → the neutral placeholder fill.
-     */
-    identity?: string;
-    /**
-     * Blanks the image the instant this changes, so a recycled list row can never show the PREVIOUS
-     * subject's photo while the new one loads. Defaults to `source.uri`, which is the right key
-     * whenever one avatar means one image.
-     */
-    recyclingKey?: string;
-    /**
-     * Optional, unlike `Button`'s icon-only `accessibilityLabel` — an avatar is usually adjacent to a
-     * visible name, so it is not the sole carrier of identity the way an icon-only button's label is.
-     * Absent → the avatar is treated as decorative and hidden from assistive tech; present → exposed as
-     * one `"image"`-role element with this label.
-     */
-    accessibilityLabel?: string;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { AvatarProps } from "./AvatarProps";
+export type { AvatarProps } from "./AvatarProps";
 export declare const Avatar: import("react").NamedExoticComponent<AvatarProps>;
 //# sourceMappingURL=Avatar.d.ts.map

package/lib/typescript/modules/avatar/Avatar.variants.d.ts

@@ -15,7 +15,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 { PaletteProps, RoleColors, Theme } from "../../theme/hooks";
+export { MIN_TOUCH_TARGET };
 export type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
 /** `circle` for a person, `rounded` for an organisation/product, `square` for tiles/thumbnails. */
 export type AvatarShape = "circle" | "rounded" | "square";
@@ -144,7 +146,7 @@ export declare const avatarStructure: import("../../core/style").ThemedVariantRe
             borderRadius: 9999;
         };
         rounded: {
-            borderRadius: 8;
+            borderRadius: 16;
         };
         square: {
             borderRadius: 0;

package/lib/typescript/modules/avatar/AvatarProps.d.ts

@@ -0,0 +1,23 @@
+import type { LayoutStyle } from "../../core/style";
+import type { AvatarShape, AvatarSize } from "./Avatar.variants";
+/** A circular identity glyph — image, initials, or a plain placeholder. */
+export interface AvatarProps {
+    size?: AvatarSize;
+    shape?: AvatarShape;
+    /** A remote image. Wins over `initials` when present. */
+    source?: {
+        uri: string;
+    };
+    /** Shown when there's no `source`; clipped to its first two characters. */
+    initials?: string;
+    /** Tints initials/placeholder with a colour hashed from this string; absent uses the neutral fill. */
+    identity?: string;
+    /** Blanks the image on change so a recycled row won't flash the old photo. */
+    recyclingKey?: string;
+    /** Optional — absent hides the avatar from assistive tech; present exposes it as an image. */
+    accessibilityLabel?: string;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=AvatarProps.d.ts.map

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

@@ -6,6 +6,6 @@
  * No `IconName` re-export here: unlike `Button`, Avatar takes no `icon` prop.
  */
 export { Avatar } from "./Avatar";
-export type { AvatarProps } from "./Avatar";
+export type { AvatarProps } from "./AvatarProps";
 export type { AvatarShape, AvatarSize } from "./Avatar.variants";
 //# sourceMappingURL=index.d.ts.map