@webority/mobile-ui 0.11.0 → 0.12.0

package/lib/typescript/commonjs/components/Chip/Chip.d.ts

@@ -11,14 +11,25 @@ import type { SlotIcon } from '../AppIcon/slotIcon';
 export type ChipVariant = 'filled' | 'outlined' | 'soft';
 export type ChipTone = 'primary' | 'neutral' | 'success' | 'warning' | 'error' | 'info';
 export type ChipSize = 'sm' | 'md';
-export type ChipSelectionMode = 'single' | 'multiple';
+export type ChipSelectionMode = 'single' | 'multiple' | 'radio';
 export interface ChipProps {
     label: string;
+    /**
+     * A figure after the label, drawn quieter than it (regular weight, caption
+     * size, tabular digits): "Open" with `count={4}`. `0` is shown; `undefined`
+     * and an empty string draw nothing, so a count still loading leaves the
+     * label alone. The accessibility label becomes "Open, 4" unless
+     * `accessibilityLabel` is set.
+     */
+    count?: number | string;
     selected?: boolean;
     /**
      * How a pressable chip announces itself. `'single'` (default) is a button
      * with a selected state; `'multiple'` is a checkbox whose checked state
-     * follows `selected`, for chips that toggle independently.
+     * follows `selected`, for chips that toggle independently; `'radio'` is a
+     * radio whose checked state follows `selected`, for one-of-many chips inside
+     * a radiogroup. A disabled `'radio'` chip with an `onPress` stays a radio
+     * (announced disabled) instead of falling back to plain text.
      */
     selectionMode?: ChipSelectionMode;
     onPress?: () => void;
@@ -51,6 +62,8 @@ export interface ChipProps {
     textStyle?: StyleProp<TextStyle>;
     /** Style override for the chip outer container (alias to style, applied after). */
     containerStyle?: StyleProp<ViewStyle>;
+    /** Style override for the count text. */
+    countStyle?: StyleProp<TextStyle>;
     /** Style override for the close (×) button pressable. */
     closeButtonStyle?: StyleProp<ViewStyle>;
     /** Style override for the close (×) glyph text. */

package/lib/typescript/commonjs/components/Descriptions/Descriptions.d.ts

@@ -4,9 +4,16 @@ import type { TextColor } from '../Text/Text';
 export type DescriptionsSize = 'sm' | 'md';
 export type DescriptionsVariant = 'list' | 'summary';
 export interface DescriptionItem {
-    /** A string renders as text; a node (a symbol with a subscript, say) renders as-is. */
+    /**
+     * A string renders as text. A node (a symbol with a subscript, say) sits in the label's Text, so
+     * its base and subscript take the label's size and colour; a string inside a node list is fine.
+     */
     label: React.ReactNode;
-    /** A string renders as text; a node renders as-is. Empty renders as a plain hyphen, "-". */
+    /**
+     * A string, a number, a `sym()` / `Notation` or a list of those renders as text in the value's
+     * size, weight and colour (`strong`, `tone`), the subscript included. Any other node (a badge, a
+     * Text of your own) renders as-is in a View and owns its type. Empty renders as a plain hyphen, "-".
+     */
     value?: React.ReactNode;
     /** Make this row span both columns. Ignored when `columns` is 1. */
     full?: boolean;

package/lib/typescript/commonjs/components/FileViewer/FileViewer.d.ts

@@ -20,22 +20,33 @@ export interface FileViewerProps {
     onError?: (error: Error) => void;
     /** Replaces the default themed spinner shown while the document loads. */
     loadingIndicator?: () => React.ReactNode;
+    /** Pinch, double-tap zoom and pan while zoomed. Default true. */
+    zoomEnabled?: boolean;
+    /** Upper bound on pinch zoom, as a multiple of the page fitting the width. Default 4. */
+    maxZoom?: number;
     style?: StyleProp<ViewStyle>;
     testID?: string;
     accessibilityLabel?: string;
 }
 /**
  * Renders a PDF via our own native rasterizer (Core Graphics on iOS, PdfRenderer on
- * Android) — no third-party PDF dependency. Pages are paged through a plain
- * `ScrollView` with manual windowed mounting (render the visible page ±
- * `RENDER_WINDOW`), not a `FlatList` — a `VirtualizedList`-based component
- * would trip React Native's "VirtualizedLists should never be nested inside
- * plain ScrollViews" the moment a consumer embeds FileViewer in their own
- * scrolling screen, which is a completely ordinary way to use it. Avoiding the
- * VirtualizedList primitive entirely removes that whole class of warning
- * rather than working around one instance of it. The WebView fallback
- * consumer apps use for non-PDF office documents is a distinct rendering
- * strategy and stays app-side.
+ * Android), with no third-party PDF dependency. Pages are paged through a plain
+ * `ScrollView` with manual windowed mounting, not a `FlatList`: a
+ * `VirtualizedList`-based component would trip React Native's "VirtualizedLists
+ * should never be nested inside plain ScrollViews" the moment a consumer embeds
+ * FileViewer in their own scrolling screen, which is a completely ordinary way to
+ * use it. Avoiding the VirtualizedList primitive entirely removes that whole class
+ * of warning rather than working around one instance of it. The WebView fallback
+ * consumer apps use for non-PDF office documents is a distinct rendering strategy
+ * and stays app-side.
+ *
+ * Pages render one at a time, nearest the reader first, `RENDER_AHEAD` each way,
+ * and their files are kept, so scrolling back or ahead never lands on a blank
+ * page; only `MOUNT_AROUND` pages each side decode their image. Pinch zooms around
+ * the fingers and a double tap zooms in on the tap or back out; the transform sits
+ * on the whole scroll view, so while zoomed a one-finger drag pans and, past the
+ * zoomed page's top or bottom edge, carries on into the document's scroll. A
+ * settled zoom re-renders the page in view at the sharper scale it needs.
  */
 export declare const FileViewer: React.FC<FileViewerProps>;
 export default FileViewer;

package/lib/typescript/commonjs/components/FileViewer/FileViewerPage.d.ts

@@ -0,0 +1,12 @@
+import type React from 'react';
+export interface FileViewerPageProps {
+    width: number;
+    height: number;
+    /** The rendered page file: `undefined` while it renders, `null` when it failed to render. */
+    uri: string | null | undefined;
+    /** Only pages near the reader decode their image, so memory stays flat on a long document. */
+    mounted: boolean;
+    renderLoading: () => React.ReactNode;
+}
+export declare const FileViewerPage: React.NamedExoticComponent<FileViewerPageProps>;
+//# sourceMappingURL=FileViewerPage.d.ts.map

package/lib/typescript/commonjs/components/FileViewer/useFileViewerZoom.d.ts

@@ -0,0 +1,41 @@
+/** A zoom that ends at or below this counts as none and springs back to 1x. */
+export declare const ZOOM_REST = 1.01;
+interface UseFileViewerZoomOptions {
+    zoomEnabled: boolean;
+    maxZoom: number;
+    viewportWidth: number;
+    viewportHeight: number;
+    /** The furthest the document scrolls, so a pan carried into the scroll stops at the end. */
+    maxScroll: number;
+}
+/**
+ * FileViewer's zoom: a scale and translate on the whole scroll view, so the
+ * maths stays in viewport space. Pinch zooms around the fingers, a double tap
+ * zooms in on the tap or back out, and while zoomed a one-finger drag pans and,
+ * past the zoomed page's top or bottom edge, carries on into the document's
+ * scroll. `zoomLevel` reaches React only when a gesture settles, never per frame.
+ */
+export declare const useFileViewerZoom: ({ zoomEnabled, maxZoom, viewportWidth, viewportHeight, maxScroll }: UseFileViewerZoomOptions) => {
+    scrollRef: import("react-native-reanimated").AnimatedRef<import("react-native").ReactNativeElement>;
+    scrollGesture: import("react-native-gesture-handler/lib/typescript/handlers/gestures/nativeGesture").NativeGesture;
+    zoomGesture: import("react-native-gesture-handler/lib/typescript/handlers/gestures/gestureComposition").SimultaneousGesture;
+    zoomStyle: import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
+        transform: ({
+            translateX: number;
+            translateY?: undefined;
+            scale?: undefined;
+        } | {
+            translateY: number;
+            translateX?: undefined;
+            scale?: undefined;
+        } | {
+            scale: number;
+            translateX?: undefined;
+            translateY?: undefined;
+        })[];
+    }>;
+    zoomLevel: number;
+    resetZoom: () => void;
+};
+export {};
+//# sourceMappingURL=useFileViewerZoom.d.ts.map

package/lib/typescript/commonjs/components/FilterChipRow/FilterChipRow.d.ts

@@ -0,0 +1,55 @@
+/**
+ * FilterChipRow: a horizontal row of single-choice filter chips, each with an
+ * optional count ("Open 4"), above a list.
+ *
+ * The row scrolls edge to edge: `bleed` pulls it out by the page gutter on both
+ * sides and pads its content by the same amount, so the first chip lines up
+ * with the page content and the row still runs to the screen edge. Choosing a
+ * chip scrolls the row to centre it, so one past the screen edge never stays
+ * out of sight. The first placement is not animated; later ones glide, unless
+ * the OS asks for reduced motion.
+ *
+ * Accessibility is a radiogroup of radios, like SegmentedControl and
+ * ChoiceGroup: a filter picks a value on the same data. Sections of a screen
+ * are `Tabs`, not this.
+ */
+import type { View as RNView, StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
+import type { ChipSize, ChipTone, ChipVariant } from '../Chip';
+export interface FilterChipItem {
+    /** Stable id of the chip; `value` and `onChange` carry it. */
+    key: string;
+    label: string;
+    /** Shown after the label; leave it undefined while it loads and the label shows alone. */
+    count?: number | string;
+    disabled?: boolean;
+}
+export interface FilterChipRowProps {
+    items: ReadonlyArray<FilterChipItem>;
+    /** Key of the selected item. */
+    value: string;
+    /** Fired with the key of a chip the person picks. Not fired for the chip that is already selected. */
+    onChange: (key: string) => void;
+    /**
+     * The page gutter in points. The row extends this far past its parent on
+     * both sides and pads its content by the same amount. The theme carries no
+     * screen gutter, so the default is 0 (the row stays inside its parent).
+     */
+    bleed?: number;
+    size?: ChipSize;
+    variant?: ChipVariant;
+    tone?: ChipTone;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
+    /** Names the radiogroup for screen readers, e.g. "Filter by status". */
+    accessibilityLabel?: string;
+    /** Style of the outer view, applied after the bleed margin. */
+    style?: StyleProp<ViewStyle>;
+    /** Style of the scrolling content, applied after the bleed padding and the chip gap. */
+    contentContainerStyle?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const FilterChipRow: import("react").ForwardRefExoticComponent<FilterChipRowProps & import("react").RefAttributes<RNView>>;
+export { FilterChipRow };
+export default FilterChipRow;
+//# sourceMappingURL=FilterChipRow.d.ts.map

package/lib/typescript/commonjs/components/FilterChipRow/index.d.ts

@@ -0,0 +1,3 @@
+export type { FilterChipItem, FilterChipRowProps } from './FilterChipRow';
+export { default, FilterChipRow } from './FilterChipRow';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/components/FloatingActionButton/FloatingActionButton.d.ts

@@ -8,7 +8,15 @@ export interface FloatingActionButtonProps {
     /** JSX element for the icon. The FAB sizes it via the `size` prop's iconSize token. */
     icon: React.ReactNode;
     onPress: () => void;
+    /** Text beside the icon; makes the button extended (a pill). */
     label?: string;
+    /**
+     * Folds an extended button to its round icon alone (the size's diameter) with
+     * the label fading out, and unfolds it when false. Drive it from scroll state
+     * to cover less of the rows moving underneath. Does nothing without a `label`;
+     * the accessibility label is unchanged. Independent of `hideOnScroll`.
+     */
+    collapsed?: boolean;
     size?: FloatingActionButtonSize;
     tone?: FloatingActionButtonTone;
     position?: FloatingActionButtonPosition;

package/lib/typescript/commonjs/components/SignaturePad/SignaturePad.d.ts

@@ -71,9 +71,15 @@ export interface SignaturePadProps {
     height?: number;
     /** Longest typed name. Default 100. */
     maxNameLength?: number;
-    /** Ink of the strokes and the typed name. Defaults to the light theme's primary text, in both colour schemes. */
+    /**
+     * Ink of the strokes and the typed name, on the pad and in `toFile()` and `toSvg()`. With neither
+     * `inkColor` nor `paperColor` set, the pad follows the active theme (primary text on the elevated
+     * surface), while `toFile()` and `toSvg()` stay the library's dark ink on light paper in every
+     * colour scheme so the file is ready for a document. Set one and the other keeps the light
+     * theme's colour.
+     */
     inkColor?: string;
-    /** Ground of the pad and of the PNG. Defaults to the light theme's elevated surface, in both colour schemes. */
+    /** Ground of the pad and of the PNG. See `inkColor` for the defaults. */
     paperColor?: string;
     /**
      * Font family of the typed name. Default a system script face: Snell Roundhand on iOS, `cursive`

package/lib/typescript/commonjs/components/SquircleView/SquircleView.d.ts

@@ -0,0 +1,22 @@
+import type { View as RNView, ViewProps } from 'react-native';
+export type SquircleViewProps = ViewProps;
+/**
+ * A `View` whose rounded corners are smooth on both platforms, for a surface
+ * the library has no component for (a photo tile, a signature pad frame).
+ * Give it `borderRadius`, and `backgroundColor` and a border in `style`.
+ *
+ * iOS draws the continuous curve natively (`borderCurve`). Android draws the
+ * fill and border as one SVG path behind the children, with the theme's
+ * `cornerSmoothing`, so it matches Box, Card and Button. The view keeps its
+ * native corner until it is measured, and where the curve cannot apply: a
+ * radius under 6, a pill, a different radius or border per corner or side, a
+ * dashed border, `overflow: 'hidden'`, `elevation`, or a colour that is not a
+ * string.
+ *
+ * Children are not clipped to the curve. Use `Card` or `Box` when the surface
+ * is a themed card or a spacing container.
+ */
+declare const SquircleView: import("react").ForwardRefExoticComponent<ViewProps & import("react").RefAttributes<RNView>>;
+export { SquircleView };
+export default SquircleView;
+//# sourceMappingURL=SquircleView.d.ts.map

package/lib/typescript/commonjs/components/SquircleView/index.d.ts

@@ -0,0 +1,3 @@
+export type { SquircleViewProps } from './SquircleView';
+export { SquircleView } from './SquircleView';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/components/index.d.ts

@@ -68,6 +68,8 @@ export type { FilePickerFile, FilePickerFileState, FilePickerFileStatus, FilePic
 export { FilePicker, formatFileSize } from './FilePicker';
 export type { FileViewerProps, FileViewerSource } from './FileViewer';
 export { FileViewer } from './FileViewer';
+export type { FilterChipItem, FilterChipRowProps } from './FilterChipRow';
+export { FilterChipRow } from './FilterChipRow';
 export type { FloatingActionButtonGroupAction, FloatingActionButtonGroupProps, FloatingActionButtonPosition, FloatingActionButtonProps, FloatingActionButtonSize, FloatingActionButtonTone } from './FloatingActionButton';
 export { FloatingActionButton, FloatingActionButtonGroup } from './FloatingActionButton';
 export type { ForceUpdateDialogProps } from './ForceUpdateDialog';
@@ -160,6 +162,8 @@ export type { SparklineProps, SparklineTone } from './Sparkline';
 export { Sparkline } from './Sparkline';
 export type { SpinnerProps, SpinnerSize, SpinnerVariant } from './Spinner';
 export { Spinner } from './Spinner';
+export type { SquircleViewProps } from './SquircleView';
+export { SquircleView } from './SquircleView';
 export type { StatTileProps, StatTileTrend } from './StatTile';
 export { StatTile } from './StatTile';
 export type { StatusBadgeProps, StatusBadgeSize, StatusBadgeTone, StatusBadgeVariant } from './StatusBadge';

package/lib/typescript/commonjs/theme/types.d.ts

@@ -359,6 +359,10 @@ export interface EmptyStateSizeTokens {
     descriptionFontSize: keyof TypographyScale['fontSize'];
     /** Resolves against the active theme's spacing scale. */
     paddingVertical: keyof SpacingScale;
+    /** Space between the icon and the title; a spacing scale key. Library default: "md". */
+    titleGap?: keyof SpacingScale;
+    /** Space between the title and the description; a spacing scale key. Library default: "xs". */
+    descriptionGap?: keyof SpacingScale;
 }
 export interface ListItemSizeTokens {
     /** Resolves against the active theme's spacing scale. */

package/lib/typescript/module/components/Avatar/Avatar.d.ts

@@ -1,6 +1,7 @@
 import type React from 'react';
-import type { ImageSourcePropType, ImageStyle, View as RNView, StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { GestureResponderEvent, ImageSourcePropType, ImageStyle, PressableProps, View as RNView, StyleProp, TextStyle, ViewStyle } from 'react-native';
 import type { Theme } from '../../theme/types.js';
+import type { HapticType } from '../../utils/hapticUtils.js';
 /**
  * Props passed to a custom {@link AvatarProps.ImageComponent}. The built-in
  * image is expo-image's `Image`, and both it (`contentFit`) and React Native's
@@ -72,7 +73,30 @@ export interface AvatarProps {
      * when data arrives. Use this while the data driving the component is being fetched.
      */
     loading?: boolean;
+    /**
+     * Accessible name. The default is `"<name>'s avatar"`, or the name alone
+     * when the avatar is pressable.
+     */
     accessibilityLabel?: string;
+    /**
+     * Makes the avatar a button: it is announced as one, dims while pressed and
+     * fires the haptic. Pass it to open a profile or a photo menu. Ignored
+     * while `loading`.
+     */
+    onPress?: (event: GestureResponderEvent) => void;
+    /** Long press; also makes the avatar a button. The `longPress` haptic fires first. */
+    onLongPress?: (event: GestureResponderEvent) => void;
+    /**
+     * Haptic on a press (default `'selection'`) and a long press (default
+     * `'longPress'`). A type replaces both; `false` turns both off. Only a
+     * pressable avatar fires one.
+     */
+    haptic?: HapticType | false;
+    /**
+     * Extra touch area of a pressable avatar. Unset, it grows the avatar to
+     * 44 points on each side, so `xs` and `sm` stay easy to hit.
+     */
+    hitSlop?: PressableProps['hitSlop'];
     style?: StyleProp<ViewStyle>;
     textStyle?: StyleProp<TextStyle>;
     testID?: string;

package/lib/typescript/module/components/Chip/Chip.d.ts

@@ -11,14 +11,25 @@ import type { SlotIcon } from '../AppIcon/slotIcon.js';
 export type ChipVariant = 'filled' | 'outlined' | 'soft';
 export type ChipTone = 'primary' | 'neutral' | 'success' | 'warning' | 'error' | 'info';
 export type ChipSize = 'sm' | 'md';
-export type ChipSelectionMode = 'single' | 'multiple';
+export type ChipSelectionMode = 'single' | 'multiple' | 'radio';
 export interface ChipProps {
     label: string;
+    /**
+     * A figure after the label, drawn quieter than it (regular weight, caption
+     * size, tabular digits): "Open" with `count={4}`. `0` is shown; `undefined`
+     * and an empty string draw nothing, so a count still loading leaves the
+     * label alone. The accessibility label becomes "Open, 4" unless
+     * `accessibilityLabel` is set.
+     */
+    count?: number | string;
     selected?: boolean;
     /**
      * How a pressable chip announces itself. `'single'` (default) is a button
      * with a selected state; `'multiple'` is a checkbox whose checked state
-     * follows `selected`, for chips that toggle independently.
+     * follows `selected`, for chips that toggle independently; `'radio'` is a
+     * radio whose checked state follows `selected`, for one-of-many chips inside
+     * a radiogroup. A disabled `'radio'` chip with an `onPress` stays a radio
+     * (announced disabled) instead of falling back to plain text.
      */
     selectionMode?: ChipSelectionMode;
     onPress?: () => void;
@@ -51,6 +62,8 @@ export interface ChipProps {
     textStyle?: StyleProp<TextStyle>;
     /** Style override for the chip outer container (alias to style, applied after). */
     containerStyle?: StyleProp<ViewStyle>;
+    /** Style override for the count text. */
+    countStyle?: StyleProp<TextStyle>;
     /** Style override for the close (×) button pressable. */
     closeButtonStyle?: StyleProp<ViewStyle>;
     /** Style override for the close (×) glyph text. */

package/lib/typescript/module/components/Descriptions/Descriptions.d.ts

@@ -4,9 +4,16 @@ import type { TextColor } from '../Text/Text.js';
 export type DescriptionsSize = 'sm' | 'md';
 export type DescriptionsVariant = 'list' | 'summary';
 export interface DescriptionItem {
-    /** A string renders as text; a node (a symbol with a subscript, say) renders as-is. */
+    /**
+     * A string renders as text. A node (a symbol with a subscript, say) sits in the label's Text, so
+     * its base and subscript take the label's size and colour; a string inside a node list is fine.
+     */
     label: React.ReactNode;
-    /** A string renders as text; a node renders as-is. Empty renders as a plain hyphen, "-". */
+    /**
+     * A string, a number, a `sym()` / `Notation` or a list of those renders as text in the value's
+     * size, weight and colour (`strong`, `tone`), the subscript included. Any other node (a badge, a
+     * Text of your own) renders as-is in a View and owns its type. Empty renders as a plain hyphen, "-".
+     */
     value?: React.ReactNode;
     /** Make this row span both columns. Ignored when `columns` is 1. */
     full?: boolean;

package/lib/typescript/module/components/FileViewer/FileViewer.d.ts

@@ -20,22 +20,33 @@ export interface FileViewerProps {
     onError?: (error: Error) => void;
     /** Replaces the default themed spinner shown while the document loads. */
     loadingIndicator?: () => React.ReactNode;
+    /** Pinch, double-tap zoom and pan while zoomed. Default true. */
+    zoomEnabled?: boolean;
+    /** Upper bound on pinch zoom, as a multiple of the page fitting the width. Default 4. */
+    maxZoom?: number;
     style?: StyleProp<ViewStyle>;
     testID?: string;
     accessibilityLabel?: string;
 }
 /**
  * Renders a PDF via our own native rasterizer (Core Graphics on iOS, PdfRenderer on
- * Android) — no third-party PDF dependency. Pages are paged through a plain
- * `ScrollView` with manual windowed mounting (render the visible page ±
- * `RENDER_WINDOW`), not a `FlatList` — a `VirtualizedList`-based component
- * would trip React Native's "VirtualizedLists should never be nested inside
- * plain ScrollViews" the moment a consumer embeds FileViewer in their own
- * scrolling screen, which is a completely ordinary way to use it. Avoiding the
- * VirtualizedList primitive entirely removes that whole class of warning
- * rather than working around one instance of it. The WebView fallback
- * consumer apps use for non-PDF office documents is a distinct rendering
- * strategy and stays app-side.
+ * Android), with no third-party PDF dependency. Pages are paged through a plain
+ * `ScrollView` with manual windowed mounting, not a `FlatList`: a
+ * `VirtualizedList`-based component would trip React Native's "VirtualizedLists
+ * should never be nested inside plain ScrollViews" the moment a consumer embeds
+ * FileViewer in their own scrolling screen, which is a completely ordinary way to
+ * use it. Avoiding the VirtualizedList primitive entirely removes that whole class
+ * of warning rather than working around one instance of it. The WebView fallback
+ * consumer apps use for non-PDF office documents is a distinct rendering strategy
+ * and stays app-side.
+ *
+ * Pages render one at a time, nearest the reader first, `RENDER_AHEAD` each way,
+ * and their files are kept, so scrolling back or ahead never lands on a blank
+ * page; only `MOUNT_AROUND` pages each side decode their image. Pinch zooms around
+ * the fingers and a double tap zooms in on the tap or back out; the transform sits
+ * on the whole scroll view, so while zoomed a one-finger drag pans and, past the
+ * zoomed page's top or bottom edge, carries on into the document's scroll. A
+ * settled zoom re-renders the page in view at the sharper scale it needs.
  */
 export declare const FileViewer: React.FC<FileViewerProps>;
 export default FileViewer;

package/lib/typescript/module/components/FileViewer/FileViewerPage.d.ts

@@ -0,0 +1,12 @@
+import type React from 'react';
+export interface FileViewerPageProps {
+    width: number;
+    height: number;
+    /** The rendered page file: `undefined` while it renders, `null` when it failed to render. */
+    uri: string | null | undefined;
+    /** Only pages near the reader decode their image, so memory stays flat on a long document. */
+    mounted: boolean;
+    renderLoading: () => React.ReactNode;
+}
+export declare const FileViewerPage: React.NamedExoticComponent<FileViewerPageProps>;
+//# sourceMappingURL=FileViewerPage.d.ts.map

package/lib/typescript/module/components/FileViewer/useFileViewerZoom.d.ts

@@ -0,0 +1,41 @@
+/** A zoom that ends at or below this counts as none and springs back to 1x. */
+export declare const ZOOM_REST = 1.01;
+interface UseFileViewerZoomOptions {
+    zoomEnabled: boolean;
+    maxZoom: number;
+    viewportWidth: number;
+    viewportHeight: number;
+    /** The furthest the document scrolls, so a pan carried into the scroll stops at the end. */
+    maxScroll: number;
+}
+/**
+ * FileViewer's zoom: a scale and translate on the whole scroll view, so the
+ * maths stays in viewport space. Pinch zooms around the fingers, a double tap
+ * zooms in on the tap or back out, and while zoomed a one-finger drag pans and,
+ * past the zoomed page's top or bottom edge, carries on into the document's
+ * scroll. `zoomLevel` reaches React only when a gesture settles, never per frame.
+ */
+export declare const useFileViewerZoom: ({ zoomEnabled, maxZoom, viewportWidth, viewportHeight, maxScroll }: UseFileViewerZoomOptions) => {
+    scrollRef: import("react-native-reanimated").AnimatedRef<import("react-native").ReactNativeElement>;
+    scrollGesture: import("react-native-gesture-handler/lib/typescript/handlers/gestures/nativeGesture").NativeGesture;
+    zoomGesture: import("react-native-gesture-handler/lib/typescript/handlers/gestures/gestureComposition").SimultaneousGesture;
+    zoomStyle: import("react-native-reanimated/lib/typescript/hook/commonTypes").AnimatedStyleHandle<{
+        transform: ({
+            translateX: number;
+            translateY?: undefined;
+            scale?: undefined;
+        } | {
+            translateY: number;
+            translateX?: undefined;
+            scale?: undefined;
+        } | {
+            scale: number;
+            translateX?: undefined;
+            translateY?: undefined;
+        })[];
+    }>;
+    zoomLevel: number;
+    resetZoom: () => void;
+};
+export {};
+//# sourceMappingURL=useFileViewerZoom.d.ts.map

package/lib/typescript/module/components/FilterChipRow/FilterChipRow.d.ts

@@ -0,0 +1,55 @@
+/**
+ * FilterChipRow: a horizontal row of single-choice filter chips, each with an
+ * optional count ("Open 4"), above a list.
+ *
+ * The row scrolls edge to edge: `bleed` pulls it out by the page gutter on both
+ * sides and pads its content by the same amount, so the first chip lines up
+ * with the page content and the row still runs to the screen edge. Choosing a
+ * chip scrolls the row to centre it, so one past the screen edge never stays
+ * out of sight. The first placement is not animated; later ones glide, unless
+ * the OS asks for reduced motion.
+ *
+ * Accessibility is a radiogroup of radios, like SegmentedControl and
+ * ChoiceGroup: a filter picks a value on the same data. Sections of a screen
+ * are `Tabs`, not this.
+ */
+import type { View as RNView, StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/index.js';
+import type { ChipSize, ChipTone, ChipVariant } from '../Chip/index.js';
+export interface FilterChipItem {
+    /** Stable id of the chip; `value` and `onChange` carry it. */
+    key: string;
+    label: string;
+    /** Shown after the label; leave it undefined while it loads and the label shows alone. */
+    count?: number | string;
+    disabled?: boolean;
+}
+export interface FilterChipRowProps {
+    items: ReadonlyArray<FilterChipItem>;
+    /** Key of the selected item. */
+    value: string;
+    /** Fired with the key of a chip the person picks. Not fired for the chip that is already selected. */
+    onChange: (key: string) => void;
+    /**
+     * The page gutter in points. The row extends this far past its parent on
+     * both sides and pads its content by the same amount. The theme carries no
+     * screen gutter, so the default is 0 (the row stays inside its parent).
+     */
+    bleed?: number;
+    size?: ChipSize;
+    variant?: ChipVariant;
+    tone?: ChipTone;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
+    /** Names the radiogroup for screen readers, e.g. "Filter by status". */
+    accessibilityLabel?: string;
+    /** Style of the outer view, applied after the bleed margin. */
+    style?: StyleProp<ViewStyle>;
+    /** Style of the scrolling content, applied after the bleed padding and the chip gap. */
+    contentContainerStyle?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const FilterChipRow: import("react").ForwardRefExoticComponent<FilterChipRowProps & import("react").RefAttributes<RNView>>;
+export { FilterChipRow };
+export default FilterChipRow;
+//# sourceMappingURL=FilterChipRow.d.ts.map

package/lib/typescript/module/components/FilterChipRow/index.d.ts

@@ -0,0 +1,3 @@
+export type { FilterChipItem, FilterChipRowProps } from './FilterChipRow.js';
+export { default, FilterChipRow } from './FilterChipRow.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/FloatingActionButton/FloatingActionButton.d.ts

@@ -8,7 +8,15 @@ export interface FloatingActionButtonProps {
     /** JSX element for the icon. The FAB sizes it via the `size` prop's iconSize token. */
     icon: React.ReactNode;
     onPress: () => void;
+    /** Text beside the icon; makes the button extended (a pill). */
     label?: string;
+    /**
+     * Folds an extended button to its round icon alone (the size's diameter) with
+     * the label fading out, and unfolds it when false. Drive it from scroll state
+     * to cover less of the rows moving underneath. Does nothing without a `label`;
+     * the accessibility label is unchanged. Independent of `hideOnScroll`.
+     */
+    collapsed?: boolean;
     size?: FloatingActionButtonSize;
     tone?: FloatingActionButtonTone;
     position?: FloatingActionButtonPosition;

package/lib/typescript/module/components/SignaturePad/SignaturePad.d.ts

@@ -71,9 +71,15 @@ export interface SignaturePadProps {
     height?: number;
     /** Longest typed name. Default 100. */
     maxNameLength?: number;
-    /** Ink of the strokes and the typed name. Defaults to the light theme's primary text, in both colour schemes. */
+    /**
+     * Ink of the strokes and the typed name, on the pad and in `toFile()` and `toSvg()`. With neither
+     * `inkColor` nor `paperColor` set, the pad follows the active theme (primary text on the elevated
+     * surface), while `toFile()` and `toSvg()` stay the library's dark ink on light paper in every
+     * colour scheme so the file is ready for a document. Set one and the other keeps the light
+     * theme's colour.
+     */
     inkColor?: string;
-    /** Ground of the pad and of the PNG. Defaults to the light theme's elevated surface, in both colour schemes. */
+    /** Ground of the pad and of the PNG. See `inkColor` for the defaults. */
     paperColor?: string;
     /**
      * Font family of the typed name. Default a system script face: Snell Roundhand on iOS, `cursive`

package/lib/typescript/module/components/SquircleView/SquircleView.d.ts

@@ -0,0 +1,22 @@
+import type { View as RNView, ViewProps } from 'react-native';
+export type SquircleViewProps = ViewProps;
+/**
+ * A `View` whose rounded corners are smooth on both platforms, for a surface
+ * the library has no component for (a photo tile, a signature pad frame).
+ * Give it `borderRadius`, and `backgroundColor` and a border in `style`.
+ *
+ * iOS draws the continuous curve natively (`borderCurve`). Android draws the
+ * fill and border as one SVG path behind the children, with the theme's
+ * `cornerSmoothing`, so it matches Box, Card and Button. The view keeps its
+ * native corner until it is measured, and where the curve cannot apply: a
+ * radius under 6, a pill, a different radius or border per corner or side, a
+ * dashed border, `overflow: 'hidden'`, `elevation`, or a colour that is not a
+ * string.
+ *
+ * Children are not clipped to the curve. Use `Card` or `Box` when the surface
+ * is a themed card or a spacing container.
+ */
+declare const SquircleView: import("react").ForwardRefExoticComponent<ViewProps & import("react").RefAttributes<RNView>>;
+export { SquircleView };
+export default SquircleView;
+//# sourceMappingURL=SquircleView.d.ts.map