pixelize-native-library 1.2.0 → 1.3.0

package/lib/typescript/modules/divider/Divider.d.ts

@@ -4,14 +4,7 @@
  * (the same "no role" conclusion `Card` documents for its own plain-`View` container — see
  * `Card.tsx` — made explicit here since, unlike `Card`, a divider has no children to carry meaning).
  */
-import type { LayoutStyle } from "../../core/style";
-import type { DividerOrientation } from "./Divider.variants";
-export interface DividerProps {
-    orientation?: DividerOrientation;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { DividerProps } from "./DividerProps";
 declare function DividerImpl({ orientation, style, testID }: DividerProps): import("react").JSX.Element;
 export declare const Divider: import("react").MemoExoticComponent<typeof DividerImpl>;
 export {};

package/lib/typescript/modules/divider/Divider.variants.d.ts

@@ -1,6 +1,6 @@
 /**
  * Divider's style resolution — same split as `Card.variants` / `Button.variants`:
- *  - STRUCTURE (the hairline's thickness on the cross axis) lives in the themed `dividerStructure`
+ *  - STRUCTURE (the StyleSheet.hairlineWidth's thickness on the cross axis) lives in the themed `dividerStructure`
  *    resolver, static per (brand, mode), registered once via `StyleSheet.create`.
  *  - COLOUR is resolved from the theme's ROLE colours by `resolveDividerColor`, never a raw ramp
  *    and never a hardcoded hex.
@@ -23,18 +23,18 @@ export type DividerOrientation = "horizontal" | "vertical";
  */
 export declare function resolveDividerColor(colors: RoleColors): string;
 /**
- * Structural styles only — the hairline's thickness on the theme's `borderWidths` scale, spanning
+ * Structural styles only — the StyleSheet.hairlineWidth's thickness on the theme's `borderWidths` scale, spanning
  * the full cross axis. No colour (resolved separately, applied inline over this), so this compiles
  * once per theme identity via the `WeakMap`-cached themed resolver and never rebuilds per render.
  */
 export declare const dividerStructure: import("../../core/style").ThemedVariantResolver<Theme, {
     orientation: {
         horizontal: {
-            height: 1;
+            height: number;
             width: "100%";
         };
         vertical: {
-            width: 1;
+            width: number;
             alignSelf: "stretch";
         };
     };

package/lib/typescript/modules/divider/DividerProps.d.ts

@@ -0,0 +1,11 @@
+import type { LayoutStyle } from "../../core/style";
+import type { DividerOrientation } from "./Divider.variants";
+/** Props for the hairline separator between sections of content. */
+export interface DividerProps {
+    /** Defaults to "horizontal". */
+    orientation?: DividerOrientation;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=DividerProps.d.ts.map

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

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

package/lib/typescript/modules/document-viewer/DocumentViewer.d.ts

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

package/lib/typescript/modules/document-viewer/DocumentViewerProps.d.ts

@@ -0,0 +1,13 @@
+import type { LayoutStyle } from "../../core/style";
+/** v1 shows a message and an "Open in browser" button — no in-app PDF rendering. */
+export interface DocumentViewerProps {
+    /** Remote PDF URL passed to `Linking.openURL` when the user taps "Open in browser". */
+    uri: string;
+    /** Modal title; defaults to "Document". */
+    title?: string;
+    visible: boolean;
+    onRequestClose: () => void;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=DocumentViewerProps.d.ts.map

package/lib/typescript/modules/document-viewer/index.d.ts

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

package/lib/typescript/modules/drawer/Drawer.d.ts

@@ -34,12 +34,7 @@
  * documents. Every other case (native, or web with no provider — the default `ModalPortalContext` value
  * is `null`) renders through RN's own `<Modal>`, byte-identical to before this mechanism existed.
  */
-import type { ReactNode } from "react";
-export interface DrawerProps {
-    visible: boolean;
-    onRequestClose: () => void;
-    children: ReactNode;
-    testID?: string;
-}
+import type { DrawerProps } from "./DrawerProps";
+export type { DrawerProps } from "./DrawerProps";
 export declare const Drawer: import("react").NamedExoticComponent<DrawerProps>;
 //# sourceMappingURL=Drawer.d.ts.map

package/lib/typescript/modules/drawer/DrawerProps.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+/** A bottom-sheet panel built on React Native's own Modal. */
+export interface DrawerProps {
+    visible: boolean;
+    onRequestClose: () => void;
+    children: ReactNode;
+    testID?: string;
+}
+//# sourceMappingURL=DrawerProps.d.ts.map

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

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

package/lib/typescript/modules/empty-state/EmptyState.d.ts

@@ -13,20 +13,6 @@
  * Appearing is itself the status message (WCAG 4.1.3): a screen swapping its content for this block
  * moves no focus, so `useAnnounce` speaks the title + description once, on arrival and on change.
  */
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-export interface EmptyStateAction {
-    readonly label: string;
-    readonly onPress: () => void;
-}
-export interface EmptyStateProps {
-    icon?: IconName;
-    title: string;
-    description?: string;
-    action?: EmptyStateAction;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { EmptyStateProps } from "./EmptyStateProps";
 export declare const EmptyState: import("react").NamedExoticComponent<EmptyStateProps>;
 //# sourceMappingURL=EmptyState.d.ts.map

package/lib/typescript/modules/empty-state/EmptyState.variants.d.ts

@@ -46,4 +46,5 @@ export declare function resolveEmptyStateAnnouncement(title: string, description
  * never rebuilds per render.
  */
 export declare const emptyStateStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
+export declare const emptyStateFillStructure: import("../../core/style").ThemedVariantResolver<Theme, import("../../core/style").VariantGroups<import("react-native").ViewStyle>, import("react-native").ViewStyle>;
 //# sourceMappingURL=EmptyState.variants.d.ts.map

package/lib/typescript/modules/empty-state/EmptyStateProps.d.ts

@@ -0,0 +1,24 @@
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+/** A single call-to-action, rendered as a solid, accent-toned Button. */
+export interface EmptyStateAction {
+    readonly label: string;
+    readonly onPress: () => void;
+}
+/** Centred placeholder for empty or zero-result list/screen states. */
+export interface EmptyStateProps {
+    /** Decorative — hidden from screen readers. */
+    icon?: IconName;
+    /** Rendered as a level-2 heading and announced to screen readers on appearance. */
+    title: string;
+    /** Read after the title; included in the same screen-reader announcement. */
+    description?: string;
+    /** Renders as a solid, accent-toned Button. */
+    action?: EmptyStateAction;
+    /** Expands to fill and centre in a flex parent (e.g. a list empty slot). */
+    fill?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=EmptyStateProps.d.ts.map

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

@@ -5,6 +5,6 @@
  * never by importing its internals.
  */
 export { EmptyState } from "./EmptyState";
-export type { EmptyStateProps, EmptyStateAction } from "./EmptyState";
+export type { EmptyStateProps, EmptyStateAction } from "./EmptyStateProps";
 export type { IconName } from "../../core/icon";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/fab/Fab.d.ts

@@ -17,57 +17,7 @@
  * free of a cross-module dependency on `button/` internals, the same isolation `Toast.variants.ts`
  * documents for its own duplicated `MIN_TOUCH_TARGET`.
  */
-import type { GestureResponderEvent, MouseEvent, NativeSyntheticEvent, TargetedEvent } from "react-native";
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-import type { FabPosition, FabSize, FabTone } from "./Fab.variants";
-interface FabBaseProps {
-    onPress: () => void;
-    tone?: FabTone;
-    size?: FabSize;
-    position?: FabPosition;
-    disabled?: boolean;
-    /** Replaces the icon with a spinner and suppresses the press, same contract as `Button`. */
-    loading?: boolean;
-    /** Extra inset on top of the safe-area approximation — see `Fab.variants.ts`'s
-     *  `resolveFabBottomInset`/`resolveFabHorizontalInset`. Ignored when `position` is `"static"`. */
-    offset?: {
-        readonly bottom?: number;
-        readonly horizontal?: number;
-    };
-    /**
-     * The exact set a wrapping `Tooltip` injects via `cloneElement`, same contract `Button` declares.
-     * Explicit because `{...rest}` is banned repo-wide: an undeclared prop is dropped, so without
-     * these a tooltip on a Fab never opens. Chained after the Fab's own press/focus state.
-     */
-    onLongPress?: (event: GestureResponderEvent) => void;
-    onPressOut?: (event: GestureResponderEvent) => void;
-    onHoverIn?: (event: MouseEvent) => void;
-    onHoverOut?: (event: MouseEvent) => void;
-    onFocus?: (event: NativeSyntheticEvent<TargetedEvent>) => void;
-    onBlur?: (event: NativeSyntheticEvent<TargetedEvent>) => void;
-    accessibilityHint?: string;
-    /** react-native-web has no `accessibilityHint`, so a wrapping `Tooltip` describes the control by
-     *  id instead — inert on native, where the hint above is the equivalent. */
-    "aria-describedby"?: string;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
-/** A Fab with a visible text label — the EXTENDED variant (a pill, icon + text). */
-interface LabelledFabProps extends FabBaseProps {
-    icon: IconName;
-    label: string;
-    accessibilityLabel?: string;
-}
-/** An icon-only Fab. No visible text, so `accessibilityLabel` is REQUIRED at the type level — the
- *  same trap `Button`'s icon-only shape closes. `label?: never` keeps the two shapes exclusive. */
-interface IconOnlyFabProps extends FabBaseProps {
-    icon: IconName;
-    label?: never;
-    accessibilityLabel: string;
-}
-export type FabProps = LabelledFabProps | IconOnlyFabProps;
+import type { FabProps } from "./FabProps";
 declare function FabImpl(props: FabProps): import("react").JSX.Element;
 export declare const Fab: import("react").MemoExoticComponent<typeof FabImpl>;
 export {};

package/lib/typescript/modules/fab/Fab.variants.d.ts

@@ -19,13 +19,14 @@
  * Free of React, lucide, and any Pressable/Animated import, so the WCAG + behaviour tests import it
  * directly (mocking only `react-native`'s `StyleSheet`, as `core/style` does).
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, Theme } from "../../theme/hooks";
+export { MIN_TOUCH_TARGET };
 export type FabTone = "accent" | "neutral" | "danger";
 export type FabSize = "md" | "lg";
 export type FabPosition = "bottom-right" | "bottom-left" | "bottom-center" | "static";
 /** Both sizes already clear this floor directly (48dp / 56dp) — no `hitSlop` needed, unlike Button's
  *  shorter sizes (WCAG 2.5.5 AAA / Apple HIG minimum). */
-export declare const MIN_TOUCH_TARGET = 44;
 export interface FabSizeSpec {
     /** Visual diameter (icon-only) / pill height (extended), in dp. */
     readonly diameter: number;
@@ -64,6 +65,8 @@ export interface FabToneColors {
  * lookups, so it inverts light↔dark for free and can never be an off-palette value an app invented.
  */
 export declare function resolveFabTone(colors: RoleColors, tone: FabTone): FabToneColors;
+/** Press scrim direction, chosen by brightness — shared by `Fab` and `FabGroup`'s trigger. */
+export declare function fabOverlayColor(onFill: string): string;
 export interface FabAccessibilityInput {
     readonly label?: string | undefined;
     readonly accessibilityLabel?: string | undefined;
@@ -175,7 +178,7 @@ export interface FabFocusRingStyle {
 export declare function resolveFabFocusRingStyle(borderColor: string, borderRadius: number): FabFocusRingStyle;
 /** The dismiss scrim behind an expanded FabGroup — a design constant, not a role token: decorative,
  *  same status `BACKDROP_SCRIM` (Menu/Select) and `DRAWER_BACKDROP` already have. */
-export declare const FAB_GROUP_SCRIM = "#00000080";
+export declare const FAB_GROUP_SCRIM: string;
 /** Structural circle — the icon-only shape. Colour (fill) is tone-driven, applied inline over this. */
 export declare const fabCircleStructure: import("../../core/style").ThemedVariantResolver<Theme, {
     size: {

package/lib/typescript/modules/fab/FabGroup.d.ts

@@ -26,40 +26,7 @@
  * Uncontrolled by default (`open`/`onOpenChange` both omitted → internal state); controlled the
  * instant a caller passes `open`, the conventional React controlled/uncontrolled split.
  */
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-import type { FabPosition, FabSize, FabTone } from "./Fab.variants";
-export interface FabGroupAction {
-    readonly icon: IconName;
-    readonly label: string;
-    readonly onPress: () => void;
-    readonly tone?: FabTone;
-}
-export interface FabGroupProps {
-    actions: FabGroupAction[];
-    /** Trigger glyph. Rotates 45° open↔closed (a "+" reads as a close "×"); suppressed under reduced
-     *  motion via the same `progress`-driven duration as the rest of the expand/collapse. */
-    icon?: IconName;
-    /** Controlled the instant this is passed; omit both this and `onOpenChange` for internal state. */
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    tone?: FabTone;
-    size?: FabSize;
-    position?: FabPosition;
-    disabled?: boolean;
-    /** Overrides the trigger's accessible name whole. Defaults to "Open actions menu" / "Close actions
-     *  menu", swapping with the expanded state. */
-    accessibilityLabel?: string;
-    offset?: {
-        readonly bottom?: number;
-        readonly horizontal?: number;
-    };
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    /** Seeds `${testID}-anchor`, `${testID}-trigger`, `${testID}-trigger-focus-ring`,
-     *  `${testID}-scrim`, `${testID}-action-${index}`. */
-    testID?: string;
-}
+import type { FabGroupProps } from "./FabGroupProps";
 declare function FabGroupImpl({ actions, icon, open, onOpenChange, tone, size, position, disabled, accessibilityLabel, offset, style, testID, }: FabGroupProps): import("react").JSX.Element;
 export declare const FabGroup: import("react").MemoExoticComponent<typeof FabGroupImpl>;
 export {};

package/lib/typescript/modules/fab/FabGroupProps.d.ts

@@ -0,0 +1,34 @@
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+import type { FabPosition, FabSize, FabTone } from "./Fab.variants";
+/** One mini action in the expanded speed-dial stack. */
+export interface FabGroupAction {
+    readonly icon: IconName;
+    readonly label: string;
+    readonly onPress: () => void;
+    readonly tone?: FabTone;
+}
+/** A Fab-shaped trigger that expands into a vertical stack of labeled mini actions. */
+export interface FabGroupProps {
+    actions: FabGroupAction[];
+    /** Trigger glyph; rotates 45° open↔closed. Defaults to "plus". */
+    icon?: IconName;
+    /** Controlled the instant this is passed; omit both this and `onOpenChange` for internal state. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    tone?: FabTone;
+    size?: FabSize;
+    position?: FabPosition;
+    disabled?: boolean;
+    /** Overrides the trigger's accessible name; defaults to swapping "Open"/"Close actions menu". */
+    accessibilityLabel?: string;
+    offset?: {
+        readonly bottom?: number;
+        readonly horizontal?: number;
+    };
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    /** Seeds `${testID}-anchor`, `-trigger`, `-scrim` and `-action-${index}`. */
+    testID?: string;
+}
+//# sourceMappingURL=FabGroupProps.d.ts.map

package/lib/typescript/modules/fab/FabProps.d.ts

@@ -0,0 +1,50 @@
+import type { GestureResponderEvent, MouseEvent, NativeSyntheticEvent, TargetedEvent } from "react-native";
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+import type { FabPosition, FabSize, FabTone } from "./Fab.variants";
+interface FabBaseProps {
+    onPress: () => void;
+    /** Defaults to "accent". */
+    tone?: FabTone;
+    /** Defaults to "lg". */
+    size?: FabSize;
+    /** Defaults to "bottom-right". */
+    position?: FabPosition;
+    disabled?: boolean;
+    /** Replaces the icon with a spinner and suppresses the press, same contract as `Button`. */
+    loading?: boolean;
+    /** Extra inset on top of the safe-area approximation. Ignored when `position` is "static". */
+    offset?: {
+        readonly bottom?: number;
+        readonly horizontal?: number;
+    };
+    /** Injected by a wrapping `Tooltip` via `cloneElement`, same contract as `Button`. */
+    onLongPress?: (event: GestureResponderEvent) => void;
+    onPressOut?: (event: GestureResponderEvent) => void;
+    onHoverIn?: (event: MouseEvent) => void;
+    onHoverOut?: (event: MouseEvent) => void;
+    onFocus?: (event: NativeSyntheticEvent<TargetedEvent>) => void;
+    onBlur?: (event: NativeSyntheticEvent<TargetedEvent>) => void;
+    accessibilityHint?: string;
+    /** Native equivalent of `accessibilityHint`; inert on native. */
+    "aria-describedby"?: string;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+/** A Fab with a visible text label — the EXTENDED variant (a pill, icon + text). */
+interface LabelledFabProps extends FabBaseProps {
+    icon: IconName;
+    label: string;
+    accessibilityLabel?: string;
+}
+/** An icon-only Fab; `accessibilityLabel` is REQUIRED since there is no visible text. */
+interface IconOnlyFabProps extends FabBaseProps {
+    icon: IconName;
+    label?: never;
+    accessibilityLabel: string;
+}
+/** A floating action button — a safe-area-aware primary-action circle or extended pill. */
+export type FabProps = LabelledFabProps | IconOnlyFabProps;
+export {};
+//# sourceMappingURL=FabProps.d.ts.map

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

@@ -4,9 +4,9 @@
  * their props, never by importing internals.
  */
 export { Fab } from "./Fab";
-export type { FabProps } from "./Fab";
+export type { FabProps } from "./FabProps";
 export { FabGroup } from "./FabGroup";
-export type { FabGroupProps, FabGroupAction } from "./FabGroup";
+export type { FabGroupProps, FabGroupAction } from "./FabGroupProps";
 export type { FabPosition, FabSize, FabTone } from "./Fab.variants";
 export type { IconName } from "../../core/icon";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/field-select-modal/FieldSelectModal.d.ts

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

package/lib/typescript/modules/field-select-modal/FieldSelectModalProps.d.ts

@@ -0,0 +1,20 @@
+import type { LayoutStyle } from "../../core/style";
+/** One selectable row in the field-select modal. */
+export interface FieldSelectOption {
+    readonly id: string;
+    readonly label: string;
+}
+/** Modal single- or multi-select for form fields. */
+export interface FieldSelectModalProps {
+    visible: boolean;
+    onRequestClose: () => void;
+    title: string;
+    options: readonly FieldSelectOption[];
+    selectedIds: readonly string[];
+    onChange: (selectedIds: readonly string[]) => void;
+    /** Defaults to true; when false, picking an option calls onChange([id]) and closes the modal. */
+    multiple?: boolean;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=FieldSelectModalProps.d.ts.map

package/lib/typescript/modules/field-select-modal/index.d.ts

@@ -0,0 +1,3 @@
+export { FieldSelectModal } from "./FieldSelectModal";
+export type { FieldSelectModalProps, FieldSelectOption } from "./FieldSelectModalProps";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/file-grid/FileGrid.d.ts

@@ -4,23 +4,6 @@
  * Items are chunked into fixed-height rows and rendered through `core/list`'s `VirtualList`, so a
  * folder with thousands of files mounts a window of rows rather than every cell.
  */
-import type { IconName } from "../../core/icon";
-import type { LayoutStyle } from "../../core/style";
-import type { FileGridColumns } from "./FileGrid.variants";
-export interface FileGridItem {
-    readonly id: string;
-    readonly label: string;
-    readonly icon?: IconName;
-    /** What the glyph means ("Folder", "PDF") — the icon's text equivalent, WCAG 1.3.1. */
-    readonly typeLabel?: string;
-}
-export interface FileGridProps {
-    items: readonly FileGridItem[];
-    columns?: FileGridColumns;
-    onItemPress?: (id: string) => void;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { FileGridProps } from "./FileGridProps";
 export declare const FileGrid: import("react").NamedExoticComponent<FileGridProps>;
 //# sourceMappingURL=FileGrid.d.ts.map

package/lib/typescript/modules/file-grid/FileGridProps.d.ts

@@ -0,0 +1,23 @@
+import type { IconName } from "../../core/icon";
+import type { LayoutStyle } from "../../core/style";
+import type { FileGridColumns } from "./FileGrid.variants";
+/** One cell in the grid. */
+export interface FileGridItem {
+    readonly id: string;
+    readonly label: string;
+    readonly icon?: IconName;
+    /** What the glyph means ("Folder", "PDF") — the icon's text equivalent, WCAG 1.3.1. */
+    readonly typeLabel?: string;
+}
+/** Thumbnail grid for attachments or folders. */
+export interface FileGridProps {
+    items: readonly FileGridItem[];
+    /** Defaults to 3. */
+    columns?: FileGridColumns;
+    /** Omitted → cells render as plain, non-interactive views. */
+    onItemPress?: (id: string) => void;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=FileGridProps.d.ts.map

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

@@ -1,4 +1,4 @@
 export { FileGrid } from "./FileGrid";
-export type { FileGridItem, FileGridProps } from "./FileGrid";
+export type { FileGridItem, FileGridProps } from "./FileGridProps";
 export type { FileGridColumns } from "./FileGrid.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/file-upload/FileUpload.d.ts

@@ -16,32 +16,6 @@
  * control) rather than hand-rolling a `Pressable` — see MODULE.md "Why this module has no colour
  * resolver" for why that's a deliberate departure from every sibling module's structure/colour split.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { FileUploadResult, FileUploadSize, FileUploadSource } from "./FileUpload.variants";
-export interface FileUploadProps {
-    source: FileUploadSource;
-    /** The trigger's visible label, e.g. `"Upload photo"`. Always shown as-is — pressing the trigger
-     *  again while a file is already selected re-opens the picker and replaces it; the label does not
-     *  change to "change" or similar (the "selected file" row below is what communicates state). */
-    label: string;
-    /** Controlled — the currently selected file, or `null`/`undefined` for none. */
-    value?: FileUploadResult | null;
-    /** Fires with the picked file on a successful pick, or `null` when the user clears the selection
-     *  OR a pick attempt fails outright. Does NOT fire on a user cancel (the picker closes with
-     *  nothing chosen) — `value` is left exactly as it was. */
-    onChange: (result: FileUploadResult | null) => void;
-    size?: FileUploadSize;
-    disabled?: boolean;
-    /** Document-only — forwarded as `DocumentPicker.getDocumentAsync`'s `type`. Ignored when `source` is `"image"`. */
-    allowedMimeTypes?: string[];
-    /** Image-only — forwarded as `ImagePicker.launchImageLibraryAsync`'s `allowsEditing`. Ignored when `source` is `"document"`. Defaults to `false`, the default (permission-less) picker flow — see `FileUpload.variants.ts`'s `pickImageFile`. */
-    allowsEditing?: boolean;
-    /** 0–100. Omitted means "no upload in flight" and renders no track at all — this module still owns
-     *  no upload logic, it only DISPLAYS a number the consumer drives from its own transfer. */
-    progress?: number;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { FileUploadProps } from "./FileUploadProps";
 export declare const FileUpload: import("react").NamedExoticComponent<FileUploadProps>;
 //# sourceMappingURL=FileUpload.d.ts.map

package/lib/typescript/modules/file-upload/FileUploadProps.d.ts

@@ -0,0 +1,27 @@
+import type { LayoutStyle } from "../../core/style";
+import type { FileUploadResult, FileUploadSize, FileUploadSource } from "./FileUpload.variants";
+/** Trigger `Button` that opens a native image/document picker and reports the pick via `onChange`. */
+export interface FileUploadProps {
+    source: FileUploadSource;
+    /** Pressing it again while a file is selected re-opens the picker and replaces it. */
+    label: string;
+    value?: FileUploadResult | null;
+    /** Not called on a user cancel — `value` is left untouched. */
+    onChange: (result: FileUploadResult | null) => void;
+    size?: FileUploadSize;
+    disabled?: boolean;
+    /** Document-only; ignored when `source` is `"image"`. */
+    allowedMimeTypes?: string[];
+    /** Image-only; ignored when `source` is `"document"`. Defaults to `false`. */
+    allowsEditing?: boolean;
+    /** Omitted means no upload in flight — renders no progress track. */
+    progress?: number;
+    maxSizeKB?: number;
+    maxFiles?: number;
+    /** Multi-file selection; when set, `value` is ignored. */
+    values?: readonly FileUploadResult[];
+    onValuesChange?: (files: readonly FileUploadResult[]) => void;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=FileUploadProps.d.ts.map

package/lib/typescript/modules/file-upload/index.d.ts

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

package/lib/typescript/modules/filter-bar/FilterBar.d.ts

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

package/lib/typescript/modules/filter-bar/FilterBarProps.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { LayoutStyle } from "../../core/style";
+/** Search + filter affordances for list screens. */
+export interface FilterBarProps {
+    searchValue: string;
+    onSearchChange: (value: string) => void;
+    /** Defaults to "Search". */
+    searchPlaceholder?: string;
+    /** Shows the Filters button; also required for `activeFilterCount`'s badge to render. */
+    onOpenFilters?: () => void;
+    /** Ignored unless `onOpenFilters` is also set — the button's badge won't render otherwise. */
+    activeFilterCount?: number;
+    trailing?: ReactNode;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=FilterBarProps.d.ts.map

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

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

package/lib/typescript/modules/filter-sheet/FilterChip.d.ts

@@ -12,14 +12,6 @@
  * own admin-pinned default filter the current user can't remove, matching web's `lockedChipKeys`
  * concept), not a disabled-looking control.
  */
-import type { LayoutStyle } from "../../core/style";
-export interface FilterChipProps {
-    label: string;
-    /** Omit → renders a non-removable/"locked" chip: no press, no "x", no accessibilityRole. */
-    onRemove?: () => void;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { FilterChipProps } from "./FilterChipProps";
 export declare const FilterChip: import("react").NamedExoticComponent<FilterChipProps>;
 //# sourceMappingURL=FilterChip.d.ts.map